#cache #http #middleware #surf

http-cache-surf

http-cache middleware implementation for surf

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

Download history 54/week @ 2022-03-15 32/week @ 2022-03-22 27/week @ 2022-03-29 22/week @ 2022-04-05 32/week @ 2022-04-12 28/week @ 2022-04-19 152/week @ 2022-04-26 70/week @ 2022-05-03 201/week @ 2022-05-10 149/week @ 2022-05-17 134/week @ 2022-05-24 255/week @ 2022-05-31 119/week @ 2022-06-07 34/week @ 2022-06-14 14/week @ 2022-06-21 5/week @ 2022-06-28

187 downloads per month
Used in okta-jwt-verifier

MIT/Apache

45KB
729 lines

http-cache-surf

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. 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

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