# yokedcache

> MIT-licensed async Python cache: same API for in-process memory, Redis, Memcached, disk, and SQLite; tag/pattern invalidation; optional Starlette HTTP middleware and metrics.

## Summary

- Package: yokedcache (PyPI). **Python 3.10+** (CI: 3.10–3.14). Plain `pip install yokedcache` uses **embedded memory** when `redis` is not installed (1.0.1+). Add `yokedcache[redis]` for Redis, `yokedcache[web]` for HTTP middleware, `yokedcache[full]` for the full optional stack.
- Docs: https://sirstig.github.io/yokedcache/
- API (HTML): https://sirstig.github.io/yokedcache/api/
- Changelog: https://sirstig.github.io/yokedcache/changelog.html
- Repository: https://github.com/sirstig/yokedcache

## Install

```
pip install yokedcache
```

See [Backends](https://sirstig.github.io/yokedcache/backends.html) and PyPI optional dependencies for presets (`redis`, `web`, `backends`, `observability`, `full`) and granular extras.

## Human-maintained guides

- Getting started: https://sirstig.github.io/yokedcache/getting-started.html
- Backends: https://sirstig.github.io/yokedcache/backends.html
- Configuration: https://sirstig.github.io/yokedcache/configuration.html
- Usage patterns: https://sirstig.github.io/yokedcache/usage-patterns.html
- FastAPI: https://sirstig.github.io/yokedcache/tutorials/fastapi.html

## API reference

Use the generated pdoc site under `/api/` for module and class-level docstrings (authoritative for Python API surface).

## Maintainer

Joshua Kac (Project Yoked LLC). Organization: https://www.projectyoked.com
