serve

Documentation

Index

• Constants
• Variables
• func App(opt ...AppOption) func(http.ResponseWriter, *http.Request, fs.FS, ...Option) (*Info, error)
• func AutoCert(email string, host string) *tls.Config
• func Error(w http.ResponseWriter, err error)
• func ErrorStatusCode(err error) int
• func Handle(w http.ResponseWriter, r *http.Request, fn func() (*Info, error))
• func Listen(h http.Handler, opt ...ListenOption)
• func NewAppHandler(fsys fs.FS, opt ...AppOption) http.Handler
• type AppOption
  • func Index(name string) AppOption
• type Info
  • func Blob(w http.ResponseWriter, r *http.Request, b blob.Blob, opt ...Option) (*Info, error)
  • func Header(w http.ResponseWriter, opt ...Option) (*Info, error)
  • func JSON(w http.ResponseWriter, r *http.Request, v any, opt ...Option) (*Info, error)
  • func Reader(rw http.ResponseWriter, r *http.Request, rd io.Reader, opt ...Option) (*Info, error)
• type ListenOption
  • func Addr(addr string) ListenOption
  • func TLS(c *tls.Config) ListenOption
• type Option
  • func Attachment(name string) Option
  • func Compress(b bool) Option
  • func ContentLength(n int64) Option
  • func ContentType(ct string) Option
  • func ContentTypeFromPath(p string) Option
  • func Immutable(b bool) Option
  • func LastModified(t time.Time) Option
  • func Location(loc string) Option
  • func MaxAge(d time.Duration) Option
  • func NoOp() Option
  • func Range(start, end int64) Option
  • func StatusCode(n int) Option
• type StatusCoder

Constants

const (
	DefaultReadTimeout  = time.Second * 30
	DefaultWriteTimeout = time.Second * 60
	DefaultIdleTimeout  = time.Second * 120
	DefaultAddr         = ":http"
	DefaultTLSAddr      = ":https"
)

const DefaultIndexFile = "index.html"

Variables

var ErrContentLengthMismatch = errors.New("content-length mismatch")

Functions

func App

func App(opt ...AppOption) func(http.ResponseWriter, *http.Request, fs.FS, ...Option) (*Info, error)

func AutoCert

func AutoCert(email string, host string) *tls.Config

func Error

func Error(w http.ResponseWriter, err error)

func ErrorStatusCode

func ErrorStatusCode(err error) int

func Handle

func Handle(w http.ResponseWriter, r *http.Request, fn func() (*Info, error))

func Listen

func Listen(h http.Handler, opt ...ListenOption)

func NewAppHandler

func NewAppHandler(fsys fs.FS, opt ...AppOption) http.Handler

Types

type AppOption

type AppOption func(*appConfig)

func Index

func Index(name string) AppOption

type Info

type Info struct {
	StatusCode    int
	ContentLength int64
	ContentType   string
	Location      string
	LastModified  time.Time
	MaxAge        time.Duration
	Immutable     bool
	Compress      bool
	Disposition   string
	Range         *[2]int64
}

func Blob

func Blob(w http.ResponseWriter, r *http.Request, b blob.Blob, opt ...Option) (*Info, error)

func Header

func Header(w http.ResponseWriter, opt ...Option) (*Info, error)

func JSON

func JSON(w http.ResponseWriter, r *http.Request, v any, opt ...Option) (*Info, error)

func Reader

func Reader(rw http.ResponseWriter, r *http.Request, rd io.Reader, opt ...Option) (*Info, error)

type ListenOption

type ListenOption func(*listenConfig)

func Addr

func Addr(addr string) ListenOption

func TLS

func TLS(c *tls.Config) ListenOption

type Option

type Option func(c *config)

func Attachment

func Attachment(name string) Option

func Compress

func Compress(b bool) Option

func ContentLength

func ContentLength(n int64) Option

func ContentType

func ContentType(ct string) Option

func ContentTypeFromPath

func ContentTypeFromPath(p string) Option

func Immutable

func Immutable(b bool) Option

func LastModified

func LastModified(t time.Time) Option

func Location

func Location(loc string) Option

func MaxAge

func MaxAge(d time.Duration) Option

func NoOp

func NoOp() Option

func Range

func Range(start, end int64) Option

func StatusCode

func StatusCode(n int) Option

type StatusCoder

type StatusCoder interface {
	StatusCode() int
}