Coverage for tests / test_launch.py: 100%
94 statements
« prev ^ index » next coverage.py v7.13.1, created at 2026-11-18 11:12 +0000
« prev ^ index » next coverage.py v7.13.1, created at 2026-11-18 11:12 +0000
1import io 1abcdhijefg
2import subprocess 1abcdhijefg
3from unittest.mock import Mock, patch 1abcdhijefg
5import pytest 1abcdhijefg
6import typer 1abcdhijefg
8from tests.utils import needs_linux, needs_macos, needs_windows 1abcdhijefg
10url = "http://example.com" 1abcdhijefg
13@pytest.mark.parametrize( 1abcdhijefg
14 "system, command",
15 [
16 ("Darwin", "open"),
17 ("Linux", "xdg-open"),
18 ("FreeBSD", "xdg-open"),
19 ],
20)
21def test_launch_url_unix(system: str, command: str): 1abcdhijefg
22 with ( 1a
23 patch("platform.system", return_value=system),
24 patch("shutil.which", return_value=True),
25 patch("subprocess.Popen") as mock_popen,
26 ):
27 typer.launch(url) 1abcdhijefg
29 mock_popen.assert_called_once_with( 1abcdhijefg
30 [command, url], stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT
31 )
34def test_launch_url_windows(): 1abcdhijefg
35 with ( 1a
36 patch("platform.system", return_value="Windows"),
37 patch("webbrowser.open") as mock_webbrowser_open,
38 ):
39 typer.launch(url) 1abcdhijefg
41 mock_webbrowser_open.assert_called_once_with(url) 1abcdhijefg
44def test_launch_url_no_xdg_open(): 1abcdhijefg
45 with ( 1a
46 patch("platform.system", return_value="Linux"),
47 patch("shutil.which", return_value=None),
48 patch("webbrowser.open") as mock_webbrowser_open,
49 ):
50 typer.launch(url) 1abcdhijefg
52 mock_webbrowser_open.assert_called_once_with(url) 1abcdhijefg
55def test_launch_url_linux_xdg_open_does_not_wait_by_default(): 1abcdhijefg
56 proc = Mock() 1abcdhijefg
58 with ( 1a
59 patch("platform.system", return_value="Linux"),
60 patch("shutil.which", return_value=True),
61 patch("subprocess.Popen", return_value=proc) as mock_popen,
62 ):
63 result = typer.launch(url) 1abcdhijefg
65 assert result == 0 1abcdhijefg
66 mock_popen.assert_called_once_with( 1abcdhijefg
67 ["xdg-open", url], stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT
68 )
69 proc.wait.assert_not_called() 1abcdhijefg
72def test_launch_url_linux_xdg_open_waits_when_requested(): 1abcdhijefg
73 proc = Mock() 1abcdhijefg
74 proc.wait.return_value = 42 1abcdhijefg
76 with ( 1a
77 patch("platform.system", return_value="Linux"),
78 patch("shutil.which", return_value=True),
79 patch("subprocess.Popen", return_value=proc) as mock_popen,
80 ):
81 result = typer.launch(url, wait=True) 1abcdhijefg
83 assert result == 42 1abcdhijefg
84 mock_popen.assert_called_once_with( 1abcdhijefg
85 ["xdg-open", url], stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT
86 )
87 proc.wait.assert_called_once_with() 1abcdhijefg
90@pytest.fixture 1abcdhijefg
91def allow_dev_null(monkeypatch): 1abcdhijefg
92 real_open = open 1efg
94 def fake_open(path, *args, **kwargs): 1efg
95 if path == "/dev/null": 1efg
96 return io.StringIO() 1efg
97 return real_open(path, *args, **kwargs) # pragma: no cover
99 monkeypatch.setattr("builtins.open", fake_open) 1efg
102@needs_macos 1abcdhijefg
103def test_open_url_macos(monkeypatch, allow_dev_null): 1abcdhijefg
104 recorded: list[list[str]] = [] 1efg
106 class Proc: 1efg
107 def wait(self) -> int: 1efg
108 return 42 1efg
110 def fake_popen(args, **kwargs): 1efg
111 recorded.append(list(args)) 1efg
112 return Proc() 1efg
114 monkeypatch.setattr(subprocess, "Popen", fake_popen) 1efg
116 assert typer.launch("/path/to/file", wait=True, locate=True) == 42 1efg
117 assert recorded[0][:3] == ["open", "-W", "-R"] 1efg
118 assert recorded[0][-1] == "/path/to/file" 1efg
121@needs_windows 1abcdhijefg
122def test_launch_files_windows(monkeypatch): 1abcdhijefg
123 calls: list[list[str]] = [] 1hij
125 def fake_call(args): 1hij
126 calls.append(list(args)) 1hij
127 return 0 1hij
129 monkeypatch.setattr(subprocess, "call", fake_call) 1hij
131 assert typer.launch("C:/Tools/readme.txt", wait=True, locate=False) == 0 1hij
132 assert typer.launch("file:///C:/tmp/a.txt", wait=False, locate=True) == 0 1hij
133 assert calls.pop(0) == ["start", "/WAIT", "", "C:/Tools/readme.txt"] 1hij
134 assert calls.pop(0) == ["explorer", "/select,/C:/tmp/a.txt"] 1hij
136 monkeypatch.setattr(subprocess, "call", lambda a: (_ for _ in ()).throw(OSError())) 1hij
137 assert typer.launch("D:/no/such/file.txt", wait=False, locate=False) == 127 1hij
140@needs_linux 1abcdhijefg
141def test_open_url_linux_wait(monkeypatch): 1abcdhijefg
142 class Proc: 1abcd
143 def __init__(self, code: int = 0) -> None: 1abcd
144 self._code = code 1abcd
146 def wait(self) -> int: 1abcd
147 return self._code 1abcd
149 monkeypatch.setattr(subprocess, "Popen", lambda *a, **k: Proc(7)) 1abcd
151 assert typer.launch("/file", wait=True, locate=False) == 7 1abcd
154@needs_linux 1abcdhijefg
155def test_open_url_linux_locate(monkeypatch): 1abcdhijefg
156 recorded: list[list[str]] = [] 1abcd
158 class Proc: 1abcd
159 def wait(self) -> int: 1abcd
160 return 0 # pragma: no cover
162 def fake_popen(args, **kwargs): 1abcd
163 recorded.append(list(args)) 1abcd
164 return Proc() 1abcd
166 monkeypatch.setattr(subprocess, "Popen", fake_popen) 1abcd
168 assert typer.launch("/tmp/sub/file.txt", wait=False, locate=True) == 0 1abcd
169 assert recorded[-1] == ["xdg-open", "/tmp/sub"] 1abcd
172@needs_windows 1abcdhijefg
173def test_launch_file(): 1abcdhijefg
174 with (
175 patch("typer._click._termui_impl.sys.platform", "win32"),
176 patch("typer._click._termui_impl.WIN", True),
177 patch("typer._click._termui_impl.CYGWIN", False),
178 patch("subprocess.call", return_value=0) as call_mock,
179 ):
180 result = typer.launch("C:/tmp/file.txt", locate=True) 1hij
182 assert result == 0 1hij
183 call_mock.assert_called_once_with(["explorer", "/select,C:/tmp/file.txt"]) 1hij