hishel 1.0.0.dev1__py3-none-any.whl → 1.0.0.dev3__py3-none-any.whl

hishel/httpx.py

@@ -1,20 +1,5 @@
-from __future__ import annotations
-
-import ssl
-import typing as t
-from typing import AsyncIterator, Iterable, Iterator, Union, overload
-
-from hishel import Headers, Request, Response
-from hishel._async_cache import AsyncCacheProxy
-from hishel._core._base._storages._base import AsyncBaseStorage, SyncBaseStorage
-from hishel._core._spec import (
-    CacheOptions,
-)
-from hishel._core.models import AnyIterable
-from hishel._sync_cache import SyncCacheProxy
-
 try:
-    import httpx
+    import httpx  # noqa: F401
 except ImportError as e:
     raise ImportError(
         "httpx is required to use hishel.httpx module. "
@@ -22,314 +7,6 @@ except ImportError as e:
         "e.g., 'pip install hishel[httpx]'."
     ) from e
 
-SOCKET_OPTION = t.Union[
-    t.Tuple[int, int, int],
-    t.Tuple[int, int, t.Union[bytes, bytearray]],
-    t.Tuple[int, int, None, int],
-]
-
-# 128 KB
-CHUNK_SIZE = 131072
-
-
-class IteratorStream(httpx.SyncByteStream, httpx.AsyncByteStream):
-    def __init__(self, iterator: Iterator[bytes] | AsyncIterator[bytes]) -> None:
-        self.iterator = iterator
-
-    def __iter__(self) -> Iterator[bytes]:
-        assert isinstance(self.iterator, (Iterator))
-        yield from self.iterator
-
-    async def __aiter__(self) -> AsyncIterator[bytes]:
-        assert isinstance(self.iterator, (AsyncIterator))
-        async for chunk in self.iterator:
-            yield chunk
-
-
-@overload
-def internal_to_httpx(
-    value: Request,
-) -> httpx.Request: ...
-@overload
-def internal_to_httpx(
-    value: Response,
-) -> httpx.Response: ...
-def internal_to_httpx(
-    value: Union[Request, Response],
-) -> Union[httpx.Request, httpx.Response]:
-    """
-    Convert internal Request/Response to httpx.Request/httpx.Response.
-    """
-    if isinstance(value, Request):
-        return httpx.Request(
-            method=value.method,
-            url=value.url,
-            headers=value.headers,
-            stream=IteratorStream(value.stream),
-            extensions=value.metadata,
-        )
-    elif isinstance(value, Response):
-        return httpx.Response(
-            status_code=value.status_code,
-            headers=value.headers,
-            stream=IteratorStream(value.stream),
-            extensions=value.metadata,
-        )
-
-
-@overload
-def httpx_to_internal(
-    value: httpx.Request,
-) -> Request: ...
-@overload
-def httpx_to_internal(
-    value: httpx.Response,
-) -> Response: ...
-def httpx_to_internal(
-    value: Union[httpx.Request, httpx.Response],
-) -> Union[Request, Response]:
-    """
-    Convert httpx.Request/httpx.Response to internal Request/Response.
-    """
-    stream: Union[Iterator[bytes], AsyncIterator[bytes]]
-    try:
-        stream = AnyIterable(value.content)
-    except (httpx.RequestNotRead, httpx.ResponseNotRead):
-        if isinstance(value, httpx.Response):
-            stream = (
-                value.iter_raw(chunk_size=CHUNK_SIZE)
-                if isinstance(value.stream, Iterable)
-                else value.aiter_raw(chunk_size=CHUNK_SIZE)
-            )
-        else:
-            stream = value.stream  # type: ignore
-    if isinstance(value, httpx.Request):
-        return Request(
-            method=value.method,
-            url=str(value.url),
-            headers=Headers({key: value for key, value in value.headers.items()}),
-            stream=stream,
-            metadata={
-                "hishel_refresh_ttl_on_access": value.extensions.get("hishel_refresh_ttl_on_access"),
-                "hishel_ttl": value.extensions.get("hishel_ttl"),
-                "hishel_spec_ignore": value.extensions.get("hishel_spec_ignore"),
-            },
-        )
-    elif isinstance(value, httpx.Response):
-        return Response(
-            status_code=value.status_code,
-            headers=Headers({key: value for key, value in value.headers.items()}),
-            stream=stream,
-            metadata={},
-        )
-
-
-class SyncCacheTransport(httpx.BaseTransport):
-    def __init__(
-        self,
-        next_transport: httpx.BaseTransport,
-        storage: SyncBaseStorage | None = None,
-        cache_options: CacheOptions | None = None,
-        ignore_specification: bool = False,
-    ) -> None:
-        self.next_transport = next_transport
-        self._cache_proxy: SyncCacheProxy = SyncCacheProxy(
-            send_request=self.sync_send_request,
-            storage=storage,
-            cache_options=cache_options,
-            ignore_specification=ignore_specification,
-        )
-        self.storage = self._cache_proxy.storage
-
-    def handle_request(
-        self,
-        request: httpx.Request,
-    ) -> httpx.Response:
-        internal_request = httpx_to_internal(request)
-        internal_response = self._cache_proxy.handle_request(internal_request)
-        response = internal_to_httpx(internal_response)
-        return response
-
-    def close(self) -> None:
-        self.next_transport.close()
-        self.storage.close()
-        super().close()
-
-    def sync_send_request(self, request: Request) -> Response:
-        httpx_request = internal_to_httpx(request)
-        httpx_response = self.next_transport.handle_request(httpx_request)
-        return httpx_to_internal(httpx_response)
-
-
-class SyncCacheClient(httpx.Client):
-    @overload
-    def __init__(
-        self,
-        *,
-        storage: SyncBaseStorage | None = None,
-        cache_options: CacheOptions | None = None,
-        **kwargs: t.Any,
-    ) -> None: ...
-    @overload
-    def __init__(
-        self,
-        *args: t.Any,
-        **kwargs: t.Any,
-    ) -> None: ...
-    def __init__(self, *args: t.Any, **kwargs: t.Any) -> None:
-        self.storage: SyncBaseStorage | None = kwargs.pop("storage", None)
-        self.cache_options: CacheOptions | None = kwargs.pop("cache_options", None)
-        super().__init__(*args, **kwargs)
-
-    def _init_transport(
-        self,
-        verify: ssl.SSLContext | str | bool = True,
-        cert: t.Union[str, t.Tuple[str, str], t.Tuple[str, str, str], None] = None,
-        trust_env: bool = True,
-        http1: bool = True,
-        http2: bool = False,
-        limits: httpx.Limits = httpx.Limits(max_connections=100, max_keepalive_connections=20),
-        transport: httpx.BaseTransport | None = None,
-        **kwargs: t.Any,
-    ) -> httpx.BaseTransport:
-        if transport is not None:
-            return transport
-
-        return SyncCacheTransport(
-            next_transport=httpx.HTTPTransport(
-                verify=verify,
-                cert=cert,
-                trust_env=trust_env,
-                http1=http1,
-                http2=http2,
-                limits=limits,
-            ),
-            storage=self.storage,
-            cache_options=self.cache_options,
-            ignore_specification=False,
-        )
-
-    def _init_proxy_transport(
-        self,
-        proxy: httpx.Proxy,
-        verify: ssl.SSLContext | str | bool = True,
-        cert: t.Union[str, t.Tuple[str, str], t.Tuple[str, str, str], None] = None,
-        trust_env: bool = True,
-        http1: bool = True,
-        http2: bool = False,
-        limits: httpx.Limits = httpx.Limits(max_connections=100, max_keepalive_connections=20),
-        **kwargs: t.Any,
-    ) -> httpx.BaseTransport:
-        return SyncCacheTransport(
-            next_transport=httpx.HTTPTransport(
-                verify=verify,
-                cert=cert,
-                trust_env=trust_env,
-                http1=http1,
-                http2=http2,
-                limits=limits,
-                proxy=proxy,
-            ),
-            storage=self.storage,
-            cache_options=self.cache_options,
-            ignore_specification=False,
-        )
-
-
-class AsyncCacheTransport(httpx.AsyncBaseTransport):
-    def __init__(
-        self,
-        next_transport: httpx.AsyncBaseTransport,
-        storage: AsyncBaseStorage | None = None,
-        cache_options: CacheOptions | None = None,
-        ignore_specification: bool = False,
-    ) -> None:
-        self.next_transport = next_transport
-        self._cache_proxy: AsyncCacheProxy = AsyncCacheProxy(
-            send_request=self.async_send_request,
-            storage=storage,
-            cache_options=cache_options,
-            ignore_specification=ignore_specification,
-        )
-        self.storage = self._cache_proxy.storage
-
-    async def handle_async_request(
-        self,
-        request: httpx.Request,
-    ) -> httpx.Response:
-        internal_request = httpx_to_internal(request)
-        internal_response = await self._cache_proxy.handle_request(internal_request)
-        response = internal_to_httpx(internal_response)
-        return response
-
-    async def aclose(self) -> None:
-        await self.next_transport.aclose()
-        await self.storage.close()
-        await super().aclose()
-
-    async def async_send_request(self, request: Request) -> Response:
-        httpx_request = internal_to_httpx(request)
-        httpx_response = await self.next_transport.handle_async_request(httpx_request)
-        return httpx_to_internal(httpx_response)
-
-
-class AsyncCacheClient(httpx.AsyncClient):
-    def __init__(self, *args: t.Any, **kwargs: t.Any) -> None:
-        self.storage: AsyncBaseStorage | None = kwargs.pop("storage", None)
-        self.cache_options: CacheOptions | None = kwargs.pop("cache_options", None)
-        self.ignore_specification: bool = kwargs.pop("ignore_specification", False)
-        super().__init__(*args, **kwargs)
-
-    def _init_transport(
-        self,
-        verify: ssl.SSLContext | str | bool = True,
-        cert: t.Union[str, t.Tuple[str, str], t.Tuple[str, str, str], None] = None,
-        trust_env: bool = True,
-        http1: bool = True,
-        http2: bool = False,
-        limits: httpx.Limits = httpx.Limits(max_connections=100, max_keepalive_connections=20),
-        transport: httpx.AsyncBaseTransport | None = None,
-        **kwargs: t.Any,
-    ) -> httpx.AsyncBaseTransport:
-        if transport is not None:
-            return transport
-
-        return AsyncCacheTransport(
-            next_transport=httpx.AsyncHTTPTransport(
-                verify=verify,
-                cert=cert,
-                trust_env=trust_env,
-                http1=http1,
-                http2=http2,
-                limits=limits,
-            ),
-            storage=self.storage,
-            cache_options=self.cache_options,
-            ignore_specification=False,
-        )
 
-    def _init_proxy_transport(
-        self,
-        proxy: httpx.Proxy,
-        verify: ssl.SSLContext | str | bool = True,
-        cert: t.Union[str, t.Tuple[str, str], t.Tuple[str, str, str], None] = None,
-        trust_env: bool = True,
-        http1: bool = True,
-        http2: bool = False,
-        limits: httpx.Limits = httpx.Limits(max_connections=100, max_keepalive_connections=20),
-        **kwargs: t.Any,
-    ) -> httpx.AsyncBaseTransport:
-        return AsyncCacheTransport(
-            next_transport=httpx.AsyncHTTPTransport(
-                verify=verify,
-                cert=cert,
-                trust_env=trust_env,
-                http1=http1,
-                http2=http2,
-                limits=limits,
-                proxy=proxy,
-            ),
-            storage=self.storage,
-            cache_options=self.cache_options,
-            ignore_specification=self.ignore_specification,
-        )
+from ._async_httpx import AsyncCacheClient as AsyncCacheClient, AsyncCacheTransport as AsyncCacheTransport
+from ._sync_httpx import SyncCacheClient as SyncCacheClient, SyncCacheTransport as SyncCacheTransport

hishel/requests.py

@@ -6,8 +6,8 @@ from typing import Any, Iterator, Mapping, Optional, overload
 from typing_extensions import assert_never
 
 from hishel import Headers, Request, Response as Response
-from hishel._core._base._storages._base import SyncBaseStorage
 from hishel._core._spec import CacheOptions
+from hishel._core._storages._sync_base import SyncBaseStorage
 from hishel._core.models import extract_metadata_from_headers
 from hishel._sync_cache import SyncCacheProxy
 from hishel._utils import snake_to_header
@@ -27,7 +27,7 @@ except ImportError:  # pragma: no cover
 CHUNK_SIZE = 131072
 
 
-class IteratorStream(RawIOBase):
+class _IteratorStream(RawIOBase):
     def __init__(self, iterator: Iterator[bytes]):
         self.iterator = iterator
         self.leftover = b""
@@ -61,18 +61,18 @@ class IteratorStream(RawIOBase):
 
 
 @overload
-def requests_to_internal(
+def _requests_to_internal(
     model: requests.models.PreparedRequest,
 ) -> Request: ...
 
 
 @overload
-def requests_to_internal(
+def _requests_to_internal(
     model: requests.models.Response,
 ) -> Response: ...
 
 
-def requests_to_internal(
+def _requests_to_internal(
     model: requests.models.PreparedRequest | requests.models.Response,
 ) -> Request | Response:
     if isinstance(model, requests.models.PreparedRequest):
@@ -108,19 +108,24 @@ def requests_to_internal(
 
 
 @overload
-def internal_to_requests(model: Request) -> requests.models.PreparedRequest: ...
+def _internal_to_requests(model: Request) -> requests.models.PreparedRequest: ...
 @overload
-def internal_to_requests(model: Response) -> requests.models.Response: ...
-def internal_to_requests(model: Request | Response) -> requests.models.Response | requests.models.PreparedRequest:
+def _internal_to_requests(model: Response) -> requests.models.Response: ...
+def _internal_to_requests(
+    model: Request | Response,
+) -> requests.models.Response | requests.models.PreparedRequest:
     if isinstance(model, Response):
         response = requests.models.Response()
 
         assert isinstance(model.stream, Iterator)
-        stream = IteratorStream(model.stream)
+        stream = _IteratorStream(model.stream)
 
         urllib_response = HTTPResponse(
             body=stream,
-            headers={**model.headers, **{snake_to_header(k): str(v) for k, v in model.metadata.items()}},
+            headers={
+                **model.headers,
+                **{snake_to_header(k): str(v) for k, v in model.metadata.items()},
+            },
             status=model.status_code,
             preload_content=False,
             decode_content=False,
@@ -163,7 +168,7 @@ class CacheAdapter(HTTPAdapter):
     ):
         super().__init__(pool_connections, pool_maxsize, max_retries, pool_block)
         self._cache_proxy = SyncCacheProxy(
-            send_request=self.send_request,
+            request_sender=self._send_request,
             storage=storage,
             cache_options=cache_options,
             ignore_specification=ignore_specification,
@@ -179,9 +184,9 @@ class CacheAdapter(HTTPAdapter):
         cert: None | bytes | str | tuple[bytes | str, bytes | str] = None,
         proxies: Mapping[str, str] | None = None,
     ) -> requests.models.Response:
-        internal_request = requests_to_internal(request)
+        internal_request = _requests_to_internal(request)
         internal_response = self._cache_proxy.handle_request(internal_request)
-        response = internal_to_requests(internal_response)
+        response = _internal_to_requests(internal_response)
 
         # Set the original request on the response
         response.request = request
@@ -189,10 +194,13 @@ class CacheAdapter(HTTPAdapter):
 
         return response
 
-    def send_request(self, request: Request) -> Response:
-        requests_request = internal_to_requests(request)
-        response = super().send(requests_request, stream=True)
-        return requests_to_internal(response)
+    def _send_request(self, request: Request) -> Response:
+        requests_request = _internal_to_requests(request)
+        response = super().send(
+            requests_request,
+            stream=True,
+        )
+        return _requests_to_internal(response)
 
     def close(self) -> Any:
         self.storage.close()

{hishel-1.0.0.dev1.dist-info → hishel-1.0.0.dev3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.0.0.dev1
+Version: 1.0.0.dev3
 Summary:  Elegant HTTP Caching for Python
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -29,6 +29,8 @@ Requires-Dist: typing-extensions>=4.14.1
 Provides-Extra: async
 Requires-Dist: anyio>=4.9.0; extra == 'async'
 Requires-Dist: anysqlite>=0.0.5; extra == 'async'
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.119.1; extra == 'fastapi'
 Provides-Extra: httpx
 Requires-Dist: anyio>=4.9.0; extra == 'httpx'
 Requires-Dist: anysqlite>=0.0.5; extra == 'httpx'
@@ -37,6 +39,7 @@ Provides-Extra: requests
 Requires-Dist: requests>=2.32.5; extra == 'requests'
 Description-Content-Type: text/markdown
 
+
 <p align="center">
   <img alt="Hishel Logo" width="350" src="https://raw.githubusercontent.com/karpetrosyan/hishel/master/docs/static/Shelkopryad_350x250_yellow.png#gh-dark-mode-only">
   <img alt="Hishel Logo" width="350" src="https://raw.githubusercontent.com/karpetrosyan/hishel/master/docs/static/Shelkopryad_350x250_black.png#gh-light-mode-only">
@@ -73,14 +76,15 @@ Description-Content-Type: text/markdown
 ## ✨ Features
 
 - 🎯 **RFC 9111 Compliant** - Fully compliant with the latest HTTP caching specification
-- 🔌 **Easy Integration** - Drop-in support for HTTPX and Requests
+- 🔌 **Easy Integration** - Drop-in support for HTTPX, Requests, ASGI, FastAPI, and BlackSheep
 - 💾 **Flexible Storage** - SQLite backend with more coming soon
 - ⚡ **High Performance** - Efficient caching with minimal overhead
 - 🔄 **Async & Sync** - Full support for both synchronous and asynchronous workflows
 - 🎨 **Type Safe** - Fully typed with comprehensive type hints
 - 🧪 **Well Tested** - Extensive test coverage and battle-tested
 - 🎛️ **Configurable** - Fine-grained control over caching behavior
-- 🌐 **Future Ready** - Designed for easy integration with any HTTP client/server
+- � **Memory Efficient** - Streaming support prevents loading large payloads into memory
+- 🌐 **Universal** - Works with any ASGI application (Starlette, Litestar, BlackSheep, etc.)
 
 ## 📦 Installation
 
@@ -90,19 +94,23 @@ pip install hishel
 
 ### Optional Dependencies
 
-Install with specific HTTP client support:
+Install with specific integration support:
 
 ```bash
 pip install hishel[httpx]      # For HTTPX support
 pip install hishel[requests]   # For Requests support
+pip install hishel[fastapi]    # For FastAPI support (includes ASGI)
 ```
 
-Or install both:
+Or install multiple:
 
 ```bash
-pip install hishel[httpx,requests]
+pip install hishel[httpx,requests,fastapi]
 ```
 
+> [!NOTE]
+> ASGI middleware has no extra dependencies - it's included in the base installation.
+ 
 ## 🚀 Quick Start
 
 ### With HTTPX
@@ -156,6 +164,65 @@ response = session.get("https://api.example.com/data")
 print(response.headers.get("X-Hishel-From-Cache"))  # "True"
 ```
 
+### With ASGI Applications
+
+Add caching middleware to any ASGI application:
+
+```python
+from hishel.asgi import ASGICacheMiddleware
+
+# Wrap your ASGI app
+app = ASGICacheMiddleware(app)
+
+# Or configure with options
+from hishel import AsyncSqliteStorage, CacheOptions
+
+app = ASGICacheMiddleware(
+    app,
+    storage=AsyncSqliteStorage(),
+    cache_options=CacheOptions(shared=True)
+)
+```
+
+### With FastAPI
+
+Add Cache-Control headers using the `cache()` dependency:
+
+```python
+from fastapi import FastAPI
+from hishel.fastapi import cache
+
+app = FastAPI()
+
+@app.get("/api/data", dependencies=[cache(max_age=300, public=True)])
+async def get_data():
+    # Cache-Control: public, max-age=300
+    return {"data": "cached for 5 minutes"}
+  
+# Optionally wrap with ASGI middleware for local caching according to specified rules
+from hishel.asgi import ASGICacheMiddleware
+from hishel import AsyncSqliteStorage
+
+app = ASGICacheMiddleware(app, storage=AsyncSqliteStorage())
+```
+
+### With BlackSheep
+
+Use BlackSheep's native `cache_control` decorator with Hishel's ASGI middleware:
+
+```python
+from blacksheep import Application, get
+from blacksheep.server.headers.cache import cache_control
+
+app = Application()
+
+@get("/api/data")
+@cache_control(max_age=300, public=True)
+async def get_data():
+    # Cache-Control: public, max-age=300
+    return {"data": "cached for 5 minutes"}
+```
+
 ## 🎛️ Advanced Configuration
 
 ### Custom Cache Options
@@ -214,7 +281,11 @@ Comprehensive documentation is available at [https://hishel.com/dev](https://his
 - [Getting Started](https://hishel.com)
 - [HTTPX Integration](https://hishel.com/dev/integrations/httpx)
 - [Requests Integration](https://hishel.com/dev/integrations/requests)
+- [ASGI Integration](https://hishel.com/dev/asgi)
+- [FastAPI Integration](https://hishel.com/dev/fastapi)
+- [BlackSheep Integration](https://hishel.com/dev/integrations/blacksheep)
 - [Storage Backends](https://hishel.com/dev/storages)
+- [Request/Response Metadata](https://hishel.com/dev/metadata)
 - [RFC 9111 Specification](https://hishel.com/dev/specification)
 
 ## 🤝 Contributing
@@ -255,44 +326,85 @@ Hishel is inspired by and builds upon the excellent work in the Python HTTP ecos
 
 All notable changes to this project will be documented in this file.
 
-## 1.0.0dev1 - 2025-10-21
-### <!-- 7 -->⚙️ Miscellaneous Tasks
+## 1.0.0.dev3 - 2025-10-26
+### ♻️ Refactoring
+- Replace pairs with entries, simplify storage API
+- Automatically generate httpx sync integration from async
+
+### ⚙️ Miscellaneous Tasks
+- Simplify metadata docs
+- Add custom integrations docs
+- More robust compressed response caching
+
+### 🐛 Bug Fixes
+- Add missing permissions into `publish.yml`
+- Raise on consumed httpx streams, which we can't store as is (it's already decoded)
+- Fix compressed data caching for requests
+- Handle httpx iterable usage instead of iterator correctly
+- Add date header for proper age calculation
+
+### 🚀 Features
+- Add integrations with fastapi and asgi
+- Add blacksheep integration examples
+- Add logging for asgi
+
+## 1.0.0.dev2 - 2025-10-21
+### ⚙️ Miscellaneous Tasks
+- Remove redundant utils and tests
+- Add import without extras check in ci
+- Fix time travel date, explicitly specify the timezone
+
+### 🐛 Bug Fixes
+- Fix check for storing auth requests
+- Don't raise an error on 3xx during revalidation
+
+### 🚀 Features
+- Add hishel_created_at response metadata
+
+## 1.0.0.dev1 - 2025-10-21
+### ⚙️ Miscellaneous Tasks
 - Remove some redundant utils methods
 
+### 📦 Dependencies
+- Make httpx and async libs optional dependencies
+- Make `anysqlite` optional dependency
+- Install async extra with httpx
+- Improve git-cliff
+
 ## 1.0.0.dev0 - 2025-10-19
-### <!-- 7 -->⚙️ Miscellaneous Tasks
+### ⚙️ Miscellaneous Tasks
 - Use mike powered versioning
 - Improve docs versioning, deploy dev doc on ci
 
 ## 0.1.5 - 2025-10-18
-### <!-- 0 -->🚀 Features
+### ⚙️ Miscellaneous Tasks
+- Remove some redundant files from repo
+
+### 🐛 Bug Fixes
+- Fix some line breaks
+
+### 🚀 Features
 - Set chunk size to 128KB for httpx to reduce SQLite read/writes
 - Better cache-control parsing
 - Add close method to storages API (#384)
 - Increase requests buffer size to 128KB, disable charset detection
 
-### <!-- 1 -->🐛 Bug Fixes
-- Fix some line breaks
+## 0.1.4 - 2025-10-14
+### ⚙️ Miscellaneous Tasks
+- Improve CI (#369)
+- Remove src folder (#373)
+- Temporary remove python3.14 from CI
+- Add sqlite tests for new storage
+- Move some tests to beta
 
-### <!-- 7 -->⚙️ Miscellaneous Tasks
-- Remove some redundant files from repo
+### 🐛 Bug Fixes
+- Create an sqlite file in a cache folder
+- Fix beta imports
 
-## 0.1.4 - 2025-10-14
-### <!-- 0 -->🚀 Features
+### 🚀 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
 
-### <!-- 1 -->🐛 Bug Fixes
-- Create an sqlite file in a cache folder
-- Fix beta imports
-
-### <!-- 7 -->⚙️ Miscellaneous Tasks
-- Improve CI (#369)
-- Remove src folder (#373)
-- Temporary remove python3.14 from CI
-- Add sqlite tests for new storage
-- Move some tests to beta
-