Handle Arduino CLI 1.x core list data format

The action parses the output of the `arduino-cli core list --format json` command.

There was a breaking change to the data format of that output was changed in the 1.0.0 release of Arduino CLI.

The action code is updated to handle the new output, while also retaining backwards compatibility with the pre-1.x data
format in order to support workflows that pin the Arduino CLI version to >1.0.0 via the action's "cli-version" input.

Author: per1234

compilesketches/compilesketches.py

@@ -558,7 +558,7 @@ def __init__(self):
         self.run_arduino_cli_command(command=["core", "update-index"])
         # Use Arduino CLI to get the list of installed platforms
         command_data = self.run_arduino_cli_command(command=["core", "list", "--format", "json"])
-        installed_platform_list = json.loads(command_data.stdout)
+        installed_platform_list = self.cli_core_list_platform_list(json.loads(command_data.stdout))
         for installed_platform in installed_platform_list:
             if installed_platform[self.cli_json_key("core list", "ID")] == platform[self.dependency_name_key]:
                 # The platform has been installed via Board Manager, so do an overwrite
@@ -1437,6 +1437,26 @@ def create_sketches_report_file(self, sketches_report):
         ) as report_file:
             json.dump(obj=sketches_report, fp=report_file, indent=2)
 
+    def cli_core_list_platform_list(self, data):
+        """Extract the list of platform data from the `arduino-cli core list` command output according to the Arduino
+        CLI version in use.
+
+        Keyword arguments:
+        data -- Arduino CLI command output data
+        """
+        # Interface was changed at this Arduino CLI release:
+        # https://arduino.github.io/arduino-cli/dev/UPGRADING/#cli-changed-json-output-for-some-lib-core-config-board-and-sketch-commands
+        first_new_interface_version = "1.0.0"
+
+        if (
+            not semver.VersionInfo.is_valid(version=self.cli_version)
+            or semver.Version.parse(version=self.cli_version).compare(other=first_new_interface_version) >= 0
+        ):
+            # cli_version is either "latest" (which will now always be >=1.0.0) or an explicit version >=1.0.0
+            return data["platforms"]
+
+        return data
+
     def cli_json_key(self, command, original_key_name):
         """Return the appropriate JSON output key name for the Arduino CLI version in use.
 

compilesketches/tests/test_compilesketches.py

@@ -2883,6 +2883,21 @@ def test_create_sketches_report_file(monkeypatch, tmp_path):
         assert json.load(sketch_report_file) == sketches_report
 
 
+@pytest.mark.parametrize(
+    "cli_version, data, assertion",
+    [
+        ("latest", {"platforms": [unittest.mock.sentinel.list_item]}, [unittest.mock.sentinel.list_item]),  # Non-semver
+        ("2.0.0", {"platforms": [unittest.mock.sentinel.list_item]}, [unittest.mock.sentinel.list_item]),  # >
+        ("1.0.0", {"platforms": [unittest.mock.sentinel.list_item]}, [unittest.mock.sentinel.list_item]),  # ==
+        ("0.1.2", [unittest.mock.sentinel.list_item], [unittest.mock.sentinel.list_item]),  # <
+    ],
+)
+def test_cli_core_list_platform_list(cli_version, data, assertion):
+    compile_sketches = get_compilesketches_object(cli_version=cli_version)
+
+    assert compile_sketches.cli_core_list_platform_list(data) == assertion
+
+
 @pytest.mark.parametrize(
     "cli_version, command, original_key, expected_key",
     [