web

Web server.

Features

• High performance
• Low latency
• Radix tree routing

Installation

go get git.akyoto.dev/go/web

Usage

s := web.NewServer()

// Static route
s.Get("/", func(ctx web.Context) error {
	return ctx.String("Hello")
})

// Parameter route
s.Get("/blog/:post", func(ctx web.Context) error {
	return ctx.String(ctx.Get("post"))
})

// Wildcard route
s.Get("/images/*file", func(ctx web.Context) error {
	return ctx.String(ctx.Get("file"))
})

s.Run(":8080")

Tests

PASS: TestBytes
PASS: TestString
PASS: TestError
PASS: TestErrorMultiple
PASS: TestRequest
PASS: TestRequestHeader
PASS: TestRequestParam
PASS: TestWrite
PASS: TestWriteString
PASS: TestResponseCompression
PASS: TestResponseHeader
PASS: TestResponseHeaderOverwrite
PASS: TestPanic
PASS: TestRun
PASS: TestBadRequest
PASS: TestBadRequestHeader
PASS: TestBadRequestMethod
PASS: TestBadRequestProtocol
PASS: TestEarlyClose
PASS: TestUnavailablePort
coverage: 100.0% of statements

Benchmarks

wrk

wrk -t12 -c1000 -d2s http://127.0.0.1:8080/

Running 2s test @ http://127.0.0.1:8080/
  12 threads and 1000 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency     1.83ms    2.07ms  33.95ms   88.04%
    Req/Sec    50.38k     5.34k   64.92k    71.67%
  1207398 requests in 2.03s, 46.06MB read
Requests/sec: 595860.16
Transfer/sec:     22.73MB

ali

ali --rate=10000 --duration=0 http://127.0.0.1:8080/

Latencies:
P50: 90μs
P90: 138μs
P95: 160μs

oha

oha -z 2s --no-tui http://127.0.0.1:8080/

Summary:
  Success rate:	100.00%
  Total:	2.0003 secs
  Slowest:	0.0034 secs
  Fastest:	0.0000 secs
  Average:	0.0002 secs
  Requests/sec:	265346.5118

go-wrk

go-wrk -c 1000 -d 2 http://127.0.0.1:8080/

Running 2s test @ http://127.0.0.1:8080/
  1000 goroutine(s) running concurrently
355214 requests in 1.97068379s, 8.81MB read
Requests/sec:		180249.11
Transfer/sec:		4.47MB
Avg Req Time:		5.547877ms
Fastest Request:	30.66µs
Slowest Request:	95.208812ms
Number of Errors:	0

License

Please see the license documentation.

Copyright

© 2024 Eduard Urbach