scratch

A small Python command-line tool, set up as a src/-layout package with tests and CI.

Install

Editable install into a virtual environment:

python -m venv .venv
source .venv/Scripts/activate  # Windows PowerShell: .venv\Scripts\Activate.ps1
pip install -e ".[dev]"

Usage

scratch greet
scratch greet Ada
scratch greet Ada --shout
scratch --version

It also runs without installing the entry point:

python -m scratch greet Ada

Development

pytest
ruff check .

CI runs both on every push and pull request against Python 3.10–3.13.

Layout

src/scratch/     package code (cli.py holds the argparse interface)
tests/           pytest suite
.github/workflows/ci.yml

License

MIT — see LICENSE.