Awesome
bone
NOTICE
The Original repo have move to https://github.com/go-zoo/bone
What is bone ?
Bone is a lightweight and lightning fast HTTP Multiplexer for Golang. It support URL variables, http method declaration and custom NotFound handler.
Update
After trying to find a way of using the default url.Query() for route parameters, i decide to change the way bone is dealing with this. url.Query() is too slow for good router performance.
So now to get the parameters value in your handler, you need to use
bone.GetValue(request, key)
instead of req.Url.Query().Get(key)
.
This change give a big speed improvement for every kind of application using route parameters, like ~80x faster ...
Really sorry for breaking things, but i think it's worth it.
Speed
- BenchmarkBoneMux 10000000 118 ns/op
- BenchmarkZeusMux 100000 144 ns/op
- BenchmarkHttpRouterMux 10000000 134 ns/op
- BenchmarkNetHttpMux 3000000 580 ns/op
- BenchmarkGorillaMux 300000 3333 ns/op
- BenchmarkGorillaPatMux 1000000 1889 ns/op
These test are just for fun, all these router are great and really efficient. Bone do not pretend to be the fastest router for every job.
Example
package main
import(
"net/http"
"github.com/squiidz/bone"
)
func main () {
mux := bone.New()
// Method takes http.HandlerFunc
mux.Get("/home/:id", HomeHandler)
mux.Post("/data", DataHandler)
// Handle take http.Handler
mux.Handle("/", http.HandlerFunc(RootHandler))
http.ListenAndServe(":8080", mux)
}
func Handler(rw http.ResponseWriter, req *http.Request) {
// Get the value of the "id" parameters.
val := bone.GetValue(req, "id")
rw.Write([]byte(val))
}
TODO
- More Testing
- Debugging
- Optimisation
- Refactoring
Contributing
- Fork it
- Create your feature branch (git checkout -b my-new-feature)
- Write Tests!
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create new Pull Request
License
MIT
Links
Middleware Chaining module : Claw