format.yaml

name: format

on:
  workflow_dispatch:
  push:
    branches:
      - main
  pull_request:
    branches:
      - "**"
    paths-ignore:
      - "docs/**"

concurrency:
  group: build-format-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  ruff-format:
    name: "Code quality checks"
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repo
        uses: actions/checkout@v4

      - name: Install uv
        uses: astral-sh/setup-uv@v3
        with:
          version: "latest"

      - name: Set up Python
        run: uv python install 3.12

      - name: Install development dependencies
        # `--all-extras` (matching the dev setup in README.md) so pyright can
        # resolve types from various optional dependencies.
        run: uv sync --group dev --all-extras --no-extra gstreamer --no-extra local

      - name: Ruff formatter
        id: ruff-format
        run: uv run ruff format --diff

      - name: Ruff linter (all rules)
        id: ruff-check
        run: uv run ruff check

      - name: Type check (pyright)
        id: pyright
        run: uv run pyright

      - name: CLI registry drift check
        id: registry-drift
        # Regenerate the CLI's service registry against the source and fail if it drifted.
        # This runs here because regenerating _configs.py introspects constructor
        # signatures and needs the service SDKs, which this job already installs via
        # --all-extras. Catches both import-path and constructor-signature drift, and
        # backstops commits made with --no-verify or without the pre-commit hook.
        run: |
          uv run scripts/cli/update_registry.py
          git diff --exit-code src/pipecat/cli/registry/_imports.py src/pipecat/cli/registry/_configs.py