cachetools 7.1.0__tar.gz → 7.1.2__tar.gz

{cachetools-7.1.0 → cachetools-7.1.2}/CHANGELOG.rst

@@ -1,3 +1,19 @@
+v7.1.2 (2026-05-16)
+===================
+
+- Minor type stub improvements.
+
+- Minor documentation improvements.
+
+- Modernize build environment.
+
+
+v7.1.1 (2026-05-03)
+===================
+
+- Various type stub improvements.
+
+
 v7.1.0 (2026-05-01)
 ===================
 

{cachetools-7.1.0/src/cachetools.egg-info → cachetools-7.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachetools
-Version: 7.1.0
+Version: 7.1.2
 Summary: Extensible memoizing collections and decorators
 Author-email: Thomas Kemmer <tkemmer@computer.org>
 Maintainer-email: Thomas Kemmer <tkemmer@computer.org>
@@ -46,19 +46,10 @@ cachetools
    :target: https://codecov.io/gh/tkem/cachetools
    :alt: Test coverage
 
-.. image:: https://img.shields.io/librariesio/sourcerank/pypi/cachetools
-   :target: https://libraries.io/pypi/cachetools
-   :alt: Libraries.io SourceRank
-
 .. image:: https://img.shields.io/github/license/tkem/cachetools
    :target: https://raw.github.com/tkem/cachetools/master/LICENSE
    :alt: License
 
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-   :target: https://github.com/psf/black
-   :alt: Code style: black
-
-
 This module provides various memoizing collections and decorators,
 including variants of the Python Standard Library's `@lru_cache`_
 function decorator.

{cachetools-7.1.0 → cachetools-7.1.2}/README.rst

@@ -17,19 +17,10 @@ cachetools
    :target: https://codecov.io/gh/tkem/cachetools
    :alt: Test coverage
 
-.. image:: https://img.shields.io/librariesio/sourcerank/pypi/cachetools
-   :target: https://libraries.io/pypi/cachetools
-   :alt: Libraries.io SourceRank
-
 .. image:: https://img.shields.io/github/license/tkem/cachetools
    :target: https://raw.github.com/tkem/cachetools/master/LICENSE
    :alt: License
 
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-   :target: https://github.com/psf/black
-   :alt: Code style: black
-
-
 This module provides various memoizing collections and decorators,
 including variants of the Python Standard Library's `@lru_cache`_
 function decorator.

{cachetools-7.1.0 → cachetools-7.1.2}/docs/index.rst

@@ -88,6 +88,10 @@ inserted into the cache.
    This class evicts items in the order they were added to make space
    when necessary.
 
+   Updating a cache item via :meth:`FIFOCache.__setitem__` will act
+   like a re-insertion, i.e. deleting the item followed by an insert,
+   and therefore will reset the item's position in the cache.
+
 .. autoclass:: LFUCache(maxsize, getsizeof=None)
    :members: popitem
 

{cachetools-7.1.0 → cachetools-7.1.2}/pyproject.toml

@@ -47,17 +47,8 @@ where = ["src"]
 [tool.setuptools.dynamic]
 version = {attr = "cachetools.__version__"}
 
-[tool.flake8]
-max-line-length = 80
-exclude = [".git", ".tox", "build"]
-select = ["C", "E", "F", "W", "B", "B950", "I", "N"]
-# F401: imported but unused (submodule shims)
-# E501: line too long (black)
-# E704: multiple statements on one line (typehints)
-ignore = ["F401", "E501", "E704"]
-
 [tool.pyright]
 typeCheckingMode = "standard"
 reportFunctionMemberAccess = false
 reportOptionalContextManager = false
-reportOptionalMemberAccess = false
+reportOptionalMemberAccess = false

{cachetools-7.1.0 → cachetools-7.1.2}/src/cachetools/__init__.py

@@ -12,7 +12,7 @@ __all__ = (
     "cachedmethod",
 )
 
-__version__ = "7.1.0"
+__version__ = "7.1.2"
 
 import collections
 import collections.abc

{cachetools-7.1.0 → cachetools-7.1.2}/src/cachetools/__init__.pyi

@@ -3,10 +3,12 @@ from collections.abc import Callable, Iterator, MutableMapping, Sequence
 from contextlib import AbstractContextManager
 from typing import (
     Any,
+    Concatenate,
     Final,
     Generic,
     Literal,
     NamedTuple,
+    ParamSpec,
     Protocol,
     TypeVar,
     overload,
@@ -26,11 +28,12 @@ __all__: Final = (
 )
 __version__: str
 
+_P = ParamSpec("_P")
+_R = TypeVar("_R")
+_T = TypeVar("_T")
 _KT = TypeVar("_KT")
 _VT = TypeVar("_VT")
 _TT = TypeVar("_TT", default=float)
-_T = TypeVar("_T")
-_R = TypeVar("_R")
 _KT2 = TypeVar("_KT2")
 _VT2 = TypeVar("_VT2")
 
@@ -147,19 +150,19 @@ class _AbstractCondition(AbstractContextManager[Any], Protocol):
     def notify_all(self) -> None: ...
 
 @type_check_only
-class _cached_wrapper(Generic[_R]):
-    __wrapped__: Callable[..., _R]
+class _cached_wrapper(Generic[_P, _R]):
+    __wrapped__: Callable[_P, _R]
     __name__: str
     __doc__: str | None
     cache: MutableMapping[Any, Any] | None
     cache_key: Callable[..., Any] = ...
     cache_lock: AbstractContextManager[Any] | None = None
     cache_condition: _AbstractCondition | None = None
-    def __call__(self, /, *args: Any, **kwargs: Any) -> _R: ...
+    def __call__(self, /, *args: _P.args, **kwargs: _P.kwargs) -> _R: ...
     def cache_clear(self) -> None: ...
 
 @type_check_only
-class _cached_wrapper_info(_cached_wrapper[_R]):
+class _cached_wrapper_info(_cached_wrapper[_P, _R]):
     def cache_info(self) -> _CacheInfo: ...
 
 @overload
@@ -168,31 +171,47 @@ def cached(
     key: Callable[..., _KT] = ...,
     lock: AbstractContextManager[Any] | None = None,
     condition: _AbstractCondition | None = None,
-    info: Literal[True] = ...,
-) -> Callable[[Callable[..., _R]], _cached_wrapper_info[_R]]: ...
+    info: Literal[False] = ...,
+) -> Callable[[Callable[_P, _R]], _cached_wrapper[_P, _R]]: ...
 @overload
 def cached(
     cache: MutableMapping[_KT, Any] | None,
     key: Callable[..., _KT] = ...,
     lock: AbstractContextManager[Any] | None = None,
     condition: _AbstractCondition | None = None,
-    info: Literal[False] = ...,
-) -> Callable[[Callable[..., _R]], _cached_wrapper[_R]]: ...
+    *,
+    info: Literal[True],
+) -> Callable[[Callable[_P, _R]], _cached_wrapper_info[_P, _R]]: ...
+@overload
+def cached(
+    cache: MutableMapping[_KT, Any] | None,
+    key: Callable[..., _KT],
+    lock: AbstractContextManager[Any] | None,
+    condition: _AbstractCondition | None,
+    info: Literal[True],
+) -> Callable[[Callable[_P, _R]], _cached_wrapper_info[_P, _R]]: ...
 
 @type_check_only
-class _cachedmethod_wrapper(Generic[_R]):
-    __wrapped__: Callable[..., _R]
+class _cachedmethod_wrapper(Generic[_P, _R]):
+    __wrapped__: Callable[Concatenate[Any, _P], _R]
     __name__: str
     __doc__: str | None
-    cache: MutableMapping[Any, Any] | None
+    cache: MutableMapping[Any, Any]
     cache_key: Callable[..., Any] = ...
     cache_lock: AbstractContextManager[Any] | None = None
     cache_condition: _AbstractCondition | None = None
-    def __call__(self, /, *args: Any, **kwargs: Any) -> _R: ...
+    def __set_name__(self, owner: type, name: str) -> None: ...
+    def __get__(
+        self, obj: Any, objtype: type | None = None
+    ) -> _cachedmethod_wrapper[_P, _R]: ...
+    def __call__(self, /, *args: _P.args, **kwargs: _P.kwargs) -> _R: ...
     def cache_clear(self) -> None: ...
 
 @type_check_only
-class _cachedmethod_wrapper_info(_cachedmethod_wrapper[_R]):
+class _cachedmethod_wrapper_info(_cachedmethod_wrapper[_P, _R]):
+    def __get__(
+        self, obj: Any, objtype: type | None = None
+    ) -> _cachedmethod_wrapper_info[_P, _R]: ...
     def cache_info(self) -> _CacheInfo: ...
 
 @overload
@@ -201,13 +220,26 @@ def cachedmethod(
     key: Callable[..., _KT] = ...,
     lock: Callable[[Any], AbstractContextManager[Any]] | None = None,
     condition: Callable[[Any], _AbstractCondition] | None = None,
-    info: Literal[True] = ...,
-) -> Callable[[Callable[..., _R]], _cachedmethod_wrapper_info[_R]]: ...
+    info: Literal[False] = ...,
+) -> Callable[[Callable[Concatenate[Any, _P], _R]], _cachedmethod_wrapper[_P, _R]]: ...
 @overload
 def cachedmethod(
     cache: Callable[[Any], MutableMapping[_KT, Any]],
     key: Callable[..., _KT] = ...,
     lock: Callable[[Any], AbstractContextManager[Any]] | None = None,
     condition: Callable[[Any], _AbstractCondition] | None = None,
-    info: Literal[False] = ...,
-) -> Callable[[Callable[..., _R]], _cachedmethod_wrapper[_R]]: ...
+    *,
+    info: Literal[True],
+) -> Callable[
+    [Callable[Concatenate[Any, _P], _R]], _cachedmethod_wrapper_info[_P, _R]
+]: ...
+@overload
+def cachedmethod(
+    cache: Callable[[Any], MutableMapping[_KT, Any]],
+    key: Callable[..., _KT],
+    lock: Callable[[Any], AbstractContextManager[Any]] | None,
+    condition: Callable[[Any], _AbstractCondition] | None,
+    info: Literal[True],
+) -> Callable[
+    [Callable[Concatenate[Any, _P], _R]], _cachedmethod_wrapper_info[_P, _R]
+]: ...

{cachetools-7.1.0 → cachetools-7.1.2}/src/cachetools/func.py

@@ -2,7 +2,6 @@
 
 __all__ = ("fifo_cache", "lfu_cache", "lru_cache", "rr_cache", "ttl_cache")
 
-import functools
 import math
 import random
 import time

{cachetools-7.1.0 → cachetools-7.1.2/src/cachetools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cachetools
-Version: 7.1.0
+Version: 7.1.2
 Summary: Extensible memoizing collections and decorators
 Author-email: Thomas Kemmer <tkemmer@computer.org>
 Maintainer-email: Thomas Kemmer <tkemmer@computer.org>
@@ -46,19 +46,10 @@ cachetools
    :target: https://codecov.io/gh/tkem/cachetools
    :alt: Test coverage
 
-.. image:: https://img.shields.io/librariesio/sourcerank/pypi/cachetools
-   :target: https://libraries.io/pypi/cachetools
-   :alt: Libraries.io SourceRank
-
 .. image:: https://img.shields.io/github/license/tkem/cachetools
    :target: https://raw.github.com/tkem/cachetools/master/LICENSE
    :alt: License
 
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
-   :target: https://github.com/psf/black
-   :alt: Code style: black
-
-
 This module provides various memoizing collections and decorators,
 including variants of the Python Standard Library's `@lru_cache`_
 function decorator.

{cachetools-7.1.0 → cachetools-7.1.2}/src/cachetools.egg-info/SOURCES.txt

@@ -1,6 +1,5 @@
 CHANGELOG.rst
 LICENSE
-MANIFEST.in
 README.rst
 pyproject.toml
 tox.ini

{cachetools-7.1.0 → cachetools-7.1.2}/tests/__init__.py

@@ -1,5 +1,5 @@
 from collections.abc import Container, Iterable
-from typing import Any, Protocol, TypeAlias, no_type_check
+from typing import Any, Protocol
 
 import cachetools
 

{cachetools-7.1.0 → cachetools-7.1.2}/tests/test_cached.py

@@ -1,5 +1,4 @@
 import unittest
-import warnings
 
 import cachetools
 import cachetools.keys

{cachetools-7.1.0 → cachetools-7.1.2}/tests/test_cachedmethod.py

@@ -517,7 +517,6 @@ class MethodDecoratorTestMixin(_TestCaseProtocol):
 
 
 class CacheMethodTest(unittest.TestCase, MethodDecoratorTestMixin):
-
     def cache(self, minsize, **kwargs):
         return Cache(maxsize=minsize, **kwargs)
 
@@ -636,13 +635,11 @@ class CacheMethodTest(unittest.TestCase, MethodDecoratorTestMixin):
 
 
 class DictMethodTest(unittest.TestCase, MethodDecoratorTestMixin):
-
     def cache(self, minsize, **_kwargs):
         return dict()
 
 
 class WeakRefMethodTest(unittest.TestCase):
-
     def test_weakref(self):
         import fractions
         import gc

{cachetools-7.1.0 → cachetools-7.1.2}/tests/test_threading.py

@@ -19,7 +19,6 @@ def func():
 
 @unittest.skipUnless(environ.get("THREADING_TESTS", False), "THREADING_TESTS not set")
 class ThreadingTest(unittest.TestCase):
-
     NTHREADS = 10
 
     cache: LRUCache[Any, int] = LRUCache(1)

{cachetools-7.1.0 → cachetools-7.1.2}/tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = check-manifest,docs,doctest,flake8,pyright,py
+envlist = docs,doctest,format,lint,py,pyright
 
 [testenv]
 deps =
@@ -10,13 +10,6 @@ setenv =
 commands =
     py.test --basetemp={envtmpdir} --cov=cachetools --cov-report term-missing {posargs}
 
-[testenv:check-manifest]
-deps =
-    check-manifest
-commands =
-    check-manifest
-skip_install = true
-
 [testenv:docs]
 deps =
      sphinx
@@ -29,15 +22,18 @@ deps =
 commands =
      sphinx-build -W -b doctest -d {envtmpdir}/doctrees docs {envtmpdir}/doctest
 
-[testenv:flake8]
+[testenv:format]
+deps =
+    ruff
+commands =
+    ruff format --diff -q {posargs}
+skip_install = true
+
+[testenv:lint]
 deps =
-    flake8
-    flake8-black
-    flake8-bugbear
-    flake8-import-order
-    flake8-pyproject
+    ruff
 commands =
-    flake8
+    ruff check {posargs}
 skip_install = true
 
 [testenv:pyright]

cachetools-7.1.0/MANIFEST.in

@@ -1,11 +0,0 @@
-include CHANGELOG.rst
-include LICENSE
-include MANIFEST.in
-include README.rst
-include tox.ini
-exclude .readthedocs.yaml
-
-recursive-include docs *
-prune docs/_build
-
-recursive-include tests *.py