Excuse Generator

Generate a random excuse from a category and an absurdity level. The same package is a small Python library and a pipe-friendly command.

The PyPI name is lupaxa-excuse-generator. The import path is lupaxa.excuse_generator. The console script is excuse-generator. lupaxa is a namespace package — there is no lupaxa/__init__.py.

Public names: get_excuse, get_excuses, get_blame, Category, Level, ExcuseError, InvalidCategoryError, InvalidLevelError, ExcuseDataError, __version__, get_version().

Friday excuses are a normal category. Ask for them with --category friday. The tool does not look at the date.

Install

pip install lupaxa-excuse-generator

Requires Python 3.10+. The standard library is enough.

CLI

excuse-generator
excuse-generator --category coding --level questionable
excuse-generator --count 5
excuse-generator --blame
excuse-generator --seed 42
excuse-generator --version

One excuse is printed per line. There is no banner.

--blame cannot be combined with --category, --level, or --count. --categories and --levels cannot be combined with each other or with generation options.

python -m lupaxa.excuse_generator --category friday

Library

from lupaxa.excuse_generator import get_blame, get_excuse, get_excuses

get_excuse(category="coding", level="absurd")
get_excuses(5, category="meeting")
get_blame()

Pass rng=random.Random(seed) when a test needs the same result twice. That object is the only random state the library uses.

Excuses live in data/excuses.json. Blame lives in data/blame.json.

Development

make init
make python-install-dev
make python-check