[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-trail-of-bits-modern-python":3,"mdc-vyajo9-key":32,"related-repo-trail-of-bits-modern-python":3073,"related-org-trail-of-bits-modern-python":3173},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":27,"sourceUrl":30,"mdContent":31},"modern-python","configure modern Python projects","Configures Python projects with modern tooling (uv, ruff, ty). Use when creating projects, writing standalone scripts, or migrating from pip\u002FPoetry\u002Fmypy\u002Fblack.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"trail-of-bits","Trail of Bits","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Ftrail-of-bits.png","trailofbits",[13,17],{"name":14,"slug":15,"type":16},"Configuration","configuration","tag",{"name":18,"slug":19,"type":16},"Python","python",6139,"https:\u002F\u002Fgithub.com\u002Ftrailofbits\u002Fskills","2026-07-17T06:05:27.014948",null,541,[26],"agent-skills",{"repoUrl":21,"stars":20,"forks":24,"topics":28,"description":29},[26],"Trail of Bits Claude Code skills for security research, vulnerability detection, and audit workflows","https:\u002F\u002Fgithub.com\u002Ftrailofbits\u002Fskills\u002Ftree\u002FHEAD\u002Fplugins\u002Fmodern-python\u002Fskills\u002Fmodern-python","---\nname: modern-python\ndescription: Configures Python projects with modern tooling (uv, ruff, ty). Use when creating projects, writing standalone scripts, or migrating from pip\u002FPoetry\u002Fmypy\u002Fblack.\n---\n\n# Modern Python\n\nGuide for modern Python tooling and best practices, based on [trailofbits\u002Fcookiecutter-python](https:\u002F\u002Fgithub.com\u002Ftrailofbits\u002Fcookiecutter-python).\n\n## When to Use This Skill\n\n- Creating a new Python project or package\n- Setting up `pyproject.toml` configuration\n- Configuring development tools (linting, formatting, testing)\n- Writing Python scripts with external dependencies\n- Migrating from legacy tools (when user requests it)\n\n## When NOT to Use This Skill\n\n- **User wants to keep legacy tooling**: Respect existing workflows if explicitly requested\n- **Python \u003C 3.11 required**: These tools target modern Python\n- **Non-Python projects**: Mixed codebases where Python isn't primary\n\n## Anti-Patterns to Avoid\n\n| Avoid | Use Instead |\n|-------|-------------|\n| `[tool.ty]` python-version | `[tool.ty.environment]` python-version |\n| `uv pip install` | `uv add` and `uv sync` |\n| Editing pyproject.toml manually to add deps | `uv add \u003Cpkg>` \u002F `uv remove \u003Cpkg>` |\n| `hatchling` build backend | `uv_build` (simpler, sufficient for most cases) |\n| Poetry | uv (faster, simpler, better ecosystem integration) |\n| requirements.txt | PEP 723 for scripts, pyproject.toml for projects |\n| mypy \u002F pyright | ty (faster, from Astral team) |\n| `[project.optional-dependencies]` for dev tools | `[dependency-groups]` (PEP 735) |\n| Manual virtualenv activation (`source .venv\u002Fbin\u002Factivate`) | `uv run \u003Ccmd>` |\n| pre-commit | prek (faster, no Python runtime needed) |\n\n**Key principles:**\n- Always use `uv add` and `uv remove` to manage dependencies\n- Never manually activate or manage virtual environments—use `uv run` for all commands\n- Use `[dependency-groups]` for dev\u002Ftest\u002Fdocs dependencies, not `[project.optional-dependencies]`\n\n## Decision Tree\n\n```\nWhat are you doing?\n│\n├─ Single-file script with dependencies?\n│   └─ Use PEP 723 inline metadata (.\u002Freferences\u002Fpep723-scripts.md)\n│\n├─ New multi-file project (not distributed)?\n│   └─ Minimal uv setup (see Quick Start below)\n│\n├─ New reusable package\u002Flibrary?\n│   └─ Full project setup (see Full Setup below)\n│\n└─ Migrating existing project?\n    └─ See Migration Guide below\n```\n\n## Tool Overview\n\n| Tool | Purpose | Replaces |\n|------|---------|----------|\n| **uv** | Package\u002Fdependency management | pip, virtualenv, pip-tools, pipx, pyenv |\n| **ruff** | Linting AND formatting | flake8, black, isort, pyupgrade, pydocstyle |\n| **ty** | Type checking | mypy, pyright (faster alternative) |\n| **pytest** | Testing with coverage | unittest |\n| **prek** | Pre-commit hooks ([setup](.\u002Freferences\u002Fprek.md)) | pre-commit (faster, Rust-native) |\n\n### Security Tools\n\n| Tool | Purpose | When It Runs |\n|------|---------|--------------|\n| **shellcheck** | Shell script linting | pre-commit |\n| **detect-secrets** | Secret detection | pre-commit |\n| **actionlint** | Workflow syntax validation | pre-commit, CI |\n| **zizmor** | Workflow security audit | pre-commit, CI |\n| **pip-audit** | Dependency vulnerability scanning | CI, manual |\n| **Dependabot** | Automated dependency updates | scheduled |\n\nSee [security-setup.md](.\u002Freferences\u002Fsecurity-setup.md) for configuration and usage.\n\n## Quick Start: Minimal Project\n\nFor simple multi-file projects not intended for distribution:\n\n```bash\n# Create project with uv\nuv init myproject\ncd myproject\n\n# Add dependencies\nuv add requests rich\n\n# Add dev dependencies\nuv add --group dev pytest ruff ty\n\n# Run code\nuv run python src\u002Fmyproject\u002Fmain.py\n\n# Run tools\nuv run pytest\nuv run ruff check .\n```\n\n## Full Project Setup\nIf starting from scratch, ask the user if they prefer to use the Trail of Bits cookiecutter template to bootstrap a complete project with already preconfigured tooling.\n\n```bash\nuvx cookiecutter gh:trailofbits\u002Fcookiecutter-python\n```\n\n### 1. Create Project Structure\n\n```bash\nuv init --package myproject\ncd myproject\n```\n\nThis creates:\n```\nmyproject\u002F\n├── pyproject.toml\n├── README.md\n├── src\u002F\n│   └── myproject\u002F\n│       └── __init__.py\n└── .python-version\n```\n\n### 2. Configure pyproject.toml\n\nSee [pyproject.md](.\u002Freferences\u002Fpyproject.md) for complete configuration reference.\n\nKey sections:\n```toml\n[project]\nname = \"myproject\"\nversion = \"0.1.0\"\nrequires-python = \">=3.11\"\ndependencies = []\n\n[dependency-groups]\ndev = [{include-group = \"lint\"}, {include-group = \"test\"}, {include-group = \"audit\"}]\nlint = [\"ruff\", \"ty\"]\ntest = [\"pytest\", \"pytest-cov\"]\naudit = [\"pip-audit\"]\n\n[tool.ruff]\nline-length = 100\ntarget-version = \"py311\"\n\n[tool.ruff.lint]\nselect = [\"ALL\"]\nignore = [\"D\", \"COM812\", \"ISC001\"]\n\n[tool.pytest]\naddopts = [\"--cov=myproject\", \"--cov-fail-under=80\"]\n\n[tool.ty.terminal]\nerror-on-warning = true\n\n[tool.ty.environment]\npython-version = \"3.11\"\n\n[tool.ty.rules]\n# Strict from day 1 for new projects\npossibly-unresolved-reference = \"error\"\nunused-ignore-comment = \"warn\"\n```\n\n### 3. Install Dependencies\n\n```bash\n# Install all dependency groups\nuv sync --all-groups\n\n# Or install specific groups\nuv sync --group dev\n```\n\n### 4. Add Makefile\n\n```makefile\n.PHONY: dev lint format test build\n\ndev:\n\tuv sync --all-groups\n\nlint:\n\tuv run ruff format --check && uv run ruff check && uv run ty check src\u002F\n\nformat:\n\tuv run ruff format .\n\ntest:\n\tuv run pytest\n\nbuild:\n\tuv build\n```\n\n## Migration Guide\n\nWhen a user requests migration from legacy tooling:\n\n### From requirements.txt + pip\n\nFirst, determine the nature of the code:\n\n**For standalone scripts**: Convert to PEP 723 inline metadata (see [pep723-scripts.md](.\u002Freferences\u002Fpep723-scripts.md))\n\n**For projects**:\n```bash\n# Initialize uv in existing project\nuv init --bare\n\n# Add dependencies using uv (not by editing pyproject.toml)\nuv add requests rich  # add each package\n\n# Or import from requirements.txt (review each package before adding)\n# Note: Complex version specifiers may need manual handling\ngrep -v '^#' requirements.txt | grep -v '^-' | grep -v '^\\s*$' | while read -r pkg; do\n    uv add \"$pkg\" || echo \"Failed to add: $pkg\"\ndone\n\nuv sync\n```\n\nThen:\n1. Delete `requirements.txt`, `requirements-dev.txt`\n2. Delete virtual environment (`venv\u002F`, `.venv\u002F`)\n3. Add `uv.lock` to version control\n\n### From setup.py \u002F setup.cfg\n\n1. Run `uv init --bare` to create pyproject.toml\n2. Use `uv add` to add each dependency from `install_requires`\n3. Use `uv add --group dev` for dev dependencies\n4. Copy non-dependency metadata (name, version, description, etc.) to `[project]`\n5. Delete `setup.py`, `setup.cfg`, `MANIFEST.in`\n\n### From flake8 + black + isort\n\n1. Remove flake8, black, isort via `uv remove`\n2. Delete `.flake8`, `pyproject.toml [tool.black]`, `[tool.isort]` configs\n3. Add ruff: `uv add --group dev ruff`\n4. Add ruff configuration (see [ruff-config.md](.\u002Freferences\u002Fruff-config.md))\n5. Run `uv run ruff check --fix .` to apply fixes\n6. Run `uv run ruff format .` to format\n\n### From mypy \u002F pyright\n\n1. Remove mypy\u002Fpyright via `uv remove`\n2. Delete `mypy.ini`, `pyrightconfig.json`, or `[tool.mypy]`\u002F`[tool.pyright]` sections\n3. Add ty: `uv add --group dev ty`\n4. Run `uv run ty check src\u002F`\n\n## Quick Reference: uv Commands\n\n| Command | Description |\n|---------|-------------|\n| `uv init` | Create new project |\n| `uv init --package` | Create distributable package |\n| `uv add \u003Cpkg>` | Add dependency |\n| `uv add --group dev \u003Cpkg>` | Add to dependency group |\n| `uv remove \u003Cpkg>` | Remove dependency |\n| `uv sync` | Install dependencies |\n| `uv sync --all-groups` | Install all dependency groups |\n| `uv run \u003Ccmd>` | Run command in venv |\n| `uv run --with \u003Cpkg> \u003Ccmd>` | Run with temporary dependency |\n| `uv build` | Build package |\n| `uv publish` | Publish to PyPI |\n\n### Ad-hoc Dependencies with `--with`\n\nUse `uv run --with` for one-off commands that need packages not in your project:\n\n```bash\n# Run Python with a temporary package\nuv run --with requests python -c \"import requests; print(requests.get('https:\u002F\u002Fhttpbin.org\u002Fip').json())\"\n\n# Run a module with temporary deps\nuv run --with rich python -m rich.progress\n\n# Multiple packages\nuv run --with requests --with rich python script.py\n\n# Combine with project deps (adds to existing venv)\nuv run --with httpx pytest  # project deps + httpx\n```\n\n**When to use `--with` vs `uv add`:**\n- `uv add`: Package is a project dependency (goes in pyproject.toml\u002Fuv.lock)\n- `--with`: One-off usage, testing, or scripts outside a project context\n\nSee [uv-commands.md](.\u002Freferences\u002Fuv-commands.md) for complete reference.\n\n## Quick Reference: Dependency Groups\n\n```toml\n[dependency-groups]\ndev = [\"ruff\", \"ty\"]\ntest = [\"pytest\", \"pytest-cov\", \"hypothesis\"]\ndocs = [\"sphinx\", \"myst-parser\"]\n```\n\nInstall with: `uv sync --group dev --group test`\n\n## Best Practices Checklist\n\n- [ ] Use `src\u002F` layout for packages\n- [ ] Set `requires-python = \">=3.11\"`\n- [ ] Configure ruff with `select = [\"ALL\"]` and explicit ignores\n- [ ] Use ty for type checking\n- [ ] Enforce test coverage minimum (80%+)\n- [ ] Use dependency groups instead of extras for dev tools\n- [ ] Add `uv.lock` to version control\n- [ ] Use PEP 723 for standalone scripts\n\n## Read Next\n\n- [migration-checklist.md](.\u002Freferences\u002Fmigration-checklist.md) - Step-by-step migration cleanup\n- [pyproject.md](.\u002Freferences\u002Fpyproject.md) - Complete pyproject.toml reference\n- [uv-commands.md](.\u002Freferences\u002Fuv-commands.md) - uv command reference\n- [ruff-config.md](.\u002Freferences\u002Fruff-config.md) - Ruff linting\u002Fformatting configuration\n- [testing.md](.\u002Freferences\u002Ftesting.md) - pytest and coverage setup\n- [pep723-scripts.md](.\u002Freferences\u002Fpep723-scripts.md) - PEP 723 inline script metadata\n- [prek.md](.\u002Freferences\u002Fprek.md) - Fast pre-commit hooks with prek\n- [security-setup.md](.\u002Freferences\u002Fsecurity-setup.md) - Security hooks and dependency scanning\n- [dependabot.md](.\u002Freferences\u002Fdependabot.md) - Automated dependency updates\n",{"data":33,"body":34},{"name":4,"description":6},{"type":35,"children":36},"root",[37,45,62,69,108,114,148,154,387,395,447,453,465,471,610,617,765,778,784,789,1040,1046,1051,1076,1082,1120,1125,1134,1140,1152,1157,1440,1446,1513,1519,1651,1657,1662,1668,1673,1690,1700,1998,2003,2057,2063,2143,2149,2235,2241,2310,2316,2521,2533,2545,2745,2766,2789,2801,2807,2845,2856,2862,2970,2976,3067],{"type":38,"tag":39,"props":40,"children":41},"element","h1",{"id":4},[42],{"type":43,"value":44},"text","Modern Python",{"type":38,"tag":46,"props":47,"children":48},"p",{},[49,51,60],{"type":43,"value":50},"Guide for modern Python tooling and best practices, based on ",{"type":38,"tag":52,"props":53,"children":57},"a",{"href":54,"rel":55},"https:\u002F\u002Fgithub.com\u002Ftrailofbits\u002Fcookiecutter-python",[56],"nofollow",[58],{"type":43,"value":59},"trailofbits\u002Fcookiecutter-python",{"type":43,"value":61},".",{"type":38,"tag":63,"props":64,"children":66},"h2",{"id":65},"when-to-use-this-skill",[67],{"type":43,"value":68},"When to Use This Skill",{"type":38,"tag":70,"props":71,"children":72},"ul",{},[73,79,93,98,103],{"type":38,"tag":74,"props":75,"children":76},"li",{},[77],{"type":43,"value":78},"Creating a new Python project or package",{"type":38,"tag":74,"props":80,"children":81},{},[82,84,91],{"type":43,"value":83},"Setting up ",{"type":38,"tag":85,"props":86,"children":88},"code",{"className":87},[],[89],{"type":43,"value":90},"pyproject.toml",{"type":43,"value":92}," configuration",{"type":38,"tag":74,"props":94,"children":95},{},[96],{"type":43,"value":97},"Configuring development tools (linting, formatting, testing)",{"type":38,"tag":74,"props":99,"children":100},{},[101],{"type":43,"value":102},"Writing Python scripts with external dependencies",{"type":38,"tag":74,"props":104,"children":105},{},[106],{"type":43,"value":107},"Migrating from legacy tools (when user requests it)",{"type":38,"tag":63,"props":109,"children":111},{"id":110},"when-not-to-use-this-skill",[112],{"type":43,"value":113},"When NOT to Use This Skill",{"type":38,"tag":70,"props":115,"children":116},{},[117,128,138],{"type":38,"tag":74,"props":118,"children":119},{},[120,126],{"type":38,"tag":121,"props":122,"children":123},"strong",{},[124],{"type":43,"value":125},"User wants to keep legacy tooling",{"type":43,"value":127},": Respect existing workflows if explicitly requested",{"type":38,"tag":74,"props":129,"children":130},{},[131,136],{"type":38,"tag":121,"props":132,"children":133},{},[134],{"type":43,"value":135},"Python \u003C 3.11 required",{"type":43,"value":137},": These tools target modern Python",{"type":38,"tag":74,"props":139,"children":140},{},[141,146],{"type":38,"tag":121,"props":142,"children":143},{},[144],{"type":43,"value":145},"Non-Python projects",{"type":43,"value":147},": Mixed codebases where Python isn't primary",{"type":38,"tag":63,"props":149,"children":151},{"id":150},"anti-patterns-to-avoid",[152],{"type":43,"value":153},"Anti-Patterns to Avoid",{"type":38,"tag":155,"props":156,"children":157},"table",{},[158,177],{"type":38,"tag":159,"props":160,"children":161},"thead",{},[162],{"type":38,"tag":163,"props":164,"children":165},"tr",{},[166,172],{"type":38,"tag":167,"props":168,"children":169},"th",{},[170],{"type":43,"value":171},"Avoid",{"type":38,"tag":167,"props":173,"children":174},{},[175],{"type":43,"value":176},"Use Instead",{"type":38,"tag":178,"props":179,"children":180},"tbody",{},[181,206,235,260,285,298,311,324,349,374],{"type":38,"tag":163,"props":182,"children":183},{},[184,196],{"type":38,"tag":185,"props":186,"children":187},"td",{},[188,194],{"type":38,"tag":85,"props":189,"children":191},{"className":190},[],[192],{"type":43,"value":193},"[tool.ty]",{"type":43,"value":195}," python-version",{"type":38,"tag":185,"props":197,"children":198},{},[199,205],{"type":38,"tag":85,"props":200,"children":202},{"className":201},[],[203],{"type":43,"value":204},"[tool.ty.environment]",{"type":43,"value":195},{"type":38,"tag":163,"props":207,"children":208},{},[209,218],{"type":38,"tag":185,"props":210,"children":211},{},[212],{"type":38,"tag":85,"props":213,"children":215},{"className":214},[],[216],{"type":43,"value":217},"uv pip install",{"type":38,"tag":185,"props":219,"children":220},{},[221,227,229],{"type":38,"tag":85,"props":222,"children":224},{"className":223},[],[225],{"type":43,"value":226},"uv add",{"type":43,"value":228}," and ",{"type":38,"tag":85,"props":230,"children":232},{"className":231},[],[233],{"type":43,"value":234},"uv sync",{"type":38,"tag":163,"props":236,"children":237},{},[238,243],{"type":38,"tag":185,"props":239,"children":240},{},[241],{"type":43,"value":242},"Editing pyproject.toml manually to add deps",{"type":38,"tag":185,"props":244,"children":245},{},[246,252,254],{"type":38,"tag":85,"props":247,"children":249},{"className":248},[],[250],{"type":43,"value":251},"uv add \u003Cpkg>",{"type":43,"value":253}," \u002F ",{"type":38,"tag":85,"props":255,"children":257},{"className":256},[],[258],{"type":43,"value":259},"uv remove \u003Cpkg>",{"type":38,"tag":163,"props":261,"children":262},{},[263,274],{"type":38,"tag":185,"props":264,"children":265},{},[266,272],{"type":38,"tag":85,"props":267,"children":269},{"className":268},[],[270],{"type":43,"value":271},"hatchling",{"type":43,"value":273}," build backend",{"type":38,"tag":185,"props":275,"children":276},{},[277,283],{"type":38,"tag":85,"props":278,"children":280},{"className":279},[],[281],{"type":43,"value":282},"uv_build",{"type":43,"value":284}," (simpler, sufficient for most cases)",{"type":38,"tag":163,"props":286,"children":287},{},[288,293],{"type":38,"tag":185,"props":289,"children":290},{},[291],{"type":43,"value":292},"Poetry",{"type":38,"tag":185,"props":294,"children":295},{},[296],{"type":43,"value":297},"uv (faster, simpler, better ecosystem integration)",{"type":38,"tag":163,"props":299,"children":300},{},[301,306],{"type":38,"tag":185,"props":302,"children":303},{},[304],{"type":43,"value":305},"requirements.txt",{"type":38,"tag":185,"props":307,"children":308},{},[309],{"type":43,"value":310},"PEP 723 for scripts, pyproject.toml for projects",{"type":38,"tag":163,"props":312,"children":313},{},[314,319],{"type":38,"tag":185,"props":315,"children":316},{},[317],{"type":43,"value":318},"mypy \u002F pyright",{"type":38,"tag":185,"props":320,"children":321},{},[322],{"type":43,"value":323},"ty (faster, from Astral team)",{"type":38,"tag":163,"props":325,"children":326},{},[327,338],{"type":38,"tag":185,"props":328,"children":329},{},[330,336],{"type":38,"tag":85,"props":331,"children":333},{"className":332},[],[334],{"type":43,"value":335},"[project.optional-dependencies]",{"type":43,"value":337}," for dev tools",{"type":38,"tag":185,"props":339,"children":340},{},[341,347],{"type":38,"tag":85,"props":342,"children":344},{"className":343},[],[345],{"type":43,"value":346},"[dependency-groups]",{"type":43,"value":348}," (PEP 735)",{"type":38,"tag":163,"props":350,"children":351},{},[352,365],{"type":38,"tag":185,"props":353,"children":354},{},[355,357,363],{"type":43,"value":356},"Manual virtualenv activation (",{"type":38,"tag":85,"props":358,"children":360},{"className":359},[],[361],{"type":43,"value":362},"source .venv\u002Fbin\u002Factivate",{"type":43,"value":364},")",{"type":38,"tag":185,"props":366,"children":367},{},[368],{"type":38,"tag":85,"props":369,"children":371},{"className":370},[],[372],{"type":43,"value":373},"uv run \u003Ccmd>",{"type":38,"tag":163,"props":375,"children":376},{},[377,382],{"type":38,"tag":185,"props":378,"children":379},{},[380],{"type":43,"value":381},"pre-commit",{"type":38,"tag":185,"props":383,"children":384},{},[385],{"type":43,"value":386},"prek (faster, no Python runtime needed)",{"type":38,"tag":46,"props":388,"children":389},{},[390],{"type":38,"tag":121,"props":391,"children":392},{},[393],{"type":43,"value":394},"Key principles:",{"type":38,"tag":70,"props":396,"children":397},{},[398,417,430],{"type":38,"tag":74,"props":399,"children":400},{},[401,403,408,409,415],{"type":43,"value":402},"Always use ",{"type":38,"tag":85,"props":404,"children":406},{"className":405},[],[407],{"type":43,"value":226},{"type":43,"value":228},{"type":38,"tag":85,"props":410,"children":412},{"className":411},[],[413],{"type":43,"value":414},"uv remove",{"type":43,"value":416}," to manage dependencies",{"type":38,"tag":74,"props":418,"children":419},{},[420,422,428],{"type":43,"value":421},"Never manually activate or manage virtual environments—use ",{"type":38,"tag":85,"props":423,"children":425},{"className":424},[],[426],{"type":43,"value":427},"uv run",{"type":43,"value":429}," for all commands",{"type":38,"tag":74,"props":431,"children":432},{},[433,435,440,442],{"type":43,"value":434},"Use ",{"type":38,"tag":85,"props":436,"children":438},{"className":437},[],[439],{"type":43,"value":346},{"type":43,"value":441}," for dev\u002Ftest\u002Fdocs dependencies, not ",{"type":38,"tag":85,"props":443,"children":445},{"className":444},[],[446],{"type":43,"value":335},{"type":38,"tag":63,"props":448,"children":450},{"id":449},"decision-tree",[451],{"type":43,"value":452},"Decision Tree",{"type":38,"tag":454,"props":455,"children":459},"pre",{"className":456,"code":458,"language":43},[457],"language-text","What are you doing?\n│\n├─ Single-file script with dependencies?\n│   └─ Use PEP 723 inline metadata (.\u002Freferences\u002Fpep723-scripts.md)\n│\n├─ New multi-file project (not distributed)?\n│   └─ Minimal uv setup (see Quick Start below)\n│\n├─ New reusable package\u002Flibrary?\n│   └─ Full project setup (see Full Setup below)\n│\n└─ Migrating existing project?\n    └─ See Migration Guide below\n",[460],{"type":38,"tag":85,"props":461,"children":463},{"__ignoreMap":462},"",[464],{"type":43,"value":458},{"type":38,"tag":63,"props":466,"children":468},{"id":467},"tool-overview",[469],{"type":43,"value":470},"Tool Overview",{"type":38,"tag":155,"props":472,"children":473},{},[474,495],{"type":38,"tag":159,"props":475,"children":476},{},[477],{"type":38,"tag":163,"props":478,"children":479},{},[480,485,490],{"type":38,"tag":167,"props":481,"children":482},{},[483],{"type":43,"value":484},"Tool",{"type":38,"tag":167,"props":486,"children":487},{},[488],{"type":43,"value":489},"Purpose",{"type":38,"tag":167,"props":491,"children":492},{},[493],{"type":43,"value":494},"Replaces",{"type":38,"tag":178,"props":496,"children":497},{},[498,519,540,561,582],{"type":38,"tag":163,"props":499,"children":500},{},[501,509,514],{"type":38,"tag":185,"props":502,"children":503},{},[504],{"type":38,"tag":121,"props":505,"children":506},{},[507],{"type":43,"value":508},"uv",{"type":38,"tag":185,"props":510,"children":511},{},[512],{"type":43,"value":513},"Package\u002Fdependency management",{"type":38,"tag":185,"props":515,"children":516},{},[517],{"type":43,"value":518},"pip, virtualenv, pip-tools, pipx, pyenv",{"type":38,"tag":163,"props":520,"children":521},{},[522,530,535],{"type":38,"tag":185,"props":523,"children":524},{},[525],{"type":38,"tag":121,"props":526,"children":527},{},[528],{"type":43,"value":529},"ruff",{"type":38,"tag":185,"props":531,"children":532},{},[533],{"type":43,"value":534},"Linting AND formatting",{"type":38,"tag":185,"props":536,"children":537},{},[538],{"type":43,"value":539},"flake8, black, isort, pyupgrade, pydocstyle",{"type":38,"tag":163,"props":541,"children":542},{},[543,551,556],{"type":38,"tag":185,"props":544,"children":545},{},[546],{"type":38,"tag":121,"props":547,"children":548},{},[549],{"type":43,"value":550},"ty",{"type":38,"tag":185,"props":552,"children":553},{},[554],{"type":43,"value":555},"Type checking",{"type":38,"tag":185,"props":557,"children":558},{},[559],{"type":43,"value":560},"mypy, pyright (faster alternative)",{"type":38,"tag":163,"props":562,"children":563},{},[564,572,577],{"type":38,"tag":185,"props":565,"children":566},{},[567],{"type":38,"tag":121,"props":568,"children":569},{},[570],{"type":43,"value":571},"pytest",{"type":38,"tag":185,"props":573,"children":574},{},[575],{"type":43,"value":576},"Testing with coverage",{"type":38,"tag":185,"props":578,"children":579},{},[580],{"type":43,"value":581},"unittest",{"type":38,"tag":163,"props":583,"children":584},{},[585,593,605],{"type":38,"tag":185,"props":586,"children":587},{},[588],{"type":38,"tag":121,"props":589,"children":590},{},[591],{"type":43,"value":592},"prek",{"type":38,"tag":185,"props":594,"children":595},{},[596,598,604],{"type":43,"value":597},"Pre-commit hooks (",{"type":38,"tag":52,"props":599,"children":601},{"href":600},".\u002Freferences\u002Fprek.md",[602],{"type":43,"value":603},"setup",{"type":43,"value":364},{"type":38,"tag":185,"props":606,"children":607},{},[608],{"type":43,"value":609},"pre-commit (faster, Rust-native)",{"type":38,"tag":611,"props":612,"children":614},"h3",{"id":613},"security-tools",[615],{"type":43,"value":616},"Security Tools",{"type":38,"tag":155,"props":618,"children":619},{},[620,639],{"type":38,"tag":159,"props":621,"children":622},{},[623],{"type":38,"tag":163,"props":624,"children":625},{},[626,630,634],{"type":38,"tag":167,"props":627,"children":628},{},[629],{"type":43,"value":484},{"type":38,"tag":167,"props":631,"children":632},{},[633],{"type":43,"value":489},{"type":38,"tag":167,"props":635,"children":636},{},[637],{"type":43,"value":638},"When It Runs",{"type":38,"tag":178,"props":640,"children":641},{},[642,662,682,703,723,744],{"type":38,"tag":163,"props":643,"children":644},{},[645,653,658],{"type":38,"tag":185,"props":646,"children":647},{},[648],{"type":38,"tag":121,"props":649,"children":650},{},[651],{"type":43,"value":652},"shellcheck",{"type":38,"tag":185,"props":654,"children":655},{},[656],{"type":43,"value":657},"Shell script linting",{"type":38,"tag":185,"props":659,"children":660},{},[661],{"type":43,"value":381},{"type":38,"tag":163,"props":663,"children":664},{},[665,673,678],{"type":38,"tag":185,"props":666,"children":667},{},[668],{"type":38,"tag":121,"props":669,"children":670},{},[671],{"type":43,"value":672},"detect-secrets",{"type":38,"tag":185,"props":674,"children":675},{},[676],{"type":43,"value":677},"Secret detection",{"type":38,"tag":185,"props":679,"children":680},{},[681],{"type":43,"value":381},{"type":38,"tag":163,"props":683,"children":684},{},[685,693,698],{"type":38,"tag":185,"props":686,"children":687},{},[688],{"type":38,"tag":121,"props":689,"children":690},{},[691],{"type":43,"value":692},"actionlint",{"type":38,"tag":185,"props":694,"children":695},{},[696],{"type":43,"value":697},"Workflow syntax validation",{"type":38,"tag":185,"props":699,"children":700},{},[701],{"type":43,"value":702},"pre-commit, CI",{"type":38,"tag":163,"props":704,"children":705},{},[706,714,719],{"type":38,"tag":185,"props":707,"children":708},{},[709],{"type":38,"tag":121,"props":710,"children":711},{},[712],{"type":43,"value":713},"zizmor",{"type":38,"tag":185,"props":715,"children":716},{},[717],{"type":43,"value":718},"Workflow security audit",{"type":38,"tag":185,"props":720,"children":721},{},[722],{"type":43,"value":702},{"type":38,"tag":163,"props":724,"children":725},{},[726,734,739],{"type":38,"tag":185,"props":727,"children":728},{},[729],{"type":38,"tag":121,"props":730,"children":731},{},[732],{"type":43,"value":733},"pip-audit",{"type":38,"tag":185,"props":735,"children":736},{},[737],{"type":43,"value":738},"Dependency vulnerability scanning",{"type":38,"tag":185,"props":740,"children":741},{},[742],{"type":43,"value":743},"CI, manual",{"type":38,"tag":163,"props":745,"children":746},{},[747,755,760],{"type":38,"tag":185,"props":748,"children":749},{},[750],{"type":38,"tag":121,"props":751,"children":752},{},[753],{"type":43,"value":754},"Dependabot",{"type":38,"tag":185,"props":756,"children":757},{},[758],{"type":43,"value":759},"Automated dependency updates",{"type":38,"tag":185,"props":761,"children":762},{},[763],{"type":43,"value":764},"scheduled",{"type":38,"tag":46,"props":766,"children":767},{},[768,770,776],{"type":43,"value":769},"See ",{"type":38,"tag":52,"props":771,"children":773},{"href":772},".\u002Freferences\u002Fsecurity-setup.md",[774],{"type":43,"value":775},"security-setup.md",{"type":43,"value":777}," for configuration and usage.",{"type":38,"tag":63,"props":779,"children":781},{"id":780},"quick-start-minimal-project",[782],{"type":43,"value":783},"Quick Start: Minimal Project",{"type":38,"tag":46,"props":785,"children":786},{},[787],{"type":43,"value":788},"For simple multi-file projects not intended for distribution:",{"type":38,"tag":454,"props":790,"children":794},{"className":791,"code":792,"language":793,"meta":462,"style":462},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Create project with uv\nuv init myproject\ncd myproject\n\n# Add dependencies\nuv add requests rich\n\n# Add dev dependencies\nuv add --group dev pytest ruff ty\n\n# Run code\nuv run python src\u002Fmyproject\u002Fmain.py\n\n# Run tools\nuv run pytest\nuv run ruff check .\n","bash",[795],{"type":38,"tag":85,"props":796,"children":797},{"__ignoreMap":462},[798,810,830,844,854,863,886,894,903,940,948,957,980,988,997,1014],{"type":38,"tag":799,"props":800,"children":803},"span",{"class":801,"line":802},"line",1,[804],{"type":38,"tag":799,"props":805,"children":807},{"style":806},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[808],{"type":43,"value":809},"# Create project with uv\n",{"type":38,"tag":799,"props":811,"children":813},{"class":801,"line":812},2,[814,819,825],{"type":38,"tag":799,"props":815,"children":817},{"style":816},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[818],{"type":43,"value":508},{"type":38,"tag":799,"props":820,"children":822},{"style":821},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[823],{"type":43,"value":824}," init",{"type":38,"tag":799,"props":826,"children":827},{"style":821},[828],{"type":43,"value":829}," myproject\n",{"type":38,"tag":799,"props":831,"children":833},{"class":801,"line":832},3,[834,840],{"type":38,"tag":799,"props":835,"children":837},{"style":836},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[838],{"type":43,"value":839},"cd",{"type":38,"tag":799,"props":841,"children":842},{"style":821},[843],{"type":43,"value":829},{"type":38,"tag":799,"props":845,"children":847},{"class":801,"line":846},4,[848],{"type":38,"tag":799,"props":849,"children":851},{"emptyLinePlaceholder":850},true,[852],{"type":43,"value":853},"\n",{"type":38,"tag":799,"props":855,"children":857},{"class":801,"line":856},5,[858],{"type":38,"tag":799,"props":859,"children":860},{"style":806},[861],{"type":43,"value":862},"# Add dependencies\n",{"type":38,"tag":799,"props":864,"children":866},{"class":801,"line":865},6,[867,871,876,881],{"type":38,"tag":799,"props":868,"children":869},{"style":816},[870],{"type":43,"value":508},{"type":38,"tag":799,"props":872,"children":873},{"style":821},[874],{"type":43,"value":875}," add",{"type":38,"tag":799,"props":877,"children":878},{"style":821},[879],{"type":43,"value":880}," requests",{"type":38,"tag":799,"props":882,"children":883},{"style":821},[884],{"type":43,"value":885}," rich\n",{"type":38,"tag":799,"props":887,"children":889},{"class":801,"line":888},7,[890],{"type":38,"tag":799,"props":891,"children":892},{"emptyLinePlaceholder":850},[893],{"type":43,"value":853},{"type":38,"tag":799,"props":895,"children":897},{"class":801,"line":896},8,[898],{"type":38,"tag":799,"props":899,"children":900},{"style":806},[901],{"type":43,"value":902},"# Add dev dependencies\n",{"type":38,"tag":799,"props":904,"children":906},{"class":801,"line":905},9,[907,911,915,920,925,930,935],{"type":38,"tag":799,"props":908,"children":909},{"style":816},[910],{"type":43,"value":508},{"type":38,"tag":799,"props":912,"children":913},{"style":821},[914],{"type":43,"value":875},{"type":38,"tag":799,"props":916,"children":917},{"style":821},[918],{"type":43,"value":919}," --group",{"type":38,"tag":799,"props":921,"children":922},{"style":821},[923],{"type":43,"value":924}," dev",{"type":38,"tag":799,"props":926,"children":927},{"style":821},[928],{"type":43,"value":929}," pytest",{"type":38,"tag":799,"props":931,"children":932},{"style":821},[933],{"type":43,"value":934}," ruff",{"type":38,"tag":799,"props":936,"children":937},{"style":821},[938],{"type":43,"value":939}," ty\n",{"type":38,"tag":799,"props":941,"children":943},{"class":801,"line":942},10,[944],{"type":38,"tag":799,"props":945,"children":946},{"emptyLinePlaceholder":850},[947],{"type":43,"value":853},{"type":38,"tag":799,"props":949,"children":951},{"class":801,"line":950},11,[952],{"type":38,"tag":799,"props":953,"children":954},{"style":806},[955],{"type":43,"value":956},"# Run code\n",{"type":38,"tag":799,"props":958,"children":960},{"class":801,"line":959},12,[961,965,970,975],{"type":38,"tag":799,"props":962,"children":963},{"style":816},[964],{"type":43,"value":508},{"type":38,"tag":799,"props":966,"children":967},{"style":821},[968],{"type":43,"value":969}," run",{"type":38,"tag":799,"props":971,"children":972},{"style":821},[973],{"type":43,"value":974}," python",{"type":38,"tag":799,"props":976,"children":977},{"style":821},[978],{"type":43,"value":979}," src\u002Fmyproject\u002Fmain.py\n",{"type":38,"tag":799,"props":981,"children":983},{"class":801,"line":982},13,[984],{"type":38,"tag":799,"props":985,"children":986},{"emptyLinePlaceholder":850},[987],{"type":43,"value":853},{"type":38,"tag":799,"props":989,"children":991},{"class":801,"line":990},14,[992],{"type":38,"tag":799,"props":993,"children":994},{"style":806},[995],{"type":43,"value":996},"# Run tools\n",{"type":38,"tag":799,"props":998,"children":1000},{"class":801,"line":999},15,[1001,1005,1009],{"type":38,"tag":799,"props":1002,"children":1003},{"style":816},[1004],{"type":43,"value":508},{"type":38,"tag":799,"props":1006,"children":1007},{"style":821},[1008],{"type":43,"value":969},{"type":38,"tag":799,"props":1010,"children":1011},{"style":821},[1012],{"type":43,"value":1013}," pytest\n",{"type":38,"tag":799,"props":1015,"children":1017},{"class":801,"line":1016},16,[1018,1022,1026,1030,1035],{"type":38,"tag":799,"props":1019,"children":1020},{"style":816},[1021],{"type":43,"value":508},{"type":38,"tag":799,"props":1023,"children":1024},{"style":821},[1025],{"type":43,"value":969},{"type":38,"tag":799,"props":1027,"children":1028},{"style":821},[1029],{"type":43,"value":934},{"type":38,"tag":799,"props":1031,"children":1032},{"style":821},[1033],{"type":43,"value":1034}," check",{"type":38,"tag":799,"props":1036,"children":1037},{"style":821},[1038],{"type":43,"value":1039}," .\n",{"type":38,"tag":63,"props":1041,"children":1043},{"id":1042},"full-project-setup",[1044],{"type":43,"value":1045},"Full Project Setup",{"type":38,"tag":46,"props":1047,"children":1048},{},[1049],{"type":43,"value":1050},"If starting from scratch, ask the user if they prefer to use the Trail of Bits cookiecutter template to bootstrap a complete project with already preconfigured tooling.",{"type":38,"tag":454,"props":1052,"children":1054},{"className":791,"code":1053,"language":793,"meta":462,"style":462},"uvx cookiecutter gh:trailofbits\u002Fcookiecutter-python\n",[1055],{"type":38,"tag":85,"props":1056,"children":1057},{"__ignoreMap":462},[1058],{"type":38,"tag":799,"props":1059,"children":1060},{"class":801,"line":802},[1061,1066,1071],{"type":38,"tag":799,"props":1062,"children":1063},{"style":816},[1064],{"type":43,"value":1065},"uvx",{"type":38,"tag":799,"props":1067,"children":1068},{"style":821},[1069],{"type":43,"value":1070}," cookiecutter",{"type":38,"tag":799,"props":1072,"children":1073},{"style":821},[1074],{"type":43,"value":1075}," gh:trailofbits\u002Fcookiecutter-python\n",{"type":38,"tag":611,"props":1077,"children":1079},{"id":1078},"_1-create-project-structure",[1080],{"type":43,"value":1081},"1. Create Project Structure",{"type":38,"tag":454,"props":1083,"children":1085},{"className":791,"code":1084,"language":793,"meta":462,"style":462},"uv init --package myproject\ncd myproject\n",[1086],{"type":38,"tag":85,"props":1087,"children":1088},{"__ignoreMap":462},[1089,1109],{"type":38,"tag":799,"props":1090,"children":1091},{"class":801,"line":802},[1092,1096,1100,1105],{"type":38,"tag":799,"props":1093,"children":1094},{"style":816},[1095],{"type":43,"value":508},{"type":38,"tag":799,"props":1097,"children":1098},{"style":821},[1099],{"type":43,"value":824},{"type":38,"tag":799,"props":1101,"children":1102},{"style":821},[1103],{"type":43,"value":1104}," --package",{"type":38,"tag":799,"props":1106,"children":1107},{"style":821},[1108],{"type":43,"value":829},{"type":38,"tag":799,"props":1110,"children":1111},{"class":801,"line":812},[1112,1116],{"type":38,"tag":799,"props":1113,"children":1114},{"style":836},[1115],{"type":43,"value":839},{"type":38,"tag":799,"props":1117,"children":1118},{"style":821},[1119],{"type":43,"value":829},{"type":38,"tag":46,"props":1121,"children":1122},{},[1123],{"type":43,"value":1124},"This creates:",{"type":38,"tag":454,"props":1126,"children":1129},{"className":1127,"code":1128,"language":43},[457],"myproject\u002F\n├── pyproject.toml\n├── README.md\n├── src\u002F\n│   └── myproject\u002F\n│       └── __init__.py\n└── .python-version\n",[1130],{"type":38,"tag":85,"props":1131,"children":1132},{"__ignoreMap":462},[1133],{"type":43,"value":1128},{"type":38,"tag":611,"props":1135,"children":1137},{"id":1136},"_2-configure-pyprojecttoml",[1138],{"type":43,"value":1139},"2. Configure pyproject.toml",{"type":38,"tag":46,"props":1141,"children":1142},{},[1143,1144,1150],{"type":43,"value":769},{"type":38,"tag":52,"props":1145,"children":1147},{"href":1146},".\u002Freferences\u002Fpyproject.md",[1148],{"type":43,"value":1149},"pyproject.md",{"type":43,"value":1151}," for complete configuration reference.",{"type":38,"tag":46,"props":1153,"children":1154},{},[1155],{"type":43,"value":1156},"Key sections:",{"type":38,"tag":454,"props":1158,"children":1162},{"className":1159,"code":1160,"language":1161,"meta":462,"style":462},"language-toml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","[project]\nname = \"myproject\"\nversion = \"0.1.0\"\nrequires-python = \">=3.11\"\ndependencies = []\n\n[dependency-groups]\ndev = [{include-group = \"lint\"}, {include-group = \"test\"}, {include-group = \"audit\"}]\nlint = [\"ruff\", \"ty\"]\ntest = [\"pytest\", \"pytest-cov\"]\naudit = [\"pip-audit\"]\n\n[tool.ruff]\nline-length = 100\ntarget-version = \"py311\"\n\n[tool.ruff.lint]\nselect = [\"ALL\"]\nignore = [\"D\", \"COM812\", \"ISC001\"]\n\n[tool.pytest]\naddopts = [\"--cov=myproject\", \"--cov-fail-under=80\"]\n\n[tool.ty.terminal]\nerror-on-warning = true\n\n[tool.ty.environment]\npython-version = \"3.11\"\n\n[tool.ty.rules]\n# Strict from day 1 for new projects\npossibly-unresolved-reference = \"error\"\nunused-ignore-comment = \"warn\"\n","toml",[1163],{"type":38,"tag":85,"props":1164,"children":1165},{"__ignoreMap":462},[1166,1174,1182,1190,1198,1206,1213,1221,1229,1237,1245,1253,1260,1268,1276,1284,1291,1300,1309,1318,1326,1335,1344,1352,1361,1370,1378,1387,1396,1404,1413,1422,1431],{"type":38,"tag":799,"props":1167,"children":1168},{"class":801,"line":802},[1169],{"type":38,"tag":799,"props":1170,"children":1171},{},[1172],{"type":43,"value":1173},"[project]\n",{"type":38,"tag":799,"props":1175,"children":1176},{"class":801,"line":812},[1177],{"type":38,"tag":799,"props":1178,"children":1179},{},[1180],{"type":43,"value":1181},"name = \"myproject\"\n",{"type":38,"tag":799,"props":1183,"children":1184},{"class":801,"line":832},[1185],{"type":38,"tag":799,"props":1186,"children":1187},{},[1188],{"type":43,"value":1189},"version = \"0.1.0\"\n",{"type":38,"tag":799,"props":1191,"children":1192},{"class":801,"line":846},[1193],{"type":38,"tag":799,"props":1194,"children":1195},{},[1196],{"type":43,"value":1197},"requires-python = \">=3.11\"\n",{"type":38,"tag":799,"props":1199,"children":1200},{"class":801,"line":856},[1201],{"type":38,"tag":799,"props":1202,"children":1203},{},[1204],{"type":43,"value":1205},"dependencies = []\n",{"type":38,"tag":799,"props":1207,"children":1208},{"class":801,"line":865},[1209],{"type":38,"tag":799,"props":1210,"children":1211},{"emptyLinePlaceholder":850},[1212],{"type":43,"value":853},{"type":38,"tag":799,"props":1214,"children":1215},{"class":801,"line":888},[1216],{"type":38,"tag":799,"props":1217,"children":1218},{},[1219],{"type":43,"value":1220},"[dependency-groups]\n",{"type":38,"tag":799,"props":1222,"children":1223},{"class":801,"line":896},[1224],{"type":38,"tag":799,"props":1225,"children":1226},{},[1227],{"type":43,"value":1228},"dev = [{include-group = \"lint\"}, {include-group = \"test\"}, {include-group = \"audit\"}]\n",{"type":38,"tag":799,"props":1230,"children":1231},{"class":801,"line":905},[1232],{"type":38,"tag":799,"props":1233,"children":1234},{},[1235],{"type":43,"value":1236},"lint = [\"ruff\", \"ty\"]\n",{"type":38,"tag":799,"props":1238,"children":1239},{"class":801,"line":942},[1240],{"type":38,"tag":799,"props":1241,"children":1242},{},[1243],{"type":43,"value":1244},"test = [\"pytest\", \"pytest-cov\"]\n",{"type":38,"tag":799,"props":1246,"children":1247},{"class":801,"line":950},[1248],{"type":38,"tag":799,"props":1249,"children":1250},{},[1251],{"type":43,"value":1252},"audit = [\"pip-audit\"]\n",{"type":38,"tag":799,"props":1254,"children":1255},{"class":801,"line":959},[1256],{"type":38,"tag":799,"props":1257,"children":1258},{"emptyLinePlaceholder":850},[1259],{"type":43,"value":853},{"type":38,"tag":799,"props":1261,"children":1262},{"class":801,"line":982},[1263],{"type":38,"tag":799,"props":1264,"children":1265},{},[1266],{"type":43,"value":1267},"[tool.ruff]\n",{"type":38,"tag":799,"props":1269,"children":1270},{"class":801,"line":990},[1271],{"type":38,"tag":799,"props":1272,"children":1273},{},[1274],{"type":43,"value":1275},"line-length = 100\n",{"type":38,"tag":799,"props":1277,"children":1278},{"class":801,"line":999},[1279],{"type":38,"tag":799,"props":1280,"children":1281},{},[1282],{"type":43,"value":1283},"target-version = \"py311\"\n",{"type":38,"tag":799,"props":1285,"children":1286},{"class":801,"line":1016},[1287],{"type":38,"tag":799,"props":1288,"children":1289},{"emptyLinePlaceholder":850},[1290],{"type":43,"value":853},{"type":38,"tag":799,"props":1292,"children":1294},{"class":801,"line":1293},17,[1295],{"type":38,"tag":799,"props":1296,"children":1297},{},[1298],{"type":43,"value":1299},"[tool.ruff.lint]\n",{"type":38,"tag":799,"props":1301,"children":1303},{"class":801,"line":1302},18,[1304],{"type":38,"tag":799,"props":1305,"children":1306},{},[1307],{"type":43,"value":1308},"select = [\"ALL\"]\n",{"type":38,"tag":799,"props":1310,"children":1312},{"class":801,"line":1311},19,[1313],{"type":38,"tag":799,"props":1314,"children":1315},{},[1316],{"type":43,"value":1317},"ignore = [\"D\", \"COM812\", \"ISC001\"]\n",{"type":38,"tag":799,"props":1319,"children":1321},{"class":801,"line":1320},20,[1322],{"type":38,"tag":799,"props":1323,"children":1324},{"emptyLinePlaceholder":850},[1325],{"type":43,"value":853},{"type":38,"tag":799,"props":1327,"children":1329},{"class":801,"line":1328},21,[1330],{"type":38,"tag":799,"props":1331,"children":1332},{},[1333],{"type":43,"value":1334},"[tool.pytest]\n",{"type":38,"tag":799,"props":1336,"children":1338},{"class":801,"line":1337},22,[1339],{"type":38,"tag":799,"props":1340,"children":1341},{},[1342],{"type":43,"value":1343},"addopts = [\"--cov=myproject\", \"--cov-fail-under=80\"]\n",{"type":38,"tag":799,"props":1345,"children":1347},{"class":801,"line":1346},23,[1348],{"type":38,"tag":799,"props":1349,"children":1350},{"emptyLinePlaceholder":850},[1351],{"type":43,"value":853},{"type":38,"tag":799,"props":1353,"children":1355},{"class":801,"line":1354},24,[1356],{"type":38,"tag":799,"props":1357,"children":1358},{},[1359],{"type":43,"value":1360},"[tool.ty.terminal]\n",{"type":38,"tag":799,"props":1362,"children":1364},{"class":801,"line":1363},25,[1365],{"type":38,"tag":799,"props":1366,"children":1367},{},[1368],{"type":43,"value":1369},"error-on-warning = true\n",{"type":38,"tag":799,"props":1371,"children":1373},{"class":801,"line":1372},26,[1374],{"type":38,"tag":799,"props":1375,"children":1376},{"emptyLinePlaceholder":850},[1377],{"type":43,"value":853},{"type":38,"tag":799,"props":1379,"children":1381},{"class":801,"line":1380},27,[1382],{"type":38,"tag":799,"props":1383,"children":1384},{},[1385],{"type":43,"value":1386},"[tool.ty.environment]\n",{"type":38,"tag":799,"props":1388,"children":1390},{"class":801,"line":1389},28,[1391],{"type":38,"tag":799,"props":1392,"children":1393},{},[1394],{"type":43,"value":1395},"python-version = \"3.11\"\n",{"type":38,"tag":799,"props":1397,"children":1399},{"class":801,"line":1398},29,[1400],{"type":38,"tag":799,"props":1401,"children":1402},{"emptyLinePlaceholder":850},[1403],{"type":43,"value":853},{"type":38,"tag":799,"props":1405,"children":1407},{"class":801,"line":1406},30,[1408],{"type":38,"tag":799,"props":1409,"children":1410},{},[1411],{"type":43,"value":1412},"[tool.ty.rules]\n",{"type":38,"tag":799,"props":1414,"children":1416},{"class":801,"line":1415},31,[1417],{"type":38,"tag":799,"props":1418,"children":1419},{},[1420],{"type":43,"value":1421},"# Strict from day 1 for new projects\n",{"type":38,"tag":799,"props":1423,"children":1425},{"class":801,"line":1424},32,[1426],{"type":38,"tag":799,"props":1427,"children":1428},{},[1429],{"type":43,"value":1430},"possibly-unresolved-reference = \"error\"\n",{"type":38,"tag":799,"props":1432,"children":1434},{"class":801,"line":1433},33,[1435],{"type":38,"tag":799,"props":1436,"children":1437},{},[1438],{"type":43,"value":1439},"unused-ignore-comment = \"warn\"\n",{"type":38,"tag":611,"props":1441,"children":1443},{"id":1442},"_3-install-dependencies",[1444],{"type":43,"value":1445},"3. Install Dependencies",{"type":38,"tag":454,"props":1447,"children":1449},{"className":791,"code":1448,"language":793,"meta":462,"style":462},"# Install all dependency groups\nuv sync --all-groups\n\n# Or install specific groups\nuv sync --group dev\n",[1450],{"type":38,"tag":85,"props":1451,"children":1452},{"__ignoreMap":462},[1453,1461,1478,1485,1493],{"type":38,"tag":799,"props":1454,"children":1455},{"class":801,"line":802},[1456],{"type":38,"tag":799,"props":1457,"children":1458},{"style":806},[1459],{"type":43,"value":1460},"# Install all dependency groups\n",{"type":38,"tag":799,"props":1462,"children":1463},{"class":801,"line":812},[1464,1468,1473],{"type":38,"tag":799,"props":1465,"children":1466},{"style":816},[1467],{"type":43,"value":508},{"type":38,"tag":799,"props":1469,"children":1470},{"style":821},[1471],{"type":43,"value":1472}," sync",{"type":38,"tag":799,"props":1474,"children":1475},{"style":821},[1476],{"type":43,"value":1477}," --all-groups\n",{"type":38,"tag":799,"props":1479,"children":1480},{"class":801,"line":832},[1481],{"type":38,"tag":799,"props":1482,"children":1483},{"emptyLinePlaceholder":850},[1484],{"type":43,"value":853},{"type":38,"tag":799,"props":1486,"children":1487},{"class":801,"line":846},[1488],{"type":38,"tag":799,"props":1489,"children":1490},{"style":806},[1491],{"type":43,"value":1492},"# Or install specific groups\n",{"type":38,"tag":799,"props":1494,"children":1495},{"class":801,"line":856},[1496,1500,1504,1508],{"type":38,"tag":799,"props":1497,"children":1498},{"style":816},[1499],{"type":43,"value":508},{"type":38,"tag":799,"props":1501,"children":1502},{"style":821},[1503],{"type":43,"value":1472},{"type":38,"tag":799,"props":1505,"children":1506},{"style":821},[1507],{"type":43,"value":919},{"type":38,"tag":799,"props":1509,"children":1510},{"style":821},[1511],{"type":43,"value":1512}," dev\n",{"type":38,"tag":611,"props":1514,"children":1516},{"id":1515},"_4-add-makefile",[1517],{"type":43,"value":1518},"4. Add Makefile",{"type":38,"tag":454,"props":1520,"children":1524},{"className":1521,"code":1522,"language":1523,"meta":462,"style":462},"language-makefile shiki shiki-themes material-theme-lighter material-theme material-theme-palenight",".PHONY: dev lint format test build\n\ndev:\n    uv sync --all-groups\n\nlint:\n    uv run ruff format --check && uv run ruff check && uv run ty check src\u002F\n\nformat:\n    uv run ruff format .\n\ntest:\n    uv run pytest\n\nbuild:\n    uv build\n","makefile",[1525],{"type":38,"tag":85,"props":1526,"children":1527},{"__ignoreMap":462},[1528,1536,1543,1551,1559,1566,1574,1582,1589,1597,1605,1612,1620,1628,1635,1643],{"type":38,"tag":799,"props":1529,"children":1530},{"class":801,"line":802},[1531],{"type":38,"tag":799,"props":1532,"children":1533},{},[1534],{"type":43,"value":1535},".PHONY: dev lint format test build\n",{"type":38,"tag":799,"props":1537,"children":1538},{"class":801,"line":812},[1539],{"type":38,"tag":799,"props":1540,"children":1541},{"emptyLinePlaceholder":850},[1542],{"type":43,"value":853},{"type":38,"tag":799,"props":1544,"children":1545},{"class":801,"line":832},[1546],{"type":38,"tag":799,"props":1547,"children":1548},{},[1549],{"type":43,"value":1550},"dev:\n",{"type":38,"tag":799,"props":1552,"children":1553},{"class":801,"line":846},[1554],{"type":38,"tag":799,"props":1555,"children":1556},{},[1557],{"type":43,"value":1558},"    uv sync --all-groups\n",{"type":38,"tag":799,"props":1560,"children":1561},{"class":801,"line":856},[1562],{"type":38,"tag":799,"props":1563,"children":1564},{"emptyLinePlaceholder":850},[1565],{"type":43,"value":853},{"type":38,"tag":799,"props":1567,"children":1568},{"class":801,"line":865},[1569],{"type":38,"tag":799,"props":1570,"children":1571},{},[1572],{"type":43,"value":1573},"lint:\n",{"type":38,"tag":799,"props":1575,"children":1576},{"class":801,"line":888},[1577],{"type":38,"tag":799,"props":1578,"children":1579},{},[1580],{"type":43,"value":1581},"    uv run ruff format --check && uv run ruff check && uv run ty check src\u002F\n",{"type":38,"tag":799,"props":1583,"children":1584},{"class":801,"line":896},[1585],{"type":38,"tag":799,"props":1586,"children":1587},{"emptyLinePlaceholder":850},[1588],{"type":43,"value":853},{"type":38,"tag":799,"props":1590,"children":1591},{"class":801,"line":905},[1592],{"type":38,"tag":799,"props":1593,"children":1594},{},[1595],{"type":43,"value":1596},"format:\n",{"type":38,"tag":799,"props":1598,"children":1599},{"class":801,"line":942},[1600],{"type":38,"tag":799,"props":1601,"children":1602},{},[1603],{"type":43,"value":1604},"    uv run ruff format .\n",{"type":38,"tag":799,"props":1606,"children":1607},{"class":801,"line":950},[1608],{"type":38,"tag":799,"props":1609,"children":1610},{"emptyLinePlaceholder":850},[1611],{"type":43,"value":853},{"type":38,"tag":799,"props":1613,"children":1614},{"class":801,"line":959},[1615],{"type":38,"tag":799,"props":1616,"children":1617},{},[1618],{"type":43,"value":1619},"test:\n",{"type":38,"tag":799,"props":1621,"children":1622},{"class":801,"line":982},[1623],{"type":38,"tag":799,"props":1624,"children":1625},{},[1626],{"type":43,"value":1627},"    uv run pytest\n",{"type":38,"tag":799,"props":1629,"children":1630},{"class":801,"line":990},[1631],{"type":38,"tag":799,"props":1632,"children":1633},{"emptyLinePlaceholder":850},[1634],{"type":43,"value":853},{"type":38,"tag":799,"props":1636,"children":1637},{"class":801,"line":999},[1638],{"type":38,"tag":799,"props":1639,"children":1640},{},[1641],{"type":43,"value":1642},"build:\n",{"type":38,"tag":799,"props":1644,"children":1645},{"class":801,"line":1016},[1646],{"type":38,"tag":799,"props":1647,"children":1648},{},[1649],{"type":43,"value":1650},"    uv build\n",{"type":38,"tag":63,"props":1652,"children":1654},{"id":1653},"migration-guide",[1655],{"type":43,"value":1656},"Migration Guide",{"type":38,"tag":46,"props":1658,"children":1659},{},[1660],{"type":43,"value":1661},"When a user requests migration from legacy tooling:",{"type":38,"tag":611,"props":1663,"children":1665},{"id":1664},"from-requirementstxt-pip",[1666],{"type":43,"value":1667},"From requirements.txt + pip",{"type":38,"tag":46,"props":1669,"children":1670},{},[1671],{"type":43,"value":1672},"First, determine the nature of the code:",{"type":38,"tag":46,"props":1674,"children":1675},{},[1676,1681,1683,1689],{"type":38,"tag":121,"props":1677,"children":1678},{},[1679],{"type":43,"value":1680},"For standalone scripts",{"type":43,"value":1682},": Convert to PEP 723 inline metadata (see ",{"type":38,"tag":52,"props":1684,"children":1686},{"href":1685},".\u002Freferences\u002Fpep723-scripts.md",[1687],{"type":43,"value":1688},"pep723-scripts.md",{"type":43,"value":364},{"type":38,"tag":46,"props":1691,"children":1692},{},[1693,1698],{"type":38,"tag":121,"props":1694,"children":1695},{},[1696],{"type":43,"value":1697},"For projects",{"type":43,"value":1699},":",{"type":38,"tag":454,"props":1701,"children":1703},{"className":791,"code":1702,"language":793,"meta":462,"style":462},"# Initialize uv in existing project\nuv init --bare\n\n# Add dependencies using uv (not by editing pyproject.toml)\nuv add requests rich  # add each package\n\n# Or import from requirements.txt (review each package before adding)\n# Note: Complex version specifiers may need manual handling\ngrep -v '^#' requirements.txt | grep -v '^-' | grep -v '^\\s*$' | while read -r pkg; do\n    uv add \"$pkg\" || echo \"Failed to add: $pkg\"\ndone\n\nuv sync\n",[1704],{"type":38,"tag":85,"props":1705,"children":1706},{"__ignoreMap":462},[1707,1715,1731,1738,1746,1771,1778,1786,1794,1915,1971,1979,1986],{"type":38,"tag":799,"props":1708,"children":1709},{"class":801,"line":802},[1710],{"type":38,"tag":799,"props":1711,"children":1712},{"style":806},[1713],{"type":43,"value":1714},"# Initialize uv in existing project\n",{"type":38,"tag":799,"props":1716,"children":1717},{"class":801,"line":812},[1718,1722,1726],{"type":38,"tag":799,"props":1719,"children":1720},{"style":816},[1721],{"type":43,"value":508},{"type":38,"tag":799,"props":1723,"children":1724},{"style":821},[1725],{"type":43,"value":824},{"type":38,"tag":799,"props":1727,"children":1728},{"style":821},[1729],{"type":43,"value":1730}," --bare\n",{"type":38,"tag":799,"props":1732,"children":1733},{"class":801,"line":832},[1734],{"type":38,"tag":799,"props":1735,"children":1736},{"emptyLinePlaceholder":850},[1737],{"type":43,"value":853},{"type":38,"tag":799,"props":1739,"children":1740},{"class":801,"line":846},[1741],{"type":38,"tag":799,"props":1742,"children":1743},{"style":806},[1744],{"type":43,"value":1745},"# Add dependencies using uv (not by editing pyproject.toml)\n",{"type":38,"tag":799,"props":1747,"children":1748},{"class":801,"line":856},[1749,1753,1757,1761,1766],{"type":38,"tag":799,"props":1750,"children":1751},{"style":816},[1752],{"type":43,"value":508},{"type":38,"tag":799,"props":1754,"children":1755},{"style":821},[1756],{"type":43,"value":875},{"type":38,"tag":799,"props":1758,"children":1759},{"style":821},[1760],{"type":43,"value":880},{"type":38,"tag":799,"props":1762,"children":1763},{"style":821},[1764],{"type":43,"value":1765}," rich",{"type":38,"tag":799,"props":1767,"children":1768},{"style":806},[1769],{"type":43,"value":1770},"  # add each package\n",{"type":38,"tag":799,"props":1772,"children":1773},{"class":801,"line":865},[1774],{"type":38,"tag":799,"props":1775,"children":1776},{"emptyLinePlaceholder":850},[1777],{"type":43,"value":853},{"type":38,"tag":799,"props":1779,"children":1780},{"class":801,"line":888},[1781],{"type":38,"tag":799,"props":1782,"children":1783},{"style":806},[1784],{"type":43,"value":1785},"# Or import from requirements.txt (review each package before adding)\n",{"type":38,"tag":799,"props":1787,"children":1788},{"class":801,"line":896},[1789],{"type":38,"tag":799,"props":1790,"children":1791},{"style":806},[1792],{"type":43,"value":1793},"# Note: Complex version specifiers may need manual handling\n",{"type":38,"tag":799,"props":1795,"children":1796},{"class":801,"line":905},[1797,1802,1807,1813,1818,1823,1828,1833,1838,1842,1846,1851,1855,1859,1863,1867,1871,1876,1880,1884,1890,1895,1900,1905,1910],{"type":38,"tag":799,"props":1798,"children":1799},{"style":816},[1800],{"type":43,"value":1801},"grep",{"type":38,"tag":799,"props":1803,"children":1804},{"style":821},[1805],{"type":43,"value":1806}," -v",{"type":38,"tag":799,"props":1808,"children":1810},{"style":1809},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1811],{"type":43,"value":1812}," '",{"type":38,"tag":799,"props":1814,"children":1815},{"style":821},[1816],{"type":43,"value":1817},"^#",{"type":38,"tag":799,"props":1819,"children":1820},{"style":1809},[1821],{"type":43,"value":1822},"'",{"type":38,"tag":799,"props":1824,"children":1825},{"style":821},[1826],{"type":43,"value":1827}," requirements.txt",{"type":38,"tag":799,"props":1829,"children":1830},{"style":1809},[1831],{"type":43,"value":1832}," |",{"type":38,"tag":799,"props":1834,"children":1835},{"style":816},[1836],{"type":43,"value":1837}," grep",{"type":38,"tag":799,"props":1839,"children":1840},{"style":821},[1841],{"type":43,"value":1806},{"type":38,"tag":799,"props":1843,"children":1844},{"style":1809},[1845],{"type":43,"value":1812},{"type":38,"tag":799,"props":1847,"children":1848},{"style":821},[1849],{"type":43,"value":1850},"^-",{"type":38,"tag":799,"props":1852,"children":1853},{"style":1809},[1854],{"type":43,"value":1822},{"type":38,"tag":799,"props":1856,"children":1857},{"style":1809},[1858],{"type":43,"value":1832},{"type":38,"tag":799,"props":1860,"children":1861},{"style":816},[1862],{"type":43,"value":1837},{"type":38,"tag":799,"props":1864,"children":1865},{"style":821},[1866],{"type":43,"value":1806},{"type":38,"tag":799,"props":1868,"children":1869},{"style":1809},[1870],{"type":43,"value":1812},{"type":38,"tag":799,"props":1872,"children":1873},{"style":821},[1874],{"type":43,"value":1875},"^\\s*$",{"type":38,"tag":799,"props":1877,"children":1878},{"style":1809},[1879],{"type":43,"value":1822},{"type":38,"tag":799,"props":1881,"children":1882},{"style":1809},[1883],{"type":43,"value":1832},{"type":38,"tag":799,"props":1885,"children":1887},{"style":1886},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[1888],{"type":43,"value":1889}," while",{"type":38,"tag":799,"props":1891,"children":1892},{"style":836},[1893],{"type":43,"value":1894}," read",{"type":38,"tag":799,"props":1896,"children":1897},{"style":821},[1898],{"type":43,"value":1899}," -r",{"type":38,"tag":799,"props":1901,"children":1902},{"style":821},[1903],{"type":43,"value":1904}," pkg",{"type":38,"tag":799,"props":1906,"children":1907},{"style":1809},[1908],{"type":43,"value":1909},";",{"type":38,"tag":799,"props":1911,"children":1912},{"style":1886},[1913],{"type":43,"value":1914}," do\n",{"type":38,"tag":799,"props":1916,"children":1917},{"class":801,"line":942},[1918,1923,1927,1932,1938,1943,1948,1953,1957,1962,1966],{"type":38,"tag":799,"props":1919,"children":1920},{"style":816},[1921],{"type":43,"value":1922},"    uv",{"type":38,"tag":799,"props":1924,"children":1925},{"style":821},[1926],{"type":43,"value":875},{"type":38,"tag":799,"props":1928,"children":1929},{"style":1809},[1930],{"type":43,"value":1931}," \"",{"type":38,"tag":799,"props":1933,"children":1935},{"style":1934},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1936],{"type":43,"value":1937},"$pkg",{"type":38,"tag":799,"props":1939,"children":1940},{"style":1809},[1941],{"type":43,"value":1942},"\"",{"type":38,"tag":799,"props":1944,"children":1945},{"style":1809},[1946],{"type":43,"value":1947}," ||",{"type":38,"tag":799,"props":1949,"children":1950},{"style":836},[1951],{"type":43,"value":1952}," echo",{"type":38,"tag":799,"props":1954,"children":1955},{"style":1809},[1956],{"type":43,"value":1931},{"type":38,"tag":799,"props":1958,"children":1959},{"style":821},[1960],{"type":43,"value":1961},"Failed to add: ",{"type":38,"tag":799,"props":1963,"children":1964},{"style":1934},[1965],{"type":43,"value":1937},{"type":38,"tag":799,"props":1967,"children":1968},{"style":1809},[1969],{"type":43,"value":1970},"\"\n",{"type":38,"tag":799,"props":1972,"children":1973},{"class":801,"line":950},[1974],{"type":38,"tag":799,"props":1975,"children":1976},{"style":1886},[1977],{"type":43,"value":1978},"done\n",{"type":38,"tag":799,"props":1980,"children":1981},{"class":801,"line":959},[1982],{"type":38,"tag":799,"props":1983,"children":1984},{"emptyLinePlaceholder":850},[1985],{"type":43,"value":853},{"type":38,"tag":799,"props":1987,"children":1988},{"class":801,"line":982},[1989,1993],{"type":38,"tag":799,"props":1990,"children":1991},{"style":816},[1992],{"type":43,"value":508},{"type":38,"tag":799,"props":1994,"children":1995},{"style":821},[1996],{"type":43,"value":1997}," sync\n",{"type":38,"tag":46,"props":1999,"children":2000},{},[2001],{"type":43,"value":2002},"Then:",{"type":38,"tag":2004,"props":2005,"children":2006},"ol",{},[2007,2025,2044],{"type":38,"tag":74,"props":2008,"children":2009},{},[2010,2012,2017,2019],{"type":43,"value":2011},"Delete ",{"type":38,"tag":85,"props":2013,"children":2015},{"className":2014},[],[2016],{"type":43,"value":305},{"type":43,"value":2018},", ",{"type":38,"tag":85,"props":2020,"children":2022},{"className":2021},[],[2023],{"type":43,"value":2024},"requirements-dev.txt",{"type":38,"tag":74,"props":2026,"children":2027},{},[2028,2030,2036,2037,2043],{"type":43,"value":2029},"Delete virtual environment (",{"type":38,"tag":85,"props":2031,"children":2033},{"className":2032},[],[2034],{"type":43,"value":2035},"venv\u002F",{"type":43,"value":2018},{"type":38,"tag":85,"props":2038,"children":2040},{"className":2039},[],[2041],{"type":43,"value":2042},".venv\u002F",{"type":43,"value":364},{"type":38,"tag":74,"props":2045,"children":2046},{},[2047,2049,2055],{"type":43,"value":2048},"Add ",{"type":38,"tag":85,"props":2050,"children":2052},{"className":2051},[],[2053],{"type":43,"value":2054},"uv.lock",{"type":43,"value":2056}," to version control",{"type":38,"tag":611,"props":2058,"children":2060},{"id":2059},"from-setuppy-setupcfg",[2061],{"type":43,"value":2062},"From setup.py \u002F setup.cfg",{"type":38,"tag":2004,"props":2064,"children":2065},{},[2066,2079,2096,2108,2119],{"type":38,"tag":74,"props":2067,"children":2068},{},[2069,2071,2077],{"type":43,"value":2070},"Run ",{"type":38,"tag":85,"props":2072,"children":2074},{"className":2073},[],[2075],{"type":43,"value":2076},"uv init --bare",{"type":43,"value":2078}," to create pyproject.toml",{"type":38,"tag":74,"props":2080,"children":2081},{},[2082,2083,2088,2090],{"type":43,"value":434},{"type":38,"tag":85,"props":2084,"children":2086},{"className":2085},[],[2087],{"type":43,"value":226},{"type":43,"value":2089}," to add each dependency from ",{"type":38,"tag":85,"props":2091,"children":2093},{"className":2092},[],[2094],{"type":43,"value":2095},"install_requires",{"type":38,"tag":74,"props":2097,"children":2098},{},[2099,2100,2106],{"type":43,"value":434},{"type":38,"tag":85,"props":2101,"children":2103},{"className":2102},[],[2104],{"type":43,"value":2105},"uv add --group dev",{"type":43,"value":2107}," for dev dependencies",{"type":38,"tag":74,"props":2109,"children":2110},{},[2111,2113],{"type":43,"value":2112},"Copy non-dependency metadata (name, version, description, etc.) to ",{"type":38,"tag":85,"props":2114,"children":2116},{"className":2115},[],[2117],{"type":43,"value":2118},"[project]",{"type":38,"tag":74,"props":2120,"children":2121},{},[2122,2123,2129,2130,2136,2137],{"type":43,"value":2011},{"type":38,"tag":85,"props":2124,"children":2126},{"className":2125},[],[2127],{"type":43,"value":2128},"setup.py",{"type":43,"value":2018},{"type":38,"tag":85,"props":2131,"children":2133},{"className":2132},[],[2134],{"type":43,"value":2135},"setup.cfg",{"type":43,"value":2018},{"type":38,"tag":85,"props":2138,"children":2140},{"className":2139},[],[2141],{"type":43,"value":2142},"MANIFEST.in",{"type":38,"tag":611,"props":2144,"children":2146},{"id":2145},"from-flake8-black-isort",[2147],{"type":43,"value":2148},"From flake8 + black + isort",{"type":38,"tag":2004,"props":2150,"children":2151},{},[2152,2162,2188,2199,2211,2223],{"type":38,"tag":74,"props":2153,"children":2154},{},[2155,2157],{"type":43,"value":2156},"Remove flake8, black, isort via ",{"type":38,"tag":85,"props":2158,"children":2160},{"className":2159},[],[2161],{"type":43,"value":414},{"type":38,"tag":74,"props":2163,"children":2164},{},[2165,2166,2172,2173,2179,2180,2186],{"type":43,"value":2011},{"type":38,"tag":85,"props":2167,"children":2169},{"className":2168},[],[2170],{"type":43,"value":2171},".flake8",{"type":43,"value":2018},{"type":38,"tag":85,"props":2174,"children":2176},{"className":2175},[],[2177],{"type":43,"value":2178},"pyproject.toml [tool.black]",{"type":43,"value":2018},{"type":38,"tag":85,"props":2181,"children":2183},{"className":2182},[],[2184],{"type":43,"value":2185},"[tool.isort]",{"type":43,"value":2187}," configs",{"type":38,"tag":74,"props":2189,"children":2190},{},[2191,2193],{"type":43,"value":2192},"Add ruff: ",{"type":38,"tag":85,"props":2194,"children":2196},{"className":2195},[],[2197],{"type":43,"value":2198},"uv add --group dev ruff",{"type":38,"tag":74,"props":2200,"children":2201},{},[2202,2204,2210],{"type":43,"value":2203},"Add ruff configuration (see ",{"type":38,"tag":52,"props":2205,"children":2207},{"href":2206},".\u002Freferences\u002Fruff-config.md",[2208],{"type":43,"value":2209},"ruff-config.md",{"type":43,"value":364},{"type":38,"tag":74,"props":2212,"children":2213},{},[2214,2215,2221],{"type":43,"value":2070},{"type":38,"tag":85,"props":2216,"children":2218},{"className":2217},[],[2219],{"type":43,"value":2220},"uv run ruff check --fix .",{"type":43,"value":2222}," to apply fixes",{"type":38,"tag":74,"props":2224,"children":2225},{},[2226,2227,2233],{"type":43,"value":2070},{"type":38,"tag":85,"props":2228,"children":2230},{"className":2229},[],[2231],{"type":43,"value":2232},"uv run ruff format .",{"type":43,"value":2234}," to format",{"type":38,"tag":611,"props":2236,"children":2238},{"id":2237},"from-mypy-pyright",[2239],{"type":43,"value":2240},"From mypy \u002F pyright",{"type":38,"tag":2004,"props":2242,"children":2243},{},[2244,2254,2289,2300],{"type":38,"tag":74,"props":2245,"children":2246},{},[2247,2249],{"type":43,"value":2248},"Remove mypy\u002Fpyright via ",{"type":38,"tag":85,"props":2250,"children":2252},{"className":2251},[],[2253],{"type":43,"value":414},{"type":38,"tag":74,"props":2255,"children":2256},{},[2257,2258,2264,2265,2271,2273,2279,2281,2287],{"type":43,"value":2011},{"type":38,"tag":85,"props":2259,"children":2261},{"className":2260},[],[2262],{"type":43,"value":2263},"mypy.ini",{"type":43,"value":2018},{"type":38,"tag":85,"props":2266,"children":2268},{"className":2267},[],[2269],{"type":43,"value":2270},"pyrightconfig.json",{"type":43,"value":2272},", or ",{"type":38,"tag":85,"props":2274,"children":2276},{"className":2275},[],[2277],{"type":43,"value":2278},"[tool.mypy]",{"type":43,"value":2280},"\u002F",{"type":38,"tag":85,"props":2282,"children":2284},{"className":2283},[],[2285],{"type":43,"value":2286},"[tool.pyright]",{"type":43,"value":2288}," sections",{"type":38,"tag":74,"props":2290,"children":2291},{},[2292,2294],{"type":43,"value":2293},"Add ty: ",{"type":38,"tag":85,"props":2295,"children":2297},{"className":2296},[],[2298],{"type":43,"value":2299},"uv add --group dev ty",{"type":38,"tag":74,"props":2301,"children":2302},{},[2303,2304],{"type":43,"value":2070},{"type":38,"tag":85,"props":2305,"children":2307},{"className":2306},[],[2308],{"type":43,"value":2309},"uv run ty check src\u002F",{"type":38,"tag":63,"props":2311,"children":2313},{"id":2312},"quick-reference-uv-commands",[2314],{"type":43,"value":2315},"Quick Reference: uv Commands",{"type":38,"tag":155,"props":2317,"children":2318},{},[2319,2335],{"type":38,"tag":159,"props":2320,"children":2321},{},[2322],{"type":38,"tag":163,"props":2323,"children":2324},{},[2325,2330],{"type":38,"tag":167,"props":2326,"children":2327},{},[2328],{"type":43,"value":2329},"Command",{"type":38,"tag":167,"props":2331,"children":2332},{},[2333],{"type":43,"value":2334},"Description",{"type":38,"tag":178,"props":2336,"children":2337},{},[2338,2355,2372,2388,2405,2421,2437,2454,2470,2487,2504],{"type":38,"tag":163,"props":2339,"children":2340},{},[2341,2350],{"type":38,"tag":185,"props":2342,"children":2343},{},[2344],{"type":38,"tag":85,"props":2345,"children":2347},{"className":2346},[],[2348],{"type":43,"value":2349},"uv init",{"type":38,"tag":185,"props":2351,"children":2352},{},[2353],{"type":43,"value":2354},"Create new project",{"type":38,"tag":163,"props":2356,"children":2357},{},[2358,2367],{"type":38,"tag":185,"props":2359,"children":2360},{},[2361],{"type":38,"tag":85,"props":2362,"children":2364},{"className":2363},[],[2365],{"type":43,"value":2366},"uv init --package",{"type":38,"tag":185,"props":2368,"children":2369},{},[2370],{"type":43,"value":2371},"Create distributable package",{"type":38,"tag":163,"props":2373,"children":2374},{},[2375,2383],{"type":38,"tag":185,"props":2376,"children":2377},{},[2378],{"type":38,"tag":85,"props":2379,"children":2381},{"className":2380},[],[2382],{"type":43,"value":251},{"type":38,"tag":185,"props":2384,"children":2385},{},[2386],{"type":43,"value":2387},"Add dependency",{"type":38,"tag":163,"props":2389,"children":2390},{},[2391,2400],{"type":38,"tag":185,"props":2392,"children":2393},{},[2394],{"type":38,"tag":85,"props":2395,"children":2397},{"className":2396},[],[2398],{"type":43,"value":2399},"uv add --group dev \u003Cpkg>",{"type":38,"tag":185,"props":2401,"children":2402},{},[2403],{"type":43,"value":2404},"Add to dependency group",{"type":38,"tag":163,"props":2406,"children":2407},{},[2408,2416],{"type":38,"tag":185,"props":2409,"children":2410},{},[2411],{"type":38,"tag":85,"props":2412,"children":2414},{"className":2413},[],[2415],{"type":43,"value":259},{"type":38,"tag":185,"props":2417,"children":2418},{},[2419],{"type":43,"value":2420},"Remove dependency",{"type":38,"tag":163,"props":2422,"children":2423},{},[2424,2432],{"type":38,"tag":185,"props":2425,"children":2426},{},[2427],{"type":38,"tag":85,"props":2428,"children":2430},{"className":2429},[],[2431],{"type":43,"value":234},{"type":38,"tag":185,"props":2433,"children":2434},{},[2435],{"type":43,"value":2436},"Install dependencies",{"type":38,"tag":163,"props":2438,"children":2439},{},[2440,2449],{"type":38,"tag":185,"props":2441,"children":2442},{},[2443],{"type":38,"tag":85,"props":2444,"children":2446},{"className":2445},[],[2447],{"type":43,"value":2448},"uv sync --all-groups",{"type":38,"tag":185,"props":2450,"children":2451},{},[2452],{"type":43,"value":2453},"Install all dependency groups",{"type":38,"tag":163,"props":2455,"children":2456},{},[2457,2465],{"type":38,"tag":185,"props":2458,"children":2459},{},[2460],{"type":38,"tag":85,"props":2461,"children":2463},{"className":2462},[],[2464],{"type":43,"value":373},{"type":38,"tag":185,"props":2466,"children":2467},{},[2468],{"type":43,"value":2469},"Run command in venv",{"type":38,"tag":163,"props":2471,"children":2472},{},[2473,2482],{"type":38,"tag":185,"props":2474,"children":2475},{},[2476],{"type":38,"tag":85,"props":2477,"children":2479},{"className":2478},[],[2480],{"type":43,"value":2481},"uv run --with \u003Cpkg> \u003Ccmd>",{"type":38,"tag":185,"props":2483,"children":2484},{},[2485],{"type":43,"value":2486},"Run with temporary dependency",{"type":38,"tag":163,"props":2488,"children":2489},{},[2490,2499],{"type":38,"tag":185,"props":2491,"children":2492},{},[2493],{"type":38,"tag":85,"props":2494,"children":2496},{"className":2495},[],[2497],{"type":43,"value":2498},"uv build",{"type":38,"tag":185,"props":2500,"children":2501},{},[2502],{"type":43,"value":2503},"Build package",{"type":38,"tag":163,"props":2505,"children":2506},{},[2507,2516],{"type":38,"tag":185,"props":2508,"children":2509},{},[2510],{"type":38,"tag":85,"props":2511,"children":2513},{"className":2512},[],[2514],{"type":43,"value":2515},"uv publish",{"type":38,"tag":185,"props":2517,"children":2518},{},[2519],{"type":43,"value":2520},"Publish to PyPI",{"type":38,"tag":611,"props":2522,"children":2524},{"id":2523},"ad-hoc-dependencies-with-with",[2525,2527],{"type":43,"value":2526},"Ad-hoc Dependencies with ",{"type":38,"tag":85,"props":2528,"children":2530},{"className":2529},[],[2531],{"type":43,"value":2532},"--with",{"type":38,"tag":46,"props":2534,"children":2535},{},[2536,2537,2543],{"type":43,"value":434},{"type":38,"tag":85,"props":2538,"children":2540},{"className":2539},[],[2541],{"type":43,"value":2542},"uv run --with",{"type":43,"value":2544}," for one-off commands that need packages not in your project:",{"type":38,"tag":454,"props":2546,"children":2548},{"className":791,"code":2547,"language":793,"meta":462,"style":462},"# Run Python with a temporary package\nuv run --with requests python -c \"import requests; print(requests.get('https:\u002F\u002Fhttpbin.org\u002Fip').json())\"\n\n# Run a module with temporary deps\nuv run --with rich python -m rich.progress\n\n# Multiple packages\nuv run --with requests --with rich python script.py\n\n# Combine with project deps (adds to existing venv)\nuv run --with httpx pytest  # project deps + httpx\n",[2549],{"type":38,"tag":85,"props":2550,"children":2551},{"__ignoreMap":462},[2552,2560,2602,2609,2617,2650,2657,2665,2701,2708,2716],{"type":38,"tag":799,"props":2553,"children":2554},{"class":801,"line":802},[2555],{"type":38,"tag":799,"props":2556,"children":2557},{"style":806},[2558],{"type":43,"value":2559},"# Run Python with a temporary package\n",{"type":38,"tag":799,"props":2561,"children":2562},{"class":801,"line":812},[2563,2567,2571,2576,2580,2584,2589,2593,2598],{"type":38,"tag":799,"props":2564,"children":2565},{"style":816},[2566],{"type":43,"value":508},{"type":38,"tag":799,"props":2568,"children":2569},{"style":821},[2570],{"type":43,"value":969},{"type":38,"tag":799,"props":2572,"children":2573},{"style":821},[2574],{"type":43,"value":2575}," --with",{"type":38,"tag":799,"props":2577,"children":2578},{"style":821},[2579],{"type":43,"value":880},{"type":38,"tag":799,"props":2581,"children":2582},{"style":821},[2583],{"type":43,"value":974},{"type":38,"tag":799,"props":2585,"children":2586},{"style":821},[2587],{"type":43,"value":2588}," -c",{"type":38,"tag":799,"props":2590,"children":2591},{"style":1809},[2592],{"type":43,"value":1931},{"type":38,"tag":799,"props":2594,"children":2595},{"style":821},[2596],{"type":43,"value":2597},"import requests; print(requests.get('https:\u002F\u002Fhttpbin.org\u002Fip').json())",{"type":38,"tag":799,"props":2599,"children":2600},{"style":1809},[2601],{"type":43,"value":1970},{"type":38,"tag":799,"props":2603,"children":2604},{"class":801,"line":832},[2605],{"type":38,"tag":799,"props":2606,"children":2607},{"emptyLinePlaceholder":850},[2608],{"type":43,"value":853},{"type":38,"tag":799,"props":2610,"children":2611},{"class":801,"line":846},[2612],{"type":38,"tag":799,"props":2613,"children":2614},{"style":806},[2615],{"type":43,"value":2616},"# Run a module with temporary deps\n",{"type":38,"tag":799,"props":2618,"children":2619},{"class":801,"line":856},[2620,2624,2628,2632,2636,2640,2645],{"type":38,"tag":799,"props":2621,"children":2622},{"style":816},[2623],{"type":43,"value":508},{"type":38,"tag":799,"props":2625,"children":2626},{"style":821},[2627],{"type":43,"value":969},{"type":38,"tag":799,"props":2629,"children":2630},{"style":821},[2631],{"type":43,"value":2575},{"type":38,"tag":799,"props":2633,"children":2634},{"style":821},[2635],{"type":43,"value":1765},{"type":38,"tag":799,"props":2637,"children":2638},{"style":821},[2639],{"type":43,"value":974},{"type":38,"tag":799,"props":2641,"children":2642},{"style":821},[2643],{"type":43,"value":2644}," -m",{"type":38,"tag":799,"props":2646,"children":2647},{"style":821},[2648],{"type":43,"value":2649}," rich.progress\n",{"type":38,"tag":799,"props":2651,"children":2652},{"class":801,"line":865},[2653],{"type":38,"tag":799,"props":2654,"children":2655},{"emptyLinePlaceholder":850},[2656],{"type":43,"value":853},{"type":38,"tag":799,"props":2658,"children":2659},{"class":801,"line":888},[2660],{"type":38,"tag":799,"props":2661,"children":2662},{"style":806},[2663],{"type":43,"value":2664},"# Multiple packages\n",{"type":38,"tag":799,"props":2666,"children":2667},{"class":801,"line":896},[2668,2672,2676,2680,2684,2688,2692,2696],{"type":38,"tag":799,"props":2669,"children":2670},{"style":816},[2671],{"type":43,"value":508},{"type":38,"tag":799,"props":2673,"children":2674},{"style":821},[2675],{"type":43,"value":969},{"type":38,"tag":799,"props":2677,"children":2678},{"style":821},[2679],{"type":43,"value":2575},{"type":38,"tag":799,"props":2681,"children":2682},{"style":821},[2683],{"type":43,"value":880},{"type":38,"tag":799,"props":2685,"children":2686},{"style":821},[2687],{"type":43,"value":2575},{"type":38,"tag":799,"props":2689,"children":2690},{"style":821},[2691],{"type":43,"value":1765},{"type":38,"tag":799,"props":2693,"children":2694},{"style":821},[2695],{"type":43,"value":974},{"type":38,"tag":799,"props":2697,"children":2698},{"style":821},[2699],{"type":43,"value":2700}," script.py\n",{"type":38,"tag":799,"props":2702,"children":2703},{"class":801,"line":905},[2704],{"type":38,"tag":799,"props":2705,"children":2706},{"emptyLinePlaceholder":850},[2707],{"type":43,"value":853},{"type":38,"tag":799,"props":2709,"children":2710},{"class":801,"line":942},[2711],{"type":38,"tag":799,"props":2712,"children":2713},{"style":806},[2714],{"type":43,"value":2715},"# Combine with project deps (adds to existing venv)\n",{"type":38,"tag":799,"props":2717,"children":2718},{"class":801,"line":950},[2719,2723,2727,2731,2736,2740],{"type":38,"tag":799,"props":2720,"children":2721},{"style":816},[2722],{"type":43,"value":508},{"type":38,"tag":799,"props":2724,"children":2725},{"style":821},[2726],{"type":43,"value":969},{"type":38,"tag":799,"props":2728,"children":2729},{"style":821},[2730],{"type":43,"value":2575},{"type":38,"tag":799,"props":2732,"children":2733},{"style":821},[2734],{"type":43,"value":2735}," httpx",{"type":38,"tag":799,"props":2737,"children":2738},{"style":821},[2739],{"type":43,"value":929},{"type":38,"tag":799,"props":2741,"children":2742},{"style":806},[2743],{"type":43,"value":2744},"  # project deps + httpx\n",{"type":38,"tag":46,"props":2746,"children":2747},{},[2748],{"type":38,"tag":121,"props":2749,"children":2750},{},[2751,2753,2758,2760,2765],{"type":43,"value":2752},"When to use ",{"type":38,"tag":85,"props":2754,"children":2756},{"className":2755},[],[2757],{"type":43,"value":2532},{"type":43,"value":2759}," vs ",{"type":38,"tag":85,"props":2761,"children":2763},{"className":2762},[],[2764],{"type":43,"value":226},{"type":43,"value":1699},{"type":38,"tag":70,"props":2767,"children":2768},{},[2769,2779],{"type":38,"tag":74,"props":2770,"children":2771},{},[2772,2777],{"type":38,"tag":85,"props":2773,"children":2775},{"className":2774},[],[2776],{"type":43,"value":226},{"type":43,"value":2778},": Package is a project dependency (goes in pyproject.toml\u002Fuv.lock)",{"type":38,"tag":74,"props":2780,"children":2781},{},[2782,2787],{"type":38,"tag":85,"props":2783,"children":2785},{"className":2784},[],[2786],{"type":43,"value":2532},{"type":43,"value":2788},": One-off usage, testing, or scripts outside a project context",{"type":38,"tag":46,"props":2790,"children":2791},{},[2792,2793,2799],{"type":43,"value":769},{"type":38,"tag":52,"props":2794,"children":2796},{"href":2795},".\u002Freferences\u002Fuv-commands.md",[2797],{"type":43,"value":2798},"uv-commands.md",{"type":43,"value":2800}," for complete reference.",{"type":38,"tag":63,"props":2802,"children":2804},{"id":2803},"quick-reference-dependency-groups",[2805],{"type":43,"value":2806},"Quick Reference: Dependency Groups",{"type":38,"tag":454,"props":2808,"children":2810},{"className":1159,"code":2809,"language":1161,"meta":462,"style":462},"[dependency-groups]\ndev = [\"ruff\", \"ty\"]\ntest = [\"pytest\", \"pytest-cov\", \"hypothesis\"]\ndocs = [\"sphinx\", \"myst-parser\"]\n",[2811],{"type":38,"tag":85,"props":2812,"children":2813},{"__ignoreMap":462},[2814,2821,2829,2837],{"type":38,"tag":799,"props":2815,"children":2816},{"class":801,"line":802},[2817],{"type":38,"tag":799,"props":2818,"children":2819},{},[2820],{"type":43,"value":1220},{"type":38,"tag":799,"props":2822,"children":2823},{"class":801,"line":812},[2824],{"type":38,"tag":799,"props":2825,"children":2826},{},[2827],{"type":43,"value":2828},"dev = [\"ruff\", \"ty\"]\n",{"type":38,"tag":799,"props":2830,"children":2831},{"class":801,"line":832},[2832],{"type":38,"tag":799,"props":2833,"children":2834},{},[2835],{"type":43,"value":2836},"test = [\"pytest\", \"pytest-cov\", \"hypothesis\"]\n",{"type":38,"tag":799,"props":2838,"children":2839},{"class":801,"line":846},[2840],{"type":38,"tag":799,"props":2841,"children":2842},{},[2843],{"type":43,"value":2844},"docs = [\"sphinx\", \"myst-parser\"]\n",{"type":38,"tag":46,"props":2846,"children":2847},{},[2848,2850],{"type":43,"value":2849},"Install with: ",{"type":38,"tag":85,"props":2851,"children":2853},{"className":2852},[],[2854],{"type":43,"value":2855},"uv sync --group dev --group test",{"type":38,"tag":63,"props":2857,"children":2859},{"id":2858},"best-practices-checklist",[2860],{"type":43,"value":2861},"Best Practices Checklist",{"type":38,"tag":70,"props":2863,"children":2866},{"className":2864},[2865],"contains-task-list",[2867,2887,2902,2919,2928,2937,2946,2961],{"type":38,"tag":74,"props":2868,"children":2871},{"className":2869},[2870],"task-list-item",[2872,2877,2879,2885],{"type":38,"tag":2873,"props":2874,"children":2876},"input",{"disabled":850,"type":2875},"checkbox",[],{"type":43,"value":2878}," Use ",{"type":38,"tag":85,"props":2880,"children":2882},{"className":2881},[],[2883],{"type":43,"value":2884},"src\u002F",{"type":43,"value":2886}," layout for packages",{"type":38,"tag":74,"props":2888,"children":2890},{"className":2889},[2870],[2891,2894,2896],{"type":38,"tag":2873,"props":2892,"children":2893},{"disabled":850,"type":2875},[],{"type":43,"value":2895}," Set ",{"type":38,"tag":85,"props":2897,"children":2899},{"className":2898},[],[2900],{"type":43,"value":2901},"requires-python = \">=3.11\"",{"type":38,"tag":74,"props":2903,"children":2905},{"className":2904},[2870],[2906,2909,2911,2917],{"type":38,"tag":2873,"props":2907,"children":2908},{"disabled":850,"type":2875},[],{"type":43,"value":2910}," Configure ruff with ",{"type":38,"tag":85,"props":2912,"children":2914},{"className":2913},[],[2915],{"type":43,"value":2916},"select = [\"ALL\"]",{"type":43,"value":2918}," and explicit ignores",{"type":38,"tag":74,"props":2920,"children":2922},{"className":2921},[2870],[2923,2926],{"type":38,"tag":2873,"props":2924,"children":2925},{"disabled":850,"type":2875},[],{"type":43,"value":2927}," Use ty for type checking",{"type":38,"tag":74,"props":2929,"children":2931},{"className":2930},[2870],[2932,2935],{"type":38,"tag":2873,"props":2933,"children":2934},{"disabled":850,"type":2875},[],{"type":43,"value":2936}," Enforce test coverage minimum (80%+)",{"type":38,"tag":74,"props":2938,"children":2940},{"className":2939},[2870],[2941,2944],{"type":38,"tag":2873,"props":2942,"children":2943},{"disabled":850,"type":2875},[],{"type":43,"value":2945}," Use dependency groups instead of extras for dev tools",{"type":38,"tag":74,"props":2947,"children":2949},{"className":2948},[2870],[2950,2953,2955,2960],{"type":38,"tag":2873,"props":2951,"children":2952},{"disabled":850,"type":2875},[],{"type":43,"value":2954}," Add ",{"type":38,"tag":85,"props":2956,"children":2958},{"className":2957},[],[2959],{"type":43,"value":2054},{"type":43,"value":2056},{"type":38,"tag":74,"props":2962,"children":2964},{"className":2963},[2870],[2965,2968],{"type":38,"tag":2873,"props":2966,"children":2967},{"disabled":850,"type":2875},[],{"type":43,"value":2969}," Use PEP 723 for standalone scripts",{"type":38,"tag":63,"props":2971,"children":2973},{"id":2972},"read-next",[2974],{"type":43,"value":2975},"Read Next",{"type":38,"tag":70,"props":2977,"children":2978},{},[2979,2990,2999,3008,3017,3028,3037,3047,3056],{"type":38,"tag":74,"props":2980,"children":2981},{},[2982,2988],{"type":38,"tag":52,"props":2983,"children":2985},{"href":2984},".\u002Freferences\u002Fmigration-checklist.md",[2986],{"type":43,"value":2987},"migration-checklist.md",{"type":43,"value":2989}," - Step-by-step migration cleanup",{"type":38,"tag":74,"props":2991,"children":2992},{},[2993,2997],{"type":38,"tag":52,"props":2994,"children":2995},{"href":1146},[2996],{"type":43,"value":1149},{"type":43,"value":2998}," - Complete pyproject.toml reference",{"type":38,"tag":74,"props":3000,"children":3001},{},[3002,3006],{"type":38,"tag":52,"props":3003,"children":3004},{"href":2795},[3005],{"type":43,"value":2798},{"type":43,"value":3007}," - uv command reference",{"type":38,"tag":74,"props":3009,"children":3010},{},[3011,3015],{"type":38,"tag":52,"props":3012,"children":3013},{"href":2206},[3014],{"type":43,"value":2209},{"type":43,"value":3016}," - Ruff linting\u002Fformatting configuration",{"type":38,"tag":74,"props":3018,"children":3019},{},[3020,3026],{"type":38,"tag":52,"props":3021,"children":3023},{"href":3022},".\u002Freferences\u002Ftesting.md",[3024],{"type":43,"value":3025},"testing.md",{"type":43,"value":3027}," - pytest and coverage setup",{"type":38,"tag":74,"props":3029,"children":3030},{},[3031,3035],{"type":38,"tag":52,"props":3032,"children":3033},{"href":1685},[3034],{"type":43,"value":1688},{"type":43,"value":3036}," - PEP 723 inline script metadata",{"type":38,"tag":74,"props":3038,"children":3039},{},[3040,3045],{"type":38,"tag":52,"props":3041,"children":3042},{"href":600},[3043],{"type":43,"value":3044},"prek.md",{"type":43,"value":3046}," - Fast pre-commit hooks with prek",{"type":38,"tag":74,"props":3048,"children":3049},{},[3050,3054],{"type":38,"tag":52,"props":3051,"children":3052},{"href":772},[3053],{"type":43,"value":775},{"type":43,"value":3055}," - Security hooks and dependency scanning",{"type":38,"tag":74,"props":3057,"children":3058},{},[3059,3065],{"type":38,"tag":52,"props":3060,"children":3062},{"href":3061},".\u002Freferences\u002Fdependabot.md",[3063],{"type":43,"value":3064},"dependabot.md",{"type":43,"value":3066}," - Automated dependency updates",{"type":38,"tag":3068,"props":3069,"children":3070},"style",{},[3071],{"type":43,"value":3072},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3074,"total":3172},[3075,3094,3104,3124,3139,3152,3162],{"slug":3076,"name":3076,"fn":3077,"description":3078,"org":3079,"tags":3080,"stars":20,"repoUrl":21,"updatedAt":3093},"address-sanitizer","detect memory errors during fuzzing","AddressSanitizer detects memory errors during fuzzing. Use when fuzzing C\u002FC++ code to find buffer overflows and use-after-free bugs.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3081,3084,3087,3090],{"name":3082,"slug":3083,"type":16},"C#","c",{"name":3085,"slug":3086,"type":16},"Debugging","debugging",{"name":3088,"slug":3089,"type":16},"Security","security",{"name":3091,"slug":3092,"type":16},"Testing","testing","2026-07-17T06:05:14.925095",{"slug":3095,"name":3095,"fn":3096,"description":3097,"org":3098,"tags":3099,"stars":20,"repoUrl":21,"updatedAt":3103},"aflpp","perform multi-core fuzzing of C\u002FC++ projects","AFL++ is a fork of AFL with better fuzzing performance and advanced features. Use for multi-core fuzzing of C\u002FC++ projects.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3100,3101,3102],{"name":3082,"slug":3083,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3091,"slug":3092,"type":16},"2026-07-17T06:05:12.433192",{"slug":3105,"name":3105,"fn":3106,"description":3107,"org":3108,"tags":3109,"stars":20,"repoUrl":21,"updatedAt":3123},"agentic-actions-auditor","audit GitHub Actions for security vulnerabilities","Audits GitHub Actions workflows for security vulnerabilities in AI agent integrations including Claude Code Action, Gemini CLI, OpenAI Codex, and GitHub AI Inference. Detects attack vectors where attacker-controlled input reaches AI agents running in CI\u002FCD pipelines, including env var intermediary patterns, direct expression injection, dangerous sandbox configurations, and wildcard user allowlists. Use when reviewing workflow files that invoke AI coding agents, auditing CI\u002FCD pipeline security for prompt injection risks, or evaluating agentic action configurations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3110,3113,3116,3119,3122],{"name":3111,"slug":3112,"type":16},"Agents","agents",{"name":3114,"slug":3115,"type":16},"CI\u002FCD","ci-cd",{"name":3117,"slug":3118,"type":16},"Code Analysis","code-analysis",{"name":3120,"slug":3121,"type":16},"GitHub Actions","github-actions",{"name":3088,"slug":3089,"type":16},"2026-07-18T05:47:48.564744",{"slug":3125,"name":3125,"fn":3126,"description":3127,"org":3128,"tags":3129,"stars":20,"repoUrl":21,"updatedAt":3138},"algorand-vulnerability-scanner","scan Algorand smart contracts for vulnerabilities","Scans Algorand smart contracts for 11 common vulnerabilities including rekeying attacks, unchecked transaction fees, missing field validations, and access control issues. Use when auditing Algorand projects (TEAL\u002FPyTeal).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3130,3133,3134,3135],{"name":3131,"slug":3132,"type":16},"Audit","audit",{"name":3117,"slug":3118,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3136,"slug":3137,"type":16},"Smart Contracts","smart-contracts","2026-07-18T05:47:43.989063",{"slug":3140,"name":3140,"fn":3141,"description":3142,"org":3143,"tags":3144,"stars":20,"repoUrl":21,"updatedAt":3151},"ask-questions-if-underspecified","clarify requirements before implementation","Clarify requirements before implementing. Use when serious doubts arise.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3145,3148],{"name":3146,"slug":3147,"type":16},"Engineering","engineering",{"name":3149,"slug":3150,"type":16},"Productivity","productivity","2026-07-17T06:05:33.543262",{"slug":3153,"name":3153,"fn":3154,"description":3155,"org":3156,"tags":3157,"stars":20,"repoUrl":21,"updatedAt":3161},"atheris","fuzz Python code with Atheris","Atheris is a coverage-guided Python fuzzer based on libFuzzer. Use for fuzzing pure Python code and Python C extensions.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3158,3159,3160],{"name":18,"slug":19,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3091,"slug":3092,"type":16},"2026-07-17T06:05:14.575191",{"slug":3163,"name":3163,"fn":3164,"description":3165,"org":3166,"tags":3167,"stars":20,"repoUrl":21,"updatedAt":3171},"audit-augmentation","augment code graphs with audit findings","Augments Trailmark code graphs with external audit findings from SARIF static analysis results, weAudit annotation files, and version-gated Trailmark 0.4.x binary-analysis graph exports. Maps findings to graph nodes by file and line overlap, creates severity-based subgraphs, and enables cross-referencing findings with pre-analysis data (blast radius, taint, etc.). Use when projecting SARIF results onto a code graph, overlaying weAudit annotations, importing binary graph findings, cross-referencing Semgrep, CodeQL, or binary-analysis findings with call graph data, or visualizing audit findings in the context of code structure.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3168,3169,3170],{"name":3131,"slug":3132,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3088,"slug":3089,"type":16},"2026-08-01T05:44:54.920542",77,{"items":3174,"total":3278},[3175,3182,3188,3196,3203,3208,3214,3220,3233,3244,3256,3267],{"slug":3076,"name":3076,"fn":3077,"description":3078,"org":3176,"tags":3177,"stars":20,"repoUrl":21,"updatedAt":3093},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3178,3179,3180,3181],{"name":3082,"slug":3083,"type":16},{"name":3085,"slug":3086,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3091,"slug":3092,"type":16},{"slug":3095,"name":3095,"fn":3096,"description":3097,"org":3183,"tags":3184,"stars":20,"repoUrl":21,"updatedAt":3103},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3185,3186,3187],{"name":3082,"slug":3083,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3091,"slug":3092,"type":16},{"slug":3105,"name":3105,"fn":3106,"description":3107,"org":3189,"tags":3190,"stars":20,"repoUrl":21,"updatedAt":3123},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3191,3192,3193,3194,3195],{"name":3111,"slug":3112,"type":16},{"name":3114,"slug":3115,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3120,"slug":3121,"type":16},{"name":3088,"slug":3089,"type":16},{"slug":3125,"name":3125,"fn":3126,"description":3127,"org":3197,"tags":3198,"stars":20,"repoUrl":21,"updatedAt":3138},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3199,3200,3201,3202],{"name":3131,"slug":3132,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3136,"slug":3137,"type":16},{"slug":3140,"name":3140,"fn":3141,"description":3142,"org":3204,"tags":3205,"stars":20,"repoUrl":21,"updatedAt":3151},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3206,3207],{"name":3146,"slug":3147,"type":16},{"name":3149,"slug":3150,"type":16},{"slug":3153,"name":3153,"fn":3154,"description":3155,"org":3209,"tags":3210,"stars":20,"repoUrl":21,"updatedAt":3161},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3211,3212,3213],{"name":18,"slug":19,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3091,"slug":3092,"type":16},{"slug":3163,"name":3163,"fn":3164,"description":3165,"org":3215,"tags":3216,"stars":20,"repoUrl":21,"updatedAt":3171},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3217,3218,3219],{"name":3131,"slug":3132,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3088,"slug":3089,"type":16},{"slug":3221,"name":3221,"fn":3222,"description":3223,"org":3224,"tags":3225,"stars":20,"repoUrl":21,"updatedAt":3232},"audit-context-building","build architectural context for code analysis","Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3226,3229,3230,3231],{"name":3227,"slug":3228,"type":16},"Architecture","architecture",{"name":3131,"slug":3132,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3146,"slug":3147,"type":16},"2026-07-18T05:47:40.122449",{"slug":3234,"name":3234,"fn":3235,"description":3236,"org":3237,"tags":3238,"stars":20,"repoUrl":21,"updatedAt":3243},"audit-prep-assistant","prepare codebases for security audits","Prepares codebases for security review using Trail of Bits' checklist. Helps set review goals, runs static analysis tools, increases test coverage, removes dead code, ensures accessibility, and generates documentation (flowcharts, user stories, inline comments).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3239,3240,3241,3242],{"name":3131,"slug":3132,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3146,"slug":3147,"type":16},{"name":3088,"slug":3089,"type":16},"2026-07-18T05:47:39.210985",{"slug":3245,"name":3245,"fn":3246,"description":3247,"org":3248,"tags":3249,"stars":20,"repoUrl":21,"updatedAt":3255},"burpsuite-project-parser","parse Burp Suite project files","Searches and explores Burp Suite project files (.burp) from the command line. Use when searching response headers or bodies with regex patterns, extracting security audit findings, dumping proxy history or site map data, or analyzing HTTP traffic captured in a Burp project.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3250,3251,3254],{"name":3131,"slug":3132,"type":16},{"name":3252,"slug":3253,"type":16},"CLI","cli",{"name":3088,"slug":3089,"type":16},"2026-07-17T06:05:33.198077",{"slug":3257,"name":3257,"fn":3258,"description":3259,"org":3260,"tags":3261,"stars":20,"repoUrl":21,"updatedAt":3266},"c-review","audit C and C++ code","Performs comprehensive C\u002FC++ security review for memory corruption, integer overflows, race conditions, and platform-specific vulnerabilities. Use when auditing native C\u002FC++ applications, reviewing daemons or services for memory safety, or hunting integer overflow \u002F use-after-free \u002F race conditions in userspace code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3262,3263,3264,3265],{"name":3131,"slug":3132,"type":16},{"name":3082,"slug":3083,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3088,"slug":3089,"type":16},"2026-07-17T06:05:11.333374",{"slug":3268,"name":3268,"fn":3269,"description":3270,"org":3271,"tags":3272,"stars":20,"repoUrl":21,"updatedAt":3277},"cairo-vulnerability-scanner","scan Cairo and StarkNet contracts for vulnerabilities","Scans Cairo\u002FStarkNet smart contracts for 6 critical vulnerabilities including felt252 arithmetic overflow, L1-L2 messaging issues, address conversion problems, and signature replay. Use when auditing StarkNet projects.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3273,3274,3275,3276],{"name":3131,"slug":3132,"type":16},{"name":3117,"slug":3118,"type":16},{"name":3088,"slug":3089,"type":16},{"name":3136,"slug":3137,"type":16},"2026-07-18T05:47:42.84568",111]