Files
local-ci-cd-system/.gitea/workflows/lint.yml
T
Simone 4827cadada fix(ci): lint workflow's venv is missing the [web] extra
mypy --strict (files = ["src"]) and pytest --cov=ci_orchestrator both walk
the whole src tree, web/ included, but the lint job's venv only ever
installed .[dev] -- fastapi/starlette/uvicorn/jinja2/authlib were never
resolvable, so every symbol they touch degraded to Any under mypy (masking
real type errors, and producing a cascading "Returning Any" on
_is_htmx_request) and every tests/python/test_web_*.py would fail to import
under pytest. Install .[dev,web] instead. Verified against a fresh venv:
ruff/mypy --strict/pytest --cov all pass.
2026-07-25 19:40:18 +02:00

119 lines
3.8 KiB
YAML

# Python lint runs on every push/PR (linux-build runner) and blocks the PR.
#
# PSScriptAnalyzer (pssa) runs on the Windows runner (windows-build) on-demand
# only — triggered via workflow_dispatch — because the .ps1/.psm1 targets are
# Windows-native (PS 5.1). It is intentionally NOT queued on push/PR so it does
# not block the pipeline when no Windows runner is registered (dual-boot Passo 9
# may be down). This keeps the Linux host/runner free of pwsh (Phase C goal).
# Requires PSScriptAnalyzer installed on the Windows runner host:
# Install-Module PSScriptAnalyzer -Scope AllUsers -Force
# Fix warnings with:
# Invoke-ScriptAnalyzer -Path scripts\ -Recurse -Fix
name: Lint
on:
workflow_dispatch:
push:
paths:
- '**.ps1'
- '**.psm1'
- '**.py'
- 'pyproject.toml'
- '.gitea/workflows/lint.yml'
pull_request:
paths:
- '**.ps1'
- '**.psm1'
- '**.py'
- 'pyproject.toml'
- '.gitea/workflows/lint.yml'
jobs:
pssa:
# On-demand only: runs on the Windows runner (PS 5.1), never on push/PR,
# so it cannot block the pipeline when no Windows runner is registered.
if: ${{ github.event_name == 'workflow_dispatch' }}
runs-on: windows-build
timeout-minutes: 10
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 1
- name: Run PSScriptAnalyzer
shell: powershell
run: |
$ErrorActionPreference = 'Stop'
if (-not (Get-Module -ListAvailable PSScriptAnalyzer)) {
Write-Host "Installing PSScriptAnalyzer..."
Install-Module PSScriptAnalyzer -Scope CurrentUser -Force -AllowClobber
}
$settings = Join-Path $PWD 'PSScriptAnalyzerSettings.psd1'
$paths = @('scripts', 'template', 'Setup-Host.ps1')
$results = $paths | ForEach-Object {
if (Test-Path $_) {
Invoke-ScriptAnalyzer -Path $_ -Recurse -Settings $settings -Severity Error,Warning
}
}
# scripts/archived/ holds frozen .ps1 superseded by the Python CLI
# (kept for history only) — exempt from lint.
$results = $results | Where-Object { $_.ScriptPath -notmatch '[\\/]archived[\\/]' }
if ($results) {
$results | Format-Table -AutoSize
Write-Error "PSScriptAnalyzer found $($results.Count) issue(s). Fix before merging."
exit 1
}
else {
Write-Host "PSScriptAnalyzer: no issues found."
}
python:
runs-on: linux-build
timeout-minutes: 20
env:
PYTHONIOENCODING: utf-8
VENV_DIR: ${{ github.workspace }}/.venv-lint
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 1
- name: Setup venv + install package
shell: bash
run: |
set -euo pipefail
rm -rf "$VENV_DIR"
python3 -m venv "$VENV_DIR"
"$VENV_DIR/bin/python" -m pip install --upgrade pip
# mypy --strict (files = ["src"]) and pytest --cov=ci_orchestrator both
# walk the whole src tree, web/ included -- [dev] alone leaves fastapi/
# starlette/uvicorn/jinja2/authlib unresolved, so every symbol they
# touch degrades to Any (masking real type errors) and every
# tests/python/test_web_*.py fails to import.
"$VENV_DIR/bin/python" -m pip install -e ".[dev,web]"
- name: ruff
shell: bash
run: |
"$VENV_DIR/bin/python" -m ruff check src tests/python
- name: mypy --strict
shell: bash
run: |
"$VENV_DIR/bin/python" -m mypy --strict src
- name: pytest (coverage >= 90%)
shell: bash
run: |
"$VENV_DIR/bin/python" -m pytest tests/python --cov=ci_orchestrator --cov-fail-under=90