cachekit 0.4.0__tar.gz → 0.6.1__tar.gz

{cachekit-0.4.0 → cachekit-0.6.1}/Cargo.lock

@@ -231,7 +231,7 @@ dependencies = [
 
 [[package]]
 name = "cachekit-rs"
-version = "0.4.0"
+version = "0.6.1"
 dependencies = [
  "cachekit-core",
  "criterion",

{cachekit-0.4.0 → cachekit-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachekit
-Version: 0.4.0
+Version: 0.6.1
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -34,7 +34,9 @@ Requires-Dist: httpx[http2]>=0.28.1
 Requires-Dist: numpy>=2.0.2 ; extra == 'data'
 Requires-Dist: pandas>=1.3.0 ; extra == 'data'
 Requires-Dist: pyarrow>=21.0.0 ; extra == 'data'
+Requires-Dist: pymemcache>=4.0.0 ; extra == 'memcached'
 Provides-Extra: data
+Provides-Extra: memcached
 License-File: LICENSE
 Summary: Production-ready Redis caching for Python with intelligent reliability features and Rust-powered performance
 Keywords: redis,cache,caching,decorator,rust,performance,reliability,production,encryption,security,circuit-breaker,prometheus,messagepack,distributed-locking
@@ -54,9 +56,9 @@ Project-URL: Repository, https://github.com/cachekit-io/cachekit-py.git
 
 # cachekit
 
-> **Redis caching, batteries included**
+> **Python caching, batteries included**
 
-Production-ready Redis caching for Python with intelligent reliability features and Rust-powered performance.
+Production-ready caching for Python with intelligent reliability features and Rust-powered performance.
 
 [![PyPI Version][pypi-badge]][pypi-url]
 [![Python Versions][python-badge]][pypi-url]
@@ -117,7 +119,7 @@ Or with [uv][uv-url] (recommended):
 uv add cachekit
 ```
 
-### Setup
+### Setup (Redis — recommended default)
 
 ```bash
 # Run Redis locally or use your existing infrastructure
@@ -135,6 +137,53 @@ def expensive_api_call(user_id: int):
 > [!TIP]
 > No Redis? No worries! Use `@cache(backend=None)` for L1-only in-memory caching, like `lru_cache`, but with all the bells and whistles.
 
+### More Backends
+
+<details>
+<summary><strong>CachekitIO — Managed SaaS (Alpha)</strong></summary>
+
+```python notest
+import os
+from cachekit import cache
+
+# Set your CachekitIO API key
+# export CACHEKIT_API_KEY="your-api-key"  # pragma: allowlist secret
+
+@cache.io()  # Uses CachekitIO SaaS backend — no Redis to manage
+def expensive_api_call(user_id: int):
+    return fetch_user_data(user_id)
+```
+
+*cachekit.io is in closed alpha — [request access](https://cachekit.io) to get started.*
+
+</details>
+
+<details>
+<summary><strong>Memcached — Optional</strong></summary>
+
+```python notest
+from cachekit import cache
+from cachekit.backends.memcached import MemcachedBackend
+
+# pip install cachekit[memcached]
+
+backend = MemcachedBackend()  # Defaults to 127.0.0.1:11211
+
+@cache(backend=backend)
+def expensive_api_call(user_id: int):
+    return fetch_user_data(user_id)
+```
+
+*Requires: `pip install cachekit[memcached]` or `uv add cachekit[memcached]`*
+
+</details>
+
+---
+
+> **CachekitIO Cloud (Alpha)**
+> Managed caching with zero infrastructure. L1+L2 caching, circuit breaker, and automatic failover — no Redis to manage.
+> *cachekit.io is in closed alpha — [request access](https://cachekit.io) to get started.*
+
 ---
 
 ## Intent-Based Optimization
@@ -158,14 +207,15 @@ def get_user_profile(user_id: int):
     return db.fetch_user(user_id)
 ```
 
-| Feature | `@cache.minimal` | `@cache.production` | `@cache.secure` |
-|:--------|:----------------:|:-------------------:|:---------------:|
-| Circuit Breaker | - | ✅ | ✅ |
-| Adaptive Timeouts | - | ✅ | ✅ |
-| Monitoring | - | ✅ Full | ✅ Full |
-| Integrity Checking | - | ✅ Enabled | ✅ Enforced |
-| Encryption | - | - | ✅ Required |
-| **Use Case** | High throughput | Production reliability | Compliance/security |
+| Feature | `@cache.minimal` | `@cache.production` | `@cache.secure` | `@cache.io()` | `@cache.local()` |
+|:--------|:----------------:|:-------------------:|:---------------:|:-------------:|:----------------:|
+| Circuit Breaker | - | ✅ | ✅ | ✅ | - |
+| Adaptive Timeouts | - | ✅ | ✅ | ✅ | - |
+| Monitoring | - | ✅ Full | ✅ Full | ✅ Full | ✅ Basic |
+| Integrity Checking | - | ✅ Enabled | ✅ Enforced | ✅ Enabled | - |
+| Encryption | - | - | ✅ Required | - | - |
+| Backend | Redis | Redis | Redis | CachekitIO SaaS | In-process |
+| **Use Case** | High throughput | Production reliability | Compliance/security | Managed cloud | Opaque objects |
 
 <details>
 <summary><strong>Additional Presets</strong></summary>
@@ -198,8 +248,9 @@ def test_cached_function():
 │  │   Breaker   │  │  Timeouts   │  │      Locking        │  │
 │  └─────────────┘  └─────────────┘  └─────────────────────┘  │
 ├─────────────────────────────────────────────────────────────┤
-│  L1 Cache (In-Memory)  │  L2 Cache (Redis/Backend)         │
-│       ~50ns            │         ~2-7ms                     │
+│  L1 Cache (In-Memory)  │  L2 Cache (Pluggable Backend)     │
+│       ~50ns            │  Redis / CachekitIO / File /      │
+│                        │  Memcached    ~2-50ms             │
 ├─────────────────────────────────────────────────────────────┤
 │                    Rust Core (PyO3)                         │
 │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
@@ -221,7 +272,7 @@ def test_cached_function():
 - Circuit breaker with graceful degradation
 - Connection pooling with thread affinity (+28% throughput)
 - Distributed locking prevents cache stampedes
-- Pluggable backend abstraction (Redis, File, HTTP, DynamoDB, custom)
+- Pluggable backend abstraction (Redis, CachekitIO, File, Memcached, custom)
 
 > [!NOTE]
 > All reliability features are **enabled by default** with `@cache.production`. Use `@cache.minimal` to disable them for maximum throughput.
@@ -230,7 +281,7 @@ def test_cached_function():
 
 | Serializer | Speed | Use Case |
 |:-----------|:-----:|:---------|
-| **DefaultSerializer** | ★★★★☆ | General Python types, NumPy, Pandas |
+| **StandardSerializer** | ★★★★☆ | General Python types, NumPy, Pandas |
 | **OrjsonSerializer** | ★★★★★ | JSON APIs (2-5x faster than stdlib) |
 | **ArrowSerializer** | ★★★★★ | Large DataFrames (6-23x faster for 10K+ rows) |
 | **EncryptionWrapper** | ★★★★☆ | Wraps any serializer with AES-256-GCM |
@@ -352,7 +403,7 @@ print(expensive_func.cache_info())
 
 | Feature | Description |
 |:--------|:------------|
-| [Serializer Guide][serializer-guide-url] | ArrowSerializer vs DefaultSerializer benchmarks |
+| [Serializer Guide][serializer-guide-url] | ArrowSerializer vs StandardSerializer benchmarks |
 | [Circuit Breaker][circuit-breaker-url] | Prevent cascading failures |
 | [Distributed Locking][distributed-locking-url] | Cache stampede prevention |
 | [Prometheus Metrics][prometheus-url] | Built-in observability |
@@ -370,6 +421,16 @@ print(expensive_func.cache_info())
 CACHEKIT_REDIS_URL="redis://localhost:6379"  # Primary (preferred)
 REDIS_URL="redis://localhost:6379"           # Fallback
 
+# CachekitIO SaaS Backend (closed alpha — request access at cachekit.io)
+CACHEKIT_API_KEY="your-api-key"             # Required for @cache.io()  # pragma: allowlist secret
+CACHEKIT_API_URL="https://api.cachekit.io"  # Default SaaS endpoint
+
+# Memcached Backend (optional: pip install cachekit[memcached])
+CACHEKIT_MEMCACHED_SERVERS='["mc1:11211", "mc2:11211"]'  # Default: 127.0.0.1:11211
+CACHEKIT_MEMCACHED_CONNECT_TIMEOUT=2.0                   # Default: 2.0 seconds
+CACHEKIT_MEMCACHED_TIMEOUT=1.0                            # Default: 1.0 seconds
+CACHEKIT_MEMCACHED_KEY_PREFIX="myapp:"                    # Default: "" (none)
+
 # Optional Configuration
 CACHEKIT_DEFAULT_TTL=3600
 CACHEKIT_MAX_CHUNK_SIZE_MB=100
@@ -425,7 +486,7 @@ MIT License - see [LICENSE][license-file-url] for details.
 [comparison-url]: docs/comparison.md
 [getting-started-url]: docs/getting-started.md
 [api-reference-url]: docs/api-reference.md
-[serializer-guide-url]: docs/guides/serializer-guide.md
+[serializer-guide-url]: docs/serializers/index.md
 [circuit-breaker-url]: docs/features/circuit-breaker.md
 [distributed-locking-url]: docs/features/distributed-locking.md
 [prometheus-url]: docs/features/prometheus-metrics.md

{cachekit-0.4.0 → cachekit-0.6.1}/README.md

@@ -2,9 +2,9 @@
 
 # cachekit
 
-> **Redis caching, batteries included**
+> **Python caching, batteries included**
 
-Production-ready Redis caching for Python with intelligent reliability features and Rust-powered performance.
+Production-ready caching for Python with intelligent reliability features and Rust-powered performance.
 
 [![PyPI Version][pypi-badge]][pypi-url]
 [![Python Versions][python-badge]][pypi-url]
@@ -65,7 +65,7 @@ Or with [uv][uv-url] (recommended):
 uv add cachekit
 ```
 
-### Setup
+### Setup (Redis — recommended default)
 
 ```bash
 # Run Redis locally or use your existing infrastructure
@@ -83,6 +83,53 @@ def expensive_api_call(user_id: int):
 > [!TIP]
 > No Redis? No worries! Use `@cache(backend=None)` for L1-only in-memory caching, like `lru_cache`, but with all the bells and whistles.
 
+### More Backends
+
+<details>
+<summary><strong>CachekitIO — Managed SaaS (Alpha)</strong></summary>
+
+```python notest
+import os
+from cachekit import cache
+
+# Set your CachekitIO API key
+# export CACHEKIT_API_KEY="your-api-key"  # pragma: allowlist secret
+
+@cache.io()  # Uses CachekitIO SaaS backend — no Redis to manage
+def expensive_api_call(user_id: int):
+    return fetch_user_data(user_id)
+```
+
+*cachekit.io is in closed alpha — [request access](https://cachekit.io) to get started.*
+
+</details>
+
+<details>
+<summary><strong>Memcached — Optional</strong></summary>
+
+```python notest
+from cachekit import cache
+from cachekit.backends.memcached import MemcachedBackend
+
+# pip install cachekit[memcached]
+
+backend = MemcachedBackend()  # Defaults to 127.0.0.1:11211
+
+@cache(backend=backend)
+def expensive_api_call(user_id: int):
+    return fetch_user_data(user_id)
+```
+
+*Requires: `pip install cachekit[memcached]` or `uv add cachekit[memcached]`*
+
+</details>
+
+---
+
+> **CachekitIO Cloud (Alpha)**
+> Managed caching with zero infrastructure. L1+L2 caching, circuit breaker, and automatic failover — no Redis to manage.
+> *cachekit.io is in closed alpha — [request access](https://cachekit.io) to get started.*
+
 ---
 
 ## Intent-Based Optimization
@@ -106,14 +153,15 @@ def get_user_profile(user_id: int):
     return db.fetch_user(user_id)
 ```
 
-| Feature | `@cache.minimal` | `@cache.production` | `@cache.secure` |
-|:--------|:----------------:|:-------------------:|:---------------:|
-| Circuit Breaker | - | ✅ | ✅ |
-| Adaptive Timeouts | - | ✅ | ✅ |
-| Monitoring | - | ✅ Full | ✅ Full |
-| Integrity Checking | - | ✅ Enabled | ✅ Enforced |
-| Encryption | - | - | ✅ Required |
-| **Use Case** | High throughput | Production reliability | Compliance/security |
+| Feature | `@cache.minimal` | `@cache.production` | `@cache.secure` | `@cache.io()` | `@cache.local()` |
+|:--------|:----------------:|:-------------------:|:---------------:|:-------------:|:----------------:|
+| Circuit Breaker | - | ✅ | ✅ | ✅ | - |
+| Adaptive Timeouts | - | ✅ | ✅ | ✅ | - |
+| Monitoring | - | ✅ Full | ✅ Full | ✅ Full | ✅ Basic |
+| Integrity Checking | - | ✅ Enabled | ✅ Enforced | ✅ Enabled | - |
+| Encryption | - | - | ✅ Required | - | - |
+| Backend | Redis | Redis | Redis | CachekitIO SaaS | In-process |
+| **Use Case** | High throughput | Production reliability | Compliance/security | Managed cloud | Opaque objects |
 
 <details>
 <summary><strong>Additional Presets</strong></summary>
@@ -146,8 +194,9 @@ def test_cached_function():
 │  │   Breaker   │  │  Timeouts   │  │      Locking        │  │
 │  └─────────────┘  └─────────────┘  └─────────────────────┘  │
 ├─────────────────────────────────────────────────────────────┤
-│  L1 Cache (In-Memory)  │  L2 Cache (Redis/Backend)         │
-│       ~50ns            │         ~2-7ms                     │
+│  L1 Cache (In-Memory)  │  L2 Cache (Pluggable Backend)     │
+│       ~50ns            │  Redis / CachekitIO / File /      │
+│                        │  Memcached    ~2-50ms             │
 ├─────────────────────────────────────────────────────────────┤
 │                    Rust Core (PyO3)                         │
 │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
@@ -169,7 +218,7 @@ def test_cached_function():
 - Circuit breaker with graceful degradation
 - Connection pooling with thread affinity (+28% throughput)
 - Distributed locking prevents cache stampedes
-- Pluggable backend abstraction (Redis, File, HTTP, DynamoDB, custom)
+- Pluggable backend abstraction (Redis, CachekitIO, File, Memcached, custom)
 
 > [!NOTE]
 > All reliability features are **enabled by default** with `@cache.production`. Use `@cache.minimal` to disable them for maximum throughput.
@@ -178,7 +227,7 @@ def test_cached_function():
 
 | Serializer | Speed | Use Case |
 |:-----------|:-----:|:---------|
-| **DefaultSerializer** | ★★★★☆ | General Python types, NumPy, Pandas |
+| **StandardSerializer** | ★★★★☆ | General Python types, NumPy, Pandas |
 | **OrjsonSerializer** | ★★★★★ | JSON APIs (2-5x faster than stdlib) |
 | **ArrowSerializer** | ★★★★★ | Large DataFrames (6-23x faster for 10K+ rows) |
 | **EncryptionWrapper** | ★★★★☆ | Wraps any serializer with AES-256-GCM |
@@ -300,7 +349,7 @@ print(expensive_func.cache_info())
 
 | Feature | Description |
 |:--------|:------------|
-| [Serializer Guide][serializer-guide-url] | ArrowSerializer vs DefaultSerializer benchmarks |
+| [Serializer Guide][serializer-guide-url] | ArrowSerializer vs StandardSerializer benchmarks |
 | [Circuit Breaker][circuit-breaker-url] | Prevent cascading failures |
 | [Distributed Locking][distributed-locking-url] | Cache stampede prevention |
 | [Prometheus Metrics][prometheus-url] | Built-in observability |
@@ -318,6 +367,16 @@ print(expensive_func.cache_info())
 CACHEKIT_REDIS_URL="redis://localhost:6379"  # Primary (preferred)
 REDIS_URL="redis://localhost:6379"           # Fallback
 
+# CachekitIO SaaS Backend (closed alpha — request access at cachekit.io)
+CACHEKIT_API_KEY="your-api-key"             # Required for @cache.io()  # pragma: allowlist secret
+CACHEKIT_API_URL="https://api.cachekit.io"  # Default SaaS endpoint
+
+# Memcached Backend (optional: pip install cachekit[memcached])
+CACHEKIT_MEMCACHED_SERVERS='["mc1:11211", "mc2:11211"]'  # Default: 127.0.0.1:11211
+CACHEKIT_MEMCACHED_CONNECT_TIMEOUT=2.0                   # Default: 2.0 seconds
+CACHEKIT_MEMCACHED_TIMEOUT=1.0                            # Default: 1.0 seconds
+CACHEKIT_MEMCACHED_KEY_PREFIX="myapp:"                    # Default: "" (none)
+
 # Optional Configuration
 CACHEKIT_DEFAULT_TTL=3600
 CACHEKIT_MAX_CHUNK_SIZE_MB=100
@@ -373,7 +432,7 @@ MIT License - see [LICENSE][license-file-url] for details.
 [comparison-url]: docs/comparison.md
 [getting-started-url]: docs/getting-started.md
 [api-reference-url]: docs/api-reference.md
-[serializer-guide-url]: docs/guides/serializer-guide.md
+[serializer-guide-url]: docs/serializers/index.md
 [circuit-breaker-url]: docs/features/circuit-breaker.md
 [distributed-locking-url]: docs/features/distributed-locking.md
 [prometheus-url]: docs/features/prometheus-metrics.md

{cachekit-0.4.0 → cachekit-0.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "cachekit"
-version = "0.4.0"
+version = "0.6.1"
 description = "Production-ready Redis caching for Python with intelligent reliability features and Rust-powered performance"
 readme = "README.md"
 license = {text = "MIT"}
@@ -79,6 +79,9 @@ data = [
     "pandas>=1.3.0",
     "pyarrow>=21.0.0",
 ]
+memcached = [
+    "pymemcache>=4.0.0",
+]
 
 [project.urls]
 Homepage = "https://github.com/cachekit-io/cachekit-py"
@@ -126,7 +129,7 @@ ignore = [
 "src/cachekit/monitoring/pool_monitor.py" = ["S110"]  # Monitoring errors should be silent
 "src/cachekit/reliability/async_metrics.py" = ["S101"]  # Internal invariant checks
 "src/cachekit/serializers/__init__.py" = ["S101"]  # Module-level validation
-"src/cachekit/serializers/default_serializer.py" = ["S110"]  # Fallback deserialization patterns
+"src/cachekit/serializers/standard_serializer.py" = ["S110"]  # Fallback deserialization patterns
 
 [tool.ruff.lint.isort]
 known-first-party = ["cachekit"]
@@ -205,6 +208,7 @@ dev = [
     "pytest-cov>=7.0.0",
     "pytest-markdown-docs>=0.6.0",
     "pytest-redis>=3.0.0",
+    "pymemcache>=4.0.0",
     # Code quality
     "basedpyright>=1.32.1",
     "ruff>=0.6.0",
@@ -214,6 +218,7 @@ dev = [
     "httpx>=0.28.1",
     "hypothesis>=6.0.0",
     "pip-audit>=2.7.0",
+    "requests>=2.33.0; python_version >= '3.10'",
     "psutil>=5.9.0",
     "python-dotenv>=1.0.0",
     "pyyaml>=6.0.3",
@@ -221,6 +226,8 @@ dev = [
     "numpy>=2.0.2",
     "pandas>=1.3.0",
     "pyarrow>=21.0.0",
+    "pytest-xdist>=3.8.0",
+    "time-machine>=2.19.0",
 ]
 # Linux CI only - Atheris requires libFuzzer (not available on macOS without building LLVM)
 fuzz = [

{cachekit-0.4.0 → cachekit-0.6.1}/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cachekit-rs"
-version = "0.4.0"
+version = "0.6.1"
 edition = "2021"
 authors = ["cachekit Contributors"]
 description = "High-performance storage engine for caching with compression and encryption"

{cachekit-0.4.0 → cachekit-0.6.1}/rust/README.md

@@ -2,9 +2,9 @@
 
 # cachekit
 
-> **Redis caching, batteries included**
+> **Python caching, batteries included**
 
-Production-ready Redis caching for Python with intelligent reliability features and Rust-powered performance.
+Production-ready caching for Python with intelligent reliability features and Rust-powered performance.
 
 [![PyPI Version][pypi-badge]][pypi-url]
 [![Python Versions][python-badge]][pypi-url]
@@ -65,7 +65,7 @@ Or with [uv][uv-url] (recommended):
 uv add cachekit
 ```
 
-### Setup
+### Setup (Redis — recommended default)
 
 ```bash
 # Run Redis locally or use your existing infrastructure
@@ -83,6 +83,53 @@ def expensive_api_call(user_id: int):
 > [!TIP]
 > No Redis? No worries! Use `@cache(backend=None)` for L1-only in-memory caching, like `lru_cache`, but with all the bells and whistles.
 
+### More Backends
+
+<details>
+<summary><strong>CachekitIO — Managed SaaS (Alpha)</strong></summary>
+
+```python notest
+import os
+from cachekit import cache
+
+# Set your CachekitIO API key
+# export CACHEKIT_API_KEY="your-api-key"  # pragma: allowlist secret
+
+@cache.io()  # Uses CachekitIO SaaS backend — no Redis to manage
+def expensive_api_call(user_id: int):
+    return fetch_user_data(user_id)
+```
+
+*cachekit.io is in closed alpha — [request access](https://cachekit.io) to get started.*
+
+</details>
+
+<details>
+<summary><strong>Memcached — Optional</strong></summary>
+
+```python notest
+from cachekit import cache
+from cachekit.backends.memcached import MemcachedBackend
+
+# pip install cachekit[memcached]
+
+backend = MemcachedBackend()  # Defaults to 127.0.0.1:11211
+
+@cache(backend=backend)
+def expensive_api_call(user_id: int):
+    return fetch_user_data(user_id)
+```
+
+*Requires: `pip install cachekit[memcached]` or `uv add cachekit[memcached]`*
+
+</details>
+
+---
+
+> **CachekitIO Cloud (Alpha)**
+> Managed caching with zero infrastructure. L1+L2 caching, circuit breaker, and automatic failover — no Redis to manage.
+> *cachekit.io is in closed alpha — [request access](https://cachekit.io) to get started.*
+
 ---
 
 ## Intent-Based Optimization
@@ -106,14 +153,15 @@ def get_user_profile(user_id: int):
     return db.fetch_user(user_id)
 ```
 
-| Feature | `@cache.minimal` | `@cache.production` | `@cache.secure` |
-|:--------|:----------------:|:-------------------:|:---------------:|
-| Circuit Breaker | - | ✅ | ✅ |
-| Adaptive Timeouts | - | ✅ | ✅ |
-| Monitoring | - | ✅ Full | ✅ Full |
-| Integrity Checking | - | ✅ Enabled | ✅ Enforced |
-| Encryption | - | - | ✅ Required |
-| **Use Case** | High throughput | Production reliability | Compliance/security |
+| Feature | `@cache.minimal` | `@cache.production` | `@cache.secure` | `@cache.io()` | `@cache.local()` |
+|:--------|:----------------:|:-------------------:|:---------------:|:-------------:|:----------------:|
+| Circuit Breaker | - | ✅ | ✅ | ✅ | - |
+| Adaptive Timeouts | - | ✅ | ✅ | ✅ | - |
+| Monitoring | - | ✅ Full | ✅ Full | ✅ Full | ✅ Basic |
+| Integrity Checking | - | ✅ Enabled | ✅ Enforced | ✅ Enabled | - |
+| Encryption | - | - | ✅ Required | - | - |
+| Backend | Redis | Redis | Redis | CachekitIO SaaS | In-process |
+| **Use Case** | High throughput | Production reliability | Compliance/security | Managed cloud | Opaque objects |
 
 <details>
 <summary><strong>Additional Presets</strong></summary>
@@ -146,8 +194,9 @@ def test_cached_function():
 │  │   Breaker   │  │  Timeouts   │  │      Locking        │  │
 │  └─────────────┘  └─────────────┘  └─────────────────────┘  │
 ├─────────────────────────────────────────────────────────────┤
-│  L1 Cache (In-Memory)  │  L2 Cache (Redis/Backend)         │
-│       ~50ns            │         ~2-7ms                     │
+│  L1 Cache (In-Memory)  │  L2 Cache (Pluggable Backend)     │
+│       ~50ns            │  Redis / CachekitIO / File /      │
+│                        │  Memcached    ~2-50ms             │
 ├─────────────────────────────────────────────────────────────┤
 │                    Rust Core (PyO3)                         │
 │  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
@@ -169,7 +218,7 @@ def test_cached_function():
 - Circuit breaker with graceful degradation
 - Connection pooling with thread affinity (+28% throughput)
 - Distributed locking prevents cache stampedes
-- Pluggable backend abstraction (Redis, File, HTTP, DynamoDB, custom)
+- Pluggable backend abstraction (Redis, CachekitIO, File, Memcached, custom)
 
 > [!NOTE]
 > All reliability features are **enabled by default** with `@cache.production`. Use `@cache.minimal` to disable them for maximum throughput.
@@ -178,7 +227,7 @@ def test_cached_function():
 
 | Serializer | Speed | Use Case |
 |:-----------|:-----:|:---------|
-| **DefaultSerializer** | ★★★★☆ | General Python types, NumPy, Pandas |
+| **StandardSerializer** | ★★★★☆ | General Python types, NumPy, Pandas |
 | **OrjsonSerializer** | ★★★★★ | JSON APIs (2-5x faster than stdlib) |
 | **ArrowSerializer** | ★★★★★ | Large DataFrames (6-23x faster for 10K+ rows) |
 | **EncryptionWrapper** | ★★★★☆ | Wraps any serializer with AES-256-GCM |
@@ -300,7 +349,7 @@ print(expensive_func.cache_info())
 
 | Feature | Description |
 |:--------|:------------|
-| [Serializer Guide][serializer-guide-url] | ArrowSerializer vs DefaultSerializer benchmarks |
+| [Serializer Guide][serializer-guide-url] | ArrowSerializer vs StandardSerializer benchmarks |
 | [Circuit Breaker][circuit-breaker-url] | Prevent cascading failures |
 | [Distributed Locking][distributed-locking-url] | Cache stampede prevention |
 | [Prometheus Metrics][prometheus-url] | Built-in observability |
@@ -318,6 +367,16 @@ print(expensive_func.cache_info())
 CACHEKIT_REDIS_URL="redis://localhost:6379"  # Primary (preferred)
 REDIS_URL="redis://localhost:6379"           # Fallback
 
+# CachekitIO SaaS Backend (closed alpha — request access at cachekit.io)
+CACHEKIT_API_KEY="your-api-key"             # Required for @cache.io()  # pragma: allowlist secret
+CACHEKIT_API_URL="https://api.cachekit.io"  # Default SaaS endpoint
+
+# Memcached Backend (optional: pip install cachekit[memcached])
+CACHEKIT_MEMCACHED_SERVERS='["mc1:11211", "mc2:11211"]'  # Default: 127.0.0.1:11211
+CACHEKIT_MEMCACHED_CONNECT_TIMEOUT=2.0                   # Default: 2.0 seconds
+CACHEKIT_MEMCACHED_TIMEOUT=1.0                            # Default: 1.0 seconds
+CACHEKIT_MEMCACHED_KEY_PREFIX="myapp:"                    # Default: "" (none)
+
 # Optional Configuration
 CACHEKIT_DEFAULT_TTL=3600
 CACHEKIT_MAX_CHUNK_SIZE_MB=100
@@ -373,7 +432,7 @@ MIT License - see [LICENSE][license-file-url] for details.
 [comparison-url]: docs/comparison.md
 [getting-started-url]: docs/getting-started.md
 [api-reference-url]: docs/api-reference.md
-[serializer-guide-url]: docs/guides/serializer-guide.md
+[serializer-guide-url]: docs/serializers/index.md
 [circuit-breaker-url]: docs/features/circuit-breaker.md
 [distributed-locking-url]: docs/features/distributed-locking.md
 [prometheus-url]: docs/features/prometheus-metrics.md

{cachekit-0.4.0 → cachekit-0.6.1}/src/cachekit/__init__.py

@@ -1,29 +1,31 @@
 r"""cachekit - Caching decorator for Python applications.
 
-A robust, production-ready Python library that provides intelligent Redis caching
+A robust, production-ready Python library that provides intelligent caching
 capabilities with advanced features like chunked data handling, multi-serialization
 support, distributed locking, and automatic corruption detection.
 
+Supports pluggable backends: Redis (default), CachekitIO SaaS, File, and custom.
+
 Key Features:
 - **Intelligent @cache decorator** with auto-detection and intent-based optimization
 - **Circuit breaker protection** against cascading failures
-- **Adaptive timeout adjustment** based on historical Redis latency patterns
-- **Backpressure control** to prevent Redis overload
+- **Adaptive timeout adjustment** based on historical backend latency patterns
+- **Backpressure control** to prevent backend overload
 - **Connection pooling** for optimized performance
 - **Health check methods** for comprehensive monitoring
 - **Structured logging** with correlation IDs and distributed tracing
 - **Statistics collection** for Prometheus metrics integration
 
 Architecture Overview:
-cachekit v0.1.0 provides a modular decorator architecture with intelligent
-auto-detection and intent-based optimization. The v0.1 architecture includes:
+cachekit provides a modular decorator architecture with intelligent
+auto-detection and intent-based optimization:
 
 - FeatureOrchestrator: Manages enterprise-grade reliability and monitoring features
 - Flexible configuration interface with intelligent auto-detection
 - Enhanced error handling with comprehensive safety checks
-- Streamlined connection management with optimized components
+- Pluggable backend abstraction (Redis, CachekitIO, File, custom)
 
-Born from production debugging of Redis caching failures:
+Born from production debugging of caching failures:
 - UTF-8 corruption prevention with intelligent binary data handling
 - Binary data magic byte detection and validation
 - Chunked storage for large objects with atomic operations
@@ -51,6 +53,10 @@ Example Usage:
     def get_user_data(user_id: int) -> UserProfile:
         return db.fetch_user(user_id)
 
+    @cache.io()      # Managed SaaS backend (cachekit.io, closed alpha)
+    def get_remote_data(key: str):
+        return fetch_remote(key)
+
     # Manual configuration when needed (1% of use cases)
     @cache(ttl=3600, namespace="custom", circuit_breaker=True)
     def custom_function():
@@ -62,7 +68,7 @@ Example Usage:
     ```
 """
 
-__version__ = "0.4.0"
+__version__ = "0.6.1"
 
 from typing import Any, Callable, TypeVar
 

{cachekit-0.4.0 → cachekit-0.6.1}/src/cachekit/backends/__init__.py

@@ -1,8 +1,8 @@
 """Backend storage abstraction for cachekit.
 
 This module provides protocol-based abstraction for L2 backend storage with
-dependency injection pattern. Backends can be Redis, HTTP, DynamoDB, or any
-key-value store.
+dependency injection pattern. Backends can be Redis, HTTP, DynamoDB, Memcached,
+or any key-value store.
 
 Public API:
     - BaseBackend: Core protocol (5 methods: get, set, delete, exists, health_check)
@@ -14,6 +14,7 @@ Public API:
     - BackendErrorType: Error classification enum
     - CapabilityNotAvailableError: Exception for missing optional capabilities
     - RedisBackend: Redis implementation (default)
+    - MemcachedBackend: Memcached implementation (requires pymemcache)
 
 Usage:
     >>> from cachekit.backends import BaseBackend, RedisBackend, BackendError
@@ -56,6 +57,7 @@ __all__ = [
     "BackendErrorType",
     "CapabilityNotAvailableError",
     "RedisBackend",
+    "MemcachedBackend",
 ]
 
 
@@ -95,3 +97,12 @@ class BackendProvider(Protocol):
             >>> backend.set("key", b"value", ttl=60)  # doctest: +SKIP
         """
         ...
+
+
+def __getattr__(name: str):
+    """Lazy import for optional backends (pymemcache may not be installed)."""
+    if name == "MemcachedBackend":
+        from cachekit.backends.memcached import MemcachedBackend
+
+        return MemcachedBackend
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")