def test_docker_bad_version(test_command, capsys):
"If docker exists but the version string doesn't make sense, the Docker wrapper is returned with a warning."
# Mock a bad return value of `docker --version`
test_command.subprocess.check_output.return_value = "Docker version 17.2\n"
# Invoke verify_docker
with pytest.raises(BriefcaseCommandError,
match=r'Briefcase requires Docker 19 or higher'):
verify_docker(command=test_command)
def test_docker_doesnt_exist(test_command):
"""If docker doesn't exist, an error is raised."""
# Mock the return value of Docker Version
test_command.subprocess.check_output.side_effect = FileNotFoundError
# Invoke verify_docker
with pytest.raises(BriefcaseCommandError):
verify_docker(command=test_command)
# But docker was invoked
test_command.subprocess.check_output.assert_called_with(
["docker", "--version"],
stderr=subprocess.STDOUT,
)
def test_docker_failure(test_command, capsys):
"""If docker failed during execution, the Docker wrapper is returned with a
warning."""
# Mock the return value of Docker Version
test_command.subprocess.check_output.side_effect = [
subprocess.CalledProcessError(
returncode=1,
cmd="docker --version",
),
"Success!",
]
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
(
docker_version_called_with,
docker_info_called_with,
) = test_command.subprocess.check_output.call_args_list
assert docker_version_called_with[0] == (["docker", "--version"], )
assert docker_version_called_with[1] == {"stderr": subprocess.STDOUT}
assert docker_info_called_with[0] == (["docker", "info"], )
assert docker_info_called_with[1] == {"stderr": subprocess.STDOUT}
# console output
output = capsys.readouterr()
assert "** WARNING: Unable to determine if Docker is installed" in output.out
assert output.err == ""
def test_docker_exists(test_command, capsys):
"""If docker exists, the Docker wrapper is returned."""
# Mock the return value of Docker Version
test_command.subprocess.check_output.return_value = (
"Docker version 19.03.8, build afacb8b\n")
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
(
docker_version_called_with,
docker_info_called_with,
) = test_command.subprocess.check_output.call_args_list
assert docker_version_called_with[0] == (["docker", "--version"], )
assert docker_version_called_with[1] == {"stderr": subprocess.STDOUT}
assert docker_info_called_with[0] == (["docker", "info"], )
assert docker_info_called_with[1] == {"stderr": subprocess.STDOUT}
# No console output
output = capsys.readouterr()
assert output.out == ""
assert output.err == ""
def test_docker_unknown_version(test_command, capsys):
"""If docker exists but the version string doesn't make sense, the Docker
wrapper is returned with a warning."""
# Mock a bad return value of `docker --version`
test_command.subprocess.check_output.return_value = "ceci nest pas un Docker\n"
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
(
docker_version_called_with,
docker_info_called_with,
) = test_command.subprocess.check_output.call_args_list
assert docker_version_called_with[0] == (["docker", "--version"], )
assert docker_version_called_with[1] == {"stderr": subprocess.STDOUT}
assert docker_info_called_with[0] == (["docker", "info"], )
assert docker_info_called_with[1] == {"stderr": subprocess.STDOUT}
# console output
output = capsys.readouterr()
assert "** WARNING: Unable to determine the version of Docker" in output.out
assert output.err == ""
def test_docker_failure(test_command, capsys):
"If docker failed during execution, the Docker wrapper is returned with a warning"
# Mock the return value of Docker Version
test_command.subprocess.check_output.side_effect = [
subprocess.CalledProcessError(
returncode=1, cmd="docker --version",
),
'Success!',
]
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
(
docker_version_called_with,
docker_info_called_with,
) = test_command.subprocess.check_output.call_args_list
assert docker_version_called_with[0] == (['docker', '--version'],)
assert docker_version_called_with[1] == {'universal_newlines': True, 'stderr': subprocess.STDOUT}
assert docker_info_called_with[0] == (['docker', 'info'],)
assert docker_info_called_with[1] == {'universal_newlines': True, 'stderr': subprocess.STDOUT}
# console output
output = capsys.readouterr()
assert '** WARNING: Unable to determine if Docker is installed' in output.out
assert output.err == ''
def test_docker_exists(test_command, capsys):
"If docker exists, the Docker wrapper is returned."
# Mock the return value of Docker Version
test_command.subprocess.check_output.return_value = "Docker version 19.03.8, build afacb8b\n"
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
(
docker_version_called_with,
docker_info_called_with,
) = test_command.subprocess.check_output.call_args_list
assert docker_version_called_with[0] == (['docker', '--version'],)
assert docker_version_called_with[1] == {'universal_newlines': True, 'stderr': subprocess.STDOUT}
assert docker_info_called_with[0] == (['docker', 'info'],)
assert docker_info_called_with[1] == {'universal_newlines': True, 'stderr': subprocess.STDOUT}
# No console output
output = capsys.readouterr()
assert output.out == ''
assert output.err == ''
def verify_tools(self):
"""Verify that Docker is available; and if it isn't that we're on
Linux."""
super().verify_tools()
if self.use_docker:
if self.host_os == "Windows":
raise BriefcaseCommandError(
"Linux AppImages cannot be generated on Windows.")
else:
self.Docker = verify_docker(self)
elif self.host_os == "Linux":
# Use subprocess natively. No Docker wrapper is needed
self.Docker = None
else:
raise BriefcaseCommandError(
"Linux AppImages can only be generated on Linux.")
def test_docker_unknown_version(test_command, capsys):
"If docker exists but the version string doesn't make sense, the Docker wrapper is returned with a warning."
# Mock a bad return value of `docker --version`
test_command.subprocess.check_output.return_value = "ceci nest pas un Docker\n"
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
test_command.subprocess.check_output.assert_called_with(
['docker', '--version'],
universal_newlines=True,
stderr=subprocess.STDOUT,
)
# console output
output = capsys.readouterr()
assert '** WARNING: Unable to determine the version of Docker' in output.out
assert output.err == ''
def test_docker_exists(test_command, capsys):
"If docker exists, the Docker wrapper is returned."
# Mock the return value of Docker Version
test_command.subprocess.check_output.return_value = "Docker version 19.03.8, build afacb8b\n"
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
test_command.subprocess.check_output.assert_called_with(
['docker', '--version'],
universal_newlines=True,
stderr=subprocess.STDOUT,
)
# No console output
output = capsys.readouterr()
assert output.out == ''
assert output.err == ''
def test_docker_failure(test_command, capsys):
"If docker failed during execution, the Docker wrapper is returned with a warning"
# Mock the return value of Docker Version
test_command.subprocess.check_output.side_effect = subprocess.CalledProcessError(
returncode=1, cmd="docker --version")
# Invoke verify_docker
result = verify_docker(command=test_command)
# The verify call should return the Docker wrapper
assert result == Docker
test_command.subprocess.check_output.assert_called_with(
['docker', '--version'],
universal_newlines=True,
stderr=subprocess.STDOUT,
)
# console output
output = capsys.readouterr()
assert '** WARNING: Unable to determine if Docker is installed' in output.out
assert output.err == ''