propcache

Warnings

• breaking Version 0.4.0 was yanked due to a reference leak caused by improper reference counting in Cython.
  Fix: Upgrade to version 0.4.1 or later, where the issue has been resolved.
• gotcha propcache's under_cached_property uses self._cache instead of self.__dict__ to store cached values, which may lead to unexpected behavior if self._cache is not properly managed.
  Fix: Ensure that self._cache is correctly initialized and managed within your class when using under_cached_property.

Install

• pip install propcache Install propcache

Imports

• cached_property

  from propcache import cached_property

  propcache provides an optimized version of cached_property; using functools.cached_property will not leverage these optimizations.
• under_cached_property

  from propcache import under_cached_property

  under_cached_property is a unique feature of propcache and is not available in functools.

Quickstart

This example demonstrates how to use propcache's cached_property to cache the result of an expensive computation in a class property.

from propcache import cached_property

class MyClass:
    def __init__(self, value):
        self._value = value

    @cached_property
    def computed_property(self):
        # Expensive computation
        return self._value * 2

obj = MyClass(10)
print(obj.computed_property)  # Outputs: 20