class trytond.cache.Cache(name[, size_limit[, duration[, context]]])

The class is used to cache values between server requests. The name should be unique and it’s used to identify the cache. We usually use <class_name>.<content_name> to make it unique. The size_limit parameter can be used to limit the number of values cached and it has 1024 as the default value. The duration parameter defines how long a cached value stays valid but if it is not set the value remains valid until it is cleared. And the context parameter is used to indicate if the cache depends on the user context and is true by default. The cache is cleaned on Transaction starts and resets on Transaction commit or rollback.


As there is no deepcopy of the values cached, they must never be mutated after being set in or retrieved from the cache.


Count the number of times the cache returned a cached value.


Count the number of times the cache did not contain the key.

classmethod trytond.cache.stats()

Yield statistics for each instance.

trytond.cache.get(key[, default])

Retrieve the value of the key in the cache. If a default is specified it will be returned when the key is missing otherwise it will return None.

trytond.cache.set(key, value)

Sets the value of the key in the cache.


Clears all the keys in the cache.

classmethod trytond.cache.clear_all()

Clears all cache instances.

classmethod trytond.cache.sync(transaction)

Synchronize cache instances using transaction.


Return True if the last synchronization was done before value.

classmethod trytond.cache.commit(transaction)

Apply cache changes from transaction.

classmethod trytond.cache.rollback(transaction)

Remove cache changes from transaction.

classmethod trytond.cache.drop(dbname)

Drops all the caches for database dbname


By default Tryton uses a MemoryCache, but this behaviour can be overridden by setting a fully qualified name of an alternative class defined in the configuration class of the cache section.