propcache 0.3.0__tar.gz → 0.3.2__tar.gz

{propcache-0.3.0 → propcache-0.3.2}/.coveragerc

@@ -13,7 +13,10 @@ _site-packages-to-src-mapping =
 
 [report]
 exclude_also =
-  ^\s*@pytest\.mark\.xfail
+    if TYPE_CHECKING
+    assert False
+    : \.\.\.(\s*#.*)?$
+    ^ +\.\.\.$
 # small library, don't fail when running without C-extension
 fail_under = 50.00
 skip_covered = true

{propcache-0.3.0 → propcache-0.3.2}/CHANGES.rst

@@ -14,6 +14,61 @@ Changelog
 
 .. towncrier release notes start
 
+0.3.2
+=====
+
+*(2025-06-09)*
+
+
+Improved documentation
+----------------------
+
+- Fixed incorrect decorator usage in the :func:`~propcache.api.under_cached_property` example code -- by :user:`meanmail`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`109`.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Updated to use Cython 3.1 universally across the build path -- by :user:`lysnikolaou`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`117`.
+
+- Made Cython line tracing opt-in via the ``with-cython-tracing`` build config setting -- by :user:`bdraco`.
+
+  Previously, line tracing was enabled by default in :file:`pyproject.toml`, which caused build issues for some users and made wheels nearly twice as slow.
+
+  Now line tracing is only enabled when explicitly requested via ``pip install . --config-setting=with-cython-tracing=true`` or by setting the ``PROPCACHE_CYTHON_TRACING`` environment variable.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`118`.
+
+
+----
+
+
+0.3.1
+=====
+
+*(2025-03-25)*
+
+
+Bug fixes
+---------
+
+- Improved typing annotations, fixing some type errors under correct usage
+  and improving typing robustness generally -- by :user:`Dreamsorcerer`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`103`.
+
+
+----
+
+
 0.3.0
 =====
 

{propcache-0.3.0/src/propcache.egg-info → propcache-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: propcache
-Version: 0.3.0
+Version: 0.3.2
 Summary: Accelerated property cache
 Home-page: https://github.com/aio-libs/propcache
 Author: Andrew Svetlov
@@ -35,6 +35,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: NOTICE
+Dynamic: license-file
 
 propcache
 =========
@@ -151,6 +152,61 @@ Changelog
 
 .. towncrier release notes start
 
+0.3.2
+=====
+
+*(2025-06-09)*
+
+
+Improved documentation
+----------------------
+
+- Fixed incorrect decorator usage in the ``~propcache.api.under_cached_property`` example code -- by `@meanmail <https://github.com/sponsors/meanmail>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#109 <https://github.com/aio-libs/propcache/issues/109>`__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Updated to use Cython 3.1 universally across the build path -- by `@lysnikolaou <https://github.com/sponsors/lysnikolaou>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#117 <https://github.com/aio-libs/propcache/issues/117>`__.
+
+- Made Cython line tracing opt-in via the ``with-cython-tracing`` build config setting -- by `@bdraco <https://github.com/sponsors/bdraco>`__.
+
+  Previously, line tracing was enabled by default in ``pyproject.toml``, which caused build issues for some users and made wheels nearly twice as slow.
+
+  Now line tracing is only enabled when explicitly requested via ``pip install . --config-setting=with-cython-tracing=true`` or by setting the ``PROPCACHE_CYTHON_TRACING`` environment variable.
+
+  *Related issues and pull requests on GitHub:*
+  `#118 <https://github.com/aio-libs/propcache/issues/118>`__.
+
+
+----
+
+
+0.3.1
+=====
+
+*(2025-03-25)*
+
+
+Bug fixes
+---------
+
+- Improved typing annotations, fixing some type errors under correct usage
+  and improving typing robustness generally -- by `@Dreamsorcerer <https://github.com/sponsors/Dreamsorcerer>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#103 <https://github.com/aio-libs/propcache/issues/103>`__.
+
+
+----
+
+
 0.3.0
 =====
 

{propcache-0.3.0 → propcache-0.3.2}/docs/api.rst

@@ -42,7 +42,7 @@ under_cached_property
                self._data = data
                self._cache = {}
 
-           @cached_property
+           @under_cached_property
            def calculated_data(self):
                return expensive_operation(self._data)
 

{propcache-0.3.0 → propcache-0.3.2}/packaging/pep517_backend/_backend.py

@@ -4,8 +4,8 @@
 from __future__ import annotations
 
 import os
-import sysconfig
 import typing as t
+from collections.abc import Iterator
 from contextlib import contextmanager, nullcontext, suppress
 from functools import partial
 from pathlib import Path
@@ -56,7 +56,7 @@ __all__ = (  # noqa: WPS410
     'get_requires_for_build_wheel',
     'prepare_metadata_for_build_wheel',
     *(
-        () if _setuptools_build_editable is None
+        () if _setuptools_build_editable is None  # type: ignore[redundant-expr]
         else (
             'build_editable',
             'get_requires_for_build_editable',
@@ -87,7 +87,7 @@ PURE_PYTHON_MODE_CLI_FALLBACK = not IS_CPYTHON
 """A fallback for ``pure-python`` is not set."""
 
 
-def _is_truthy_setting_value(setting_value) -> bool:
+def _is_truthy_setting_value(setting_value: str) -> bool:
     truthy_values = {'', None, 'true', '1', 'on'}
     return setting_value.lower() in truthy_values
 
@@ -108,7 +108,7 @@ def _get_setting_value(
             continue
 
         with suppress(lookup_errors):  # type: ignore[arg-type]
-            return _is_truthy_setting_value(src_mapping[src_key])  # type: ignore[index]
+            return _is_truthy_setting_value(src_mapping[src_key])  # type: ignore[arg-type,index]
 
     return default
 
@@ -125,7 +125,7 @@ def _make_pure_python(config_settings: _ConfigDict | None = None) -> bool:
 def _include_cython_line_tracing(
         config_settings: _ConfigDict | None = None,
         *,
-        default=False,
+        default: bool = False,
 ) -> bool:
     return _get_setting_value(
         config_settings,
@@ -136,7 +136,7 @@ def _include_cython_line_tracing(
 
 
 @contextmanager
-def patched_distutils_cmd_install():
+def patched_distutils_cmd_install() -> Iterator[None]:
     """Make `install_lib` of `install` cmd always use `platlib`.
 
     :yields: None
@@ -144,19 +144,19 @@ def patched_distutils_cmd_install():
     # Without this, build_lib puts stuff under `*.data/purelib/` folder
     orig_finalize = _distutils_install_cmd.finalize_options
 
-    def new_finalize_options(self):  # noqa: WPS430
+    def new_finalize_options(self: _distutils_install_cmd) -> None:
         self.install_lib = self.install_platlib
         orig_finalize(self)
 
-    _distutils_install_cmd.finalize_options = new_finalize_options
+    _distutils_install_cmd.finalize_options = new_finalize_options  # type: ignore[method-assign]
     try:
         yield
     finally:
-        _distutils_install_cmd.finalize_options = orig_finalize
+        _distutils_install_cmd.finalize_options = orig_finalize  # type: ignore[method-assign]
 
 
 @contextmanager
-def patched_dist_has_ext_modules():
+def patched_dist_has_ext_modules() -> Iterator[None]:
     """Make `has_ext_modules` of `Distribution` always return `True`.
 
     :yields: None
@@ -164,15 +164,15 @@ def patched_dist_has_ext_modules():
     # Without this, build_lib puts stuff under `*.data/platlib/` folder
     orig_func = _DistutilsDistribution.has_ext_modules
 
-    _DistutilsDistribution.has_ext_modules = lambda *args, **kwargs: True
+    _DistutilsDistribution.has_ext_modules = lambda *args, **kwargs: True  # type: ignore[method-assign]
     try:
         yield
     finally:
-        _DistutilsDistribution.has_ext_modules = orig_func
+        _DistutilsDistribution.has_ext_modules = orig_func  # type: ignore[method-assign]
 
 
 @contextmanager
-def patched_dist_get_long_description():
+def patched_dist_get_long_description() -> Iterator[None]:
     """Make `has_ext_modules` of `Distribution` always return `True`.
 
     :yields: None
@@ -180,16 +180,17 @@ def patched_dist_get_long_description():
     # Without this, build_lib puts stuff under `*.data/platlib/` folder
     _orig_func = _DistutilsDistributionMetadata.get_long_description
 
-    def _get_sanitized_long_description(self):
+    def _get_sanitized_long_description(self: _DistutilsDistributionMetadata) -> str:
+        assert self.long_description is not None
         return sanitize_rst_roles(self.long_description)
 
-    _DistutilsDistributionMetadata.get_long_description = (
+    _DistutilsDistributionMetadata.get_long_description = (  # type: ignore[method-assign]
         _get_sanitized_long_description
     )
     try:
         yield
     finally:
-        _DistutilsDistributionMetadata.get_long_description = _orig_func
+        _DistutilsDistributionMetadata.get_long_description = _orig_func  # type: ignore[method-assign]
 
 
 def _exclude_dir_path(
@@ -291,9 +292,9 @@ def maybe_prebuild_c_extensions(
     with build_dir_ctx:
         config = _get_local_cython_config()
 
-        cythonize_args = _make_cythonize_cli_args_from_config(config)
+        cythonize_args = _make_cythonize_cli_args_from_config(config, cython_line_tracing_requested)
         with _patched_cython_env(config['env'], cython_line_tracing_requested):
-            _cythonize_cli_cmd(cythonize_args)
+            _cythonize_cli_cmd(cythonize_args)  # type: ignore[no-untyped-call]
         with patched_distutils_cmd_install():
             with patched_dist_has_ext_modules():
                 yield
@@ -374,10 +375,8 @@ def get_requires_for_build_wheel(
 
     if is_pure_python_build:
         c_ext_build_deps = []
-    elif sysconfig.get_config_var('Py_GIL_DISABLED'):
-        c_ext_build_deps = ['Cython ~= 3.1.0a1']
     else:
-        c_ext_build_deps = ['Cython ~= 3.0.12']
+        c_ext_build_deps = ['Cython ~= 3.1.0']
 
     return _setuptools_get_requires_for_build_wheel(
         config_settings=config_settings,

{propcache-0.3.0 → propcache-0.3.2}/packaging/pep517_backend/_compat.py

@@ -1,17 +1,20 @@
 """Cross-python stdlib shims."""
 
 import os
-import typing as t
+import sys
+from collections.abc import Iterator
 from contextlib import contextmanager
 from pathlib import Path
 
 # isort: off
-try:
-    from contextlib import chdir as chdir_cm  # type: ignore[attr-defined, unused-ignore] # noqa: E501
-except ImportError:
+if sys.version_info >= (3, 11):
+    from contextlib import chdir as chdir_cm
+    from tomllib import loads as load_toml_from_string
+else:
+    from tomli import loads as load_toml_from_string
 
-    @contextmanager  # type: ignore[no-redef, unused-ignore]
-    def chdir_cm(path: os.PathLike) -> t.Iterator[None]:
+    @contextmanager
+    def chdir_cm(path: os.PathLike) -> Iterator[None]:
         """Temporarily change the current directory, recovering on exit."""
         original_wd = Path.cwd()
         os.chdir(path)
@@ -22,12 +25,4 @@ except ImportError:
 
 
 # isort: on
-
-
-try:
-    from tomllib import loads as load_toml_from_string
-except ImportError:
-    from tomli import loads as load_toml_from_string
-
-
 __all__ = ("chdir_cm", "load_toml_from_string")  # noqa: WPS410

{propcache-0.3.0 → propcache-0.3.2}/packaging/pep517_backend/_cython_configuration.py

@@ -3,9 +3,11 @@
 from __future__ import annotations
 
 import os
+from collections.abc import Iterator
 from contextlib import contextmanager
 from pathlib import Path
 from sys import version_info as _python_version_tuple
+from typing import TypedDict
 
 from expandvars import expandvars
 
@@ -13,7 +15,14 @@ from ._compat import load_toml_from_string
 from ._transformers import get_cli_kwargs_from_config, get_enabled_cli_flags_from_config
 
 
-def get_local_cython_config() -> dict:
+class Config(TypedDict):
+    env: dict[str, str]
+    flags: dict[str, bool]
+    kwargs: dict[str, str | dict[str, str]]
+    src: list[str]
+
+
+def get_local_cython_config() -> Config:
     """Grab optional build dependencies from pyproject.toml config.
 
     :returns: config section from ``pyproject.toml``
@@ -67,20 +76,34 @@ def get_local_cython_config() -> dict:
     """
     config_toml_txt = (Path.cwd().resolve() / 'pyproject.toml').read_text()
     config_mapping = load_toml_from_string(config_toml_txt)
-    return config_mapping['tool']['local']['cythonize']
+    return config_mapping['tool']['local']['cythonize']  # type: ignore[no-any-return]
 
 
-def make_cythonize_cli_args_from_config(config) -> list[str]:
+def _configure_cython_line_tracing(config_kwargs: dict[str, str | dict[str, str]], cython_line_tracing_requested: bool) -> None:
+    """Configure Cython line tracing directives if requested."""
+    # If line tracing is requested, add it to the directives
+    if cython_line_tracing_requested:
+        directives = config_kwargs.setdefault('directive', {})
+        assert isinstance(directives, dict)  # Type narrowing for mypy
+        directives['linetrace'] = 'True'
+        directives['profile'] = 'True'
+
+
+def make_cythonize_cli_args_from_config(config: Config, cython_line_tracing_requested: bool = False) -> list[str]:
     py_ver_arg = f'-{_python_version_tuple.major!s}'
 
     cli_flags = get_enabled_cli_flags_from_config(config['flags'])
-    cli_kwargs = get_cli_kwargs_from_config(config['kwargs'])
+    config_kwargs = config['kwargs']
+
+    _configure_cython_line_tracing(config_kwargs, cython_line_tracing_requested)
+
+    cli_kwargs = get_cli_kwargs_from_config(config_kwargs)
 
     return cli_flags + [py_ver_arg] + cli_kwargs + ['--'] + config['src']
 
 
 @contextmanager
-def patched_env(env: dict[str, str], cython_line_tracing_requested: bool):
+def patched_env(env: dict[str, str], cython_line_tracing_requested: bool) -> Iterator[None]:
     """Temporary set given env vars.
 
     :param env: tmp env vars to set
@@ -89,7 +112,7 @@ def patched_env(env: dict[str, str], cython_line_tracing_requested: bool):
     :yields: None
     """
     orig_env = os.environ.copy()
-    expanded_env = {name: expandvars(var_val) for name, var_val in env.items()}
+    expanded_env = {name: expandvars(var_val) for name, var_val in env.items()}  # type: ignore[no-untyped-call]
     os.environ.update(expanded_env)
 
     if cython_line_tracing_requested:

{propcache-0.3.0 → propcache-0.3.2}/packaging/pep517_backend/_transformers.py

@@ -1,26 +1,30 @@
 """Data conversion helpers for the in-tree PEP 517 build backend."""
 
+from collections.abc import Iterable, Iterator, Mapping
 from itertools import chain
 from re import sub as _substitute_with_regexp
+from typing import Union
 
 
-def _emit_opt_pairs(opt_pair):
+def _emit_opt_pairs(opt_pair: tuple[str, Union[dict[str, str], str]]) -> Iterator[str]:
     flag, flag_value = opt_pair
     flag_opt = f"--{flag!s}"
     if isinstance(flag_value, dict):
-        sub_pairs = flag_value.items()
+        sub_pairs: Iterable[tuple[str, ...]] = flag_value.items()
     else:
         sub_pairs = ((flag_value,),)
 
     yield from ("=".join(map(str, (flag_opt,) + pair)) for pair in sub_pairs)
 
 
-def get_cli_kwargs_from_config(kwargs_map):
+def get_cli_kwargs_from_config(
+    kwargs_map: dict[str, Union[str, dict[str, str]]],
+) -> list[str]:
     """Make a list of options with values from config."""
     return list(chain.from_iterable(map(_emit_opt_pairs, kwargs_map.items())))
 
 
-def get_enabled_cli_flags_from_config(flags_map):
+def get_enabled_cli_flags_from_config(flags_map: Mapping[str, bool]) -> list[str]:
     """Make a list of enabled boolean flags from config."""
     return [f"--{flag}" for flag, is_enabled in flags_map.items() if is_enabled]
 

{propcache-0.3.0 → propcache-0.3.2}/packaging/pep517_backend/cli.py

@@ -3,11 +3,12 @@
 from __future__ import annotations
 
 import sys
+from collections.abc import Sequence
 from itertools import chain
 from pathlib import Path
 
+from Cython.Compiler.CmdLine import parse_command_line as _split_cython_cli_args
 from Cython.Compiler.Main import compile as _translate_cython_cli_cmd
-from Cython.Compiler.Main import parse_command_line as _split_cython_cli_args
 
 from ._cython_configuration import get_local_cython_config as _get_local_cython_config
 from ._cython_configuration import (
@@ -18,7 +19,7 @@ from ._cython_configuration import patched_env as _patched_cython_env
 _PROJECT_PATH = Path(__file__).parents[2]
 
 
-def run_main_program(argv) -> int | str:
+def run_main_program(argv: Sequence[str]) -> int | str:
     """Invoke ``translate-cython`` or fail."""
     if len(argv) != 2:
         return 'This program only accepts one argument -- "translate-cython"'
@@ -38,12 +39,12 @@ def run_main_program(argv) -> int | str:
     )
     translate_cython_cli_args = _make_cythonize_cli_args_from_config(config)
 
-    cython_options, cython_sources = _split_cython_cli_args(
+    cython_options, cython_sources = _split_cython_cli_args(  # type: ignore[no-untyped-call]
         translate_cython_cli_args,
     )
 
     with _patched_cython_env(config['env'], cython_line_tracing_requested=True):
-        return _translate_cython_cli_cmd(
+        return _translate_cython_cli_cmd(  # type: ignore[no-untyped-call,no-any-return]
             cython_sources,
             cython_options,
         ).num_errors

{propcache-0.3.0 → propcache-0.3.2}/packaging/pep517_backend/hooks.py

@@ -2,7 +2,7 @@
 
 from contextlib import suppress as _suppress
 
-from setuptools.build_meta import *  # Re-exporting PEP 517 hooks  # pylint: disable=unused-wildcard-import,wildcard-import  # noqa: E501, F401, F403
+from setuptools.build_meta import *  # Re-exporting PEP 517 hooks  # pylint: disable=unused-wildcard-import,wildcard-import  # noqa: F401, F403
 
 # Re-exporting PEP 517 hooks
 from ._backend import (  # type: ignore[assignment]

{propcache-0.3.0 → propcache-0.3.2}/pyproject.toml

@@ -48,7 +48,6 @@ keep-going = false
 # https://cython.rtfd.io/en/latest/src/userguide/source_files_and_compilation.html#compiler-directives
 embedsignature = "True"
 emit_code_comments = "True"
-linetrace = "True"  # Implies `profile=True`
 
 [tool.local.cythonize.kwargs.compile-time-env]
 # This section can contain compile time env vars
@@ -95,12 +94,3 @@ before-test = []  # Windows cmd has different syntax and pip chooses wheels
 
 [tool.cibuildwheel.linux]
 before-all = "yum install -y libffi-devel || apk add --upgrade libffi-dev || apt-get install libffi-dev"
-
-# TODO: Remove this when there's a Cython 3.1 final release
-# Remove PIP_CONSTRAINT from the environment
-[[tool.cibuildwheel.overrides]]
-select = "cp313t-*"
-
-test-requires = "-r requirements/test-freethreading.txt"
-inherit.environment = "append"
-environment = {PIP_CONSTRAINT = "requirements/cython-freethreading.txt"}

propcache-0.3.2/requirements/cython.txt

@@ -0,0 +1 @@
+cython==3.1.2

{propcache-0.3.0 → propcache-0.3.2}/requirements/doc.txt

@@ -1,4 +1,4 @@
 -r towncrier.txt
 myst-parser >= 0.10.0
-sphinx==8.2.0
+sphinx==8.2.3
 sphinxcontrib-towncrier

propcache-0.3.2/requirements/lint.txt

@@ -0,0 +1 @@
+pre-commit==4.2.0

propcache-0.3.0/requirements/test-pure.txt → propcache-0.3.2/requirements/test.txt

@@ -1,4 +1,5 @@
+-r cython.txt
 covdefaults
-pytest==8.3.4
+pytest==8.3.5
 pytest-cov>=2.3.1
 pytest-xdist

{propcache-0.3.0 → propcache-0.3.2}/setup.cfg

@@ -73,7 +73,8 @@ include_package_data = True
 max-line-length = 79
 
 [flake8]
-ignore = E203,E301,E302,E704,W503,W504,F811
+extend-select = B950
+ignore = E203,E301,E302,E501,E704,W503,W504,F811
 max-line-length = 88
 per-file-ignores = 
 	

{propcache-0.3.0 → propcache-0.3.2}/src/propcache/__init__.py

@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING
 
 _PUBLIC_API = ("cached_property", "under_cached_property")
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 __all__ = ()
 
 # Imports have moved to `propcache.api` in 0.2.0+.

{propcache-0.3.0 → propcache-0.3.2}/src/propcache/_helpers.py

@@ -19,8 +19,8 @@ if TYPE_CHECKING:
     under_cached_property = under_cached_property_py
 elif not NO_EXTENSIONS:  # pragma: no branch
     try:
-        from ._helpers_c import cached_property as cached_property_c  # type: ignore[attr-defined, unused-ignore] # noqa: E501
-        from ._helpers_c import under_cached_property as under_cached_property_c  # type: ignore[attr-defined, unused-ignore] # noqa: E501
+        from ._helpers_c import cached_property as cached_property_c  # type: ignore[attr-defined, unused-ignore]
+        from ._helpers_c import under_cached_property as under_cached_property_c  # type: ignore[attr-defined, unused-ignore]
 
         cached_property = cached_property_c
         under_cached_property = under_cached_property_c

{propcache-0.3.0 → propcache-0.3.2}/src/propcache/_helpers_c.pyx

@@ -37,6 +37,8 @@ cdef class under_cached_property:
     def __set__(self, inst, value):
         raise AttributeError("cached property is read-only")
 
+    __class_getitem__ = classmethod(GenericAlias)
+
 
 cdef class cached_property:
     """Use as a class method decorator.  It operates almost exactly like

{propcache-0.3.0 → propcache-0.3.2}/src/propcache/_helpers_py.py

@@ -1,6 +1,7 @@
 """Various helper functions."""
 
 import sys
+from collections.abc import Mapping
 from functools import cached_property
 from typing import Any, Callable, Generic, Optional, Protocol, TypeVar, Union, overload
 
@@ -13,10 +14,13 @@ else:
     Self = Any
 
 _T = TypeVar("_T")
+# We use Mapping to make it possible to use TypedDict, but this isn't
+# technically type safe as we need to assign into the dict.
+_Cache = TypeVar("_Cache", bound=Mapping[str, Any])
 
 
-class _TSelf(Protocol, Generic[_T]):
-    _cache: dict[str, _T]
+class _CacheImpl(Protocol[_Cache]):
+    _cache: _Cache
 
 
 class under_cached_property(Generic[_T]):
@@ -29,7 +33,7 @@ class under_cached_property(Generic[_T]):
     variable.  It is, in Python parlance, a data descriptor.
     """
 
-    def __init__(self, wrapped: Callable[..., _T]) -> None:
+    def __init__(self, wrapped: Callable[[Any], _T]) -> None:
         self.wrapped = wrapped
         self.__doc__ = wrapped.__doc__
         self.name = wrapped.__name__
@@ -38,19 +42,19 @@ class under_cached_property(Generic[_T]):
     def __get__(self, inst: None, owner: Optional[type[object]] = None) -> Self: ...
 
     @overload
-    def __get__(self, inst: _TSelf[_T], owner: Optional[type[object]] = None) -> _T: ...
+    def __get__(self, inst: _CacheImpl[Any], owner: Optional[type[object]] = None) -> _T: ...  # type: ignore[misc]
 
     def __get__(
-        self, inst: Optional[_TSelf[_T]], owner: Optional[type[object]] = None
+        self, inst: Optional[_CacheImpl[Any]], owner: Optional[type[object]] = None
     ) -> Union[_T, Self]:
         if inst is None:
             return self
         try:
-            return inst._cache[self.name]
+            return inst._cache[self.name]  # type: ignore[no-any-return]
         except KeyError:
             val = self.wrapped(inst)
             inst._cache[self.name] = val
             return val
 
-    def __set__(self, inst: _TSelf[_T], value: _T) -> None:
+    def __set__(self, inst: _CacheImpl[Any], value: _T) -> None:
         raise AttributeError("cached property is read-only")

{propcache-0.3.0 → propcache-0.3.2/src/propcache.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: propcache
-Version: 0.3.0
+Version: 0.3.2
 Summary: Accelerated property cache
 Home-page: https://github.com/aio-libs/propcache
 Author: Andrew Svetlov
@@ -35,6 +35,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: NOTICE
+Dynamic: license-file
 
 propcache
 =========
@@ -151,6 +152,61 @@ Changelog
 
 .. towncrier release notes start
 
+0.3.2
+=====
+
+*(2025-06-09)*
+
+
+Improved documentation
+----------------------
+
+- Fixed incorrect decorator usage in the ``~propcache.api.under_cached_property`` example code -- by `@meanmail <https://github.com/sponsors/meanmail>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#109 <https://github.com/aio-libs/propcache/issues/109>`__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Updated to use Cython 3.1 universally across the build path -- by `@lysnikolaou <https://github.com/sponsors/lysnikolaou>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#117 <https://github.com/aio-libs/propcache/issues/117>`__.
+
+- Made Cython line tracing opt-in via the ``with-cython-tracing`` build config setting -- by `@bdraco <https://github.com/sponsors/bdraco>`__.
+
+  Previously, line tracing was enabled by default in ``pyproject.toml``, which caused build issues for some users and made wheels nearly twice as slow.
+
+  Now line tracing is only enabled when explicitly requested via ``pip install . --config-setting=with-cython-tracing=true`` or by setting the ``PROPCACHE_CYTHON_TRACING`` environment variable.
+
+  *Related issues and pull requests on GitHub:*
+  `#118 <https://github.com/aio-libs/propcache/issues/118>`__.
+
+
+----
+
+
+0.3.1
+=====
+
+*(2025-03-25)*
+
+
+Bug fixes
+---------
+
+- Improved typing annotations, fixing some type errors under correct usage
+  and improving typing robustness generally -- by `@Dreamsorcerer <https://github.com/sponsors/Dreamsorcerer>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#103 <https://github.com/aio-libs/propcache/issues/103>`__.
+
+
+----
+
+
 0.3.0
 =====
 

{propcache-0.3.0 → propcache-0.3.2}/src/propcache.egg-info/SOURCES.txt

@@ -31,14 +31,11 @@ packaging/pep517_backend/_transformers.py
 packaging/pep517_backend/cli.py
 packaging/pep517_backend/hooks.py
 requirements/codspeed.txt
-requirements/cython-freethreading.txt
 requirements/cython.txt
 requirements/dev.txt
 requirements/doc-spelling.txt
 requirements/doc.txt
 requirements/lint.txt
-requirements/test-freethreading.txt
-requirements/test-pure.txt
 requirements/test.txt
 requirements/towncrier.txt
 src/propcache/__init__.py

{propcache-0.3.0 → propcache-0.3.2}/tests/conftest.py

@@ -53,7 +53,7 @@ class PropcacheImplementation:
 )
 def propcache_implementation(request: pytest.FixtureRequest) -> PropcacheImplementation:
     """Return a propcache variant facade."""
-    return request.param
+    return request.param  # type: ignore[no-any-return]
 
 
 @pytest.fixture(scope="session")

{propcache-0.3.0 → propcache-0.3.2}/tests/test_cached_property.py

@@ -1,14 +1,22 @@
+import sys
+from collections.abc import Callable
 from operator import not_
-from typing import Protocol
+from typing import TYPE_CHECKING, Any, Protocol, TypeVar
 
 import pytest
 
 from propcache.api import cached_property
 
+if sys.version_info >= (3, 11):
+    from typing import assert_type
+
+_T_co = TypeVar("_T_co", covariant=True)
 
-class APIProtocol(Protocol):
 
-    cached_property: type[cached_property]
+class APIProtocol(Protocol):
+    def cached_property(
+        self, func: Callable[[Any], _T_co]
+    ) -> cached_property[_T_co]: ...
 
 
 def test_cached_property(propcache_module: APIProtocol) -> None:
@@ -21,23 +29,11 @@ def test_cached_property(propcache_module: APIProtocol) -> None:
             return 1
 
     a = A()
+    if sys.version_info >= (3, 11):
+        assert_type(a.prop, int)
     assert a.prop == 1
 
 
-def test_cached_property_class(propcache_module: APIProtocol) -> None:
-    class A:
-        def __init__(self) -> None:
-            """Init."""
-            # self._cache not set because its never accessed in this test
-
-        @propcache_module.cached_property
-        def prop(self) -> None:
-            """Docstring."""
-
-    assert isinstance(A.prop, propcache_module.cached_property)
-    assert A.prop.__doc__ == "Docstring."
-
-
 def test_cached_property_without_cache(propcache_module: APIProtocol) -> None:
     class A:
 
@@ -53,7 +49,7 @@ def test_cached_property_without_cache(propcache_module: APIProtocol) -> None:
     a = A()
 
     with pytest.raises(AttributeError):
-        a.prop = 123
+        a.prop = 123  # type: ignore[assignment]
 
 
 def test_cached_property_check_without_cache(propcache_module: APIProtocol) -> None:
@@ -96,7 +92,10 @@ def test_cached_property_class_docstring(propcache_module: APIProtocol) -> None:
         def prop(self) -> None:
             """Docstring."""
 
-    assert isinstance(A.prop, propcache_module.cached_property)
+    if TYPE_CHECKING:
+        assert isinstance(A.prop, cached_property)
+    else:
+        assert isinstance(A.prop, propcache_module.cached_property)
     assert "Docstring." == A.prop.__doc__
 
 

{propcache-0.3.0 → propcache-0.3.2}/tests/test_under_cached_property.py

@@ -1,13 +1,21 @@
-from typing import Any, Protocol
+import sys
+from collections.abc import Callable
+from typing import TYPE_CHECKING, Any, Protocol, TypedDict, TypeVar
 
 import pytest
 
 from propcache.api import under_cached_property
 
+if sys.version_info >= (3, 11):
+    from typing import assert_type
+
+_T_co = TypeVar("_T_co", covariant=True)
 
-class APIProtocol(Protocol):
 
-    under_cached_property: type[under_cached_property]
+class APIProtocol(Protocol):
+    def under_cached_property(
+        self, func: Callable[[Any], _T_co]
+    ) -> under_cached_property[_T_co]: ...
 
 
 def test_under_cached_property(propcache_module: APIProtocol) -> None:
@@ -19,21 +27,45 @@ def test_under_cached_property(propcache_module: APIProtocol) -> None:
         def prop(self) -> int:
             return 1
 
+        @propcache_module.under_cached_property
+        def prop2(self) -> str:
+            return "foo"
+
     a = A()
+    if sys.version_info >= (3, 11):
+        assert_type(a.prop, int)
     assert a.prop == 1
+    if sys.version_info >= (3, 11):
+        assert_type(a.prop2, str)
+    assert a.prop2 == "foo"
 
 
-def test_under_cached_property_class(propcache_module: APIProtocol) -> None:
+def test_under_cached_property_typeddict(propcache_module: APIProtocol) -> None:
+    """Test static typing passes with TypedDict."""
+
+    class _Cache(TypedDict, total=False):
+        prop: int
+        prop2: str
+
     class A:
         def __init__(self) -> None:
-            """Init."""
+            self._cache: _Cache = {}
 
         @propcache_module.under_cached_property
-        def prop(self) -> None:
-            """Docstring."""
+        def prop(self) -> int:
+            return 1
+
+        @propcache_module.under_cached_property
+        def prop2(self) -> str:
+            return "foo"
 
-    assert isinstance(A.prop, propcache_module.under_cached_property)
-    assert A.prop.__doc__ == "Docstring."
+    a = A()
+    if sys.version_info >= (3, 11):
+        assert_type(a.prop, int)
+    assert a.prop == 1
+    if sys.version_info >= (3, 11):
+        assert_type(a.prop2, str)
+    assert a.prop2 == "foo"
 
 
 def test_under_cached_property_assignment(propcache_module: APIProtocol) -> None:
@@ -48,7 +80,7 @@ def test_under_cached_property_assignment(propcache_module: APIProtocol) -> None
     a = A()
 
     with pytest.raises(AttributeError):
-        a.prop = 123
+        a.prop = 123  # type: ignore[assignment]
 
 
 def test_under_cached_property_without_cache(propcache_module: APIProtocol) -> None:
@@ -64,7 +96,7 @@ def test_under_cached_property_without_cache(propcache_module: APIProtocol) -> N
     a = A()
 
     with pytest.raises(AttributeError):
-        a.prop = 123
+        a.prop = 123  # type: ignore[assignment]
 
 
 def test_under_cached_property_check_without_cache(
@@ -105,10 +137,16 @@ def test_under_cached_property_class_docstring(propcache_module: APIProtocol) ->
             """Init."""
 
         @propcache_module.under_cached_property
-        def prop(self) -> Any:
+        def prop(self) -> None:
             """Docstring."""
 
-    assert isinstance(A.prop, propcache_module.under_cached_property)
+    if TYPE_CHECKING:
+        # At type checking, the fixture doesn't represent the real module, so
+        # we use the global-level imported module to verify the isinstance() check here
+        # matches the behaviour users would see in real code.
+        assert isinstance(A.prop, under_cached_property)
+    else:
+        assert isinstance(A.prop, propcache_module.under_cached_property)
     assert "Docstring." == A.prop.__doc__
 
 

propcache-0.3.0/requirements/cython-freethreading.txt

@@ -1 +0,0 @@
-cython==3.1.0a1

propcache-0.3.0/requirements/cython.txt

@@ -1 +0,0 @@
-cython==3.0.12

propcache-0.3.0/requirements/lint.txt

@@ -1 +0,0 @@
-pre-commit==4.1.0

propcache-0.3.0/requirements/test-freethreading.txt

@@ -1,2 +0,0 @@
--r cython-freethreading.txt
--r test-pure.txt

propcache-0.3.0/requirements/test.txt

@@ -1,2 +0,0 @@
--r cython.txt
--r test-pure.txt