hishel 1.1.0__py3-none-any.whl → 1.1.2__py3-none-any.whl

hishel/_async_httpx.py

@@ -174,6 +174,9 @@ class AsyncCacheTransport(httpx.AsyncBaseTransport):
     async def request_sender(self, request: Request) -> Response:
         httpx_request = _internal_to_httpx(request)
         httpx_response = await self.next_transport.handle_async_request(httpx_request)
+        if httpx_response.status_code == 304:
+            # 304 should not have a body, but we read it to ensure we'll not let the stream unconsumed
+            await httpx_response.aread()
         return _httpx_to_internal(httpx_response)
 
 

hishel/_core/_spec.py

@@ -996,6 +996,7 @@ def exclude_unstorable_headers(response: Response, is_cache_shared: bool) -> Res
 def refresh_response_headers(
     stored_response: Response,
     revalidation_response: Response,
+    is_cache_shared: bool,
 ) -> Response:
     """
     Updates a stored response's headers with fresh metadata from a 304 response.
@@ -1108,7 +1109,7 @@ def refresh_response_headers(
             stored_response,
             headers=Headers(new_headers),
         ),
-        is_cache_shared=True,  # Assume shared cache for maximum safety
+        is_cache_shared,
     )
 
 
@@ -1337,7 +1338,7 @@ class IdleClient(State):
             "A cache MUST NOT generate a stale response unless it is disconnected or
             doing so is explicitly permitted by the client or origin server."
             """
-            freshness_lifetime = get_freshness_lifetime(pair.response, is_cache_shared=True)
+            freshness_lifetime = get_freshness_lifetime(pair.response, self.options.shared)
             age = get_age(pair.response)
 
             # Check freshness: response_is_fresh = (freshness_lifetime > current_age)
@@ -2245,7 +2246,7 @@ class NeedRevalidation(State):
                 updating_entries=[
                     replace(
                         pair,
-                        response=refresh_response_headers(pair.response, revalidation_response),
+                        response=refresh_response_headers(pair.response, revalidation_response, self.options.shared),
                     )
                     for pair in identified_for_revalidation
                 ],

hishel/_sync_httpx.py

@@ -174,6 +174,9 @@ class SyncCacheTransport(httpx.BaseTransport):
     def request_sender(self, request: Request) -> Response:
         httpx_request = _internal_to_httpx(request)
         httpx_response = self.next_transport.handle_request(httpx_request)
+        if httpx_response.status_code == 304:
+            # 304 should not have a body, but we read it to ensure we'll not let the stream unconsumed
+            httpx_response.read()
         return _httpx_to_internal(httpx_response)
 
 

{hishel-1.1.0.dist-info → hishel-1.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.1.0
+Version: 1.1.2
 Summary:  Elegant HTTP Caching for Python
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -406,118 +406,198 @@ Hishel is inspired by and builds upon the excellent work in the Python HTTP ecos
   <strong>Made with ❤️ by <a href="https://github.com/karpetrosyan">Kar Petrosyan</a></strong>
 </p>
 
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## 1.1.0 - 2025-10-31
-### ⚙️ Miscellaneous Tasks
-- Add in memory example
-
-### 🐛 Bug Fixes
-- Pass any response with non-expected status code on revalidation to client
-
-### 🚀 Features
-- Allow setting storage base with via `database_path` for sqlite storage
-
-## 1.0.0 - 2025-10-28
-### ⚙️ Miscellaneous Tasks
-- Add examples, improve docs
-
-## 1.0.0b1 - 2025-10-28
-### ♻️ Refactoring
-- Add policies
-
-### ⚙️ Miscellaneous Tasks
-- Improve sans-io diagram colors
-- Add graphql docs
-
-### 🐛 Bug Fixes
-- Body-sensitive responses caching
-- Filter out `Transfer-Encoding` header for asgi responses
-
-### 🚀 Features
-- Add global `use_body_key` setting
-
-## 1.0.0.dev3 - 2025-10-26
-### ♻️ Refactoring
-- Replace pairs with entries, simplify storage API
-- Automatically generate httpx sync integration from async
-
-### ⚙️ Miscellaneous Tasks
-- Simplify metadata docs
-- Add custom integrations docs
-- More robust compressed response caching
-
-### 🐛 Bug Fixes
-- Add missing permissions into `publish.yml`
-- Raise on consumed httpx streams, which we can't store as is (it's already decoded)
-- Fix compressed data caching for requests
-- Handle httpx iterable usage instead of iterator correctly
-- Add date header for proper age calculation
-
-### 🚀 Features
-- Add integrations with fastapi and asgi
-- Add blacksheep integration examples
-- Add logging for asgi
-
-## 1.0.0.dev2 - 2025-10-21
-### ⚙️ Miscellaneous Tasks
-- Remove redundant utils and tests
-- Add import without extras check in ci
-- Fix time travel date, explicitly specify the timezone
-
-### 🐛 Bug Fixes
-- Fix check for storing auth requests
-- Don't raise an error on 3xx during revalidation
-
-### 🚀 Features
-- Add hishel_created_at response metadata
-
-## 1.0.0.dev1 - 2025-10-21
-### ⚙️ Miscellaneous Tasks
-- Remove some redundant utils methods
-
-### 📦 Dependencies
-- Make httpx and async libs optional dependencies
-- Make `anysqlite` optional dependency
-- Install async extra with httpx
-- Improve git-cliff
-
-## 1.0.0.dev0 - 2025-10-19
-### ⚙️ Miscellaneous Tasks
-- Use mike powered versioning
-- Improve docs versioning, deploy dev doc on ci
-
-## 0.1.5 - 2025-10-18
-### ⚙️ Miscellaneous Tasks
-- Remove some redundant files from repo
-
-### 🐛 Bug Fixes
-- Fix some line breaks
-
-### 🚀 Features
-- Set chunk size to 128KB for httpx to reduce SQLite read/writes
-- Better cache-control parsing
-- Add close method to storages API (#384)
-- Increase requests buffer size to 128KB, disable charset detection
-
-## 0.1.4 - 2025-10-14
-### ⚙️ Miscellaneous Tasks
-- Improve CI (#369)
-- Remove src folder (#373)
-- Temporary remove python3.14 from CI
-- Add sqlite tests for new storage
-- Move some tests to beta
-
-### 🐛 Bug Fixes
-- Create an sqlite file in a cache folder
-- Fix beta imports
-
-### 🚀 Features
-- Add support for a sans-IO API (#366)
-- Allow already consumed streams with `CacheTransport` (#377)
-- Add sqlite storage for beta storages
-- Get rid of some locks from sqlite storage
-- Better async implemetation for sqlite storage
-
+## What's Changed in 1.1.2
+* fix: respect shared option when excluding unstorable headers by @karpetrosyan
+* fix: remove s-maxage consideration for private caches by @karpetrosyan
+* fix: respect shared option when excluding unstorable headers by @jlopex in [#401](https://github.com/karpetrosyan/hishel/pull/401)
+* fix: remove s-maxage consideration for private caches by @jlopex in [#400](https://github.com/karpetrosyan/hishel/pull/400)
+* fix: ensure 304 responses don't leak by @karpetrosyan
+
+## New Contributors
+* @jlopex made their first contribution in [#401](https://github.com/karpetrosyan/hishel/pull/401)
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.1...1.1.2
+
+## What's Changed in 1.1.1
+* Revert "Revert "chore(deps): bump actions/upload-artifact from 4 to 5 "" by @karpetrosyan
+* Revert "chore(deps): bump actions/download-artifact from 4 to 6 " by @karpetrosyan
+* Revert "chore(deps): bump actions/upload-artifact from 4 to 5 " by @karpetrosyan
+* update uv.lock by @karpetrosyan
+* Version 1.1.1 by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.0...1.1.1
+
+## What's Changed in 1.1.0
+* Version 1.1.0 by @karpetrosyan
+* fix: pass any response with non-expected status code on revalidation to client by @karpetrosyan
+* fix: pass any response with non-expected status code on revalidation to client by @karpetrosyan
+* feat: allow setting storage base with via `database_path` for sqlite storage by @karpetrosyan
+* fix in memory example by @karpetrosyan
+* chore: add in memory example by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0...1.1.0
+
+## What's Changed in 1.0.0
+* Version 1.0.0 by @karpetrosyan
+* chore(docs): add examples, improve docs by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0b1...1.0.0
+
+## What's Changed in 1.0.0b1
+* Version 1.0.0b1 by @karpetrosyan
+* improve docs by @karpetrosyan
+* fix: filter out `Transfer-Encoding` header for asgi responses by @karpetrosyan
+* fix body sensitive docs by @karpetrosyan
+* refactor: add policies by @karpetrosyan
+* chore(docs): add graphql docs by @karpetrosyan
+* feat: add global `use_body_key` setting by @karpetrosyan
+* chore(docs): improve sans-io diagram colors by @karpetrosyan
+* fix: body-sensitive responses caching by @karpetrosyan
+* mention body sensitive content caching by @karpetrosyan
+* clean up roadmap by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0.dev3...1.0.0b1
+
+## What's Changed in 1.0.0.dev3
+* Version 1.0.0.dev3 by @karpetrosyan
+* fix ci by @karpetrosyan
+* fix: add date header for proper age calculation by @karpetrosyan
+* rename some methods by @karpetrosyan
+* refactor: automatically generate httpx sync integration from async by @karpetrosyan
+* change pairs to entries in some places by @karpetrosyan
+* fix lint format by @karpetrosyan
+* refactor: replace pairs with entries, simplify storage API by @karpetrosyan
+* better docs by @karpetrosyan
+* better custom integrations docs by @karpetrosyan
+* more private by @karpetrosyan
+* fix lint, make things private by @karpetrosyan
+* dont fail if unasync rule was not used by @karpetrosyan
+* chore: more robust compressed response caching by @karpetrosyan
+* chore(docs): add custom integrations docs by @karpetrosyan
+* feat: add logging for asgi by @karpetrosyan
+* fix: handle httpx iterable usage instead of iterator correctly by @karpetrosyan
+* feat: add blacksheep integration examples by @karpetrosyan
+* Change note syntax for ASGI middleware by @karpetrosyan
+* fix lint by @karpetrosyan
+* feat: add integrations with fastapi and asgi by @karpetrosyan
+* fix readme by @karpetrosyan
+* add icon for introduction page by @karpetrosyan
+* fix test by @karpetrosyan
+* properly close resource by @karpetrosyan
+* fix: fix compressed data caching for requests by @karpetrosyan
+* fix: raise on consumed httpx streams, which we can't store as is (it's already decoded) by @karpetrosyan
+* chore(docs): simplify metadata docs by @karpetrosyan
+* fix: add missing permissions into `publish.yml` by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0.dev2...1.0.0.dev3
+
+## What's Changed in 1.0.0.dev2
+* Version 1.0.0.dev2 by @karpetrosyan
+* unasync by @karpetrosyan
+* chore: fix time travel date, explicitly specify the timezone by @karpetrosyan
+* fix: don't raise an error on 3xx during revalidation by @karpetrosyan
+* chore: add import without extras check in ci by @karpetrosyan
+* chore(internal): remove redundant utils and tests by @karpetrosyan
+* feat: add hishel_created_at response metadata by @karpetrosyan
+* fix: fix check for storing auth requests by @karpetrosyan
+* better git-cliff by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0.dev1...1.0.0.dev2
+
+## What's Changed in 1.0.0.dev1
+* Version 1.0.0.dev1 by @karpetrosyan
+* fix changelog + uv lock by @karpetrosyan
+* fix linting by @karpetrosyan
+* chore(internal): remove some redundant utils methods by @karpetrosyan
+* fix mike deploy by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0.dev0...1.0.0.dev1
+
+## What's Changed in 1.0.0.dev0
+* fix publish.yml by @karpetrosyan
+* fix format by @karpetrosyan
+* prepare 1.0.0.dev0 release by @karpetrosyan
+* improve `CacheOptions` docs by @karpetrosyan
+* don't make release version latest by default by @karpetrosyan
+* fix changelog by @karpetrosyan
+* fix action permissions by @karpetrosyan
+* improve docs introduction by @karpetrosyan
+* better docs publishing, better project description by @karpetrosyan
+* fix docs publishing by @karpetrosyan
+* fix docs deploying by @karpetrosyan
+* chore(docs): improve docs versioning, deploy dev doc on ci by @karpetrosyan
+* fix unasync by @karpetrosyan
+* fix unasync by @karpetrosyan
+* fix unasync by @karpetrosyan
+* Version 1.0.0.dev0 by @karpetrosyan
+* chore(docs): use mike powered versioning by @karpetrosyan
+* fix changelog by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/0.1.5...1.0.0.dev0
+
+## What's Changed in 0.1.5
+* Version 0.1.5 by @karpetrosyan in [#385](https://github.com/karpetrosyan/hishel/pull/385)
+* feat(perf): increase requests buffer size to 128KB, disable charset detection by @karpetrosyan
+* feat: add close method to storages API by @karpetrosyan in [#384](https://github.com/karpetrosyan/hishel/pull/384)
+* fix headers by @karpetrosyan
+* fix lint by @karpetrosyan
+* ruff format by @karpetrosyan
+* feat: better cache-control parsing by @karpetrosyan
+* feat(perf): set chunk size to 128KB for httpx to reduce SQLite read/writes by @karpetrosyan
+* fix(docs): fix some line breaks by @karpetrosyan
+* chore: remove some redundant files from repo by @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/0.1.4...0.1.5
+
+## What's Changed in 0.1.4
+* Version 0.1.4 by @karpetrosyan in [#381](https://github.com/karpetrosyan/hishel/pull/381)
+* fix lint by @karpetrosyan
+* more docs! by @karpetrosyan
+* ensure connection is not stored by @karpetrosyan
+* fix annotations by @karpetrosyan
+* fix typing by @karpetrosyan
+* format by @karpetrosyan
+* more docs! more tests! by @karpetrosyan
+* lot of fixes by @karpetrosyan
+* remove redundant files by @karpetrosyan
+* remove docs footer by @karpetrosyan
+* fix: fix beta imports by @karpetrosyan
+* uv lock by @karpetrosyan
+* fix: create an sqlite file in a cache folder by @karpetrosyan
+* better unasync by @karpetrosyan
+* feat: better async implemetation for sqlite storage by @karpetrosyan
+* feat: get rid of some locks from sqlite storage by @karpetrosyan
+* chore(tests): move some tests to beta by @karpetrosyan
+* fix tests by @karpetrosyan
+* fix tests by @karpetrosyan
+* fix lint by @karpetrosyan
+* chore(tests): add sqlite tests for new storage by @karpetrosyan
+* feat: add sqlite storage for beta storages by @karpetrosyan
+* Adding `.venv` to `.gitignore` by @jamesbraza in [#379](https://github.com/karpetrosyan/hishel/pull/379)
+* Revert "add ethical ads" by @karpetrosyan
+* add ethical ads by @karpetrosyan
+* feat: allow already consumed streams with `CacheTransport` by @jamesbraza in [#377](https://github.com/karpetrosyan/hishel/pull/377)
+* chore(ci): fix lint script by @GugNersesyan in [#375](https://github.com/karpetrosyan/hishel/pull/375)
+* chore(internal): temporary remove python3.14 from CI by @karpetrosyan
+* chore(internal): remove src folder by @karpetrosyan in [#373](https://github.com/karpetrosyan/hishel/pull/373)
+* New storage API by @karpetrosyan in [#359](https://github.com/karpetrosyan/hishel/pull/359)
+* chore: improve CI by @karpetrosyan in [#369](https://github.com/karpetrosyan/hishel/pull/369)
+* feat: add support for a sans-IO API by @karpetrosyan in [#366](https://github.com/karpetrosyan/hishel/pull/366)
+* Enhance documentation with donation link by @karpetrosyan in [#368](https://github.com/karpetrosyan/hishel/pull/368)
+* Update README to include donation link by @karpetrosyan in [#367](https://github.com/karpetrosyan/hishel/pull/367)
+* Added `Metadata` to public API by @jamesbraza in [#363](https://github.com/karpetrosyan/hishel/pull/363)
+* Bump the python-packages group with 10 updates by @dependabot[bot] in [#354](https://github.com/karpetrosyan/hishel/pull/354)
+* skip anysqlite, yaml and redis tests if optional deps are missing by @mmdbalkhi in [#348](https://github.com/karpetrosyan/hishel/pull/348)
+* Don't bomb if directory creation races by @AstraLuma in [#353](https://github.com/karpetrosyan/hishel/pull/353)
+* Cleanup module imports by @deathaxe in [#351](https://github.com/karpetrosyan/hishel/pull/351)
+
+## New Contributors
+* @jamesbraza made their first contribution in [#379](https://github.com/karpetrosyan/hishel/pull/379)
+* @GugNersesyan made their first contribution in [#375](https://github.com/karpetrosyan/hishel/pull/375)
+* @mmdbalkhi made their first contribution in [#348](https://github.com/karpetrosyan/hishel/pull/348)
+* @AstraLuma made their first contribution in [#353](https://github.com/karpetrosyan/hishel/pull/353)
+* @deathaxe made their first contribution in [#351](https://github.com/karpetrosyan/hishel/pull/351)
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/0.1.3...0.1.4
+
+<!-- generated by git-cliff -->

{hishel-1.1.0.dist-info → hishel-1.1.2.dist-info}/RECORD

@@ -1,9 +1,9 @@
 hishel/__init__.py,sha256=XYnAlT2Wkrg0Cw5u4DLJAsC3TjWDOQJr5kqQMuXxEJI,1796
 hishel/_async_cache.py,sha256=4wm6YBL9ClNOg4WbEkALTJVCIXuzQU80MVem2C3hHrQ,8785
-hishel/_async_httpx.py,sha256=WB35o7CseRDz89dpqoWNLXYEkDxqeSo709eR3oPXP7Q,7536
+hishel/_async_httpx.py,sha256=_-M5BEIyhrPiWJYy-zX0XbAvGFY6NLDdKtfiLt6Io6c,7726
 hishel/_policies.py,sha256=1ae_rmDF7oaG91-lQyOGVaTrRX8uI2GImmu5gN6WJa4,1135
 hishel/_sync_cache.py,sha256=k0AN0M--yR4Jc6SiAreaxPUFiwEt5Dx7wi9jqW9sy50,8510
-hishel/_sync_httpx.py,sha256=FbnJrdoLftPDVNUzYkAtz-JOTNtiBPJ2c1ZOcU0JnmE,7368
+hishel/_sync_httpx.py,sha256=0wVXeapkFqWtsLq1xtlTpvL-TQ5T6HUyQ7RK4Kz0GMA,7551
 hishel/_utils.py,sha256=kR7RnhFqLzFRmB-YNnZteQVP0iDPUouCscA0_FHHFls,3837
 hishel/asgi.py,sha256=ocXzqrrYGazeJxlKFcz1waoKvKGOqJ7YBEAmly4Towk,14998
 hishel/fastapi.py,sha256=CVWCyXTxBPwG_XALo-Oldekv4lqMgH2-W-PPZ9rZjXg,10826
@@ -11,14 +11,14 @@ hishel/httpx.py,sha256=99a8X9COPiPHSgGW61O2uMWMZB7dY93Ty9DTCJ9C18Q,467
 hishel/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hishel/requests.py,sha256=FbOBMvgNSWkH0Bh0qZdr-dhCYG6siR5Lmxcu5eMay3s,6409
 hishel/_core/_headers.py,sha256=hGaT6o1F-gs1pm5RpdGb0IMQL3uJYDH1xpwJLy28Cys,17514
-hishel/_core/_spec.py,sha256=YfZfMYS4--o0v-AQZ37vVzHfc-Mh-SEHcl9SrBM9Y7Y,102963
+hishel/_core/_spec.py,sha256=i4Gf0Z8Zku2qkTdNmKp2mN2gUkVWGVi57GAdqcCkcvI,102963
 hishel/_core/models.py,sha256=EabP2qnjYVzhPWhQer3QFmdDE6TDbqEBEqPHzv25VnA,7978
 hishel/_core/_storages/_async_base.py,sha256=iZ6Mb30P0ho5h4UU5bgOrcsSMZ1427j9tht-tupZs68,2106
 hishel/_core/_storages/_async_sqlite.py,sha256=QZEWroGZKGhCMf7CcYpZfKZdKd88R8elQCoPge0Khxc,15674
 hishel/_core/_storages/_packing.py,sha256=mC8LMFQ5uPfFOgingKm2WKFO_DwcZ1OjTgI6xc0hfJI,3708
 hishel/_core/_storages/_sync_base.py,sha256=qfOvcFY5qvrzSh4ztV2Trlxft-BF7An5SFsLlEb8EeE,2075
 hishel/_core/_storages/_sync_sqlite.py,sha256=P3vIp636tTtM553-sBTZkam3-sNv0EEkh1rRSd1Qw90,15167
-hishel-1.1.0.dist-info/METADATA,sha256=08BqqoUdS_tMtsQyo4JTS5mOuASXLW1cs5S_PrSAuGM,15759
-hishel-1.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hishel-1.1.0.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
-hishel-1.1.0.dist-info/RECORD,,
+hishel-1.1.2.dist-info/METADATA,sha256=JN9YiWi9__uIBUbq0YIuMNqwbpNqJ1RPwz_fu6Bd1Ok,22965
+hishel-1.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hishel-1.1.2.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
+hishel-1.1.2.dist-info/RECORD,,