add(scripts): dev convenience runner (PowerShell + Bash)
Wrap the most common day-to-day commands so we stop typing .venv/Scripts/python.exe -m ... by hand. Mirrors the same tasks on both shells; binaries always resolved from the project's .venv so the host machine's globally-installed Python doesn't leak in. Tasks (both shells): install create .venv, install arautopilot[dev] in editable mode test run pytest (extra args forwarded: e.g. test -k roundtrip) test-cov pytest with branch coverage + HTML report lint ruff check (read-only) fix ruff check --fix + ruff format format ruff format typecheck mypy --strict over core/library/shared check full quality gate: lint + typecheck + test demo run examples/sprint0_demo.py clean remove build/cache artefacts + examples/output Usage: .\scripts\dev.ps1 check (Windows PowerShell) bash scripts/dev.sh check (Git Bash / WSL / Linux) Verification: `bash scripts/dev.sh check` runs lint + typecheck + 80 tests all green in ~0.5s on this machine. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
+203
@@ -0,0 +1,203 @@
|
||||
# =============================================================================
|
||||
# AR-Autopilot — developer convenience script (PowerShell, Windows)
|
||||
# =============================================================================
|
||||
#
|
||||
# Usage (from the repo root):
|
||||
#
|
||||
# .\scripts\dev.ps1 <task> [args...]
|
||||
#
|
||||
# Tasks:
|
||||
#
|
||||
# install Install the package + dev dependencies into .venv (creates venv if needed)
|
||||
# test Run the pytest suite
|
||||
# test-cov Run pytest with branch coverage report
|
||||
# lint Run ruff check (no auto-fix)
|
||||
# fix Run ruff check --fix (auto-fix safe findings) then ruff format
|
||||
# format Run ruff format only
|
||||
# typecheck Run mypy --strict over core/library/shared
|
||||
# check Run lint + typecheck + test (the full quality gate)
|
||||
# demo Run examples/sprint0_demo.py
|
||||
# clean Remove build artefacts, __pycache__/, .pytest_cache/, .mypy_cache/, .ruff_cache/
|
||||
# help Show this message
|
||||
#
|
||||
# All tasks resolve binaries from .\.venv\Scripts\ — they never depend on
|
||||
# what's globally installed on the machine.
|
||||
#
|
||||
# =============================================================================
|
||||
|
||||
[CmdletBinding()]
|
||||
param(
|
||||
[Parameter(Position = 0)]
|
||||
[string] $Task = 'help',
|
||||
|
||||
[Parameter(ValueFromRemainingArguments = $true)]
|
||||
[string[]] $Args
|
||||
)
|
||||
|
||||
$ErrorActionPreference = 'Stop'
|
||||
Set-StrictMode -Version Latest
|
||||
|
||||
# Resolve repo root regardless of where the script was invoked from.
|
||||
$RepoRoot = Resolve-Path (Join-Path $PSScriptRoot '..')
|
||||
Set-Location $RepoRoot
|
||||
|
||||
$VenvDir = Join-Path $RepoRoot '.venv'
|
||||
$VenvScripts = Join-Path $VenvDir 'Scripts'
|
||||
$Python = Join-Path $VenvScripts 'python.exe'
|
||||
$Pytest = Join-Path $VenvScripts 'pytest.exe'
|
||||
$Ruff = Join-Path $VenvScripts 'ruff.exe'
|
||||
$Mypy = Join-Path $VenvScripts 'mypy.exe'
|
||||
|
||||
function Assert-Venv {
|
||||
if (-not (Test-Path $Python)) {
|
||||
throw "Virtual environment not found at $VenvDir. Run: .\scripts\dev.ps1 install"
|
||||
}
|
||||
}
|
||||
|
||||
function Invoke-Install {
|
||||
if (-not (Test-Path $Python)) {
|
||||
Write-Host "[install] Creating virtual environment at $VenvDir ..."
|
||||
& py -m venv $VenvDir
|
||||
if ($LASTEXITCODE -ne 0) { throw "venv creation failed (exit $LASTEXITCODE)" }
|
||||
}
|
||||
Write-Host "[install] Upgrading pip ..."
|
||||
& $Python -m pip install --upgrade pip
|
||||
if ($LASTEXITCODE -ne 0) { throw "pip upgrade failed" }
|
||||
|
||||
Write-Host "[install] Installing arautopilot[dev] in editable mode ..."
|
||||
& $Python -m pip install -e ".[dev]"
|
||||
if ($LASTEXITCODE -ne 0) { throw "pip install failed" }
|
||||
|
||||
Write-Host "[install] OK"
|
||||
}
|
||||
|
||||
function Invoke-Test {
|
||||
Assert-Venv
|
||||
& $Pytest @Args
|
||||
exit $LASTEXITCODE
|
||||
}
|
||||
|
||||
function Invoke-TestCov {
|
||||
Assert-Venv
|
||||
& $Pytest --cov=arautopilot --cov-report=term-missing --cov-report=html @Args
|
||||
exit $LASTEXITCODE
|
||||
}
|
||||
|
||||
function Invoke-Lint {
|
||||
Assert-Venv
|
||||
& $Ruff check arautopilot/
|
||||
exit $LASTEXITCODE
|
||||
}
|
||||
|
||||
function Invoke-Fix {
|
||||
Assert-Venv
|
||||
& $Ruff check arautopilot/ --fix
|
||||
$check = $LASTEXITCODE
|
||||
& $Ruff format arautopilot/
|
||||
$format = $LASTEXITCODE
|
||||
if ($check -ne 0) { exit $check }
|
||||
exit $format
|
||||
}
|
||||
|
||||
function Invoke-Format {
|
||||
Assert-Venv
|
||||
& $Ruff format arautopilot/
|
||||
exit $LASTEXITCODE
|
||||
}
|
||||
|
||||
function Invoke-Typecheck {
|
||||
Assert-Venv
|
||||
& $Mypy arautopilot/core arautopilot/library arautopilot/shared
|
||||
exit $LASTEXITCODE
|
||||
}
|
||||
|
||||
function Invoke-Check {
|
||||
Assert-Venv
|
||||
Write-Host "[check] (1/3) lint ..."
|
||||
& $Ruff check arautopilot/
|
||||
if ($LASTEXITCODE -ne 0) { Write-Host "[check] FAILED at lint"; exit $LASTEXITCODE }
|
||||
|
||||
Write-Host "[check] (2/3) typecheck ..."
|
||||
& $Mypy arautopilot/core arautopilot/library arautopilot/shared
|
||||
if ($LASTEXITCODE -ne 0) { Write-Host "[check] FAILED at typecheck"; exit $LASTEXITCODE }
|
||||
|
||||
Write-Host "[check] (3/3) tests ..."
|
||||
& $Pytest
|
||||
if ($LASTEXITCODE -ne 0) { Write-Host "[check] FAILED at tests"; exit $LASTEXITCODE }
|
||||
|
||||
Write-Host "[check] OK"
|
||||
}
|
||||
|
||||
function Invoke-Demo {
|
||||
Assert-Venv
|
||||
& $Python examples/sprint0_demo.py
|
||||
exit $LASTEXITCODE
|
||||
}
|
||||
|
||||
function Invoke-Clean {
|
||||
$patterns = @(
|
||||
'__pycache__', '.pytest_cache', '.mypy_cache', '.ruff_cache',
|
||||
'build', 'dist', '*.egg-info', 'htmlcov', '.coverage'
|
||||
)
|
||||
foreach ($p in $patterns) {
|
||||
Get-ChildItem -Path $RepoRoot -Filter $p -Recurse -Force -ErrorAction SilentlyContinue |
|
||||
Where-Object { $_.FullName -notmatch '\\\.venv\\' } |
|
||||
ForEach-Object {
|
||||
Write-Host "[clean] removing $($_.FullName)"
|
||||
Remove-Item -Recurse -Force -LiteralPath $_.FullName -ErrorAction SilentlyContinue
|
||||
}
|
||||
}
|
||||
Get-ChildItem -Path $RepoRoot -Filter '*.pyc' -Recurse -Force -ErrorAction SilentlyContinue |
|
||||
ForEach-Object {
|
||||
Remove-Item -Force -LiteralPath $_.FullName -ErrorAction SilentlyContinue
|
||||
}
|
||||
if (Test-Path 'examples/output') {
|
||||
Write-Host "[clean] removing examples/output/"
|
||||
Remove-Item -Recurse -Force 'examples/output' -ErrorAction SilentlyContinue
|
||||
}
|
||||
Write-Host "[clean] OK"
|
||||
}
|
||||
|
||||
function Show-Help {
|
||||
@'
|
||||
AR-Autopilot — dev tasks
|
||||
|
||||
Usage: .\scripts\dev.ps1 <task> [args...]
|
||||
|
||||
Tasks:
|
||||
install Install package + dev deps into .venv (creates venv if needed)
|
||||
test Run pytest
|
||||
test-cov Run pytest with branch coverage
|
||||
lint Run ruff check (read-only)
|
||||
fix Run ruff check --fix + ruff format
|
||||
format Run ruff format
|
||||
typecheck Run mypy --strict
|
||||
check lint + typecheck + test (full quality gate)
|
||||
demo Run examples/sprint0_demo.py
|
||||
clean Remove build / cache artefacts
|
||||
help Show this message
|
||||
|
||||
Tip: any extra args are forwarded to the underlying tool, e.g.
|
||||
.\scripts\dev.ps1 test -k roundtrip
|
||||
.\scripts\dev.ps1 test -v --tb=short
|
||||
'@ | Write-Host
|
||||
}
|
||||
|
||||
switch ($Task.ToLower()) {
|
||||
'install' { Invoke-Install }
|
||||
'test' { Invoke-Test }
|
||||
'test-cov' { Invoke-TestCov }
|
||||
'lint' { Invoke-Lint }
|
||||
'fix' { Invoke-Fix }
|
||||
'format' { Invoke-Format }
|
||||
'typecheck' { Invoke-Typecheck }
|
||||
'check' { Invoke-Check }
|
||||
'demo' { Invoke-Demo }
|
||||
'clean' { Invoke-Clean }
|
||||
'help' { Show-Help }
|
||||
default {
|
||||
Write-Host "Unknown task: $Task" -ForegroundColor Red
|
||||
Show-Help
|
||||
exit 2
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user