DEPRECATED (and archived): use mux instead!

httpmux (HTTP request multiplexer)

About

This package is an HTTP request multiplexer that enables router nesting and middleware stacking for Go (or Golang) HTTP servers.

It uses standard approaches, such as the context package for retrieving route parameters and short-circuiting middlewares, what makes it easy to be used on both new and old projects, since it doesn't present any new pattern.

Usage

Full documentation here.

Example (from example_test.go)

package httpmux_test

import (
	"log"
	"net/http"

	"github.com/gbrlsnchs/httpmux"
	"github.com/gbrlsnchs/httpmux/internal"
)

func Example() {
	rt := httpmux.NewRouter()

	rt.SetParamsKey(internal.ParamsKey)
	rt.HandleMiddlewares(http.MethodGet, "/:path",
		// Logger.
		func(w http.ResponseWriter, r *http.Request) {
			log.Printf("r.URL.Path = %s\n", r.URL.Path)
		},
		// Guard.
		func(w http.ResponseWriter, r *http.Request) {
			if params, ok := r.Context().Value(internal.ParamsKey).(map[string]string); ok {
				if params["path"] == "forbidden" {
					w.WriteHeader(http.StatusForbidden)
					httpmux.Cancel(r)
				}

				return
			}

			httpmux.Cancel(r)
		},
		// Handler.
		func(w http.ResponseWriter, r *http.Request) {
			w.WriteHeader(http.StatusOK)
		},
	)

	http.ListenAndServe("/", rt)
}

Contribution

How to help:

• Pull Requests
• Issues
• Opinions