formatting.yml

name: Code Formatting and Linting

on:
  push:
    branches:
      - main
      - master
      - develop
    paths:
      - '**.py'
      - '**.sh'
      - '**.c'
      - '**.h'
      - '**.ts'
      - '**.tsx'
      - '**.js'
      - '**.jsx'
      - '**.md'
      - '**.vim'
  pull_request:
    branches:
      - main
      - master
      - develop
    paths:
      - '**.py'
      - '**.sh'
      - '**.c'
      - '**.h'
      - '**.ts'
      - '**.tsx'
      - '**.js'
      - '**.jsx'
      - '**.md'
      - '**.vim'

jobs:
  format:
    runs-on: ubuntu-latest
    
    permissions:
      contents: write
    
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
          token: ${{ secrets.GITHUB_TOKEN }}
      
      - name: Install shellcheck
        run: |
          sudo apt-get update
          sudo apt-get install -y shellcheck
      
      - name: Install shfmt
        run: |
          curl -sS https://webi.sh/shfmt | sh
          echo "$HOME/.local/bin" >> $GITHUB_PATH
      
      - name: Find shell scripts
        id: find_shell
        run: |
          # Find all .sh files and files with shell shebangs
          SHELL_FILES=$(find . -type f \( -name "*.sh" -o -exec sh -c 'head -n1 "$1" | grep -q "^#!.*sh"' _ {} \; \) -print | grep -v ".git" || true)
          if [ -n "$SHELL_FILES" ]; then
            echo "found=true" >> $GITHUB_OUTPUT
            echo "$SHELL_FILES" > /tmp/shell_files.txt
          else
            echo "found=false" >> $GITHUB_OUTPUT
          fi
      
      - name: Run shellcheck (BLOCKING)
        if: steps.find_shell.outputs.found == 'true'
        run: |
          echo "Running shellcheck on all shell scripts..."
          cat /tmp/shell_files.txt | xargs shellcheck
      
      - name: Run shfmt
        if: steps.find_shell.outputs.found == 'true'
        run: |
          echo "Formatting shell scripts with shfmt..."
          cat /tmp/shell_files.txt | xargs shfmt -w -i 2 -ci -bn
      
      - name: Install C tools
        run: |
          sudo apt-get update
          sudo apt-get install -y clang-tidy clang-format
      
      - name: Find C files
        id: find_c
        run: |
          C_FILES=$(find . -type f \( -name "*.c" -o -name "*.h" \) -not -path "./.git/*" || true)
          if [ -n "$C_FILES" ]; then
            echo "found=true" >> $GITHUB_OUTPUT
            echo "$C_FILES" > /tmp/c_files.txt
          else
            echo "found=false" >> $GITHUB_OUTPUT
          fi
      
      - name: Run clang-tidy (BLOCKING)
        if: steps.find_c.outputs.found == 'true'
        run: |
          echo "Running clang-tidy on all C files..."
          cat /tmp/c_files.txt | xargs clang-tidy --warnings-as-errors='*'
      
      - name: Run clang-format
        if: steps.find_c.outputs.found == 'true'
        run: |
          echo "Formatting C code with clang-format..."
          cat /tmp/c_files.txt | xargs clang-format -i --style=LLVM
      
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Install TypeScript and Markdown tools
        run: |
          npm install -g eslint prettier @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-markdown markdownlint-cli
      
      - name: Find TypeScript files
        id: find_ts
        run: |
          TS_FILES=$(find . -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.jsx" \) -not -path "./node_modules/*" -not -path "./.git/*" || true)
          if [ -n "$TS_FILES" ]; then
            echo "found=true" >> $GITHUB_OUTPUT
          else
            echo "found=false" >> $GITHUB_OUTPUT
          fi
      
      - name: Find Markdown files
        id: find_md
        run: |
          MD_FILES=$(find . -type f -name "*.md" -not -path "./node_modules/*" -not -path "./.git/*" || true)
          if [ -n "$MD_FILES" ]; then
            echo "found=true" >> $GITHUB_OUTPUT
          else
            echo "found=false" >> $GITHUB_OUTPUT
          fi
      
      - name: Run ESLint (BLOCKING)
        if: steps.find_ts.outputs.found == 'true'
        run: |
          echo "Running ESLint on TypeScript/JavaScript files..."
          npx eslint . --ext .ts,.tsx,.js,.jsx || echo "No ESLint config found, skipping..."
        continue-on-error: true
      
      - name: Run markdownlint (BLOCKING)
        if: steps.find_md.outputs.found == 'true'
        run: |
          echo "Running markdownlint on Markdown files..."
          npx markdownlint '**/*.md' --ignore node_modules --ignore .git || echo "No markdownlint config found, using defaults..."
        continue-on-error: true
      
      - name: Run Prettier on TypeScript/JavaScript
        if: steps.find_ts.outputs.found == 'true'
        run: |
          echo "Formatting TypeScript/JavaScript with Prettier..."
          npx prettier --write "**/*.{ts,tsx,js,jsx,json}"
      
      - name: Run Prettier on Markdown
        if: steps.find_md.outputs.found == 'true'
        run: |
          echo "Formatting Markdown with Prettier..."
          npx prettier --write "**/*.md"
      
      - name: Install Vimscript tools
        run: |
          pip install vim-vint --break-system-packages
      
      - name: Find Vimscript files
        id: find_vim
        run: |
          VIM_FILES=$(find . -type f \( -name "*.vim" -o -name ".vimrc" -o -name "vimrc" \) -not -path "./.git/*" || true)
          if [ -n "$VIM_FILES" ]; then
            echo "found=true" >> $GITHUB_OUTPUT
            echo "$VIM_FILES" > /tmp/vim_files.txt
          else
            echo "found=false" >> $GITHUB_OUTPUT
          fi
      
      - name: Run vint (BLOCKING)
        if: steps.find_vim.outputs.found == 'true'
        run: |
          echo "Running vint on Vimscript files..."
          cat /tmp/vim_files.txt | xargs vint
      
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      
      - name: Install Python formatting tools
        run: |
          python -m pip install --upgrade pip
          pip install black isort ssort ruff
      
      - name: Run ruff check (BLOCKING)
        run: |
          echo "Running ruff linter on all Python files..."
          ruff check .
      
      - name: Run ssort
        run: |
          ssort **/*.py || true
        continue-on-error: false
      
      - name: Run isort
        run: |
          isort .
        continue-on-error: false
      
      - name: Run black
        run: |
          black .
        continue-on-error: false
      
      - name: Check for changes
        id: verify_diff
        run: |
          git diff --quiet . || echo "changed=true" >> $GITHUB_OUTPUT
      
      - name: Commit and push changes
        if: steps.verify_diff.outputs.changed == 'true'
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add -A
          git commit -m "style: auto-format code with shfmt, clang-format, eslint, prettier, markdownlint, vint, black, isort, and ssort"
          git push