hishel 1.1.5__py3-none-any.whl → 1.1.7__py3-none-any.whl

hishel/_async_cache.py

@@ -197,12 +197,12 @@ class AsyncCacheProxy:
         return state.next(revalidation_response)
 
     async def _handle_update(self, state: NeedToBeUpdated) -> AnyState:
-        for entry in state.updating_entries:
+        for updating_entry in state.updating_entries:
             await self.storage.update_entry(
-                entry.id,
-                lambda entry: replace(
-                    entry,
-                    response=replace(entry.response, headers=entry.response.headers),
+                updating_entry.id,
+                lambda existing_entry: replace(
+                    existing_entry,
+                    response=replace(existing_entry.response, headers=updating_entry.response.headers),
                 ),
             )
         return state.next()

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

@@ -43,16 +43,12 @@ try:
             self,
             *,
             connection: Optional[anysqlite.Connection] = None,
-            database_path: str = "hishel_cache.db",
+            database_path: Union[str, Path] = "hishel_cache.db",
             default_ttl: Optional[float] = None,
             refresh_ttl_on_access: bool = True,
         ) -> None:
-            db_path = Path(database_path)
-
             self.connection = connection
-            self.database_path = (
-                ensure_cache_dict(db_path.parent if db_path.parent != Path(".") else None) / db_path.name
-            )
+            self.database_path: Path = database_path if isinstance(database_path, Path) else Path(database_path)
             self.default_ttl = default_ttl
             self.refresh_ttl_on_access = refresh_ttl_on_access
             self.last_cleanup = time.time() - BATCH_CLEANUP_INTERVAL + BATCH_CLEANUP_START_DELAY
@@ -63,7 +59,10 @@ try:
         async def _ensure_connection(self) -> anysqlite.Connection:
             """Ensure connection is established and database is initialized."""
             if self.connection is None:
-                self.connection = await anysqlite.connect(str(self.database_path))
+                # Create cache directory and resolve full path on first connection
+                parent = self.database_path.parent if self.database_path.parent != Path(".") else None
+                full_path = ensure_cache_dict(parent) / self.database_path.name
+                self.connection = await anysqlite.connect(str(full_path))
             if not self._initialized:
                 await self._initialize_database()
                 self._initialized = True
@@ -340,8 +339,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
 
@@ -421,6 +420,7 @@ try:
                     break
                 yield chunk
                 chunk_number += 1
+
 except ImportError:
 
     class AsyncSqliteStorage:  # type: ignore[no-redef]

hishel/_core/_storages/_sync_sqlite.py

@@ -43,16 +43,12 @@ try:
             self,
             *,
             connection: Optional[sqlite3.Connection] = None,
-            database_path: str = "hishel_cache.db",
+            database_path: Union[str, Path] = "hishel_cache.db",
             default_ttl: Optional[float] = None,
             refresh_ttl_on_access: bool = True,
         ) -> None:
-            db_path = Path(database_path)
-
             self.connection = connection
-            self.database_path = (
-                ensure_cache_dict(db_path.parent if db_path.parent != Path(".") else None) / db_path.name
-            )
+            self.database_path: Path = database_path if isinstance(database_path, Path) else Path(database_path)
             self.default_ttl = default_ttl
             self.refresh_ttl_on_access = refresh_ttl_on_access
             self.last_cleanup = time.time() - BATCH_CLEANUP_INTERVAL + BATCH_CLEANUP_START_DELAY
@@ -63,7 +59,10 @@ try:
         def _ensure_connection(self) -> sqlite3.Connection:
             """Ensure connection is established and database is initialized."""
             if self.connection is None:
-                self.connection = sqlite3.connect(str(self.database_path))
+                # Create cache directory and resolve full path on first connection
+                parent = self.database_path.parent if self.database_path.parent != Path(".") else None
+                full_path = ensure_cache_dict(parent) / self.database_path.name
+                self.connection = sqlite3.connect(str(full_path))
             if not self._initialized:
                 self._initialize_database()
                 self._initialized = True
@@ -340,8 +339,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
 
@@ -421,6 +420,7 @@ try:
                     break
                 yield chunk
                 chunk_number += 1
+
 except ImportError:
 
     class SyncSqliteStorage:  # type: ignore[no-redef]

hishel/_sync_cache.py

@@ -197,12 +197,12 @@ class SyncCacheProxy:
         return state.next(revalidation_response)
 
     def _handle_update(self, state: NeedToBeUpdated) -> AnyState:
-        for entry in state.updating_entries:
+        for updating_entry in state.updating_entries:
             self.storage.update_entry(
-                entry.id,
-                lambda entry: replace(
-                    entry,
-                    response=replace(entry.response, headers=entry.response.headers),
+                updating_entry.id,
+                lambda existing_entry: replace(
+                    existing_entry,
+                    response=replace(existing_entry.response, headers=updating_entry.response.headers),
                 ),
             )
         return state.next()

{hishel-1.1.5.dist-info → hishel-1.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.1.5
+Version: 1.1.7
 Summary:  Elegant HTTP Caching for Python
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -406,6 +406,45 @@ 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.7
+### ♻️ Refactoring
+
+* refactor(storage): create sqlite database path only when creating connections by @jeefberkey in [#426](https://github.com/karpetrosyan/hishel/pull/426)
+### ⚙️ Miscellaneous Tasks
+
+* chore(deps-dev): bump the python-packages group with 5 updates by @dependabot[bot] in [#424](https://github.com/karpetrosyan/hishel/pull/424)
+### 🐛 Bug Fixes
+
+* fix(cache): Lambda parameter name clashes the loop variable being closed over by @dump247 in [#427](https://github.com/karpetrosyan/hishel/pull/427)
+### 📚 Documentation
+
+* add release process guidelines for maintainers by @karpetrosyan
+### 🚀 Features
+
+* Feature/accept pathlib path in SqliteStorage by @daudef in [#419](https://github.com/karpetrosyan/hishel/pull/419)
+
+### Contributors
+* @daudef
+* @dependabot[bot]
+* @jeefberkey
+* @dump247
+* @karpetrosyan
+
+**Full Changelog**: https://github.com/karpetrosyan/hishel/compare/1.1.6...1.1.7
+
+## 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.dist-info → hishel-1.1.7.dist-info}/RECORD

@@ -1,8 +1,8 @@
 hishel/__init__.py,sha256=1EdAEXWx41gmxUzG1Fchd_B4gQDtqlxlqQw0WkCBaUE,1826
-hishel/_async_cache.py,sha256=4wm6YBL9ClNOg4WbEkALTJVCIXuzQU80MVem2C3hHrQ,8785
+hishel/_async_cache.py,sha256=QprSuucR6OXYWNVS9lzM1jHjUEC33AGq8zpUT27Cngs,8839
 hishel/_async_httpx.py,sha256=89i92f2SlvgWrav_TDNU1iUzMxdR607apauxXA3pE3U,8127
 hishel/_policies.py,sha256=1ae_rmDF7oaG91-lQyOGVaTrRX8uI2GImmu5gN6WJa4,1135
-hishel/_sync_cache.py,sha256=k0AN0M--yR4Jc6SiAreaxPUFiwEt5Dx7wi9jqW9sy50,8510
+hishel/_sync_cache.py,sha256=afM1MfBlT3kitBJX-YmDEJ4i6Kc1d0A4PcrvCL6LlPI,8564
 hishel/_sync_httpx.py,sha256=z1pwVUQfRf72Q48PXXZ4FKwXGevll0X5iHcVRANiP38,7952
 hishel/_utils.py,sha256=kR7RnhFqLzFRmB-YNnZteQVP0iDPUouCscA0_FHHFls,3837
 hishel/asgi.py,sha256=ocXzqrrYGazeJxlKFcz1waoKvKGOqJ7YBEAmly4Towk,14998
@@ -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=L1772hba8Onpu7zyEVx74ouFEgQFILuo4xY73BHg8SI,15911
+hishel/_core/_storages/_async_sqlite.py,sha256=3h1VEYGaiWdr-q3XT30MYPLBEN2R7g96BfUG5-hsRqM,16102
 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=_d5d4ApZ-CTFY_frs4iehBbn0buQ0zcdRL5RF40MPo4,15386
-hishel-1.1.5.dist-info/METADATA,sha256=dWg7HdttEhW6yjA1Em9ye-wy9bmOa_uXMgyoB_MZngc,20444
-hishel-1.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hishel-1.1.5.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
-hishel-1.1.5.dist-info/RECORD,,
+hishel/_core/_storages/_sync_sqlite.py,sha256=t8OAVhydr56SDFditvhjpUwt_Nco4dAKEv7-bRPMPgM,15571
+hishel-1.1.7.dist-info/METADATA,sha256=1crLOlKwSXnos2wCQ0fb0BWU42_hBR_unEcAGHLAX3c,21752
+hishel-1.1.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hishel-1.1.7.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
+hishel-1.1.7.dist-info/RECORD,,