Skip to content

arduino/setup-arduino-cli

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

setup-arduino-cli

Actions Status

This action makes the arduino-cli tool available to Workflows.

Usage

To get the latest stable version of arduino-cli just add this step:

- name: Install Arduino CLI
  uses: arduino/setup-arduino-cli@v2

If you want to pin a major or minor version you can use the .x wildcard:

- name: Install Arduino CLI
  uses: arduino/setup-arduino-cli@v2
  with:
    version: "1.x"

To pin the exact version:

- name: Install Arduino CLI
  uses: arduino/setup-arduino-cli@v2
  with:
    version: "1.0.1"

Examples

Here there is a good example on how to use the action. See also the Arduino on GitHub Actions blogpost to learn more.

Development

To work on the codebase you have to install all the dependencies:

# npm install

To run tests set the environment variable GITHUB_TOKEN with a valid Personal Access Token and then:

# npm run test

See the official Github documentation to know more about Personal Access Tokens.

Release

  1. npm install to add all the dependencies, included development.
  2. npm run build to build the Action under the ./lib folder.
  3. npm run test to see everything works as expected.
  4. npm run pack to package for distribution
  5. git add src dist to check in the code that matters.
  6. If the release will increment the major version, update the action refs in the examples in README.md (e.g., uses: arduino/setup-arduino-cli@v1 -> uses: arduino/setup-arduino-cli@v2).
  7. open a PR and request a review.
  8. After PR is merged, create a release, following the vX.Y.Z tag name convention.
  9. After the release, rebase the release branch for that major version (e.g., v1 branch for the v1.x.x tags) on the tag. If no branch exists for the release's major version, create one.

Security

If you think you found a vulnerability or other security-related bug in this project, please read our security policy and report the bug to our Security Team 🛡️ Thank you!

e-mail contact: [email protected]