Taking lessons learned from supporting BaseHash over the years, it was obvious that it could be optimized, thus Obfuskey was born. BaseHash had some misconceptions, mainly that consumers thought it was a crypto library due to the word "hash". Since a hashes are generally irreversible, this new project was born to clearly convey what it is used for.
Obfuskey was a way to both modernize and simplify BaseHash, while keeping the same functionality. Obfuskey generates obfuscated keys out of integer values that have a uniform length using a specified alphabet. It was built solely for Python 3.6 and up. There are no guarantees that it will work for lower versions. If you need this for a lower version, please use BaseHash.
When generating keys, the combination of key length and alphabet used will determine the
maximum value it can obfuscate, len(alphabet) ** key_length - 1.
To use Obfuskey, you can use one of the available alphabets, or provide your own. You can also provide your own multiplier, or leave it blank to use the built-in prime generator.
from obfuskey import Obfuskey, alphabets
obfuscator = Obfuskey(alphabets.BASE36, key_length=8)
key = obfuscator.get_key(1234567890) # FWQ8H52I
value = obfuscator.get_value('FWQ8H52I') # 1234567890To provide a custom multiplier, or if you to provide the prime generated from a
previous instance, you can pass it in with multiplier=. This value has to be an odd
integer.
from obfuskey import Obfuskey, alphabets
obfuscator = Obfuskey(alphabets.BASE62)
key = obfuscator.get_key(12345) # d2Aasl
obfuscator = Obfuskey(alphabets.BASE62, multiplier=46485)
key = obfuscator.get_key(12345) # 0cpqVJIf you wish to generate a prime not within the golden prime set, you can overwrite the
multiplier with set_prime_multiplier.
from obfuskey import Obfuskey, alphabets
obfuscator = Obfuskey(alphabets.BASE62, key_length=2)
key = obfuscator.get_key(123) # 3f
obfuscator.set_prime_multiplier(1.75)
key = obfuscator.get_key(123) # RPThere are predefined alphabets that you can use, but Obfuskey allows you to specify a custom one during instantiation.
from obfuskey import Obfuskey
obfuscator = Obfuskey('012345abcdef')
key = obfuscator.get_key(123) #022d43If you need to obfuscate integers that are larger than 512-bit, you will need to also have gmp2 installed.
$ pip install gmpy2
OR
poetry install -E gmpy2