philiprehberger-randstr 0.1.6

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"

All generators use the secrets module for cryptographic security.

API

• randstr(length=16, charset="alphanumeric") — Random string from charset
• token(length=32) — URL-safe base64 token
• password(length=16, symbols, min_symbols, min_digits, min_upper) — Strong password
• hex_str(length=16) — Random hex string
• uuid_short(length=8) — Short UUID-like hex ID

Development

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

License

MIT