Allow installation of platform dependencies from archive downloads

Benefits:
- Allows installing platforms that are not available from a Git repository.
- Installing from an archive download is often faster than cloning a repository.

Author: per1234

README.md

@@ -55,6 +55,13 @@ Keys:
 - `source-path` - path to install as a library. Paths are relative to the root of the repository. The default is to install from the root of the repository.
 - `name` - platform name in the form of `VENDOR:ARCHITECTURE`.
 
+##### Archive download
+
+Keys:
+- `source-url` - download URL for the archive (e.g., `https://github.com/arduino/ArduinoCore-avr/archive/master.zip`).
+- `source-path` - path to install as a library. Paths are relative to the root folder of the archive, or the root of the archive if it has no root folder. The default is to install from the root folder of the archive.
+- `name` - platform name in the form of `VENDOR:ARCHITECTURE`.
+
 ### `libraries`
 
 YAML-format list of library dependencies to install.

compilesketches/compilesketches.py

@@ -237,6 +237,9 @@ def install_platforms(self):
         if len(platform_list.repository) > 0:
             self.install_platforms_from_repository(platform_list=platform_list.repository)
 
+        if len(platform_list.download) > 0:
+            self.install_platforms_from_download(platform_list=platform_list.download)
+
     def get_fqbn_platform_dependency(self):
         """Return the platform dependency definition automatically generated from the FQBN."""
         # Extract the platform name from the FQBN (e.g., arduino:avr:uno => arduino:avr)
@@ -564,6 +567,26 @@ def clone_repository(self, url, git_ref, destination_path):
             # checkout ref
             cloned_repository.git.checkout(git_ref)
 
+    def install_platforms_from_download(self, platform_list):
+        """Install libraries by downloading them
+
+        Keyword arguments:
+        platform_list -- list of dictionaries defining the dependencies
+        """
+        for platform in platform_list:
+            self.verbose_print("Installing platform from download URL:", platform[self.dependency_source_url_key])
+            if self.dependency_source_path_key in platform:
+                source_path = platform[self.dependency_source_path_key]
+            else:
+                source_path = "."
+
+            destination_path = self.get_platform_installation_path(platform=platform)
+
+            install_from_download(url=platform[self.dependency_source_url_key],
+                                  source_path=source_path,
+                                  destination_parent_path=destination_path.base,
+                                  destination_name=destination_path.platform)
+
     def install_libraries(self):
         """Install Arduino libraries."""
         libraries = yaml.load(stream="", Loader=yaml.SafeLoader)

compilesketches/tests/test_compilesketches.py

@@ -767,6 +767,47 @@ def test_get_repository_dependency_ref(dependency, expected_ref):
     assert compile_sketches.get_repository_dependency_ref(dependency=dependency) == expected_ref
 
 
+def test_install_platforms_from_download(mocker):
+    platform_list = [
+        {compilesketches.CompileSketches.dependency_source_url_key: unittest.mock.sentinel.source_url1,
+         compilesketches.CompileSketches.dependency_source_path_key: unittest.mock.sentinel.source_path,
+         compilesketches.CompileSketches.dependency_destination_name_key: unittest.mock.sentinel.destination_name},
+        {compilesketches.CompileSketches.dependency_source_url_key: unittest.mock.sentinel.source_url2}
+    ]
+
+    class PlatformInstallationPath:
+        def __init__(self):
+            self.base = pathlib.PurePath()
+            self.platform = pathlib.PurePath()
+
+    platform_installation_path = PlatformInstallationPath()
+    platform_installation_path.parent = pathlib.Path("/foo/PlatformInstallationPathParent")
+    platform_installation_path.name = pathlib.Path("PlatformInstallationPathName")
+
+    expected_source_path_list = [unittest.mock.sentinel.source_path, "."]
+
+    compile_sketches = get_compilesketches_object()
+
+    mocker.patch("compilesketches.CompileSketches.get_platform_installation_path",
+                 autospec=True,
+                 return_value=platform_installation_path)
+    mocker.patch("compilesketches.install_from_download", autospec=True)
+
+    compile_sketches.install_platforms_from_download(platform_list=platform_list)
+
+    get_platform_installation_path_calls = []
+    install_platforms_from_download_calls = []
+    for platform, expected_source_path, in zip(platform_list, expected_source_path_list):
+        get_platform_installation_path_calls.append(unittest.mock.call(compile_sketches, platform=platform))
+        install_platforms_from_download_calls.append(
+            unittest.mock.call(url=platform[compilesketches.CompileSketches.dependency_source_url_key],
+                               source_path=expected_source_path,
+                               destination_parent_path=platform_installation_path.base,
+                               destination_name=platform_installation_path.platform)
+        )
+    compilesketches.install_from_download.assert_has_calls(calls=install_platforms_from_download_calls)
+
+
 @pytest.mark.parametrize(
     "libraries, expected_manager, expected_path, expected_repository, expected_download",
     [("", [], [{compilesketches.CompileSketches.dependency_source_path_key: pathlib.PurePath("/foo/GitHubWorkspace")}],