feat: tower client and streaming body support

Author: 06chaynes

.github/workflows/coverage.yml

@@ -24,10 +24,12 @@ jobs:
       - uses: taiki-e/install-action@cargo-llvm-cov
       - run: |
           cargo llvm-cov clean --workspace
-          cargo llvm-cov --no-report --no-default-features --package http-cache --features manager-cacache,cacache-async-std,with-http-types,manager-moka
-          cargo llvm-cov --no-report --no-default-features --package http-cache --features manager-cacache,cacache-tokio
-          cargo llvm-cov --no-report --package http-cache-surf --features manager-moka
-          cargo llvm-cov --no-report --package http-cache-reqwest --features manager-moka
+          cargo llvm-cov --no-report --no-default-features --package http-cache --features manager-cacache,cacache-smol,with-http-types,manager-moka,streaming-smol
+          cargo llvm-cov --no-report --no-default-features --package http-cache --features manager-cacache,cacache-tokio,with-http-types,manager-moka,streaming-tokio
+          cargo llvm-cov --no-report --package http-cache-surf --all-features
+          cargo llvm-cov --no-report --package http-cache-reqwest --all-features
+          cargo llvm-cov --no-report --package http-cache-tower --all-features
+          cargo llvm-cov --no-report --package http-cache-quickcache --all-features
           cargo llvm-cov report --lcov --output-path lcov.info
       - uses: codecov/codecov-action@v5
         with:

.github/workflows/http-cache-mokadeser.yml

@@ -1,18 +1,21 @@
-name: http-cache-darkbird
+name: http-cache-tower
 
 on:
+  push:
+    branches: [main]
+  pull_request:
   workflow_dispatch:
 
 env:
   CARGO_TERM_COLOR: always
 
 concurrency:
-  group: ${{ github.ref }}-http-cache-darkbird
+  group: ${{ github.ref }}-http-cache-tower
   cancel-in-progress: true
 
 defaults:
  run:
-  working-directory: ./http-cache-darkbird
+  working-directory: ./http-cache-tower
 
 jobs:
   fmt:
@@ -41,6 +44,16 @@ jobs:
       - run: |
           cargo test --all-targets --all-features
 
+  examples:
+    name: Test examples
+    needs: [fmt]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - run: |
+          cargo run --example streaming_memory_profile --features streaming
+
   clippy:
     name: Check clippy
     needs: [fmt, test]

.github/workflows/http-cache-darkbird.yml .github/workflows/http-cache-tower.yml.github/workflows/http-cache-darkbird.yml renamed to .github/workflows/http-cache-tower.yml

@@ -42,8 +42,8 @@ jobs:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
       - run: |
-          cargo test --all-targets --no-default-features --features manager-cacache,cacache-async-std,with-http-types,manager-moka
-          cargo test --all-targets --no-default-features --features manager-cacache,cacache-tokio
+          cargo test --all-targets --no-default-features --features manager-cacache,cacache-smol,with-http-types,manager-moka,streaming-smol
+          cargo test --all-targets --no-default-features --features manager-cacache,cacache-tokio,with-http-types,manager-moka,streaming-tokio
 
   clippy:
     name: Check clippy
@@ -55,8 +55,8 @@ jobs:
         with:
           components: "clippy"
       - run: |
-          cargo clippy --lib --tests --all-targets --no-default-features --features manager-cacache,cacache-async-std,with-http-types,manager-moka -- -D warnings
-          cargo clippy --lib --tests --all-targets --no-default-features --features manager-cacache,cacache-tokio -- -D warnings
+          cargo clippy --lib --tests --all-targets --no-default-features --features manager-cacache,cacache-smol,with-http-types,manager-moka,streaming-smol -- -D warnings
+          cargo clippy --lib --tests --all-targets --no-default-features --features manager-cacache,cacache-tokio,with-http-types,manager-moka,streaming-tokio -- -D warnings
 
   docs:
     name: Build docs
@@ -68,4 +68,7 @@ jobs:
         env:
           RUSTFLAGS: --cfg docsrs
           RUSTDOCFLAGS: --cfg docsrs -Dwarnings
-      - run: cargo doc --no-deps --document-private-items
+      - run: |
+          cargo doc --no-deps --document-private-items
+          cargo test --doc --no-default-features --features manager-cacache,cacache-smol,with-http-types,manager-moka,streaming-smol
+          cargo test --doc --no-default-features --features manager-cacache,cacache-tokio,with-http-types,manager-moka,streaming-tokio

.github/workflows/http-cache.yml

@@ -23,6 +23,8 @@ jobs:
           - http-cache
           - http-cache-reqwest
           - http-cache-surf
+          - http-cache-tower
+          - http-cache-quickcache
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable

.github/workflows/msrv.yml

@@ -2,6 +2,6 @@ target/
 Cargo.lock
 **/*.rs.bk
 http-cacache/
-http-darkbird/
 /.idea
 /public
+/.DS_Store

.gitignore

@@ -4,5 +4,6 @@ members = [
     "http-cache",
     "http-cache-reqwest",
     "http-cache-surf",
-    "http-cache-quickcache"
+    "http-cache-quickcache",
+    "http-cache-tower"
 ]

Cargo.toml

@@ -8,6 +8,7 @@
 - [Client Implementations](./clients/clients.md)
   - [reqwest](./clients/reqwest.md)
   - [surf](./clients/surf.md)
+  - [tower](./clients/tower.md)
 - [Backend Cache Manager Implementations](./managers/managers.md)
   - [cacache](./managers/cacache.md)
   - [moka](./managers/moka.md)

docs/src/SUMMARY.md

@@ -4,8 +4,12 @@ The following client implementations are provided by this crate:
 
 ## [reqwest](./reqwest.md)
 
-The [`http-cache-reqwest`](https://github.com/06chaynes/http-cache/tree/latest/http-cache-reqwest) crate provides a [`Middleware`](https://docs.rs/http-cache/latest/http_cache/trait.Middleware.html) implementation for the [`reqwest`](https://github.com/seanmonstar/reqwest) HTTP client.
+The [`http-cache-reqwest`](https://github.com/06chaynes/http-cache/tree/main/http-cache-reqwest) crate provides a [`Middleware`](https://docs.rs/http-cache/latest/http_cache/trait.Middleware.html) implementation for the [`reqwest`](https://github.com/seanmonstar/reqwest) HTTP client.
 
 ## [surf](./surf.md)
 
-The [`http-cache-surf`](https://github.com/06chaynes/http-cache/tree/latest/http-cache-surf) crate provides a [`Middleware`](https://docs.rs/http-cache/latest/http_cache/trait.Middleware.html) implementation for the [`surf`](https://github.com/http-rs/surf) HTTP client.
+The [`http-cache-surf`](https://github.com/06chaynes/http-cache/tree/main/http-cache-surf) crate provides a [`Middleware`](https://docs.rs/http-cache/latest/http_cache/trait.Middleware.html) implementation for the [`surf`](https://github.com/http-rs/surf) HTTP client.
+
+## [tower](./tower.md)
+
+The [`http-cache-tower`](https://github.com/06chaynes/http-cache/tree/main/http-cache-tower) crate provides Tower Layer and Service implementations for caching HTTP requests and responses. It supports both regular and streaming cache operations for memory-efficient handling of large responses.

docs/src/clients/clients.md

@@ -1,6 +1,6 @@
 # reqwest
 
-The [`http-cache-reqwest`](https://github.com/06chaynes/http-cache/tree/latest/http-cache-reqwest) crate provides a [`Middleware`](https://docs.rs/http-cache/latest/http_cache/trait.Middleware.html) implementation for the [`reqwest`](https://github.com/seanmonstar/reqwest) HTTP client. It accomplishes this by utilizing [`reqwest_middleware`](https://github.com/TrueLayer/reqwest-middleware).
+The [`http-cache-reqwest`](https://github.com/06chaynes/http-cache/tree/main/http-cache-reqwest) crate provides a [`Middleware`](https://docs.rs/http-cache/latest/http_cache/trait.Middleware.html) implementation for the [`reqwest`](https://github.com/seanmonstar/reqwest) HTTP client. It accomplishes this by utilizing [`reqwest_middleware`](https://github.com/TrueLayer/reqwest-middleware).
 
 ## Getting Started