examples.yml

name: Examples Validation

# Gate on examples/ so the swallow-to-exit-0 anti-pattern (and lint/format/
# syntax drift) cannot regress: nothing else in CI checks examples/.

on:
  push:
    branches: [main]
    paths:
      - "examples/**"
      - "tools/examples/**"
      - ".github/workflows/examples.yml"
  pull_request:
    paths:
      - "examples/**"
      - "tools/examples/**"
      - ".github/workflows/examples.yml"
  workflow_dispatch:

jobs:
  validate:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1

      - name: Set up Python
        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
        with:
          python-version: "3.13"

      - name: Install Poetry
        uses: snok/install-poetry@v1  # not pinned — see ci-validation.yaml header

      - name: Cache Poetry virtualenv
        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
        with:
          path: ~/.cache/pypoetry
          key: examples-poetry-${{ runner.os }}-${{ hashFiles('poetry.lock') }}

      # ruff is a dev-group dependency; the checker + py_compile are stdlib-only.
      - name: Install dependencies
        run: poetry install --no-interaction --with dev

      - name: Ruff lint (examples/)
        run: poetry run ruff check examples/

      - name: Ruff format check (examples/)
        run: poetry run ruff format --check examples/

      - name: Compile-smoke every example (syntax / indentation)
        run: poetry run python -m compileall -q examples/

      - name: Swallow-to-exit-0 gate (Rules A + C)
        run: poetry run python tools/examples/check_no_swallow.py