1. 24 Sep, 2021 7 commits
  2. 22 Sep, 2021 1 commit
  3. 02 Sep, 2021 1 commit
  4. 01 Sep, 2021 2 commits
  5. 31 Aug, 2021 4 commits
  6. 30 Aug, 2021 2 commits
    • Silvano Cerza's avatar
      Enhance handling of colored output (#1418) · ff4eb92a
      Silvano Cerza authored
      ff4eb92a
    • Cristian Maglie's avatar
      [skip-changleog] Better gRPC error handling (#1251) · 75b9760c
      Cristian Maglie authored
      * Proper gRPC error handling
      
      * Update gRPC API of board command to return status.Status instead of error
      
      * Update gRPC API of remaining commands to return status.Status instead of error
      
      * Replace custom error with protobuf message
      
      Previously, a custom error was returned when attempting to upgrade a platform that was already at the latest available
      version. There is dedicated code for handling this specific error.
      
      Now that the function has been changed to return a status.Status instead of error, the previous check for the return
      being this error is no longer possible. The capability is restored by replacing the error with a protocol buffer message.
      
      * Handle details of any type in `core.PlatformUpgrade()` status
      
      The status details of the function are used to identify the specific cause of a non-nil status. This is done via a type
      assertion. Previously, this type assertion was configured such that a details of any type other than the expected would
      result in a panic. At the moment, that will not occur because we only add details of one type. However, the whole point
      of the type assertion is to support details of multiple types, and if other types are added a panic will not be the
      appropriate behavior.
      
      A better approach is to check the result of the type assertion, handling the non-nil status as a generic error if its
      details are of a different type.
      
      * Return nil on program action if an error occurred
      
      * Refactoring 'upload' commands
      
      * Refactoring 'board' commands
      
      * Refactoring 'compile' commands
      
      * Refactoring 'core' commands
      
      * Refactoring 'debug' commands
      
      * Refactoring 'lib' commands
      
      * Refactoring 'sketch' commands
      
      * Refactoring 'commands' commands
      
      * updated tests and fixed some error wording
      
      * fixed go lint warnings
      
      * Apply suggestions from code review
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      
      * Apply changes from code review
      Co-authored-by: default avatarSilvano Cerza <3314350+silvanocerza@users.noreply.github.com>
      
      * fix i18n
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      Co-authored-by: default avatarSilvano Cerza <3314350+silvanocerza@users.noreply.github.com>
      75b9760c
  7. 27 Aug, 2021 1 commit
  8. 26 Aug, 2021 3 commits
  9. 25 Aug, 2021 2 commits
  10. 24 Aug, 2021 5 commits
  11. 23 Aug, 2021 1 commit
    • Silvano Cerza's avatar
      Add support for Pluggable Discoveries (#1333) · ec027a7f
      Silvano Cerza authored
      * [skip changelog] Add DiscoveryManager to PackageManager
      
      * Add loading of PluggableDiscoveries when loading a platform release
      
      * Added compatibility layer for non-pluggable platforms
      
      * Implemented board list with discoveries
      
      * Implemented discovery loading after initialization
      
      * Implemented board watch with discoveries
      
      * Fix load discoveries tests
      
      * Fix some issues with board list watcher
      
      * Fix FindToolsRequiredFromPlatformRelease not returning discoveries
      
      * Enhanced handling of some discoveries states
      
      * Fix PackageManager reset
      
      * Add function to convert discovery.Port to rpc.Port
      
      * Moved reference argument parsing to new package
      
      * Fix functions docstrings
      
      * Remove duplicated code to initialize Sketch path
      
      * Add property conversion for platform not supporting pluggable discovery
      
      * Fix board list watch not working
      
      * Fix crash when converting Port to rpc struct
      
      * Add generic Port argument
      
      * Change gRPC upload functions to use new Port message
      
      * Add support for upload user fields
      
      * Fix upload unit tests
      
      * Fix code naming issues
      
      * Added builtin:mdns-discovery
      
      * Do not panic if discovery tool is not installed
      
      * Implemented port/protocol detection at CLI startup time
      
      * Perform 1200bps-touch only on serial ports
      
      * Added missing properties for pluggable upload
      
      * Correctly implemented 'board list' timeout option
      
      * Updated mdns-discovery to 0.9.2
      
      * Add documentation
      
      * Add board properties to board list command and gRPC function
      
      * Fix documentation and code comments
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      
      * Fix crash when attempting upload without specifying port address
      
      * Fix unit tests
      
      * Update go-properties-orderedmap to fix discovery properties issues
      
      * Fix more documentation
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      
      * Clarify pluggable discovery specification
      
      * More documentation fixes
      
      * Add upload_port properties docs in platform specification
      
      * Change links from pluggable discovery RFC to official docs
      
      * Add more upload mock integration tests
      
      * Fix integration tests
      
      * Change property to declare pluggable discoveries
      
      * Change property to declare pluggable discoveries
      
      * Fix documentation
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      
      * Fix loading of platform not supporting pluggable discovery
      
      * Fix more documentation
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      
      * Add pluggable discovery states documentation
      
      * Enhanced handling of pluggable discoveries states
      
      * Discoveries processes are now killed if the HELLO command fails
      
      * Add pluggable discovery logging
      
      * Enhanced handling of failing pluggable discoveries
      
      * Fix pluggable discoveries parallelization
      
      * Discoveries event channels are now created when start sync is called
      
      * Cached ports are now reset on discovery stop
      
      * Renamed ListSync methods to ListCachedPorts
      
      * Pluggable discovery upload user fields are now limited to 50 chars
      
      * Fix i18n strings
      
      * Fix failing integration tests
      
      * Fix i18n data
      
      * Fix integration tests again
      
      * [skip changelog] Internationalize strings added for pluggable discovery support (#1384)
      
      * Update docs/pluggable-discovery-specification.md
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      
      * Fix failing workflows
      
      * Updated upload-mock tests for generation
      
      * Added a lot of mock upload test (also with programmer option)
      
      * test_upload_mock: Handle '{' and '}' in recipes
      
      * network ota: autoconvert network_patter from legacy
      
      * Automatically add port detection properties for network discovery
      
      * Slightly improved 'board list' text output
      
      * Default 'board list' timeout to 1s
      
      * Added some code review fixes
      
      * Added unit test for legacy-package conversion to pluggable discovery
      Co-authored-by: default avatarCristian Maglie <c.maglie@arduino.cc>
      Co-authored-by: default avatarper1234 <accounts@perglass.com>
      ec027a7f
  12. 20 Aug, 2021 1 commit
    • per1234's avatar
      [skip changelog] Use major version ref for `actions/github-script` action (#1404) · 3aceff5f
      per1234 authored
      Use of the major version ref will cause the workflow to benefit from ongoing development to its `actions/github-script`
      GitHub Actions action dependency at each patch or minor release up until such time as a new major release is made.
      Dependabot will submit a PR at that time, which will serve as the notification that a newer version is available. At that
      time, the maintainer should evaluate whether any changes to the workflow are required by the breaking change that
      triggered the major release before manually updating the major ref (i.e., `uses: actions/github-script@v5`).
      3aceff5f
  13. 17 Aug, 2021 1 commit
    • per1234's avatar
      [skip changelog] Run relevant workflows on release branch creation (#1400) · 1985936d
      per1234 authored
      * [skip changelog] Run relevant workflows on release branch creation
      
      The trunk-based development strategy is employed by this repository. This means that the release branch may contain a
      subset of the history of the default branch.
      
      The status of the GitHub Actions workflows should be evaluated before making a release. However, this is not so simple as
      checking the status of the commit at the tip of the release branch. The reason is that, for the sake of efficiency, the
      workflows are configured to run only when the processes are relevant to the trigger event (e.g., no need to run the Go
      unit tests for a change to the readme).
      
      In the case of the default branch, you can simply set the workflow runs filter to that branch and then check the result
      of the latest run of each workflow of interest. However, that was not possible to do with the release branch since it
      might be that the workflow was never run in that branch. The status of the latest run of the workflow in the default
      branch might not match the status for the release branch if the release branch does not contain the full history.
      
      For this reason, it will be helpful to trigger all relevant workflows on the creation of a release branch. This will
      ensure that each of those workflows will always have at least one run in the release branch. Subsequent commits pushed to
      the branch can run based on their usual trigger filters and the status of the latest run of each workflow in the branch
      will provide an accurate indication of the state of that branch.
      
      Branches are created for purposes other than releases, most notably feature branches to stage work for a pull request.
      Because the workflows are very comprehensive, it would not be convenient or efficient to run them on the creation of
      every feature branch.
      
      Unfortunately, GitHub Actions does not support filters on the `create` event of branch creation like it does for the
      `push` and `pull_request` events. There is support for a `branches` filter of the `push` event, but that filter is an AND
      to the `paths` filter and this application requires an OR. For this reason, the workflows must be triggered by the
      creation of any branch. The unwanted job runs are prevented by adding a `run-determination` job with the branch filter
      handled by Bash commands. The other jobs of the workflow use this `run-determination` job as a dependency, only running
      when it indicates they should via a job output. Because this minimal `run-determination` job runs very quickly, it is
      roughly equivalent to the workflow having been skipped entirely for non-release branch creations. This approach has been
      in use for some time already in the website deployment workflow.
      
      * [skip changlog] Simplify jobs run determination logic
      Co-authored-by: default avatarCristian Maglie <c.maglie@bug.st>
      Co-authored-by: default avatarCristian Maglie <c.maglie@bug.st>
      1985936d
  14. 13 Aug, 2021 3 commits
    • per1234's avatar
      [skip changelog] Don't require Codecov upload success for test run in fork (#1397) · 408cee85
      per1234 authored
      * [skip changelog] Use major version refs of action in "Test Go" workflow
      
      Use of the major version ref will cause the workflow to benefit from ongoing development to the actions up until such
      time as a new major release of an action is made, at which time we would need to evaluate whether any changes to the
      workflow are required by the breaking change that triggered the major release before updating the major ref
      (e.g., `uses: codecov/codecov-action@v3`).
      
      The previous pin to the patch version required an update to the workflow on every action release in order to keep it
      updated.
      
      * [skip changelog] Don't require Codecov upload success for test run in fork
      
      The "Test Go" workflow uploads code coverage data to Codecov. There will occasionally be spurious upload failures caused
      by transient network outages. These will typically succeed after the workflow is re-run, but the option to re-run is not
      offered when the workflow run passes.
      
      Because it's important that the data be complete, the `codecov/codecov-action` action is configured to fail the workflow
      run if the upload does not succeed. However, the upload will never be able to succeed for workflow runs in a fork where
      the owner has not set up Codecov. For this reason, the `fail_ci_if_error` input setting is made conditional upon the
      repository name.
      
      The result is:
      
      - Coverage data upload success is required for all workflow runs in the `arduino/arduino-cli` repository.
      - Uploads are attempted for workflow runs in forks (because the fork owner might have Codecov set up and want the data),
        but they are not required to succeed and will fail silently.
      408cee85
    • per1234's avatar
      [skip changelog] Sync install script with template (#1396) · bec94dba
      per1234 authored
      * [skip changelog] Bring shell scripts into compliance with standard formatting
      
      A standardized style for all Arduino Tooling shell scripts has been established. The `.editorconfig` file is updated
      accordingly and all the repository's scripts made compliant with it.
      
      * [skip changelog] Sync install script with template
      
      We have assembled a collection of reusable project assets:
      https://github.com/arduino/tooling-project-assets
      These assets will be used in the repositories of all Arduino tooling projects.
      
      Some minor improvements and standardizations have been made in the upstream "template" installation script, and those are
      introduced to this repository via this pull request.
      
      Notable:
      
      - ShellCheck compliance
      - Support for specifying nightly build versions (e.g., "nightly-latest") via the script argument
      - Remove cryptic output not of interest to the user (likely forgotten debug artifacts from script development)
      bec94dba
    • per1234's avatar
      [skip changelog] Sync "Release" workflow with template (#1395) · c4d39e35
      per1234 authored
      We have assembled a collection of reusable GitHub Actions workflows:
      https://github.com/arduino/tooling-project-assets
      These workflows will be used in the repositories of all Arduino tooling projects.
      
      Some minor improvements and standardizations have been made in the upstream "template" workflow, and those are introduced to this repository via this pull request.
      
      Notable:
      
      - Replace changelog file read, deprecated `actions/create-release`, and asset upload steps with the comprehensive `ncipollo/release-action` action
      c4d39e35
  15. 12 Aug, 2021 5 commits
    • per1234's avatar
      [skip changelog] Sync "Publish Nightly Build" CI workflow with template (#1394) · 2d88f113
      per1234 authored
      * [skip changelog] Remove obsolete link footnotes from readme
      
      These have been replaced by more maintainable direct links.
      
      * [skip changelog] Sync "Publish Nightly Build" CI workflow with template
      
      We have assembled a collection of reusable GitHub Actions workflows:
      https://github.com/arduino/tooling-project-assets
      These workflows will be used in the repositories of all Arduino tooling projects.
      
      Some minor improvements and standardizations have been made in the upstream "template" workflow, and those are introduced to this repository via this pull request.
      
      Notable:
      
      - Improved failure reporting
      - Manual triggers to allow publishing on demand
      2d88f113
    • per1234's avatar
      [skip changelog] Sync "Check Python" CI workflow with template (#1393) · 7989a4ef
      per1234 authored
      * [skip changelog] Sync "Check Python" CI workflow with template
      
      We have assembled a collection of reusable project assets:
      https://github.com/arduino/tooling-project-assets
      These assets will be used in the repositories of all Arduino tooling projects.
      
      Some minor improvements and standardizations have been made in the upstream "template" assets, and those are
      introduced to this repository here.
      
      Notable:
      
      - Check for black formatting style compliance
      - Update tool dependencies
      - Standardize linting task name and deprecate old task name
      - Add cyclomatic complexity check
      - Add pep8-naming plugin to flake8
      
      * [skip changelog] Restore formatting compliance of Python code after black update
      
      After updating the black formatter tool, the new version wanted a small change in the Python formatting.
      
      * Remove obsolete Python linting task
      
      The sync with the template documentation assets has resulted in new standardized names for some of the tasks.
      
      The `python:check` task has been renamed to `python:lint`
      7989a4ef
    • per1234's avatar
      [skip changelog] Add formatting check to "Check Protocol Buffers" workflow (#1391) · ab31c21b
      per1234 authored
      On every push and pull request that affects relevant files, check the protocol buffer files for code formatting
      inconsistency.
      ab31c21b
    • per1234's avatar
      [skip changelog] Run formatting and linting CI checks on all Go modules (#1390) · 3f2e910c
      per1234 authored
      The repository contains multiple Go modules. Previously, the CI workflow that lints and checks the formatting of the
      repository's Go code was only checking the primary module in the root of the repo.
      
      This workflow is now expanded to cover all Go code through the use of a dedicated matrix job for each of the modules.
      
      Arbitrary Go module paths can be specified to the tasks by defining the `GO_MODULE_PATH` environment variable. If this
      variable is not defined, the default root module path is used as default, preserving the previous task behavior.
      3f2e910c
    • per1234's avatar
      [skip changelog] Revert "Add skip changelog prefix to Dependabot workflow... · d052cf64
      per1234 authored
      [skip changelog] Revert "Add skip changelog prefix to Dependabot workflow update commits (#1381)" (#1389)
      
      This reverts commit 4fbf7b7b.
      
      It turns out there is an undocumented maximum length of 15 characters for this prefix:
      
      https://github.com/arduino/arduino-cli/network/updates
      
      ```
      Dependabot encountered the following error when parsing your .github/dependabot.yml:
      
      The property '#/updates/0/commit-message/prefix' was not of a maximum string length of 15
      Please update the config file to conform with Dependabot's specification.
      ```
      Unfortunately, even though it is possible to reduce the prefix length by 1 with the removal of the trailing space, we
      still end up with 16 characters.
      d052cf64
  16. 11 Aug, 2021 1 commit
    • Matthijs Kooijman's avatar
      Fix error printing when core uninstall fails during upgrade (#1371) · f632a9d2
      Matthijs Kooijman authored
      The code tried to log the wrong error, which was nil, hiding the real
      error.
      
      This originally occurred for example when a version of the core was already
      installed manually in the sketchbook, and you would try to install
      another version using arduino-cli, though that has since been fixed
      (arduino-cli no longer tries to uninstall cores from the sketchbook).
      
      To still reproduce this problem, you can e.g. break the permissions of
      an installed core:
      
          $ arduino-cli core install arduino:avr@1.8.1
          (...)
          $ chmod a-w ~/.arduino15/packages/arduino/hardware/avr/1.8.1
          $ arduino-cli core install arduino:avr@1.8.2
          Tool arduino:avr-gcc@7.3.0-atmel3.6.1-arduino5 already installed
          Tool arduino:avrdude@6.3.0-arduino17 already installed
          Tool arduino:arduinoOTA@1.3.0 already installed
          Downloading packages...
          arduino:avr@1.8.2 already downloaded
          Upgrading arduino:avr@1.8.1 with arduino:avr@1.8.2...
          Error upgrading platform: %!s(<nil>)...
          Error during install: upgrading platform: removing platform files: unlinkat /home/matthijs/.arduino15/packages/arduino/hardware/avr/1.8.1/firmwares: permission denied
      
      With this fix applied, this produces a proper error message:
      
          $ arduino-cli core install arduino:avr@1.8.2
          Tool arduino:avr-gcc@7.3.0-atmel3.6.1-arduino5 already installed
          Tool arduino:avrdude@6.3.0-arduino17 already installed
          Tool arduino:arduinoOTA@1.3.0 already installed
          Downloading packages...
          arduino:avr@1.8.2 already downloaded
          Upgrading arduino:avr@1.8.1 with arduino:avr@1.8.2...
          Error upgrading platform: removing platform files: unlinkat /home/matthijs/.arduino15/packages/arduino/hardware/avr/1.8.1/firmwares: permission denied...
          Error during install: upgrading platform: removing platform files: unlinkat /home/matthijs/.arduino15/packages/arduino/hardware/avr/1.8.1/firmwares: permission denied
      f632a9d2