# Copyright (c) 2014-present PlatformIO # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # pylint: disable=unused-argument import os from platformio import fs from platformio.package.commands.install import package_install_cmd from platformio.package.commands.update import package_update_cmd from platformio.package.exception import UnknownPackageError from platformio.package.manager.library import LibraryPackageManager from platformio.package.manager.platform import PlatformPackageManager from platformio.package.manager.tool import ToolPackageManager from platformio.package.meta import PackageSpec from platformio.project.config import ProjectConfig DALLASTEMPERATURE_LATEST_VERSION = "3.11.0" PROJECT_OUTDATED_CONFIG_TPL = """ [env:devkit] platform = platformio/atmelavr@^2 framework = arduino board = attiny88 lib_deps = milesburton/DallasTemperature@^3.9.1 """ PROJECT_UPDATED_CONFIG_TPL = """ [env:devkit] platform = platformio/atmelavr@<4 framework = arduino board = attiny88 lib_deps = milesburton/DallasTemperature@^3.9.1 """ def pkgs_to_specs(pkgs): return [ PackageSpec(name=pkg.metadata.name, requirements=pkg.metadata.version) for pkg in pkgs ] def test_custom_project_libraries( clirunner, validate_cliresult, isolated_pio_core, get_pkg_latest_version, tmp_path ): project_dir = tmp_path / "project" project_dir.mkdir() (project_dir / "platformio.ini").write_text(PROJECT_OUTDATED_CONFIG_TPL) spec = "milesburton/DallasTemperature@^3.9.1" result = clirunner.invoke( package_install_cmd, ["-d", str(project_dir), "-e", "devkit", "-l", spec], ) validate_cliresult(result) with fs.cd(str(project_dir)): config = ProjectConfig() assert config.get("env:devkit", "lib_deps") == [spec] lm = LibraryPackageManager( os.path.join(config.get("platformio", "libdeps_dir"), "devkit") ) assert pkgs_to_specs(lm.get_installed()) == [ PackageSpec(f"DallasTemperature@{DALLASTEMPERATURE_LATEST_VERSION}"), PackageSpec( "OneWire@%s" % get_pkg_latest_version("paulstoffregen/OneWire") ), ] # update package result = clirunner.invoke( package_update_cmd, ["-e", "devkit", "-l", "milesburton/DallasTemperature@^3.9.1"], ) assert ProjectConfig().get("env:devkit", "lib_deps") == [ "milesburton/DallasTemperature@^3.9.1" ] # try again result = clirunner.invoke( package_update_cmd, ["-e", "devkit", "-l", "milesburton/DallasTemperature@^3.9.1"], ) validate_cliresult(result) assert "Already up-to-date." in result.output # install library without saving to config result = clirunner.invoke( package_update_cmd, ["-e", "devkit", "-l", "milesburton/DallasTemperature@^3", "--no-save"], ) validate_cliresult(result) assert "Already up-to-date." in result.output config = ProjectConfig() lm = LibraryPackageManager( os.path.join(config.get("platformio", "libdeps_dir"), "devkit") ) assert pkgs_to_specs(lm.get_installed()) == [ PackageSpec("DallasTemperature@3.11.0"), PackageSpec( "OneWire@%s" % get_pkg_latest_version("paulstoffregen/OneWire") ), ] assert config.get("env:devkit", "lib_deps") == [ "milesburton/DallasTemperature@^3.9.1" ] # unknown libraries result = clirunner.invoke( package_update_cmd, ["-l", "platformio/unknown_library"] ) assert isinstance(result.exception, UnknownPackageError) def test_custom_project_tools( clirunner, validate_cliresult, func_isolated_pio_core, tmp_path ): project_dir = tmp_path / "project" project_dir.mkdir() (project_dir / "platformio.ini").write_text(PROJECT_OUTDATED_CONFIG_TPL) spec = "toolchain-atmelavr@~1.50400.0" result = clirunner.invoke( package_install_cmd, ["-d", str(project_dir), "-e", "devkit", "-t", spec], ) validate_cliresult(result) with fs.cd(str(project_dir)): assert ProjectConfig().get("env:devkit", "platform_packages") == [ "platformio/toolchain-atmelavr@~1.50400.0" ] assert pkgs_to_specs(ToolPackageManager().get_installed()) == [ PackageSpec("toolchain-atmelavr@1.50400.190710") ] result = clirunner.invoke( package_update_cmd, ["-e", "devkit", "-t", "toolchain-atmelavr@^1"], ) validate_cliresult(result) assert ProjectConfig().get("env:devkit", "platform_packages") == [ "platformio/toolchain-atmelavr@^1" ] assert pkgs_to_specs(ToolPackageManager().get_installed()) == [ PackageSpec("toolchain-atmelavr@1.70300.191015") ] # install without saving to config result = clirunner.invoke( package_update_cmd, ["-e", "devkit", "-t", "toolchain-atmelavr@~1.70300.191015", "--no-save"], ) validate_cliresult(result) assert "Already up-to-date." in result.output assert ProjectConfig().get("env:devkit", "platform_packages") == [ "platformio/toolchain-atmelavr@^1" ] # unknown tool result = clirunner.invoke(package_update_cmd, ["-t", "platformio/unknown_tool"]) assert isinstance(result.exception, UnknownPackageError) def test_custom_project_platforms( clirunner, validate_cliresult, func_isolated_pio_core, tmp_path ): project_dir = tmp_path / "project" project_dir.mkdir() (project_dir / "platformio.ini").write_text(PROJECT_OUTDATED_CONFIG_TPL) spec = "atmelavr@^2" result = clirunner.invoke( package_install_cmd, ["-d", str(project_dir), "-e", "devkit", "-p", spec, "--skip-dependencies"], ) validate_cliresult(result) with fs.cd(str(project_dir)): assert pkgs_to_specs(PlatformPackageManager().get_installed()) == [ PackageSpec("atmelavr@2.2.0") ] assert ProjectConfig().get("env:devkit", "platform") == "platformio/atmelavr@^2" # update result = clirunner.invoke( package_install_cmd, ["-e", "devkit", "-p", "platformio/atmelavr@^3", "--skip-dependencies"], ) validate_cliresult(result) assert pkgs_to_specs(PlatformPackageManager().get_installed()) == [ PackageSpec("atmelavr@3.4.0"), PackageSpec("atmelavr@2.2.0"), ] assert ProjectConfig().get("env:devkit", "platform") == "platformio/atmelavr@^2" # unknown platform result = clirunner.invoke(package_install_cmd, ["-p", "unknown_platform"]) assert isinstance(result.exception, UnknownPackageError)