Небольшие правки и улучшение README

.pre-commit-config.yaml

@@ -1,18 +1,18 @@
 repos:
   - repo: https://github.com/crate-ci/typos
-    rev: v1.36.3
+    rev: v1.42.0
     hooks:
       - id: typos
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.13.2
+    rev: v0.14.13
     hooks:
       - id: ruff
         args: [ --fix ]
       - id: ruff-format
 
   - repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.405
+    rev: v1.1.408
     hooks:
     - id: pyright
 

README.md

@@ -1,117 +1,121 @@
-# aiohttpx
+# AioHTTPX
 
-## Description
+**AioHTTPX** is an internal async HTTP client built on top of **httpx.AsyncClient**, using **aiohttp** as the transport layer for improved async performance.
+It also adds **Redis-backed rate limiting and response caching** at the transport level.
 
-**aiohttpx** is an asynchronous HTTP client that merges the ergonomics and powerful API of [httpx](https://github.com/encode/httpx) with the high-performance transport layer of [aiohttp](https://github.com/aio-libs/aiohttp).
+---
-It also provides optional Redis-powered caching and rate-limiting to enable efficient, production-grade request handling with minimal setup.
 
-## Features
+## What it provides
 
-* Fully asynchronous HTTP client using **aiohttp** as the transport.
+* `AioHTTPXClient` — a drop-in replacement for `httpx.AsyncClient`
-* Optional **Redis-based caching** to reduce redundant API calls.
+* `aiohttp`-based async transport
-* Optional **Redis-based rate limiting** to control request throughput.
+* Optional **rate limiting** (Redis)
-* Familiar API interface inspired by **httpx**.
+* Optional **response caching** (Redis, TTL via headers)
 
-## Requirements
+---
 
-* Python 3.13 or higher
+## Installation (internal)
-* Redis server (if using caching or rate limiting)
 
-## Installation
+Configure pip with your private index:
 
-### Using `uv` Tool
+```ini
+[global]
+index-url = https://git.miwory.dev/api/packages/Miwory/pypi/simple
+username = <USERNAME>
+password = <PASSWORD>
+```
 
-This project supports dependency management via the [uv tool](https://github.com/astral-sh/uv).
+Then install:
-To set up the project:
-
-1. **Install uv**
 
 ```bash
-   curl -LsSf https://astral.sh/uv/install.sh | sh
+pip install aiohttpx
 ```
 
-2. **Add to the repository**
+---
-
-   ```bash
-   uv add https://git.meowly.ru/Miwory/aiohttpx.git
-   ```
-
-## Configuration
-
-aiohttpx supports several optional parameters for caching and rate limiting:
-
-### `key` — Redis prefix
-
-A string used as the **Redis key namespace** for all cache and rate-limit entries.
-This allows multiple clients or services to share the same Redis instance without collisions.
-
-### `limit` — Rate limit
-
-The maximum number of requests allowed **per second** for this client.
-This value is enforced using Redis, making it safe to use across distributed systems.
-
-### `X-Cache-TTL` — Enable caching for a request
-
-To enable caching for a specific request, include the header:
-
-```text
-X-Cache-TTL: <seconds>
-```
-
-Example:
-
-```python
-response = await client.get(
-    "/users",
-    headers={"X-Cache-TTL": "60"},  # cache this endpoint for 60 seconds
-)
-```
-
-If this header is present and Redis is configured, the response will be cached for the specified duration.
 
 ## Usage
 
-### Basic Example
+### Basic client (no Redis)
 
 ```python
-from aiohttpx.client import AioHTTPXClient
+from aiohttpx import AioHTTPXClient
 
-class TwitchAPIClient(AioHTTPXClient):
+async with AioHTTPXClient() as client:
-    def __init__(
+    r = await client.get("https://example.com")
-        self,
+    print(r.text)
-        redis_url: str,
+```
-        client_id: str,
-        client_secret: str,
-        redirect_uri: str,
-    ):
-        self.base_uri = 'https://api.twitch.tv/helix'
-        self.client_id = client_id
-        self.client_secret = client_secret
-        self.redirect_uri = redirect_uri
 
-        super().__init__(
+This uses:
-            base_url=self.base_uri,
+
-            headers={'Client-Id': self.client_id},
+* `aiohttp.ClientSession` under the hood
-            redis_url=redis_url,
+* httpx-compatible request / response API
-            key='twitch',      # Redis prefix
+
-            limit=10,          # 10 requests per second
+---
-            logger='Twitch API',
+
+## Rate limiting
+
+Rate limiting is **optional** and requires Redis.
+
+```python
+client = AioHTTPXClient(
+    redis_url="redis://localhost:6379",
+    key="my-rate-limit-key",
+    limit=60,  # requests per minute
 )
-
-    async def test_endpoint(self):
-        ...
 ```
 
-## Linting and Pre-commit Checks
+How it works:
 
-This project uses `pre-commit` and `ruff` for linting and formatting.
+* Token-based limiting using Redis time
-Run the linting process with:
+* Requests exceeding the limit are delayed and retried
+* Implemented in `AsyncRateLimit`
 
-```bash
+---
-poe lint
+
+## Response caching
+
+Caching is also **optional** and Redis-backed.
+
+```python
+client = AioHTTPXClient(
+    redis_url="redis://localhost:6379",
+)
 ```
 
-## License
+To enable caching for a request, set a TTL header:
 
-This project is licensed under the MIT License.
+```python
-See `LICENSE` for details.
+await client.get(
+    "https://example.com/data",
+    headers={"X-Cache-TTL": "30"},
+)
+```
+
+Notes:
+
+* Cache key = method + URL
+* TTL is read from `X-Cache-TTL` header
+* Cached responses are fully reconstructed `Response` objects
+
+---
+
+## Configuration parameters
+
+`AioHTTPXClient(...)` supports all standard `httpx.AsyncClient` arguments **plus**:
+
+| Parameter   | Type          | Description          |
+| ----------- | ------------- | -------------------- |
+| `redis_url` | `str \| None` | Redis connection URL |
+| `key`       | `str \| None` | Rate limit Redis key |
+| `limit`     | `int \| None` | Requests per minute  |
+| `logger`    | `str \| None` | Logger name          |
+
+---
+
+## Notes & limitations
+
+* ❌ Sync client is not supported
+* ❌ HTTP/2 disabled (`http1=True`, `http2=False`)
+* ✅ Automatic retry on network/connect errors
+
+---

pyproject.toml

@@ -1,11 +1,9 @@
 [project]
 name = "aiohttpx"
-version = "1.3.1"
+version = "1.4.0"
 description = "Custom HTTPX client with aiohttp transport, rate limiter and caching"
 readme = "README.md"
-authors = [
+authors = [{ name = "Miwory", email = "miwory.uwu@gmail.com" }]
-    { name = "Miwory", email = "miwory.uwu@gmail.com" }
-]
 requires-python = ">=3.13"
 dependencies = [
     "aiohttp[speedups]>=3.13,<=3.14",
@@ -16,10 +14,10 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
-    "ruff==0.14.2",
+    "ruff==0.14.13",
-    "pyright==1.1.407",
+    "pyright==1.1.408",
-    "poethepoet==0.37.0",
+    "poethepoet==0.40.0",
-    "pre-commit==4.3.0",
+    "pre-commit==4.5.1",
     "types-redis==4.6.0.20241004",
 ]
 

src/aiohttpx/__init__.py

@@ -1 +0,0 @@
-__version__: str = '1.1.0'