Efficient serving of pre-compressed static files.
Go to file
Laurence Withers 527b361b51 Finish up the initial packserver implementation 2019-04-15 14:10:26 +01:00
cmd Finish up the initial packserver implementation 2019-04-15 14:10:26 +01:00
packed Reorganise ready to split into modules 2019-04-12 09:07:17 +01:00
.gitignore Finish up the initial packserver implementation 2019-04-15 14:10:26 +01:00
README.md Note a TODO in the README 2019-04-12 09:16:23 +01:00
go.mod cmd/htpacker now split into its own module 2019-04-12 09:15:28 +01:00
go.sum cmd/htpacker now split into its own module 2019-04-12 09:15:28 +01:00
handler.go Reorganise ready to split into modules 2019-04-12 09:07:17 +01:00

README.md

HTTP resource pack server

A common scenario is that you have a set of static resources that you want to serve up quickly via HTTP (for example: stylesheets, WASM).

This package provides a net/http-compatible http.Handler to do so, with support for:

  • compression
    • gzip
    • brotli, if you have the external compression binary available at pack time
    • does not yet support Transfer-Encoding, only Accept-Encoding/Content-Encoding
  • etags
  • ranges (TODO)

The workflow is as follows:

  • (optional) build YAML file describing files to serve
  • run htpacker tool to produce a single .htpack file
  • create htpack.Handler pointing at .htpack file

The handler can easily be combined with middleware (http.StripPrefix etc.).