Bourbon is a package for rapidly developing JSON web services.
Start by installing Bourbon:
$ go get github.com/daneharrigan/bourbonNext, we'll create our first Bourbon web service. Let's create a file call
web.go containing the following:
package main
import "github.com/daneharrigan/bourbon"
type Example struct {
Message string
}
func main() {
b := bourbon.New()
b.Get("/", func() bourbon.Encodeable {
return Example{Message: "Hello World!"}
})
b.Run()
}Lets run the web service locally:
$ go run web.goLastly, lets make a request to the web service:
$ curl http://localhost:5000
{"Message":"Hello World!"}Bourbon defaults to port 5000. This can be overwritten by setting the
environment variable PORT to the desired value or specifying the value in
SetPort.
bourbon.SetPort("3000")Bourbon's feature set targets JSON web services and aims to make them as easy to write as possible. Common or repetitive tasks should be handled by Bourbon.
A Bourbon can be mounted onto another Bourbon and inherit properties such as middleware and URL prefix.
package main
import (
"github.com/daneharrigan/bourbon"
"github.com/example/myproject/v1"
"github.com/example/myproject/v2"
)
func main() {
v1.API.SetPrefix("/v1")
v2.API.SetPrefix("/v2")
b := bourbon.New()
b.Mount(v1.API)
b.Mount(v2.API)
b.Run()
}The v1 and v2 packages in this example could be run independently
of each other, but they can also be combined and run as a single web service.
Bourbon will automatically encode a data structure and write the response when a
bourbon.Encodeable is returned by a Handler.
package main
import "github.com/daneharrigan/bourbon"
type Example struct {
Message string
}
func main() {
b := bourbon.New()
b.Get("/", func() bourbon.Encodeable {
return Example{Message: "Hello World!"}
})
b.Run()
}When Bourbon sees a data type in the Handler's argument list that does not
belong to the packages net/http or bourbon, it will decode the request body
into a value of that argument type.
package main
import "github.com/daneharrigan/bourbon"
type Example struct {
Message string
}
func main() {
b := bourbon.New()
b.Post("/", func(e Example) (int, bourbon.Encodeable) {
println(e.Message)
return 201, e
})
b.Run()
}Since you have already declared the URLs and HTTP methods for your web service,
Bourbon will use that information and handle OPTIONS requests automatically.
package main
import "github.com/daneharrigan/bourbon"
func main() {
b := bourbon.New()
b.Get("/", func(){ /* some work */ })
b.Put("/", func(){ /* some work */ })
b.Post("/", func(){ /* some work */ })
b.Run()
}$ curl http://localhost:5000 -X OPTIONS -v
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 0
Allow: GET, PUT, POSTBourbon only accepts JSON. Because of this, Bourbon will reject requests whose Content-Types are not a form of JSON.
package main
import "github.com/daneharrigan/bourbon"
type Example struct {
Message string
}
func main() {
b := bourbon.New()
b.Get("/", func() bourbon.Encodeable {
return Example{Message: "Hello World!"}
})
b.Run()
}With the Content-Type of application/json:
$ curl http://localhost:5000 -H "Content-Type: application/json"
{"Message":"Hello World!"}With the Content-Type of application/vnd.custom+json:
$ curl http://localhost:5000 -H "Content-Type: application/vnd.custom+json"
{"Message":"Hello World!"}With the Content-Type of text/html:
$ curl http://localhost:5000 -H "Content-Type: text/html"
{"code":415,"message":"Unsupported Media Type","errors":["\"text/html\" is not a supported Content-Type"]}Did I overlook something? Is an area of Bourbon confusing? Or maybe you just want to say hi! Feel free to reach out via Twitter, email or over Github.