14 releases (4 breaking)
Uses new Rust 2021
0.5.0 | Jun 17, 2022 |
---|---|
0.4.6 | Apr 30, 2022 |
0.4.1 | Mar 29, 2022 |
0.3.0 | Feb 10, 2022 |
0.1.1 | Jan 16, 2022 |
#51 in Caching
187 downloads per month
Used in okta-jwt-verifier
45KB
729 lines
http-cache-surf
A caching middleware that follows HTTP caching rules, thanks to http-cache-semantics. By default, it uses cacache as the backend cache manager. Should likely be registered after any middleware modifying the request.
Minimum Supported Rust Version (MSRV)
1.59.0
Install
With cargo add installed :
cargo add http-cache-surf
Example
use http_cache_surf::{Cache, CacheMode, CACacheManager, HttpCache};
#[async_std::main]
async fn main() -> surf::Result<()> {
let req = surf::get("https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching");
surf::client()
.with(Cache(HttpCache {
mode: CacheMode::Default,
manager: CACacheManager::default(),
options: None,
}))
.send(req)
.await?;
Ok(())
}
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.
Documentation
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
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
~8–16MB
~306K SLoC