Repository navigation
fastapi-cache-stable 0.4.0
fastapi-cache-stable 0.4.0 — Redis client compatibility expansion
Status: published 2026-11-20.
PyPI: fastapi-cache-stable==0.4.0.
What's new
The optional [redis] and [all] dependencies now accept newer
redis-py clients with Python-specific version constraints. Redis client
versions are distinct from Redis server versions.
| CPython | Optional redis-py requirement | Verified client examples |
|---|---|---|
| 3.8 | >=4.2.0rc1,<6.2 |
4.6.0, 5.2.1, 6.1.x |
| 3.9 | >=4.2.0rc1,<7.1 |
4.6.0, 5.2.1, 7.0.1 |
| 3.10–3.13 | >=4.2.0rc1,<8.2 |
4.6.0, 7.2.1, 8.1.0 |
This preserves redis-py 4.x migration compatibility and adds tested
options on supported interpreters. The range caps are intentional;
compatibility with untested future versions is not claimed. Python
>=3.8,<3.14 and the public fastapi_cache import remain unchanged.
No RedisBackend cache-key format, binary serialization or runtime behavior
change is intended by this release. A change of redis-py itself may affect
other application code sharing the same client.
Integration evidence
- #62 research:
28 real-server Redis/Python/client profiles, conditional metadata resolution
tests and separate installed-wheel FastAPI probes. - #63 implementation:
12 release-shaped wheel lanes, 4 source-distribution lanes, Redis server
6.2/7.0/7.4/8.0 checks, Python 3.8–3.13, targeted redis-py audit, pip
installation and metadata tests. The 50 GitHub checks were successful
on the implementation HEAD prior to merging. - A maintainer reported 48 passing selected tests per profile using
real-estate-arg@4c4b6030with the final #63 wheel, actual standalone
Redis 7.4.7 / RedisBackend, redis-py 4.6.0 → 7.2.1 → 8.1.0 → 4.6.0 rollback
andpip checkpassing each time. This is local maintainer evidence,
not an archived independent Actions run. It used a temporary test fixture. - The version-bumped 0.4.0 wheel and sdist were built from the release
branch and independently installed before publication. The final hashes
and publication runs are recorded in the
release status.
Scope and limitations
- In scope: standalone Redis clients and operations proven in the
matrix, RESP2/RESP3, Redis ACL authentication, binary cache payloads with
decode_responses=False, cache MISS/HIT and targeted namespace clearing. - Not certified: Redis Cluster, Sentinel/failover, TLS and managed Redis
providers. Redis Cluster namespace clear continues to raise
NotImplementedError. Usingdecode_responses=Truewith arbitrary
@cachebinary payloads is not supported. - Security boundary: Python 3.8–3.10 are EOL, functional-compatibility
targets only. The project's best-effort security-supported environment is
server-side CPython 3.11–3.13; this release does not fix unrelated
vulnerabilities in consumer applications, FastAPI, Starlette, AnyIO or
other runtime dependencies. Check the current security audit and
SUPPORT.md before production deployment. - The independent
Vary/hidden-context limitations in
#53 are not
solved by redis-py compatibility changes.
Installation
In a clean virtual environment:
python -m pip uninstall -y fastapi-cache2
python -m pip install "fastapi-cache-stable[redis]==0.4.0"
python -m pip checkNever co-install the upstream and this fork: both provide fastapi_cache.
Pin the selected redis-py version if sharing a Redis client with other
libraries; test with real application traffic and preserve a rollback pin.
See MIGRATION.md for authentication and cache isolation
caveats. InMemory-only consumers can omit the Redis extra.
Publication verification
The version-stamped wheel and sdist were built from the final release branch,
checked with twine check, installed in clean environments and exercised with
redis-py 4.6.0 and 8.1.0. The final wheel was also run against the disposable
real-estate-arg consumer with 4.6.0, 7.2.1, 8.1.0 and rollback. Exact hashes,
workflow runs, provenance and residual security notes are recorded in the
0.4.0 release status. #47 closes only after the
published artifacts are verified; #53 remains open for Vary/hidden context.
Published artifacts
- PyPI 0.4.0
- Wheel:
fastapi_cache_stable-0.4.0-py3-none-any.whl— SHA-256dfb887cc79e10b2d9dd91d1c516a35f1266dcf60e37cfcf52fd553d06158bbeb - sdist:
fastapi_cache_stable-0.4.0.tar.gz— SHA-25653e6635c78f10ae0c206891216c10f0689eea7cc3e87181a70f9540a71f696b2 - TestPyPI workflow
- Production PyPI workflow
- Tag
v0.4.0targets8d2dfe2ec5c74dbfac394b468a6bf13445f920d1.
TestPyPI, PyPI and the workflow artifact are byte-identical. PyPI provenance binds the artifacts to stable, commit 8d2dfe2ec5c74dbfac394b468a6bf13445f920d1 and production run 44670980627. The final wheel passed the real-estate-arg consumer suite with redis-py 4.6.0, 7.2.1, 8.1.0 and rollback; the pre-production Dependabot delta found no new material findings.