Efficient serving of pre-compressed static files.
Go to file
Laurence Withers 0fc26e5414 Initial README 2019-02-23 13:47:59 +00:00
README.md Initial README 2019-02-23 13:47:59 +00:00
go.mod Initial README 2019-02-23 13:47:59 +00:00

README.md

HTTP resource pack server

A common scenario is that you have a set of static resources that you want to server 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

The workflow is as follows:

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

Only the minimal header processing necessary for correctness (Content-Length, etc.) is carried out by htpack.Handler; the handler can be combined with middleware for further processing (adding headers, http.StripPrefix, etc.).