1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
import os
import shutil
from unittest.mock import MagicMock
import pytest
from briefcase.exceptions import (
BriefcaseCommandError,
MissingToolError,
NetworkFailure,
NonManagedToolError,
)
from briefcase.integrations.base import ToolCache
from briefcase.integrations.java import JDK
from ...utils import create_zip_file
from .conftest import JDK_BUILD, JDK_RELEASE
@pytest.fixture
def mock_tools(mock_tools) -> ToolCache:
mock_tools.host_os = "Linux"
mock_tools.host_arch = "x86_64"
return mock_tools
def test_non_managed_install(mock_tools, tmp_path, capsys):
"""If the Java install points to a non-managed install, no upgrade is attempted."""
# Make the installation point to somewhere else.
jdk = JDK(mock_tools, java_home=tmp_path / "other-jdk")
# Attempt an upgrade. This will fail because the install is non-managed
with pytest.raises(NonManagedToolError):
jdk.upgrade()
# No download was attempted
assert mock_tools.file.download.call_count == 0
def test_non_existing_install(mock_tools, tmp_path):
"""If there's no existing managed JDK install, upgrading is an error."""
# Create an SDK wrapper around a non-existing managed install
jdk = JDK(mock_tools, java_home=tmp_path / "tools/java")
with pytest.raises(MissingToolError):
jdk.upgrade()
# No download was attempted
assert mock_tools.file.download.call_count == 0
def test_existing_install(mock_tools, tmp_path):
"""If there's an existing managed JDK install, it is deleted and re-downloaded."""
# Create a mock of a previously installed Java version.
java_home = tmp_path / "tools/java"
(java_home / "bin").mkdir(parents=True)
# We actually need to delete the original java install
def rmtree(path):
shutil.rmtree(path)
mock_tools.shutil.rmtree.side_effect = rmtree
# Mock the cached download path.
jdk_zip_path = create_zip_file(tmp_path / "download.zip", content=[("jdk", "jdk")])
mock_tools.file.download = MagicMock(return_value=jdk_zip_path)
# Create a directory to make it look like Java was downloaded and unpacked.
(tmp_path / "tools" / f"jdk-{JDK_RELEASE}+{JDK_BUILD}").mkdir(parents=True)
# Create an SDK wrapper
jdk = JDK(mock_tools, java_home=java_home)
# Attempt an upgrade.
jdk.upgrade()
# The old version has been deleted
mock_tools.shutil.rmtree.assert_called_with(java_home)
# A download was initiated
mock_tools.file.download.assert_called_with(
url="https://github.com/adoptium/temurin17-binaries/releases/download/"
f"jdk-{JDK_RELEASE}+{JDK_BUILD}/OpenJDK17U-jdk_x64_linux_hotspot_{JDK_RELEASE}_{JDK_BUILD}.tar.gz",
download_path=tmp_path / "tools",
role="Java 17 JDK",
)
# The archive was unpacked.
mock_tools.shutil.unpack_archive.assert_called_with(
filename=os.fsdecode(jdk_zip_path), extract_dir=os.fsdecode(tmp_path / "tools")
)
# The original archive was deleted
assert not jdk_zip_path.exists()
def test_macOS_existing_install(mock_tools, tmp_path):
"""If there's an existing managed macOS JDK install, it is deleted and re-
downloaded."""
# Force mocking on macOS
mock_tools.host_os = "Darwin"
# Create a mock of a previously installed Java version.
java_home = tmp_path / "tools/java/Contents/Home"
(java_home / "bin").mkdir(parents=True)
# We actually need to delete the original java install
def rmtree(path):
shutil.rmtree(path)
mock_tools.shutil.rmtree.side_effect = rmtree
# Mock the cached download path.
jdk_zip_path = create_zip_file(tmp_path / "download.zip", content=[("jdk", "jdk")])
mock_tools.file.download = MagicMock(return_value=jdk_zip_path)
# Create a directory to make it look like Java was downloaded and unpacked.
(tmp_path / "tools" / f"jdk-{JDK_RELEASE}+{JDK_BUILD}").mkdir(parents=True)
# Create an SDK wrapper
jdk = JDK(mock_tools, java_home=java_home)
# Attempt an upgrade.
jdk.upgrade()
# The old version has been deleted
mock_tools.shutil.rmtree.assert_called_with(tmp_path / "tools/java")
# A download was initiated
mock_tools.file.download.assert_called_with(
url="https://github.com/adoptium/temurin17-binaries/releases/download/"
f"jdk-{JDK_RELEASE}+{JDK_BUILD}/OpenJDK17U-jdk_x64_mac_hotspot_{JDK_RELEASE}_{JDK_BUILD}.tar.gz",
download_path=tmp_path / "tools",
role="Java 17 JDK",
)
# The archive was unpacked.
mock_tools.shutil.unpack_archive.assert_called_with(
filename=os.fsdecode(jdk_zip_path),
extract_dir=os.fsdecode(tmp_path / "tools"),
)
# The original archive was deleted
assert not jdk_zip_path.exists()
def test_download_fail(mock_tools, tmp_path):
"""If there's an existing managed JDK install, it is deleted and re-downloaded."""
# Create a mock of a previously installed Java version.
java_home = tmp_path / "tools/java"
(java_home / "bin").mkdir(parents=True)
# We actually need to delete the original java install
def rmtree(path):
shutil.rmtree(path)
mock_tools.shutil.rmtree.side_effect = rmtree
# Mock a failure on download
mock_tools.file.download = MagicMock(side_effect=NetworkFailure("mock"))
# Create an SDK wrapper
jdk = JDK(mock_tools, java_home=java_home)
# Attempt an upgrade. This will fail along with the download
with pytest.raises(NetworkFailure, match="Unable to mock"):
jdk.upgrade()
# The old version has been deleted
mock_tools.shutil.rmtree.assert_called_with(java_home)
# A download was initiated
mock_tools.file.download.assert_called_with(
url="https://github.com/adoptium/temurin17-binaries/releases/download/"
f"jdk-{JDK_RELEASE}+{JDK_BUILD}/OpenJDK17U-jdk_x64_linux_hotspot_{JDK_RELEASE}_{JDK_BUILD}.tar.gz",
download_path=tmp_path / "tools",
role="Java 17 JDK",
)
# No attempt was made to unpack the archive
assert mock_tools.shutil.unpack_archive.call_count == 0
def test_unpack_fail(mock_tools, tmp_path):
"""If there's an existing managed JDK install, it is deleted and re-downloaded."""
# Create a mock of a previously installed Java version.
java_home = tmp_path / "tools/java"
(java_home / "bin").mkdir(parents=True)
# We actually need to delete the original java install
def rmtree(path):
shutil.rmtree(path)
mock_tools.shutil.rmtree.side_effect = rmtree
# Mock the cached download path
jdk_zip_path = create_zip_file(tmp_path / "download.zip", content=[("jdk", "jdk")])
mock_tools.file.download = MagicMock(return_value=jdk_zip_path)
# Mock an unpack failure due to an invalid archive
mock_tools.shutil.unpack_archive.side_effect = shutil.ReadError
# Create an SDK wrapper
jdk = JDK(mock_tools, java_home=java_home)
# Attempt an upgrade. This will fail.
with pytest.raises(BriefcaseCommandError):
jdk.upgrade()
# The old version has been deleted
mock_tools.shutil.rmtree.assert_called_with(java_home)
# A download was initiated
mock_tools.file.download.assert_called_with(
url="https://github.com/adoptium/temurin17-binaries/releases/download/"
f"jdk-{JDK_RELEASE}+{JDK_BUILD}/OpenJDK17U-jdk_x64_linux_hotspot_{JDK_RELEASE}_{JDK_BUILD}.tar.gz",
download_path=tmp_path / "tools",
role="Java 17 JDK",
)
# The archive was unpacked.
mock_tools.shutil.unpack_archive.assert_called_with(
filename=os.fsdecode(jdk_zip_path),
extract_dir=os.fsdecode(tmp_path / "tools"),
)
# The original archive was not deleted
assert jdk_zip_path.exists()
|
