sq/libsq/files/internal/downloader/README.md

49 lines
2.2 KiB
Markdown
Raw Normal View History

# ACKNOWLEDGEMENT
This `download` package is a heavily-modified fork
of [`gregjones/httpcache`](https://github.com/gregjones/httpcache).
# httpcache
[![GoDoc](https://godoc.org/github.com/bitcomplete/httpcache?status.svg)](https://godoc.org/github.com/bitcomplete/httpcache)
Package httpcache provides a http.RoundTripper implementation that works as a
mostly [RFC 7234](https://tools.ietf.org/html/rfc7234) compliant cache for http
responses. This incarnation of the library is an active fork of
[github.com/gregjones/httpcache](https://github.com/gregjones/httpcache) which
is unmaintained.
It is only suitable for use as a 'private' cache (i.e. for a web-browser or an
API-client and not for a shared proxy).
## Cache Backends
- The built-in 'memory' cache stores responses in an in-memory map. -
[`github.com/bitcomplete/httpcache/diskcache`](https://github.com/bitcomplete/httpcache/tree/master/diskcache)
provides a filesystem-backed cache using the
[diskv](https://github.com/peterbourgon/diskv) library.
- [`github.com/bitcomplete/httpcache/memcache`](https://github.com/bitcomplete/httpcache/tree/master/memcache)
provides memcache implementations, for both App Engine and 'normal' memcache
servers.
- [`sourcegraph.com/sourcegraph/s3cache`](https://sourcegraph.com/github.com/sourcegraph/s3cache)
uses Amazon S3 for storage.
- [`github.com/bitcomplete/httpcache/leveldbcache`](https://github.com/bitcomplete/httpcache/tree/master/leveldbcache)
provides a filesystem-backed cache using
[leveldb](https://github.com/syndtr/goleveldb/leveldb).
- [`github.com/die-net/lrucache`](https://github.com/die-net/lrucache) provides an
in-memory cache that will evict least-recently used entries.
- [`github.com/die-net/lrucache/twotier`](https://github.com/die-net/lrucache/tree/master/twotier)
allows caches to be combined, for example to use lrucache above with a
persistent disk-cache.
- [`github.com/birkelund/boltdbcache`](https://github.com/birkelund/boltdbcache)
provides a BoltDB implementation (based on the
[bbolt](https://github.com/coreos/bbolt) fork).
If you implement any other backend and wish it to be linked here, please send a
PR editing this file.
## License
- [MIT License](LICENSE.txt)