propcache 0.2.0__tar.gz → 0.3.0__tar.gz

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

@@ -3,20 +3,22 @@ show_contexts = true
 skip_covered = false
 
 [paths]
-source =
-  src/propcache
-  */lib/pypy*/site-packages/propcache
-  */lib/python*/site-packages/propcache
-  */Lib/site-packages/propcache
+_site-packages-to-src-mapping =
+  src
+  */src
+  *\src
+  */lib/pypy*/site-packages
+  */lib/python*/site-packages
+  *\Lib\site-packages
 
 [report]
+exclude_also =
+  ^\s*@pytest\.mark\.xfail
 # small library, don't fail when running without C-extension
 fail_under = 50.00
 skip_covered = true
 skip_empty = true
 show_missing = true
-exclude_also =
-  ^\s*@pytest\.mark\.xfail
 
 [run]
 branch = true

propcache-0.3.0/CHANGES.rst

@@ -0,0 +1,180 @@
+=========
+Changelog
+=========
+
+..
+    You should *NOT* be adding new change log entries to this file, this
+    file is managed by towncrier. You *may* edit previous change logs to
+    fix problems like typo corrections or such.
+    To add a new change log entry, please see
+    https://pip.pypa.io/en/latest/development/#adding-a-news-entry
+    we named the news folder "changes".
+
+    WARNING: Don't drop the next directive!
+
+.. towncrier release notes start
+
+0.3.0
+=====
+
+*(2025-02-20)*
+
+
+Features
+--------
+
+- Implemented support for the free-threaded build of CPython 3.13 -- by :user:`lysnikolaou`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`84`.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Started building wheels for the free-threaded build of CPython 3.13 -- by :user:`lysnikolaou`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`84`.
+
+
+Contributor-facing changes
+--------------------------
+
+- GitHub Actions CI/CD is now configured to manage caching pip-ecosystem
+  dependencies using `re-actors/cache-python-deps`_ -- an action by
+  :user:`webknjaz` that takes into account ABI stability and the exact
+  version of Python runtime.
+
+  .. _`re-actors/cache-python-deps`:
+     https://github.com/marketplace/actions/cache-python-deps
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`93`.
+
+
+----
+
+
+0.2.1
+=====
+
+*(2024-12-01)*
+
+
+Bug fixes
+---------
+
+- Stopped implicitly allowing the use of Cython pre-release versions when
+  building the distribution package -- by :user:`ajsanchezsanz` and
+  :user:`markgreene74`.
+
+  *Related commits on GitHub:*
+  :commit:`64df0a6`.
+
+- Fixed ``wrapped`` and ``func`` not being accessible in the Cython versions of :func:`propcache.api.cached_property` and :func:`propcache.api.under_cached_property` decorators -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`72`.
+
+
+Removals and backward incompatible breaking changes
+---------------------------------------------------
+
+- Removed support for Python 3.8 as it has reached end of life -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`57`.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Stopped implicitly allowing the use of Cython pre-release versions when
+  building the distribution package -- by :user:`ajsanchezsanz` and
+  :user:`markgreene74`.
+
+  *Related commits on GitHub:*
+  :commit:`64df0a6`.
+
+
+----
+
+
+0.2.0
+=====
+
+*(2024-10-07)*
+
+
+Bug fixes
+---------
+
+- Fixed loading the C-extensions on Python 3.8 -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`26`.
+
+
+Features
+--------
+
+- Improved typing for the :func:`propcache.api.under_cached_property` decorator -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`38`.
+
+
+Improved documentation
+----------------------
+
+- Added API documentation for the :func:`propcache.api.cached_property` and :func:`propcache.api.under_cached_property` decorators -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`16`.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Moved :func:`propcache.api.under_cached_property` and :func:`propcache.api.cached_property` to `propcache.api` -- by :user:`bdraco`.
+
+  Both decorators remain importable from the top-level package, however importing from `propcache.api` is now the recommended way to use them.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`19`, :issue:`24`, :issue:`32`.
+
+- Converted project to use a src layout -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`22`, :issue:`29`, :issue:`37`.
+
+
+----
+
+
+0.1.0
+=====
+
+*(2024-10-03)*
+
+
+Features
+--------
+
+- Added ``armv7l`` wheels -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`5`.
+
+
+----
+
+
+0.0.0
+=====
+
+*(2024-10-02)*
+
+
+- Initial release.

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: propcache
-Version: 0.2.0
+Version: 0.3.0
 Summary: Accelerated property cache
 Home-page: https://github.com/aio-libs/propcache
 Author: Andrew Svetlov
@@ -24,7 +24,6 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Cython
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -32,7 +31,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: NOTICE
@@ -40,7 +39,7 @@ License-File: NOTICE
 propcache
 =========
 
-The module provides a fast implementation of cached properties for Python 3.8+.
+The module provides a fast implementation of cached properties for Python 3.9+.
 
 .. image:: https://github.com/aio-libs/propcache/actions/workflows/ci-cd.yml/badge.svg
   :target: https://github.com/aio-libs/propcache/actions?query=workflow%3ACI
@@ -152,6 +151,93 @@ Changelog
 
 .. towncrier release notes start
 
+0.3.0
+=====
+
+*(2025-02-20)*
+
+
+Features
+--------
+
+- Implemented support for the free-threaded build of CPython 3.13 -- by `@lysnikolaou <https://github.com/sponsors/lysnikolaou>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#84 <https://github.com/aio-libs/propcache/issues/84>`__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Started building wheels for the free-threaded build of CPython 3.13 -- by `@lysnikolaou <https://github.com/sponsors/lysnikolaou>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#84 <https://github.com/aio-libs/propcache/issues/84>`__.
+
+
+Contributor-facing changes
+--------------------------
+
+- GitHub Actions CI/CD is now configured to manage caching pip-ecosystem
+  dependencies using `re-actors/cache-python-deps`_ -- an action by
+  `@webknjaz <https://github.com/sponsors/webknjaz>`__ that takes into account ABI stability and the exact
+  version of Python runtime.
+
+  .. _`re-actors/cache-python-deps`:
+     https://github.com/marketplace/actions/cache-python-deps
+
+  *Related issues and pull requests on GitHub:*
+  `#93 <https://github.com/aio-libs/propcache/issues/93>`__.
+
+
+----
+
+
+0.2.1
+=====
+
+*(2024-12-01)*
+
+
+Bug fixes
+---------
+
+- Stopped implicitly allowing the use of Cython pre-release versions when
+  building the distribution package -- by `@ajsanchezsanz <https://github.com/sponsors/ajsanchezsanz>`__ and
+  `@markgreene74 <https://github.com/sponsors/markgreene74>`__.
+
+  *Related commits on GitHub:*
+  `64df0a6 <https://github.com/aio-libs/propcache/commit/64df0a6>`__.
+
+- Fixed ``wrapped`` and ``func`` not being accessible in the Cython versions of ``propcache.api.cached_property`` and ``propcache.api.under_cached_property`` decorators -- by `@bdraco <https://github.com/sponsors/bdraco>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#72 <https://github.com/aio-libs/propcache/issues/72>`__.
+
+
+Removals and backward incompatible breaking changes
+---------------------------------------------------
+
+- Removed support for Python 3.8 as it has reached end of life -- by `@bdraco <https://github.com/sponsors/bdraco>`__.
+
+  *Related issues and pull requests on GitHub:*
+  `#57 <https://github.com/aio-libs/propcache/issues/57>`__.
+
+
+Packaging updates and notes for downstreams
+-------------------------------------------
+
+- Stopped implicitly allowing the use of Cython pre-release versions when
+  building the distribution package -- by `@ajsanchezsanz <https://github.com/sponsors/ajsanchezsanz>`__ and
+  `@markgreene74 <https://github.com/sponsors/markgreene74>`__.
+
+  *Related commits on GitHub:*
+  `64df0a6 <https://github.com/aio-libs/propcache/commit/64df0a6>`__.
+
+
+----
+
+
 0.2.0
 =====
 

{propcache-0.2.0 → propcache-0.3.0}/README.rst

@@ -1,7 +1,7 @@
 propcache
 =========
 
-The module provides a fast implementation of cached properties for Python 3.8+.
+The module provides a fast implementation of cached properties for Python 3.9+.
 
 .. image:: https://github.com/aio-libs/propcache/actions/workflows/ci-cd.yml/badge.svg
   :target: https://github.com/aio-libs/propcache/actions?query=workflow%3ACI

{propcache-0.2.0 → propcache-0.3.0}/docs/spelling_wordlist.txt

@@ -1,5 +1,6 @@
 Bluesky
 Bugfixes
+CPython
 Changelog
 Codecov
 Cython

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

@@ -4,6 +4,7 @@
 from __future__ import annotations
 
 import os
+import sysconfig
 import typing as t
 from contextlib import contextmanager, nullcontext, suppress
 from functools import partial
@@ -11,7 +12,6 @@ from pathlib import Path
 from shutil import copytree
 from sys import implementation as _system_implementation
 from sys import stderr as _standard_error_stream
-from sys import version_info as _python_version_tuple
 from tempfile import TemporaryDirectory
 from warnings import warn as _warn_that
 
@@ -43,14 +43,12 @@ with suppress(ImportError):
     from Cython.Build.Cythonize import main as _cythonize_cli_cmd
 
 from ._compat import chdir_cm
-from ._cython_configuration import (  # noqa: WPS436
-    get_local_cython_config as _get_local_cython_config,
-)
+from ._cython_configuration import get_local_cython_config as _get_local_cython_config
 from ._cython_configuration import (
     make_cythonize_cli_args_from_config as _make_cythonize_cli_args_from_config,
 )
 from ._cython_configuration import patched_env as _patched_cython_env
-from ._transformers import sanitize_rst_roles  # noqa: WPS436
+from ._transformers import sanitize_rst_roles
 
 __all__ = (  # noqa: WPS410
     'build_sdist',
@@ -82,9 +80,6 @@ PURE_PYTHON_CONFIG_SETTING = 'pure-python'
 PURE_PYTHON_ENV_VAR = 'PROPCACHE_NO_EXTENSIONS'
 """Environment variable name toggle used to opt out of making C-exts."""
 
-IS_PY3_12_PLUS = _python_version_tuple[:2] >= (3, 12)
-"""A flag meaning that the current runtime is Python 3.12 or higher."""
-
 IS_CPYTHON = _system_implementation.name == "cpython"
 """A flag meaning that the current interpreter implementation is CPython."""
 
@@ -205,7 +200,7 @@ def _exclude_dir_path(
     """Prevent recursive directory traversal."""
     # This stops the temporary directory from being copied
     # into self recursively forever.
-    # Ref: https://github.com/aio-libs/propcache/issues/992
+    # Ref: https://github.com/aio-libs/yarl/issues/992
     visited_directory_subdirs_to_ignore = [
         subdir
         for subdir in _visited_dir_contents
@@ -377,10 +372,12 @@ def get_requires_for_build_wheel(
             stacklevel=999,
         )
 
-    c_ext_build_deps = [] if is_pure_python_build else [
-        'Cython >= 3.0.0b3' if IS_PY3_12_PLUS  # Only Cython 3+ is compatible
-        else 'Cython',
-    ]
+    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']
 
     return _setuptools_get_requires_for_build_wheel(
         config_settings=config_settings,

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

@@ -9,11 +9,8 @@ from sys import version_info as _python_version_tuple
 
 from expandvars import expandvars
 
-from ._compat import load_toml_from_string  # noqa: WPS436
-from ._transformers import (  # noqa: WPS436
-    get_cli_kwargs_from_config,
-    get_enabled_cli_flags_from_config,
-)
+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:

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

@@ -5,7 +5,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
 
 # Re-exporting PEP 517 hooks
-from ._backend import (  # type: ignore[assignment]  # noqa: WPS436
+from ._backend import (  # type: ignore[assignment]
     build_sdist,
     build_wheel,
     get_requires_for_build_wheel,
@@ -14,7 +14,7 @@ from ._backend import (  # type: ignore[assignment]  # noqa: WPS436
 
 with _suppress(ImportError):  # Only succeeds w/ setuptools implementing PEP 660
     # Re-exporting PEP 660 hooks
-    from ._backend import (  # type: ignore[assignment]  # noqa: WPS436
+    from ._backend import (  # type: ignore[assignment]
         build_editable,
         get_requires_for_build_editable,
         prepare_metadata_for_build_editable,

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

@@ -64,6 +64,7 @@ linetrace = "True"  # Implies `profile=True`
 
 [tool.cibuildwheel]
 build-frontend = "build"
+enable = ["cpython-freethreading"]
 before-test = [
   # NOTE: Attempt to have pip pre-compile PyYAML wheel with our build
   # NOTE: constraints unset. The hope is that pip will cache that wheel
@@ -91,3 +92,15 @@ pure-python = "false"
 
 [tool.cibuildwheel.windows]
 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.2.0 → propcache-0.3.0}/pytest.ini

@@ -2,6 +2,8 @@
 addopts =
   # `pytest-xdist`:
   --numprocesses=auto
+  # NOTE: the plugin disabled because it's slower with so few tests
+  --numprocesses=0
 
   # Show 10 slowest invocations:
   --durations=10
@@ -16,16 +18,14 @@ addopts =
   # https://docs.pytest.org/en/stable/doctest.html
   --doctest-modules
 
-  # Dump the test results in junit format:
-  # --junitxml=.test-results/pytest/results.xml
-
   # Pre-load the `pytest-cov` plugin early:
   -p pytest_cov
 
   # `pytest-cov`:
   --cov
-  --cov-context=test
   --cov-config=.coveragerc
+  --cov-context=test
+  --no-cov-on-fail
 
   # Fail on config parsing warnings:
   # --strict-config
@@ -73,6 +73,7 @@ norecursedirs =
   build
   dist
   docs
+  requirements
   venv
   virtualenv
   propcache.egg-info

propcache-0.3.0/requirements/codspeed.txt

@@ -0,0 +1,2 @@
+-r test.txt
+pytest-codspeed==3.2.0

propcache-0.3.0/requirements/cython-freethreading.txt

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

propcache-0.3.0/requirements/cython.txt

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

{propcache-0.2.0 → propcache-0.3.0}/requirements/dev.txt

@@ -1,2 +1,2 @@
--r test.txt
+-r codspeed.txt
 -r towncrier.txt

propcache-0.3.0/requirements/doc-spelling.txt

@@ -0,0 +1,2 @@
+-r doc.txt
+sphinxcontrib-spelling==8.0.1; platform_system!="Windows"  # We only use it in Azure CI

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

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

propcache-0.3.0/requirements/lint.txt

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

propcache-0.3.0/requirements/test-freethreading.txt

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

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

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

propcache-0.3.0/requirements/test.txt

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

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

@@ -36,7 +36,6 @@ classifiers =
 	Programming Language :: Cython
 	Programming Language :: Python
 	Programming Language :: Python :: 3
-	Programming Language :: Python :: 3.8
 	Programming Language :: Python :: 3.9
 	Programming Language :: Python :: 3.10
 	Programming Language :: Python :: 3.11
@@ -51,7 +50,7 @@ keywords =
 	propcache
 
 [options]
-python_requires = >=3.8
+python_requires = >=3.9
 package_dir = 
 	=src
 packages = 

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

@@ -1,10 +1,10 @@
 """propcache: An accelerated property cache for Python classes."""
 
-from typing import TYPE_CHECKING, List
+from typing import TYPE_CHECKING
 
 _PUBLIC_API = ("cached_property", "under_cached_property")
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 __all__ = ()
 
 # Imports have moved to `propcache.api` in 0.2.0+.
@@ -23,7 +23,7 @@ def _import_facade(attr: str) -> object:
     raise AttributeError(f"module '{__package__}' has no attribute '{attr}'")
 
 
-def _dir_facade() -> List[str]:
+def _dir_facade() -> list[str]:
     """Include the public API in the module's dir() output."""
     return [*_PUBLIC_API, *globals().keys()]
 

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

@@ -1,13 +1,5 @@
-# cython: language_level=3
-import sys
-import types
-
-if sys.version_info >= (3, 9):
-    GenericAlias = types.GenericAlias
-else:
-
-    def GenericAlias(cls):
-        return cls
+# cython: language_level=3, freethreading_compatible=True
+from types import GenericAlias
 
 
 cdef _sentinel = object()
@@ -21,7 +13,7 @@ cdef class under_cached_property:
 
     """
 
-    cdef object wrapped
+    cdef readonly object wrapped
     cdef object name
 
     def __init__(self, wrapped):
@@ -55,16 +47,16 @@ cdef class cached_property:
 
     """
 
-    cdef object wrapped
+    cdef readonly object func
     cdef object name
 
-    def __init__(self, wrapped):
-        self.wrapped = wrapped
+    def __init__(self, func):
+        self.func = func
         self.name = None
 
     @property
     def __doc__(self):
-        return self.wrapped.__doc__
+        return self.func.__doc__
 
     def __set_name__(self, owner, name):
         if self.name is None:
@@ -85,7 +77,7 @@ cdef class cached_property:
         cdef dict cache = inst.__dict__
         val = cache.get(self.name, _sentinel)
         if val is _sentinel:
-            val = self.wrapped(inst)
+            val = self.func(inst)
             cache[self.name] = val
         return val