summaryrefslogtreecommitdiff
path: root/docs/build/unreleased/236.rst
diff options
context:
space:
mode:
authorSimon Hewitt <simon@archera.ai>2023-04-18 18:42:59 -0400
committerMike Bayer <mike_mp@zzzcomputing.com>2023-04-25 13:15:23 -0400
commite3187d80896078fdd03377a374978f42e8ad28ec (patch)
tree569171014b9e161fc4cc36b736ad9cf372a4a5e1 /docs/build/unreleased/236.rst
parent0fe5b17957a4417fa39ccd038bd861c097d5b896 (diff)
downloaddogpile-cache-e3187d80896078fdd03377a374978f42e8ad28ec.tar.gz
handle CantDeserializeException raised from deserialize method
Added new construct :class:`.api.CantDeserializeException` which can be raised by user-defined deserializer functions which would be passed to :paramref:`.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. Closes: #236 Pull-request: https://github.com/sqlalchemy/dogpile.cache/pull/236 Pull-request-sha: f2ec26521acb8069d092c51749952f8540b5d75c Change-Id: Idec175b9c06274628d3d027024f9878abb1d188b
Diffstat (limited to 'docs/build/unreleased/236.rst')
-rw-r--r--docs/build/unreleased/236.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/build/unreleased/236.rst b/docs/build/unreleased/236.rst
new file mode 100644
index 0000000..ebd06bd
--- /dev/null
+++ b/docs/build/unreleased/236.rst
@@ -0,0 +1,11 @@
+.. change::
+ :tags: feature, region
+ :tickets: 236
+
+ Added new construct :class:`.api.CantDeserializeException` which can be
+ raised by user-defined deserializer functions which would be passed to
+ :paramref:`.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.