26 releases (11 breaking)

0.11.0 Mar 29, 2023
0.9.2 Feb 24, 2023
0.7.2 Nov 17, 2022
0.7.0 Jun 17, 2022
0.0.0 Sep 1, 2018

#30 in Caching

Download history 1573/week @ 2023-02-03 1734/week @ 2023-02-10 2546/week @ 2023-02-17 2846/week @ 2023-02-24 2591/week @ 2023-03-03 2502/week @ 2023-03-10 3319/week @ 2023-03-17 3662/week @ 2023-03-24 2125/week @ 2023-03-31 1838/week @ 2023-04-07 1777/week @ 2023-04-14 2079/week @ 2023-04-21 2351/week @ 2023-04-28 4078/week @ 2023-05-05 2995/week @ 2023-05-12 3008/week @ 2023-05-19

12,930 downloads per month
Used in 18 crates (3 directly)

MIT/Apache

32KB
554 lines

http-cache

CI Crates.io Docs.rs Codecov Crates.io

the http-cache logo

A caching middleware that follows HTTP caching rules, thanks to http-cache-semantics. By default, it uses cacache as the backend cache manager.

How do I use this?

Likely you won't! At least not directly. Unless you are looking to implement a custom backend cache manager or client middleware you'll probably want to pull in one of the existing client implementations instead. See the Provided Client Implementations section below.

Minimum Supported Rust Version (MSRV)

1.63.0

Install

With cargo add installed :

cargo add http-cache

Features

The following features are available. By default manager-cacache is enabled.

  • manager-cacache (default): enable cacache, a high-performance disk cache, backend manager.
  • manager-moka (disabled): enable moka, a high-performance in-memory cache, backend manager.
  • with-http-types (disabled): enable http-types type conversion support

Documentation

Provided Client Implementations

  • Surf: See README for more details
  • Reqwest: See README for more details

Additional Manager Implementations

  • quick-cache: See README for more details

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~3–12MB
~250K SLoC