User-friendly ID

Collection of functions to randomly and securely generate commonly-used types of IDs.

Installation

Install from PyPI:

pip install user-friendly-id

Features

• Generate any length of random string, either cryptographically secure (slower) or not (faster)
• Generate IDs without without common confusables / homoglyphs (e.g lowercase "l" vs uppercase "i")
• Lowers chances of a curse word randomly appearing in IDs using same logic as Hashids library.

How to use?

from ufid import (
    generate_random_string,
    generate_random_lowercase_string,
    generate_random_digit_string,
    generate_base64_random_string,
    generate_base47_random_string,
    generate_user_friendly_id,
)

# Generate securely a random string of 10 characters of
# any lowercase/uppercase alphabet + digits
generate_random_string(length=10, secure=True)


# Generate a random string of 10 characters within a set of predefined chars
generate_random_string(length=10, allowed_chars='01')


# Shortcut of the above to only allow lowercase alphabet
generate_random_lowercase_string(length=10)


# Again, shortcut to get only digits
generate_random_digit_string(length=10)


# Generate youtube-like base64 random string
generate_base64_random_string(length=10)


# Generate a random string without common confusables / homoglyphs.
# To maximize number of combination allowed_chars is not settable.
# This gives a base47 string hence the name of the function

generate_base47_random_string(length=10)


# Generate a 'true' user-friendly ID. Opiniated to a secure settings, and default of
# 6 chars for about 10 billion combinations. Also excludes without confusables / homoglyphs
# but also adds an algorithm inspired by the popular Hashids library to lower chances of
# generating curse words

generate_user_friendly_id()
generate_user_friendly_id(length=10)

Tests

TODO