webutil

README

webutil

Roadmap

• logging middleware

Documentation

Index

• Variables
• 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 FormScanner
  • func NewFormScanner(form url.Values) *FormScanner
  • func (s *FormScanner) Error() error
  • func (s *FormScanner) Scan(name string, val any) *FormScanner
• type PathScanner
  • func NewPathScanner(r *http.Request) *PathScanner
  • func (s *PathScanner) Error() error
  • func (s *PathScanner) Scan(name string, val any) *PathScanner

Variables

var ErrUnsupportedType = errors.New("unsupported type")

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 FormScanner

type FormScanner struct {
	// contains filtered or unexported fields
}

func NewFormScanner

func NewFormScanner(form url.Values) *FormScanner

func (*FormScanner) Error

func (s *FormScanner) Error() error

func (*FormScanner) Scan

func (s *FormScanner) Scan(name string, val any) *FormScanner

type PathScanner

type PathScanner struct {
	// contains filtered or unexported fields
}

func NewPathScanner

func NewPathScanner(r *http.Request) *PathScanner

func (*PathScanner) Error

func (s *PathScanner) Error() error

func (*PathScanner) Scan

func (s *PathScanner) Scan(name string, val any) *PathScanner