hishel 1.1.1__py3-none-any.whl → 1.1.3__py3-none-any.whl

hishel/__init__.py

@@ -27,7 +27,7 @@ from hishel._core.models import (
 from hishel._async_cache import AsyncCacheProxy as AsyncCacheProxy
 from hishel._sync_cache import SyncCacheProxy as SyncCacheProxy
 
-from hishel._policies import SpecificationPolicy, FilterPolicy, CachePolicy
+from hishel._policies import SpecificationPolicy, FilterPolicy, CachePolicy, BaseFilter
 
 __all__ = (
     # New API
@@ -62,6 +62,7 @@ __all__ = (
     "AsyncCacheProxy",
     "SyncCacheProxy",
     # Policies
+    "BaseFilter",
     "CachePolicy",
     "SpecificationPolicy",
     "FilterPolicy",

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
                 ],
@@ -2409,4 +2410,4 @@ class NeedToBeUpdated(State):
     original_request: Request
 
     def next(self) -> FromCache:
-        return FromCache(entry=self.updating_entries[-1], options=self.options)
+        return FromCache(entry=self.updating_entries[-1], options=self.options, after_revalidation=True)

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.1.dist-info → hishel-1.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.1.1
+Version: 1.1.3
 Summary:  Elegant HTTP Caching for Python
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -406,128 +406,220 @@ 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
+## What's Changed in 1.1.3
+### ⚙️ Miscellaneous Tasks
+
+* improve git-cliff docs by @karpetrosyan
+### 🐛 Bug Fixes
+
+* fix: add BaseFilter to __all__ exports by @martinblech in [#408](https://github.com/karpetrosyan/hishel/pull/408)
+* fix: set `after_revalidation=True` for `NeedsToBeUpdated` -> `FromCache` transition by @jlopex in [#402](https://github.com/karpetrosyan/hishel/pull/402)
+
+### Contributors
+* @martinblech
+* @jlopex
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.2...1.1.3
+
+## What's Changed in 1.1.2
+### 🐛 Bug Fixes
+
+* respect shared option when excluding unstorable headers by @karpetrosyan
+* remove s-maxage consideration for private caches by @karpetrosyan
+* ensure 304 responses don't leak by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+* @jlopex
 
-All notable changes to this project will be documented in this file.
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.1...1.1.2
 
-## 1.1.1 - 2025-11-01
+## What's Changed in 1.1.1
 ### ⚙️ Miscellaneous Tasks
-- Bump the python-packages group with 10 updates (#396)
 
+* chore(deps-dev): bump the python-packages group with 10 updates by @dependabot[bot] in [#396](https://github.com/karpetrosyan/hishel/pull/396)
 ### 📦 Dependencies
-- Bump actions/upload-artifact from 4 to 5 (#395)
-- Bump actions/download-artifact from 4 to 6 (#394)
-- Bump astral-sh/setup-uv from 5 to 7 (#393)
 
-## 1.1.0 - 2025-10-31
+* chore(deps): bump astral-sh/setup-uv from 5 to 7 by @dependabot[bot] in [#393](https://github.com/karpetrosyan/hishel/pull/393)
+* chore(deps): bump actions/download-artifact from 4 to 6 by @dependabot[bot] in [#394](https://github.com/karpetrosyan/hishel/pull/394)
+* chore(deps): bump actions/upload-artifact from 4 to 5 by @dependabot[bot] in [#395](https://github.com/karpetrosyan/hishel/pull/395)
+
+### Contributors
+* @karpetrosyan
+* @dependabot[bot]
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.0...1.1.1
+
+## What's Changed in 1.1.0
 ### ⚙️ Miscellaneous Tasks
-- Add in memory example
 
+* add in memory example by @karpetrosyan
 ### 🐛 Bug Fixes
-- Pass any response with non-expected status code on revalidation to client
-- Pass any response with non-expected status code on revalidation to client
 
+* pass any response with non-expected status code on revalidation to client by @karpetrosyan
+* pass any response with non-expected status code on revalidation to client by @karpetrosyan
 ### 🚀 Features
-- Allow setting storage base with via `database_path` for sqlite storage
 
-## 1.0.0 - 2025-10-28
+* allow setting storage base with via `database_path` for sqlite storage by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0...1.1.0
+
+## What's Changed in 1.0.0
 ### ⚙️ Miscellaneous Tasks
-- Add examples, improve docs
 
-## 1.0.0b1 - 2025-10-28
+* add examples, improve docs by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0b1...1.0.0
+
+## What's Changed in 1.0.0b1
 ### ♻️ Refactoring
-- Add policies
 
+* add policies by @karpetrosyan
 ### ⚙️ Miscellaneous Tasks
-- Improve sans-io diagram colors
-- Add graphql docs
 
+* add graphql docs by @karpetrosyan
+* improve sans-io diagram colors by @karpetrosyan
 ### 🐛 Bug Fixes
-- Body-sensitive responses caching
-- Filter out `Transfer-Encoding` header for asgi responses
 
+* filter out `Transfer-Encoding` header for asgi responses by @karpetrosyan
+* body-sensitive responses caching by @karpetrosyan
 ### 🚀 Features
-- Add global `use_body_key` setting
 
-## 1.0.0.dev3 - 2025-10-26
+* add global `use_body_key` setting by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.0.0.dev3...1.0.0b1
+
+## What's Changed in 1.0.0.dev3
 ### ♻️ Refactoring
-- Replace pairs with entries, simplify storage API
-- Automatically generate httpx sync integration from async
 
+* automatically generate httpx sync integration from async by @karpetrosyan
+* replace pairs with entries, simplify storage API by @karpetrosyan
 ### ⚙️ Miscellaneous Tasks
-- Simplify metadata docs
-- Add custom integrations docs
-- More robust compressed response caching
 
+* more robust compressed response caching by @karpetrosyan
+* add custom integrations docs by @karpetrosyan
+* simplify metadata docs by @karpetrosyan
 ### 🐛 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
 
+* add date header for proper age calculation by @karpetrosyan
+* handle httpx iterable usage instead of iterator correctly by @karpetrosyan
+* fix compressed data caching for requests by @karpetrosyan
+* raise on consumed httpx streams, which we can't store as is (it's already decoded) by @karpetrosyan
+* add missing permissions into `publish.yml` by @karpetrosyan
 ### 🚀 Features
-- Add integrations with fastapi and asgi
-- Add blacksheep integration examples
-- Add logging for asgi
 
-## 1.0.0.dev2 - 2025-10-21
+* add logging for asgi by @karpetrosyan
+* add blacksheep integration examples by @karpetrosyan
+* add integrations with fastapi and asgi by @karpetrosyan
+
+### Contributors
+* @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
 ### ⚙️ Miscellaneous Tasks
-- Remove redundant utils and tests
-- Add import without extras check in ci
-- Fix time travel date, explicitly specify the timezone
 
+* fix time travel date, explicitly specify the timezone by @karpetrosyan
+* add import without extras check in ci by @karpetrosyan
+* remove redundant utils and tests by @karpetrosyan
 ### 🐛 Bug Fixes
-- Fix check for storing auth requests
-- Don't raise an error on 3xx during revalidation
 
+* don't raise an error on 3xx during revalidation by @karpetrosyan
+* fix check for storing auth requests by @karpetrosyan
 ### 🚀 Features
-- Add hishel_created_at response metadata
 
-## 1.0.0.dev1 - 2025-10-21
+* add hishel_created_at response metadata by @karpetrosyan
+
+### Contributors
+* @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
 ### ⚙️ Miscellaneous Tasks
-- Remove some redundant utils methods
 
+* remove some redundant utils methods by @karpetrosyan
 ### 📦 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
+* improve git-cliff by @karpetrosyan
+* install async extra with httpx by @karpetrosyan
+* make `anysqlite` optional dependency by @karpetrosyan
+* make httpx and async libs optional dependencies by @karpetrosyan
+
+### Contributors
+* @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
 ### ⚙️ Miscellaneous Tasks
-- Use mike powered versioning
-- Improve docs versioning, deploy dev doc on ci
 
-## 0.1.5 - 2025-10-18
+* improve docs versioning, deploy dev doc on ci by @karpetrosyan
+* use mike powered versioning by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/0.1.5...1.0.0.dev0
+
+## What's Changed in 0.1.5
 ### ⚙️ Miscellaneous Tasks
-- Remove some redundant files from repo
 
+* remove some redundant files from repo by @karpetrosyan
 ### 🐛 Bug Fixes
-- Fix some line breaks
 
+* fix some line breaks by @karpetrosyan
 ### 🚀 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
+* 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)
+* better cache-control parsing by @karpetrosyan
+* set chunk size to 128KB for httpx to reduce SQLite read/writes by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/0.1.4...0.1.5
+
+## What's Changed in 0.1.4
 ### ⚙️ 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
 
+* move some tests to beta by @karpetrosyan
+* add sqlite tests for new storage by @karpetrosyan
+* temporary remove python3.14 from CI by @karpetrosyan
+* chore(internal): remove src folder by @karpetrosyan in [#373](https://github.com/karpetrosyan/hishel/pull/373)
+* chore: improve CI by @karpetrosyan in [#369](https://github.com/karpetrosyan/hishel/pull/369)
 ### 🐛 Bug Fixes
-- Create an sqlite file in a cache folder
-- Fix beta imports
 
+* fix beta imports by @karpetrosyan
+* create an sqlite file in a cache folder by @karpetrosyan
 ### 🚀 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
+
+* better async implemetation for sqlite storage by @karpetrosyan
+* get rid of some locks from sqlite storage by @karpetrosyan
+* add sqlite storage for beta storages by @karpetrosyan
+* feat: allow already consumed streams with `CacheTransport` by @jamesbraza in [#377](https://github.com/karpetrosyan/hishel/pull/377)
+* feat: add support for a sans-IO API by @karpetrosyan in [#366](https://github.com/karpetrosyan/hishel/pull/366)
+
+### Contributors
+* @karpetrosyan
+* @jamesbraza
+* @GugNersesyan
+* @dependabot[bot]
+* @mmdbalkhi
+* @AstraLuma
+* @deathaxe
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/0.1.3...0.1.4
 

{hishel-1.1.1.dist-info → hishel-1.1.3.dist-info}/RECORD

@@ -1,9 +1,9 @@
-hishel/__init__.py,sha256=XYnAlT2Wkrg0Cw5u4DLJAsC3TjWDOQJr5kqQMuXxEJI,1796
+hishel/__init__.py,sha256=1EdAEXWx41gmxUzG1Fchd_B4gQDtqlxlqQw0WkCBaUE,1826
 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=5VLwyT-eSdbez87A6xJG8T_Z3ySVcEEQp8WyTY_mhCo,102988
 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.1.dist-info/METADATA,sha256=-asM9uMqOksQJV8PucbLYqdeY5MPMz54d0bGwAsCs6E,16115
-hishel-1.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hishel-1.1.1.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
-hishel-1.1.1.dist-info/RECORD,,
+hishel-1.1.3.dist-info/METADATA,sha256=wnTvK34erjBZbe20gkt-19WumeD2OFsURe9pSQfGcuk,19884
+hishel-1.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hishel-1.1.3.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
+hishel-1.1.3.dist-info/RECORD,,