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

hishel/_utils.py

@@ -2,19 +2,13 @@ from __future__ import annotations
 
 import calendar
 import hashlib
-import json
-import sqlite3
 import time
 import typing as tp
-from datetime import date
 from email.utils import parsedate_tz
-from typing import Any, AsyncIterator, Generator, Iterable, Iterator, TypeVar
+from typing import AsyncIterator, Generator, Iterable, Iterator, TypeVar
 
-import anyio
-import anysqlite
 import httpcore
 import httpx
-from anyio import from_thread, to_thread
 
 HEADERS_ENCODING = "iso-8859-1"
 
@@ -116,10 +110,6 @@ def parse_date(date: str) -> tp.Optional[int]:
     return timestamp
 
 
-async def asleep(seconds: tp.Union[int, float]) -> None:
-    await anyio.sleep(seconds)
-
-
 def sleep(seconds: tp.Union[int, float]) -> None:
     time.sleep(seconds)
 
@@ -155,66 +145,6 @@ def partition(iterable: tp.Iterable[T], predicate: tp.Callable[[T], bool]) -> tp
     return matching, non_matching
 
 
-def async_iterator_to_sync(iterator: AsyncIterator[bytes]) -> Iterator[bytes]:
-    """
-    Convert an asynchronous byte iterator to a synchronous one.
-    This function takes an asynchronous iterator that yields bytes and converts it into
-    a synchronous iterator.
-
-    Args:
-        iterator (AsyncIterator[bytes]): The asynchronous byte iterator to be converted.
-    Returns:
-        Iterator[bytes]: A synchronous iterator that yields the same byte chunks as the input iterator.
-    Example:
-        ```python
-        async_iter = some_async_byte_stream()
-        sync_iter = async_iterator_to_sync(async_iter)
-        for chunk in sync_iter:
-            process_bytes(chunk)
-        ```
-    """
-
-    while True:
-        try:
-            chunk = from_thread.run(iterator.__anext__)
-        except StopAsyncIteration:
-            break
-        yield chunk
-
-
-def _call_next(iterator: Iterator[bytes]) -> bytes:
-    try:
-        return iterator.__next__()
-    except StopIteration:
-        raise StopAsyncIteration
-
-
-async def sync_iterator_to_async(iterator: Iterator[bytes]) -> AsyncIterator[bytes]:
-    """
-    Converts a synchronous bytes iterator to an asynchronous one.
-    This function takes a synchronous iterator that yields bytes and converts it into an
-    asynchronous iterator, allowing it to be used in async contexts without blocking.
-    Args:
-        iterator (Iterator[bytes]): A synchronous iterator yielding bytes objects.
-    Returns:
-        AsyncIterator[bytes]: An asynchronous iterator yielding the same bytes objects.
-    Example:
-        ```
-        sync_iter = iter([b'data1', b'data2'])
-        async for chunk in sync_iterator_to_async(sync_iter):
-            await process_chunk(chunk)
-        ```
-    """
-
-    while True:
-        try:
-            chunk = await to_thread.run_sync(_call_next, iterator)
-        except StopAsyncIteration:
-            break
-
-        yield chunk
-
-
 async def make_async_iterator(iterable: Iterable[bytes]) -> AsyncIterator[bytes]:
     for item in iterable:
         yield item
@@ -286,173 +216,3 @@ class GeneratorWithReturnValue:
             self.value = exc.value
             raise
         return chunk
-
-
-def print_sqlite_state(conn: sqlite3.Connection) -> str:
-    """
-    Print all tables and their rows in a pretty format suitable for inline snapshots.
-
-    Args:
-        conn: SQLite database connection
-
-    Returns:
-        Formatted string representation of the database state
-    """
-    cursor = conn.cursor()
-
-    # Get all table names
-    cursor.execute("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name")
-    tables = [row[0] for row in cursor.fetchall()]
-
-    output_lines = []
-    output_lines.append("=" * 80)
-    output_lines.append("DATABASE SNAPSHOT")
-    output_lines.append("=" * 80)
-
-    for table_name in tables:
-        # Get column information
-        cursor.execute(f"PRAGMA table_info({table_name})")
-        columns = cursor.fetchall()
-        column_names = [col[1] for col in columns]
-        column_types = {col[1]: col[2] for col in columns}
-
-        # Get all rows
-        cursor.execute(f"SELECT * FROM {table_name}")
-        rows = cursor.fetchall()
-
-        output_lines.append("")
-        output_lines.append(f"TABLE: {table_name}")
-        output_lines.append("-" * 80)
-        output_lines.append(f"Rows: {len(rows)}")
-        output_lines.append("")
-
-        if not rows:
-            output_lines.append("  (empty)")
-            continue
-
-        # Format each row
-        for idx, row in enumerate(rows, 1):
-            output_lines.append(f"  Row {idx}:")
-
-            for col_name, value in zip(column_names, row):
-                col_type = column_types[col_name]
-                formatted_value = format_value(value, col_name, col_type)
-                output_lines.append(f"    {col_name:15} = {formatted_value}")
-
-            if idx < len(rows):
-                output_lines.append("")
-
-    output_lines.append("")
-    output_lines.append("=" * 80)
-
-    result = "\n".join(output_lines)
-    return result
-
-
-async def aprint_sqlite_state(conn: anysqlite.Connection) -> str:
-    """
-    Print all tables and their rows in a pretty format suitable for inline snapshots.
-
-    Args:
-        conn: SQLite database connection
-
-    Returns:
-        Formatted string representation of the database state
-    """
-    cursor = await conn.cursor()
-
-    # Get all table names
-    await cursor.execute("SELECT name FROM sqlite_master WHERE type='table' ORDER BY name")
-    tables = [row[0] for row in await cursor.fetchall()]
-
-    output_lines = []
-    output_lines.append("=" * 80)
-    output_lines.append("DATABASE SNAPSHOT")
-    output_lines.append("=" * 80)
-
-    for table_name in tables:
-        # Get column information
-        await cursor.execute(f"PRAGMA table_info({table_name})")
-        columns = await cursor.fetchall()
-        column_names = [col[1] for col in columns]
-        column_types = {col[1]: col[2] for col in columns}
-
-        # Get all rows
-        await cursor.execute(f"SELECT * FROM {table_name}")
-        rows = await cursor.fetchall()
-
-        output_lines.append("")
-        output_lines.append(f"TABLE: {table_name}")
-        output_lines.append("-" * 80)
-        output_lines.append(f"Rows: {len(rows)}")
-        output_lines.append("")
-
-        if not rows:
-            output_lines.append("  (empty)")
-            continue
-
-        # Format each row
-        for idx, row in enumerate(rows, 1):
-            output_lines.append(f"  Row {idx}:")
-
-            for col_name, value in zip(column_names, row):
-                col_type = column_types[col_name]
-                formatted_value = format_value(value, col_name, col_type)
-                output_lines.append(f"    {col_name:15} = {formatted_value}")
-
-            if idx < len(rows):
-                output_lines.append("")
-
-    output_lines.append("")
-    output_lines.append("=" * 80)
-
-    result = "\n".join(output_lines)
-    return result
-
-
-def format_value(value: Any, col_name: str, col_type: str) -> str:
-    """Format a value for display based on its type and column name."""
-
-    if value is None:
-        return "NULL"
-
-    # Handle BLOB columns
-    if col_type.upper() == "BLOB":
-        if isinstance(value, bytes):
-            # Try to decode as UTF-8 string first
-            try:
-                decoded = value.decode("utf-8")
-                # Check if it looks like JSON
-                if decoded.strip().startswith("{") or decoded.strip().startswith("["):
-                    try:
-                        parsed = json.loads(decoded)
-                        return f"(JSON) {json.dumps(parsed, indent=2)}"
-                    except json.JSONDecodeError:
-                        pass
-                # Show string if it's printable
-                if all(32 <= ord(c) <= 126 or c in "\n\r\t" for c in decoded):
-                    return f"(str) '{decoded}'"
-            except UnicodeDecodeError:
-                pass
-
-            # Show hex representation for binary data
-            hex_str = value.hex()
-            if len(hex_str) > 64:
-                return f"(bytes) 0x{hex_str[:60]}... ({len(value)} bytes)"
-            return f"(bytes) 0x{hex_str} ({len(value)} bytes)"
-        return repr(value)
-
-    # Handle timestamps - ONLY show date, not the raw timestamp
-    if col_name.endswith("_at") and isinstance(value, (int, float)):
-        try:
-            dt = date.fromtimestamp(value)
-            return dt.isoformat()  # Changed: removed the timestamp prefix
-        except (ValueError, OSError):
-            return str(value)
-
-    # Handle TEXT columns
-    if col_type.upper() == "TEXT":
-        return f"'{value}'"
-
-    # Handle other types
-    return str(value)

hishel/httpx.py

@@ -4,8 +4,6 @@ import ssl
 import typing as t
 from typing import AsyncIterator, Iterable, Iterator, Union, overload
 
-import httpx
-
 from hishel import Headers, Request, Response
 from hishel._async_cache import AsyncCacheProxy
 from hishel._core._base._storages._base import AsyncBaseStorage, SyncBaseStorage
@@ -15,6 +13,15 @@ from hishel._core._spec import (
 from hishel._core.models import AnyIterable
 from hishel._sync_cache import SyncCacheProxy
 
+try:
+    import httpx
+except ImportError as e:
+    raise ImportError(
+        "httpx is required to use hishel.httpx module. "
+        "Please install hishel with the 'httpx' extra, "
+        "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]],

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hishel
-Version: 1.0.0.dev0
+Version: 1.0.0.dev1
 Summary:  Elegant HTTP Caching for Python
 Project-URL: Homepage, https://hishel.com
 Project-URL: Source, https://github.com/karpetrosyan/hishel
@@ -24,12 +24,14 @@ 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: async
+Requires-Dist: anyio>=4.9.0; extra == 'async'
+Requires-Dist: anysqlite>=0.0.5; extra == 'async'
 Provides-Extra: httpx
+Requires-Dist: anyio>=4.9.0; extra == 'httpx'
+Requires-Dist: anysqlite>=0.0.5; extra == 'httpx'
 Requires-Dist: httpx>=0.28.1; extra == 'httpx'
 Provides-Extra: requests
 Requires-Dist: requests>=2.32.5; extra == 'requests'
@@ -249,73 +251,48 @@ 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>
 
-## [1.0.0dev0] - 2025-10-19
+# Changelog
 
-### ⚙️ Miscellaneous Tasks
+All notable changes to this project will be documented in this file.
 
-- *(docs)* Use mike powered versioning
-- *(docs)* Improve docs versioning, deploy dev doc on ci
-## [0.1.5] - 2025-10-18
+## 1.0.0dev1 - 2025-10-21
+### <!-- 7 -->⚙️ Miscellaneous Tasks
+- Remove some redundant utils methods
 
-### 🚀 Features
+## 1.0.0.dev0 - 2025-10-19
+### <!-- 7 -->⚙️ Miscellaneous Tasks
+- Use mike powered versioning
+- Improve docs versioning, deploy dev doc on ci
 
-- *(perf)* Set chunk size to 128KB for httpx to reduce SQLite read/writes
+## 0.1.5 - 2025-10-18
+### <!-- 0 -->🚀 Features
+- 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
+- Increase requests buffer size to 128KB, disable charset detection
 
-### 🐛 Bug Fixes
-
-- *(docs)* Fix some line breaks
-
-### ⚙️ Miscellaneous Tasks
+### <!-- 1 -->🐛 Bug Fixes
+- Fix some line breaks
 
+### <!-- 7 -->⚙️ Miscellaneous Tasks
 - Remove some redundant files from repo
-## [0.1.4] - 2025-10-14
-
-### 🚀 Features
 
+## 0.1.4 - 2025-10-14
+### <!-- 0 -->🚀 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
-
+### <!-- 1 -->🐛 Bug Fixes
 - Create an sqlite file in a cache folder
 - Fix beta imports
 
-### ⚙️ Miscellaneous Tasks
-
+### <!-- 7 -->⚙️ 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
+- Remove src folder (#373)
+- Temporary remove python3.14 from CI
+- Add sqlite tests for new storage
+- Move some tests to beta
 
-- *(redis)* Do not update metadata with negative ttl (#231)
-## [0.0.1] - 2023-07-22

{hishel-1.0.0.dev0.dist-info → hishel-1.0.0.dev1.dist-info}/RECORD

@@ -1,19 +1,19 @@
 hishel/__init__.py,sha256=byj_IhCjFMaBcp6R8iyRlQV-3R4uTfH44PQzB4lVe1g,1447
 hishel/_async_cache.py,sha256=gE5CygC7FG9htBMfxul7carRRNph8zcMlSoOcB_LNTY,6792
 hishel/_sync_cache.py,sha256=lfkWHJFK527peESMaufjKSbXBriidc09tOwBwub2t34,6538
-hishel/_utils.py,sha256=uO8PcY_E1sHSgBGzZ2GNB4kpKqAlzmnzPCc3s-yDd44,13826
-hishel/httpx.py,sha256=HcJ5iO9PgkEOp92ti8013N6m1IotLajwd9M_DLsmrX0,10997
+hishel/_utils.py,sha256=hQURFuNdS7sjHeVGu12MQzJewjFdnVrdOki3CjBfZvs,6162
+hishel/httpx.py,sha256=vscNB426VIhh0f5qQVkGA_WpwVvaKxbI6gnsHrBA_D0,11226
 hishel/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hishel/requests.py,sha256=eiWcwCId04DucnquCsU12tj9cDZcn-cjZ9MYniVuNeo,6429
 hishel/_core/__init__.py,sha256=byj_IhCjFMaBcp6R8iyRlQV-3R4uTfH44PQzB4lVe1g,1447
 hishel/_core/_headers.py,sha256=ii4x2L6GoQFpqpgg28OtFh7p2DoM9mhE4q6CjW6xUWc,17473
 hishel/_core/_spec.py,sha256=d2ZnTXttyT4zuVq9xHAO86VGJxAEBxD2a8WMyEgOuAo,102702
 hishel/_core/models.py,sha256=5qwo1WifrDeZdXag7M5rh0hJuVsm1N-sF3UagQ5LcLc,5519
-hishel/_core/_async/_storages/_sqlite.py,sha256=wIO0UaFzal9qoVqDVczzcsW0kGUjBQD-ikauc_MN414,14704
+hishel/_core/_async/_storages/_sqlite.py,sha256=QPbNtNMA7vYjpt8bSPFIZ4u4c3UCH6eDfUWnH6WprTU,17787
 hishel/_core/_base/_storages/_base.py,sha256=xLJGTBlFK8DVrQMgRMtGXJnYRUmNB-iYkk7S-BtMx8s,8516
 hishel/_core/_base/_storages/_packing.py,sha256=NFMpSvYYTDBNkzwpjj5l4w-JOPLc19oAEDqDEQJ7VZI,4873
-hishel/_core/_sync/_storages/_sqlite.py,sha256=TDm9jXIWtd54m4_8AiVApxZVmbBoeFVi3E6s-vGzDjs,14138
-hishel-1.0.0.dev0.dist-info/METADATA,sha256=EpqEHRIGfzVXqMiRefCa_NZ9AlbjzVToXfnK-GBrs9o,9993
-hishel-1.0.0.dev0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hishel-1.0.0.dev0.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
-hishel-1.0.0.dev0.dist-info/RECORD,,
+hishel/_core/_sync/_storages/_sqlite.py,sha256=kvAcV2FttZstWEfCczBxj30-PYdj1y9lzh0x3hNusKY,17210
+hishel-1.0.0.dev1.dist-info/METADATA,sha256=IW6_UTqzUl-k8Pcyil_6brlEgd-gKomu1OyeZxrN3dU,9727
+hishel-1.0.0.dev1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hishel-1.0.0.dev1.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
+hishel-1.0.0.dev1.dist-info/RECORD,,