Home

Awesome

Shell Linter

Release Marketplace Actions Status

A GitHub Action that performs static analysis for shell scripts using ShellCheck.

<br>

Usage

Shell Linter can perform static analysis in various ways. By default it scans all the Shellcheck-supported shell scripts (sh/bash/dash/ksh) in your project. However, you can use the path parameter to scan a specific file or folder or use the exclude-paths parameter to exclude files or folders from the scan. With Shell Linter, you can also specify the minimum severity of errors to consider using the severity parameter. Specific use cases along with examples are shown below:

Run static analysis for all the supported shell scripts in your repository:

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
      - uses: actions/checkout@v1
      - name: Run Shellcheck
        uses: azohra/shell-linter@latest

Run static analysis for a single shell script:

      - name: Run Shellcheck
        uses: azohra/shell-linter@latest
        with:
          path: "setup.sh"

Run static analysis for multiple shell scripts with or without extension:

      - name: Run Shellcheck
        uses: azohra/shell-linter@latest
        with:
          path: "setup,deploy.sh"

Run static analysis for all the shell scripts in a folder:

      - name: Run Shellcheck
        uses: azohra/shell-linter@latest
        with:
          path: "src"

Run static analysis using a wildcard path:

      - name: Run Shellcheck
        uses: azohra/shell-linter@latest
        with:
          path: "src/*.sh"

Exclude files and folders from the static analysis:

      - name: Run Shellcheck
        uses: azohra/shell-linter@latest
        with:
          exclude-paths: "src/setup.sh,tests/unit_tests" 

Note that exclude-paths only accepts paths relative to your project's root directory. However, do not include ./ at the beginning of the paths.

To exclude a folder and it's content recursively just provide the path of the folder without a / at the end. In the example above, the entire folder at the path tests/unit_tests will be excluded from linting.

Run static analysis for all the shell scripts and only report issue with error severity:

      - name: Run Shellcheck
        uses: azohra/shell-linter@latest
        with:
          path: "src/*.sh"
          severity: "error"

Run analysis by using a specific version of Shell Linter:

      - name: Run Shellcheck
        uses: azohra/shell-linter@v0.5.0

Input

path

Optional. Execute lint check on a specific file or folder. Default: .

exclude-paths

Optional. Exclude files and folders from Shellcheck scan.

severity

Optional. Specify minimum severity of errors to consider [style, info, warning, error]. Default: style

License

This software is available as open source under the terms of the MIT License.