python-code-inspection.yml

name: Python CI

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]
    paths-ignore:
      - '**/*.md'
      - '**/*.txt'

permissions:
  contents: read

jobs:
  validate:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout repository
      uses: actions/checkout@v7

    - name: Set up Python
      uses: actions/setup-python@v7
      with:
        python-version: "3.11"

    - name: Install linters
      run: |
        python -m pip install --upgrade pip
        pip install ruff yamllint

    - name: Lint Python files with ruff
      run: |
        ruff check . || true

    - name: Validate YAML files
      run: |
        # Only lint YAML files we own to avoid noise from node_modules / third-party files
        find docs .github -type f \( -name '*.yml' -o -name '*.yaml' \) -print0 | xargs -0 yamllint || true

    - name: Validate JSON files
      run: |
        # Use Python's stdlib json module to validate JSON files and skip node_modules
        find . -type f -name '*.json' -not -path './node_modules/*' -print0 \
        | xargs -0 -I {} python -c "import sys,json; json.load(open(sys.argv[1]));" {} || true

    - name: Python syntax check
      run: |
        python -m compileall -q .