Goro is a mighty fine routing toolkit for Go web applications. It is designed to be fast, yet flexible.
Goro is LOADED with features, but no bloat.
- Straightforward context handling / management
- Flexible routing options with wildcards and variables
- Prioritized route definitions with caching
- Pre and Post execution
Filters to modifyRequestorHandlerContextobjects or to perform post-execution logic if embedding. - Static asset mapping
- Support for subdomains
- Handler chaining built-in
To install, run:
go get -u github.com/theyakka/goro
You can then import goro using:
import github.com/theyakka/goro
Setting up a basic router would look something like the following.
In your main/server.go file you would create a Router instance, configure a basic route, and then pass the router to http.ListenAndServe as a handler.
package main
func startServer() {
router := goro.NewRouter()
router.GET("/").Handle(handlers.RootHandler)
log.Fatal(http.ListenAndServe(":8080", router))
}Then in your handlers package (or where you define your routes) you would set up your RootHandler function.
package handlers
func RootHandler(ctx *goro.HandlerContext) {
// do something here
}That's just a quick intro. However, Goro has so much more packed in. Rather than try to describe it all here, you should check out The Goro Guide.
We recommend using the latest version of Go.
I'm not going to make any claims that Goro is the fastest router on the market or that it'll make you a million bucks. The likelihood is that even if those were true for you, they might not be for others.
What we will say is that we have tried A LOT of web frameworks over many languages and that we invested in making Goro out of unhappiness with what we saw generally. If you're here, then maybe you have also.
Goro was designed from the ground up as a Router that we wanted to use and not to copy anyone else. It has the features we think are important, and is architected in a way that we think makes managing all this stuff super simple.
Give it a try and if you like it, let us know! Either way, we love feedback.
The code here has been written based on experiences with clients of all sizes. It has been production tested. That said, code is always evolving. We plan to keep on using it in production but we also plan to keep on improving it. If you find a bug, let us know!
Yakka is the premier Flutter agency and a kick-ass product company. We focus on the work. Our stuff is at http://theyakka.com. Go check it out.
Goro is sponsored, owned and maintained by Yakka LLC. Feel free to reach out with suggestions, ideas or to say hey.
If you believe you have identified a serious security vulnerability or issue with Goro, please report it as soon as possible to [email protected]. Please refrain from posting it to the public issue tracker so that we have a chance to address it and notify everyone accordingly.
Goro is released under a modified MIT license. See LICENSE for details.