--- /tmp/python-oslo.cache-2.6.1-26yrbk58q/debian/python-oslo.cache-doc_2.6.1-2_all.deb +++ python-oslo.cache-doc_2.6.1-2_all.deb ├── file list │ @@ -1,3 +1,3 @@ │ -rw-r--r-- 0 0 0 4 2020-10-15 21:00:34.000000 debian-binary │ -rw-r--r-- 0 0 0 2832 2020-10-15 21:00:34.000000 control.tar.xz │ --rw-r--r-- 0 0 0 922944 2020-10-15 21:00:34.000000 data.tar.xz │ +-rw-r--r-- 0 0 0 922836 2020-10-15 21:00:34.000000 data.tar.xz ├── control.tar.xz │ ├── control.tar │ │ ├── ./control │ │ │ @@ -1,13 +1,13 @@ │ │ │ Package: python-oslo.cache-doc │ │ │ Source: python-oslo.cache │ │ │ Version: 2.6.1-2 │ │ │ Architecture: all │ │ │ Maintainer: Debian OpenStack │ │ │ -Installed-Size: 2407 │ │ │ +Installed-Size: 2405 │ │ │ Depends: libjs-sphinxdoc (>= 2.4.3-5~) │ │ │ Section: doc │ │ │ Priority: optional │ │ │ Homepage: https://launchpad.net/oslo │ │ │ Description: cache storage for Openstack projects - doc │ │ │ oslo.cache aims to provide a generic caching mechanism for OpenStack projects │ │ │ by wrapping the dogpile.cache library. The dogpile.cache library provides │ │ ├── ./md5sums │ │ │ ├── ./md5sums │ │ │ │┄ Files differ ├── data.tar.xz │ ├── data.tar │ │ ├── file list │ │ │ @@ -88,16 +88,16 @@ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/install/ │ │ │ -rw-r--r-- 0 root (0) root (0) 13427 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/install/index.html │ │ │ -rw-r--r-- 0 root (0) root (0) 844 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/objects.inv │ │ │ -rw-r--r-- 0 root (0) root (0) 16121 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/py-modindex.html │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/api/ │ │ │ -rw-r--r-- 0 root (0) root (0) 15566 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/api/modules.html │ │ │ --rw-r--r-- 0 root (0) root (0) 44928 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/api/oslo_cache.backends.html │ │ │ --rw-r--r-- 0 root (0) root (0) 45351 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/api/oslo_cache.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 44806 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/api/oslo_cache.backends.html │ │ │ +-rw-r--r-- 0 root (0) root (0) 43825 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/api/oslo_cache.html │ │ │ -rw-r--r-- 0 root (0) root (0) 13643 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/reference/index.html │ │ │ -rw-r--r-- 0 root (0) root (0) 12902 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/search.html │ │ │ -rw-r--r-- 0 root (0) root (0) 9730 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/searchindex.js │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/user/ │ │ │ -rw-r--r-- 0 root (0) root (0) 13082 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/user/history.html │ │ │ -rw-r--r-- 0 root (0) root (0) 13586 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/user/index.html │ │ │ -rw-r--r-- 0 root (0) root (0) 18018 2020-10-15 21:00:34.000000 ./usr/share/doc/python-oslo.cache-doc/html/user/usage.html │ │ ├── ./usr/share/doc/python-oslo.cache-doc/html/reference/api/oslo_cache.backends.html │ │ │ @@ -282,15 +282,15 @@ │ │ │ │ │ │
│ │ │

oslo_cache.backends.memcache_pool module

│ │ │

dogpile.cache backend that uses Memcached connection pool

│ │ │
│ │ │
│ │ │ class oslo_cache.backends.memcache_pool.ClientProxy(client_pool)
│ │ │ -

Bases: object

│ │ │ +

Bases: object

│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ class oslo_cache.backends.memcache_pool.PooledMemcachedBackend(arguments)
│ │ │

Bases: dogpile.cache.backends.memcached.MemcachedBackend

│ │ │

Memcached backend that does connection pooling.

│ │ ├── ./usr/share/doc/python-oslo.cache-doc/html/reference/api/oslo_cache.html │ │ │ @@ -110,15 +110,15 @@ │ │ │

You must call configure().

│ │ │

Inside your application code, decorate the methods that you want the results │ │ │ to be cached with a memoization decorator created with │ │ │ get_memoization_decorator(). This function takes a group name from the │ │ │ config. Register [group] caching and [group] cache_time options │ │ │ for the groups that your decorators use so that caching can be configured.

│ │ │

This library’s configuration options must be registered in your application’s │ │ │ -oslo_config.cfg.ConfigOpts instance. Do this by passing the ConfigOpts │ │ │ +oslo_config.cfg.ConfigOpts instance. Do this by passing the ConfigOpts │ │ │ instance to configure().

│ │ │

The library has special public value for nonexistent or expired keys called │ │ │ NO_VALUE. To use this value you should import it from oslo_cache.core:

│ │ │
from oslo_cache import core
│ │ │  NO_VALUE = core.NO_VALUE
│ │ │  
│ │ │
│ │ │ @@ -133,29 +133,29 @@ │ │ │ oslo_cache.core.configure(conf) │ │ │

Configure the library.

│ │ │

Register the required oslo.cache config options into an oslo.config CONF │ │ │ object.

│ │ │

This must be called before configure_cache_region().

│ │ │
│ │ │
Parameters
│ │ │ -

conf (oslo_config.cfg.ConfigOpts) – The configuration object.

│ │ │ +

conf (oslo_config.cfg.ConfigOpts) – The configuration object.

│ │ │
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ oslo_cache.core.configure_cache_region(conf, region)
│ │ │

Configure a cache region.

│ │ │

If the cache region is already configured, this function does nothing. │ │ │ Otherwise, the region is configured.

│ │ │
│ │ │
Parameters
│ │ │
    │ │ │ -
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │ +
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │
  • region (dogpile.cache.region.CacheRegion) – Cache region to configure (see create_region()).

  • │ │ │
│ │ │
│ │ │
Raises
│ │ │

oslo_cache.exception.ConfigurationError – If the region parameter is │ │ │ not a dogpile.cache.CacheRegion.

│ │ │
│ │ │ @@ -228,15 +228,15 @@ │ │ │ def function2(arg1, arg2): │ │ │ ... │ │ │
│ │ │ │ │ │
│ │ │
Parameters
│ │ │
    │ │ │ -
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │ +
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │
  • region (dogpile.cache.region.CacheRegion) – region as created by create_region().

  • │ │ │
  • group (string) – name of the configuration group to examine

  • │ │ │
  • expiration_group (string) – name of the configuration group to examine │ │ │ for the expiration option. This will fall back to │ │ │ using group if the value is unspecified or │ │ │ None

  • │ │ │
│ │ │ @@ -249,22 +249,22 @@ │ │ │ │ │ │ │ │ │
│ │ │

oslo_cache.exception module

│ │ │
│ │ │
│ │ │ exception oslo_cache.exception.ConfigurationError
│ │ │ -

Bases: Exception

│ │ │ +

Bases: Exception

│ │ │

Raised when the cache isn’t configured correctly.

│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ exception oslo_cache.exception.QueueEmpty
│ │ │ -

Bases: Exception

│ │ │ +

Bases: Exception

│ │ │

Raised when a connection cannot be acquired.

│ │ │
│ │ │ │ │ │
│ │ │
│ │ │

oslo_cache.testing module

│ │ │

Items useful for external testing.

│ │ │ @@ -319,29 +319,29 @@ │ │ │ oslo_cache.configure(conf) │ │ │

Configure the library.

│ │ │

Register the required oslo.cache config options into an oslo.config CONF │ │ │ object.

│ │ │

This must be called before configure_cache_region().

│ │ │
│ │ │
Parameters
│ │ │ -

conf (oslo_config.cfg.ConfigOpts) – The configuration object.

│ │ │ +

conf (oslo_config.cfg.ConfigOpts) – The configuration object.

│ │ │
│ │ │
│ │ │
│ │ │ │ │ │
│ │ │
│ │ │ oslo_cache.configure_cache_region(conf, region)
│ │ │

Configure a cache region.

│ │ │

If the cache region is already configured, this function does nothing. │ │ │ Otherwise, the region is configured.

│ │ │
│ │ │
Parameters
│ │ │
    │ │ │ -
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │ +
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │
  • region (dogpile.cache.region.CacheRegion) – Cache region to configure (see create_region()).

  • │ │ │
│ │ │
│ │ │
Raises
│ │ │

oslo_cache.exception.ConfigurationError – If the region parameter is │ │ │ not a dogpile.cache.CacheRegion.

│ │ │
│ │ │ @@ -414,15 +414,15 @@ │ │ │ def function2(arg1, arg2): │ │ │ ... │ │ │ │ │ │ │ │ │
│ │ │
Parameters
│ │ │
    │ │ │ -
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │ +
  • conf (oslo_config.cfg.ConfigOpts) – config object, must have had configure() called on it.

  • │ │ │
  • region (dogpile.cache.region.CacheRegion) – region as created by create_region().

  • │ │ │
  • group (string) – name of the configuration group to examine

  • │ │ │
  • expiration_group (string) – name of the configuration group to examine │ │ │ for the expiration option. This will fall back to │ │ │ using group if the value is unspecified or │ │ │ None

  • │ │ │