meshed.caching

Caching meshes

class meshed.caching.LazyProps

A class that makes all its attributes cached_property properties.

Example:

>>> class Klass(LazyProps):
...     a = 1
...     b = 2
...
...     # methods with one argument are cached
...     def c(self):
...         print("computing c...")
...         return self.a + self.b
...
...     d = lambda x: 4
...     e = LazyProps.Literal(lambda x: 4)
...
...     @LazyProps.Literal  # to mark that this method should not be cached
...     def method1(self):
...         return self.a * 7
...
...     # Methods with more than one argument are not cached
...     def method2(self, x):
...         return x + 1
...
...
>>> k = Klass()
>>> k.b
2
>>> k.c
computing c...
3
>>> k.c  # note that c is not recomputed
3
>>> k.d  # d, a lambda with one argument, is treated as a cached property
4
>>> k.e()  # e is marked as a literal so is not a cached property, so need to call
4
>>> k.method1()  # method1 has one argument, but marked as a literal
7
>>> k.method2(10)  # method2 has more than one argument, so is not a cached property
11

Literal

alias of LiteralVal

meshed.caching.add_cached_property(cls, method, attr_name=None)

Add a method as a cached property to a class.

meshed.caching.add_cached_property_from_func(cls, func, attr_name=None)

Add a function cached property to a class.

meshed.caching.set_cached_property_attr(obj, name, value)

Helper to set cached properties.

Reason: When adding cached_property dynamically (not just with the @cached_property) the name is not set correctly. This solves that.

meshed.caching.with_cached_properties(funcs)

A decorator to add cached properties to a class.