erpc-py 0.1.0b1__tar.gz

erpc_py-0.1.0b1/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-02-24
+
+### Added
+
+- `ERPCProcess` — subprocess manager with start/stop/restart/health checks.
+- `ERPCConfig` / `CacheConfig` — programmatic YAML config generation.
+- `find_erpc_binary()` — automatic binary discovery (PATH, env var, common locations).
+- `install_erpc()` — download eRPC binary from GitHub releases.
+- `get_erpc_version()` — detect installed eRPC version.
+- Context manager support (`with ERPCProcess(...) as erpc:`).
+- Exception hierarchy: `ERPCError`, `ERPCNotFound`, `ERPCNotRunning`, `ERPCStartupError`, `ERPCHealthCheckError`.
+
+[0.1.0]: https://github.com/tars-endurance/erpc.py/releases/tag/v0.1.0

erpc_py-0.1.0b1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TARS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

erpc_py-0.1.0b1/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+recursive-include erpc py.typed

erpc_py-0.1.0b1/PKG-INFO

@@ -0,0 +1,328 @@
+Metadata-Version: 2.4
+Name: erpc-py
+Version: 0.1.0b1
+Summary: Python subprocess manager for eRPC v0.0.62 — fault-tolerant EVM RPC proxy
+Author-email: TARS <tars@endurance.sh>, Kieran Prasch <kieran@thethirdroom.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tars-endurance/erpc.py
+Project-URL: Documentation, https://tars-endurance.github.io/erpc.py
+Project-URL: Repository, https://github.com/tars-endurance/erpc.py
+Project-URL: Issues, https://github.com/tars-endurance/erpc.py/issues
+Project-URL: Changelog, https://github.com/tars-endurance/erpc.py/blob/main/CHANGELOG.md
+Keywords: ethereum,evm,rpc,proxy,cache,erpc,web3,blockchain,subprocess
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov<7,>=4.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.0; extra == "dev"
+Requires-Dist: ruff>=0.9.0; extra == "dev"
+Requires-Dist: mypy>=1.14; extra == "dev"
+Requires-Dist: pre-commit>=4.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.27; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+
+# erpc.py
+
+**Python subprocess manager for [eRPC](https://github.com/erpc/erpc) — the fault-tolerant EVM RPC proxy.**
+
+Like [py-geth](https://github.com/ethereum/py-geth) for Go-Ethereum, but for eRPC.
+
+[![PyPI](https://img.shields.io/pypi/v/erpc-py)](https://pypi.org/project/erpc-py/)
+[![CI](https://github.com/tars-endurance/erpc.py/actions/workflows/ci.yml/badge.svg)](https://github.com/tars-endurance/erpc.py/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/tars-endurance/erpc.py/branch/main/graph/badge.svg)](https://codecov.io/gh/tars-endurance/erpc.py)
+[![Python](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue)](https://pypi.org/project/erpc-py/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![mypy](https://img.shields.io/badge/type--checked-mypy%20strict-blue)](https://mypy-lang.org/)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://docs.astral.sh/ruff/)
+[![eRPC](https://img.shields.io/badge/eRPC-v0.0.62-orange)](https://github.com/erpc/erpc/releases/tag/0.0.62)
+
+</div>
+
+---
+
+> [!NOTE]
+> **This repository was built entirely by an AI agent** ([TARS](https://github.com/tars-endurance)) under the direction of a human engineer ([Kieran Prasch](https://github.com/KPrasch)). Every commit is co-authored. The architecture, priorities, and quality bar were set by a human; the implementation, tests, and documentation were produced by an AI — from first scaffold to 451 tests at 98% coverage. We believe this is how software will increasingly be built: human intent, machine execution, shared accountability.
+
+---
+
+## Compatibility
+
+| erpc.py | eRPC binary | Status |
+|---------|-------------|--------|
+| `0.1.x` | [`v0.0.62`](https://github.com/erpc/erpc/releases/tag/0.0.62) | ✅ Current |
+
+erpc.py pins a specific eRPC binary version (`erpc.ERPC_VERSION`). All config generation, tests, and CI target this version. Use `install_erpc()` to install the matching binary automatically.
+
+```python
+from erpc import ERPC_VERSION, install_erpc
+
+print(ERPC_VERSION)  # "0.0.62"
+install_erpc()       # downloads the pinned version
+```
+
+---
+
+## Overview
+
+**erpc.py** gives you full programmatic control over [eRPC](https://github.com/erpc/erpc) from Python — binary installation, YAML config generation, process lifecycle, health monitoring, and runtime metrics. Pure Python with only `pyyaml` as a runtime dependency.
+
+```python
+from erpc import ERPCProcess
+
+with ERPCProcess(upstreams={1: ["https://eth.llamarpc.com"]}) as erpc:
+    url = erpc.endpoint_url(1)  # http://127.0.0.1:4000/py-erpc/evm/1
+    print(f"Proxying Ethereum mainnet at {url}")
+```
+
+---
+
+## Installation
+
+```bash
+pip install erpc-py
+```
+
+To install the eRPC binary:
+
+```bash
+erpc-py install --version 0.0.62
+```
+
+Or programmatically:
+
+```python
+from erpc.install import install_erpc
+
+install_erpc("0.0.62")  # → /usr/local/bin/erpc
+```
+
+---
+
+## Quick Start
+
+### Minimal — just upstreams
+
+```python
+from erpc import ERPCProcess
+
+with ERPCProcess(upstreams={1: ["https://eth.llamarpc.com"]}) as erpc:
+    print(erpc.endpoint_url(1))
+    print(f"Healthy: {erpc.is_healthy}")
+```
+
+### Full config
+
+```python
+from erpc import ERPCConfig, ERPCProcess, CacheConfig
+
+config = ERPCConfig(
+    project_id="my-project",
+    upstreams={
+        1: ["https://eth.llamarpc.com", "https://rpc.ankr.com/eth"],
+        137: ["https://polygon-rpc.com"],
+    },
+    server_port=4000,
+    metrics_port=4001,
+    log_level="info",
+    cache=CacheConfig(max_items=50_000),
+)
+
+with ERPCProcess(config=config) as erpc:
+    print(erpc.endpoint_url(1))
+    print(erpc.endpoint_url(137))
+```
+
+---
+
+## Features
+
+### 🔧 Binary Management
+
+Auto-detect or install eRPC binaries from GitHub releases with optional SHA256 verification.
+
+```python
+from erpc.install import install_erpc
+
+path = install_erpc("0.0.62", checksum="abc123...")
+```
+
+### 📝 Config Builder
+
+Full-fidelity Python config that generates valid `erpc.yaml` — networks, upstreams, failsafe policies, rate limiters, auth, caching, database connectors, and more.
+
+```python
+from erpc import ERPCConfig, DatabaseConfig, RedisConnector, AuthConfig, SecretAuth
+
+config = ERPCConfig(
+    project_id="production",
+    upstreams={1: ["https://eth.llamarpc.com"]},
+    database=DatabaseConfig(
+        evm_json_rpc_cache=RedisConnector(addr="localhost:6379"),
+    ),
+    auth=AuthConfig(
+        strategies=[SecretAuth(value="my-secret-key")],
+    ),
+)
+
+config.write("erpc.yaml")  # Write to file
+print(config.to_yaml())    # Or get YAML string
+```
+
+**Supported config sections:**
+- Networks with per-chain policies
+- Upstream defaults and rich upstream configs
+- 20+ provider presets (Alchemy, Infura, QuickNode, Ankr, etc.)
+- Rate limiters and failsafe policies
+- Auth strategies (Secret, JWT, SIWE, Network-based)
+- Database connectors (Redis, PostgreSQL, DynamoDB, Memory)
+- Cache policies with per-method TTLs
+- Server config (CORS, timeouts) and metrics
+
+### 🏥 Health & Metrics Client
+
+Query eRPC's runtime health and Prometheus metrics — stdlib only, no `requests` needed.
+
+```python
+from erpc.client import ERPCClient
+
+client = ERPCClient("http://localhost:4000")
+
+# Structured health check
+status = client.health()
+print(f"{status.version} — uptime: {status.uptime}s")
+
+# Prometheus metrics as dict
+metrics = client.metrics()
+print(metrics.get("erpc_requests_total"))
+```
+
+### 📊 Health Monitoring
+
+Track health state transitions over time.
+
+```python
+from erpc import HealthMonitor, HealthEvent
+
+monitor = HealthMonitor(url="http://localhost:4000", interval=30.0)
+event = monitor.latest_event()  # HealthEvent.HEALTHY / DOWN / etc.
+```
+
+### 🐳 Docker Integration
+
+Run eRPC as a Docker container — no local binary needed. Uses the `docker` CLI, no Python Docker SDK required.
+
+```python
+from erpc import ERPCConfig, DockerERPCProcess
+
+config = ERPCConfig(upstreams={1: ["https://eth.llamarpc.com"]})
+
+with DockerERPCProcess(config=config, name="my-erpc") as erpc:
+    print(erpc.endpoint_url(1))
+    print(erpc.logs(tail=20))
+```
+
+### 🖥️ CLI Tool
+
+Manage eRPC from the command line:
+
+```bash
+erpc-py version                    # Show versions
+erpc-py install --version 0.0.62   # Install binary
+erpc-py health                     # Check health
+erpc-py metrics                    # Show Prometheus metrics
+erpc-py config generate \
+  --chains 1,137 \
+  --upstreams https://eth.llamarpc.com,https://polygon-rpc.com \
+  --output erpc.yaml               # Generate config
+erpc-py start --config erpc.yaml   # Start eRPC
+erpc-py stop                       # Stop eRPC
+```
+
+### 🛡️ Provider Presets
+
+20+ built-in provider configurations for popular RPC services:
+
+```python
+from erpc import AlchemyProvider, InfuraProvider, ERPCConfig
+
+config = ERPCConfig(
+    upstreams={1: ["https://eth.llamarpc.com"]},
+    providers=[
+        AlchemyProvider(api_key="..."),
+        InfuraProvider(api_key="..."),
+    ],
+)
+```
+
+<details>
+<summary>All supported providers</summary>
+
+Alchemy · Ankr · BlastAPI · BlockPi · Chainstack · Conduit · DRPC · Dwellir · Envio · Etherspot · Infura · OnFinality · Pimlico · QuickNode · Repository · RouteMesh · Superchain · Tenderly · Thirdweb
+
+</details>
+
+---
+
+## API Overview
+
+| Class | Description |
+|---|---|
+| `ERPCConfig` | Config builder — generates `erpc.yaml` from Python dataclasses |
+| `ERPCProcess` | Subprocess lifecycle manager with context manager support |
+| `DockerERPCProcess` | Docker container lifecycle manager |
+| `ERPCClient` | Health and Prometheus metrics client (stdlib HTTP) |
+| `HealthMonitor` | Health state tracking with event history |
+| `install_erpc()` | Binary installer from GitHub releases |
+| `CacheConfig` | Memory cache settings with per-method TTLs |
+| `DatabaseConfig` | Database connector config (Redis, Postgres, DynamoDB, Memory) |
+| `AuthConfig` | Auth strategies (Secret, JWT, SIWE, Network) |
+| `ServerConfig` | Server settings (CORS, timeouts, host/port) |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/tars-endurance/erpc.py.git
+cd erpc.py
+pip install -e ".[dev]"
+
+# Run tests (319 tests, 96% coverage)
+pytest
+
+# Type checking
+mypy erpc/
+
+# Linting
+ruff check .
+ruff format --check .
+```
+
+---
+
+## License
+
+[MIT](LICENSE)

erpc_py-0.1.0b1/README.md

@@ -0,0 +1,284 @@
+<div align="center">
+
+# erpc.py
+
+**Python subprocess manager for [eRPC](https://github.com/erpc/erpc) — the fault-tolerant EVM RPC proxy.**
+
+Like [py-geth](https://github.com/ethereum/py-geth) for Go-Ethereum, but for eRPC.
+
+[![PyPI](https://img.shields.io/pypi/v/erpc-py)](https://pypi.org/project/erpc-py/)
+[![CI](https://github.com/tars-endurance/erpc.py/actions/workflows/ci.yml/badge.svg)](https://github.com/tars-endurance/erpc.py/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/tars-endurance/erpc.py/branch/main/graph/badge.svg)](https://codecov.io/gh/tars-endurance/erpc.py)
+[![Python](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue)](https://pypi.org/project/erpc-py/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![mypy](https://img.shields.io/badge/type--checked-mypy%20strict-blue)](https://mypy-lang.org/)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://docs.astral.sh/ruff/)
+[![eRPC](https://img.shields.io/badge/eRPC-v0.0.62-orange)](https://github.com/erpc/erpc/releases/tag/0.0.62)
+
+</div>
+
+---
+
+> [!NOTE]
+> **This repository was built entirely by an AI agent** ([TARS](https://github.com/tars-endurance)) under the direction of a human engineer ([Kieran Prasch](https://github.com/KPrasch)). Every commit is co-authored. The architecture, priorities, and quality bar were set by a human; the implementation, tests, and documentation were produced by an AI — from first scaffold to 451 tests at 98% coverage. We believe this is how software will increasingly be built: human intent, machine execution, shared accountability.
+
+---
+
+## Compatibility
+
+| erpc.py | eRPC binary | Status |
+|---------|-------------|--------|
+| `0.1.x` | [`v0.0.62`](https://github.com/erpc/erpc/releases/tag/0.0.62) | ✅ Current |
+
+erpc.py pins a specific eRPC binary version (`erpc.ERPC_VERSION`). All config generation, tests, and CI target this version. Use `install_erpc()` to install the matching binary automatically.
+
+```python
+from erpc import ERPC_VERSION, install_erpc
+
+print(ERPC_VERSION)  # "0.0.62"
+install_erpc()       # downloads the pinned version
+```
+
+---
+
+## Overview
+
+**erpc.py** gives you full programmatic control over [eRPC](https://github.com/erpc/erpc) from Python — binary installation, YAML config generation, process lifecycle, health monitoring, and runtime metrics. Pure Python with only `pyyaml` as a runtime dependency.
+
+```python
+from erpc import ERPCProcess
+
+with ERPCProcess(upstreams={1: ["https://eth.llamarpc.com"]}) as erpc:
+    url = erpc.endpoint_url(1)  # http://127.0.0.1:4000/py-erpc/evm/1
+    print(f"Proxying Ethereum mainnet at {url}")
+```
+
+---
+
+## Installation
+
+```bash
+pip install erpc-py
+```
+
+To install the eRPC binary:
+
+```bash
+erpc-py install --version 0.0.62
+```
+
+Or programmatically:
+
+```python
+from erpc.install import install_erpc
+
+install_erpc("0.0.62")  # → /usr/local/bin/erpc
+```
+
+---
+
+## Quick Start
+
+### Minimal — just upstreams
+
+```python
+from erpc import ERPCProcess
+
+with ERPCProcess(upstreams={1: ["https://eth.llamarpc.com"]}) as erpc:
+    print(erpc.endpoint_url(1))
+    print(f"Healthy: {erpc.is_healthy}")
+```
+
+### Full config
+
+```python
+from erpc import ERPCConfig, ERPCProcess, CacheConfig
+
+config = ERPCConfig(
+    project_id="my-project",
+    upstreams={
+        1: ["https://eth.llamarpc.com", "https://rpc.ankr.com/eth"],
+        137: ["https://polygon-rpc.com"],
+    },
+    server_port=4000,
+    metrics_port=4001,
+    log_level="info",
+    cache=CacheConfig(max_items=50_000),
+)
+
+with ERPCProcess(config=config) as erpc:
+    print(erpc.endpoint_url(1))
+    print(erpc.endpoint_url(137))
+```
+
+---
+
+## Features
+
+### 🔧 Binary Management
+
+Auto-detect or install eRPC binaries from GitHub releases with optional SHA256 verification.
+
+```python
+from erpc.install import install_erpc
+
+path = install_erpc("0.0.62", checksum="abc123...")
+```
+
+### 📝 Config Builder
+
+Full-fidelity Python config that generates valid `erpc.yaml` — networks, upstreams, failsafe policies, rate limiters, auth, caching, database connectors, and more.
+
+```python
+from erpc import ERPCConfig, DatabaseConfig, RedisConnector, AuthConfig, SecretAuth
+
+config = ERPCConfig(
+    project_id="production",
+    upstreams={1: ["https://eth.llamarpc.com"]},
+    database=DatabaseConfig(
+        evm_json_rpc_cache=RedisConnector(addr="localhost:6379"),
+    ),
+    auth=AuthConfig(
+        strategies=[SecretAuth(value="my-secret-key")],
+    ),
+)
+
+config.write("erpc.yaml")  # Write to file
+print(config.to_yaml())    # Or get YAML string
+```
+
+**Supported config sections:**
+- Networks with per-chain policies
+- Upstream defaults and rich upstream configs
+- 20+ provider presets (Alchemy, Infura, QuickNode, Ankr, etc.)
+- Rate limiters and failsafe policies
+- Auth strategies (Secret, JWT, SIWE, Network-based)
+- Database connectors (Redis, PostgreSQL, DynamoDB, Memory)
+- Cache policies with per-method TTLs
+- Server config (CORS, timeouts) and metrics
+
+### 🏥 Health & Metrics Client
+
+Query eRPC's runtime health and Prometheus metrics — stdlib only, no `requests` needed.
+
+```python
+from erpc.client import ERPCClient
+
+client = ERPCClient("http://localhost:4000")
+
+# Structured health check
+status = client.health()
+print(f"{status.version} — uptime: {status.uptime}s")
+
+# Prometheus metrics as dict
+metrics = client.metrics()
+print(metrics.get("erpc_requests_total"))
+```
+
+### 📊 Health Monitoring
+
+Track health state transitions over time.
+
+```python
+from erpc import HealthMonitor, HealthEvent
+
+monitor = HealthMonitor(url="http://localhost:4000", interval=30.0)
+event = monitor.latest_event()  # HealthEvent.HEALTHY / DOWN / etc.
+```
+
+### 🐳 Docker Integration
+
+Run eRPC as a Docker container — no local binary needed. Uses the `docker` CLI, no Python Docker SDK required.
+
+```python
+from erpc import ERPCConfig, DockerERPCProcess
+
+config = ERPCConfig(upstreams={1: ["https://eth.llamarpc.com"]})
+
+with DockerERPCProcess(config=config, name="my-erpc") as erpc:
+    print(erpc.endpoint_url(1))
+    print(erpc.logs(tail=20))
+```
+
+### 🖥️ CLI Tool
+
+Manage eRPC from the command line:
+
+```bash
+erpc-py version                    # Show versions
+erpc-py install --version 0.0.62   # Install binary
+erpc-py health                     # Check health
+erpc-py metrics                    # Show Prometheus metrics
+erpc-py config generate \
+  --chains 1,137 \
+  --upstreams https://eth.llamarpc.com,https://polygon-rpc.com \
+  --output erpc.yaml               # Generate config
+erpc-py start --config erpc.yaml   # Start eRPC
+erpc-py stop                       # Stop eRPC
+```
+
+### 🛡️ Provider Presets
+
+20+ built-in provider configurations for popular RPC services:
+
+```python
+from erpc import AlchemyProvider, InfuraProvider, ERPCConfig
+
+config = ERPCConfig(
+    upstreams={1: ["https://eth.llamarpc.com"]},
+    providers=[
+        AlchemyProvider(api_key="..."),
+        InfuraProvider(api_key="..."),
+    ],
+)
+```
+
+<details>
+<summary>All supported providers</summary>
+
+Alchemy · Ankr · BlastAPI · BlockPi · Chainstack · Conduit · DRPC · Dwellir · Envio · Etherspot · Infura · OnFinality · Pimlico · QuickNode · Repository · RouteMesh · Superchain · Tenderly · Thirdweb
+
+</details>
+
+---
+
+## API Overview
+
+| Class | Description |
+|---|---|
+| `ERPCConfig` | Config builder — generates `erpc.yaml` from Python dataclasses |
+| `ERPCProcess` | Subprocess lifecycle manager with context manager support |
+| `DockerERPCProcess` | Docker container lifecycle manager |
+| `ERPCClient` | Health and Prometheus metrics client (stdlib HTTP) |
+| `HealthMonitor` | Health state tracking with event history |
+| `install_erpc()` | Binary installer from GitHub releases |
+| `CacheConfig` | Memory cache settings with per-method TTLs |
+| `DatabaseConfig` | Database connector config (Redis, Postgres, DynamoDB, Memory) |
+| `AuthConfig` | Auth strategies (Secret, JWT, SIWE, Network) |
+| `ServerConfig` | Server settings (CORS, timeouts, host/port) |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/tars-endurance/erpc.py.git
+cd erpc.py
+pip install -e ".[dev]"
+
+# Run tests (319 tests, 96% coverage)
+pytest
+
+# Type checking
+mypy erpc/
+
+# Linting
+ruff check .
+ruff format --check .
+```
+
+---
+
+## License
+
+[MIT](LICENSE)