xtr-cache 4.0.4__tar.gz → 5.0.0__tar.gz

{xtr_cache-4.0.4 → xtr_cache-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xtr-cache
-Version: 4.0.4
+Version: 5.0.0
 Summary: Cache pools in memory, in files, in Redis, chained or tag-aware, with stampede protection.
 Keywords: cache,redis,stampede,tags,asyncio
 Author: Xterr
@@ -16,20 +16,13 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
 Requires-Dist: typing-extensions>=4.4
-Requires-Dist: xtr-cache-contracts>=4.0,<5
-Requires-Dist: xtr-clock>=4.0,<5
-Requires-Dist: xtr-lock>=4.0,<5
-Requires-Dist: xtr-logging-contracts>=4.0,<5
-Requires-Dist: xtr-console>=4.0,<5 ; extra == 'console'
-Requires-Dist: xtr-dependency-injection>=4.0,<5 ; extra == 'di'
-Requires-Dist: xtr-service-contracts>=4.0,<5 ; extra == 'di'
-Requires-Dist: xtr-logging>=4.0,<5 ; extra == 'logging'
+Requires-Dist: xtr-cache-contracts>=5.0,<6
+Requires-Dist: xtr-clock>=5.0,<6
+Requires-Dist: xtr-lock>=5.0,<6
+Requires-Dist: xtr-logging-contracts>=5.0,<6
 Requires-Dist: redis>=5.0 ; extra == 'redis'
 Requires-Dist: pynacl>=1.5 ; extra == 'sodium'
 Requires-Python: >=3.11
-Provides-Extra: console
-Provides-Extra: di
-Provides-Extra: logging
 Provides-Extra: redis
 Provides-Extra: sodium
 Description-Content-Type: text/markdown
@@ -65,7 +58,8 @@ backend a constructor argument:
 - 🗄️ **Six adapters** — memory, files, Redis, nowhere, a chain of them, or tag-aware on top of any.
 - 🏷️ **Tags** — invalidate every value carrying a tag at once, whatever its key.
 - 🔐 **Encryption** — values encrypted and authenticated with libsodium, for a shared backend.
-- 🧩 **A bundle** — named pools configured in Python, and `cache:pool:*` console commands.
+- 🧩 **An optional bundle** — named pools configured in Python once xtr-dependency-injection is
+  installed beside it, and `cache:pool:*` console commands with xtr-console.
 
 ```python
 from xtr_cache import FilesystemAdapter, ItemInterface
@@ -85,14 +79,16 @@ profile = await cache.get(f"profile.{user_id}", load_profile)
 
 ```sh
 uv add xtr-cache
-uv add "xtr-cache[redis]"     # RedisAdapter, on redis-py's asyncio client
-uv add "xtr-cache[sodium]"    # SodiumMarshaller, on PyNaCl
-uv add "xtr-cache[di]"        # the bundle for xtr-dependency-injection
-uv add "xtr-cache[console]"   # the cache:pool:* commands for xtr-console
+uv add "xtr-cache[redis]"                  # RedisAdapter, on redis-py's asyncio client
+uv add "xtr-cache[sodium]"                 # SodiumMarshaller, on PyNaCl
+uv add xtr-cache xtr-dependency-injection  # + the container, for the CacheBundle
+uv add xtr-console                         # beside it: the cache:pool:* commands
 ```
 
-Requires Python 3.11+. Depends on `xtr-cache-contracts`, `xtr-clock`, `xtr-lock` and
-`xtr-logging-contracts`.
+Requires Python 3.11+. Depends on `typing-extensions`, `xtr-cache-contracts`, `xtr-clock`,
+`xtr-lock` and `xtr-logging-contracts` — not on the container: the bundle is used when
+[xtr-dependency-injection](../xtr-dependency-injection) is installed beside the package, never as
+an extra, and the pools work without it.
 
 Every contract symbol is re-exported, not redefined: `xtr_cache.CacheInterface is
 xtr_cache_contracts.CacheInterface`, so a library typed against the contract receives these pools
@@ -298,8 +294,9 @@ until what it encrypted has expired.
 Everything adding this package to an application on
 [xtr-dependency-injection](../xtr-dependency-injection) takes — and, read backwards, what removing it undoes.
 
-- **Install** — `uv add "xtr-cache[di]"`; add `redis`, `sodium`, `console` or `logging` for what
-  you use.
+- **Install** — `uv add xtr-cache xtr-dependency-injection`: the bundle needs the container
+  installed beside it, never as an extra. Add `redis` or `sodium` for what you use; install
+  xtr-console beside it for the `cache:pool:*` commands, and xtr-logging for a `cache` channel.
 - **Recipe** — `uv run xtr-recipes recipes:sync` does the *Activate* and *Ignore* steps below: it
   lists `CacheBundle` and ignores `/var/`. There is no config file or environment to write.
 - **Activate** — `CacheBundle: {"all": True}` in `BUNDLES` in `<app>/bundles.py`, imported
@@ -317,7 +314,9 @@ Everything adding this package to an application on
 
 ## Kernel / bundle
 
-With [xtr-dependency-injection](../xtr-dependency-injection), list the bundle and name the pools:
+With [xtr-dependency-injection](../xtr-dependency-injection) installed beside the package — it is
+not a dependency, and nothing outside `xtr_cache.bundle` needs it — list the bundle and name the
+pools:
 
 ```python
 # app/bundles.py

{xtr_cache-4.0.4 → xtr_cache-5.0.0}/README.md

@@ -29,7 +29,8 @@ backend a constructor argument:
 - 🗄️ **Six adapters** — memory, files, Redis, nowhere, a chain of them, or tag-aware on top of any.
 - 🏷️ **Tags** — invalidate every value carrying a tag at once, whatever its key.
 - 🔐 **Encryption** — values encrypted and authenticated with libsodium, for a shared backend.
-- 🧩 **A bundle** — named pools configured in Python, and `cache:pool:*` console commands.
+- 🧩 **An optional bundle** — named pools configured in Python once xtr-dependency-injection is
+  installed beside it, and `cache:pool:*` console commands with xtr-console.
 
 ```python
 from xtr_cache import FilesystemAdapter, ItemInterface
@@ -49,14 +50,16 @@ profile = await cache.get(f"profile.{user_id}", load_profile)
 
 ```sh
 uv add xtr-cache
-uv add "xtr-cache[redis]"     # RedisAdapter, on redis-py's asyncio client
-uv add "xtr-cache[sodium]"    # SodiumMarshaller, on PyNaCl
-uv add "xtr-cache[di]"        # the bundle for xtr-dependency-injection
-uv add "xtr-cache[console]"   # the cache:pool:* commands for xtr-console
+uv add "xtr-cache[redis]"                  # RedisAdapter, on redis-py's asyncio client
+uv add "xtr-cache[sodium]"                 # SodiumMarshaller, on PyNaCl
+uv add xtr-cache xtr-dependency-injection  # + the container, for the CacheBundle
+uv add xtr-console                         # beside it: the cache:pool:* commands
 ```
 
-Requires Python 3.11+. Depends on `xtr-cache-contracts`, `xtr-clock`, `xtr-lock` and
-`xtr-logging-contracts`.
+Requires Python 3.11+. Depends on `typing-extensions`, `xtr-cache-contracts`, `xtr-clock`,
+`xtr-lock` and `xtr-logging-contracts` — not on the container: the bundle is used when
+[xtr-dependency-injection](../xtr-dependency-injection) is installed beside the package, never as
+an extra, and the pools work without it.
 
 Every contract symbol is re-exported, not redefined: `xtr_cache.CacheInterface is
 xtr_cache_contracts.CacheInterface`, so a library typed against the contract receives these pools
@@ -262,8 +265,9 @@ until what it encrypted has expired.
 Everything adding this package to an application on
 [xtr-dependency-injection](../xtr-dependency-injection) takes — and, read backwards, what removing it undoes.
 
-- **Install** — `uv add "xtr-cache[di]"`; add `redis`, `sodium`, `console` or `logging` for what
-  you use.
+- **Install** — `uv add xtr-cache xtr-dependency-injection`: the bundle needs the container
+  installed beside it, never as an extra. Add `redis` or `sodium` for what you use; install
+  xtr-console beside it for the `cache:pool:*` commands, and xtr-logging for a `cache` channel.
 - **Recipe** — `uv run xtr-recipes recipes:sync` does the *Activate* and *Ignore* steps below: it
   lists `CacheBundle` and ignores `/var/`. There is no config file or environment to write.
 - **Activate** — `CacheBundle: {"all": True}` in `BUNDLES` in `<app>/bundles.py`, imported
@@ -281,7 +285,9 @@ Everything adding this package to an application on
 
 ## Kernel / bundle
 
-With [xtr-dependency-injection](../xtr-dependency-injection), list the bundle and name the pools:
+With [xtr-dependency-injection](../xtr-dependency-injection) installed beside the package — it is
+not a dependency, and nothing outside `xtr_cache.bundle` needs it — list the bundle and name the
+pools:
 
 ```python
 # app/bundles.py

{xtr_cache-4.0.4 → xtr_cache-5.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "xtr-cache"
-version = "4.0.4"
+version = "5.0.0"
 description = "Cache pools in memory, in files, in Redis, chained or tag-aware, with stampede protection."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -25,10 +25,10 @@ classifiers = [
 ]
 dependencies = [
     "typing-extensions>=4.4",
-    "xtr-cache-contracts>=4.0,<5",
-    "xtr-clock>=4.0,<5",
-    "xtr-lock>=4.0,<5",
-    "xtr-logging-contracts>=4.0,<5",
+    "xtr-cache-contracts>=5.0,<6",
+    "xtr-clock>=5.0,<6",
+    "xtr-lock>=5.0,<6",
+    "xtr-logging-contracts>=5.0,<6",
 ]
 
 [[project.authors]]
@@ -38,12 +38,6 @@ email = "me@xterr.dev"
 [project.optional-dependencies]
 redis = ["redis>=5.0"]
 sodium = ["pynacl>=1.5"]
-di = [
-    "xtr-dependency-injection>=4.0,<5",
-    "xtr-service-contracts>=4.0,<5",
-]
-console = ["xtr-console>=4.0,<5"]
-logging = ["xtr-logging>=4.0,<5"]
 
 [project.entry-points."xtr_dependency_injection.bundles"]
 cache = "xtr_cache.bundle:CacheBundle"
@@ -61,10 +55,10 @@ dev = [
     "ty>=0.0.83",
     "pynacl>=1.5",
     "redis>=5.0",
-    "xtr-console>=4.0,<5",
-    "xtr-dependency-injection>=4.0,<5",
-    "xtr-logging>=4.0,<5",
-    "xtr-service-contracts>=4.0,<5",
+    "xtr-console>=5.0,<6",
+    "xtr-dependency-injection>=5.0,<6",
+    "xtr-logging>=5.0,<6",
+    "xtr-service-contracts>=5.0,<6",
 ]
 
 [build-system]

{xtr_cache-4.0.4 → xtr_cache-5.0.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "xtr-cache"
-version = "4.0.4"
+version = "5.0.0"
 description = "Cache pools in memory, in files, in Redis, chained or tag-aware, with stampede protection."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -22,10 +22,10 @@ classifiers = [
 ]
 dependencies = [
     "typing-extensions>=4.4",
-    "xtr-cache-contracts>=4.0,<5",
-    "xtr-clock>=4.0,<5",
-    "xtr-lock>=4.0,<5",
-    "xtr-logging-contracts>=4.0,<5",
+    "xtr-cache-contracts>=5.0,<6",
+    "xtr-clock>=5.0,<6",
+    "xtr-lock>=5.0,<6",
+    "xtr-logging-contracts>=5.0,<6",
 ]
 
 [project.optional-dependencies]
@@ -35,16 +35,6 @@ redis = [
 sodium = [
     "pynacl>=1.5",
 ]
-di = [
-    "xtr-dependency-injection>=4.0,<5",
-    "xtr-service-contracts>=4.0,<5",
-]
-console = [
-    "xtr-console>=4.0,<5",
-]
-logging = [
-    "xtr-logging>=4.0,<5",
-]
 
 # Advertises the bundle so debug:bundles can name it when installed but not listed.
 # Advertising activates nothing: an application lists the bundles it wants.
@@ -65,10 +55,10 @@ dev = [
     "ty>=0.0.83",
     "pynacl>=1.5",
     "redis>=5.0",
-    "xtr-console>=4.0,<5",
-    "xtr-dependency-injection>=4.0,<5",
-    "xtr-logging>=4.0,<5",
-    "xtr-service-contracts>=4.0,<5",
+    "xtr-console>=5.0,<6",
+    "xtr-dependency-injection>=5.0,<6",
+    "xtr-logging>=5.0,<6",
+    "xtr-service-contracts>=5.0,<6",
 ]
 
 [build-system]

{xtr_cache-4.0.4 → xtr_cache-5.0.0}/src/xtr_cache/.agents/skills/xtr-cache/SKILL.md

@@ -26,8 +26,10 @@ the pool logs why.
   pool: `get_item`, `get_items`, `save`, `save_deferred`, `commit`, `delete_item`, `clear`.
 - Keys and tags are non-empty strings with none of `{}()/\@:` (`RESERVED_CHARACTERS`); letters,
   digits, `_` and `.` under 64 characters work everywhere. One key holds one type.
-- In an application: activate `CacheBundle`, name pools in `CacheConfig`, inject
-  `CacheInterface` for the `app` pool and `Annotated[CacheInterface, Target("name")]` for another.
+- In an application, with xtr-dependency-injection installed beside the package (it is not a
+  dependency): activate `CacheBundle`, name pools in `CacheConfig`, inject `CacheInterface` for
+  the `app` pool and `Annotated[CacheInterface, Target("name")]` for another. Without the
+  container every pool works the same; only `xtr_cache.bundle` needs it.
 
 ## Cache a value
 
@@ -174,7 +176,9 @@ rotation.
 `CacheBundle` and ignores `/var/`. That is the steps below a recipe can do; the others it prints
 for you to make.
 
-1. **Install** — `uv add "xtr-cache[di]"`; add `redis`, `sodium` or `console` for what you use.
+1. **Install** — `uv add xtr-cache xtr-dependency-injection`: the bundle needs the container
+   installed beside it, never as an extra. Add `redis` or `sodium` for what you use; install
+   xtr-console beside it for the `cache:pool:*` commands, and xtr-logging for a `cache` channel.
 2. **Activate** — `CacheBundle: {"all": True}` in `BUNDLES` in `<app>/bundles.py`, imported from
    `xtr_cache.bundle`.
 3. **Brings along** — the logging and console bundles, when those packages are installed. With

{xtr_cache-4.0.4 → xtr_cache-5.0.0}/src/xtr_cache/command/__init__.py

@@ -11,7 +11,7 @@ from xtr_cache.command import use_pools
 use_pools(CachePoolClearer({"app": FilesystemAdapter("app")}))
 ```
 
-Needs the ``console`` extra: ``xtr-cache[console]``.
+Needs xtr-console installed beside this package.
 """
 
 from __future__ import annotations