Minimal guide for contributing to and developing MoralStack.
pip install -e .[dev]- pytest — Run tests:
pytest - ruff — Linting and formatting:
ruff check ./ruff format . - black — Format check:
black --check .(orblack .to reformat) - mypy — Type checking:
mypy moralstack
Pre-commit hooks run cheap checks (format, lint, whitespace) automatically before every commit.
Setup (one-time):
pip install pre-commit # included in .[dev]
pre-commit installManual run on all files:
pre-commit run --all-filesSkip hooks (discouraged):
git commit --no-verifyActive hooks: trailing-whitespace, end-of-file-fixer, ruff check --fix, black.
The workflow in .github/workflows/ci.yml runs tests on Python 3.11 and 3.12 with pip install -e .[dev] and pytest.
The logs/, reports/ and .pytest_cache/ folders are generated at runtime and are in .gitignore. They should not
be committed.