hishel 0.1.3__tar.gz → 0.1.5__tar.gz

{hishel-0.1.3 → hishel-0.1.5}/.gitignore

@@ -1,5 +1,7 @@
+.venv/
 venv/
 __pycache__/
 .coverage
 .cache/
-.idea/
+.idea/
+coverage.xml

hishel-0.1.5/CHANGELOG.md

@@ -0,0 +1,64 @@
+## [0.1.5] - 2025-10-18
+
+### 🚀 Features
+
+- *(perf)* Set chunk size to 128KB for httpx to reduce SQLite read/writes
+- Better cache-control parsing
+- Add close method to storages API (#384)
+- *(perf)* Increase requests buffer size to 128KB, disable charset detection
+
+### 🐛 Bug Fixes
+
+- *(docs)* Fix some line breaks
+
+### ⚙️ Miscellaneous Tasks
+
+- Remove some redundant files from repo
+## [0.1.4] - 2025-10-14
+
+### 🚀 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
+
+### 🐛 Bug Fixes
+
+- Create an sqlite file in a cache folder
+- Fix beta imports
+
+### ⚙️ Miscellaneous Tasks
+
+- Improve CI (#369)
+- *(internal)* Remove src folder (#373)
+- *(internal)* Temporary remove python3.14 from CI
+- *(tests)* Add sqlite tests for new storage
+- *(tests)* Move some tests to beta
+## [0.1.3] - 2025-07-06
+
+### 🚀 Features
+
+- Support providing a path prefix to S3 storage (#342)
+
+### 📚 Documentation
+
+- Update link to httpx transports page (#337)
+## [0.1.2] - 2025-04-04
+
+### 🐛 Bug Fixes
+
+- Requirements.txt to reduce vulnerabilities (#263)
+## [0.0.30] - 2024-07-12
+
+### 🐛 Bug Fixes
+
+- Requirements.txt to reduce vulnerabilities (#245)
+- Requirements.txt to reduce vulnerabilities (#255)
+## [0.0.27] - 2024-05-31
+
+### 🐛 Bug Fixes
+
+- *(redis)* Do not update metadata with negative ttl (#231)
+## [0.0.1] - 2023-07-22

{hishel-0.1.3 → hishel-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 0.1.3
+Version: 0.1.5
 Summary: Persistent cache implementation for httpx and httpcore
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -21,11 +21,20 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Requires-Python: >=3.9
+Requires-Dist: anyio>=4.9.0
+Requires-Dist: anysqlite>=0.0.5
 Requires-Dist: httpx>=0.28.0
+Requires-Dist: msgpack>=1.1.2
+Requires-Dist: typing-extensions>=4.14.1
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.28.1; extra == 'httpx'
 Provides-Extra: redis
 Requires-Dist: redis==6.2.0; extra == 'redis'
+Provides-Extra: requests
+Requires-Dist: requests>=2.32.5; extra == 'requests'
 Provides-Extra: s3
 Requires-Dist: boto3<=1.15.3,>=1.15.0; (python_version < '3.12') and extra == 's3'
 Requires-Dist: boto3>=1.15.3; (python_version >= '3.12') and extra == 's3'
@@ -59,8 +68,8 @@ Description-Content-Type: text/markdown
       <img src="https://img.shields.io/pypi/l/hishel" alt="license">
   </a>
 
-  <a href="https://img.shields.io/codecov/c/github/karpetrosyan/hishel">
-      <img src="https://img.shields.io/codecov/c/github/karpetrosyan/hishel" alt="license">
+  <a href="https://coveralls.io/github/karpetrosyan/hishel">
+      <img src="https://img.shields.io/coverallsCoverage/github/karpetrosyan/hishel" alt="license">
   </a>
 
   <a href="https://github.com/karpetrosyan/hishel">
@@ -68,6 +77,10 @@ Description-Content-Type: text/markdown
   </a>
 </p>
 
+<p align="center">
+    <a href="https://buymeacoffee.com/karpetrosyan" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
+</p>
+
 -----
 
 **Hishel (հիշել, remember)** is a library that implements HTTP Caching for [HTTPX](https://github.com/encode/httpx) and [HTTP Core](https://github.com/encode/httpcore) libraries in accordance with [**RFC 9111**](https://www.rfc-editor.org/rfc/rfc9111.html), the most recent caching specification.
@@ -179,189 +192,67 @@ You have complete control over them; you can change storage or even write your o
 You can support the project by simply leaving a GitHub star ⭐ or by [contributing](https://hishel.com/contributing/).
 Help us grow and continue developing good software for you ❤️
 
-# Changelog
-
-## 0.1.3 (1st July, 2025)
-
-- Remove `types-redis` from dev dependencies (#336)
-- Bump redis to 6.0.0 and address async `.close()` deprecation warning (#336)
-- Avoid race condition when unlinking files in `FileStorage`. (#334)  
-- Allow prodiving a `path_prefix` in `S3Storage` and `AsyncS3Storage`. (#342)
-
-## 0.1.2 (5th April, 2025)
-
-- Add check for fips compliant python. (#325)
-- Fix compatibility with httpx. (#291)
-- Use `SyncByteStream` instead of `ByteStream`. (#298)
-- Don't raise exceptions if date-containing headers are invalid. (#318)
-- Fix for S3 Storage missing metadata in API request. (#320)
-
-## 0.1.1 (2nd Nov, 2024)
-
-- Fix typing extensions not found. (#290)
-
-## 0.1.0 (2nd Nov, 2024)
-
-- Add support for Python 3.12 / drop Python 3.8. (#286)
-- Specify usedforsecurity=False in blake2b. (#285)
-
-## 0.0.33 (4th Oct, 2024)
-
-- Added a [Logging](https://hishel.com/advanced/logging/) section to the documentation.
-
-## 0.0.32 (27th Sep, 2024)
-
-- Don't raise an exception if the `Date` header is not present. (#273)
-
-## 0.0.31 (22nd Sep, 2024)
-
-- Ignore file not found error when cleaning up a file storage. (#264)  
-- Fix `AssertionError` on `client.close()` when use SQLiteStorage. (#269)  
-- Fix ignored flags when use `force_cache`. (#271)  
-
-## 0.0.30 (12th July, 2024)
-
-- Fix cache update on revalidation response with content (rfc9111 section 4.3.3) (#239)
-- Fix request extensions that were not passed into revalidation request for transport-based implementation (but were
-  passed for the pool-based impl) (#247).
-- Add `cache_private` property to the controller to support acting as shared cache. (#224)
-- Improve efficiency of scanning cached responses in `FileStorage` by reducing number of syscalls. (#252)
-- Add `remove` support for storages (#241)
-
-## 0.0.29 (23th June, 2024)
-
-- Documentation hotfix. (#244)
-
-## 0.0.28 (23th June, 2024)
-
-- Add `revalidated` response extension. (#242)
-
-## 0.0.27 (31th May, 2024)
-
-- Fix `RedisStorage` when using without ttl. (#231)
-
-## 0.0.26 (12th April, 2024)
-
-- Expose `AsyncBaseStorage` and `BaseStorage`. (#220)
-- Prevent cache hits from resetting the ttl. (#215)
-
-## 0.0.25 (26th March, 2024)
-
-- Add `force_cache` property to the controller, allowing RFC9111 rules to be completely disabled. (#204)
-- Add `.gitignore` to cache directory created by `FIleStorage`. (#197)
-- Remove `stale_*` headers from the `CacheControl` class. (#199)
-
-## 0.0.24 (14th February, 2024)
-
-- Fix `botocore is not installed` exception when using any kind of storage. (#186)
-
-## 0.0.23 (14th February, 2024)
-
-- Make `S3Storage` to check staleness of all cache files with set interval. (#182)
-- Fix an issue where an empty file in `FileCache` could cause a parsing error. (#181)
-- Support caching for `POST` and other HTTP methods. (#183)
-
-## 0.0.22 (31th January, 2024)
-
-- Make `FileStorage` to check staleness of all cache files with set interval. (#169)
-- Support AWS S3 storages. (#164)
-- Move `typing_extensions` from requirements.txt to pyproject.toml. (#161)
-
-## 0.0.21 (29th December, 2023)
-
-- Fix inner transport and connection pool instances closing. (#147)
-- Improved error message when the storage type is incorrect. (#138)
-
-## 0.0.20 (12th December, 2023)
-
-- Add in-memory storage. (#133)
-- Allow customization of cache key generation. (#130)
-
-## 0.0.19 (30th November, 2023)
-
-- Add `force_cache` extension to enforce the request to be cached, ignoring the HTTP headers. (#117)
-- Fix issue where sqlite storage cache get deleted immediately. (#119)
-- Support float numbers for storage ttl. (#107)
-
-## 0.0.18 (23rd November, 2023)
-
-- Fix issue where freshness cannot be calculated to re-send request. (#104)
-- Add `cache_disabled` extension to temporarily disable the cache (#109)
-- Update `datetime.datetime.utcnow()` to `datetime.datetime.now(datetime.timezone.utc)` since `datetime.datetime.utcnow()` has been deprecated. (#111)
-
-## 0.0.17 (6th November, 2023)
-
-- Fix `Last-Modified` validation.
-
-## 0.0.16 (25th October, 2023)
-
-- Add `install_cache` function. (#95)
-- Add sqlite support. (#92)
-- Move `ttl` argument to `BaseStorage` class. (#94)
-
-## 0.0.14 (23rd October, 2023)
-
-- Replace `AsyncResponseStream` with `AsyncCacheStream`. (#86)
-- Add `must-understand` response directive support. (#90)
-
-## 0.0.13 (5th October, 2023)
-
-- Add support for Python 3.12. (#71)
-- Fix connections releasing from the connection pool. (#83)
+## [0.1.5] - 2025-10-18
 
-## 0.0.12 (8th September, 2023)
+### 🚀 Features
 
-- Add metadata into the response extensions. (#56)
+- *(perf)* Set chunk size to 128KB for httpx to reduce SQLite read/writes
+- Better cache-control parsing
+- Add close method to storages API (#384)
+- *(perf)* Increase requests buffer size to 128KB, disable charset detection
 
-## 0.0.11 (15th August, 2023)
+### 🐛 Bug Fixes
 
-- Add support for request `cache-control` directives. (#42)
-- Drop httpcore dependency. (#40)
-- Support HTTP methods only if they are defined as cacheable. (#37)
+- *(docs)* Fix some line breaks
 
-## 0.0.10 (7th August, 2023)
+### ⚙️ Miscellaneous Tasks
 
-- Add Response metadata. (#33)
-- Add API Reference documentation. (#30)
-- Use stale responses only if the client is disconnected. (#28)
+- Remove some redundant files from repo
+## [0.1.4] - 2025-10-14
 
-## 0.0.9 (1st August, 2023)
+### 🚀 Features
 
-- Expose Controller API. (#23)
+- 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
 
-## 0.0.8 (31st July, 2023)
+### 🐛 Bug Fixes
 
-- Skip redis tests if the server was not found. (#16)
-- Decrease sleep time for the storage ttl tests. (#18)
-- Fail coverage under 100. (#19)
+- Create an sqlite file in a cache folder
+- Fix beta imports
 
-## 0.0.7 (30th July, 2023)
+### ⚙️ Miscellaneous Tasks
 
-- Add support for `Heuristic Freshness`. (#11)
-- Change `Controller.cache_heuristically` to `Controller.allow_heuristics`. (#12)
-- Handle import errors. (#13)
+- Improve CI (#369)
+- *(internal)* Remove src folder (#373)
+- *(internal)* Temporary remove python3.14 from CI
+- *(tests)* Add sqlite tests for new storage
+- *(tests)* Move some tests to beta
+## [0.1.3] - 2025-07-06
 
-## 0.0.6 (29th July, 2023)
+### 🚀 Features
 
-- Fix `Vary` header validation. (#8)
-- Dump original requests with the responses. (#7)
+- Support providing a path prefix to S3 storage (#342)
 
-## 0.0.5 (29th July, 2023)
+### 📚 Documentation
 
-- Fix httpx response streaming.
+- Update link to httpx transports page (#337)
+## [0.1.2] - 2025-04-04
 
-## 0.0.4 (29th July, 2023)
+### 🐛 Bug Fixes
 
-- Change `YamlSerializer` name to `YAMLSerializer`.
+- Requirements.txt to reduce vulnerabilities (#263)
+## [0.0.30] - 2024-07-12
 
-## 0.0.3 (28th July, 2023)
+### 🐛 Bug Fixes
 
-- Add `from_cache` response extension.
-- Add `typing_extensions` into the requirements.
+- Requirements.txt to reduce vulnerabilities (#245)
+- Requirements.txt to reduce vulnerabilities (#255)
+## [0.0.27] - 2024-05-31
 
-## 0.0.2 (25th July, 2023)
+### 🐛 Bug Fixes
 
-- Add [redis](https://redis.io/) support.
-- Make backends thread and task safe.
-- Add black as a new linter.
-- Add an expire time for cached responses.
+- *(redis)* Do not update metadata with negative ttl (#231)
+## [0.0.1] - 2023-07-22

{hishel-0.1.3 → hishel-0.1.5}/README.md

@@ -22,8 +22,8 @@
       <img src="https://img.shields.io/pypi/l/hishel" alt="license">
   </a>
 
-  <a href="https://img.shields.io/codecov/c/github/karpetrosyan/hishel">
-      <img src="https://img.shields.io/codecov/c/github/karpetrosyan/hishel" alt="license">
+  <a href="https://coveralls.io/github/karpetrosyan/hishel">
+      <img src="https://img.shields.io/coverallsCoverage/github/karpetrosyan/hishel" alt="license">
   </a>
 
   <a href="https://github.com/karpetrosyan/hishel">
@@ -31,6 +31,10 @@
   </a>
 </p>
 
+<p align="center">
+    <a href="https://buymeacoffee.com/karpetrosyan" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
+</p>
+
 -----
 
 **Hishel (հիշել, remember)** is a library that implements HTTP Caching for [HTTPX](https://github.com/encode/httpx) and [HTTP Core](https://github.com/encode/httpcore) libraries in accordance with [**RFC 9111**](https://www.rfc-editor.org/rfc/rfc9111.html), the most recent caching specification.

hishel-0.1.5/hishel/__init__.py

@@ -0,0 +1,57 @@
+import httpx
+
+from ._async import *
+from ._controller import *
+from ._exceptions import *
+from ._headers import *
+from ._serializers import *
+from ._sync import *
+from ._lfu_cache import *
+
+__all__ = (
+    # Old API
+    "AsyncCacheClient",
+    "MockAsyncConnectionPool",
+    "MockAsyncTransport",
+    "AsyncCacheConnectionPool",
+    "AsyncBaseStorage",
+    "AsyncFileStorage",
+    "AsyncInMemoryStorage",
+    "AsyncRedisStorage",
+    "AsyncS3Storage",
+    "AsyncSQLiteStorage",
+    "AsyncCacheTransport",
+    "HEURISTICALLY_CACHEABLE_STATUS_CODES",
+    "Controller",
+    "CacheControlError",
+    "ParseError",
+    "ValidationError",
+    "CacheControl",
+    "Vary",
+    "BaseSerializer",
+    "JSONSerializer",
+    "Metadata",
+    "PickleSerializer",
+    "YAMLSerializer",
+    "clone_model",
+    "CacheClient",
+    "MockConnectionPool",
+    "MockTransport",
+    "CacheConnectionPool",
+    "BaseStorage",
+    "FileStorage",
+    "InMemoryStorage",
+    "RedisStorage",
+    "S3Storage",
+    "SQLiteStorage",
+    "CacheTransport",
+    "LFUCache",
+)
+
+def install_cache() -> None:  # pragma: no cover
+    httpx.AsyncClient = AsyncCacheClient  # type: ignore
+    httpx.Client = CacheClient  # type: ignore
+
+
+__version__ = "0.1.5"
+

{hishel-0.1.3 → hishel-0.1.5}/hishel/_async/_client.py

@@ -2,7 +2,7 @@ import typing as tp
 
 import httpx
 
-from hishel._async._transports import AsyncCacheTransport
+from ._transports import AsyncCacheTransport
 
 __all__ = ("AsyncCacheClient",)
 

{hishel-0.1.3 → hishel-0.1.5}/hishel/_async/_storages.py

@@ -4,7 +4,6 @@ import datetime
 import logging
 import os
 import time
-import typing as t
 import typing as tp
 import warnings
 from copy import deepcopy
@@ -24,13 +23,11 @@ except ImportError:  # pragma: no cover
 
 from httpcore import Request, Response
 
-if t.TYPE_CHECKING:  # pragma: no cover
+if tp.TYPE_CHECKING:  # pragma: no cover
     from typing_extensions import TypeAlias
 
-from hishel._serializers import BaseSerializer, clone_model
-
 from .._files import AsyncFileManager
-from .._serializers import JSONSerializer, Metadata
+from .._serializers import BaseSerializer, JSONSerializer, Metadata, clone_model
 from .._synchronization import AsyncLock
 from .._utils import float_seconds_to_int_milliseconds
 
@@ -39,10 +36,10 @@ logger = logging.getLogger("hishel.storages")
 __all__ = (
     "AsyncBaseStorage",
     "AsyncFileStorage",
-    "AsyncRedisStorage",
-    "AsyncSQLiteStorage",
     "AsyncInMemoryStorage",
+    "AsyncRedisStorage",
     "AsyncS3Storage",
+    "AsyncSQLiteStorage",
 )
 
 StoredResponse: TypeAlias = tp.Tuple[Response, Request, Metadata]
@@ -106,8 +103,7 @@ class AsyncFileStorage(AsyncBaseStorage):
         self._base_path = Path(base_path) if base_path is not None else Path(".cache/hishel")
         self._gitignore_file = self._base_path / ".gitignore"
 
-        if not self._base_path.is_dir():
-            self._base_path.mkdir(parents=True)
+        self._base_path.mkdir(parents=True, exist_ok=True)
 
         if not self._gitignore_file.is_file():
             with open(self._gitignore_file, "w", encoding="utf-8") as f:
@@ -153,7 +149,7 @@ class AsyncFileStorage(AsyncBaseStorage):
         """
 
         if isinstance(key, Response):  # pragma: no cover
-            key = t.cast(str, key.extensions["cache_metadata"]["cache_key"])
+            key = tp.cast(str, key.extensions["cache_metadata"]["cache_key"])
 
         response_path = self._base_path / key
 
@@ -322,7 +318,7 @@ class AsyncSQLiteStorage(AsyncBaseStorage):
         assert self._connection
 
         if isinstance(key, Response):  # pragma: no cover
-            key = t.cast(str, key.extensions["cache_metadata"]["cache_key"])
+            key = tp.cast(str, key.extensions["cache_metadata"]["cache_key"])
 
         async with self._lock:
             await self._connection.execute("DELETE FROM cache WHERE key = ?", [key])
@@ -459,7 +455,7 @@ class AsyncRedisStorage(AsyncBaseStorage):
         """
 
         if isinstance(key, Response):  # pragma: no cover
-            key = t.cast(str, key.extensions["cache_metadata"]["cache_key"])
+            key = tp.cast(str, key.extensions["cache_metadata"]["cache_key"])
 
         await self._client.delete(key)
 
@@ -572,7 +568,7 @@ class AsyncInMemoryStorage(AsyncBaseStorage):
         """
 
         if isinstance(key, Response):  # pragma: no cover
-            key = t.cast(str, key.extensions["cache_metadata"]["cache_key"])
+            key = tp.cast(str, key.extensions["cache_metadata"]["cache_key"])
 
         async with self._lock:
             self._cache.remove_key(key)
@@ -720,7 +716,7 @@ class AsyncS3Storage(AsyncBaseStorage):  # pragma: no cover
         """
 
         if isinstance(key, Response):  # pragma: no cover
-            key = t.cast(str, key.extensions["cache_metadata"]["cache_key"])
+            key = tp.cast(str, key.extensions["cache_metadata"]["cache_key"])
 
         async with self._lock:
             await self._s3_manager.remove_entry(key)

{hishel-0.1.3 → hishel-0.1.5}/hishel/_async/_transports.py

@@ -8,11 +8,10 @@ import httpx
 from httpx import AsyncByteStream, Request, Response
 from httpx._exceptions import ConnectError
 
-from hishel._utils import extract_header_values_decoded, normalized_url
-
 from .._controller import Controller, allowed_stale
 from .._headers import parse_cache_control
 from .._serializers import JSONSerializer, Metadata
+from .._utils import extract_header_values_decoded, normalized_url
 from ._storages import AsyncBaseStorage, AsyncFileStorage
 
 if tp.TYPE_CHECKING:  # pragma: no cover
@@ -211,11 +210,17 @@ class AsyncCacheTransport(httpx.AsyncBaseTransport):
                 )
 
         regular_response = await self._transport.handle_async_request(request)
-        assert isinstance(regular_response.stream, tp.AsyncIterable)
+        try:
+            # Prefer already-read content, if available
+            stream = fake_stream(regular_response.content)
+        except httpx.ResponseNotRead:
+            # Fall back to stream if not yet read
+            assert isinstance(regular_response.stream, tp.AsyncIterable)
+            stream = regular_response.stream
         httpcore_regular_response = httpcore.Response(
             status=regular_response.status_code,
             headers=regular_response.headers.raw,
-            content=AsyncCacheStream(regular_response.stream),
+            content=AsyncCacheStream(stream),
             extensions=regular_response.extensions,
         )
         await httpcore_regular_response.aread()

{hishel-0.1.3 → hishel-0.1.5}/hishel/_controller.py

@@ -3,8 +3,7 @@ import typing as tp
 
 from httpcore import Request, Response
 
-from hishel._headers import Vary, parse_cache_control
-
+from ._headers import Vary, parse_cache_control
 from ._utils import (
     BaseClock,
     Clock,
@@ -21,7 +20,7 @@ logger = logging.getLogger("hishel.controller")
 HEURISTICALLY_CACHEABLE_STATUS_CODES = (200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414, 501)
 HTTP_METHODS = ["GET", "HEAD", "POST", "PUT", "DELETE", "CONNECT", "OPTIONS", "TRACE", "PATCH"]
 
-__all__ = ("Controller", "HEURISTICALLY_CACHEABLE_STATUS_CODES")
+__all__ = ("HEURISTICALLY_CACHEABLE_STATUS_CODES", "Controller")
 
 
 def get_updated_headers(

hishel-0.1.5/hishel/_lmdb_types_.pyi

@@ -0,0 +1,53 @@
+from contextlib import contextmanager
+from typing import Any, Iterator
+
+class Database: ...
+
+class Transaction:
+    def get(self, key: bytes, *, db: Database | None = None) -> bytes | None:
+        """
+        Get the value associated with the given key.
+        """
+        pass
+
+    def put(self, key: bytes, value: bytes, *, db: Database | None = None, dupdata: bool = False) -> None:
+        """
+        Put a key-value pair into the database.
+        """
+        pass
+
+    def delete(self, key: bytes, *, db: Database | None = None) -> bool:
+        """
+        Delete the key from the database.
+        """
+        pass
+
+    def cursor(self, db: Database) -> Any:
+        """
+        Create a cursor for iterating over key-value pairs in the database.
+        """
+        pass
+
+class Environment:
+    @contextmanager
+    def begin(self, *, db: Database | None = None, write: bool = False) -> Iterator[Transaction]:
+        """
+        Begin a transaction in the environment.
+        """
+        raise NotImplementedError("It's only for type hinting purposes")
+
+    def open_db(self, key: bytes, dupsort: bool = False) -> Database:
+        """
+        Open a database within the environment.
+        """
+        raise NotImplementedError("It's only for type hinting purposes")
+
+def open(
+    path: str,
+    *,
+    max_dbs: int = 0,
+) -> Environment:
+    """
+    Open an LMDB environment at the specified path.
+    """
+    raise NotImplementedError("It's only for type hinting purposes")

{hishel-0.1.3 → hishel-0.1.5}/hishel/_serializers.py

@@ -6,7 +6,7 @@ from datetime import datetime
 
 from httpcore import Request, Response
 
-from hishel._utils import normalized_url
+from ._utils import normalized_url
 
 try:
     import yaml
@@ -17,7 +17,7 @@ HEADERS_ENCODING = "iso-8859-1"
 KNOWN_RESPONSE_EXTENSIONS = ("http_version", "reason_phrase")
 KNOWN_REQUEST_EXTENSIONS = ("timeout", "sni_hostname")
 
-__all__ = ("PickleSerializer", "JSONSerializer", "YAMLSerializer", "BaseSerializer", "clone_model")
+__all__ = ("BaseSerializer", "JSONSerializer", "Metadata", "PickleSerializer", "YAMLSerializer", "clone_model")
 
 T = tp.TypeVar("T", Request, Response)
 

{hishel-0.1.3 → hishel-0.1.5}/hishel/_sync/_client.py

@@ -2,7 +2,7 @@ import typing as tp
 
 import httpx
 
-from hishel._sync._transports import CacheTransport
+from ._transports import CacheTransport
 
 __all__ = ("CacheClient",)