A small library for obfuscating integer values to key strings using a set length and alphabet.
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') # 1234567890
To 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
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) # 0cpqVJ
If you wish to generate a prime not within the golden prime set, you can overwrite the
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) # RP
There 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) #022d43
If 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
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.