Environment Tooling¶
Tooling modules handle the injection of static analysis, testing frameworks, and continuous integration hooks. They safely deep-merge their configurations into existing host files like pyproject.toml.
-
Pre-Commit (
--pre-commit)The orchestration engine that binds all linting and formatting hooks. Evaluates your workspace, initializes
.gitif absent, and automatically executespre-commit install. -
Direnv (
--direnv)Scaffolds an
.envrcfile that automatically activates your virtual environment upon directory traversal and allows for non-tracked local variable overrides via.envrc.local.
Available Tooling Modules¶
| Tooling Module | CLI Flags | Description | Collision Markers |
|---|---|---|---|
| direnv | --direnv |
Scaffold a .envrc and evaluate the virtual environment | .envrc |
| MarkdownLint | -m, --markdownlint |
Scaffold a relaxed .markdownlint.yaml configuration | .markdownlint.yaml |
| Ruff | --ruff |
Scaffold Ruff linter and formatter | None |
| Mypy | --mypy |
Scaffold Mypy static type checker | None |
| Pytest | --pytest |
Scaffold Pytest testing framework | None |
| Pre-Commit | --pre-commit |
Scaffold pre-commit hooks and configuration | .pre-commit-config.yaml |