-
-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #11 from MatteoPologruto/check-shell
Add CI workflow to check for problems with shell scripts
- Loading branch information
Showing
5 changed files
with
370 additions
and
44 deletions.
There are no files selected for viewing
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,63 @@ | ||
# Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/general/.editorconfig | ||
# See: https://editorconfig.org/ | ||
# The formatting style defined in this file is the official standardized style to be used in all Arduino Tooling | ||
# projects and should not be modified. | ||
# Note: indent style for each file type is defined even when it matches the universal config in order to make it clear | ||
# that this type has an official style. | ||
|
||
[*] | ||
charset = utf-8 | ||
end_of_line = lf | ||
indent_size = 2 | ||
indent_style = space | ||
insert_final_newline = true | ||
trim_trailing_whitespace = true | ||
|
||
[*.{adoc,asc,asciidoc}] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.{bash,sh}] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.{c,cc,cp,cpp,cxx,h,hh,hpp,hxx,ii,inl,ino,ixx,pde,tpl,tpp,txx}] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.{go,mod}] | ||
indent_style = tab | ||
|
||
[*.java] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.{js,jsx,json,jsonc,json5,ts,tsx}] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.{md,mdx,mkdn,mdown,markdown}] | ||
indent_size = unset | ||
indent_style = space | ||
|
||
[*.proto] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.py] | ||
indent_size = 4 | ||
indent_style = space | ||
|
||
[*.svg] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[*.{yaml,yml}] | ||
indent_size = 2 | ||
indent_style = space | ||
|
||
[{.gitconfig,.gitmodules}] | ||
indent_style = tab | ||
|
||
[deps/*/*] | ||
ignore = true |
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,177 @@ | ||
# 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 |
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
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
Oops, something went wrong.