Add qa command entrypoints

This commit is contained in:
Abel Luck 2026-03-31 12:52:59 +02:00
parent f3f4badaa2
commit e796e09d14
4 changed files with 111 additions and 5 deletions

View file

@ -87,17 +87,16 @@ The state passed to a render-fn should be thought of as `{persistent db state, e
- Enter the dev environment with `nix develop` if you are not already inside it
- Sync Python dependencies with `uv sync --all-groups`.
- Run the app with `uv run repub`.
- Run `uv run qa` often while working. It runs Tailwind CSS generation, `black`, `flake8`, `pyright`, and the full test suite in that order.
- Run `uv run qa-final` at the end before declaring a task complete and always before staging or committing. It runs `uv run qa`, then `nix fmt`, then `nix flake check`.
- Generate CSS with `tailwindcss -i ./repub/static/app.tailwind.css -o ./repub/static/app.css` and add `--watch` when you need live rebuilds.
- Validate a generated feed with `./scripts/validate-feed path/to/feed.rss`. This wraps the local checkout at `~/src/github.com/w3c/feedvalidator` and pages the validator output through `less` by default.
```sh
uv sync --all-groups
uv run pytest
uv run flake8 repub/ tests/
uv run pyright
uv run qa
./scripts/validate-feed out/feeds/mn-cuba/feed.rss
nix fmt
nix flake check
uv run qa-final
uv run repub
uv run repub crawl -c repub.toml
```