actions

.github/actions/api-quality/action.yml

@@ -0,0 +1,116 @@
+name: API Quality
+description: Run Python uv quality checks for API services (format, lint, typecheck, tests).
+
+inputs:
+  python_version:
+    description: Python version to use.
+    required: false
+    default: "3.13"
+  uv_version:
+    description: uv version to install.
+    required: false
+    default: "latest"
+  working_directory:
+    description: Working directory for commands.
+    required: false
+    default: "."
+  cache_dependency_path:
+    description: Path used for cache key hashing.
+    required: false
+    default: "uv.lock"
+  env:
+    description: >
+      Multiline env vars, one per line: KEY=VALUE
+    required: false
+    default: ""
+  uv_sync_args:
+    description: Arguments for uv sync.
+    required: false
+    default: "--frozen --dev"
+  format_command:
+    description: Command for format checking.
+    required: false
+    default: "uv run ruff format --check ."
+  lint_command:
+    description: Command for linting.
+    required: false
+    default: "uv run ruff check ."
+  typecheck_command:
+    description: Command for type checking.
+    required: false
+    default: "uv run mypy ."
+  test_command:
+    description: Command for tests.
+    required: false
+    default: "uv run pytest"
+
+runs:
+  using: composite
+  steps:
+    - name: Load env vars
+      if: ${{ inputs.env != '' }}
+      shell: bash
+      run: |
+        while IFS= read -r line; do
+          [ -z "$line" ] && continue
+          case "$line" in \#*) continue;; esac
+          if [[ "$line" != *=* ]]; then
+            echo "Invalid env line: $line" >&2
+            exit 1
+          fi
+          echo "$line" >> "$GITHUB_ENV"
+        done <<< "${{ inputs.env }}"
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python_version }}
+
+    - name: Install uv
+      shell: bash
+      env:
+        UV_VERSION: ${{ inputs.uv_version }}
+      run: |
+        python -m pip install --upgrade pip
+        if [ -z "$UV_VERSION" ] || [ "$UV_VERSION" = "latest" ]; then
+          python -m pip install uv
+        else
+          python -m pip install "uv==$UV_VERSION"
+        fi
+
+    - name: Cache uv downloads
+      uses: actions/cache@v4
+      with:
+        path: ~/.cache/uv
+        key: uv-${{ runner.os }}-${{ hashFiles(inputs.cache_dependency_path) }}
+        restore-keys: |
+          uv-${{ runner.os }}-
+
+    - name: Sync dependencies
+      shell: bash
+      run: uv sync ${{ inputs.uv_sync_args }}
+      working-directory: ${{ inputs.working_directory }}
+
+    - name: Run format check
+      if: ${{ inputs.format_command != '' }}
+      shell: bash
+      run: ${{ inputs.format_command }}
+      working-directory: ${{ inputs.working_directory }}
+
+    - name: Run lint
+      if: ${{ inputs.lint_command != '' }}
+      shell: bash
+      run: ${{ inputs.lint_command }}
+      working-directory: ${{ inputs.working_directory }}
+
+    - name: Run typecheck
+      if: ${{ inputs.typecheck_command != '' }}
+      shell: bash
+      run: ${{ inputs.typecheck_command }}
+      working-directory: ${{ inputs.working_directory }}
+
+    - name: Run tests
+      if: ${{ inputs.test_command != '' }}
+      shell: bash
+      run: ${{ inputs.test_command }}
+      working-directory: ${{ inputs.working_directory }}