webutils

type FileServer struct {
	// Underlying is the file server's underlying file source.
	// Underlying may be nil.
	// Underlying MUST support concurrent Open calls. Returned files MUST
	// support inter-concurrent operations but are themselves accessed
	// sequentially.
	Underlying fs.FS

	// Is the Underlying filesystem static?
	// In this case, data is permanently cached in memory after first access
	// alongside all accepted encodings and a cryptographic hash.
	UnderlyingStatic bool

	// When non-zero, serve this path's page when the requested page was
	// not found. The 404 page's path cannot be served with a status code
	// of 200. If the 404 page's path does not exist, a default 404 is sent.
	// For an HTML page, it is recommended to employ `<base>` since the page
	// URL path and file path are decoupled.
	Page404 string

	// Allow hidden paths (i.e. paths containing "/.") to reach Underlying.Open.
	AllowHidden bool

	// Do not send any statistics. Currently, this only includes compression
	// statistics.
	// [2022-10-05] TODO Add timing statistics (cf. `Server-Timing` HTTP header).
	DisableStatistics bool

	// When non-zero, a `Link: <...>; rel="canonical"` header is sent on
	// requests to canonical paths present in Underlying.
	// It should not contain a trailing slash or schema; "https://" is presumed.
	// Sample Value: "www.example.com"
	CanonicalHost string

	// Only takes effect when UnderlyingStatic is true.
	// When non-zero, emit a `Cache-Control: public, maxage=...` header.
	CacheControlMaxAge time.Duration

	// Do not try to deduce a `Content-Type` header; probably because one
	// has been already set as an extra header.
	ProhibitMimeTypeSniffing bool

	ExtraHeaders map[string][]string
	// contains filtered or unexported fields
}

type Range struct {
	Index, Length int64
}