Teeny.go, a route system for Go (Golang)

Teeny.go (or teenygo or only teeny) is a micro-module for create a micro-webserver with support for routes and routes with patterns similar to PHP and JavaScript web-frameworks

For install use

go get -u github.com/inphinit/teeny.go

Then create a file with any name and extension .go, example foo.go and put this content:

package main

import (
    "fmt"
    "net/http"
    "github.com/inphinit/teenygo"
)

func main() {
    app := teeny.Serve("localhost", 7000)

    app.Action("GET", "/", func (response http.ResponseWriter, request *http.Request) {
        fmt.Fprint(response, "Homepage")
    })

    app.Action("GET", "/about", func (response http.ResponseWriter, request *http.Request) {
        fmt.Fprint(response, "About page")
    })

    app.Exec()
}

For execute local serve run this command:

go run foo.go

For build executes:

go build foo.go
foo

This is a very simple example, for access http://localhost:7000/ and http://localhost:7000/about

Handling Http errors (like ErrorDocument)

For handling errors for not defined routes (404 Not Found) and when try access a route with invalid (not defined) method uses app.HandlerCodes(codes []int, func TeenyStatusCallback), example:

func main() {
    app := teeny.Serve("localhost", 7000)

    var codes = []int {404, 405}

    app.HandlerCodes(codes, func (response http.ResponseWriter, request *http.Request, code int) {
        fmt.Fprintf(response, "Error %d", code)
    })

    ...
}

Route patterns

For use patterns in router uses app.Params(method string, path string, func TeenyPatternCallback), example with num and alnum pattern:

    app.Params("GET", "/users/<id:num>/<name:alnum>", func (response http.ResponseWriter, request *http.Request, params map[string]string) {
        fmt.Fprint(response, "Params:\n")

        for key, value := range params {
            fmt.Fprintf(response, "%s = %s\n", key, value)
        }
    })

Supported patterns:

Pattern	Regex used	Description
alnum	[\da-zA-Z]+	Matches routes with param using alpha-numeric in route
alpha	[a-zA-Z]+	Matches routes with param using A to Z letters in route
decimal	\d+\.\d+	Matches routes with param using decimal format (like 1.2, 3.5, 100.50) in route
num	\d+	Matches routes with param using numeric format in route
noslash	[^\/]+	Matches routes with param using any character except slashs (\/ or /) in route
nospace	\S+	Matches routes with param using any character except spaces, tabs or NUL in route
uuid	[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}	Matches routes with param using uuid format in route
version	\d+\.\d+(\.\d+(-[\da-zA-Z]+(\.[\da-zA-Z]+)*(\+[\da-zA-Z]+(\.[\da-zA-Z]+)*)?)?)?	Matches routes with param using semver.org format in route