https://github.com/theyakka/goro
A mighty damn fine router for Go
https://github.com/theyakka/goro
go golang http routers web-application-framework
Last synced: 16 days ago
JSON representation
A mighty damn fine router for Go
- Host: GitHub
- URL: https://github.com/theyakka/goro
- Owner: theyakka
- License: other
- Archived: true
- Created: 2016-01-08T06:48:47.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2020-02-01T02:00:34.000Z (almost 6 years ago)
- Last Synced: 2025-08-14T03:16:15.326Z (6 months ago)
- Topics: go, golang, http, routers, web-application-framework
- Language: Go
- Homepage:
- Size: 194 KB
- Stars: 10
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Goro is a mighty fine routing toolkit for Go web applications. It is designed to
be fast, yet flexible.
[](https://circleci.com/gh/theyakka/goro)
[](https://golang.org/)
[](https://codecov.io/gh/theyakka/goro)
# Features
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 `Filter`s to modify `Request` or `HandlerContext` objects or to perform post-execution logic if embedding.
- Static asset mapping
- Support for subdomains
- Handler chaining built-in
# Installing
To install, run:
```
go get -u github.com/theyakka/goro
```
You can then import goro using:
```
import github.com/theyakka/goro
```
# Getting started
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.
```go
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.
```go
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](https://github.com/theyakka/goro/wiki).
We recommend using the latest version of Go.
# FAQ
## Why should I use this and not ____?
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.
## Has it been tested in production? Can I use it in production?
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!
## Who the f*ck is Yakka?
Yakka is the premier Flutter agency and a kick-ass product company. We focus on the work. Our stuff is at [http://theyakka.com](http://theyakka.com). Go check it out.
# Outro
## Credits
Goro is sponsored, owned and maintained by [Yakka LLC](http://theyakka.com). Feel free to reach out with suggestions, ideas or to say hey.
### Security
If you believe you have identified a serious security vulnerability or issue with Goro, please report it as soon as possible to apps@theyakka.com. Please refrain from posting it to the public issue tracker so that we have a chance to address it and notify everyone accordingly.
## License
Goro is released under a modified MIT license. See LICENSE for details.