shellcheck.yml

name: ShellCheck

on:
  push:
    branches: [master]
  pull_request:

permissions:
  contents: read

jobs:
  shellcheck:
    name: Lint shell files
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      # ShellCheck is preinstalled on ubuntu-latest runners.
      # zsh/ is excluded: ShellCheck does not support the zsh dialect.
      - name: ShellCheck bash dotfiles and scripts
        run: |
          shellcheck --version
          shellcheck -s bash bash/.bash_aliases bash/.bash_profile
          shellcheck scripts/*.sh

  zsh-syntax:
    name: zsh syntax check
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Install zsh
        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends zsh

      # -n parses without executing; catches syntax errors in files
      # ShellCheck cannot handle. .zshrc references Oh My Zsh at runtime,
      # but parsing does not require it.
      - name: Parse zsh files
        run: |
          zsh -n zsh/.zshrc
          zsh -n zsh/.zshenv