cachebox 6.2.4__tar.gz → 6.2.5__tar.gz

{cachebox-6.2.4 → cachebox-6.2.5}/Cargo.lock

@@ -10,9 +10,9 @@ checksum = "c880a97d28a3681c0267bd29cff89621202715b065127cd445fa0f0fe0aa2880"
 
 [[package]]
 name = "android_system_properties"
-version = "0.1.5"
+version = "0.1.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
+checksum = "ae221649c9976a6f6c56ae1facf410f3ddb33cc661c4b7b61020a912d4237fbc"
 dependencies = [
  "libc",
 ]
@@ -37,7 +37,7 @@ checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
 
 [[package]]
 name = "cachebox"
-version = "6.2.4"
+version = "6.2.5"
 dependencies = [
  "allocator-api2",
  "cfg-if",
@@ -50,9 +50,9 @@ dependencies = [
 
 [[package]]
 name = "cc"
-version = "1.4.0"
+version = "1.4.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5add81bb678e6cb321aff7fa0dc7689ad82b112dbc032cea19f91d6b8e3582b9"
+checksum = "5d262e149917187838d5b42777c8253bcb64500067342904e7d429499a6f277e"
 dependencies = [
  "find-msvc-tools",
  "shlex",
@@ -91,9 +91,9 @@ checksum = "da7c62ceae207dd37ea5b845da6a0696c799f85e97da1ab5b7910be3c1c80223"
 
 [[package]]
 name = "find-msvc-tools"
-version = "0.1.9"
+version = "0.1.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+checksum = "26b73573e6edcd2af0cdf47bd6cb58f0b3839491263c314eaad1ccf24430e1de"
 
 [[package]]
 name = "futures-core"
@@ -151,9 +151,9 @@ dependencies = [
 
 [[package]]
 name = "js-sys"
-version = "0.3.103"
+version = "0.3.104"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
+checksum = "0e0c1080212aad755ea003d18543e8768dd432c48819efd73a7bf1e39b7a5a3a"
 dependencies = [
  "cfg-if",
  "futures-util",
@@ -227,9 +227,9 @@ checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
 
 [[package]]
 name = "portable-atomic"
-version = "1.14.0"
+version = "1.15.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d20d5497ef88037a52ff98267d066e7f11fcc5e99bbfbd58a42336193aacec3"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
 
 [[package]]
 name = "proc-macro2"
@@ -242,9 +242,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3"
-version = "0.29.1"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc153f5fd745cc038b5eed86622125969f8a39834a57bc96beaaf2512b1da729"
+checksum = "4688ddedf473e32662b9b067670129a8afb8c18e351482c70d62ba4a88171e8b"
 dependencies = [
  "chrono",
  "libc",
@@ -257,18 +257,18 @@ dependencies = [
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.29.1"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bb77d9aa6d647507b55c69ee714d266d84c526c78ff0bc6dd8757f58591e64d1"
+checksum = "f41027e41b4bd03f6e60f9f417fe24a6341a6bb744edd62b6f709f2a52ea30e9"
 dependencies = [
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.29.1"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3160087aa5733bce7d9a729f8c55f85a2a53b74742a09613178eeebff0722253"
+checksum = "e591a95526fead067432c3b3a33fc74770b87b1e04e73671090d9c2055a2b327"
 dependencies = [
  "libc",
  "pyo3-build-config",
@@ -276,9 +276,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros"
-version = "0.29.1"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91f9d455db760a9a0b0ddeaac25f1390b8a36ba73dfbda9f127cac6fc340d4d5"
+checksum = "73225868fc1cd84eef2c3c230ddb91273bf1de46aeb8a4248da76d32a0924a1c"
 dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
@@ -288,9 +288,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros-backend"
-version = "0.29.1"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e343bcec300ff262f5806a33a4e51b6d097a8a46435f512fcb83e95592581625"
+checksum = "571575aa3749fa6216757dd47d2a3e7ef360f329a40f0666a9fbd14889024952"
 dependencies = [
  "heck",
  "proc-macro2",
@@ -371,9 +371,9 @@ checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.126"
+version = "0.2.127"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
+checksum = "1b70935747edd64d89de3efa29d73789b806c15798f8e7dca4d8ac356b50ce70"
 dependencies = [
  "cfg-if",
  "once_cell",
@@ -384,9 +384,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.126"
+version = "0.2.127"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
+checksum = "77775f8f3f7217702089053b94958f8f54061a3f663417df76e19cbdcca29bc1"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -394,9 +394,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.126"
+version = "0.2.127"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
+checksum = "e11d33f857dc2fb11b8bc75aee111aa9cbeb12cd9f25efd3d4c2a3dd4e235284"
 dependencies = [
  "bumpalo",
  "proc-macro2",
@@ -407,9 +407,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.126"
+version = "0.2.127"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
+checksum = "7ef64dbcc55df09c7e5a46182d181c2cfa3e925f3da937ea764728b4bbb9dcbf"
 dependencies = [
  "unicode-ident",
 ]

{cachebox-6.2.4 → cachebox-6.2.5}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cachebox"
-version = "6.2.4"
+version = "6.2.5"
 edition = "2021"
 description = "The fastest memoizing and caching Python library written in Rust"
 readme = "README.md"
@@ -27,10 +27,10 @@ cfg-if = "1.0.4"
 chrono = "0.4.45"
 fastrand = "2.5.0"
 parking_lot = { version = "0.12.5", default-features = false }
-pyo3 = { version = "0.29.1", default-features = false, features = ["macros", "chrono"] }
+pyo3 = { version = "0.29.2", default-features = false, features = ["macros", "chrono"] }
 
 [build-dependencies]
-pyo3-build-config = { version = "0.29.1", default-features = false, features = ["resolve-config"] }
+pyo3-build-config = { version = "0.29.2", default-features = false, features = ["resolve-config"] }
 
 [features]
 default = ["inline-more", "extension-module"]

{cachebox-6.2.4 → cachebox-6.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachebox
-Version: 6.2.4
+Version: 6.2.5
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
@@ -47,9 +47,9 @@ _The fastest caching Python library written in Rust_
 [![Monthly Downloads](https://shieldcn.dev/pypi/dm/cachebox.svg?variant=branded&font=geist-mono&size=xs)](https://pypi.org/project/cachebox)
 [![Python Version](https://shieldcn.dev/pypi/python/cachebox.svg?variant=branded&font=geist-mono&size=xs)](https://pypi.org/project/cachebox)
 
-[![CI](https://shieldcn.dev/github/ci/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&animate=pulse)](https://github.com/awolverp/cachebox/actions?query=branch%3Amain)
-[![Last Commit](https://shieldcn.dev/github/last-commit/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs)](https://github.com/awolverp/cachebox/commits/main)
-[![License](https://shieldcn.dev/github/awolverp/cachebox/license.svg?variant=outline&font=geist-mono&size=xs)](https://github.com/awolverp/cachebox/blob/main/LICENSE)
+<a href="https://github.com/awolverp/cachebox/actions?query=branch%3Amain"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/ci/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&animate=pulse&mode=dark"><img alt="CI" src="https://shieldcn.dev/github/ci/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&animate=pulse&mode=light"></picture></a>
+<a href="https://github.com/awolverp/cachebox/commits/main"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/last-commit/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&mode=dark"><img alt="Last Commit" src="https://shieldcn.dev/github/last-commit/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&mode=light"></picture></a>
+<a href="https://github.com/awolverp/cachebox/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/awolverp/cachebox/license.svg?variant=outline&font=geist-mono&size=xs&mode=dark"><img alt="License" src="https://shieldcn.dev/github/awolverp/cachebox/license.svg?variant=outline&font=geist-mono&size=xs&mode=light"></picture></a>
 
 </div>
 
@@ -184,7 +184,9 @@ Read the documentation for full information and learn more: [**Documentation**](
 
 ## Contributors
 
-[![Contributers](https://contrib.rocks/image?repo=awolverp/cachebox)](https://github.com/awolverp/cachebox/graphs/contributors)
+<p align="center">
+  <a href="https://github.com/awolverp/cachebox/graphs/contributors"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/contributors/awolverp/cachebox.svg?title=false&amp;preset=transparent&amp;size=80&amp;names=true&amp;titleAlign=center&amp;mode=dark" /><img alt="contributors" src="https://shieldcn.dev/contributors/awolverp/cachebox.svg?title=false&amp;preset=transparent&amp;size=80&amp;names=true&amp;titleAlign=center&amp;mode=light" /></picture></a>
+</p>
 
 ## License
 

{cachebox-6.2.4 → cachebox-6.2.5}/README.md

@@ -11,9 +11,9 @@ _The fastest caching Python library written in Rust_
 [![Monthly Downloads](https://shieldcn.dev/pypi/dm/cachebox.svg?variant=branded&font=geist-mono&size=xs)](https://pypi.org/project/cachebox)
 [![Python Version](https://shieldcn.dev/pypi/python/cachebox.svg?variant=branded&font=geist-mono&size=xs)](https://pypi.org/project/cachebox)
 
-[![CI](https://shieldcn.dev/github/ci/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&animate=pulse)](https://github.com/awolverp/cachebox/actions?query=branch%3Amain)
-[![Last Commit](https://shieldcn.dev/github/last-commit/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs)](https://github.com/awolverp/cachebox/commits/main)
-[![License](https://shieldcn.dev/github/awolverp/cachebox/license.svg?variant=outline&font=geist-mono&size=xs)](https://github.com/awolverp/cachebox/blob/main/LICENSE)
+<a href="https://github.com/awolverp/cachebox/actions?query=branch%3Amain"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/ci/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&animate=pulse&mode=dark"><img alt="CI" src="https://shieldcn.dev/github/ci/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&animate=pulse&mode=light"></picture></a>
+<a href="https://github.com/awolverp/cachebox/commits/main"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/last-commit/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&mode=dark"><img alt="Last Commit" src="https://shieldcn.dev/github/last-commit/awolverp/cachebox.svg?variant=outline&font=geist-mono&size=xs&mode=light"></picture></a>
+<a href="https://github.com/awolverp/cachebox/blob/main/LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/awolverp/cachebox/license.svg?variant=outline&font=geist-mono&size=xs&mode=dark"><img alt="License" src="https://shieldcn.dev/github/awolverp/cachebox/license.svg?variant=outline&font=geist-mono&size=xs&mode=light"></picture></a>
 
 </div>
 
@@ -148,7 +148,9 @@ Read the documentation for full information and learn more: [**Documentation**](
 
 ## Contributors
 
-[![Contributers](https://contrib.rocks/image?repo=awolverp/cachebox)](https://github.com/awolverp/cachebox/graphs/contributors)
+<p align="center">
+  <a href="https://github.com/awolverp/cachebox/graphs/contributors"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/contributors/awolverp/cachebox.svg?title=false&amp;preset=transparent&amp;size=80&amp;names=true&amp;titleAlign=center&amp;mode=dark" /><img alt="contributors" src="https://shieldcn.dev/contributors/awolverp/cachebox.svg?title=false&amp;preset=transparent&amp;size=80&amp;names=true&amp;titleAlign=center&amp;mode=light" /></picture></a>
+</p>
 
 ## License
 

{cachebox-6.2.4 → cachebox-6.2.5}/cachebox/_core.pyi

@@ -9,6 +9,7 @@ __version__: typing.Final[str]
 KT = typing.TypeVar("KT", bound=typing.Hashable)
 VT = typing.TypeVar("VT")
 DT = typing.TypeVar("DT")
+T_co = typing.TypeVar("T_co", covariant=True)
 
 _IterableType: typing.TypeAlias = (
     typing.Dict[KT, VT]
@@ -17,6 +18,42 @@ _IterableType: typing.TypeAlias = (
     | typing.Iterable[typing.Tuple[KT, VT]]
 )
 
+class CacheIterator(typing.Iterator[T_co]):
+    """
+    What ``keys()``, ``values()`` and ``items()`` return.
+
+    This is a one-shot iterator, not a ``dict`` view: it walks the cache once
+    and is empty after that. It knows how many items it still has to yield, so
+    ``len()`` and ``bool()`` work on it, but it does not support ``in`` or set
+    operations the way ``dict.keys()`` does.
+
+    Warning:
+        Do not modify the cache while one of these is alive. Every method
+        raises ``RuntimeError`` if the cache changed.
+    """
+
+    def __next__(self) -> T_co: ...
+    def __len__(self) -> int:
+        """
+        Returns how many items are left to yield.
+
+        For ``TTLCache`` and ``VTTLCache`` this skips expired entries, which
+        takes O(n).
+
+        Returns:
+            The number of items left.
+        """
+        ...
+
+    def __bool__(self) -> bool:
+        """
+        Returns whether any item is left to yield.
+
+        Returns:
+            ``True`` if at least one item is left.
+        """
+        ...
+
 class BaseCacheImpl(typing.Generic[KT, VT]):
     """
     Base implementation for cache classes.
@@ -221,10 +258,10 @@ class BaseCacheImpl(typing.Generic[KT, VT]):
 
     def __eq__(self, other: typing.Any) -> bool: ...
     def __ne__(self, other: typing.Any) -> bool: ...
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]: ...
-    def values(self) -> typing.Iterable[VT]: ...
-    def keys(self) -> typing.Iterable[KT]: ...
-    def __iter__(self) -> typing.Iterator[KT]: ...
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]: ...
+    def values(self) -> CacheIterator[VT]: ...
+    def keys(self) -> CacheIterator[KT]: ...
+    def __iter__(self) -> CacheIterator[KT]: ...
     def copy(self) -> typing.Self: ...
     def __copy__(self) -> typing.Self: ...
     def __getstate__(self) -> object: ...
@@ -410,7 +447,7 @@ class Cache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an iterable of the cache's ``(key, value)`` pairs.
 
@@ -422,7 +459,7 @@ class Cache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an iterable of the cache's keys.
 
@@ -434,7 +471,7 @@ class Cache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an iterable of the cache's values.
 
@@ -593,7 +630,7 @@ class FIFOCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an ordered iterable of the cache's ``(key, value)`` pairs.
 
@@ -605,7 +642,7 @@ class FIFOCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an ordered iterable of the cache's keys.
 
@@ -617,7 +654,7 @@ class FIFOCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an ordered iterable of the cache's values.
 
@@ -808,7 +845,7 @@ class RRCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an iterable of the cache's ``(key, value)`` pairs.
 
@@ -820,7 +857,7 @@ class RRCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an iterable of the cache's keys.
 
@@ -832,7 +869,7 @@ class RRCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an iterable of the cache's values.
 
@@ -1016,7 +1053,7 @@ class LRUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an ordered iterable of the cache's ``(key, value)`` pairs.
 
@@ -1028,7 +1065,7 @@ class LRUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an ordered iterable of the cache's keys.
 
@@ -1040,7 +1077,7 @@ class LRUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an ordered iterable of the cache's values.
 
@@ -1265,7 +1302,7 @@ class LFUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an ordered iterable of the cache's ``(key, value)`` pairs.
 
@@ -1277,7 +1314,7 @@ class LFUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an ordered iterable of the cache's keys.
 
@@ -1289,7 +1326,7 @@ class LFUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an ordered iterable of the cache's values.
 
@@ -1301,7 +1338,7 @@ class LFUCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items_with_frequency(self) -> typing.Iterable[typing.Tuple[KT, VT, int]]:
+    def items_with_frequency(self) -> CacheIterator[typing.Tuple[KT, VT, int]]:
         """
         Returns an ordered iterable of the cache's ``(key, value)`` pairs with their
         frequency counter.
@@ -1473,7 +1510,7 @@ class TTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an ordered iterable of the cache's ``(key, value)`` pairs.
 
@@ -1485,7 +1522,7 @@ class TTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an ordered iterable of the cache's keys.
 
@@ -1497,7 +1534,7 @@ class TTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an ordered iterable of the cache's values.
 
@@ -1599,7 +1636,7 @@ class TTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items_with_expire(self) -> typing.Iterable[typing.Tuple[KT, VT, float]]:
+    def items_with_expire(self) -> CacheIterator[typing.Tuple[KT, VT, float]]:
         """
         Returns an ordered iterable of items with their remaining TTL.
 
@@ -1741,7 +1778,7 @@ class VTTLCache(BaseCacheImpl[KT, VT]):
             KeyError: If the cache is empty.
         """
 
-    def items(self) -> typing.Iterable[typing.Tuple[KT, VT]]:
+    def items(self) -> CacheIterator[typing.Tuple[KT, VT]]:
         """
         Returns an ordered iterable of the cache's ``(key, value)`` pairs.
 
@@ -1753,7 +1790,7 @@ class VTTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def keys(self) -> typing.Iterable[KT]:
+    def keys(self) -> CacheIterator[KT]:
         """
         Returns an ordered iterable of the cache's keys.
 
@@ -1765,7 +1802,7 @@ class VTTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def values(self) -> typing.Iterable[VT]:
+    def values(self) -> CacheIterator[VT]:
         """
         Returns an ordered iterable of the cache's values.
 
@@ -1838,7 +1875,7 @@ class VTTLCache(BaseCacheImpl[KT, VT]):
         """
         ...
 
-    def items_with_expire(self) -> typing.Iterable[typing.Tuple[KT, VT, float | None]]:
+    def items_with_expire(self) -> CacheIterator[typing.Tuple[KT, VT, float | None]]:
         """
         Returns an ordered iterable of items with their remaining TTL.
 

{cachebox-6.2.4 → cachebox-6.2.5}/src/internal/lazyheap.rs

@@ -340,6 +340,24 @@ impl<T> Iterator for RawIter<T> {
             }
         }
     }
+
+    #[inline]
+    fn size_hint(&self) -> (usize, Option<usize>) {
+        let left = self.first.len() + self.second.len();
+        (left, Some(left))
+    }
+}
+
+impl<T> ExactSizeIterator for RawIter<T> {}
+
+impl<T> Clone for RawIter<T> {
+    #[inline]
+    fn clone(&self) -> Self {
+        Self {
+            first: self.first.clone(),
+            second: self.second.clone(),
+        }
+    }
 }
 
 unsafe impl<T: Send + Send> Send for LazyHeap<T> {}

{cachebox-6.2.4 → cachebox-6.2.5}/src/internal/linked_list.rs

@@ -571,6 +571,17 @@ impl<T> Cursor<T> {
         unsafe { list.push_front_node(links) };
     }
 
+    /// Returns `true` if the node this cursor points to is the last node of `list`.
+    ///
+    /// # Safety
+    ///
+    /// Same contract as [`move_to_front`](Self::move_to_front).
+    #[inline]
+    pub unsafe fn is_back(&self, list: &LinkedList<T>) -> bool {
+        // SAFETY: the sentinel is always valid; caller guarantees the node is linked.
+        unsafe { (*list.sentinel.as_ptr()).prev == self.links().as_ptr() }
+    }
+
     /// Moves the node this cursor points to the back of `list`.
     ///
     /// # Safety
@@ -640,6 +651,8 @@ impl<T> Iterator for RawIter<T> {
     }
 }
 
+impl<T> ExactSizeIterator for RawIter<T> {}
+
 unsafe impl<T: Send + Send> Send for LinkedList<T> {}
 unsafe impl<T: Sync + Sync> Sync for LinkedList<T> {}
 unsafe impl<T: Send + Send> Send for RawIter<T> {}

{cachebox-6.2.4 → cachebox-6.2.5}/src/internal/utils.rs

@@ -476,6 +476,26 @@ impl<T> Iterator for RawSliceIter<T> {
             Some(value)
         }
     }
+
+    #[inline]
+    fn size_hint(&self) -> (usize, Option<usize>) {
+        let left = self.len - self.index;
+        (left, Some(left))
+    }
+}
+
+impl<T> ExactSizeIterator for RawSliceIter<T> {}
+
+// Cloning gives a second cursor over the same elements; it never touches them.
+impl<T> Clone for RawSliceIter<T> {
+    #[inline]
+    fn clone(&self) -> Self {
+        Self {
+            pointer: self.pointer,
+            index: self.index,
+            len: self.len,
+        }
+    }
 }
 
 unsafe impl<T: Sync> Send for RawSliceIter<T> {}
@@ -514,4 +534,22 @@ impl<T> Iterator for RawVecDequeIter<T> {
             }
         }
     }
+
+    #[inline]
+    fn size_hint(&self) -> (usize, Option<usize>) {
+        let left = self.first.len() + self.second.len();
+        (left, Some(left))
+    }
+}
+
+impl<T> ExactSizeIterator for RawVecDequeIter<T> {}
+
+impl<T> Clone for RawVecDequeIter<T> {
+    #[inline]
+    fn clone(&self) -> Self {
+        Self {
+            first: self.first.clone(),
+            second: self.second.clone(),
+        }
+    }
 }

{cachebox-6.2.4 → cachebox-6.2.5}/src/macro_rules.rs

@@ -25,6 +25,33 @@ macro_rules! implement_pyclass {
     };
 }
 
+/// Implements the generation-version guard shared by every cache view type.
+///
+/// # Example
+///
+/// ```ignore
+/// implement_view_guard!(PyCacheKeys);
+/// ```
+#[macro_export]
+macro_rules! implement_view_guard {
+    ($name:ident) => {
+        impl $name {
+            /// Fails if the cache changed after this view was created.
+            #[inline]
+            fn check_generation(&self) -> pyo3::PyResult<()> {
+                if self.initial_gv == self.gv.get() {
+                    return Ok(());
+                }
+
+                Err($crate::new_py_error!(
+                    PyRuntimeError,
+                    "cache size changed during iteration"
+                ))
+            }
+        }
+    };
+}
+
 /// Creates a new [`PyErr`] of the given exception type.
 #[macro_export]
 macro_rules! new_py_error {

{cachebox-6.2.4 → cachebox-6.2.5}/src/policies/fifopolicy.rs

@@ -255,6 +255,7 @@ impl PolicyExt for FIFOPolicy {
         &mut self,
         py: pyo3::Python,
         key: &<Self::Handle as HandleExt>::Key,
+        _shared: &Self::Shared,
     ) -> pyo3::PyResult<Option<&Self::Handle>> {
         let eq = |index: &usize| get_handle!(&self, *index).key().py_eq(py, key);
         match self.table.get(key.hash(), eq)? {