philiprehberger-randstr 0.3.0

Generate random readable strings for various purposes.

philiprehberger-randstr

Generate random readable strings for various purposes.

Installation

pip install philiprehberger-randstr

Usage

Random Strings

from philiprehberger_randstr import randstr

randstr(16)                       # "aBx4kLm9pQrS2tUv"
randstr(8, charset="lowercase")   # "abcdefgh"

Tokens and Passwords

from philiprehberger_randstr import token, password

token(32)       # URL-safe base64 token
password(16)    # "aB3$kLm!9pQr#2tU"

Hex and Short IDs

from philiprehberger_randstr import hex_str, uuid_short

hex_str(16)     # "a1b2c3d4e5f6a7b8"
uuid_short()    # "7f3a8b2c"

Readable IDs

readable_id excludes visually-confusable characters (0, 1, O, o, I, l) — useful for vouchers, short references, and any human-typed code.

from philiprehberger_randstr import readable_id

readable_id(8)   # e.g. "K7P4MNXR" — never contains 0/1/O/o/I/l

Numeric PINs

from philiprehberger_randstr import pin

pin()       # e.g. "478392"  — 6-digit default
pin(4)      # e.g. "2057"

URL-safe slugs

slug draws from the lowercase visually-unambiguous alphanumeric charset (excludes 0, 1, l, o) — ideal for short shareable URLs.

from philiprehberger_randstr import slug

slug()      # e.g. "k7p4mnxr"
slug(12)    # e.g. "h3jq8mt2nrpw"

All generators use the secrets module for cryptographic security.

API

Function / Class	Description
randstr(length=16, charset="alphanumeric")	Random string from a built-in or custom charset
token(length=32)	URL-safe base64-encoded token
password(length=16, symbols, min_symbols, min_digits, min_upper)	Strong password with guaranteed character-class diversity
hex_str(length=16)	Random lowercase hex string
uuid_short(length=8)	Short UUID-like hex ID
readable_id(length=8)	Random ID drawn from a visually-unambiguous alphabet
pin(length=6)	Cryptographically-strong numeric PIN of digits
slug(length=8)	Short URL-safe slug from the lowercase visually-unambiguous charset

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT