# router

A golang library for HTTP routing. Once initialized, router is immutable and thread-safe.


## Usage:

First, import the router:

	import "go.deck17.com/router"


Then make a router instance:

	urlRouter, err := router.NewRouter(
		map[string]string{
			"page.index": "/",
			"page.about": "/about",
			"page.edit":  "/object/{name}/edit",
		},
	)


To initialize endpoints with http library:


	pattern := func(key string) string {
		path, err := urlRouter.Pattern(key)
		if err != nil {
            panic(err)
        }
        return path
	}

	http.HandlerFunc(pattern("page.index"), handleIndex)
    http.HandlerFunc(pattern("page.edit"), handleEdit)


To use the handler inside Go code:

	route := func(key string, args ...any) string {
		path, err := urlRouter.Route(key, args...)
		if err != nil {
			panic(err)
		}
		return path
	}
    
    http.Redirect(w, route("page.edit", "object-1"), http.StatusSeeOther)


It is also possible to use the router inside templates. For this to work, it is necessary to implement a custom template function
either similar to "route" or just as a wrapper to "route".