Registry / random-slugs

random-slugs

library1.0.4pypypi✓ verified 87d ago

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

github ↗package ↗

INSTALL

IMPORT

SIG · RANDOM-SLUGS

random-slugs

pythonv1.0.4

Install

1.6s avg

Import

37ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.0.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.036s · 17.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.038s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

generate_slug

✓ from random_slugs import generate_slug

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)

Debug

Known issues

gotchaDefault 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.

affects: all

deprecatedThe '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=...

affects: >=1.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'random_slugs'

Import path uses hyphen instead of underscore.

fix

Use: from random_slugs import generate_slug

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

Using a deprecated parameter name from early versions.

fix

Replace 'number' with 'include_numbers'.

Upgrade

Version history

1.0.4latest on PyPI · released May 26, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/fkapsahili/random-slugs ↗

packagehttps://pypi.org/project/random-slugs/ ↗