Initial README

This commit is contained in:
Laurence Withers 2019-02-23 13:47:59 +00:00
commit 0fc26e5414
2 changed files with 24 additions and 0 deletions

23
README.md Normal file
View File

@ -0,0 +1,23 @@
# 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.).

1
go.mod Normal file
View File

@ -0,0 +1 @@
module github.com/lwithers/htpack