dogpile.cache / dogpile / cache /

Diff from to


      is the SHA1 mangler found at :func:`.sha1_mangle_key`
      which coerces keys into a SHA1
      hash, so that the string length is fixed.  To
-     disable all key mangling, set to ``False``.
+     disable all key mangling, set to ``False``.   Another typical 
+     mangler is the built-in Python function `str` , which can be used
+     to convert keys to strings.  This can be necessary in situations 
+     where `dogpile.cache` is used with a Framework that defaults to 
+     unicode strings ( such as `Pyramid` ) and a backend that requires
+     byte-strings ( such as bsddb or dbm under Python 2.x ).  Passing 
+     unicode arguments into a cached action will create a TypeError 
+     without an appropriate `key_mangler`.
     :param async_creation_runner:  A callable that, when specified,
      will be passed to and called by dogpile.lock when