Skip to content

feat(memcached): add a memcached extra and deprecate memcache - #203

Merged
allen0099 merged 1 commit into
masterfrom
feat/memcached-extra
Sep 26, 2026
Merged

allen0099 merged 1 commit into
masterfrom
feat/memcached-extra

Conversation

@allen0099

Copy link
Copy Markdown
Owner

Closes #201

Summary

  • Add memcached = ["pymemcache"] as the canonical extra for MemcachedBackend.
  • Keep memcache as a deprecated alias with the same dependency; removal is tracked in Remove the deprecated memcache extra #202 (0.4.0).
  • Switch tox.ini and release.yml to --extra memcached.
  • Update README, docs/BACKENDS.md, docs/DEVELOPMENT.md and the zh-TW docs; drop the "note: memcache, not memcached" remarks and explain the deprecation.
  • The ImportError message now points at pip install 'fastapi-cachex[memcached]'.
  • CHANGELOG: Added entry for memcached, Deprecated entry for memcache.

Why not just rename

pip and uv only warn about an unknown extra and install the package without it, so removing memcache outright would silently drop pymemcache for existing users. Keeping both names makes this release non-breaking.

Verification

  • Installed .[memcached] and .[memcache] into fresh venvs; both import pymemcache.
  • uv lock --check, ruff, mypy --strict pass.
  • Full suite against live Redis and Memcached (CACHEX_REQUIRE_LIVE_SERVERS=1): 857 passed.

The extra that installs pymemcache was named memcache, which does not
match MemcachedBackend or the docs' own wording. Add memcached as the
canonical name and keep memcache as a deprecated alias until 0.4.0
(#202), so existing installs keep pulling in pymemcache.

Switch tox, the release workflow and the docs to the new name, and point
the ImportError message at fastapi-cachex[memcached].

Closes #201
@allen0099 allen0099 added this to the 0.3.8 milestone Sep 26, 2026
@allen0099 allen0099 added enhancement New feature or request backends Cache backends and their atomic primitives labels Sep 26, 2026
@allen0099
allen0099 merged commit 4566b58 into master Sep 26, 2026
11 checks passed
@allen0099
allen0099 deleted the feat/memcached-extra branch September 26, 2026 12:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backends Cache backends and their atomic primitives enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a memcached extra and deprecate the memcache name

1 participant