hishel 0.1.4__py3-none-any.whl → 1.0.0b1__py3-none-any.whl

hishel-0.1.4.dist-info/METADATA

@@ -1,404 +0,0 @@
-Metadata-Version: 2.4
-Name: hishel
-Version: 0.1.4
-Summary: Persistent cache implementation for httpx and httpcore
-Project-URL: Homepage, https://hishel.com
-Project-URL: Source, https://github.com/karpetrosyan/hishel
-Author-email: Kar Petrosyan <kar.petrosyanpy@gmail.com>
-License-Expression: BSD-3-Clause
-License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Web Environment
-Classifier: Framework :: AsyncIO
-Classifier: Framework :: Trio
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-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'
-Provides-Extra: sqlite
-Requires-Dist: anysqlite>=0.0.5; extra == 'sqlite'
-Provides-Extra: yaml
-Requires-Dist: pyyaml==6.0.2; extra == 'yaml'
-Description-Content-Type: text/markdown
-
-<p align="center" class="logo">
-    <div align="center">
-        <picture>
-            <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/karpetrosyan/hishel/master/docs/static/Shelkopryad_350x250_yellow.png">
-            <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/karpetrosyan/hishel/master/docs/static/Shelkopryad_350x250_black.png">
-            <img alt="Logo" src="https://raw.githubusercontent.com/karpetrosyan/hishel/master/docs/static/Shelkopryad_350x250_yellow.png">
-        </picture>
-    </div>
-</p>
-
-
-
-<p align="center"><strong>Hishel</strong> <em>- An elegant HTTP Cache implementation for httpx and httpcore.</em></p>
-
-<p align="center">
-
-  <a href="https://pypi.org/project/hishel">
-      <img src="https://img.shields.io/pypi/v/hishel.svg" alt="pypi">
-  </a>
-
-  <a href="https://img.shields.io/pypi/l/hishel">
-      <img src="https://img.shields.io/pypi/l/hishel" alt="license">
-  </a>
-
-  <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">
-      <img src="https://img.shields.io/pypi/dm/hishel.svg" alt="Downloads">
-  </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.
-
-## Features
-
-- 💾 **Persistence**: Responses are cached in the [**persistent memory**](https://en.m.wikipedia.org/wiki/Persistent_memory) for later use.
-- 🤲 **Compatibility**: It is completely compatible with your existing transports or connection pools, *whether they are default, custom, or provided by third-party libraries.*
-- 🤗 **Easy to use**: You continue to use httpx while also enabling [web cache](https://en.wikipedia.org/wiki/Web_cache).
-- 🧠 **Smart**: Attempts to clearly implement RFC 9111, understands `Vary`, `Etag`, `Last-Modified`,  `Cache-Control`, and `Expires` headers, and *handles response re-validation automatically*.
-- ⚙️  **Configurable**: You have complete control over how the responses are stored and serialized.
-- 📦 **From the package**:
-    - Built-in support for [File system](https://en.wikipedia.org/wiki/File_system), [Redis](https://en.wikipedia.org/wiki/Redis), [SQLite](https://en.wikipedia.org/wiki/SQLite), and [AWS S3](https://aws.amazon.com/s3/) backends.
-    - Built-in support for [JSON](https://en.wikipedia.org/wiki/JSON), [YAML](https://en.wikipedia.org/wiki/YAML), and [pickle](https://docs.python.org/3/library/pickle.html) serializers.
-- 🚀 **Very fast**: Your requests will be even faster if there are *no IO operations*.
-
-## Documentation
-Go through the [Hishel documentation](https://hishel.com).
-
-## QuickStart
-
-Install `Hishel` using pip:
-``` shell
-$ pip install hishel
-```
-
-Let's begin with an example of a httpx client.
-
-```python
-import hishel
-
-with hishel.CacheClient() as client:
-    client.get("https://hishel.com")  # 0.4749558370003797s
-    client.get("https://hishel.com")  # 0.002873589000046195s (~250x faster!)
-```
-
-or in asynchronous context
-
-```python
-import hishel
-
-async with hishel.AsyncCacheClient() as client:
-    await client.get("https://hishel.com")
-    await client.get("https://hishel.com")  # takes from the cache
-```
-
-## Configurations
-
-Configure when and how you want to store your responses.
-
-```python
-import hishel
-
-# All the specification configs
-controller = hishel.Controller(
-        # Cache only GET and POST methods
-        cacheable_methods=["GET", "POST"],
-
-        # Cache only 200 status codes
-        cacheable_status_codes=[200],
-
-        # Use the stale response if there is a connection issue and the new response cannot be obtained.
-        allow_stale=True,
-
-        # First, revalidate the response and then utilize it.
-        # If the response has not changed, do not download the
-        # entire response data from the server; instead,
-        # use the one you have because you know it has not been modified.
-        always_revalidate=True,
-)
-
-# All the storage configs
-storage = hishel.S3Storage(
-        bucket_name="my_bucket_name", # store my cache files in the `my_bucket_name` bucket
-        ttl=3600, # delete the response if it is in the cache for more than an hour
-)
-client = hishel.CacheClient(controller=controller, storage=storage)
-
-
-# Ignore the fact that the server does not recommend you cache this request!
-client.post(
-        "https://example.com",
-        extensions={"force_cache": True}
-)
-
-
-# Return a regular response if it is in the cache; else, return a 504 status code. DO NOT SEND A REQUEST!
-client.post(
-        "https://example.com",
-        headers=[("Cache-Control", "only-if-cached")]
-)
-
-
-# Ignore cached responses and do not store incoming responses!
-response = client.post(
-        "https://example.com",
-        extensions={"cache_disabled": True}
-)
-```
-
-## How and where are the responses saved?
-
-The responses are stored by `Hishel` in [storages](https://hishel.com/userguide/#storages).
-You have complete control over them; you can change storage or even write your own if necessary.
-
-
-## Support the project
-
-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 ❤️
-
-## [0.1.4] - 2025-10-14
-
-### 🚀 Features
-
-- Add support for requests library
-- Add support for Python 3.14
-- 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
-- Added `Metadata` to public API. (#363)
-- Fix race condition in FileStorage initialization. (#353)
-
-### 🐛 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 (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.0.12 (8th September, 2023)
-
-- Add metadata into the response extensions. (#56)
-
-## 0.0.11 (15th August, 2023)
-
-- Add support for request `cache-control` directives. (#42)
-- Drop httpcore dependency. (#40)
-- Support HTTP methods only if they are defined as cacheable. (#37)
-
-## 0.0.10 (7th August, 2023)
-
-- Add Response metadata. (#33)
-- Add API Reference documentation. (#30)
-- Use stale responses only if the client is disconnected. (#28)
-
-## 0.0.9 (1st August, 2023)
-
-- Expose Controller API. (#23)
-
-## 0.0.8 (31st July, 2023)
-
-- Skip redis tests if the server was not found. (#16)
-- Decrease sleep time for the storage ttl tests. (#18)
-- Fail coverage under 100. (#19)
-
-## 0.0.7 (30th July, 2023)
-
-- Add support for `Heuristic Freshness`. (#11)
-- Change `Controller.cache_heuristically` to `Controller.allow_heuristics`. (#12)
-- Handle import errors. (#13)
-
-## 0.0.6 (29th July, 2023)
-
-- Fix `Vary` header validation. (#8)
-- Dump original requests with the responses. (#7)
-
-## 0.0.5 (29th July, 2023)
-
-- Fix httpx response streaming.
-
-## 0.0.4 (29th July, 2023)
-
-- Change `YamlSerializer` name to `YAMLSerializer`.
-
-## 0.0.3 (28th July, 2023)
-
-- Add `from_cache` response extension.
-- Add `typing_extensions` into the requirements.
-
-## 0.0.2 (25th July, 2023)
-
-- 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.

hishel-0.1.4.dist-info/RECORD

@@ -1,41 +0,0 @@
-hishel/__init__.py,sha256=uFPxYPm-vFegjbeEvYmTqIE7ALymqYf837Z1mMZNVdM,1221
-hishel/_controller.py,sha256=nQMEF-upuBf6-r0wyjd2CGYgBhB-JbEw6IgGxtvADJ4,24629
-hishel/_exceptions.py,sha256=qbg55RNlzwhv5JreWY9Zog_zmmiKdn5degtqJKijuRs,198
-hishel/_files.py,sha256=7J5uX7Nnzd7QQWfYuDGh8v6XGLG3eUDBjoJZ4aTaY1c,2228
-hishel/_headers.py,sha256=BPvas0LQgwbz-HZhFykZiHEIeNgnY-E33U__oskYzJw,7323
-hishel/_lfu_cache.py,sha256=GBxToQI8u_a9TzYnLlZMLhgZ8Lb83boPHzTvIgqV6pA,2707
-hishel/_lmdb_types_.pyi,sha256=2qx4-3kZhkKxhkWApZdnoGck3CbPrhUJQIIMLPBT90w,1492
-hishel/_s3.py,sha256=HkmWYjYWAiWgEMp1_Jl79hG5aUpMcD0NDXjj8VHRmQE,4322
-hishel/_serializers.py,sha256=wQ5xqeQPAnzDFxLrjmWUP6f0IC0RihpgpTgy3jljxjE,11646
-hishel/_synchronization.py,sha256=xOmU9_8KAWTAv3r8EpqPISrtSF3slyh1J0Sc7ZQO1rg,897
-hishel/_utils.py,sha256=uO8PcY_E1sHSgBGzZ2GNB4kpKqAlzmnzPCc3s-yDd44,13826
-hishel/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hishel/_async/__init__.py,sha256=_oAltH4emAtUF7_9SSxz_KKGYzSXL34o_EGgGvoPG7E,187
-hishel/_async/_client.py,sha256=WqYHV8SeAXlK6Q0uQe0ixkC99i64iOwD2EPOYhQcUL8,1088
-hishel/_async/_mock.py,sha256=995v9p5xiw3svGSOJATkLMqwodlhZhcwmGygLHM2VFw,1515
-hishel/_async/_pool.py,sha256=xCcSAl4bHI5eVsZyPap7iHDpxzzgfMqYE_txcjQJ1Hs,8195
-hishel/_async/_storages.py,sha256=zR0kIJSN1WK6P0qWpOTceEYtwWTcfgabf7t3qnGDK3w,28899
-hishel/_async/_transports.py,sha256=YTZecg1A5vnv4GnF9y9n394nzqGBAkr-M4BF2lvci5U,11445
-hishel/_sync/__init__.py,sha256=_oAltH4emAtUF7_9SSxz_KKGYzSXL34o_EGgGvoPG7E,187
-hishel/_sync/_client.py,sha256=hHTuS9wOBZhcNSQmbopSWTtTTGYu-q_0FQOc9g5TuRI,1048
-hishel/_sync/_mock.py,sha256=im88tZr-XhP9BpzvIt3uOjndAlNcJvFP7Puv3H-6lKU,1430
-hishel/_sync/_pool.py,sha256=U2b9ZGYUltwTjI2q2KHZwmj4boIqUExJ_rUKWuLmYSs,7960
-hishel/_sync/_storages.py,sha256=PAt0HdkGE-LNd-UV3EclrahuFFPcatDK4DoYiTXhiBM,28108
-hishel/_sync/_transports.py,sha256=ivPztcm84PxObIXMZ3hLD_o5HMo8XXGhRlSg0Lm_sNo,11117
-hishel/beta/__init__.py,sha256=VzlIfaGQaYfpesqOujNcG0HMCaIF9CzEyhIY04A4c8g,1477
-hishel/beta/_async_cache.py,sha256=vhdTyRIjMpKzc4qKPZGVoFQa9-60aCXLNGltOE1mDg8,6807
-hishel/beta/_sync_cache.py,sha256=a0fcNY5qApPBXQ_kCUBW2Ccwwj0bEkNTVmv-6W3cqPI,6553
-hishel/beta/httpx.py,sha256=KkK3_ZY3FyjWHDJFNLucXoEBph-pMkI2wuHdagXn_lo,10729
-hishel/beta/requests.py,sha256=Q6hPs8ZoFM6802ZCV9_ERG5BVRacMOMwpw5IanmPrYQ,6393
-hishel/beta/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hishel/beta/_core/_headers.py,sha256=vkdHZFFg734TO-kDpAZ271I7dXpwFUtAOuX3vS2LatU,9809
-hishel/beta/_core/_spec.py,sha256=5z5kZ7Q9BO8yZynQIiDiIly77iTMzUljekhmrF1Otyc,99529
-hishel/beta/_core/models.py,sha256=rbU72bCT_lpwASIs5Qzmo3vcjiDm-lu0C99-CgYWl7k,5524
-hishel/beta/_core/_async/_storages/_sqlite.py,sha256=_PZ4t8KXk-YErTCze80Uh8XnG8WZ2323VrRd0NwoKHY,14719
-hishel/beta/_core/_base/_storages/_base.py,sha256=XvhNNQhMNEc2Jt2p0k8SNW5_yLoDfmYMFfPncmKbmX0,8267
-hishel/beta/_core/_base/_storages/_packing.py,sha256=8s0UxYTLdwzs4A_1E896EVj5VPT8Aqv9UabWbeMD8lw,4898
-hishel/beta/_core/_sync/_storages/_sqlite.py,sha256=1sBU_geVbUSC8e46gao5p_k8MogYEWnZodse55FQQ6Q,14153
-hishel-0.1.4.dist-info/METADATA,sha256=GBT-r6kU3dotaAozdL7xlqDQ5jPt1D88kBcXKceGV1U,14344
-hishel-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hishel-0.1.4.dist-info/licenses/LICENSE,sha256=1qQj7pE0V2O9OIedvyOgLGLvZLaPd3nFEup3IBEOZjQ,1493
-hishel-0.1.4.dist-info/RECORD,,