2021-01-21 00:07:21 +08:00
|
|
|
import contextlib
|
2013-11-13 20:24:58 +08:00
|
|
|
import os
|
|
|
|
import os.path
|
2013-11-30 15:15:09 +08:00
|
|
|
import sys
|
2021-01-21 00:07:21 +08:00
|
|
|
import tempfile
|
|
|
|
import test.support
|
|
|
|
import unittest
|
|
|
|
import unittest.mock
|
2024-01-30 09:25:31 +08:00
|
|
|
from importlib.resources.abc import Traversable
|
|
|
|
from pathlib import Path
|
2013-11-11 20:11:55 +08:00
|
|
|
|
2013-12-23 16:20:34 +08:00
|
|
|
import ensurepip
|
|
|
|
import ensurepip._uninstall
|
2013-11-11 20:11:55 +08:00
|
|
|
|
2013-12-23 21:07:07 +08:00
|
|
|
|
2021-01-21 00:07:21 +08:00
|
|
|
class TestPackages(unittest.TestCase):
|
|
|
|
def touch(self, directory, filename):
|
|
|
|
fullname = os.path.join(directory, filename)
|
|
|
|
open(fullname, "wb").close()
|
|
|
|
|
|
|
|
def test_version(self):
|
|
|
|
# Test version()
|
|
|
|
with tempfile.TemporaryDirectory() as tmpdir:
|
|
|
|
self.touch(tmpdir, "pip-1.2.3b1-py2.py3-none-any.whl")
|
2024-01-30 09:25:31 +08:00
|
|
|
with unittest.mock.patch.object(ensurepip, '_WHEEL_PKG_DIR', Path(tmpdir)):
|
2021-01-21 00:07:21 +08:00
|
|
|
self.assertEqual(ensurepip.version(), '1.2.3b1')
|
|
|
|
|
2024-01-30 09:25:31 +08:00
|
|
|
def test_version_no_dir(self):
|
|
|
|
# Test version() without a wheel package directory
|
|
|
|
with unittest.mock.patch.object(ensurepip, '_WHEEL_PKG_DIR', None):
|
|
|
|
# when the bundled pip wheel is used, we get _PIP_VERSION
|
2021-01-21 00:07:21 +08:00
|
|
|
self.assertEqual(ensurepip._PIP_VERSION, ensurepip.version())
|
|
|
|
|
2024-01-30 09:25:31 +08:00
|
|
|
def test_selected_wheel_path_no_dir(self):
|
|
|
|
pip_filename = f'pip-{ensurepip._PIP_VERSION}-py3-none-any.whl'
|
|
|
|
with unittest.mock.patch.object(ensurepip, '_WHEEL_PKG_DIR', None):
|
|
|
|
with ensurepip._get_pip_whl_path_ctx() as bundled_wheel_path:
|
|
|
|
self.assertEqual(pip_filename, bundled_wheel_path.name)
|
2021-01-21 00:07:21 +08:00
|
|
|
|
2024-01-30 09:25:31 +08:00
|
|
|
def test_selected_wheel_path_with_dir(self):
|
|
|
|
# Test _get_pip_whl_path_ctx() with a wheel package directory
|
2021-01-21 00:07:21 +08:00
|
|
|
pip_filename = "pip-20.2.2-py2.py3-none-any.whl"
|
|
|
|
|
|
|
|
with tempfile.TemporaryDirectory() as tmpdir:
|
|
|
|
self.touch(tmpdir, pip_filename)
|
2024-01-30 09:25:31 +08:00
|
|
|
# not used, make sure that they're ignored
|
|
|
|
self.touch(tmpdir, "pip-1.2.3-py2.py3-none-any.whl")
|
2021-01-21 00:07:21 +08:00
|
|
|
self.touch(tmpdir, "wheel-0.34.2-py2.py3-none-any.whl")
|
2024-01-30 09:25:31 +08:00
|
|
|
self.touch(tmpdir, "pip-script.py")
|
2021-01-21 00:07:21 +08:00
|
|
|
|
2024-01-30 09:25:31 +08:00
|
|
|
with unittest.mock.patch.object(ensurepip, '_WHEEL_PKG_DIR', Path(tmpdir)):
|
|
|
|
with ensurepip._get_pip_whl_path_ctx() as bundled_wheel_path:
|
|
|
|
self.assertEqual(pip_filename, bundled_wheel_path.name)
|
2013-11-11 20:11:55 +08:00
|
|
|
|
|
|
|
|
2013-12-23 16:20:34 +08:00
|
|
|
class EnsurepipMixin:
|
2013-11-11 20:11:55 +08:00
|
|
|
|
|
|
|
def setUp(self):
|
|
|
|
run_pip_patch = unittest.mock.patch("ensurepip._run_pip")
|
|
|
|
self.run_pip = run_pip_patch.start()
|
2017-09-21 18:07:45 +08:00
|
|
|
self.run_pip.return_value = 0
|
2013-11-11 20:11:55 +08:00
|
|
|
self.addCleanup(run_pip_patch.stop)
|
|
|
|
|
2013-11-13 20:24:58 +08:00
|
|
|
# Avoid side effects on the actual os module
|
2014-02-04 21:02:36 +08:00
|
|
|
real_devnull = os.devnull
|
2013-11-13 20:24:58 +08:00
|
|
|
os_patch = unittest.mock.patch("ensurepip.os")
|
|
|
|
patched_os = os_patch.start()
|
2024-01-30 09:25:31 +08:00
|
|
|
# But expose os.listdir() used by _find_wheel_pkg_dir_pip()
|
2021-01-21 00:07:21 +08:00
|
|
|
patched_os.listdir = os.listdir
|
2013-11-13 20:24:58 +08:00
|
|
|
self.addCleanup(os_patch.stop)
|
2014-02-04 21:02:36 +08:00
|
|
|
patched_os.devnull = real_devnull
|
2013-11-13 20:24:58 +08:00
|
|
|
patched_os.path = os.path
|
|
|
|
self.os_environ = patched_os.environ = os.environ.copy()
|
2013-11-11 20:11:55 +08:00
|
|
|
|
2013-12-23 21:07:07 +08:00
|
|
|
|
2013-12-23 16:20:34 +08:00
|
|
|
class TestBootstrap(EnsurepipMixin, unittest.TestCase):
|
|
|
|
|
2013-11-11 20:11:55 +08:00
|
|
|
def test_basic_bootstrapping(self):
|
|
|
|
ensurepip.bootstrap()
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
additional_paths = self.run_pip.call_args[0][1]
|
2023-04-18 12:43:34 +08:00
|
|
|
self.assertEqual(len(additional_paths), 1)
|
2013-11-11 20:11:55 +08:00
|
|
|
|
|
|
|
def test_bootstrapping_with_root(self):
|
|
|
|
ensurepip.bootstrap(root="/foo/bar/")
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2014-01-02 22:33:35 +08:00
|
|
|
unittest.mock.ANY, "--root", "/foo/bar/",
|
2023-04-18 12:43:34 +08:00
|
|
|
"pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
def test_bootstrapping_with_user(self):
|
|
|
|
ensurepip.bootstrap(user=True)
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "--user", "pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
def test_bootstrapping_with_upgrade(self):
|
|
|
|
ensurepip.bootstrap(upgrade=True)
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "--upgrade", "pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
def test_bootstrapping_with_verbosity_1(self):
|
|
|
|
ensurepip.bootstrap(verbosity=1)
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "-v", "pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
def test_bootstrapping_with_verbosity_2(self):
|
|
|
|
ensurepip.bootstrap(verbosity=2)
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "-vv", "pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
def test_bootstrapping_with_verbosity_3(self):
|
|
|
|
ensurepip.bootstrap(verbosity=3)
|
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "-vvv", "pip",
|
2013-11-11 20:11:55 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
def test_bootstrapping_with_regular_install(self):
|
|
|
|
ensurepip.bootstrap()
|
|
|
|
self.assertEqual(self.os_environ["ENSUREPIP_OPTIONS"], "install")
|
|
|
|
|
|
|
|
def test_bootstrapping_with_alt_install(self):
|
|
|
|
ensurepip.bootstrap(altinstall=True)
|
|
|
|
self.assertEqual(self.os_environ["ENSUREPIP_OPTIONS"], "altinstall")
|
|
|
|
|
|
|
|
def test_bootstrapping_with_default_pip(self):
|
|
|
|
ensurepip.bootstrap(default_pip=True)
|
|
|
|
self.assertNotIn("ENSUREPIP_OPTIONS", self.os_environ)
|
|
|
|
|
|
|
|
def test_altinstall_default_pip_conflict(self):
|
|
|
|
with self.assertRaises(ValueError):
|
|
|
|
ensurepip.bootstrap(altinstall=True, default_pip=True)
|
2014-04-17 04:06:39 +08:00
|
|
|
self.assertFalse(self.run_pip.called)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
2013-12-23 14:16:07 +08:00
|
|
|
def test_pip_environment_variables_removed(self):
|
|
|
|
# ensurepip deliberately ignores all pip environment variables
|
|
|
|
# See http://bugs.python.org/issue19734 for details
|
|
|
|
self.os_environ["PIP_THIS_SHOULD_GO_AWAY"] = "test fodder"
|
|
|
|
ensurepip.bootstrap()
|
|
|
|
self.assertNotIn("PIP_THIS_SHOULD_GO_AWAY", self.os_environ)
|
|
|
|
|
2014-02-04 21:02:36 +08:00
|
|
|
def test_pip_config_file_disabled(self):
|
|
|
|
# ensurepip deliberately ignores the pip config file
|
|
|
|
# See http://bugs.python.org/issue20053 for details
|
|
|
|
ensurepip.bootstrap()
|
|
|
|
self.assertEqual(self.os_environ["PIP_CONFIG_FILE"], os.devnull)
|
2013-12-23 14:16:07 +08:00
|
|
|
|
2013-11-30 15:15:09 +08:00
|
|
|
@contextlib.contextmanager
|
2021-01-21 00:07:21 +08:00
|
|
|
def fake_pip(version=ensurepip.version()):
|
2013-11-30 15:15:09 +08:00
|
|
|
if version is None:
|
|
|
|
pip = None
|
|
|
|
else:
|
|
|
|
class FakePip():
|
|
|
|
__version__ = version
|
|
|
|
pip = FakePip()
|
|
|
|
sentinel = object()
|
|
|
|
orig_pip = sys.modules.get("pip", sentinel)
|
|
|
|
sys.modules["pip"] = pip
|
|
|
|
try:
|
|
|
|
yield pip
|
|
|
|
finally:
|
|
|
|
if orig_pip is sentinel:
|
|
|
|
del sys.modules["pip"]
|
|
|
|
else:
|
|
|
|
sys.modules["pip"] = orig_pip
|
|
|
|
|
2013-12-23 16:20:34 +08:00
|
|
|
class TestUninstall(EnsurepipMixin, unittest.TestCase):
|
2013-12-23 15:39:12 +08:00
|
|
|
|
2013-11-30 15:15:09 +08:00
|
|
|
def test_uninstall_skipped_when_not_installed(self):
|
|
|
|
with fake_pip(None):
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper()
|
2014-04-17 04:06:39 +08:00
|
|
|
self.assertFalse(self.run_pip.called)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
2014-02-28 21:35:05 +08:00
|
|
|
def test_uninstall_skipped_with_warning_for_wrong_version(self):
|
2013-11-30 15:15:09 +08:00
|
|
|
with fake_pip("not a valid version"):
|
2014-02-28 21:35:05 +08:00
|
|
|
with test.support.captured_stderr() as stderr:
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper()
|
2014-02-28 21:35:05 +08:00
|
|
|
warning = stderr.getvalue().strip()
|
|
|
|
self.assertIn("only uninstall a matching version", warning)
|
2014-04-17 04:06:39 +08:00
|
|
|
self.assertFalse(self.run_pip.called)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
|
|
|
|
|
|
|
def test_uninstall(self):
|
|
|
|
with fake_pip():
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper()
|
2013-11-30 15:15:09 +08:00
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
2015-06-02 22:37:08 +08:00
|
|
|
[
|
|
|
|
"uninstall", "-y", "--disable-pip-version-check", "pip",
|
|
|
|
]
|
2013-11-30 15:15:09 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
def test_uninstall_with_verbosity_1(self):
|
|
|
|
with fake_pip():
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper(verbosity=1)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
2015-06-02 22:37:08 +08:00
|
|
|
[
|
|
|
|
"uninstall", "-y", "--disable-pip-version-check", "-v", "pip",
|
|
|
|
]
|
2013-11-30 15:15:09 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
def test_uninstall_with_verbosity_2(self):
|
|
|
|
with fake_pip():
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper(verbosity=2)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
2015-06-02 22:37:08 +08:00
|
|
|
[
|
|
|
|
"uninstall", "-y", "--disable-pip-version-check", "-vv", "pip",
|
|
|
|
]
|
2013-11-30 15:15:09 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
def test_uninstall_with_verbosity_3(self):
|
|
|
|
with fake_pip():
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper(verbosity=3)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
2015-06-02 22:37:08 +08:00
|
|
|
[
|
|
|
|
"uninstall", "-y", "--disable-pip-version-check", "-vvv",
|
2023-04-18 12:43:34 +08:00
|
|
|
"pip"
|
2015-06-02 22:37:08 +08:00
|
|
|
]
|
2013-11-30 15:15:09 +08:00
|
|
|
)
|
|
|
|
|
2013-12-23 15:39:12 +08:00
|
|
|
def test_pip_environment_variables_removed(self):
|
|
|
|
# ensurepip deliberately ignores all pip environment variables
|
|
|
|
# See http://bugs.python.org/issue19734 for details
|
|
|
|
self.os_environ["PIP_THIS_SHOULD_GO_AWAY"] = "test fodder"
|
|
|
|
with fake_pip():
|
2013-12-23 16:20:34 +08:00
|
|
|
ensurepip._uninstall_helper()
|
2013-12-23 15:39:12 +08:00
|
|
|
self.assertNotIn("PIP_THIS_SHOULD_GO_AWAY", self.os_environ)
|
2013-11-30 15:15:09 +08:00
|
|
|
|
2014-02-04 21:02:36 +08:00
|
|
|
def test_pip_config_file_disabled(self):
|
|
|
|
# ensurepip deliberately ignores the pip config file
|
|
|
|
# See http://bugs.python.org/issue20053 for details
|
|
|
|
with fake_pip():
|
|
|
|
ensurepip._uninstall_helper()
|
|
|
|
self.assertEqual(self.os_environ["PIP_CONFIG_FILE"], os.devnull)
|
|
|
|
|
2013-11-11 20:11:55 +08:00
|
|
|
|
2013-12-23 16:20:34 +08:00
|
|
|
# Basic testing of the main functions and their argument parsing
|
|
|
|
|
2021-01-21 00:07:21 +08:00
|
|
|
EXPECTED_VERSION_OUTPUT = "pip " + ensurepip.version()
|
2013-12-23 16:20:34 +08:00
|
|
|
|
|
|
|
class TestBootstrappingMainFunction(EnsurepipMixin, unittest.TestCase):
|
|
|
|
|
|
|
|
def test_bootstrap_version(self):
|
|
|
|
with test.support.captured_stdout() as stdout:
|
|
|
|
with self.assertRaises(SystemExit):
|
|
|
|
ensurepip._main(["--version"])
|
|
|
|
result = stdout.getvalue().strip()
|
|
|
|
self.assertEqual(result, EXPECTED_VERSION_OUTPUT)
|
2014-04-17 04:06:39 +08:00
|
|
|
self.assertFalse(self.run_pip.called)
|
2013-12-23 16:20:34 +08:00
|
|
|
|
|
|
|
def test_basic_bootstrapping(self):
|
2017-09-21 18:07:45 +08:00
|
|
|
exit_code = ensurepip._main([])
|
2013-12-23 16:20:34 +08:00
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
|
|
|
[
|
2020-06-16 01:28:46 +08:00
|
|
|
"install", "--no-cache-dir", "--no-index", "--find-links",
|
2023-04-18 12:43:34 +08:00
|
|
|
unittest.mock.ANY, "pip",
|
2013-12-23 16:20:34 +08:00
|
|
|
],
|
|
|
|
unittest.mock.ANY,
|
|
|
|
)
|
|
|
|
|
|
|
|
additional_paths = self.run_pip.call_args[0][1]
|
2023-04-18 12:43:34 +08:00
|
|
|
self.assertEqual(len(additional_paths), 1)
|
2017-09-21 18:07:45 +08:00
|
|
|
self.assertEqual(exit_code, 0)
|
|
|
|
|
|
|
|
def test_bootstrapping_error_code(self):
|
|
|
|
self.run_pip.return_value = 2
|
|
|
|
exit_code = ensurepip._main([])
|
|
|
|
self.assertEqual(exit_code, 2)
|
|
|
|
|
2013-12-23 16:20:34 +08:00
|
|
|
|
|
|
|
class TestUninstallationMainFunction(EnsurepipMixin, unittest.TestCase):
|
|
|
|
|
|
|
|
def test_uninstall_version(self):
|
|
|
|
with test.support.captured_stdout() as stdout:
|
|
|
|
with self.assertRaises(SystemExit):
|
|
|
|
ensurepip._uninstall._main(["--version"])
|
|
|
|
result = stdout.getvalue().strip()
|
|
|
|
self.assertEqual(result, EXPECTED_VERSION_OUTPUT)
|
2014-04-17 04:06:39 +08:00
|
|
|
self.assertFalse(self.run_pip.called)
|
2013-12-23 16:20:34 +08:00
|
|
|
|
|
|
|
def test_basic_uninstall(self):
|
|
|
|
with fake_pip():
|
2017-09-21 18:07:45 +08:00
|
|
|
exit_code = ensurepip._uninstall._main([])
|
2013-12-23 16:20:34 +08:00
|
|
|
|
|
|
|
self.run_pip.assert_called_once_with(
|
2015-06-02 22:37:08 +08:00
|
|
|
[
|
|
|
|
"uninstall", "-y", "--disable-pip-version-check", "pip",
|
|
|
|
]
|
2013-12-23 16:20:34 +08:00
|
|
|
)
|
|
|
|
|
2017-09-21 18:07:45 +08:00
|
|
|
self.assertEqual(exit_code, 0)
|
|
|
|
|
|
|
|
def test_uninstall_error_code(self):
|
|
|
|
with fake_pip():
|
|
|
|
self.run_pip.return_value = 2
|
|
|
|
exit_code = ensurepip._uninstall._main([])
|
|
|
|
self.assertEqual(exit_code, 2)
|
2013-12-23 16:20:34 +08:00
|
|
|
|
2013-11-11 20:11:55 +08:00
|
|
|
|
|
|
|
if __name__ == "__main__":
|
2015-04-14 04:00:43 +08:00
|
|
|
unittest.main()
|