Note that you can probably also use the python standard library hashlib

key_mangler has the sha1_mangle_key mangler that goes along with it and it's documented with key_mangler. but at the moment the paramlinks don't seem to be working so i can't link to the key mangler param, going to see what's up with that.

Although I (now) know that dogpile.cache has all the tools to make the memcached backend work, it still has to be configured. This use-case is broken by default -- with the fix requiring guessing the cause of the error and reading more docs. Shouldn't this library have as little gotchas as possible to facilitate new users and adoption? (still it's awesome that it exists at all)

I think you're referring specifically to the cache decorators. the keys stored by dogpile are the keys you give it directly if you are using the straight region API like get_or_create, get, etc., and certainly if I use a cache library and say, cache.set("my key", value), by default I'd expect it to use the key "my key" and not decide I want to hash it.

the function decorators are a special case and they also have their own function_key_generator parameter you can set.

This is all documented so I don't see the problem as beyond the CSS styling and perhaps some extra notes here and there. we certainly couldn't change this behavior by default right now even if we wanted.

another option is to have the function key decorators specifically emit a warning if key_mangler isn't set. does anyone have interest in doing a PR for this?