hishel 1.1.5__tar.gz → 1.1.7__tar.gz

{hishel-1.1.5 → hishel-1.1.7}/.gitignore

@@ -5,4 +5,5 @@ __pycache__/
 .cache/
 .idea/
 coverage.xml
-site
+site
+.DS_Store

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

@@ -1,3 +1,42 @@
+## 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 → hishel-1.1.7}/PKG-INFO

@@ -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 → hishel-1.1.7}/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-1.1.5 → hishel-1.1.7}/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.7}/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-1.1.5 → hishel-1.1.7}/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-1.1.5 → hishel-1.1.7}/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 → hishel-1.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hishel"
-version = "1.1.5"
+version = "1.1.7"
 dynamic = ["readme"]
 description = " Elegant HTTP Caching for Python"
 license = "BSD-3-Clause"
@@ -118,7 +118,7 @@ combine-as-imports = true
 
 [dependency-groups]
 dev = [
-    "anyio==4.11.0",
+    "anyio==4.12.0",
     "anysqlite>=0.0.5",
     "coverage==7.10.7",
     "fastapi[standard]>=0.119.1",
@@ -128,16 +128,16 @@ dev = [
     "mkdocs==1.6.1",
     "mkdocs-git-committers-plugin>=0.2.3",
     "mkdocs-git-revision-date-localized-plugin>=1.4.7",
-    "mkdocs-material==9.6.22",
-    "mypy==1.18.2",
+    "mkdocs-material==9.7.0",
+    "mypy==1.19.0",
     "pyright>=1.1.404",
     "pytest==8.4.2",
     "pytest-cov>=6.2.1",
     "pytest-icdiff>=0.9",
-    "ruff==0.14.3",
+    "ruff==0.14.7",
     "time-machine>=2.19.0",
     "trio==0.31.0",
-    "types-boto3==1.40.64",
+    "types-boto3==1.41.5",
     "types-pyyaml==6.0.12.20250915",
     "types-requests>=2.31.0.6",
     "zipp>=3.19.1",