Check Shell Scripts #103
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/check-shell-task.md | |
| name: Check Shell Scripts | |
| # See: https://docs.github.com/actions/using-workflows/events-that-trigger-workflows | |
| on: | |
| create: | |
| push: | |
| paths: | |
| - ".github/workflows/check-shell-task.ya?ml" | |
| - "Taskfile.ya?ml" | |
| - "**/.editorconfig" | |
| - "**.bash" | |
| - "**.sh" | |
| pull_request: | |
| paths: | |
| - ".github/workflows/check-shell-task.ya?ml" | |
| - "Taskfile.ya?ml" | |
| - "**/.editorconfig" | |
| - "**.bash" | |
| - "**.sh" | |
| schedule: | |
| # Run every Tuesday at 8 AM UTC to catch breakage caused by tool changes. | |
| - cron: "0 8 * * TUE" | |
| workflow_dispatch: | |
| repository_dispatch: | |
| jobs: | |
| run-determination: | |
| runs-on: ubuntu-latest | |
| outputs: | |
| result: ${{ steps.determination.outputs.result }} | |
| steps: | |
| - name: Determine if the rest of the workflow should run | |
| id: determination | |
| run: | | |
| RELEASE_BRANCH_REGEX="refs/heads/[0-9]+.[0-9]+.x" | |
| # The `create` event trigger doesn't support `branches` filters, so it's necessary to use Bash instead. | |
| if [[ | |
| "${{ github.event_name }}" != "create" || | |
| "${{ github.ref }}" =~ $RELEASE_BRANCH_REGEX | |
| ]]; then | |
| # Run the other jobs. | |
| RESULT="true" | |
| else | |
| # There is no need to run the other jobs. | |
| RESULT="false" | |
| fi | |
| echo "result=$RESULT" >> $GITHUB_OUTPUT | |
| lint: | |
| name: ${{ matrix.configuration.name }} | |
| needs: run-determination | |
| if: needs.run-determination.outputs.result == 'true' | |
| runs-on: ubuntu-latest | |
| env: | |
| # See: https://github.com/koalaman/shellcheck/releases/latest | |
| SHELLCHECK_RELEASE_ASSET_SUFFIX: .linux.x86_64.tar.xz | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| configuration: | |
| - name: Generate problem matcher output | |
| # ShellCheck's "gcc" output format is required for annotated diffs, but inferior for humans reading the log. | |
| format: gcc | |
| # The other matrix job is used to set the result, so this job is configured to always pass. | |
| continue-on-error: true | |
| - name: ShellCheck | |
| # ShellCheck's "tty" output format is most suitable for humans reading the log. | |
| format: tty | |
| continue-on-error: false | |
| steps: | |
| - name: Set environment variables | |
| run: | | |
| # See: https://docs.github.com/actions/using-workflows/workflow-commands-for-github-actions#setting-an-environment-variable | |
| echo "INSTALL_PATH=${{ runner.temp }}/shellcheck" >> "$GITHUB_ENV" | |
| - name: Checkout repository | |
| uses: actions/checkout@v3 | |
| - name: Install Task | |
| uses: arduino/setup-task@v1 | |
| with: | |
| repo-token: ${{ secrets.GITHUB_TOKEN }} | |
| version: 3.x | |
| - name: Download latest ShellCheck release binary package | |
| id: download | |
| uses: MrOctopus/[email protected] | |
| with: | |
| repository: koalaman/shellcheck | |
| excludes: prerelease, draft | |
| asset: ${{ env.SHELLCHECK_RELEASE_ASSET_SUFFIX }} | |
| target: ${{ env.INSTALL_PATH }} | |
| - name: Install ShellCheck | |
| run: | | |
| cd "${{ env.INSTALL_PATH }}" | |
| tar --extract --file="${{ steps.download.outputs.name }}" | |
| EXTRACTION_FOLDER="$(basename "${{ steps.download.outputs.name }}" "${{ env.SHELLCHECK_RELEASE_ASSET_SUFFIX }}")" | |
| # Add installation to PATH: | |
| # See: https://docs.github.com/actions/using-workflows/workflow-commands-for-github-actions#adding-a-system-path | |
| echo "${{ env.INSTALL_PATH }}/$EXTRACTION_FOLDER" >> "$GITHUB_PATH" | |
| - name: Run ShellCheck | |
| uses: liskin/gh-problem-matcher-wrap@v2 | |
| continue-on-error: ${{ matrix.configuration.continue-on-error }} | |
| with: | |
| linters: gcc | |
| run: task --silent shell:check SHELLCHECK_FORMAT=${{ matrix.configuration.format }} | |
| formatting: | |
| needs: run-determination | |
| if: needs.run-determination.outputs.result == 'true' | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Set environment variables | |
| run: | | |
| # See: https://docs.github.com/actions/using-workflows/workflow-commands-for-github-actions#setting-an-environment-variable | |
| echo "SHFMT_INSTALL_PATH=${{ runner.temp }}/shfmt" >> "$GITHUB_ENV" | |
| - name: Checkout repository | |
| uses: actions/checkout@v3 | |
| - name: Install Task | |
| uses: arduino/setup-task@v1 | |
| with: | |
| repo-token: ${{ secrets.GITHUB_TOKEN }} | |
| version: 3.x | |
| - name: Download shfmt | |
| id: download | |
| uses: MrOctopus/[email protected] | |
| with: | |
| repository: mvdan/sh | |
| excludes: prerelease, draft | |
| asset: _linux_amd64 | |
| target: ${{ env.SHFMT_INSTALL_PATH }} | |
| - name: Install shfmt | |
| run: | | |
| # Executable permissions of release assets are lost | |
| chmod +x "${{ env.SHFMT_INSTALL_PATH }}/${{ steps.download.outputs.name }}" | |
| # Standardize binary name | |
| mv "${{ env.SHFMT_INSTALL_PATH }}/${{ steps.download.outputs.name }}" "${{ env.SHFMT_INSTALL_PATH }}/shfmt" | |
| # Add installation to PATH: | |
| # See: https://docs.github.com/actions/using-workflows/workflow-commands-for-github-actions#adding-a-system-path | |
| echo "${{ env.SHFMT_INSTALL_PATH }}" >> "$GITHUB_PATH" | |
| - name: Format shell scripts | |
| run: task --silent shell:format | |
| - name: Check formatting | |
| run: git diff --color --exit-code | |
| executable: | |
| needs: run-determination | |
| if: needs.run-determination.outputs.result == 'true' | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout repository | |
| uses: actions/checkout@v3 | |
| - name: Install Task | |
| uses: arduino/setup-task@v1 | |
| with: | |
| repo-token: ${{ secrets.GITHUB_TOKEN }} | |
| version: 3.x | |
| - name: Check for non-executable scripts | |
| run: task --silent shell:check-mode |