Skip to content
High performance and extensible micro web framework. Zero memory allocations in hot paths.
Go
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
examples
middlewares
.gitignore
.travis.yml
LICENSE
README.md
atreugo.go
atreugo_test.go
consts.go
context.go
context_test.go
doc.go
go.mod
go.sum
listener_test.go
listener_unix.go
listener_windows.go
response.go
response_test.go
router.go
router_test.go
types.go
utils.go
utils_test.go

README.md

Atreugo

Build Status Coverage Status Go Report Card GoDoc GitHub release

High performance and extensible micro web framework with zero memory allocations in hot paths.

It's build on top of fasthttp.

Install

  • WITH Go modules:
go get github.com/savsgio/atreugo/v9
  • WITHOUT Go modules:
go get github.com/savsgio/atreugo

Supported Go versions:

  • 1.9.x
  • 1.10.x
  • 1.11.x
  • 1.12.x
  • 1.13.x

Documentation

See: docs

Feature Overview

  • Optimized for speed. Easily handles more than 100K qps and more than 1M concurrent keep-alive connections on modern hardware.

  • Optimized for low memory usage.

  • Easy 'Connection: Upgrade' support via RequestCtx.Hijack.

  • Server provides anti-DoS limits.

  • Middlewares support:

    • Before view execution.
    • After view execution.
  • Easy routing:

    • Path parameters (mandatories and optionals).
    • Views with timeout.
    • Group paths and middlewares.
    • Static files.
    • Serve one file like pdf, etc.
    • Filters (middlewares) to especific views.
    • net/http handlers support.
    • fasthttp handlers support
  • Common responses (also you could use your own responses):

    • JSON
    • HTTP
    • Text
    • Raw
    • File
    • Redirect

Examples:

Go to examples directory to see how to use Atreugo.

Note:

*atreugo.RequestCtx is equal than *fasthttp.RequestCtx, but adding extra funtionality, so you can use the same functions of *fasthttp.RequestCtx. Don't worry 😄

Benchmark

Best Performance: Atreugo is one of the fastest go web frameworks in the go-web-framework-benchmark.

  • Basic Test: The first test case is to mock 0 ms, 10 ms, 100 ms, 500 ms processing time in handlers.

  • Concurrency Test (allocations): In 30 ms processing time, the tets result for 100, 1000, 5000 clients is:

* Smaller is better

Useful third-party libraries

Contributing

Feel free to contribute it or fork me... 😉

You can’t perform that action at this time.