Files
aqtinstall/tests/test_cli.py
2023-08-28 05:28:45 -07:00

573 lines
22 KiB
Python

import re
import sys
from pathlib import Path
from tempfile import TemporaryDirectory
from typing import Dict, List, Optional, Union
import pytest
from aqt.exceptions import CliInputError
from aqt.helper import Settings
from aqt.installer import Cli
from aqt.metadata import MetadataFactory, SimpleSpec, Version
def expected_help(actual, prefix=None):
expected = (
"usage: aqt [-h] [-c CONFIG]\n"
" {install-qt,install-tool,install-doc,install-example,install-src,"
"list-qt,list-tool,list-doc,list-example,list-src,"
"install,tool,doc,examples,src,help,version}\n"
" ...\n"
"\n"
"Another unofficial Qt Installer.\n"
"aqt helps you install Qt SDK, tools, examples and others\n"
"\n"
"option",
" -h, --help show this help message and exit\n"
" -c CONFIG, --config CONFIG\n"
" Configuration ini file.\n"
"\n"
"subcommands:\n"
" aqt accepts several subcommands:\n"
" install-* subcommands are commands that install components\n"
" list-* subcommands are commands that show available components\n"
" \n"
" commands {install|tool|src|examples|doc} are deprecated and marked for "
"removal\n"
"\n"
" {install-qt,install-tool,install-doc,install-example,install-src,list-qt,"
"list-tool,list-doc,list-example,list-src,"
"install,tool,doc,examples,src,help,version}\n"
" Please refer to each help message by using '--help' "
"with each subcommand\n",
)
if prefix is not None:
return actual.startswith(prefix + expected[0]) and actual.endswith(expected[1])
return actual.startswith(expected[0]) and actual.endswith(expected[1])
def test_cli_help(capsys):
cli = Cli()
cli.run(["help"])
out, err = capsys.readouterr()
assert expected_help(out)
@pytest.mark.parametrize(
"qt_version, modules, unexpected_modules",
(
("5.11.3", ["qtcharts", "qtwebengine"], []),
("5.11.3", ["not_exist"], ["not_exist"]),
("5.11.3", ["qtcharts", "qtwebengine", "not_exist"], ["not_exist"]),
("5.11.3", None, []),
("5.15.0", ["Unknown"], ["Unknown"]),
),
)
def test_cli_select_unexpected_modules(qt_version: str, modules: Optional[List[str]], unexpected_modules: List[str]):
cli = Cli()
cli._setup_settings()
assert cli._select_unexpected_modules(qt_version, modules) == unexpected_modules
nonexistent_qt = "5.16.0"
assert cli._select_unexpected_modules(nonexistent_qt, modules) == sorted(modules or [])
def test_cli_check_combination():
cli = Cli()
cli._setup_settings()
assert cli._check_qt_arg_combination("5.11.3", "linux", "desktop", "gcc_64")
assert cli._check_qt_arg_combination("5.11.3", "mac", "desktop", "clang_64")
assert not cli._check_qt_arg_combination("5.14.0", "android", "desktop", "clang_64")
def test_cli_check_version():
cli = Cli()
cli._setup_settings()
assert cli._check_qt_arg_versions("5.12.0")
assert not cli._check_qt_arg_versions("5.12")
@pytest.mark.parametrize(
"host, target, arch, version_or_spec, expected_version, is_bad_spec",
(
("windows", "desktop", "wasm_32", "6.1", None, False),
("windows", "desktop", "wasm_32", "5.12", None, False),
("windows", "desktop", "wasm_32", "5.13", Version("5.13.2"), False),
("windows", "desktop", "wasm_32", "5", Version("5.15.2"), False),
("windows", "desktop", "wasm_32", "<5.14.5", Version("5.14.2"), False),
("windows", "desktop", "mingw32", "6.0", Version("6.0.3"), False),
("windows", "winrt", "mingw32", "6", None, False),
("windows", "winrt", "mingw32", "bad spec", None, True),
("windows", "android", "android_x86", "6", Version("6.1.0"), False),
("windows", "desktop", "android_x86", "6", Version("6.5.0"), False), # does not validate arch
("windows", "desktop", "android_fake", "6", Version("6.5.0"), False), # does not validate arch
),
)
def test_cli_determine_qt_version(
monkeypatch, host, target, arch, version_or_spec: str, expected_version: Version, is_bad_spec: bool
):
_html = (Path(__file__).parent / "data" / f"{host}-{target}.html").read_text("utf-8")
monkeypatch.setattr(MetadataFactory, "fetch_http", lambda *args, **kwargs: _html)
cli = Cli()
cli._setup_settings()
if is_bad_spec:
with pytest.raises(CliInputError) as e:
Cli._determine_qt_version(version_or_spec, host, target, arch)
assert e.type == CliInputError
assert format(e.value) == f"Invalid version or SimpleSpec: '{version_or_spec}'\n" + SimpleSpec.usage()
elif not expected_version:
with pytest.raises(CliInputError) as e:
Cli._determine_qt_version(version_or_spec, host, target, arch)
assert e.type == CliInputError
expect_msg = f"No versions of Qt exist for spec={version_or_spec} with host={host}, target={target}, arch={arch}"
actual_msg = format(e.value)
assert actual_msg == expect_msg
else:
ver = Cli._determine_qt_version(version_or_spec, host, target, arch)
assert ver == expected_version
@pytest.mark.parametrize(
"invalid_version",
("5.15", "five-dot-fifteen", "5", "5.5.5.5"),
)
def test_cli_invalid_version(capsys, invalid_version):
"""Checks that invalid version strings are handled properly"""
# Ensure that invalid_version cannot be a semantic_version.Version
with pytest.raises(ValueError):
Version(invalid_version)
cli = Cli()
cli._setup_settings()
matcher = re.compile(
r"^INFO : aqtinstall\(aqt\) v.* on Python 3.*\n"
r"(.*\n)*"
r"ERROR :.*Invalid version: '" + invalid_version + r"'! Please use the form '5\.X\.Y'\.\n.*"
)
for cmd in (
("install", invalid_version, "mac", "desktop"),
("doc", invalid_version, "mac", "desktop"),
("list-qt", "mac", "desktop", "--arch", invalid_version),
):
cli = Cli()
assert cli.run(cmd) == 1
out, err = capsys.readouterr()
sys.stdout.write(out)
sys.stderr.write(err)
assert matcher.match(err)
@pytest.mark.parametrize(
"version, allow_latest, allow_empty, allow_minus, expect_ok",
(
("1.2.3", False, False, False, True),
("1.2.", False, False, False, False),
("latest", True, False, False, True),
("latest", False, False, False, False),
("", False, True, False, True),
("", False, False, False, False),
("1.2.3-0-123", False, False, True, True),
("1.2.3-0-123", False, False, False, False),
),
)
def test_cli_validate_version(version: str, allow_latest: bool, allow_empty: bool, allow_minus: bool, expect_ok: bool):
if expect_ok:
Cli._validate_version_str(version, allow_latest=allow_latest, allow_empty=allow_empty, allow_minus=allow_minus)
else:
with pytest.raises(CliInputError) as err:
Cli._validate_version_str(version, allow_latest=allow_latest, allow_empty=allow_empty, allow_minus=allow_minus)
assert err.type == CliInputError
def test_cli_check_mirror():
cli = Cli()
cli._setup_settings()
assert cli._check_mirror(None)
arg = ["install-qt", "linux", "desktop", "5.11.3", "-b", "https://download.qt.io/"]
args = cli.parser.parse_args(arg)
assert args.base == "https://download.qt.io/"
assert cli._check_mirror(args.base)
@pytest.mark.parametrize(
"arch, host, target, version, expect",
(
("impossible_arch", "windows", "desktop", "6.2.0", "impossible_arch"),
("", "windows", "desktop", "6.2.0", None),
(None, "windows", "desktop", "6.2.0", None),
(None, "linux", "desktop", "6.2.0", "gcc_64"),
(None, "mac", "desktop", "6.2.0", "clang_64"),
(None, "mac", "ios", "6.2.0", "ios"),
(None, "mac", "android", "6.2.0", "android"),
(None, "mac", "android", "5.12.0", None),
# SimpleSpec instead of Version
("impossible_arch", "windows", "desktop", "6.2", "impossible_arch"),
("", "windows", "desktop", "6.2", None),
(None, "windows", "desktop", "6.2", None),
(None, "linux", "desktop", "6.2", "gcc_64"),
(None, "mac", "desktop", "6.2", "clang_64"),
(None, "mac", "ios", "6.2", "ios"),
(None, "mac", "android", "6.2", None), # No way to determine arch for android target w/o version
),
)
def test_set_arch(arch: Optional[str], host: str, target: str, version: str, expect: Optional[str]):
if not expect:
with pytest.raises(CliInputError) as e:
Cli._set_arch(arch, host, target, version)
assert e.type == CliInputError
assert format(e.value) == "Please supply a target architecture."
assert e.value.should_show_help is True
else:
assert Cli._set_arch(arch, host, target, version) == expect
@pytest.mark.parametrize(
"cmd, expect_msg, should_show_help",
(
(
"install-qt mac ios 6.2.0 --base not_a_url",
"The `--base` option requires a url where the path `online/qtsdkrepository` exists.",
True,
),
(
"install-qt mac ios 6.2.0 --noarchives",
"When `--noarchives` is set, the `--modules` option is mandatory.",
False,
),
(
"install-qt mac ios 6.2.0 --noarchives --archives",
"When `--noarchives` is set, the `--modules` option is mandatory.",
False,
),
(
"install-qt mac ios 6.2.0 --noarchives --archives --modules qtcharts",
"Options `--archives` and `--noarchives` are mutually exclusive.",
False,
),
(
"install-src mac ios 6.2.0 --kde",
"KDE patch: unsupported version!!",
False,
),
),
)
def test_cli_input_errors(capsys, cmd, expect_msg, should_show_help):
cli = Cli()
cli._setup_settings()
assert 1 == cli.run(cmd.split())
out, err = capsys.readouterr()
if should_show_help:
assert expected_help(out)
else:
assert out == ""
assert err.rstrip().endswith(expect_msg)
# These commands use the new syntax with the legacy commands
@pytest.mark.parametrize(
"cmd",
(
"install linux desktop 5.10.0",
"install linux desktop 5.10.0 gcc_64",
"src linux desktop 5.10.0",
"doc linux desktop 5.10.0",
"example linux desktop 5.10.0",
"tool windows desktop tools_ifw",
),
)
def test_cli_legacy_commands_with_wrong_syntax(cmd):
cli = Cli()
cli._setup_settings()
with pytest.raises(SystemExit) as e:
cli.run(cmd.split())
assert e.type == SystemExit
@pytest.mark.parametrize(
"cmd",
(
"tool windows desktop tools_ifw qt.tools.ifw.31", # New syntax
"tool windows desktop tools_ifw 1.2.3",
),
)
def test_cli_legacy_tool_new_syntax(monkeypatch, capsys, cmd):
# These incorrect commands cannot be filtered out directly by argparse because
# they have the correct number of arguments.
command = cmd.split()
expected = (
"WARNING : The command 'tool' is deprecated and marked for removal in a future version of aqt.\n"
"In the future, please use the command 'install-tool' instead.\n"
"ERROR : Invalid version: 'tools_ifw'! Please use the form '5.X.Y'.\n"
)
cli = Cli()
cli._setup_settings()
assert 1 == cli.run(command)
out, err = capsys.readouterr()
actual = err[err.index("\n") + 1 :]
assert actual == expected
@pytest.mark.parametrize(
"cmd, expect_err",
(
(
"list-qt mac --extension wasm",
"WARNING : The parameter 'extension' with value 'wasm' is deprecated "
"and marked for removal in a future version of aqt.\n"
"In the future, please omit this parameter.\n"
"WARNING : The '--extension' flag will be ignored.\n",
),
(
"list-qt mac desktop --extensions 6.2.0",
"WARNING : The parameter 'extensions' with value '6.2.0' is deprecated "
"and marked for removal in a future version of aqt.\n"
"In the future, please omit this parameter.\n"
"WARNING : The '--extensions' flag will always return an empty list, "
"because there are no useful arguments for the '--extension' flag.\n",
),
),
)
def test_cli_list_qt_deprecated_flags(capsys, cmd: str, expect_err: str):
cli = Cli()
cli._setup_settings()
assert 0 == cli.run(cmd.split())
out, err = capsys.readouterr()
assert err == expect_err
# These commands come directly from examples in the legacy documentation
@pytest.mark.parametrize(
"cmd",
(
"install 5.10.0 linux desktop", # default arch
"install 5.10.2 linux android android_armv7",
"src 5.15.2 windows desktop --archives qtbase --kde",
"doc 5.15.2 windows desktop -m qtcharts qtnetworkauth",
"examples 5.15.2 windows desktop -m qtcharts qtnetworkauth",
"tool linux tools_ifw 4.0 qt.tools.ifw.40",
),
)
def test_cli_legacy_commands_with_correct_syntax(monkeypatch, cmd):
# Pretend to install correctly when any command is run
for func in ("run_install_qt", "run_install_src", "run_install_doc", "run_install_example", "run_install_tool"):
monkeypatch.setattr(Cli, func, lambda *args, **kwargs: 0)
cli = Cli()
cli._setup_settings()
assert 0 == cli.run(cmd.split())
def test_cli_unexpected_error(monkeypatch, capsys):
def _mocked_run(*args):
raise RuntimeError("Some unexpected error")
monkeypatch.setattr("aqt.installer.Cli.run_install_qt", _mocked_run)
cli = Cli()
cli._setup_settings()
assert Cli.UNHANDLED_EXCEPTION_CODE == cli.run(["install-qt", "mac", "ios", "6.2.0"])
out, err = capsys.readouterr()
assert err.startswith("ERROR : Some unexpected error")
assert err.rstrip().endswith(
"===========================PLEASE FILE A BUG REPORT===========================\n"
"You have discovered a bug in aqt.\n"
"Please file a bug report at https://github.com/miurahr/aqtinstall/issues\n"
"Please remember to include a copy of this program's output in your report."
)
def test_cli_set_7zip_nonexistent(monkeypatch):
cli = Cli()
cli._setup_settings()
with pytest.raises(CliInputError) as err:
cli._set_sevenzip("some_nonexistent_binary")
assert err.type == CliInputError
assert format(err.value) == "Specified 7zip command executable does not exist: 'some_nonexistent_binary'"
@pytest.mark.parametrize("external_tool_exists", (True, False))
def test_set_7zip_checks_external_tool_when_specified(monkeypatch, capsys, external_tool_exists: bool):
cli = Cli()
cli._setup_settings()
external = "my_7z_extractor"
def mock_subprocess_run(args, **kwargs):
assert args[0] == external
if not external_tool_exists:
raise FileNotFoundError()
monkeypatch.setattr("aqt.installer.subprocess.run", mock_subprocess_run)
monkeypatch.setattr("aqt.installer.EXT7Z", False)
if external_tool_exists:
assert external == cli._set_sevenzip(external)
else:
with pytest.raises(CliInputError) as err:
cli._set_sevenzip(external)
assert format(err.value) == format(f"Specified 7zip command executable does not exist: '{external}'")
assert capsys.readouterr()[1] == ''
@pytest.mark.parametrize("fallback_exists", (True, False))
def test_set_7zip_uses_fallback_when_py7zr_missing(monkeypatch, capsys, fallback_exists: bool):
cli = Cli()
cli._setup_settings()
external, fallback = None, Settings.zipcmd
def mock_subprocess_run(args, **kwargs):
assert args[0] == fallback
if not fallback_exists:
raise FileNotFoundError()
monkeypatch.setattr("aqt.installer.subprocess.run", mock_subprocess_run)
monkeypatch.setattr("aqt.installer.EXT7Z", True)
if fallback_exists:
assert fallback == cli._set_sevenzip(external)
else:
with pytest.raises(CliInputError) as err:
cli._set_sevenzip(external)
assert format(err.value) == format(f"Fallback 7zip command executable does not exist: '{fallback}'")
assert f"Falling back to '{fallback}'" in capsys.readouterr()[1]
@pytest.mark.parametrize("fallback_exists", (True, False))
def test_set_7zip_chooses_p7zr_when_ext_missing(monkeypatch, capsys, fallback_exists: bool):
cli = Cli()
cli._setup_settings()
external = None
def mock_subprocess_run(args, **kwargs):
assert False, "Should not try to run anything"
monkeypatch.setattr("aqt.installer.subprocess.run", mock_subprocess_run)
monkeypatch.setattr("aqt.installer.EXT7Z", False)
assert cli._set_sevenzip(external) is None
assert capsys.readouterr()[1] == ''
@pytest.mark.parametrize(
"archive_dest, keep, temp_dir, expect, should_make_dir",
(
(None, False, "temp", "temp", False),
(None, True, "temp", ".", False),
("my_archives", False, "temp", "my_archives", True),
("my_archives", True, "temp", "my_archives", True),
),
)
def test_cli_choose_archive_dest(
monkeypatch, archive_dest: Optional[str], keep: bool, temp_dir: str, expect: str, should_make_dir: bool
):
enclosed = {"made_dir": False}
def mock_mkdir(*args, **kwargs):
enclosed["made_dir"] = True
monkeypatch.setattr("aqt.installer.Path.mkdir", mock_mkdir)
assert Cli.choose_archive_dest(archive_dest, keep, temp_dir) == Path(expect)
assert enclosed["made_dir"] == should_make_dir
@pytest.mark.parametrize(
"host, is_auto, mocked_mingw, existing_arch_dirs, expect",
(
( # not installed
"windows",
False,
"win64_mingw99",
["not_mingw"],
{"install": None, "instruct": "win64_mingw99", "use_dir": "mingw99_64"},
),
( # Alt Desktop Qt already installed
"windows",
False,
"win64_mingw99",
["mingw128_32"],
{"install": None, "instruct": None, "use_dir": "mingw128_32"},
),
# not installed
("linux", False, None, ["gcc_32"], {"install": None, "instruct": "gcc_64", "use_dir": "gcc_64"}),
( # Desktop Qt already installed
"linux",
False,
None,
["gcc_64"],
{"install": None, "instruct": None, "use_dir": "gcc_64"},
),
( # not installed
"windows",
True,
"win64_mingw99",
["not_mingw"],
{"install": "win64_mingw99", "instruct": None, "use_dir": "mingw99_64"},
),
( # Alt Desktop Qt already installed
"windows",
True,
"win64_mingw99",
["mingw128_32"],
{"install": None, "instruct": None, "use_dir": "mingw128_32"},
),
# not installed
("linux", True, None, ["gcc_32"], {"install": "gcc_64", "instruct": None, "use_dir": "gcc_64"}),
( # Desktop Qt already installed
"linux",
True,
None,
["gcc_64"],
{"install": None, "instruct": None, "use_dir": "gcc_64"},
),
),
)
def test_get_autodesktop_dir_and_arch(
monkeypatch, capsys, host: str, is_auto: bool, mocked_mingw: str, existing_arch_dirs: List[str], expect: Dict[str, str]
):
"""
:is_auto: Simulates passing `--autodesktop` to aqt
:mocked_mingw: When we ask MetadataFactory for a list of available architectures, we return this value
:existing_arch_dirs: Directories that contain an existing file at `arch_dir/bin/qmake`
:expect[install]: The archdir we expect aqt to install
:expect[instruct]: The architecture we expect aqt to ask the user to install
:expect[use_dir]: The directory that includes `bin/qmake`; we will patch files in the mobile installation
with this value
"""
monkeypatch.setattr(MetadataFactory, "fetch_arches", lambda *args: [mocked_mingw])
monkeypatch.setattr(Cli, "run", lambda *args: 0)
target = "android"
version = "6.2.3"
cli = Cli()
cli._setup_settings()
expect_msg_prefix = (
f"You are installing the {target} version of Qt, "
f"which requires that the desktop version of Qt is also installed."
)
with TemporaryDirectory() as temp_dir:
base_dir = Path(temp_dir)
for arch_dir in existing_arch_dirs:
qmake = base_dir / version / arch_dir / f"bin/qmake{'.exe' if host == 'windows' else ''}"
qmake.parent.mkdir(parents=True)
qmake.write_text("exe file")
autodesktop_arch_dir, autodesktop_arch_to_install = cli._get_autodesktop_dir_and_arch(
is_auto, host, target, base_dir, Version(version)
)
# It should choose the correct desktop arch directory for updates
assert autodesktop_arch_dir == expect["use_dir"]
out, err = capsys.readouterr()
if expect["install"]:
assert err.strip() == f"INFO : {expect_msg_prefix} Now installing Qt: desktop {version} {expect['install']}"
elif expect["instruct"]:
assert (
err.strip() == f"WARNING : {expect_msg_prefix} You can install it with the following command:\n"
f" `aqt install-qt {host} desktop {version} {expect['instruct']}`"
)
else:
assert err.strip() == f"INFO : Found installed {host}-desktop Qt at {base_dir / version / expect['use_dir']}"