Convert to composite run steps action

When the action was created, the only option for non-JavaScript actions was to use a Docker container. However, GitHub
recently added a new action type: the "composite run steps action":
https://docs.github.com/en/free-pro-team@latest/actions/creating-actions/creating-a-composite-run-steps-action

The Docker container approach has the significant advantage of providing a controlled environment for the action to run
in, which will not pollute the general environment of the runner for later workflow steps. However it also has a couple
disadvantages:

- Docker container actions can only execute on runners with a Linux operating system.
- The workspace is mounted to a folder in the container named `/github/workspace`.

The problem with the first is it prevents testing for other operating systems. Arduino boards platforms have different
toolchains and even build properties according to operating system of the machine they are running on. Only testing on
a Linux system may result in missing issues that affect the majority of users.

Although more still needs to be done to make the action cross-platform, converting to a composite run steps action is
the first step toward that goal.

The problem with the second is that, in order to be valid, an Arduino sketch folder must match the filename of the
primary sketch file. For a sketch in the root of the repository, a sketch author might achieve this to some limited
extent by naming the repository to match the primary sketch file name. However, the container volume is not named
according to the repository name, so sketches in the root of the repository are not currently supported by the action
(except in the unlikely event the sketch happens to be named "workspace"). Even though structuring sketch repositories
in this manner is not best practices due to GitHub's popular "Download ZIP" appending the Git ref to the end of the
folder name, the purpose of this action is to compile sketches, not legislate repository policy, so it is reasonable to
support this use case.

The workspace folder in the GitHub Actions runner is named according to the repository name, meaning that converting to
a composite run steps action permits use with sketches in the root of the repository.

Author: per1234

Dockerfile

@@ -0,0 +1,44 @@
+#!/bin/sh
+
+# Set up the Python environment for the action's script to run in
+
+readonly PYTHON_PACKAGE_VERSION='3.8'
+
+# https://stackoverflow.com/a/29835459
+readonly SCRIPT_PATH="$(
+  CDPATH='' \
+  cd -- "$(
+    dirname -- "$0"
+  )" && (
+    pwd -P
+  )
+)"
+
+readonly PYTHON_COMMAND="python${PYTHON_PACKAGE_VERSION}"
+readonly PYTHON_VENV_PATH="${SCRIPT_PATH}/compilesketches/.venv"
+readonly PYTHON_VENV_ACTIVATE_SCRIPT_PATH="${PYTHON_VENV_PATH}/bin/activate"
+
+# Install Python
+sudo apt-get install --yes software-properties-common > /dev/null
+sudo add-apt-repository --yes ppa:deadsnakes/ppa > /dev/null
+sudo apt-get update --yes > /dev/null
+sudo apt-get install --yes python${PYTHON_PACKAGE_VERSION} > /dev/null
+echo "Using Python version: $("$PYTHON_COMMAND" --version)"
+
+sudo apt-get install --yes python3-setuptools > /dev/null
+sudo apt-get install --yes python${PYTHON_PACKAGE_VERSION}-venv > /dev/null
+
+# Create Python virtual environment
+"$PYTHON_COMMAND" -m venv "$PYTHON_VENV_PATH"
+
+# Activate Python virtual environment
+. "$PYTHON_VENV_ACTIVATE_SCRIPT_PATH"
+
+# Install Python dependencies
+"$PYTHON_COMMAND" -m pip install --upgrade pip > /dev/null
+"$PYTHON_COMMAND" -m pip install --quiet --requirement "${SCRIPT_PATH}/compilesketches/requirements.txt"
+
+# Set outputs for use in GitHub Actions workflow steps
+# See: https://docs.github.com/en/free-pro-team@latest/actions/reference/workflow-commands-for-github-actions#setting-an-output-parameter
+echo "::set-output name=python-command::$PYTHON_COMMAND"
+echo "::set-output name=python-venv-activate-script-path::$PYTHON_VENV_ACTIVATE_SCRIPT_PATH"

action-setup.sh

@@ -43,5 +43,30 @@ inputs:
     required: true
 
 runs:
-  using: 'docker'
-  image: 'Dockerfile'
+  using: composite
+  steps:
+    - name: Run the set up script
+      id: setup
+      shell: bash
+      run: |
+        # Group action setup log output
+        echo "::group::Action set up"
+        "${{ github.action_path }}/action-setup.sh"
+        echo "::endgroup::"
+
+    - name: Run script
+      shell: bash
+      env:
+        INPUT_CLI-VERSION: ${{ inputs.cli-version }}
+        INPUT_FQBN: ${{ inputs.fqbn }}
+        INPUT_LIBRARIES: ${{ inputs.libraries }}
+        INPUT_PLATFORMS: ${{ inputs.platforms }}
+        INPUT_SKETCH-PATHS: ${{ inputs.sketch-paths }}
+        INPUT_VERBOSE: ${{ inputs.verbose }}
+        INPUT_GITHUB-TOKEN: ${{ inputs.github-token }}
+        INPUT_ENABLE-DELTAS-REPORT: ${{ inputs.enable-deltas-report }}
+        INPUT_ENABLE-WARNINGS-REPORT: ${{ inputs.enable-warnings-report }}
+        INPUT_SKETCHES-REPORT-PATH: ${{ inputs.sketches-report-path }}
+      run: |
+        source "${{ steps.setup.outputs.python-venv-activate-script-path }}"
+        "${{ steps.setup.outputs.python-command }}" "${{ github.action_path }}/compilesketches/compilesketches.py"