webutil

README

webutil

Roadmap

• logging middleware

Documentation

Index

• func ListenAndServe(srv *http.Server) error
• func ParseTemplateSet(funcs template.FuncMap, fs embed.FS) map[string]*template.Template
• func WithLogging(inner http.HandlerFunc) http.HandlerFunc
• type CookieHandler
  • func NewCookieHandler(listenAddr string) *CookieHandler
  • func (h *CookieHandler) Get(r *http.Request, name string) string
  • func (h *CookieHandler) Set(w http.ResponseWriter, name, value string)

Functions

func ListenAndServe

func ListenAndServe(srv *http.Server) error

Serve requests using the given http.Server. If srv.Addr has the format `hostname:https`, then use autocert to manage certificates for the domain.

For http on port 80, you can use :http.

func ParseTemplateSet

func ParseTemplateSet(funcs template.FuncMap, fs embed.FS) map[string]*template.Template

ParseTemplateSet parses sets of templates from an embed.FS.

Each directory constitutes a set of templates that are parsed together.

Structure (within a directory):

• share/* are always parsed.
• base.html will be parsed with each other file in same dir

Call a template with m[path].Execute(w, data) (root dir name is excluded).

For example, if you have

• /user/share/*
• /user/base.html
• /user/home.html

Then you call m["/user/home.html"].Execute(w, data).

func WithLogging

func WithLogging(inner http.HandlerFunc) http.HandlerFunc

Types

type CookieHandler

type CookieHandler struct {
	Secure   bool
	SameSite http.SameSite // Defaults to strict.
	MaxAge   int           // Default 10 years
}

func NewCookieHandler

func NewCookieHandler(listenAddr string) *CookieHandler

func (*CookieHandler) Get

func (h *CookieHandler) Get(r *http.Request, name string) string

func (*CookieHandler) Set

func (h *CookieHandler) Set(w http.ResponseWriter, name, value string)