propcache 0.3.1__tar.gz → 0.3.2__tar.gz

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

@@ -14,6 +14,42 @@ 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
 =====
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: propcache
-Version: 0.3.1
+Version: 0.3.2
 Summary: Accelerated property cache
 Home-page: https://github.com/aio-libs/propcache
 Author: Andrew Svetlov
@@ -152,6 +152,42 @@ 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
 =====
 

{propcache-0.3.1 → 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.1 → propcache-0.3.2}/packaging/pep517_backend/_backend.py

@@ -4,7 +4,6 @@
 from __future__ import annotations
 
 import os
-import sysconfig
 import typing as t
 from collections.abc import Iterator
 from contextlib import contextmanager, nullcontext, suppress
@@ -293,7 +292,7 @@ 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)  # type: ignore[no-untyped-call]
         with patched_distutils_cmd_install():
@@ -376,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.1 → propcache-0.3.2}/packaging/pep517_backend/_cython_configuration.py

@@ -18,7 +18,7 @@ from ._transformers import get_cli_kwargs_from_config, get_enabled_cli_flags_fro
 class Config(TypedDict):
     env: dict[str, str]
     flags: dict[str, bool]
-    kwargs: dict[str, str]
+    kwargs: dict[str, str | dict[str, str]]
     src: list[str]
 
 
@@ -79,11 +79,25 @@ def get_local_cython_config() -> Config:
     return config_mapping['tool']['local']['cythonize']  # type: ignore[no-any-return]
 
 
-def make_cythonize_cli_args_from_config(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']
 

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

@@ -17,7 +17,9 @@ def _emit_opt_pairs(opt_pair: tuple[str, Union[dict[str, str], str]]) -> Iterato
     yield from ("=".join(map(str, (flag_opt,) + pair)) for pair in sub_pairs)
 
 
-def get_cli_kwargs_from_config(kwargs_map: dict[str, str]) -> list[str]:
+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())))
 

{propcache-0.3.1 → 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.1/requirements/test-pure.txt → propcache-0.3.2/requirements/test.txt

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

{propcache-0.3.1 → 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.1"
+__version__ = "0.3.2"
 __all__ = ()
 
 # Imports have moved to `propcache.api` in 0.2.0+.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: propcache
-Version: 0.3.1
+Version: 0.3.2
 Summary: Accelerated property cache
 Home-page: https://github.com/aio-libs/propcache
 Author: Andrew Svetlov
@@ -152,6 +152,42 @@ 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
 =====
 

{propcache-0.3.1 → 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.1/requirements/cython-freethreading.txt

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

propcache-0.3.1/requirements/cython.txt

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

propcache-0.3.1/requirements/test-freethreading.txt

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

propcache-0.3.1/requirements/test.txt

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