hishel 1.1.4__py3-none-any.whl → 1.1.6__py3-none-any.whl

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/_core/_storages/_async_sqlite.py

@@ -161,8 +161,19 @@ try:
             for row in await cursor.fetchall():
                 pair_data = unpack(row[1], kind="pair")
 
+                if pair_data is None:
+                    continue
+
                 # Skip entries without a response (incomplete)
-                if not isinstance(pair_data, Entry) or pair_data.response is None:
+                if not await self._is_stream_complete(pair_data.id, cursor=cursor):
+                    continue
+
+                # Skip expired entries
+                if await self._is_pair_expired(pair_data, cursor=cursor):
+                    continue
+
+                # Skip soft-deleted entries
+                if self.is_soft_deleted(pair_data):
                     continue
 
                 final_pairs.append(pair_data)
@@ -329,16 +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 pair.response is None:
-                return True
-
-            # Check if response stream is complete for Entry with response
-            if (
-                isinstance(pair, Entry)
-                and pair.response is not None
-                and not await 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/_core/_storages/_sync_sqlite.py

@@ -161,8 +161,19 @@ try:
             for row in cursor.fetchall():
                 pair_data = unpack(row[1], kind="pair")
 
+                if pair_data is None:
+                    continue
+
                 # Skip entries without a response (incomplete)
-                if not isinstance(pair_data, Entry) or pair_data.response is None:
+                if not self._is_stream_complete(pair_data.id, cursor=cursor):
+                    continue
+
+                # Skip expired entries
+                if self._is_pair_expired(pair_data, cursor=cursor):
+                    continue
+
+                # Skip soft-deleted entries
+                if self.is_soft_deleted(pair_data):
                     continue
 
                 final_pairs.append(pair_data)
@@ -329,16 +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 pair.response is None:
-                return True
-
-            # Check if response stream is complete for Entry with response
-            if (
-                isinstance(pair, Entry)
-                and pair.response is not None
-                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.4.dist-info → hishel-1.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.1.4
+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,29 @@ 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
+
+* filter out soft-deleted, expired and incomplete entries in `get_entries` by @karpetrosyan
+
+### Contributors
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.4...1.1.5
+
 ## What's Changed in 1.1.4
 ### 🐛 Bug Fixes
 

{hishel-1.1.4.dist-info → hishel-1.1.6.dist-info}/RECORD

@@ -11,14 +11,14 @@ hishel/httpx.py,sha256=99a8X9COPiPHSgGW61O2uMWMZB7dY93Ty9DTCJ9C18Q,467
 hishel/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hishel/requests.py,sha256=F3BntFGeesm19NmWFgGoBg-rfkcIs9OTpXDass73t6w,6819
 hishel/_core/_headers.py,sha256=hGaT6o1F-gs1pm5RpdGb0IMQL3uJYDH1xpwJLy28Cys,17514
-hishel/_core/_spec.py,sha256=5VLwyT-eSdbez87A6xJG8T_Z3ySVcEEQp8WyTY_mhCo,102988
+hishel/_core/_spec.py,sha256=26mrK0MFSN_03ZecKem0asHYCXqzJ0tmcVmJXG7VHeI,105016
 hishel/_core/models.py,sha256=EabP2qnjYVzhPWhQer3QFmdDE6TDbqEBEqPHzv25VnA,7978
 hishel/_core/_storages/_async_base.py,sha256=iZ6Mb30P0ho5h4UU5bgOrcsSMZ1427j9tht-tupZs68,2106
-hishel/_core/_storages/_async_sqlite.py,sha256=h22qGIQk8ceo9_rKtptEw7LszWCmb3aPwE1_DXOTDXc,15843
+hishel/_core/_storages/_async_sqlite.py,sha256=IDMbtmbQ8e12HUlNJGyn6SIYColupuIbtvGfNl47_pM,15916
 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=ZO_FnK4IH014plPHuhzM7PfZklNAmUhTeOfGFJh9U8c,15324
-hishel-1.1.4.dist-info/METADATA,sha256=Yivm81fEo6fXTN5uHNCMnVX-Mrnfks1hQk-7QTT9Tm4,20188
-hishel-1.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hishel-1.1.4.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
-hishel-1.1.4.dist-info/RECORD,,
+hishel/_core/_storages/_sync_sqlite.py,sha256=MidCVhhzlf2bZQ2_UzZzh0r_14HGZpFEomkGU5POjuk,15385
+hishel-1.1.6.dist-info/METADATA,sha256=xQuRX_gSxX_sqXkwKnH7Mtsft7tUfym5L05CfbKeog4,20803
+hishel-1.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hishel-1.1.6.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
+hishel-1.1.6.dist-info/RECORD,,