coolname-hash 1.0.0

Human-readable deterministic pseudo-hash, based on coolname

For any int/str/bytes, return deterministic human-readable string generated by coolname.

>>> from coolname_hash import pseudohash_slug
>>> pseudohash_slug(123)
'ambrosial-amorphous-jackal-of-expertise'
>>> pseudohash_slug('qwerty')
'logical-ingenious-albatross-of-spirit'
>>> pseudohash_slug(b'\x00\x01\xFF')
'small-polar-mole-of-wholeness'

Get sequences instead of strings:

>>> from coolname_hash import pseudohash
>>> pseudohash('foobar')
['loud', 'gabby', 'finch', 'of', 'variation']

Pseudohash functions are stateless, thread-safe and don’t use the random module.

This package is a drop-in replacement for coolname, you can also import and use all of the ordinary functions like generate and generate_slug. You can create custom RandomGenerator as per documentation, and use pseudohash and pseudohash_slug methods.

WARNING: Random sequence varies from version to version of coolname, so make sure you pin version exactly in your project’s requirements file. You MUST include something like coolname_hash==1.0.0 or coolname_hash>=1.0,<2.0 in your project’s dependencies. Don’t specify coolname in your requirements file at all - coolname_hash always pins specific version of it. coolname version (except patches) only changes in major releases of coolname_hash.

If you care about consistency of pseudohashes across multiple executions of your application, the best practice is to add an import-time assert like this, with the actual pseudohash for 0:

from coolname_hash import pseudohash_slug
assert pseudohash_slug(0) == 'elusive-fabulous-sloth-of-wizardry'  # NEVER CHANGE THIS LINE: specific version of coolname_hash is required

Caveats for variable types:

• Same integer represented as int/str/bytes (e.g. 123, '123' and b'123') will yield the same result.

• Same text as bytes and str will yield the same result when encoded in UTF-8.

• Float/Decimal and Boolean values are not allowed (makes no sense anyway).

• None is not allowed, you should handle it explicitly in your code.