1.3.3

1.3.3

Released: Sun May 5 2024

usecase

• [usecase] [memcached] Added support for an additional pymemcached client parameter
  PyMemcacheBackend.memcached_expire_time. Pull request
  courtesy Takashi Kajinami.

bug

• [bug] [typing] Fixed the return type for CacheRegion.get(), which was inadvertently
  hardcoded to use CacheReturnType that only resolved to CachedValue
  or NoValue. Fixed to return ValuePayload which resolves to
  Any, as well as a new literal indicating an enum constant for
  :data:.api.NO_VALUE. The :data:.api.NO_VALUE constant remains
  available as the single element of this enum.

  Unknown interpreted text role "data".

  Unknown interpreted text role "data".

1.3.2

1.3.2

Released: Wed Feb 21 2024

usecase

• [usecase] [redis] Added a new backend RedisClusterBackend, allowing support for
  Redis Cluster. Pull request courtesy Maël Naccache Tüfekçi.

  References: #250

• [usecase] [redis] Added support for additional Redis client parameters
  RedisBackend.socket_connect_timeout,
  RedisBackend.socket_keepalive and
  RedisBackend.socket_keepalive_options. Pull request courtesy
  Takashi Kajinami.

  References: #252

1.3.1

1.3.1

Released: Wed Feb 7 2024

usecase

• [usecase] [redis] Added new parameter RedisBackend.username to the Redis
  backend, and RedisSentinelBackend.username to the Redis
  Sentinel backend. These parameters allow for username authentication in
  Redis when RBAC is enabled. Pull request courtesy Takashi Kajinami.

1.3.0

1.3.0

Released: Wed Dec 20 2023

feature

• [feature] [region] Added new method CacheRegion.get_value_metadata() which can be used
  to get a value from the cache along with its metadata, including timestamp
  of when the value was cached. The CachedValue object is returned
  which features new accessors to retrieve cached time and current age. Pull
  request courtesy Grégoire Deveaux.

  References: #37

misc

• [change] [setup] Minimum Python version is now Python 3.8; prior versions Python 3.7 and 3.6
  are EOL.

• [change] [setup] Project setup is now based on pep-621 pyproject.toml configuration.

1.2.2

1.2.2

Released: Sat Jul 8 2023

bug

• [bug] [typing] Made use of pep-673 Self type for method chained methods such as
  CacheRegion.configure() and ProxyBackend.wrap(). Pull request
  courtesy Viicos.

  References: #240

1.2.1

1.2.1

Released: Sat May 20 2023

bug

• [bug] [typing] Added py.typed file to root so that typing tools such as Mypy recognize
  dogpile as typed. Pull request courtesy Daverball.

  References: #238

1.2.0

1.2.0

Released: Wed Apr 26 2023

feature

• [feature] [region] Added new construct api.CantDeserializeException which can be
  raised by user-defined deserializer functions which would be passed to
  CacheRegion.deserializer, to indicate a cache value that can't
  be deserialized and therefore should be regenerated. This can allow an
  application that's been updated to gracefully re-cache old items that were
  persisted from a previous version of the application. Pull request courtesy
  Simon Hewitt.

  References: #236

1.1.8

1.1.8

Released: Fri Jul 8 2022

bug

• [bug] [memcached] Moved the MemcacheArgs.dead_retry argument and the
  MemcacheArgs.socket_timeout argument which were
  erroneously added to the "set_parameters",
  where they have no effect, to be part of the Memcached connection
  arguments MemcachedBackend.dead_retry,
  MemcachedBackend.socket_timeout.

  References: #223, #228

1.1.7

1.1.7

Released: Tue Jul 5 2022

usecase

• [usecase] [memcached] Added MemcacheArgs.dead_retry and
  MemcacheArgs.socket_timeout to the dictionary of
  additional keyword arguments that will be passed
  directly to GenericMemcachedBackend().

  References: #223

1.1.6

1.1.6

Released: Fri Jun 10 2022

usecase

• [usecase] [redis] Added RedisBackend.connection_kwargs parameter, which is a
  dictionary of additional keyword arguments that will be passed directly to
  StrictRedis() or StrictRedis.from_url(), in the same way that this
  parameter works with the RedisSentinelBackend already.

  References: #221

bug

• [bug] [redis] Fixed regression caused by backwards-incompatible API changes in Redis that
  caused the "distributed lock" feature to not function.

  References: #220