random-slugs

1.0.4 verified Mon Apr 27 auth: no python

A lightweight Python 3.9+ library for generating random slugs from a customizable 150-word vocabulary. Current version 1.0.4, stable release. Low cadence.

pip install random-slugs

Common errors

error ModuleNotFoundError: No module named 'random_slugs' ↓

cause Import path uses hyphen instead of underscore.

fix

Use: from random_slugs import generate_slug

error TypeError: generate_slug() got an unexpected keyword argument 'number' ↓

cause Using a deprecated parameter name from early versions.

fix

Replace 'number' with 'include_numbers'.

Warnings

gotcha Default vocabulary is only 150 words – slugs may repeat if generated many times. ↓

fix Provide a custom word list via generate_slug(words=['...', ...]) or extend the default list.

deprecated The 'number' parameter (typo) was present in early v1.0.0 dev versions; always use 'include_numbers' instead. ↓

fix Use include_numbers=... in place of number=...

Imports

generate_slug
```
from random_slugs import generate_slug
```

Quickstart

Generate a random slug using the default vocabulary.

from random_slugs import generate_slug

# Generate a random slug (e.g., 'blue-mountain-42')
slug = generate_slug()
print(slug)

# Customize separator and number inclusion
slug = generate_slug(separator='_', include_numbers=False)
print(slug)