fig

Figlet ASCII art text generator with PNG export capabilities.

Minimum Requirements

• Python 3.12+
• uv

Recommended Requirements

• mise

Quickstart

# clone repo
git clone git@github.com:pythoninthegrass/fig.git
cd fig

# symlink to somewhere on path
ln -s $(pwd)/fig.py ~/.local/bin/fig

# run script
fig                                     # Run help (also accepts -h, --help)
fig preview slant                       # Preview slant font with default text
fig preview slant 'Hello'               # Preview slant font with custom text
fig generate slant 'Hello' out.png      # Generate PNG image
fig list                                # Show available fonts

Development

Clone the repo per Quickstart, then do the following:

# setup virtual environment (venv)
uv venv --python ">=3.12,<3.13"
uv pip install -r pyproject.toml --all-extras

# source venv
source .venv/bin/activate

# poke around

# run tests
uv run pytest -v

# run pre-commit hooks
uv run pre-commit run --all-files

# exit venv
deactivate

TODO

Outstanding tasks live in TODO.md

Further Reading

• FIGlet
• pyfiglet
• pictex