1. 30 Sep, 2021 3 commits
    • Umberto Baldi's avatar
      POC Dynamic shell completion for fqbn flag (#1431) · 991a2649
      Umberto Baldi authored
      * make fqbn flag required, so that the completion suggests it when pressing <tab><tab>
      for better explanation see https://github.com/spf13/cobra/blob/master/shell_completions.md#mark-flags-as-required
      
      * use newer and supported bashv2 completion in order to have dynamic completion
      
      * add dynamic completion for `compile -b` command to list available board
      
      * Revert "make fqbn flag required, so that the completion suggests it when pressing <tab><tab>"
      
      This reverts commit cc812654d3b7bf096ef8d86c7e550d2a5bc28084.
      
      * make Internalization happy
      991a2649
    • Umberto Baldi's avatar
      [skip changelog] Update cobra to latest version (#1430) · 50778940
      Umberto Baldi authored
      * bump github.com/spf13/cobra to 1.2.1
      
      * go mod tidy
      
      * fix CI failing
      
      * update powershell tests, in new version of cobra the completion file is different
      50778940
    • per1234's avatar
      Correct typo in mdns-discovery archive checksum (#1448) · 637e9078
      per1234 authored
      A typo in the checksum definition for the arm-linux-gnueabihf  host version of the mdns-discovery tool caused installation to fail on that target:
      
      Installing builtin:mdns-discovery@0.9.2...
      Error initializing instance: installing builtin:mdns-discovery@0.9.2 tool: Cannot install tool builtin:mdns-discovery@0.9.2: testing local archive integrity: testing archive checksum: invalid checksum format: SHA-256cc1096936abddb21af23fa10c435e8e9e37ec9df2c3d2c41d265d466b03de0af
      637e9078
  2. 24 Sep, 2021 7 commits
  3. 22 Sep, 2021 1 commit
  4. 02 Sep, 2021 1 commit
  5. 01 Sep, 2021 2 commits
  6. 31 Aug, 2021 4 commits
  7. 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
  8. 27 Aug, 2021 1 commit
  9. 26 Aug, 2021 3 commits
  10. 25 Aug, 2021 2 commits
  11. 24 Aug, 2021 5 commits
  12. 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
  13. 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
  14. 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
  15. 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
  16. 12 Aug, 2021 3 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