hishel 1.1.5__tar.gz → 1.1.6__tar.gz

{hishel-1.1.5 → hishel-1.1.6}/CHANGELOG.md

@@ -1,3 +1,16 @@
+## What's Changed in 1.1.6
+### 📚 Documentation
+
+* remove some stale httpx configs by @karpetrosyan
+### 🚀 Features
+
+* Add support for request no-cache directive by @karpetrosyan in [#416](https://github.com/karpetrosyan/hishel/pull/416)
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.5...1.1.6
+
 ## What's Changed in 1.1.5
 ### 🐛 Bug Fixes
 

{hishel-1.1.5 → hishel-1.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.1.5
+Version: 1.1.6
 Summary:  Elegant HTTP Caching for Python
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -406,6 +406,19 @@ 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>
 
+## What's Changed in 1.1.6
+### 📚 Documentation
+
+* remove some stale httpx configs by @karpetrosyan
+### 🚀 Features
+
+* Add support for request no-cache directive by @karpetrosyan in [#416](https://github.com/karpetrosyan/hishel/pull/416)
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.5...1.1.6
+
 ## What's Changed in 1.1.5
 ### 🐛 Bug Fixes
 

{hishel-1.1.5 → hishel-1.1.6}/hishel/_core/_spec.py

@@ -1207,6 +1207,7 @@ class IdleClient(State):
         - Unsafe methods (POST, PUT, DELETE, etc.) are written through to origin
         - Multiple matching responses are sorted by Date header (most recent first)
         - Age header is updated when serving from cache
+        - Request no-cache directive forces revalidation of cached responses
 
         Examples:
         --------
@@ -1229,6 +1230,18 @@ class IdleClient(State):
         >>> next_state = idle.next(get_request, [cached_pair])
         >>> isinstance(next_state, NeedRevalidation)
         True
+
+        >>> # Need revalidation - request no-cache forces validation of fresh response
+        >>> idle = IdleClient(options=default_options)
+        >>> no_cache_request = Request(
+        ...     method="GET",
+        ...     url="https://example.com",
+        ...     headers=Headers({"cache-control": "no-cache"})
+        ... )
+        >>> cached_pair = CompletePair(no_cache_request, fresh_response)
+        >>> next_state = idle.next(no_cache_request, [cached_pair])
+        >>> isinstance(next_state, NeedRevalidation)
+        True
         """
 
         # ============================================================================
@@ -1388,7 +1401,31 @@ class IdleClient(State):
         ready_to_use, need_revalidation = partition(filtered_pairs, fresh_or_allowed_stale)
 
         # ============================================================================
-        # STEP 7: Determine Next State Based on Available Responses
+        # STEP 7: Handle Request no-cache Directive
+        # ============================================================================
+        # RFC 9111 Section 5.2.1.4: no-cache Request Directive
+        # https://www.rfc-editor.org/rfc/rfc9111.html#section-5.2.1.4
+        #
+        # "The no-cache request directive indicates that a cache MUST NOT use a
+        # stored response to satisfy the request without successful validation on
+        # the origin server."
+        #
+        # When a client sends Cache-Control: no-cache in the request, it's explicitly
+        # requesting that the cache not use any stored response without first validating
+        # it with the origin server. This is different from the response no-cache directive,
+        # which applies to how responses should be cached.
+        request_cache_control = parse_cache_control(request.headers.get("cache-control"))
+
+        if request_cache_control.no_cache is True:
+            # Move all fresh responses to the revalidation queue
+            # This ensures that even fresh cached responses will be validated
+            # with the origin server via conditional requests (If-None-Match,
+            # If-Modified-Since) before being served to the client.
+            need_revalidation.extend(ready_to_use)
+            ready_to_use = []
+
+        # ============================================================================
+        # STEP 8: Determine Next State Based on Available Responses
         # ============================================================================
 
         if ready_to_use:

{hishel-1.1.5 → hishel-1.1.6}/hishel/_core/_storages/_async_sqlite.py

@@ -340,8 +340,8 @@ try:
             await connection.commit()
 
         async def _is_corrupted(self, pair: Entry, cursor: anysqlite.Cursor) -> bool:
-            # if entry was created more than 1 hour ago and still has no response (incomplete)
-            if pair.meta.created_at + 3600 < time.time() and not self._is_stream_complete(pair.id, cursor):
+            # if entry was created more than 1 hour ago and still has no full response data
+            if pair.meta.created_at + 3600 < time.time() and not (await self._is_stream_complete(pair.id, cursor)):
                 return True
             return False
 

{hishel-1.1.5 → hishel-1.1.6}/hishel/_core/_storages/_sync_sqlite.py

@@ -340,8 +340,8 @@ try:
             connection.commit()
 
         def _is_corrupted(self, pair: Entry, cursor: sqlite3.Cursor) -> bool:
-            # if entry was created more than 1 hour ago and still has no response (incomplete)
-            if pair.meta.created_at + 3600 < time.time() and not self._is_stream_complete(pair.id, cursor):
+            # if entry was created more than 1 hour ago and still has no full response data
+            if pair.meta.created_at + 3600 < time.time() and not (self._is_stream_complete(pair.id, cursor)):
                 return True
             return False
 

{hishel-1.1.5 → hishel-1.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hishel"
-version = "1.1.5"
+version = "1.1.6"
 dynamic = ["readme"]
 description = " Elegant HTTP Caching for Python"
 license = "BSD-3-Clause"