makefile
Complete reference for all make targets in the project. Use when: looking up the right make command for any task — setup, testing, linting, formatting, database, packaging, or cleanup.
来源信息
- 仓库
- tedivm/robs_awesome_python_template_examples
- 最近来源活动
- 2026年5月18日 12:11
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 16
- Forks
- 1
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- makefile
- description
- Complete reference for all make targets in the project. Use when: looking up the right make command for any task — setup, testing, linting, formatting, database, packaging, or cleanup.
# Makefile Reference
All developer tasks are exposed as `make` targets. Run from the project root.
---
## Setup
| Target | What it does |
| ------------- | --------------------------------------------------------------- |
| `make install` | Install Python deps, create `.venv` (first-time setup) |
| `make sync` | Sync Python deps with `uv.lock` (after pulling changes) |
| `make pre-commit` | Install pre-commit hooks |
| `make lock` | Upgrade and relock all dependencies |
| `make lock-check` | Verify lock file is up to date without changing it |
---
## Testing
| Target | What it does |
| --------------- | ----------------------------------------------------------------- |
| `make tests` | Run **everything**: pytest, ruff, black, mypy, prettier, TOML formatting |
| `make pytest` | Run pytest with coverage report |
| `make pytest_loud` | Run pytest with `DEBUG` log output enabled |
---
## Code Quality Checks
These check only — they do not auto-fix.
| Target | What it checks |
| ------------------------------- | ------------------------------------------------- |
| `make ruff_check` | Ruff linter |
| `make black_check` | Ruff formatter (black style) |
| `make mypy_check` | Type checking (mypy) |
| `make prettier_check` | Markdown, JSON, YAML, TOML formatting (prettier) |
| `make tomlsort_check` | TOML file formatting (tombi) |
---
## Code Formatting (Auto-fix)
| Target | What it fixes |
| ------------------------ | ------------------------------------------------------ |
| `make chores` | Run **all** auto-fixes: ruff, format, prettier, TOML |
| `make ruff_fixes` | Auto-fix ruff lint issues |
| `make black_fixes` | Auto-format Python code (black style via ruff) |
| `make prettier_fixes` | Auto-format markdown/JSON/YAML/TOML |
| `make tomlsort_fixes` | Auto-format TOML files (tombi) |
**Typical workflow before committing:** `make chores && make tests`
---
## Packaging
| Target | What it does |
| ------------------ | --------------------------------------------- |
| `make build` | Build Python package distribution (sdist + wheel) |
---
## Quick Reference by Task
| I want to… | Run |
| ----------------------------------------- | ------------------------------------ |
| Set up for the first time | `make install` |
| Run all tests before a PR | `make tests` |
| Fix all formatting issues | `make chores` |
| Check types only | `make mypy_check` |
| Run only Python tests with verbose output | `make pytest_loud` |
| Update dependencies | `make lock && make sync` |
---
## Further Reading
- [docs/dev/makefile.md](../../docs/dev/makefile.md) — Full makefile developer guide with detailed explanations of every target, shell autocomplete setup, and usage examples.
在 GitHub 查看