开源软件构建与测试

Changes of Revision 3

_service:tar_scm:python-pip.spec Changed

@@ -5,7 +5,7 @@
 pip is the package installer for Python. You can use pip to install packages from the Python Package Index and other indexes.
 %global bashcompdir %(b=$(pkg-config --variable=completionsdir bash-completion 2>/dev/null); echo ${b:-%{_sysconfdir}/bash_completion.d})
 Name:           python-%{srcname}
-Version:        22.3.1
+Version:        23.1.2
 Release:        1
 Summary:        A tool for installing and managing Python packages
 License:        MIT and Python and ASL 2.0 and BSD and ISC and LGPLv2 and MPLv2.0 and (ASL 2.0 or BSD)
@@ -43,7 +43,13 @@
 
 # this goes together with Patch6000
 rm src/pip/_vendor/certifi/*.pem
-sed -i '/\.pem$/d' src/pip.egg-info/SOURCES.txt
+#sed -i '/\.pem$/d' src/pip.egg-info/SOURCES.txt
+sed -i '/html_theme = "furo"/d' docs/html/conf.py
+
+# Remove windows executable binaries
+rm -v src/pip/_vendor/distlib/*.exe
+sed -i '/\.exe/d' setup.py
+
 
 %build
 %py3_build_wheel
@@ -118,6 +124,9 @@
 %{python_wheeldir}/%{python_wheelname}
 
 %changelog
+* Fri Jun  9 2023 dillon chen <dillon.chen@gmail.com> - 23.1.2-1
+- upgrade version to 23.1.2
+
 * Sat Jan 28 2023 zhuofeng<zhuofeng2@huawei.com> - 22.3.1-1                                          
 - upgrade version to 22.3.1

_service:tar_scm:pip-22.3.1.tar.gz/PKG-INFO Deleted

@@ -1,88 +0,0 @@
-Metadata-Version: 2.1
-Name: pip
-Version: 22.3.1
-Summary: The PyPA recommended tool for installing Python packages.
-Home-page: https://pip.pypa.io/
-Author: The pip developers
-Author-email: distutils-sig@python.org
-License: MIT
-Project-URL: Documentation, https://pip.pypa.io
-Project-URL: Source, https://github.com/pypa/pip
-Project-URL: Changelog, https://pip.pypa.io/en/stable/news/
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.7
-License-File: LICENSE.txt
-
-pip - The Python Package Installer
-==================================
-
-.. image:: https://img.shields.io/pypi/v/pip.svg
-   :target: https://pypi.org/project/pip/
-
-.. image:: https://readthedocs.org/projects/pip/badge/?version=latest
-   :target: https://pip.pypa.io/en/latest
-
-pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes.
-
-Please take a look at our documentation for how to install and use pip:
-
-* `Installation`_
-* `Usage`_
-
-We release updates regularly, with a new version every 3 months. Find more details in our documentation:
-
-* `Release notes`_
-* `Release process`_
-
-In pip 20.3, we've `made a big improvement to the heart of pip`_; `learn more`_. We want your input, so `sign up for our user experience research studies`_ to help us do it right.
-
-**Note**: pip 21.0, in January 2021, removed Python 2 support, per pip's `Python 2 support policy`_. Please migrate to Python 3.
-
-If you find bugs, need help, or want to talk to the developers, please use our mailing lists or chat rooms:
-
-* `Issue tracking`_
-* `Discourse channel`_
-* `User IRC`_
-
-If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms:
-
-* `GitHub page`_
-* `Development documentation`_
-* `Development IRC`_
-
-Code of Conduct
----------------
-
-Everyone interacting in the pip project's codebases, issue trackers, chat
-rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.
-
-.. _package installer: https://packaging.python.org/guides/tool-recommendations/
-.. _Python Package Index: https://pypi.org
-.. _Installation: https://pip.pypa.io/en/stable/installation/
-.. _Usage: https://pip.pypa.io/en/stable/
-.. _Release notes: https://pip.pypa.io/en/stable/news.html
-.. _Release process: https://pip.pypa.io/en/latest/development/release-process/
-.. _GitHub page: https://github.com/pypa/pip
-.. _Development documentation: https://pip.pypa.io/en/latest/development
-.. _made a big improvement to the heart of pip: https://pyfound.blogspot.com/2020/11/pip-20-3-new-resolver.html
-.. _learn more: https://pip.pypa.io/en/latest/user_guide/#changes-to-the-pip-dependency-resolver-in-20-3-2020
-.. _sign up for our user experience research studies: https://pyfound.blogspot.com/2020/03/new-pip-resolver-to-roll-out-this-year.html
-.. _Python 2 support policy: https://pip.pypa.io/en/latest/development/release-process/#python-2-support
-.. _Issue tracking: https://github.com/pypa/pip/issues
-.. _Discourse channel: https://discuss.python.org/c/packaging
-.. _User IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa
-.. _Development IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa-dev
-.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info/PKG-INFO Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info/SOURCES.txt Deleted

@@ -1,639 +0,0 @@
-AUTHORS.txt
-LICENSE.txt
-MANIFEST.in
-NEWS.rst
-README.rst
-pyproject.toml
-setup.cfg
-setup.py
-docs/pip_sphinxext.py
-docs/requirements.txt
-docs/html/conf.py
-docs/html/copyright.rst
-docs/html/getting-started.md
-docs/html/index.md
-docs/html/installation.md
-docs/html/installing.rst
-docs/html/news.rst
-docs/html/quickstart.rst
-docs/html/user_guide.rst
-docs/html/ux_research_design.rst
-docs/html/cli/index.md
-docs/html/cli/pip.rst
-docs/html/cli/pip_cache.rst
-docs/html/cli/pip_check.rst
-docs/html/cli/pip_config.rst
-docs/html/cli/pip_debug.rst
-docs/html/cli/pip_download.rst
-docs/html/cli/pip_freeze.rst
-docs/html/cli/pip_hash.rst
-docs/html/cli/pip_inspect.rst
-docs/html/cli/pip_install.rst
-docs/html/cli/pip_list.rst
-docs/html/cli/pip_search.rst
-docs/html/cli/pip_show.rst
-docs/html/cli/pip_uninstall.rst
-docs/html/cli/pip_wheel.rst
-docs/html/development/ci.rst
-docs/html/development/contributing.rst
-docs/html/development/conventions.rst
-docs/html/development/getting-started.rst
-docs/html/development/index.rst
-docs/html/development/issue-triage.md
-docs/html/development/release-process.rst
-docs/html/development/vendoring-policy.rst
-docs/html/development/architecture/anatomy.rst
-docs/html/development/architecture/command-line-interface.rst
-docs/html/development/architecture/configuration-files.rst
-docs/html/development/architecture/index.rst
-docs/html/development/architecture/overview.rst
-docs/html/development/architecture/package-finding.rst
-docs/html/development/architecture/upgrade-options.rst
-docs/html/reference/index.md
-docs/html/reference/inspect-report.md
-docs/html/reference/installation-report.md
-docs/html/reference/pip.rst
-docs/html/reference/pip_cache.rst
-docs/html/reference/pip_check.rst
-docs/html/reference/pip_config.rst
-docs/html/reference/pip_debug.rst
-docs/html/reference/pip_download.rst
-docs/html/reference/pip_freeze.rst
-docs/html/reference/pip_hash.rst
-docs/html/reference/pip_install.rst
-docs/html/reference/pip_list.rst
-docs/html/reference/pip_search.rst
-docs/html/reference/pip_show.rst
-docs/html/reference/pip_uninstall.rst
-docs/html/reference/pip_wheel.rst
-docs/html/reference/requirement-specifiers.md
-docs/html/reference/requirements-file-format.md
-docs/html/reference/build-system/index.md
-docs/html/reference/build-system/pyproject-toml.md
-docs/html/reference/build-system/setup-py.md
-docs/html/topics/authentication.md
-docs/html/topics/caching.md
-docs/html/topics/configuration.md
-docs/html/topics/dependency-resolution.md
-docs/html/topics/deps.dot
-docs/html/topics/deps.png
-docs/html/topics/https-certificates.md
-docs/html/topics/index.md
-docs/html/topics/local-project-installs.md
-docs/html/topics/more-dependency-resolution.md
-docs/html/topics/python-option.md
-docs/html/topics/repeatable-installs.md
-docs/html/topics/secure-installs.md
-docs/html/topics/vcs-support.md
-docs/man/index.rst
-docs/man/commands/cache.rst
-docs/man/commands/check.rst
-docs/man/commands/config.rst
-docs/man/commands/debug.rst
-docs/man/commands/download.rst
-docs/man/commands/freeze.rst
-docs/man/commands/hash.rst
-docs/man/commands/help.rst
-docs/man/commands/install.rst
-docs/man/commands/list.rst
-docs/man/commands/search.rst
-docs/man/commands/show.rst
-docs/man/commands/uninstall.rst
-docs/man/commands/wheel.rst
-src/pip/__init__.py
-src/pip/__main__.py
-src/pip/__pip-runner__.py
-src/pip/py.typed
-src/pip.egg-info/PKG-INFO
-src/pip.egg-info/SOURCES.txt
-src/pip.egg-info/dependency_links.txt
-src/pip.egg-info/entry_points.txt
-src/pip.egg-info/not-zip-safe
-src/pip.egg-info/top_level.txt
-src/pip/_internal/__init__.py
-src/pip/_internal/build_env.py
-src/pip/_internal/cache.py
-src/pip/_internal/configuration.py
-src/pip/_internal/exceptions.py
-src/pip/_internal/main.py
-src/pip/_internal/pyproject.py
-src/pip/_internal/self_outdated_check.py
-src/pip/_internal/wheel_builder.py
-src/pip/_internal/cli/__init__.py
-src/pip/_internal/cli/autocompletion.py
-src/pip/_internal/cli/base_command.py
-src/pip/_internal/cli/cmdoptions.py
-src/pip/_internal/cli/command_context.py
-src/pip/_internal/cli/main.py
-src/pip/_internal/cli/main_parser.py
-src/pip/_internal/cli/parser.py
-src/pip/_internal/cli/progress_bars.py
-src/pip/_internal/cli/req_command.py
-src/pip/_internal/cli/spinners.py
-src/pip/_internal/cli/status_codes.py
-src/pip/_internal/commands/__init__.py
-src/pip/_internal/commands/cache.py
-src/pip/_internal/commands/check.py
-src/pip/_internal/commands/completion.py
-src/pip/_internal/commands/configuration.py
-src/pip/_internal/commands/debug.py
-src/pip/_internal/commands/download.py
-src/pip/_internal/commands/freeze.py
-src/pip/_internal/commands/hash.py
-src/pip/_internal/commands/help.py
-src/pip/_internal/commands/index.py
-src/pip/_internal/commands/inspect.py
-src/pip/_internal/commands/install.py
-src/pip/_internal/commands/list.py
-src/pip/_internal/commands/search.py
-src/pip/_internal/commands/show.py
-src/pip/_internal/commands/uninstall.py
-src/pip/_internal/commands/wheel.py
-src/pip/_internal/distributions/__init__.py
-src/pip/_internal/distributions/base.py
-src/pip/_internal/distributions/installed.py
-src/pip/_internal/distributions/sdist.py
-src/pip/_internal/distributions/wheel.py
-src/pip/_internal/index/__init__.py
-src/pip/_internal/index/collector.py
-src/pip/_internal/index/package_finder.py
-src/pip/_internal/index/sources.py
-src/pip/_internal/locations/__init__.py
-src/pip/_internal/locations/_distutils.py
-src/pip/_internal/locations/_sysconfig.py
-src/pip/_internal/locations/base.py
-src/pip/_internal/metadata/__init__.py
-src/pip/_internal/metadata/_json.py
-src/pip/_internal/metadata/base.py
-src/pip/_internal/metadata/pkg_resources.py
-src/pip/_internal/metadata/importlib/__init__.py
-src/pip/_internal/metadata/importlib/_compat.py
-src/pip/_internal/metadata/importlib/_dists.py
-src/pip/_internal/metadata/importlib/_envs.py
-src/pip/_internal/models/__init__.py
-src/pip/_internal/models/candidate.py
-src/pip/_internal/models/direct_url.py
-src/pip/_internal/models/format_control.py
-src/pip/_internal/models/index.py
-src/pip/_internal/models/installation_report.py
-src/pip/_internal/models/link.py
-src/pip/_internal/models/scheme.py
-src/pip/_internal/models/search_scope.py
-src/pip/_internal/models/selection_prefs.py
-src/pip/_internal/models/target_python.py
-src/pip/_internal/models/wheel.py
-src/pip/_internal/network/__init__.py
-src/pip/_internal/network/auth.py
-src/pip/_internal/network/cache.py
-src/pip/_internal/network/download.py
-src/pip/_internal/network/lazy_wheel.py
-src/pip/_internal/network/session.py
-src/pip/_internal/network/utils.py
-src/pip/_internal/network/xmlrpc.py
-src/pip/_internal/operations/__init__.py
-src/pip/_internal/operations/check.py
-src/pip/_internal/operations/freeze.py
-src/pip/_internal/operations/prepare.py
-src/pip/_internal/operations/build/__init__.py
-src/pip/_internal/operations/build/build_tracker.py
-src/pip/_internal/operations/build/metadata.py
-src/pip/_internal/operations/build/metadata_editable.py
-src/pip/_internal/operations/build/metadata_legacy.py
-src/pip/_internal/operations/build/wheel.py
-src/pip/_internal/operations/build/wheel_editable.py
-src/pip/_internal/operations/build/wheel_legacy.py
-src/pip/_internal/operations/install/__init__.py
-src/pip/_internal/operations/install/editable_legacy.py
-src/pip/_internal/operations/install/legacy.py
-src/pip/_internal/operations/install/wheel.py
-src/pip/_internal/req/__init__.py
-src/pip/_internal/req/constructors.py
-src/pip/_internal/req/req_file.py
-src/pip/_internal/req/req_install.py
-src/pip/_internal/req/req_set.py
-src/pip/_internal/req/req_uninstall.py
-src/pip/_internal/resolution/__init__.py
-src/pip/_internal/resolution/base.py
-src/pip/_internal/resolution/legacy/__init__.py
-src/pip/_internal/resolution/legacy/resolver.py
-src/pip/_internal/resolution/resolvelib/__init__.py
-src/pip/_internal/resolution/resolvelib/base.py
-src/pip/_internal/resolution/resolvelib/candidates.py
-src/pip/_internal/resolution/resolvelib/factory.py
-src/pip/_internal/resolution/resolvelib/found_candidates.py
-src/pip/_internal/resolution/resolvelib/provider.py
-src/pip/_internal/resolution/resolvelib/reporter.py
-src/pip/_internal/resolution/resolvelib/requirements.py
-src/pip/_internal/resolution/resolvelib/resolver.py
-src/pip/_internal/utils/__init__.py
-src/pip/_internal/utils/_log.py
-src/pip/_internal/utils/appdirs.py
-src/pip/_internal/utils/compat.py
-src/pip/_internal/utils/compatibility_tags.py
-src/pip/_internal/utils/datetime.py
-src/pip/_internal/utils/deprecation.py
-src/pip/_internal/utils/direct_url_helpers.py
-src/pip/_internal/utils/distutils_args.py
-src/pip/_internal/utils/egg_link.py
-src/pip/_internal/utils/encoding.py
-src/pip/_internal/utils/entrypoints.py
-src/pip/_internal/utils/filesystem.py
-src/pip/_internal/utils/filetypes.py
-src/pip/_internal/utils/glibc.py
-src/pip/_internal/utils/hashes.py
-src/pip/_internal/utils/inject_securetransport.py
-src/pip/_internal/utils/logging.py
-src/pip/_internal/utils/misc.py
-src/pip/_internal/utils/models.py
-src/pip/_internal/utils/packaging.py
-src/pip/_internal/utils/setuptools_build.py
-src/pip/_internal/utils/subprocess.py
-src/pip/_internal/utils/temp_dir.py
-src/pip/_internal/utils/unpacking.py
-src/pip/_internal/utils/urls.py
-src/pip/_internal/utils/virtualenv.py
-src/pip/_internal/utils/wheel.py
-src/pip/_internal/vcs/__init__.py
-src/pip/_internal/vcs/bazaar.py
-src/pip/_internal/vcs/git.py
-src/pip/_internal/vcs/mercurial.py
-src/pip/_internal/vcs/subversion.py
-src/pip/_internal/vcs/versioncontrol.py
-src/pip/_vendor/README.rst
-src/pip/_vendor/__init__.py
-src/pip/_vendor/six.LICENSE
-src/pip/_vendor/six.py
-src/pip/_vendor/typing_extensions.LICENSE
-src/pip/_vendor/typing_extensions.py
-src/pip/_vendor/vendor.txt
-src/pip/_vendor/cachecontrol/LICENSE.txt
-src/pip/_vendor/cachecontrol/__init__.py
-src/pip/_vendor/cachecontrol/_cmd.py
-src/pip/_vendor/cachecontrol/adapter.py
-src/pip/_vendor/cachecontrol/cache.py
-src/pip/_vendor/cachecontrol/compat.py
-src/pip/_vendor/cachecontrol/controller.py
-src/pip/_vendor/cachecontrol/filewrapper.py
-src/pip/_vendor/cachecontrol/heuristics.py
-src/pip/_vendor/cachecontrol/serialize.py
-src/pip/_vendor/cachecontrol/wrapper.py
-src/pip/_vendor/cachecontrol/caches/__init__.py
-src/pip/_vendor/cachecontrol/caches/file_cache.py
-src/pip/_vendor/cachecontrol/caches/redis_cache.py
-src/pip/_vendor/certifi/LICENSE
-src/pip/_vendor/certifi/__init__.py
-src/pip/_vendor/certifi/__main__.py
-src/pip/_vendor/certifi/cacert.pem
-src/pip/_vendor/certifi/core.py
-src/pip/_vendor/certifi/py.typed
-src/pip/_vendor/chardet/LICENSE
-src/pip/_vendor/chardet/__init__.py
-src/pip/_vendor/chardet/big5freq.py
-src/pip/_vendor/chardet/big5prober.py
-src/pip/_vendor/chardet/chardistribution.py
-src/pip/_vendor/chardet/charsetgroupprober.py
-src/pip/_vendor/chardet/charsetprober.py
-src/pip/_vendor/chardet/codingstatemachine.py
-src/pip/_vendor/chardet/cp949prober.py
-src/pip/_vendor/chardet/enums.py
-src/pip/_vendor/chardet/escprober.py
-src/pip/_vendor/chardet/escsm.py
-src/pip/_vendor/chardet/eucjpprober.py
-src/pip/_vendor/chardet/euckrfreq.py
-src/pip/_vendor/chardet/euckrprober.py
-src/pip/_vendor/chardet/euctwfreq.py
-src/pip/_vendor/chardet/euctwprober.py
-src/pip/_vendor/chardet/gb2312freq.py
-src/pip/_vendor/chardet/gb2312prober.py
-src/pip/_vendor/chardet/hebrewprober.py
-src/pip/_vendor/chardet/jisfreq.py
-src/pip/_vendor/chardet/johabfreq.py
-src/pip/_vendor/chardet/johabprober.py
-src/pip/_vendor/chardet/jpcntx.py
-src/pip/_vendor/chardet/langbulgarianmodel.py
-src/pip/_vendor/chardet/langgreekmodel.py
-src/pip/_vendor/chardet/langhebrewmodel.py
-src/pip/_vendor/chardet/langhungarianmodel.py
-src/pip/_vendor/chardet/langrussianmodel.py
-src/pip/_vendor/chardet/langthaimodel.py
-src/pip/_vendor/chardet/langturkishmodel.py
-src/pip/_vendor/chardet/latin1prober.py
-src/pip/_vendor/chardet/mbcharsetprober.py
-src/pip/_vendor/chardet/mbcsgroupprober.py
-src/pip/_vendor/chardet/mbcssm.py
-src/pip/_vendor/chardet/sbcharsetprober.py
-src/pip/_vendor/chardet/sbcsgroupprober.py
-src/pip/_vendor/chardet/sjisprober.py
-src/pip/_vendor/chardet/universaldetector.py
-src/pip/_vendor/chardet/utf1632prober.py
-src/pip/_vendor/chardet/utf8prober.py
-src/pip/_vendor/chardet/version.py
-src/pip/_vendor/chardet/cli/__init__.py
-src/pip/_vendor/chardet/cli/chardetect.py
-src/pip/_vendor/chardet/metadata/__init__.py
-src/pip/_vendor/chardet/metadata/languages.py
-src/pip/_vendor/colorama/LICENSE.txt
-src/pip/_vendor/colorama/__init__.py
-src/pip/_vendor/colorama/ansi.py
-src/pip/_vendor/colorama/ansitowin32.py
-src/pip/_vendor/colorama/initialise.py
-src/pip/_vendor/colorama/win32.py
-src/pip/_vendor/colorama/winterm.py
-src/pip/_vendor/distlib/LICENSE.txt
-src/pip/_vendor/distlib/__init__.py
-src/pip/_vendor/distlib/compat.py
-src/pip/_vendor/distlib/database.py
-src/pip/_vendor/distlib/index.py
-src/pip/_vendor/distlib/locators.py
-src/pip/_vendor/distlib/manifest.py
-src/pip/_vendor/distlib/markers.py
-src/pip/_vendor/distlib/metadata.py
-src/pip/_vendor/distlib/resources.py
-src/pip/_vendor/distlib/scripts.py
-src/pip/_vendor/distlib/t32.exe
-src/pip/_vendor/distlib/t64-arm.exe
-src/pip/_vendor/distlib/t64.exe
-src/pip/_vendor/distlib/util.py
-src/pip/_vendor/distlib/version.py
-src/pip/_vendor/distlib/w32.exe
-src/pip/_vendor/distlib/w64-arm.exe
-src/pip/_vendor/distlib/w64.exe
-src/pip/_vendor/distlib/wheel.py
-src/pip/_vendor/distro/LICENSE
-src/pip/_vendor/distro/__init__.py
-src/pip/_vendor/distro/__main__.py
-src/pip/_vendor/distro/distro.py
-src/pip/_vendor/distro/py.typed
-src/pip/_vendor/idna/LICENSE.md
-src/pip/_vendor/idna/__init__.py
-src/pip/_vendor/idna/codec.py
-src/pip/_vendor/idna/compat.py
-src/pip/_vendor/idna/core.py
-src/pip/_vendor/idna/idnadata.py
-src/pip/_vendor/idna/intranges.py
-src/pip/_vendor/idna/package_data.py
-src/pip/_vendor/idna/py.typed
-src/pip/_vendor/idna/uts46data.py
-src/pip/_vendor/msgpack/COPYING
-src/pip/_vendor/msgpack/__init__.py
-src/pip/_vendor/msgpack/exceptions.py
-src/pip/_vendor/msgpack/ext.py
-src/pip/_vendor/msgpack/fallback.py
-src/pip/_vendor/packaging/LICENSE
-src/pip/_vendor/packaging/LICENSE.APACHE
-src/pip/_vendor/packaging/LICENSE.BSD
-src/pip/_vendor/packaging/__about__.py
-src/pip/_vendor/packaging/__init__.py
-src/pip/_vendor/packaging/_manylinux.py
-src/pip/_vendor/packaging/_musllinux.py
-src/pip/_vendor/packaging/_structures.py
-src/pip/_vendor/packaging/markers.py
-src/pip/_vendor/packaging/py.typed
-src/pip/_vendor/packaging/requirements.py
-src/pip/_vendor/packaging/specifiers.py
-src/pip/_vendor/packaging/tags.py
-src/pip/_vendor/packaging/utils.py
-src/pip/_vendor/packaging/version.py
-src/pip/_vendor/pep517/LICENSE
-src/pip/_vendor/pep517/__init__.py
-src/pip/_vendor/pep517/_compat.py
-src/pip/_vendor/pep517/build.py
-src/pip/_vendor/pep517/check.py
-src/pip/_vendor/pep517/colorlog.py
-src/pip/_vendor/pep517/dirtools.py
-src/pip/_vendor/pep517/envbuild.py
-src/pip/_vendor/pep517/meta.py
-src/pip/_vendor/pep517/wrappers.py
-src/pip/_vendor/pep517/in_process/__init__.py
-src/pip/_vendor/pep517/in_process/_in_process.py
-src/pip/_vendor/pkg_resources/LICENSE
-src/pip/_vendor/pkg_resources/__init__.py
-src/pip/_vendor/pkg_resources/py31compat.py
-src/pip/_vendor/platformdirs/LICENSE.txt
-src/pip/_vendor/platformdirs/__init__.py
-src/pip/_vendor/platformdirs/__main__.py
-src/pip/_vendor/platformdirs/android.py
-src/pip/_vendor/platformdirs/api.py
-src/pip/_vendor/platformdirs/macos.py
-src/pip/_vendor/platformdirs/py.typed
-src/pip/_vendor/platformdirs/unix.py
-src/pip/_vendor/platformdirs/version.py
-src/pip/_vendor/platformdirs/windows.py
-src/pip/_vendor/pygments/LICENSE
-src/pip/_vendor/pygments/__init__.py
-src/pip/_vendor/pygments/__main__.py
-src/pip/_vendor/pygments/cmdline.py
-src/pip/_vendor/pygments/console.py
-src/pip/_vendor/pygments/filter.py
-src/pip/_vendor/pygments/formatter.py
-src/pip/_vendor/pygments/lexer.py
-src/pip/_vendor/pygments/modeline.py
-src/pip/_vendor/pygments/plugin.py
-src/pip/_vendor/pygments/regexopt.py
-src/pip/_vendor/pygments/scanner.py
-src/pip/_vendor/pygments/sphinxext.py
-src/pip/_vendor/pygments/style.py
-src/pip/_vendor/pygments/token.py
-src/pip/_vendor/pygments/unistring.py
-src/pip/_vendor/pygments/util.py
-src/pip/_vendor/pygments/filters/__init__.py
-src/pip/_vendor/pygments/formatters/__init__.py
-src/pip/_vendor/pygments/formatters/_mapping.py
-src/pip/_vendor/pygments/formatters/bbcode.py
-src/pip/_vendor/pygments/formatters/groff.py
-src/pip/_vendor/pygments/formatters/html.py
-src/pip/_vendor/pygments/formatters/img.py
-src/pip/_vendor/pygments/formatters/irc.py
-src/pip/_vendor/pygments/formatters/latex.py
-src/pip/_vendor/pygments/formatters/other.py
-src/pip/_vendor/pygments/formatters/pangomarkup.py
-src/pip/_vendor/pygments/formatters/rtf.py
-src/pip/_vendor/pygments/formatters/svg.py
-src/pip/_vendor/pygments/formatters/terminal.py
-src/pip/_vendor/pygments/formatters/terminal256.py
-src/pip/_vendor/pygments/lexers/__init__.py
-src/pip/_vendor/pygments/lexers/_mapping.py
-src/pip/_vendor/pygments/lexers/python.py
-src/pip/_vendor/pygments/styles/__init__.py
-src/pip/_vendor/pyparsing/LICENSE
-src/pip/_vendor/pyparsing/__init__.py
-src/pip/_vendor/pyparsing/actions.py
-src/pip/_vendor/pyparsing/common.py
-src/pip/_vendor/pyparsing/core.py
-src/pip/_vendor/pyparsing/exceptions.py
-src/pip/_vendor/pyparsing/helpers.py
-src/pip/_vendor/pyparsing/py.typed
-src/pip/_vendor/pyparsing/results.py
-src/pip/_vendor/pyparsing/testing.py
-src/pip/_vendor/pyparsing/unicode.py
-src/pip/_vendor/pyparsing/util.py
-src/pip/_vendor/pyparsing/diagram/__init__.py
-src/pip/_vendor/requests/LICENSE
-src/pip/_vendor/requests/__init__.py
-src/pip/_vendor/requests/__version__.py
-src/pip/_vendor/requests/_internal_utils.py
-src/pip/_vendor/requests/adapters.py
-src/pip/_vendor/requests/api.py
-src/pip/_vendor/requests/auth.py
-src/pip/_vendor/requests/certs.py
-src/pip/_vendor/requests/compat.py
-src/pip/_vendor/requests/cookies.py
-src/pip/_vendor/requests/exceptions.py
-src/pip/_vendor/requests/help.py
-src/pip/_vendor/requests/hooks.py
-src/pip/_vendor/requests/models.py
-src/pip/_vendor/requests/packages.py
-src/pip/_vendor/requests/sessions.py
-src/pip/_vendor/requests/status_codes.py
-src/pip/_vendor/requests/structures.py
-src/pip/_vendor/requests/utils.py
-src/pip/_vendor/resolvelib/LICENSE
-src/pip/_vendor/resolvelib/__init__.py
-src/pip/_vendor/resolvelib/providers.py
-src/pip/_vendor/resolvelib/py.typed
-src/pip/_vendor/resolvelib/reporters.py
-src/pip/_vendor/resolvelib/resolvers.py
-src/pip/_vendor/resolvelib/structs.py
-src/pip/_vendor/resolvelib/compat/__init__.py
-src/pip/_vendor/resolvelib/compat/collections_abc.py
-src/pip/_vendor/rich/LICENSE
-src/pip/_vendor/rich/__init__.py
-src/pip/_vendor/rich/__main__.py
-src/pip/_vendor/rich/_cell_widths.py
-src/pip/_vendor/rich/_emoji_codes.py
-src/pip/_vendor/rich/_emoji_replace.py
-src/pip/_vendor/rich/_export_format.py
-src/pip/_vendor/rich/_extension.py
-src/pip/_vendor/rich/_inspect.py
-src/pip/_vendor/rich/_log_render.py
-src/pip/_vendor/rich/_loop.py
-src/pip/_vendor/rich/_palettes.py
-src/pip/_vendor/rich/_pick.py
-src/pip/_vendor/rich/_ratio.py
-src/pip/_vendor/rich/_spinners.py
-src/pip/_vendor/rich/_stack.py
-src/pip/_vendor/rich/_timer.py
-src/pip/_vendor/rich/_win32_console.py
-src/pip/_vendor/rich/_windows.py
-src/pip/_vendor/rich/_windows_renderer.py
-src/pip/_vendor/rich/_wrap.py
-src/pip/_vendor/rich/abc.py
-src/pip/_vendor/rich/align.py
-src/pip/_vendor/rich/ansi.py
-src/pip/_vendor/rich/bar.py
-src/pip/_vendor/rich/box.py
-src/pip/_vendor/rich/cells.py
-src/pip/_vendor/rich/color.py
-src/pip/_vendor/rich/color_triplet.py
-src/pip/_vendor/rich/columns.py
-src/pip/_vendor/rich/console.py
-src/pip/_vendor/rich/constrain.py
-src/pip/_vendor/rich/containers.py
-src/pip/_vendor/rich/control.py
-src/pip/_vendor/rich/default_styles.py
-src/pip/_vendor/rich/diagnose.py
-src/pip/_vendor/rich/emoji.py
-src/pip/_vendor/rich/errors.py
-src/pip/_vendor/rich/file_proxy.py
-src/pip/_vendor/rich/filesize.py
-src/pip/_vendor/rich/highlighter.py
-src/pip/_vendor/rich/json.py
-src/pip/_vendor/rich/jupyter.py
-src/pip/_vendor/rich/layout.py
-src/pip/_vendor/rich/live.py
-src/pip/_vendor/rich/live_render.py
-src/pip/_vendor/rich/logging.py
-src/pip/_vendor/rich/markup.py
-src/pip/_vendor/rich/measure.py
-src/pip/_vendor/rich/padding.py
-src/pip/_vendor/rich/pager.py
-src/pip/_vendor/rich/palette.py
-src/pip/_vendor/rich/panel.py
-src/pip/_vendor/rich/pretty.py
-src/pip/_vendor/rich/progress.py
-src/pip/_vendor/rich/progress_bar.py
-src/pip/_vendor/rich/prompt.py
-src/pip/_vendor/rich/protocol.py
-src/pip/_vendor/rich/py.typed
-src/pip/_vendor/rich/region.py
-src/pip/_vendor/rich/repr.py
-src/pip/_vendor/rich/rule.py
-src/pip/_vendor/rich/scope.py
-src/pip/_vendor/rich/screen.py
-src/pip/_vendor/rich/segment.py
-src/pip/_vendor/rich/spinner.py
-src/pip/_vendor/rich/status.py
-src/pip/_vendor/rich/style.py
-src/pip/_vendor/rich/styled.py
-src/pip/_vendor/rich/syntax.py
-src/pip/_vendor/rich/table.py
-src/pip/_vendor/rich/terminal_theme.py
-src/pip/_vendor/rich/text.py
-src/pip/_vendor/rich/theme.py
-src/pip/_vendor/rich/themes.py
-src/pip/_vendor/rich/traceback.py
-src/pip/_vendor/rich/tree.py
-src/pip/_vendor/tenacity/LICENSE
-src/pip/_vendor/tenacity/__init__.py
-src/pip/_vendor/tenacity/_asyncio.py
-src/pip/_vendor/tenacity/_utils.py
-src/pip/_vendor/tenacity/after.py
-src/pip/_vendor/tenacity/before.py
-src/pip/_vendor/tenacity/before_sleep.py
-src/pip/_vendor/tenacity/nap.py
-src/pip/_vendor/tenacity/py.typed
-src/pip/_vendor/tenacity/retry.py
-src/pip/_vendor/tenacity/stop.py
-src/pip/_vendor/tenacity/tornadoweb.py
-src/pip/_vendor/tenacity/wait.py
-src/pip/_vendor/tomli/LICENSE
-src/pip/_vendor/tomli/__init__.py
-src/pip/_vendor/tomli/_parser.py
-src/pip/_vendor/tomli/_re.py
-src/pip/_vendor/tomli/_types.py
-src/pip/_vendor/tomli/py.typed
-src/pip/_vendor/urllib3/LICENSE.txt
-src/pip/_vendor/urllib3/__init__.py
-src/pip/_vendor/urllib3/_collections.py
-src/pip/_vendor/urllib3/_version.py
-src/pip/_vendor/urllib3/connection.py
-src/pip/_vendor/urllib3/connectionpool.py
-src/pip/_vendor/urllib3/exceptions.py
-src/pip/_vendor/urllib3/fields.py
-src/pip/_vendor/urllib3/filepost.py
-src/pip/_vendor/urllib3/poolmanager.py
-src/pip/_vendor/urllib3/request.py
-src/pip/_vendor/urllib3/response.py
-src/pip/_vendor/urllib3/contrib/__init__.py
-src/pip/_vendor/urllib3/contrib/_appengine_environ.py
-src/pip/_vendor/urllib3/contrib/appengine.py
-src/pip/_vendor/urllib3/contrib/ntlmpool.py
-src/pip/_vendor/urllib3/contrib/pyopenssl.py
-src/pip/_vendor/urllib3/contrib/securetransport.py
-src/pip/_vendor/urllib3/contrib/socks.py
-src/pip/_vendor/urllib3/contrib/_securetransport/__init__.py
-src/pip/_vendor/urllib3/contrib/_securetransport/bindings.py
-src/pip/_vendor/urllib3/contrib/_securetransport/low_level.py
-src/pip/_vendor/urllib3/packages/__init__.py
-src/pip/_vendor/urllib3/packages/six.py
-src/pip/_vendor/urllib3/packages/backports/__init__.py
-src/pip/_vendor/urllib3/packages/backports/makefile.py
-src/pip/_vendor/urllib3/util/__init__.py
-src/pip/_vendor/urllib3/util/connection.py
-src/pip/_vendor/urllib3/util/proxy.py
-src/pip/_vendor/urllib3/util/queue.py
-src/pip/_vendor/urllib3/util/request.py
-src/pip/_vendor/urllib3/util/response.py
-src/pip/_vendor/urllib3/util/retry.py
-src/pip/_vendor/urllib3/util/ssl_.py
-src/pip/_vendor/urllib3/util/ssl_match_hostname.py
-src/pip/_vendor/urllib3/util/ssltransport.py
-src/pip/_vendor/urllib3/util/timeout.py
-src/pip/_vendor/urllib3/util/url.py
-src/pip/_vendor/urllib3/util/wait.py
-src/pip/_vendor/webencodings/LICENSE
-src/pip/_vendor/webencodings/__init__.py
-src/pip/_vendor/webencodings/labels.py
-src/pip/_vendor/webencodings/mklabels.py
-src/pip/_vendor/webencodings/tests.py
-src/pip/_vendor/webencodings/x_user_defined.py
\ No newline at end of file

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info/dependency_links.txt Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info/entry_points.txt Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info/not-zip-safe Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip.egg-info/top_level.txt Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/install/legacy.py Deleted

@@ -1,120 +0,0 @@
-"""Legacy installation process, i.e. `setup.py install`.
-"""
-
-import logging
-import os
-from typing import List, Optional, Sequence
-
-from pip._internal.build_env import BuildEnvironment
-from pip._internal.exceptions import InstallationError, LegacyInstallFailure
-from pip._internal.locations.base import change_root
-from pip._internal.models.scheme import Scheme
-from pip._internal.utils.misc import ensure_dir
-from pip._internal.utils.setuptools_build import make_setuptools_install_args
-from pip._internal.utils.subprocess import runner_with_spinner_message
-from pip._internal.utils.temp_dir import TempDirectory
-
-logger = logging.getLogger(__name__)
-
-
-def write_installed_files_from_setuptools_record(
-    record_lines: Liststr,
-    root: Optionalstr,
-    req_description: str,
-) -> None:
-    def prepend_root(path: str) -> str:
-        if root is None or not os.path.isabs(path):
-            return path
-        else:
-            return change_root(root, path)
-
-    for line in record_lines:
-        directory = os.path.dirname(line)
-        if directory.endswith(".egg-info"):
-            egg_info_dir = prepend_root(directory)
-            break
-    else:
-        message = (
-            "{} did not indicate that it installed an "
-            ".egg-info directory. Only setup.py projects "
-            "generating .egg-info directories are supported."
-        ).format(req_description)
-        raise InstallationError(message)
-
-    new_lines = 
-    for line in record_lines:
-        filename = line.strip()
-        if os.path.isdir(filename):
-            filename += os.path.sep
-        new_lines.append(os.path.relpath(prepend_root(filename), egg_info_dir))
-    new_lines.sort()
-    ensure_dir(egg_info_dir)
-    inst_files_path = os.path.join(egg_info_dir, "installed-files.txt")
-    with open(inst_files_path, "w") as f:
-        f.write("\n".join(new_lines) + "\n")
-
-
-def install(
-    install_options: Liststr,
-    global_options: Sequencestr,
-    root: Optionalstr,
-    home: Optionalstr,
-    prefix: Optionalstr,
-    use_user_site: bool,
-    pycompile: bool,
-    scheme: Scheme,
-    setup_py_path: str,
-    isolated: bool,
-    req_name: str,
-    build_env: BuildEnvironment,
-    unpacked_source_directory: str,
-    req_description: str,
-) -> bool:
-
-    header_dir = scheme.headers
-
-    with TempDirectory(kind="record") as temp_dir:
-        try:
-            record_filename = os.path.join(temp_dir.path, "install-record.txt")
-            install_args = make_setuptools_install_args(
-                setup_py_path,
-                global_options=global_options,
-                install_options=install_options,
-                record_filename=record_filename,
-                root=root,
-                prefix=prefix,
-                header_dir=header_dir,
-                home=home,
-                use_user_site=use_user_site,
-                no_user_config=isolated,
-                pycompile=pycompile,
-            )
-
-            runner = runner_with_spinner_message(
-                f"Running setup.py install for {req_name}"
-            )
-            with build_env:
-                runner(
-                    cmd=install_args,
-                    cwd=unpacked_source_directory,
-                )
-
-            if not os.path.exists(record_filename):
-                logger.debug("Record file %s not found", record_filename)
-                # Signal to the caller that we didn't install the new package
-                return False
-
-        except Exception as e:
-            # Signal to the caller that we didn't install the new package
-            raise LegacyInstallFailure(package_details=req_name) from e
-
-        # At this point, we have successfully installed the requirement.
-
-        # We intentionally do not use any encoding to read the file because
-        # setuptools writes the file using distutils.file_util.write_file,
-        # which does not specify an encoding.
-        with open(record_filename) as f:
-            record_lines = f.read().splitlines()
-
-    write_installed_files_from_setuptools_record(record_lines, root, req_description)
-    return True

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/distutils_args.py Deleted

@@ -1,43 +0,0 @@
-from getopt import GetoptError, getopt
-from typing import Dict, List
-
-_options = 
-    "exec-prefix=",
-    "home=",
-    "install-base=",
-    "install-data=",
-    "install-headers=",
-    "install-lib=",
-    "install-platlib=",
-    "install-purelib=",
-    "install-scripts=",
-    "prefix=",
-    "root=",
-    "user",
-
-
-
-def parse_distutils_args(args: Liststr) -> Dictstr, str:
-    """Parse provided arguments, returning an object that has the matched arguments.
-
-    Any unknown arguments are ignored.
-    """
-    result = {}
-    for arg in args:
-        try:
-            parsed_opt, _ = getopt(args=arg, shortopts="", longopts=_options)
-        except GetoptError:
-            # We don't care about any other options, which here may be
-            # considered unrecognized since our option list is not
-            # exhaustive.
-            continue
-
-        if not parsed_opt:
-            continue
-
-        option = parsed_opt0
-        name_from_parsed = option02:.replace("-", "_")
-        value_from_parsed = option1 or "true"
-        resultname_from_parsed = value_from_parsed
-
-    return result

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517 Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/__init__.py Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/build.py Deleted

@@ -1,126 +0,0 @@
-"""Build a project using PEP 517 hooks.
-"""
-import argparse
-import logging
-import os
-import shutil
-import tempfile
-
-from ._compat import tomllib
-from .envbuild import BuildEnvironment
-from .wrappers import Pep517HookCaller
-
-log = logging.getLogger(__name__)
-
-
-def validate_system(system):
-    """
-    Ensure build system has the requisite fields.
-    """
-    required = {'requires', 'build-backend'}
-    if not (required <= set(system)):
-        message = "Missing required fields: {missing}".format(
-            missing=required-set(system),
-        )
-        raise ValueError(message)
-
-
-def load_system(source_dir):
-    """
-    Load the build system from a source dir (pyproject.toml).
-    """
-    pyproject = os.path.join(source_dir, 'pyproject.toml')
-    with open(pyproject, 'rb') as f:
-        pyproject_data = tomllib.load(f)
-    return pyproject_data'build-system'
-
-
-def compat_system(source_dir):
-    """
-    Given a source dir, attempt to get a build system backend
-    and requirements from pyproject.toml. Fallback to
-    setuptools but only if the file was not found or a build
-    system was not indicated.
-    """
-    try:
-        system = load_system(source_dir)
-    except (FileNotFoundError, KeyError):
-        system = {}
-    system.setdefault(
-        'build-backend',
-        'setuptools.build_meta:__legacy__',
-    )
-    system.setdefault('requires', 'setuptools', 'wheel')
-    return system
-
-
-def _do_build(hooks, env, dist, dest):
-    get_requires_name = 'get_requires_for_build_{dist}'.format(**locals())
-    get_requires = getattr(hooks, get_requires_name)
-    reqs = get_requires({})
-    log.info('Got build requires: %s', reqs)
-
-    env.pip_install(reqs)
-    log.info('Installed dynamic build dependencies')
-
-    with tempfile.TemporaryDirectory() as td:
-        log.info('Trying to build %s in %s', dist, td)
-        build_name = 'build_{dist}'.format(**locals())
-        build = getattr(hooks, build_name)
-        filename = build(td, {})
-        source = os.path.join(td, filename)
-        shutil.move(source, os.path.join(dest, os.path.basename(filename)))
-
-
-def build(source_dir, dist, dest=None, system=None):
-    system = system or load_system(source_dir)
-    dest = os.path.join(source_dir, dest or 'dist')
-    os.makedirs(dest, exist_ok=True)
-
-    validate_system(system)
-    hooks = Pep517HookCaller(
-        source_dir, system'build-backend', system.get('backend-path')
-    )
-
-    with BuildEnvironment() as env:
-        env.pip_install(system'requires')
-        _do_build(hooks, env, dist, dest)
-
-
-parser = argparse.ArgumentParser()
-parser.add_argument(
-    'source_dir',
-    help="A directory containing pyproject.toml",
-)
-parser.add_argument(
-    '--binary', '-b',
-    action='store_true',
-    default=False,
-)
-parser.add_argument(
-    '--source', '-s',
-    action='store_true',
-    default=False,
-)
-parser.add_argument(
-    '--out-dir', '-o',
-    help="Destination in which to save the builds relative to source dir",
-)
-
-
-def main(args):
-    log.warning('pep517.build is deprecated. '
-                'Consider switching to https://pypi.org/project/build/')
-
-    # determine which dists to build
-    dists = list(filter(None, (
-        'sdist' if args.source or not args.binary else None,
-        'wheel' if args.binary or not args.source else None,
-    )))
-
-    for dist in dists:
-        build(args.source_dir, dist, args.out_dir)
-
-
-if __name__ == '__main__':
-    main(parser.parse_args())

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/check.py Deleted

@@ -1,207 +0,0 @@
-"""Check a project and backend by attempting to build using PEP 517 hooks.
-"""
-import argparse
-import logging
-import os
-import shutil
-import sys
-import tarfile
-import zipfile
-from os.path import isfile
-from os.path import join as pjoin
-from subprocess import CalledProcessError
-from tempfile import mkdtemp
-
-from ._compat import tomllib
-from .colorlog import enable_colourful_output
-from .envbuild import BuildEnvironment
-from .wrappers import Pep517HookCaller
-
-log = logging.getLogger(__name__)
-
-
-def check_build_sdist(hooks, build_sys_requires):
-    with BuildEnvironment() as env:
-        try:
-            env.pip_install(build_sys_requires)
-            log.info('Installed static build dependencies')
-        except CalledProcessError:
-            log.error('Failed to install static build dependencies')
-            return False
-
-        try:
-            reqs = hooks.get_requires_for_build_sdist({})
-            log.info('Got build requires: %s', reqs)
-        except Exception:
-            log.error('Failure in get_requires_for_build_sdist', exc_info=True)
-            return False
-
-        try:
-            env.pip_install(reqs)
-            log.info('Installed dynamic build dependencies')
-        except CalledProcessError:
-            log.error('Failed to install dynamic build dependencies')
-            return False
-
-        td = mkdtemp()
-        log.info('Trying to build sdist in %s', td)
-        try:
-            try:
-                filename = hooks.build_sdist(td, {})
-                log.info('build_sdist returned %r', filename)
-            except Exception:
-                log.info('Failure in build_sdist', exc_info=True)
-                return False
-
-            if not filename.endswith('.tar.gz'):
-                log.error(
-                    "Filename %s doesn't have .tar.gz extension", filename)
-                return False
-
-            path = pjoin(td, filename)
-            if isfile(path):
-                log.info("Output file %s exists", path)
-            else:
-                log.error("Output file %s does not exist", path)
-                return False
-
-            if tarfile.is_tarfile(path):
-                log.info("Output file is a tar file")
-            else:
-                log.error("Output file is not a tar file")
-                return False
-
-        finally:
-            shutil.rmtree(td)
-
-        return True
-
-
-def check_build_wheel(hooks, build_sys_requires):
-    with BuildEnvironment() as env:
-        try:
-            env.pip_install(build_sys_requires)
-            log.info('Installed static build dependencies')
-        except CalledProcessError:
-            log.error('Failed to install static build dependencies')
-            return False
-
-        try:
-            reqs = hooks.get_requires_for_build_wheel({})
-            log.info('Got build requires: %s', reqs)
-        except Exception:
-            log.error('Failure in get_requires_for_build_sdist', exc_info=True)
-            return False
-
-        try:
-            env.pip_install(reqs)
-            log.info('Installed dynamic build dependencies')
-        except CalledProcessError:
-            log.error('Failed to install dynamic build dependencies')
-            return False
-
-        td = mkdtemp()
-        log.info('Trying to build wheel in %s', td)
-        try:
-            try:
-                filename = hooks.build_wheel(td, {})
-                log.info('build_wheel returned %r', filename)
-            except Exception:
-                log.info('Failure in build_wheel', exc_info=True)
-                return False
-
-            if not filename.endswith('.whl'):
-                log.error("Filename %s doesn't have .whl extension", filename)
-                return False
-
-            path = pjoin(td, filename)
-            if isfile(path):
-                log.info("Output file %s exists", path)
-            else:
-                log.error("Output file %s does not exist", path)
-                return False
-
-            if zipfile.is_zipfile(path):
-                log.info("Output file is a zip file")
-            else:
-                log.error("Output file is not a zip file")
-                return False
-
-        finally:
-            shutil.rmtree(td)
-
-        return True
-
-
-def check(source_dir):
-    pyproject = pjoin(source_dir, 'pyproject.toml')
-    if isfile(pyproject):
-        log.info('Found pyproject.toml')
-    else:
-        log.error('Missing pyproject.toml')
-        return False
-
-    try:
-        with open(pyproject, 'rb') as f:
-            pyproject_data = tomllib.load(f)
-        # Ensure the mandatory data can be loaded
-        buildsys = pyproject_data'build-system'
-        requires = buildsys'requires'
-        backend = buildsys'build-backend'
-        backend_path = buildsys.get('backend-path')
-        log.info('Loaded pyproject.toml')
-    except (tomllib.TOMLDecodeError, KeyError):
-        log.error("Invalid pyproject.toml", exc_info=True)
-        return False
-
-    hooks = Pep517HookCaller(source_dir, backend, backend_path)
-
-    sdist_ok = check_build_sdist(hooks, requires)
-    wheel_ok = check_build_wheel(hooks, requires)
-
-    if not sdist_ok:
-        log.warning('Sdist checks failed; scroll up to see')
-    if not wheel_ok:
-        log.warning('Wheel checks failed')
-
-    return sdist_ok
-
-
-def main(argv=None):
-    log.warning('pep517.check is deprecated. '
-                'Consider switching to https://pypi.org/project/build/')
-
-    ap = argparse.ArgumentParser()
-    ap.add_argument(
-        'source_dir',
-        help="A directory containing pyproject.toml")
-    args = ap.parse_args(argv)
-
-    enable_colourful_output()
-
-    ok = check(args.source_dir)
-
-    if ok:
-        print(ansi('Checks passed', 'green'))
-    else:
-        print(ansi('Checks failed', 'red'))
-        sys.exit(1)
-
-
-ansi_codes = {
-    'reset': '\x1b0m',
-    'bold': '\x1b1m',
-    'red': '\x1b31m',
-    'green': '\x1b32m',
-}
-
-
-def ansi(s, attr):
-    if os.name != 'nt' and sys.stdout.isatty():
-        return ansi_codesattr + str(s) + ansi_codes'reset'
-    else:
-        return str(s)
-
-
-if __name__ == '__main__':
-    main()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/colorlog.py Deleted

@@ -1,113 +0,0 @@
-"""Nicer log formatting with colours.
-
-Code copied from Tornado, Apache licensed.
-"""
-# Copyright 2012 Facebook
-#
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-
-import logging
-import sys
-
-try:
-    import curses
-except ImportError:
-    curses = None
-
-
-def _stderr_supports_color():
-    color = False
-    if curses and hasattr(sys.stderr, 'isatty') and sys.stderr.isatty():
-        try:
-            curses.setupterm()
-            if curses.tigetnum("colors") > 0:
-                color = True
-        except Exception:
-            pass
-    return color
-
-
-class LogFormatter(logging.Formatter):
-    """Log formatter with colour support
-    """
-    DEFAULT_COLORS = {
-        logging.INFO: 2,  # Green
-        logging.WARNING: 3,  # Yellow
-        logging.ERROR: 1,  # Red
-        logging.CRITICAL: 1,
-    }
-
-    def __init__(self, color=True, datefmt=None):
-        r"""
-        :arg bool color: Enables color support.
-        :arg string fmt: Log message format.
-        It will be applied to the attributes dict of log records. The
-        text between ``%(color)s`` and ``%(end_color)s`` will be colored
-        depending on the level if color support is on.
-        :arg dict colors: color mappings from logging level to terminal color
-        code
-        :arg string datefmt: Datetime format.
-        Used for formatting ``(asctime)`` placeholder in ``prefix_fmt``.
-        .. versionchanged:: 3.2
-        Added ``fmt`` and ``datefmt`` arguments.
-        """
-        logging.Formatter.__init__(self, datefmt=datefmt)
-        self._colors = {}
-        if color and _stderr_supports_color():
-            # The curses module has some str/bytes confusion in
-            # python3. Until version 3.2.3, most methods return
-            # bytes, but only accept strings. In addition, we want to
-            # output these strings with the logging module, which
-            # works with unicode strings. The explicit calls to
-            # unicode() below are harmless in python2 but will do the
-            # right conversion in python 3.
-            fg_color = (curses.tigetstr("setaf") or
-                        curses.tigetstr("setf") or "")
-
-            for levelno, code in self.DEFAULT_COLORS.items():
-                self._colorslevelno = str(
-                    curses.tparm(fg_color, code), "ascii")
-            self._normal = str(curses.tigetstr("sgr0"), "ascii")
-
-            scr = curses.initscr()
-            self.termwidth = scr.getmaxyx()1
-            curses.endwin()
-        else:
-            self._normal = ''
-            # Default width is usually 80, but too wide is
-            # worse than too narrow
-            self.termwidth = 70
-
-    def formatMessage(self, record):
-        mlen = len(record.message)
-        right_text = '{initial}-{name}'.format(initial=record.levelname0,
-                                               name=record.name)
-        if mlen + len(right_text) < self.termwidth:
-            space = ' ' * (self.termwidth - (mlen + len(right_text)))
-        else:
-            space = '  '
-
-        if record.levelno in self._colors:
-            start_color = self._colorsrecord.levelno
-            end_color = self._normal
-        else:
-            start_color = end_color = ''
-
-        return record.message + space + start_color + right_text + end_color
-
-
-def enable_colourful_output(level=logging.INFO):
-    handler = logging.StreamHandler()
-    handler.setFormatter(LogFormatter())
-    logging.root.addHandler(handler)
-    logging.root.setLevel(level)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/dirtools.py Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/envbuild.py Deleted

@@ -1,170 +0,0 @@
-"""Build wheels/sdists by installing build deps to a temporary environment.
-"""
-
-import logging
-import os
-import shutil
-import sys
-from subprocess import check_call
-from sysconfig import get_paths
-from tempfile import mkdtemp
-
-from ._compat import tomllib
-from .wrappers import LoggerWrapper, Pep517HookCaller
-
-log = logging.getLogger(__name__)
-
-
-def _load_pyproject(source_dir):
-    with open(
-            os.path.join(source_dir, 'pyproject.toml'),
-            'rb',
-            ) as f:
-        pyproject_data = tomllib.load(f)
-    buildsys = pyproject_data'build-system'
-    return (
-        buildsys'requires',
-        buildsys'build-backend',
-        buildsys.get('backend-path'),
-    )
-
-
-class BuildEnvironment:
-    """Context manager to install build deps in a simple temporary environment
-
-    Based on code I wrote for pip, which is MIT licensed.
-    """
-    # Copyright (c) 2008-2016 The pip developers (see AUTHORS.txt file)
-    #
-    # Permission is hereby granted, free of charge, to any person obtaining
-    # a copy of this software and associated documentation files (the
-    # "Software"), to deal in the Software without restriction, including
-    # without limitation the rights to use, copy, modify, merge, publish,
-    # distribute, sublicense, and/or sell copies of the Software, and to
-    # permit persons to whom the Software is furnished to do so, subject to
-    # the following conditions:
-    #
-    # The above copyright notice and this permission notice shall be
-    # included in all copies or substantial portions of the Software.
-    #
-    # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-    # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-    # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-    # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-    # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-    # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-    # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-    path = None
-
-    def __init__(self, cleanup=True):
-        self._cleanup = cleanup
-
-    def __enter__(self):
-        self.path = mkdtemp(prefix='pep517-build-env-')
-        log.info('Temporary build environment: %s', self.path)
-
-        self.save_path = os.environ.get('PATH', None)
-        self.save_pythonpath = os.environ.get('PYTHONPATH', None)
-
-        install_scheme = 'nt' if (os.name == 'nt') else 'posix_prefix'
-        install_dirs = get_paths(install_scheme, vars={
-            'base': self.path,
-            'platbase': self.path,
-        })
-
-        scripts = install_dirs'scripts'
-        if self.save_path:
-            os.environ'PATH' = scripts + os.pathsep + self.save_path
-        else:
-            os.environ'PATH' = scripts + os.pathsep + os.defpath
-
-        if install_dirs'purelib' == install_dirs'platlib':
-            lib_dirs = install_dirs'purelib'
-        else:
-            lib_dirs = install_dirs'purelib' + os.pathsep + \
-                install_dirs'platlib'
-        if self.save_pythonpath:
-            os.environ'PYTHONPATH' = lib_dirs + os.pathsep + \
-                self.save_pythonpath
-        else:
-            os.environ'PYTHONPATH' = lib_dirs
-
-        return self
-
-    def pip_install(self, reqs):
-        """Install dependencies into this env by calling pip in a subprocess"""
-        if not reqs:
-            return
-        log.info('Calling pip to install %s', reqs)
-        cmd = 
-            sys.executable, '-m', 'pip', 'install', '--ignore-installed',
-            '--prefix', self.path + list(reqs)
-        check_call(
-            cmd,
-            stdout=LoggerWrapper(log, logging.INFO),
-            stderr=LoggerWrapper(log, logging.ERROR),
-        )
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        needs_cleanup = (
-            self._cleanup and
-            self.path is not None and
-            os.path.isdir(self.path)
-        )
-        if needs_cleanup:
-            shutil.rmtree(self.path)
-
-        if self.save_path is None:
-            os.environ.pop('PATH', None)
-        else:
-            os.environ'PATH' = self.save_path
-
-        if self.save_pythonpath is None:
-            os.environ.pop('PYTHONPATH', None)
-        else:
-            os.environ'PYTHONPATH' = self.save_pythonpath
-
-
-def build_wheel(source_dir, wheel_dir, config_settings=None):
-    """Build a wheel from a source directory using PEP 517 hooks.
-
-    :param str source_dir: Source directory containing pyproject.toml
-    :param str wheel_dir: Target directory to create wheel in
-    :param dict config_settings: Options to pass to build backend
-
-    This is a blocking function which will run pip in a subprocess to install
-    build requirements.
-    """
-    if config_settings is None:
-        config_settings = {}
-    requires, backend, backend_path = _load_pyproject(source_dir)
-    hooks = Pep517HookCaller(source_dir, backend, backend_path)
-
-    with BuildEnvironment() as env:
-        env.pip_install(requires)
-        reqs = hooks.get_requires_for_build_wheel(config_settings)
-        env.pip_install(reqs)
-        return hooks.build_wheel(wheel_dir, config_settings)
-
-
-def build_sdist(source_dir, sdist_dir, config_settings=None):
-    """Build an sdist from a source directory using PEP 517 hooks.
-
-    :param str source_dir: Source directory containing pyproject.toml
-    :param str sdist_dir: Target directory to place sdist in
-    :param dict config_settings: Options to pass to build backend
-
-    This is a blocking function which will run pip in a subprocess to install
-    build requirements.
-    """
-    if config_settings is None:
-        config_settings = {}
-    requires, backend, backend_path = _load_pyproject(source_dir)
-    hooks = Pep517HookCaller(source_dir, backend, backend_path)
-
-    with BuildEnvironment() as env:
-        env.pip_install(requires)
-        reqs = hooks.get_requires_for_build_sdist(config_settings)
-        env.pip_install(reqs)
-        return hooks.build_sdist(sdist_dir, config_settings)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/in_process Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/in_process/__init__.py Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/in_process/_in_process.py Deleted

@@ -1,351 +0,0 @@
-"""This is invoked in a subprocess to call the build backend hooks.
-
-It expects:
-- Command line args: hook_name, control_dir
-- Environment variables:
-      PEP517_BUILD_BACKEND=entry.point:spec
-      PEP517_BACKEND_PATH=paths (separated with os.pathsep)
-- control_dir/input.json:
-  - {"kwargs": {...}}
-
-Results:
-- control_dir/output.json
-  - {"return_val": ...}
-"""
-import json
-import os
-import os.path
-import re
-import shutil
-import sys
-import traceback
-from glob import glob
-from importlib import import_module
-from os.path import join as pjoin
-
-# This file is run as a script, and `import wrappers` is not zip-safe, so we
-# include write_json() and read_json() from wrappers.py.
-
-
-def write_json(obj, path, **kwargs):
-    with open(path, 'w', encoding='utf-8') as f:
-        json.dump(obj, f, **kwargs)
-
-
-def read_json(path):
-    with open(path, encoding='utf-8') as f:
-        return json.load(f)
-
-
-class BackendUnavailable(Exception):
-    """Raised if we cannot import the backend"""
-    def __init__(self, traceback):
-        self.traceback = traceback
-
-
-class BackendInvalid(Exception):
-    """Raised if the backend is invalid"""
-    def __init__(self, message):
-        self.message = message
-
-
-class HookMissing(Exception):
-    """Raised if a hook is missing and we are not executing the fallback"""
-    def __init__(self, hook_name=None):
-        super().__init__(hook_name)
-        self.hook_name = hook_name
-
-
-def contained_in(filename, directory):
-    """Test if a file is located within the given directory."""
-    filename = os.path.normcase(os.path.abspath(filename))
-    directory = os.path.normcase(os.path.abspath(directory))
-    return os.path.commonprefix(filename, directory) == directory
-
-
-def _build_backend():
-    """Find and load the build backend"""
-    # Add in-tree backend directories to the front of sys.path.
-    backend_path = os.environ.get('PEP517_BACKEND_PATH')
-    if backend_path:
-        extra_pathitems = backend_path.split(os.pathsep)
-        sys.path:0 = extra_pathitems
-
-    ep = os.environ'PEP517_BUILD_BACKEND'
-    mod_path, _, obj_path = ep.partition(':')
-    try:
-        obj = import_module(mod_path)
-    except ImportError:
-        raise BackendUnavailable(traceback.format_exc())
-
-    if backend_path:
-        if not any(
-            contained_in(obj.__file__, path)
-            for path in extra_pathitems
-        ):
-            raise BackendInvalid("Backend was not loaded from backend-path")
-
-    if obj_path:
-        for path_part in obj_path.split('.'):
-            obj = getattr(obj, path_part)
-    return obj
-
-
-def _supported_features():
-    """Return the list of options features supported by the backend.
-
-    Returns a list of strings.
-    The only possible value is 'build_editable'.
-    """
-    backend = _build_backend()
-    features = 
-    if hasattr(backend, "build_editable"):
-        features.append("build_editable")
-    return features
-
-
-def get_requires_for_build_wheel(config_settings):
-    """Invoke the optional get_requires_for_build_wheel hook
-
-    Returns  if the hook is not defined.
-    """
-    backend = _build_backend()
-    try:
-        hook = backend.get_requires_for_build_wheel
-    except AttributeError:
-        return 
-    else:
-        return hook(config_settings)
-
-
-def get_requires_for_build_editable(config_settings):
-    """Invoke the optional get_requires_for_build_editable hook
-
-    Returns  if the hook is not defined.
-    """
-    backend = _build_backend()
-    try:
-        hook = backend.get_requires_for_build_editable
-    except AttributeError:
-        return 
-    else:
-        return hook(config_settings)
-
-
-def prepare_metadata_for_build_wheel(
-        metadata_directory, config_settings, _allow_fallback):
-    """Invoke optional prepare_metadata_for_build_wheel
-
-    Implements a fallback by building a wheel if the hook isn't defined,
-    unless _allow_fallback is False in which case HookMissing is raised.
-    """
-    backend = _build_backend()
-    try:
-        hook = backend.prepare_metadata_for_build_wheel
-    except AttributeError:
-        if not _allow_fallback:
-            raise HookMissing()
-        whl_basename = backend.build_wheel(metadata_directory, config_settings)
-        return _get_wheel_metadata_from_wheel(whl_basename, metadata_directory,
-                                              config_settings)
-    else:
-        return hook(metadata_directory, config_settings)
-
-
-def prepare_metadata_for_build_editable(
-        metadata_directory, config_settings, _allow_fallback):
-    """Invoke optional prepare_metadata_for_build_editable
-
-    Implements a fallback by building an editable wheel if the hook isn't
-    defined, unless _allow_fallback is False in which case HookMissing is
-    raised.
-    """
-    backend = _build_backend()
-    try:
-        hook = backend.prepare_metadata_for_build_editable
-    except AttributeError:
-        if not _allow_fallback:
-            raise HookMissing()
-        try:
-            build_hook = backend.build_editable
-        except AttributeError:
-            raise HookMissing(hook_name='build_editable')
-        else:
-            whl_basename = build_hook(metadata_directory, config_settings)
-            return _get_wheel_metadata_from_wheel(whl_basename,
-                                                  metadata_directory,
-                                                  config_settings)
-    else:
-        return hook(metadata_directory, config_settings)
-
-
-WHEEL_BUILT_MARKER = 'PEP517_ALREADY_BUILT_WHEEL'
-
-
-def _dist_info_files(whl_zip):
-    """Identify the .dist-info folder inside a wheel ZipFile."""
-    res = 
-    for path in whl_zip.namelist():
-        m = re.match(r'^/\\+-^/\\+\.dist-info/', path)
-        if m:
-            res.append(path)
-    if res:
-        return res
-    raise Exception("No .dist-info folder found in wheel")
-
-
-def _get_wheel_metadata_from_wheel(
-        whl_basename, metadata_directory, config_settings):
-    """Extract the metadata from a wheel.
-
-    Fallback for when the build backend does not
-    define the 'get_wheel_metadata' hook.
-    """
-    from zipfile import ZipFile
-    with open(os.path.join(metadata_directory, WHEEL_BUILT_MARKER), 'wb'):
-        pass  # Touch marker file
-
-    whl_file = os.path.join(metadata_directory, whl_basename)
-    with ZipFile(whl_file) as zipf:
-        dist_info = _dist_info_files(zipf)
-        zipf.extractall(path=metadata_directory, members=dist_info)
-    return dist_info0.split('/')0
-
-
-def _find_already_built_wheel(metadata_directory):
-    """Check for a wheel already built during the get_wheel_metadata hook.
-    """
-    if not metadata_directory:
-        return None
-    metadata_parent = os.path.dirname(metadata_directory)
-    if not os.path.isfile(pjoin(metadata_parent, WHEEL_BUILT_MARKER)):
-        return None
-
-    whl_files = glob(os.path.join(metadata_parent, '*.whl'))
-    if not whl_files:
-        print('Found wheel built marker, but no .whl files')
-        return None
-    if len(whl_files) > 1:
-        print('Found multiple .whl files; unspecified behaviour. '
-              'Will call build_wheel.')
-        return None
-
-    # Exactly one .whl file
-    return whl_files0
-
-
-def build_wheel(wheel_directory, config_settings, metadata_directory=None):
-    """Invoke the mandatory build_wheel hook.
-
-    If a wheel was already built in the
-    prepare_metadata_for_build_wheel fallback, this
-    will copy it rather than rebuilding the wheel.
-    """
-    prebuilt_whl = _find_already_built_wheel(metadata_directory)
-    if prebuilt_whl:
-        shutil.copy2(prebuilt_whl, wheel_directory)
-        return os.path.basename(prebuilt_whl)
-
-    return _build_backend().build_wheel(wheel_directory, config_settings,
-                                        metadata_directory)
-
-
-def build_editable(wheel_directory, config_settings, metadata_directory=None):
-    """Invoke the optional build_editable hook.
-
-    If a wheel was already built in the
-    prepare_metadata_for_build_editable fallback, this
-    will copy it rather than rebuilding the wheel.
-    """
-    backend = _build_backend()
-    try:
-        hook = backend.build_editable
-    except AttributeError:
-        raise HookMissing()
-    else:
-        prebuilt_whl = _find_already_built_wheel(metadata_directory)
-        if prebuilt_whl:
-            shutil.copy2(prebuilt_whl, wheel_directory)
-            return os.path.basename(prebuilt_whl)
-
-        return hook(wheel_directory, config_settings, metadata_directory)
-
-
-def get_requires_for_build_sdist(config_settings):
-    """Invoke the optional get_requires_for_build_wheel hook
-
-    Returns  if the hook is not defined.
-    """
-    backend = _build_backend()
-    try:
-        hook = backend.get_requires_for_build_sdist
-    except AttributeError:
-        return 
-    else:
-        return hook(config_settings)
-
-
-class _DummyException(Exception):
-    """Nothing should ever raise this exception"""
-
-
-class GotUnsupportedOperation(Exception):
-    """For internal use when backend raises UnsupportedOperation"""
-    def __init__(self, traceback):
-        self.traceback = traceback
-
-
-def build_sdist(sdist_directory, config_settings):
-    """Invoke the mandatory build_sdist hook."""
-    backend = _build_backend()
-    try:
-        return backend.build_sdist(sdist_directory, config_settings)
-    except getattr(backend, 'UnsupportedOperation', _DummyException):
-        raise GotUnsupportedOperation(traceback.format_exc())
-
-
-HOOK_NAMES = {
-    'get_requires_for_build_wheel',
-    'prepare_metadata_for_build_wheel',
-    'build_wheel',
-    'get_requires_for_build_editable',
-    'prepare_metadata_for_build_editable',
-    'build_editable',
-    'get_requires_for_build_sdist',
-    'build_sdist',
-    '_supported_features',
-}
-
-
-def main():
-    if len(sys.argv) < 3:
-        sys.exit("Needs args: hook_name, control_dir")
-    hook_name = sys.argv1
-    control_dir = sys.argv2
-    if hook_name not in HOOK_NAMES:
-        sys.exit("Unknown hook: %s" % hook_name)
-    hook = globals()hook_name
-
-    hook_input = read_json(pjoin(control_dir, 'input.json'))
-
-    json_out = {'unsupported': False, 'return_val': None}
-    try:
-        json_out'return_val' = hook(**hook_input'kwargs')
-    except BackendUnavailable as e:
-        json_out'no_backend' = True
-        json_out'traceback' = e.traceback
-    except BackendInvalid as e:
-        json_out'backend_invalid' = True
-        json_out'backend_error' = e.message
-    except GotUnsupportedOperation as e:
-        json_out'unsupported' = True
-        json_out'traceback' = e.traceback
-    except HookMissing as e:
-        json_out'hook_missing' = True
-        json_out'missing_hook_name' = e.hook_name or hook_name
-
-    write_json(json_out, pjoin(control_dir, 'output.json'), indent=2)
-
-
-if __name__ == '__main__':
-    main()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/meta.py Deleted

@@ -1,93 +0,0 @@
-"""Build metadata for a project using PEP 517 hooks.
-"""
-import argparse
-import functools
-import logging
-import os
-import shutil
-import tempfile
-
-try:
-    import importlib.metadata as imp_meta
-except ImportError:
-    import importlib_metadata as imp_meta
-
-try:
-    from zipfile import Path
-except ImportError:
-    from zipp import Path
-
-from .build import compat_system, load_system, validate_system
-from .dirtools import dir_to_zipfile
-from .envbuild import BuildEnvironment
-from .wrappers import Pep517HookCaller, quiet_subprocess_runner
-
-log = logging.getLogger(__name__)
-
-
-def _prep_meta(hooks, env, dest):
-    reqs = hooks.get_requires_for_build_wheel({})
-    log.info('Got build requires: %s', reqs)
-
-    env.pip_install(reqs)
-    log.info('Installed dynamic build dependencies')
-
-    with tempfile.TemporaryDirectory() as td:
-        log.info('Trying to build metadata in %s', td)
-        filename = hooks.prepare_metadata_for_build_wheel(td, {})
-        source = os.path.join(td, filename)
-        shutil.move(source, os.path.join(dest, os.path.basename(filename)))
-
-
-def build(source_dir='.', dest=None, system=None):
-    system = system or load_system(source_dir)
-    dest = os.path.join(source_dir, dest or 'dist')
-    os.makedirs(dest, exist_ok=True)
-    validate_system(system)
-    hooks = Pep517HookCaller(
-        source_dir, system'build-backend', system.get('backend-path')
-    )
-
-    with hooks.subprocess_runner(quiet_subprocess_runner):
-        with BuildEnvironment() as env:
-            env.pip_install(system'requires')
-            _prep_meta(hooks, env, dest)
-
-
-def build_as_zip(builder=build):
-    with tempfile.TemporaryDirectory() as out_dir:
-        builder(dest=out_dir)
-        return dir_to_zipfile(out_dir)
-
-
-def load(root):
-    """
-    Given a source directory (root) of a package,
-    return an importlib.metadata.Distribution object
-    with metadata build from that package.
-    """
-    root = os.path.expanduser(root)
-    system = compat_system(root)
-    builder = functools.partial(build, source_dir=root, system=system)
-    path = Path(build_as_zip(builder))
-    return imp_meta.PathDistribution(path)
-
-
-parser = argparse.ArgumentParser()
-parser.add_argument(
-    'source_dir',
-    help="A directory containing pyproject.toml",
-)
-parser.add_argument(
-    '--out-dir', '-o',
-    help="Destination in which to save the builds relative to source dir",
-)
-
-
-def main():
-    args = parser.parse_args()
-    build(args.source_dir, args.out_dir)
-
-
-if __name__ == '__main__':
-    main()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pep517/wrappers.py Deleted

@@ -1,362 +0,0 @@
-import json
-import os
-import sys
-import tempfile
-import threading
-from contextlib import contextmanager
-from os.path import abspath
-from os.path import join as pjoin
-from subprocess import STDOUT, check_call, check_output
-
-from .in_process import _in_proc_script_path
-
-__all__ = 
-    'BackendUnavailable',
-    'BackendInvalid',
-    'HookMissing',
-    'UnsupportedOperation',
-    'default_subprocess_runner',
-    'quiet_subprocess_runner',
-    'Pep517HookCaller',
-
-
-
-def write_json(obj, path, **kwargs):
-    with open(path, 'w', encoding='utf-8') as f:
-        json.dump(obj, f, **kwargs)
-
-
-def read_json(path):
-    with open(path, encoding='utf-8') as f:
-        return json.load(f)
-
-
-class BackendUnavailable(Exception):
-    """Will be raised if the backend cannot be imported in the hook process."""
-    def __init__(self, traceback):
-        self.traceback = traceback
-
-
-class BackendInvalid(Exception):
-    """Will be raised if the backend is invalid."""
-    def __init__(self, backend_name, backend_path, message):
-        self.backend_name = backend_name
-        self.backend_path = backend_path
-        self.message = message
-
-
-class HookMissing(Exception):
-    """Will be raised on missing hooks."""
-    def __init__(self, hook_name):
-        super().__init__(hook_name)
-        self.hook_name = hook_name
-
-
-class UnsupportedOperation(Exception):
-    """May be raised by build_sdist if the backend indicates that it can't."""
-    def __init__(self, traceback):
-        self.traceback = traceback
-
-
-def default_subprocess_runner(cmd, cwd=None, extra_environ=None):
-    """The default method of calling the wrapper subprocess."""
-    env = os.environ.copy()
-    if extra_environ:
-        env.update(extra_environ)
-
-    check_call(cmd, cwd=cwd, env=env)
-
-
-def quiet_subprocess_runner(cmd, cwd=None, extra_environ=None):
-    """A method of calling the wrapper subprocess while suppressing output."""
-    env = os.environ.copy()
-    if extra_environ:
-        env.update(extra_environ)
-
-    check_output(cmd, cwd=cwd, env=env, stderr=STDOUT)
-
-
-def norm_and_check(source_tree, requested):
-    """Normalise and check a backend path.
-
-    Ensure that the requested backend path is specified as a relative path,
-    and resolves to a location under the given source tree.
-
-    Return an absolute version of the requested path.
-    """
-    if os.path.isabs(requested):
-        raise ValueError("paths must be relative")
-
-    abs_source = os.path.abspath(source_tree)
-    abs_requested = os.path.normpath(os.path.join(abs_source, requested))
-    # We have to use commonprefix for Python 2.7 compatibility. So we
-    # normalise case to avoid problems because commonprefix is a character
-    # based comparison :-(
-    norm_source = os.path.normcase(abs_source)
-    norm_requested = os.path.normcase(abs_requested)
-    if os.path.commonprefix(norm_source, norm_requested) != norm_source:
-        raise ValueError("paths must be inside source tree")
-
-    return abs_requested
-
-
-class Pep517HookCaller:
-    """A wrapper around a source directory to be built with a PEP 517 backend.
-
-    :param source_dir: The path to the source directory, containing
-        pyproject.toml.
-    :param build_backend: The build backend spec, as per PEP 517, from
-        pyproject.toml.
-    :param backend_path: The backend path, as per PEP 517, from pyproject.toml.
-    :param runner: A callable that invokes the wrapper subprocess.
-    :param python_executable: The Python executable used to invoke the backend
-
-    The 'runner', if provided, must expect the following:
-
-    - cmd: a list of strings representing the command and arguments to
-      execute, as would be passed to e.g. 'subprocess.check_call'.
-    - cwd: a string representing the working directory that must be
-      used for the subprocess. Corresponds to the provided source_dir.
-    - extra_environ: a dict mapping environment variable names to values
-      which must be set for the subprocess execution.
-    """
-    def __init__(
-            self,
-            source_dir,
-            build_backend,
-            backend_path=None,
-            runner=None,
-            python_executable=None,
-    ):
-        if runner is None:
-            runner = default_subprocess_runner
-
-        self.source_dir = abspath(source_dir)
-        self.build_backend = build_backend
-        if backend_path:
-            backend_path = 
-                norm_and_check(self.source_dir, p) for p in backend_path
-            
-        self.backend_path = backend_path
-        self._subprocess_runner = runner
-        if not python_executable:
-            python_executable = sys.executable
-        self.python_executable = python_executable
-
-    @contextmanager
-    def subprocess_runner(self, runner):
-        """A context manager for temporarily overriding the default subprocess
-        runner.
-        """
-        prev = self._subprocess_runner
-        self._subprocess_runner = runner
-        try:
-            yield
-        finally:
-            self._subprocess_runner = prev
-
-    def _supported_features(self):
-        """Return the list of optional features supported by the backend."""
-        return self._call_hook('_supported_features', {})
-
-    def get_requires_for_build_wheel(self, config_settings=None):
-        """Identify packages required for building a wheel
-
-        Returns a list of dependency specifications, e.g.::
-
-            "wheel >= 0.25", "setuptools"
-
-        This does not include requirements specified in pyproject.toml.
-        It returns the result of calling the equivalently named hook in a
-        subprocess.
-        """
-        return self._call_hook('get_requires_for_build_wheel', {
-            'config_settings': config_settings
-        })
-
-    def prepare_metadata_for_build_wheel(
-            self, metadata_directory, config_settings=None,
-            _allow_fallback=True):
-        """Prepare a ``*.dist-info`` folder with metadata for this project.
-
-        Returns the name of the newly created folder.
-
-        If the build backend defines a hook with this name, it will be called
-        in a subprocess. If not, the backend will be asked to build a wheel,
-        and the dist-info extracted from that (unless _allow_fallback is
-        False).
-        """
-        return self._call_hook('prepare_metadata_for_build_wheel', {
-            'metadata_directory': abspath(metadata_directory),
-            'config_settings': config_settings,
-            '_allow_fallback': _allow_fallback,
-        })
-
-    def build_wheel(
-            self, wheel_directory, config_settings=None,
-            metadata_directory=None):
-        """Build a wheel from this project.
-
-        Returns the name of the newly created file.
-
-        In general, this will call the 'build_wheel' hook in the backend.
-        However, if that was previously called by
-        'prepare_metadata_for_build_wheel', and the same metadata_directory is
-        used, the previously built wheel will be copied to wheel_directory.
-        """
-        if metadata_directory is not None:
-            metadata_directory = abspath(metadata_directory)
-        return self._call_hook('build_wheel', {
-            'wheel_directory': abspath(wheel_directory),
-            'config_settings': config_settings,
-            'metadata_directory': metadata_directory,
-        })
-
-    def get_requires_for_build_editable(self, config_settings=None):
-        """Identify packages required for building an editable wheel
-
-        Returns a list of dependency specifications, e.g.::
-
-            "wheel >= 0.25", "setuptools"
-
-        This does not include requirements specified in pyproject.toml.
-        It returns the result of calling the equivalently named hook in a
-        subprocess.
-        """
-        return self._call_hook('get_requires_for_build_editable', {
-            'config_settings': config_settings
-        })
-
-    def prepare_metadata_for_build_editable(
-            self, metadata_directory, config_settings=None,
-            _allow_fallback=True):
-        """Prepare a ``*.dist-info`` folder with metadata for this project.
-
-        Returns the name of the newly created folder.
-
-        If the build backend defines a hook with this name, it will be called
-        in a subprocess. If not, the backend will be asked to build an editable
-        wheel, and the dist-info extracted from that (unless _allow_fallback is
-        False).
-        """
-        return self._call_hook('prepare_metadata_for_build_editable', {
-            'metadata_directory': abspath(metadata_directory),
-            'config_settings': config_settings,
-            '_allow_fallback': _allow_fallback,
-        })
-
-    def build_editable(
-            self, wheel_directory, config_settings=None,
-            metadata_directory=None):
-        """Build an editable wheel from this project.
-
-        Returns the name of the newly created file.
-
-        In general, this will call the 'build_editable' hook in the backend.
-        However, if that was previously called by
-        'prepare_metadata_for_build_editable', and the same metadata_directory
-        is used, the previously built wheel will be copied to wheel_directory.
-        """
-        if metadata_directory is not None:
-            metadata_directory = abspath(metadata_directory)
-        return self._call_hook('build_editable', {
-            'wheel_directory': abspath(wheel_directory),
-            'config_settings': config_settings,
-            'metadata_directory': metadata_directory,
-        })
-
-    def get_requires_for_build_sdist(self, config_settings=None):
-        """Identify packages required for building a wheel
-
-        Returns a list of dependency specifications, e.g.::
-
-            "setuptools >= 26"
-
-        This does not include requirements specified in pyproject.toml.
-        It returns the result of calling the equivalently named hook in a
-        subprocess.
-        """
-        return self._call_hook('get_requires_for_build_sdist', {
-            'config_settings': config_settings
-        })
-
-    def build_sdist(self, sdist_directory, config_settings=None):
-        """Build an sdist from this project.
-
-        Returns the name of the newly created file.
-
-        This calls the 'build_sdist' backend hook in a subprocess.
-        """
-        return self._call_hook('build_sdist', {
-            'sdist_directory': abspath(sdist_directory),
-            'config_settings': config_settings,
-        })
-
-    def _call_hook(self, hook_name, kwargs):
-        extra_environ = {'PEP517_BUILD_BACKEND': self.build_backend}
-
-        if self.backend_path:
-            backend_path = os.pathsep.join(self.backend_path)
-            extra_environ'PEP517_BACKEND_PATH' = backend_path
-
-        with tempfile.TemporaryDirectory() as td:
-            hook_input = {'kwargs': kwargs}
-            write_json(hook_input, pjoin(td, 'input.json'), indent=2)
-
-            # Run the hook in a subprocess
-            with _in_proc_script_path() as script:
-                python = self.python_executable
-                self._subprocess_runner(
-                    python, abspath(str(script)), hook_name, td,
-                    cwd=self.source_dir,
-                    extra_environ=extra_environ
-                )
-
-            data = read_json(pjoin(td, 'output.json'))
-            if data.get('unsupported'):
-                raise UnsupportedOperation(data.get('traceback', ''))
-            if data.get('no_backend'):
-                raise BackendUnavailable(data.get('traceback', ''))
-            if data.get('backend_invalid'):
-                raise BackendInvalid(
-                    backend_name=self.build_backend,
-                    backend_path=self.backend_path,
-                    message=data.get('backend_error', '')
-                )
-            if data.get('hook_missing'):
-                raise HookMissing(data.get('missing_hook_name') or hook_name)
-            return data'return_val'
-
-
-class LoggerWrapper(threading.Thread):
-    """
-    Read messages from a pipe and redirect them
-    to a logger (see python's logging module).
-    """
-
-    def __init__(self, logger, level):
-        threading.Thread.__init__(self)
-        self.daemon = True
-
-        self.logger = logger
-        self.level = level
-
-        # create the pipe and reader
-        self.fd_read, self.fd_write = os.pipe()
-        self.reader = os.fdopen(self.fd_read)
-
-        self.start()
-
-    def fileno(self):
-        return self.fd_write
-
-    @staticmethod
-    def remove_newline(msg):
-        return msg:-1 if msg.endswith(os.linesep) else msg
-
-    def run(self):
-        for line in self.reader:
-            self._write(self.remove_newline(line))
-
-    def _write(self, message):
-        self.logger.log(self.level, message)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pkg_resources/py31compat.py Deleted

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/LICENSE.txt Deleted

@@ -1,22 +0,0 @@
-# This is the MIT license
-
-Copyright (c) 2010 ActiveState Software Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a
-copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be included
-in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

_service:tar_scm:pip-23.1.2.tar.gz/.gitattributes Added

_service:tar_scm:pip-23.1.2.tar.gz/.github Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/CONTRIBUTING.md Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/FUNDING.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/ISSUE_TEMPLATE Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/ISSUE_TEMPLATE/bug-report.yml Added

@@ -0,0 +1,76 @@
+name: Bug report
+description: Something is not working correctly.
+labels: "S: needs triage, type: bug"
+
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        Hi there!
+
+        We'd appreciate it if you could search on pip's existing issues prior to filing
+        a bug report.
+
+        We get a lot of duplicate tickets and have limited maintainer capacity to triage
+        them. Thanks!
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: >-
+        A clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected behavior
+      description: >-
+        A clear and concise description of what you expected to happen.
+
+  - type: input
+    attributes:
+      label: pip version
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: Python version
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: OS
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: How to Reproduce
+      description: Please provide steps to reproduce this bug.
+      placeholder: |
+        1. Get package from '...'
+        2. Then run '...'
+        3. An error occurs.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Output
+      description: >-
+        Provide the output of the steps above, including the commands
+        themselves and pip's output/traceback etc.
+
+        If you want to present output from multiple commands, please prefix
+        the line containing the command with `$ `. Please also ensure that
+        the "How to reproduce" section contains matching instructions for
+        reproducing this.
+
+  - type: checkboxes
+    attributes:
+      label: Code of Conduct
+      options:
+        - label: >-
+            I agree to follow the PSF Code of Conduct(https://www.python.org/psf/conduct/).
+          required: true

_service:tar_scm:pip-23.1.2.tar.gz/.github/ISSUE_TEMPLATE/config.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/ISSUE_TEMPLATE/feature-request.yml Added

@@ -0,0 +1,59 @@
+name: Feature request
+description: Suggest an idea for this project
+labels: "S: needs triage, type: feature request"
+
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        Hi there!
+
+        We'd appreciate it if you could search on pip's existing issues prior to filing
+        a feature request.
+
+        We get a lot of duplicate tickets and have limited maintainer capacity to triage
+        them. Thanks!
+
+  - type: textarea
+    attributes:
+      label: What's the problem this feature will solve?
+      description: >-
+        What are you trying to do, that you are unable to achieve with pip as it
+        currently stands?
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the solution you'd like
+      description: >-
+        Clear and concise description of what you want to happen. Please use examples
+        of real world use cases that this would help with, and how it solves the
+        problem described above.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Alternative Solutions
+      description: >-
+        Have you tried to workaround the problem using pip or other tools? Or a
+        different approach to solving this issue? Please elaborate here.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Additional context
+      description: >-
+        Add any other context, links, etc. relevant to the feature request.
+    validations:
+      required: true
+
+  - type: checkboxes
+    attributes:
+      label: Code of Conduct
+      options:
+        - label: >-
+            I agree to follow the PSF Code of Conduct(https://www.python.org/psf/conduct/).
+          required: true

_service:tar_scm:pip-23.1.2.tar.gz/.github/PULL_REQUEST_TEMPLATE.md Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/chronographer.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/triage-new-issues.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/workflows Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/workflows/ci.yml Added

@@ -0,0 +1,287 @@
+name: CI
+
+on:
+  push:
+    branches: main
+    tags:
+      # Tags for all potential release numbers till 2030.
+      - "20-9.0-3" # 20.0 -> 29.3
+      - "20-9.0-3.0-9+" # 20.0.0 -> 29.3.0-9+
+  pull_request:
+  schedule:
+    - cron: 0 0 * * MON # Run every Monday at 00:00 UTC
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.sha }}
+  cancel-in-progress: true
+
+jobs:
+  docs:
+    name: docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+      - run: pip install nox
+      - run: nox -s docs
+
+  determine-changes:
+    runs-on: ubuntu-latest
+    outputs:
+      tests: ${{ steps.filter.outputs.tests }}
+      vendoring: ${{ steps.filter.outputs.vendoring }}
+    steps:
+      # For pull requests it's not necessary to checkout the code
+      - uses: dorny/paths-filter@v2
+        id: filter
+        with:
+          filters: |
+            vendoring:
+              # Anything that's touching "vendored code"
+              - "src/pip/_vendor/**"
+              - "pyproject.toml"
+              - "noxfile.py"
+            tests:
+              # Anything that's touching code-related stuff
+              - ".github/workflows/ci.yml"
+              - "src/**"
+              - "tests/**"
+              - "noxfile.py"
+        if: github.event_name == 'pull_request'
+
+  packaging:
+    name: packaging
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+      - name: Set up git credentials
+        run: |
+          git config --global user.email "pypa-dev@googlegroups.com"
+          git config --global user.name "pip"
+
+      - run: pip install nox
+      - run: nox -s prepare-release -- 99.9
+      - run: nox -s build-release -- 99.9
+      - run: pipx run check-manifest
+
+  vendoring:
+    name: vendoring
+    runs-on: ubuntu-latest
+
+    needs: determine-changes
+    if: >-
+      needs.determine-changes.outputs.vendoring == 'true' ||
+      github.event_name != 'pull_request'
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+
+      - run: pip install nox
+      - run: nox -s vendoring
+      - run: git diff --exit-code
+
+  tests-unix:
+    name: tests / ${{ matrix.python }} / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}-latest
+
+    needs: packaging, determine-changes
+    if: >-
+      needs.determine-changes.outputs.tests == 'true' ||
+      github.event_name != 'pull_request'
+
+    strategy:
+      fail-fast: true
+      matrix:
+        os: Ubuntu, MacOS
+        python:
+          - "3.7"
+          - "3.8"
+          - "3.9"
+          - "3.10"
+          - "3.11"
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install Ubuntu dependencies
+        if: matrix.os == 'Ubuntu'
+        run: sudo apt-get install bzr
+
+      - name: Install MacOS dependencies
+        if: matrix.os == 'MacOS'
+        run: brew install breezy
+
+      - run: pip install nox
+
+      # Main check
+      - name: Run unit tests
+        run: >-
+          nox -s test-${{ matrix.python }} --
+          -m unit
+          --verbose --numprocesses auto --showlocals
+      - name: Run integration tests
+        run: >-
+          nox -s test-${{ matrix.python }} --
+          -m integration
+          --verbose --numprocesses auto --showlocals
+          --durations=5
+
+  tests-windows:
+    name: tests / ${{ matrix.python }} / ${{ matrix.os }} / ${{ matrix.group }}
+    runs-on: ${{ matrix.os }}-latest
+
+    needs: packaging, determine-changes
+    if: >-
+      needs.determine-changes.outputs.tests == 'true' ||
+      github.event_name != 'pull_request'
+
+    strategy:
+      fail-fast: true
+      matrix:
+        os: Windows
+        python:
+          - "3.7"
+          # Commented out, since Windows tests are expensively slow.
+          # - "3.8"
+          # - "3.9"
+          # - "3.10"
+          - "3.11"
+        group: 1, 2
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python }}
+
+      # We use a RAMDisk on Windows, since filesystem IO is a big slowdown
+      # for our tests.
+      - name: Create a RAMDisk
+        run: ./tools/ci/New-RAMDisk.ps1 -Drive R -Size 1GB
+
+      - name: Setup RAMDisk permissions
+        run: |
+          mkdir R:\Temp
+          $acl = Get-Acl "R:\Temp"
+          $rule = New-Object System.Security.AccessControl.FileSystemAccessRule(
+              "Everyone", "FullControl", "ContainerInherit,ObjectInherit", "None", "Allow"
+          )
+          $acl.AddAccessRule($rule)
+          Set-Acl "R:\Temp" $acl
+
+      - run: pip install nox
+        env:
+          TEMP: "R:\\Temp"
+
+      # Main check
+      - name: Run unit tests
+        if: matrix.group == 1
+        run: >-
+          nox -s test-${{ matrix.python }} --
+          -m unit
+          --verbose --numprocesses auto --showlocals
+        env:
+          TEMP: "R:\\Temp"
+
+      - name: Run integration tests (group 1)
+        if: matrix.group == 1
+        run: >-
+          nox -s test-${{ matrix.python }} --
+          -m integration -k "not test_install"
+          --verbose --numprocesses auto --showlocals
+        env:
+          TEMP: "R:\\Temp"
+
+      - name: Run integration tests (group 2)
+        if: matrix.group == 2
+        run: >-
+          nox -s test-${{ matrix.python }} --
+          -m integration -k "test_install"
+          --verbose --numprocesses auto --showlocals
+        env:
+          TEMP: "R:\\Temp"
+
+  tests-zipapp:
+    name: tests / zipapp
+    runs-on: ubuntu-latest
+
+    needs: packaging, determine-changes
+    if: >-
+      needs.determine-changes.outputs.tests == 'true' ||
+      github.event_name != 'pull_request'
+
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+
+      - name: Install Ubuntu dependencies
+        run: sudo apt-get install bzr
+
+      - run: pip install nox 'virtualenv<20' 'setuptools != 60.6.0'
+
+      # Main check
+      - name: Run integration tests
+        run: >-
+          nox -s test-3.10 --
+          -m integration
+          --verbose --numprocesses auto --showlocals
+          --durations=5
+          --use-zipapp
+
+  check:  # This job does nothing and is only used for the branch protection
+    if: always()
+
+    needs:
+      - determine-changes
+      - docs
+      - packaging
+      - tests-unix
+      - tests-windows
+      - tests-zipapp
+      - vendoring
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Decide whether the needed jobs succeeded or failed
+        uses: re-actors/alls-green@release/v1
+        with:
+          allowed-skips: >-
+            ${{
+              (
+                needs.determine-changes.outputs.vendoring != 'true'
+                && github.event_name == 'pull_request'
+              )
+              && 'vendoring'
+              || ''
+            }}
+            ,
+            ${{
+              (
+                needs.determine-changes.outputs.tests != 'true'
+                && github.event_name == 'pull_request'
+              )
+              && '
+                tests-unix,
+                tests-windows,
+                tests-zipapp,
+                tests-importlib-metadata,
+              '
+              || ''
+            }}
+          jobs: ${{ toJSON(needs) }}

_service:tar_scm:pip-23.1.2.tar.gz/.github/workflows/lock-threads.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/workflows/news-file.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/workflows/no-response.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.github/workflows/update-rtd-redirects.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.gitignore Added

_service:tar_scm:pip-23.1.2.tar.gz/.mailmap Added

@@ -0,0 +1,51 @@
+Adam Wentz                                                  <awentz@theonion.com>
+Alethea Flowers     <magicalgirl@google.com>       <jjramone13@gmail.com>
+Alethea Flowers     <magicalgirl@google.com>       Thea Flowers <theaflowers@google.com>
+Alex Grönholm                                               <alex.gronholm@nextday.fi>
+Alex Grönholm       <alex.gronholm@nextday.fi>              <alex.gronholm+git@nextday.fi>
+Anatoly Techtonik                                           <techtonik@gmail.com>
+Andrey Bulgakov                                             <mail@andreiko.ru>
+                    <mail@andreiko.ru>                      <bulgakov@tranio.ru>
+Andrei Geacar       <andrei.geacar@gmail.com>      unknown  <hakaton@Anam-mbl.(none)>
+Anish Tambe         <anish.tambe@yahoo.in>                  <anish.tambe@yahoo.co.in>
+Bartek Ogryczak     <b.ogryczak@gmail.com>                  <bartek@eventbrite.com>
+Ben Rosser                                                  <rosser.bjr@gmail.com>
+                    <bradley.ayers@gmail.com>               <bradley.ayers@enigmainteractive.com>
+                    <carl@oddbird.net>                      <carl@dirtcircle.com>
+Daniel Holth                                                <dholth@fastmail.fm>
+David Black                                                 <db@d1b.org>
+                    <donald@stufft.io>                      <donald.stufft@gmail.com>
+Dongweiming         <dongweiming@admaster.com.cn>           <ciici1234@hotmail.com>
+Dustin Ingram       <di@di.codes>                           <di@users.noreply.github.com>
+Endoh Takanao                                               <djmchl@gmail.com>
+Erik M. Bray                                                <embray@stsci.edu>
+Ee Durbin                                                   <ewdurbin@gmail.com>
+Gabriel de Perthuis                                         <g2p.code@gmail.com>
+Hsiaoming Yang                                              <lepture@me.com>
+Hugo van Kemenade   <hugovk@users.noreply.github.com>   Hugo <hugovk@users.noreply.github.com>
+Hugo van Kemenade   <hugovk@users.noreply.github.com>   hugovk <hugovk@users.noreply.github.com>
+Igor Kuzmitshov     <kuzmiigo@gmail.com>                    <igor@qubit.com>
+Ilya Baryshev                                               <baryshev@gmail.com>
+Jakub Stasiak                                               <kuba.stasiak@gmail.com>
+John-Scott Atlakson                                         <john.scott.atlakson@gmail.com>
+Jorge Niedbalski                                            <niedbalski@gmail.com>
+                    <niedbalski@gmail.com>                  <jorge@nimbic.com>
+Ludovic Gasc        <gmludo@gmail.com>                      <git@gmludo.eu>
+Markus Hametner                                             <fin+github@xbhd.org>
+Masklinn                                                    <bitbucket.org@masklinn.net>
+Matthew Iversen     <teh.ivo@gmail.com>                     <teh.ivo@gmail.com>
+Ofek Lev                                                    <ofekmeister@gmail.com>
+Pi Delport                                                  <pjdelport@gmail.com>
+                    <pnasrat@gmail.com>                     <pnasrat@googlemail.com>
+Pradyun Gedam       <pradyunsg@gmail.com>                   <pradyunsg@users.noreply.github.com>
+Pradyun Gedam       <pradyunsg@gmail.com>
+Preston Holmes                                              <preston@ptone.com>
+Przemek Wrzos                                               <hetmankp@none>
+                    <hodgestar@gmail.com>                   <hodgestar+hg@gmail.com>
+Romuald Brunet      <romuald@chivil.com>                    <romuald@gandi.net>
+Thomas Johansson    <devnull@localhost>            prencher <devnull@localhost>
+Thomas Kluyver      <thomas@kluyver.me.uk>                  <takowl@gmail.com>
+Stephan Erb         <github@stephanerb.eu>                  <stephan@dev.static-void.de>
+Victor Stinner      <victor.stinner@gmail.com>              <vstinner@redhat.com>
+Yoval P                                                     <yoval@gmx.com>
+Zhiping Deng                                                <kofreestyler@gmail.com>

_service:tar_scm:pip-23.1.2.tar.gz/.pre-commit-config.yaml Added

@@ -0,0 +1,80 @@
+exclude: 'src/pip/_vendor/'
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v4.4.0
+  hooks:
+  - id: check-builtin-literals
+  - id: check-added-large-files
+  - id: check-case-conflict
+  - id: check-toml
+  - id: check-yaml
+  - id: debug-statements
+  - id: end-of-file-fixer
+    exclude: WHEEL
+  - id: forbid-new-submodules
+  - id: trailing-whitespace
+    exclude: .patch
+
+- repo: https://github.com/psf/black
+  rev: 23.1.0
+  hooks:
+  - id: black
+
+- repo: https://github.com/PyCQA/flake8
+  rev: 6.0.0
+  hooks:
+  - id: flake8
+    additional_dependencies: 
+        'flake8-bugbear',
+        'flake8-logging-format',
+        'flake8-implicit-str-concat',
+    
+    exclude: tests/data
+
+- repo: https://github.com/PyCQA/isort
+  rev: 5.12.0
+  hooks:
+  - id: isort
+    files: \.py$
+
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v0.961
+  hooks:
+  - id: mypy
+    exclude: tests/data
+    args: "--pretty", "--show-error-codes"
+    additional_dependencies: 
+        'keyring==23.0.1',
+        'nox==2021.6.12',
+        'pytest',
+        'types-docutils==0.18.3',
+        'types-setuptools==57.4.14',
+        'types-freezegun==1.1.9',
+        'types-six==1.16.15',
+        'types-pyyaml==6.0.12.2',
+    
+
+- repo: https://github.com/pre-commit/pygrep-hooks
+  rev: v1.10.0
+  hooks:
+  - id: python-no-log-warn
+  - id: python-no-eval
+  - id: rst-backticks
+    files: .*\.rst$
+    types: file
+    exclude: NEWS.rst  # The errors flagged in NEWS.rst are old.
+
+- repo: local
+  hooks:
+  - id: news-fragment-filenames
+    name: NEWS fragment
+    language: fail
+    entry: NEWS fragment files must be named *.(process|removal|feature|bugfix|vendor|doc|trivial).rst
+    exclude: ^news/(.gitignore|.*\.(process|removal|feature|bugfix|vendor|doc|trivial).rst)
+    files: ^news/
+
+ci:
+  autofix_prs: false
+  autoupdate_commit_msg: 'pre-commit autoupdate'
+  autoupdate_schedule: monthly

_service:tar_scm:pip-23.1.2.tar.gz/.readthedocs-custom-redirects.yml Added

_service:tar_scm:pip-23.1.2.tar.gz/.readthedocs.yml Added

_service:tar_scm:pip-22.3.1.tar.gz/AUTHORS.txt -> _service:tar_scm:pip-23.1.2.tar.gz/AUTHORS.txt Changed

@@ -128,6 +128,7 @@
 Chris Jerdonek
 Chris McDonough
 Chris Pawley
+Chris Pryer
 Chris Wolfe
 Christian Clauss
 Christian Heimes
@@ -142,6 +143,7 @@
 Cody
 Cody Soyland
 Colin Watson
+Collin Anderson
 Connor Osborn
 Cooper Lees
 Cooper Ry Lees
@@ -169,7 +171,9 @@
 Daniel Katz
 Daniel Shaulov
 Daniele Esposti
+Daniele Nicolodi
 Daniele Procida
+Daniil Konovalenko
 Danny Hermes
 Danny McClanahan
 Darren Kavanagh
@@ -200,6 +204,7 @@
 Diego Ramirez
 DiegoCaraballo
 Dimitri Merejkowsky
+Dimitri Papadopoulos
 Dirk Stolle
 Dmitry Gladkov
 Dmitry Volodin
@@ -207,6 +212,8 @@
 Dominic Davis-Foster
 Donald Stufft
 Dongweiming
+doron zarhi
+Dos Moonen
 Douglas Thor
 DrFeathers
 Dustin Ingram
@@ -269,6 +276,7 @@
 Greg Roodt
 Greg Ward
 Guilherme Espada
+Guillaume Seguin
 gutsytechster
 Guy Rozendorn
 Guy Tuval
@@ -282,6 +290,8 @@
 Henrich Hartzer
 Henry Schreiner
 Herbert Pfennig
+Holly Stotelmyer
+Honnix
 Hsiaoming Yang
 Hugo Lopes Tavares
 Hugo van Kemenade
@@ -305,6 +315,7 @@
 Jacob Walls
 Jaime Sanz
 jakirkham
+Jakub Kuczys
 Jakub Stasiak
 Jakub Vysoky
 Jakub Wilk
@@ -317,6 +328,7 @@
 Jannis Leidel
 Jarek Potiuk
 jarondl
+Jason Curtis
 Jason R. Coombs
 Jay Graves
 Jean-Christophe Fillion-Robin
@@ -342,6 +354,7 @@
 Jon Parise
 Jonas Nockert
 Jonathan Herbert
+Joonatan Partanen
 Joost Molenaar
 Jorge Niedbalski
 Joseph Bylund
@@ -349,7 +362,9 @@
 Josh Bronson
 Josh Hansen
 Josh Schneier
+Juan Luis Cano Rodríguez
 Juanjo Bazán
+Judah Rand
 Julian Berman
 Julian Gethmann
 Julien Demoor
@@ -389,6 +404,7 @@
 Lev Givon
 Lincoln de Sousa
 Lipis
+lorddavidiii
 Loren Carvalho
 Lucas Cimon
 Ludovic Gasc
@@ -422,6 +438,7 @@
 Matt Robenolt
 matthew
 Matthew Einhorn
+Matthew Feickert
 Matthew Gilliard
 Matthew Iversen
 Matthew Trumbell
@@ -441,6 +458,7 @@
 Michael Aquilina
 Michael E. Karpeles
 Michael Klich
+Michael Mintz
 Michael Williamson
 michaelpacer
 Michał Górny
@@ -455,6 +473,7 @@
 Monica Baluna
 montefra
 Monty Taylor
+Muha Ajjan‮
 Nadav Wexler
 Nahuel Ambrosini
 Nate Coraor
@@ -471,6 +490,7 @@
 Nicolas Bock
 Nicole Harris
 Nikhil Benesch
+Nikhil Ladha
 Nikita Chepanov
 Nikolay Korolev
 Nipunn Koorapati
@@ -484,6 +504,7 @@
 OBITORASU
 Ofek Lev
 ofrinevo
+Oliver Freund
 Oliver Jeeves
 Oliver Mannion
 Oliver Tonnhofer
@@ -527,6 +548,7 @@
 Philippe Ombredanne
 Pi Delport
 Pierre-Yves Rofes
+Pieter Degroote
 pip
 Prabakaran Kumaresshan
 Prabhjyotsing Surjit Singh Sodhi
@@ -534,6 +556,7 @@
 Pradyun Gedam
 Prashant Sharma
 Pratik Mallya
+pre-commit-cibot
 Preet Thakkar
 Preston Holmes
 Przemek Wrzos
@@ -555,6 +578,7 @@
 Richard Jones
 Richard Si
 Ricky Ng-Adam
+Rishi
 RobberPhex
 Robert Collins
 Robert McGibbon
@@ -563,6 +587,7 @@
 Roey Berman
 Rohan Jain
 Roman Bogorodskiy
+Roman Donchenko
 Romuald Brunet
 ronaudinho
 Ronny Pfannschmidt
@@ -571,6 +596,7 @@
 Roy Wellington Ⅳ
 Ruairidh MacLeod
 Russell Keith-Magee
+Ryan Shepherd
 Ryan Wooden
 ryneeverett
 Sachi King
@@ -605,6 +631,7 @@
 Stefan Scherfke
 Stefano Rivera
 Stephan Erb
+Stephen Rosen
 stepshal
 Steve (Gadget) Barnes
 Steve Barnes
@@ -638,12 +665,14 @@
 Tim Heap
 tim smith
 tinruufu
+Tobias Hermann
 Tom Forbes
 Tom Freudenheim
 Tom V
 Tomas Hrnciar
 Tomas Orsava
 Tomer Chachamu
+Tommi Enenkel | AnB
 Tomáš Hrnčiar
 Tony Beswick
 Tony Narlock
@@ -670,8 +699,10 @@
 W. Trevor King
 Wil Tan
 Wilfred Hughes
+William Edwards
 William ML Leslie
 William T Olson
+William Woodruff
 Wilson Mo
 wim glenn
 Winson Luk

_service:tar_scm:pip-22.3.1.tar.gz/MANIFEST.in -> _service:tar_scm:pip-23.1.2.tar.gz/MANIFEST.in Changed

_service:tar_scm:pip-22.3.1.tar.gz/NEWS.rst -> _service:tar_scm:pip-23.1.2.tar.gz/NEWS.rst Changed

@@ -9,6 +9,203 @@
 
 .. towncrier release notes start
 
+23.1.2 (2023-04-26)
+===================
+
+Vendored Libraries
+------------------
+
+- Upgrade setuptools to 67.7.2
+
+
+23.1.1 (2023-04-22)
+===================
+
+Bug Fixes
+---------
+
+- Revert `#11487 <https://github.com/pypa/pip/pull/11487>`_, as it causes issues with virtualenvs created by the Windows Store distribution of Python. (`#11987 <https://github.com/pypa/pip/issues/11987>`_)
+
+Vendored Libraries
+------------------
+
+- Revert pkg_resources (via setuptools) back to 65.6.3
+
+Improved Documentation
+----------------------
+
+- Update documentation to reflect the new behavior of using the cache of locally
+  built wheels in hash-checking mode. (`#11967 <https://github.com/pypa/pip/issues/11967>`_)
+
+
+23.1 (2023-04-15)
+=================
+
+Deprecations and Removals
+-------------------------
+
+- Remove support for the deprecated ``--install-options``. (`#11358 <https://github.com/pypa/pip/issues/11358>`_)
+- ``--no-binary`` does not imply ``setup.py install`` anymore. Instead a wheel will be
+  built locally and installed. (`#11451 <https://github.com/pypa/pip/issues/11451>`_)
+- ``--no-binary`` does not disable the cache of locally built wheels anymore. It only
+  means "don't download wheels". (`#11453 <https://github.com/pypa/pip/issues/11453>`_)
+- Deprecate ``--build-option`` and ``--global-option``. Users are invited to switch to
+  ``--config-settings``. (`#11859 <https://github.com/pypa/pip/issues/11859>`_)
+- Using ``--config-settings`` with projects that don't have a ``pyproject.toml`` now prints
+  a deprecation warning. In the future the presence of config settings will automatically
+  enable the default build backend for legacy projects and pass the setttings to it. (`#11915 <https://github.com/pypa/pip/issues/11915>`_)
+- Remove ``setup.py install`` fallback when building a wheel failed for projects without
+  ``pyproject.toml``. (`#8368 <https://github.com/pypa/pip/issues/8368>`_)
+- When the ``wheel`` package is not installed, pip now uses the default build backend
+  instead of ``setup.py install`` and ``setup.py develop`` for project without
+  ``pyproject.toml``. (`#8559 <https://github.com/pypa/pip/issues/8559>`_)
+
+Features
+--------
+
+- Specify egg-link location in assertion message when it does not match installed location to provide better error message for debugging. (`#10476 <https://github.com/pypa/pip/issues/10476>`_)
+- Present conflict information during installation after each choice that is rejected (pass ``-vv`` to ``pip install`` to show it) (`#10937 <https://github.com/pypa/pip/issues/10937>`_)
+- Display dependency chain on each Collecting/Processing log line. (`#11169 <https://github.com/pypa/pip/issues/11169>`_)
+- Support a per-requirement ``--config-settings`` option in requirements files. (`#11325 <https://github.com/pypa/pip/issues/11325>`_)
+- The ``--config-settings``/``-C`` option now supports using the same key multiple
+  times. When the same key is specified multiple times, all values are passed to
+  the build backend as a list, as opposed to the previous behavior, where pip would
+  only pass the last value if the same key was used multiple times. (`#11681 <https://github.com/pypa/pip/issues/11681>`_)
+- Add ``-C`` as a short version of the ``--config-settings`` option. (`#11786 <https://github.com/pypa/pip/issues/11786>`_)
+- Reduce the number of resolver rounds, since backjumping makes the resolver more efficient in finding solutions. This also makes pathological cases fail quicker. (`#11908 <https://github.com/pypa/pip/issues/11908>`_)
+- Warn if ``--hash`` is used on a line without requirement in a requirements file. (`#11935 <https://github.com/pypa/pip/issues/11935>`_)
+- Stop propagating CLI ``--config-settings`` to the build dependencies. They already did
+  not propagate to requirements provided in requirement files. To pass the same config
+  settings to several requirements, users should provide the requirements as CLI
+  arguments. (`#11941 <https://github.com/pypa/pip/issues/11941>`_)
+- Support wheel cache when using ``--require-hashes``. (`#5037 <https://github.com/pypa/pip/issues/5037>`_)
+- Add ``--keyring-provider`` flag. See the Authentication page in the documentation for more info. (`#8719 <https://github.com/pypa/pip/issues/8719>`_)
+- In the case of virtual environments, configuration files are now also included from the base installation. (`#9752 <https://github.com/pypa/pip/issues/9752>`_)
+
+Bug Fixes
+---------
+
+- Fix grammar by changing "A new release of pip available:" to "A new release of pip is available:" in the notice used for indicating that. (`#11529 <https://github.com/pypa/pip/issues/11529>`_)
+- Normalize paths before checking if installed scripts are on PATH. (`#11719 <https://github.com/pypa/pip/issues/11719>`_)
+- Correct the way to decide if keyring is available. (`#11774 <https://github.com/pypa/pip/issues/11774>`_)
+- More consistent resolution backtracking by removing legacy hack related to setuptools resolution (`#11837 <https://github.com/pypa/pip/issues/11837>`_)
+- Include ``AUTHORS.txt`` in pip's wheels. (`#11882 <https://github.com/pypa/pip/issues/11882>`_)
+- The ``uninstall`` and ``install --force-reinstall`` commands no longer call
+  ``normalize_path()`` repeatedly on the same paths. Instead, these results are
+  cached for the duration of an uninstall operation, resulting in improved
+  performance, particularly on Windows. (`#11889 <https://github.com/pypa/pip/issues/11889>`_)
+- Fix and improve the parsing of hashes embedded in URL fragments. (`#11936 <https://github.com/pypa/pip/issues/11936>`_)
+- When package A depends on package B provided as a direct URL dependency including a hash
+  embedded in the link, the ``--require-hashes`` option did not warn when user supplied hashes
+  were missing for package B. (`#11938 <https://github.com/pypa/pip/issues/11938>`_)
+- Correctly report ``requested_extras`` in the installation report when extras are
+  specified for a local directory installation. (`#11946 <https://github.com/pypa/pip/issues/11946>`_)
+- When installing an archive from a direct URL or local file, populate
+  ``download_info.info.hashes`` in the installation report, in addition to the legacy
+  ``download_info.info.hash`` key. (`#11948 <https://github.com/pypa/pip/issues/11948>`_)
+
+Vendored Libraries
+------------------
+
+- Upgrade msgpack to 1.0.5
+- Patch pkg_resources to remove dependency on ``jaraco.text``.
+- Upgrade platformdirs to 3.2.0
+- Upgrade pygments to 2.14.0
+- Upgrade resolvelib to 1.0.1
+- Upgrade rich to 13.3.3
+- Upgrade setuptools to 67.6.1
+- Upgrade tenacity to 8.2.2
+- Upgrade typing_extensions to 4.5.0
+- Upgrade urllib3 to 1.26.15
+
+Improved Documentation
+----------------------
+
+- Cross-reference the ``--python`` flag from the ``--prefix`` flag,
+  and mention limitations of ``--prefix`` regarding script installation. (`#11775 <https://github.com/pypa/pip/issues/11775>`_)
+- Add SECURITY.md to make the policy offical. (`#11809 <https://github.com/pypa/pip/issues/11809>`_)
+- Add username to Git over SSH example. (`#11838 <https://github.com/pypa/pip/issues/11838>`_)
+- Quote extras in the pip install docs to guard shells with default glob
+  qualifiers, like zsh. (`#11842 <https://github.com/pypa/pip/issues/11842>`_)
+- Make it clear that requirements/constraints file can be a URL (`#11954 <https://github.com/pypa/pip/issues/11954>`_)
+
+
+23.0.1 (2023-02-17)
+===================
+
+Features
+--------
+
+- Ignore PIP_REQUIRE_VIRTUALENV for ``pip index`` (`#11671 <https://github.com/pypa/pip/issues/11671>`_)
+- Implement ``--break-system-packages`` to permit installing packages into
+  ``EXTERNALLY-MANAGED`` Python installations. (`#11780 <https://github.com/pypa/pip/issues/11780>`_)
+
+Bug Fixes
+---------
+
+- Improve handling of isolated build environments on platforms that
+  customize the Python's installation schemes, such as Debian and
+  Homebrew. (`#11740 <https://github.com/pypa/pip/issues/11740>`_)
+- Do not crash in presence of misformatted hash field in ``direct_url.json``. (`#11773 <https://github.com/pypa/pip/issues/11773>`_)
+
+
+23.0 (2023-01-30)
+=================
+
+Features
+--------
+
+- Change the hashes in the installation report to be a mapping. Emit the
+  ``archive_info.hashes`` dictionary in ``direct_url.json``. (`#11312 <https://github.com/pypa/pip/issues/11312>`_)
+- Implement logic to read the ``EXTERNALLY-MANAGED`` file as specified in PEP 668.
+  This allows a downstream Python distributor to prevent users from using pip to
+  modify the externally managed environment. (`#11381 <https://github.com/pypa/pip/issues/11381>`_)
+- Enable the use of ``keyring`` found on ``PATH``. This allows ``keyring``
+  installed using ``pipx`` to be used by ``pip``. (`#11589 <https://github.com/pypa/pip/issues/11589>`_)
+- The inspect and installation report formats are now declared stable, and their version
+  has been bumped from ``0`` to ``1``. (`#11757 <https://github.com/pypa/pip/issues/11757>`_)
+
+Bug Fixes
+---------
+
+- Wheel cache behavior is restored to match previous versions, allowing the
+  cache to find existing entries. (`#11527 <https://github.com/pypa/pip/issues/11527>`_)
+- Use the "venv" scheme if available to obtain prefixed lib paths. (`#11598 <https://github.com/pypa/pip/issues/11598>`_)
+- Deprecated a historical ambiguity in how ``egg`` fragments in URL-style
+  requirements are formatted and handled. ``egg`` fragments that do not look
+  like PEP 508 names now produce a deprecation warning. (`#11617 <https://github.com/pypa/pip/issues/11617>`_)
+- Fix scripts path in isolated build environment on Debian. (`#11623 <https://github.com/pypa/pip/issues/11623>`_)
+- Make ``pip show`` show the editable location if package is editable (`#11638 <https://github.com/pypa/pip/issues/11638>`_)
+- Stop checking that ``wheel`` is present when ``build-system.requires``
+  is provided without ``build-system.build-backend`` as ``setuptools``
+  (which we still check for) will inject it anyway. (`#11673 <https://github.com/pypa/pip/issues/11673>`_)
+- Fix an issue when an already existing in-memory distribution would cause
+  exceptions in ``pip install`` (`#11704 <https://github.com/pypa/pip/issues/11704>`_)
+
+Vendored Libraries
+------------------
+
+- Upgrade certifi to 2022.12.7
+- Upgrade chardet to 5.1.0
+- Upgrade colorama to 0.4.6
+- Upgrade distro to 1.8.0
+- Remove pep517 from vendored packages
+- Upgrade platformdirs to 2.6.2
+- Add pyproject-hooks 1.0.0
+- Upgrade requests to 2.28.2
+- Upgrade rich to 12.6.0
+- Upgrade urllib3 to 1.26.14
+
+Improved Documentation
+----------------------
+
+- Fixed the description of the option "--install-options" in the documentation (`#10265 <https://github.com/pypa/pip/issues/10265>`_)
+- Remove mention that editable installs are necessary for pip freeze to report the VCS
+  URL. (`#11675 <https://github.com/pypa/pip/issues/11675>`_)
+- Clarify that the egg URL fragment is only necessary for editable VCS installs, and
+  otherwise not necessary anymore. (`#11676 <https://github.com/pypa/pip/issues/11676>`_)
+
+
 22.3.1 (2022-11-05)
 ===================
 
@@ -55,7 +252,7 @@
 - Ensure that the candidate ``pip`` executable exists, when checking for a new version of pip. (`#11309 <https://github.com/pypa/pip/issues/11309>`_)
 - Ignore distributions with invalid ``Name`` in metadata instead of crashing, when
   using the ``importlib.metadata`` backend. (`#11352 <https://github.com/pypa/pip/issues/11352>`_)
-- Raise RequirementsFileParseError when parsing malformed requirements options that can't be sucessfully parsed by shlex. (`#11491 <https://github.com/pypa/pip/issues/11491>`_)
+- Raise RequirementsFileParseError when parsing malformed requirements options that can't be successfully parsed by shlex. (`#11491 <https://github.com/pypa/pip/issues/11491>`_)
 - Fix build environment isolation on some system Pythons. (`#6264 <https://github.com/pypa/pip/issues/6264>`_)
 
 Vendored Libraries

_service:tar_scm:pip-23.1.2.tar.gz/SECURITY.md Added

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/cli/pip_download.rst -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/cli/pip_download.rst Changed

@@ -81,7 +81,7 @@
 
 #. Download a package and all of its dependencies with OSX specific interpreter constraints.
    This forces OSX 10.10 or lower compatibility. Since OSX deps are forward compatible,
-   this will also match ``macosx-10_9_x86_64``, ``macosx-10_8_x86_64``, ``macosx-10_8_intel``,
+   this will also match ``macosx_10_9_x86_64``, ``macosx_10_8_x86_64``, ``macosx_10_8_intel``,
    etc.
    It will also match deps with platform ``any``. Also force the interpreter version to ``27``
    (or more generic, i.e. ``2``) and implementation to ``cp`` (or more generic, i.e. ``py``).
@@ -92,7 +92,7 @@
 
          python -m pip download \
             --only-binary=:all: \
-            --platform macosx-10_10_x86_64 \
+            --platform macosx_10_10_x86_64 \
             --python-version 27 \
             --implementation cp \
             SomePackage
@@ -103,7 +103,7 @@
 
          py -m pip download ^
             --only-binary=:all: ^
-            --platform macosx-10_10_x86_64 ^
+            --platform macosx_10_10_x86_64 ^
             --python-version 27 ^
             --implementation cp ^
             SomePackage

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/cli/pip_install.rst -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/cli/pip_install.rst Changed

@@ -11,7 +11,7 @@
 
 .. tab:: Unix/macOS
 
-   .. pip-command-usage:: install "python -m pip"
+   .. pip-command-usage:: install 'python -m pip'
 
 .. tab:: Windows
 
@@ -277,7 +277,7 @@
       .. code-block:: shell
 
          python -m pip install SomePackage            # latest version
-         python -m pip install SomePackage==1.0.4     # specific version
+         python -m pip install 'SomePackage==1.0.4'   # specific version
          python -m pip install 'SomePackage>=1.0.4'   # minimum version
 
    .. tab:: Windows
@@ -285,8 +285,8 @@
       .. code-block:: shell
 
          py -m pip install SomePackage            # latest version
-         py -m pip install SomePackage==1.0.4     # specific version
-         py -m pip install 'SomePackage>=1.0.4'   # minimum version
+         py -m pip install "SomePackage==1.0.4"   # specific version
+         py -m pip install "SomePackage>=1.0.4"   # minimum version
 
 
 #. Install a list of requirements specified in a file.  See the :ref:`Requirements files <Requirements Files>`.
@@ -349,13 +349,13 @@
 
       .. code-block:: shell
 
-         python -m pip install SomeProject@git+https://git.repo/some_pkg.git@1.3.1
+         python -m pip install 'SomeProject@git+https://git.repo/some_pkg.git@1.3.1'
 
    .. tab:: Windows
 
       .. code-block:: shell
 
-         py -m pip install SomeProject@git+https://git.repo/some_pkg.git@1.3.1
+         py -m pip install "SomeProject@git+https://git.repo/some_pkg.git@1.3.1"
 
 
 #. Install a project from VCS in "editable" mode. See the sections on :doc:`../topics/vcs-support` and :ref:`Editable Installs <editable-installs>`.
@@ -364,20 +364,20 @@
 
       .. code-block:: shell
 
-         python -m pip install -e git+https://git.repo/some_pkg.git#egg=SomePackage          # from git
-         python -m pip install -e hg+https://hg.repo/some_pkg.git#egg=SomePackage            # from mercurial
-         python -m pip install -e svn+svn://svn.repo/some_pkg/trunk/#egg=SomePackage         # from svn
-         python -m pip install -e git+https://git.repo/some_pkg.git@feature#egg=SomePackage  # from 'feature' branch
-         python -m pip install -e "git+https://git.repo/some_repo.git#egg=subdir&subdirectory=subdir_path" # install a python package from a repo subdirectory
+         python -m pip install -e 'git+https://git.repo/some_pkg.git#egg=SomePackage'          # from git
+         python -m pip install -e 'hg+https://hg.repo/some_pkg.git#egg=SomePackage'            # from mercurial
+         python -m pip install -e 'svn+svn://svn.repo/some_pkg/trunk/#egg=SomePackage'         # from svn
+         python -m pip install -e 'git+https://git.repo/some_pkg.git@feature#egg=SomePackage'  # from 'feature' branch
+         python -m pip install -e 'git+https://git.repo/some_repo.git#egg=subdir&subdirectory=subdir_path' # install a python package from a repo subdirectory
 
    .. tab:: Windows
 
       .. code-block:: shell
 
-         py -m pip install -e git+https://git.repo/some_pkg.git#egg=SomePackage          # from git
-         py -m pip install -e hg+https://hg.repo/some_pkg.git#egg=SomePackage            # from mercurial
-         py -m pip install -e svn+svn://svn.repo/some_pkg/trunk/#egg=SomePackage         # from svn
-         py -m pip install -e git+https://git.repo/some_pkg.git@feature#egg=SomePackage  # from 'feature' branch
+         py -m pip install -e "git+https://git.repo/some_pkg.git#egg=SomePackage"          # from git
+         py -m pip install -e "hg+https://hg.repo/some_pkg.git#egg=SomePackage"            # from mercurial
+         py -m pip install -e "svn+svn://svn.repo/some_pkg/trunk/#egg=SomePackage"         # from svn
+         py -m pip install -e "git+https://git.repo/some_pkg.git@feature#egg=SomePackage"  # from 'feature' branch
          py -m pip install -e "git+https://git.repo/some_repo.git#egg=subdir&subdirectory=subdir_path" # install a python package from a repo subdirectory
 
 #. Install a package with `extras`_.
@@ -386,21 +386,21 @@
 
       .. code-block:: shell
 
-         python -m pip install SomePackagePDF
-         python -m pip install "SomePackagePDF @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path"
-         python -m pip install .PDF  # project in current directory
-         python -m pip install SomePackagePDF==3.0
-         python -m pip install SomePackagePDF,EPUB  # multiple extras
+         python -m pip install 'SomePackagePDF'
+         python -m pip install 'SomePackagePDF @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path'
+         python -m pip install '.PDF'  # project in current directory
+         python -m pip install 'SomePackagePDF==3.0'
+         python -m pip install 'SomePackagePDF,EPUB'  # multiple extras
 
    .. tab:: Windows
 
       .. code-block:: shell
 
-         py -m pip install SomePackagePDF
+         py -m pip install "SomePackagePDF"
          py -m pip install "SomePackagePDF @ git+https://git.repo/SomePackage@main#subdirectory=subdir_path"
-         py -m pip install .PDF  # project in current directory
-         py -m pip install SomePackagePDF==3.0
-         py -m pip install SomePackagePDF,EPUB  # multiple extras
+         py -m pip install ".PDF"  # project in current directory
+         py -m pip install "SomePackagePDF==3.0"
+         py -m pip install "SomePackagePDF,EPUB"  # multiple extras
 
 #. Install a particular source archive file.
 
@@ -408,15 +408,15 @@
 
       .. code-block:: shell
 
-         python -m pip install ./downloads/SomePackage-1.0.4.tar.gz
-         python -m pip install http://my.package.repo/SomePackage-1.0.4.zip
+         python -m pip install './downloads/SomePackage-1.0.4.tar.gz'
+         python -m pip install 'http://my.package.repo/SomePackage-1.0.4.zip'
 
    .. tab:: Windows
 
       .. code-block:: shell
 
-         py -m pip install ./downloads/SomePackage-1.0.4.tar.gz
-         py -m pip install http://my.package.repo/SomePackage-1.0.4.zip
+         py -m pip install "./downloads/SomePackage-1.0.4.tar.gz"
+         py -m pip install "http://my.package.repo/SomePackage-1.0.4.zip"
 
 #. Install a particular source archive file following :pep:`440` direct references.
 
@@ -424,17 +424,17 @@
 
       .. code-block:: shell
 
-         python -m pip install SomeProject@http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl
-         python -m pip install "SomeProject @ http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl"
-         python -m pip install SomeProject@http://my.package.repo/1.2.3.tar.gz
+         python -m pip install 'SomeProject@http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl'
+         python -m pip install 'SomeProject @ http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl'
+         python -m pip install 'SomeProject@http://my.package.repo/1.2.3.tar.gz'
 
    .. tab:: Windows
 
       .. code-block:: shell
 
-         py -m pip install SomeProject@http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl
+         py -m pip install "SomeProject@http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl"
          py -m pip install "SomeProject @ http://my.package.repo/SomeProject-1.2.3-py33-none-any.whl"
-         py -m pip install SomeProject@http://my.package.repo/1.2.3.tar.gz
+         py -m pip install "SomeProject@http://my.package.repo/1.2.3.tar.gz"
 
 #. Install from alternative package repositories.

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/conf.py -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/conf.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/development/architecture/overview.rst -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/development/architecture/overview.rst Changed

@@ -24,9 +24,9 @@
            backwards compatibility reasons. But thing with setuptools:
            has a ``setup.py`` file that it invokes to …… get info?
 
-2. Decides where to install stuff. Once the package is built, resulting
-   artifact is then installed into system in appropriate place. :pep:`517`
-   defines interface between build backend & installer.
+2. Decides where to install stuff. Once the package is built, the resulting
+   artifact is then installed to the system in its appropriate place. :pep:`517`
+   defines the interface between the build backend & installer.
 
 Broad overview of flow
 ======================
@@ -111,24 +111,24 @@
 
 pip chooses from the list a single file to download.
 
-It may go back and choose another file to download
+It may go back and choose another file to download.
 
 When pip looks at the package index, the place where it looks has
-basically a link. The link’s text is the name of the file
+basically a link. The link’s text is the name of the file.
 
 This is the `PyPI Simple API`_ (PyPI has several APIs, some are being
 deprecated). pip looks at Simple API, documented initially at :pep:`503` --
 packaging.python.org has PyPA specifications with more details for
-Simple Repository API
+Simple Repository API.
 
-For this package name -- this is the list of files available
+For this package name -- this is the list of files available.
 
 Looks there for:
 
 * The list of filenames
 * Other info
 
-Once it has those, selects one file, downloads it
+Once it has those, it selects one file and downloads it.
 
 (Question: If I want to ``pip install flask``, I think the whole list of filenames
 cannot….should not be …. ? I want only the Flask …. Why am I getting the

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/development/release-process.rst -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/development/release-process.rst Changed

@@ -31,6 +31,15 @@
 option to back out the partial change prior to a release. The PR can then be
 reworked and resubmitted for the next release.
 
+Vendoring updates will be picked up from the ``main`` branch, as for any other
+update. Ideally, vendoring updates should be merged between releases, just like
+any other change. If there are outstanding updates to vendored packages, the
+release manager *may* at their discretion choose to do a vendoring update
+before the release. However this is *not* a requirement and in particular,
+updates to vendored packages that fix issues in pip should be merged
+proactively, to ensure that they will be present in the next release.
+
+
 .. _`Deprecation Policy`:
 
 Deprecation Policy
@@ -65,6 +74,13 @@
   ``pip._internal.utils.deprecation.deprecated``. The function is not a part of
   pip's public API.
 
+Supported Versions
+==================
+
+The latest version of the pip is the only supported version, previous
+versions should be considered unsupported. Users are encouraged to make
+regular updates to their version of pip in order to remain supported.
+
 .. _`Python 2 Support`:
 
 Python 2 Support
@@ -159,6 +175,11 @@
 order to create one of these the changes should already be merged into the
 ``main`` branch.
 
+Note that this process is only needed when there are changes on the main branch
+that you do *not* want to include in the bugfix release. For a bugfix release
+that will include everything that is on the ``main`` branch, the above process
+for creating a new release can be used, simply changing the version number.
+
 #. Create a new ``release/YY.N.Z+1`` branch off of the ``YY.N`` tag using the
    command ``git checkout -b release/YY.N.Z+1 YY.N``.
 #. Cherry pick the fixed commits off of the ``main`` branch, fixing any

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/getting-started.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/getting-started.md Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/installation.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/installation.md Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/reference/build-system/pyproject-toml.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/reference/build-system/pyproject-toml.md Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/reference/build-system/setup-py.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/reference/build-system/setup-py.md Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/reference/inspect-report.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/reference/inspect-report.md Changed

@@ -3,6 +3,10 @@
 ```{versionadded} 22.2
 ```
 
+```{versionchanged} 23.0
+``version`` has been bumped to ``1`` and the format declared stable.
+```
+
 The `pip inspect` command produces a detailed JSON report of the Python
 environment, including installed distributions.
 
@@ -10,10 +14,7 @@
 
 The report is a JSON object with the following properties:
 
-- `version`: the string `0`, denoting that the inspect command is an experimental
-  feature. This value will change to `1`, when the feature is deemed stable after
-  gathering user feedback (likely in pip 22.3 or 23.0). Backward incompatible changes
-  may be introduced in version `1` without notice. After that, it will change only if
+- `version`: the string `1`. It will change only if
   and when backward incompatible changes are introduced, such as removing mandatory
   fields or changing the semantics or data type of existing fields. The introduction of
   backward incompatible changes will follow the usual pip processes such as the
@@ -22,7 +23,7 @@
 
 - `pip_version`: a string with the version of pip used to produce the report.
 
-- `installed`: an array of InspectReportItem(InspectReportItem) representing the
+- `installed`: an array of `InspectReportItem`(InspectReportItem) representing the
   distribution packages that are installed.
 
 - `environment`: an object describing the environment where the installation report was
@@ -49,10 +50,11 @@
   ```
 
 - `direct_url`: Information about the direct URL that was used for installation, if any,
-  using the direct
-  URL(https://packaging.python.org/en/latest/specifications/direct-url/) data
-  structure. In most case, this field corresponds to the `direct_url.json` metadata,
-  except for legacy editable installs, where it is emulated.
+  using the direct URL data
+  structure(https://packaging.python.org/en/latest/specifications/direct-url-data-structure/).
+  In most case, this field corresponds to the
+  `direct_url.json`(https://packaging.python.org/en/latest/specifications/direct-url)
+  metadata, except for legacy editable installs, where it is emulated.
 
 - `requested`: `true` if the `REQUESTED` metadata is present, `false` otherwise. This
   field is only present for modern `.dist-info` installations.
@@ -72,7 +74,7 @@
 
 ```json
 {
-  "version": "0",
+  "version": "1",
   "pip_version": "22.2.dev0",
   "installed": 
     {

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/reference/installation-report.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/reference/installation-report.md Changed

@@ -3,6 +3,10 @@
 ```{versionadded} 22.2
 ```
 
+```{versionchanged} 23.0
+``version`` has been bumped to ``1`` and the format declared stable.
+```
+
 The `--report` option of the pip install command produces a detailed JSON report of what
 it did install (or what it would have installed, if used with the `--dry-run` option).
 
@@ -13,20 +17,16 @@
   other use cases), this format is *not* meant to be a lock file format as such;
 - there is no plan for pip to accept an installation report as input for the `install`,
   `download` or `wheel` commands;
-- the `--report` option and this format is intended to become a supported pip feature
-  (when the format is stabilized to version 1);
-- it is however *not* a PyPA interoperability standard and as such its evolution will be
-  governed by the pip processes and not the PyPA standardization processes.
+- while the `--report` option and this format is a supported pip feature,
+  it is *not* a PyPA interoperability standard and as such its evolution is governed by
+  the pip processes and not the PyPA standardization processes.
 ```
 
 ## Specification
 
 The report is a JSON object with the following properties:
 
-- `version`: the string `0`, denoting that the installation report is an experimental
-  feature. This value will change to `1`, when the feature is deemed stable after
-  gathering user feedback (likely in pip 22.3 or 23.0). Backward incompatible changes
-  may be introduced in version `1` without notice. After that, it will change only if
+- `version`: the string `1`. It will change only if
   and when backward incompatible changes are introduced, such as removing mandatory
   fields or changing the semantics or data type of existing fields. The introduction of
   backward incompatible changes will follow the usual pip processes such as the
@@ -35,7 +35,7 @@
 
 - `pip_version`: a string with the version of pip used to produce the report.
 
-- `install`: an array of InstallationReportItem(InstallationReportItem) representing
+- `install`: an array of `InstallationReportItem`(InstallationReportItem) representing
   the distribution packages (to be) installed.
 
 - `environment`: an object describing the environment where the installation report was
@@ -57,21 +57,22 @@
   specifier.
 
 - `download_info`: Information about the artifact (to be) downloaded for installation,
-  using the direct
-  URL(https://packaging.python.org/en/latest/specifications/direct-url/) data
-  structure. When `is_direct` is `true`, this field is the same as the `direct_url.json`
+  using the direct URL data
+  structure(https://packaging.python.org/en/latest/specifications/direct-url-data-structure/).
+  When `is_direct` is `true`, this field is the same as the
+  `direct_url.json`(https://packaging.python.org/en/latest/specifications/direct-url)
   metadata, otherwise it represents the URL of the artifact obtained from the index or
   `--find-links`.
 
   ```{note}
-  For source archives, `download_info.archive_info.hash` may
+  For source archives, `download_info.archive_info.hashes` may
   be absent when the requirement was installed from the wheel cache
   and the cache entry was populated by an older pip version that did not
   record the origin URL of the downloaded artifact.
   ```
 
 - `requested`: `true` if the requirement was explicitly provided by the user, either
-  directely via a command line argument or indirectly via a requirements file. `false`
+  directly via a command line argument or indirectly via a requirements file. `false`
   if the requirement was installed as a dependency of another requirement.
 
 - `requested_extras`: extras requested by the user. This field is only present when the
@@ -92,14 +93,16 @@
 
 ```json
 {
-  "version": "0",
+  "version": "1",
   "pip_version": "22.2",
   "install": 
     {
       "download_info": {
         "url": "https://files.pythonhosted.org/packages/a4/0c/fbaa7319dcb5eecd3484686eb5a5c5702a6445adb566f01aee6de3369bc4/pydantic-1.9.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
         "archive_info": {
-          "hash": "sha256=18f3e912f9ad1bdec27fb06b8198a2ccc32f201e24174cec1b3424dda605a310"
+          "hashes": {
+            "sha256": "18f3e912f9ad1bdec27fb06b8198a2ccc32f201e24174cec1b3424dda605a310"
+          }
         }
       },
       "is_direct": false,
@@ -144,7 +147,9 @@
       "download_info": {
         "url": "https://files.pythonhosted.org/packages/6c/10/a7d0fa5baea8fe7b50f448ab742f26f52b80bfca85ac2be9d35cdd9a3246/pyparsing-3.0.9-py3-none-any.whl",
         "archive_info": {
-          "hash": "sha256=5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc"
+          "hashes": {
+            "sha256": "5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc"
+          }
         }
       },
       "is_direct": false,
@@ -163,7 +168,9 @@
       "download_info": {
         "url": "https://files.pythonhosted.org/packages/75/e1/932e06004039dd670c9d5e1df0cd606bf46e29a28e65d5bb28e894ea29c9/typing_extensions-4.2.0-py3-none-any.whl",
         "archive_info": {
-          "hash": "sha256=6657594ee297170d19f67d55c05852a874e7eb634f4f753dbd667855e07c1708"
+          "hashes": {
+            "sha256": "6657594ee297170d19f67d55c05852a874e7eb634f4f753dbd667855e07c1708"
+          }
         }
       },
       "is_direct": false,

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/reference/requirements-file-format.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/reference/requirements-file-format.md Changed

@@ -109,7 +109,6 @@
 
 The options which can be applied to individual requirements are:
 
-- {ref}`--install-option <install_--install-option>`
 - {ref}`--global-option <install_--global-option>`
 - {ref}`--config-settings <install_--config-settings>`
 - `--hash` (for {ref}`Hash-checking mode`)
@@ -161,7 +160,7 @@
 This mechanism is only preserved for backwards compatibility and should be considered deprecated. A future release of pip may drop these options.
 ```
 
-The `--global-option` and `--install-option` options are used to pass options to `setup.py`.
+The `--global-option` option is used to pass options to `setup.py`.
 
 ```{attention}
 These options are highly coupled with how pip invokes setuptools using the {doc}`../reference/build-system/setup-py` build system interface. It is not compatible with newer {doc}`../reference/build-system/pyproject-toml` build system interface.
@@ -171,15 +170,10 @@
 
 If you have a declaration like:
 
-    FooProject >= 1.2 --global-option="--no-user-cfg" \
-                      --install-option="--prefix='/usr/local'" \
-                      --install-option="--no-compile"
+    FooProject >= 1.2 --global-option="--no-user-cfg"
 
 The above translates roughly into running FooProject's `setup.py` script as:
 
-    python setup.py --no-user-cfg install --prefix='/usr/local' --no-compile
+    python setup.py --no-user-cfg install
 
-Note that the only way of giving more than one option to `setup.py` is through multiple `--global-option` and `--install-option` options, as shown in the example above. The value of each option is passed as a single argument to the `setup.py` script. Therefore, a line such as the following is invalid and would result in an installation error.
-
-    # Invalid. Please use '--install-option' twice as shown above.
-    FooProject >= 1.2 --install-option="--prefix=/usr/local --no-compile"
+Note that the only way of giving more than one option to `setup.py` is through multiple `--global-option` options.

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/topics/authentication.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/topics/authentication.md Changed

@@ -66,12 +66,120 @@
 ## Keyring Support
 
 pip supports loading credentials stored in your keyring using the
-{pypi}`keyring` library.
+{pypi}`keyring` library, which can be enabled py passing `--keyring-provider`
+with a value of `auto`, `disabled`, `import`, or `subprocess`. The default
+value `auto` respects `--no-input` and not query keyring at all if the option
+is used; otherwise it tries the `import`, `subprocess`, and `disabled`
+providers (in this order) and uses the first one that works.
+
+### Configuring pip's keyring usage
+
+Since the keyring configuration is likely system-wide, a more common way to
+configure its usage would be to use a configuration instead:
+
+```{seealso}
+{doc}`./configuration` describes how pip configuration works.
+```
+
+```bash
+$ pip config set --global global.keyring-provider subprocess
+
+# A different user on the same system which has PYTHONPATH configured and and
+# wanting to use keyring installed that way could then run
+$ pip config set --user global.keyring-provider import
+
+# For a specific virtual environment you might want to use disable it again
+# because you will only be using PyPI and the private repo (and mirror)
+# requires 2FA with a keycard and a pincode
+$ pip config set --site global.index https://pypi.org/simple
+$ pip config set --site global.keyring-provider disabled
+
+# configuring it via environment variable is also possible
+$ export PIP_KEYRING_PROVIDER=disabled
+```
+
+### Using keyring's Python module
+
+Setting `keyring-provider` to `import` makes pip communicate with `keyring` via
+its Python interface.
 
 ```bash
-$ pip install keyring  # install keyring from PyPI
+# install keyring from PyPI
+$ pip install keyring --index-url https://pypi.org/simple
 $ echo "your-password" | keyring set pypi.company.com your-username
-$ pip install your-package --index-url https://pypi.company.com/
+$ pip install your-package --keyring-provider import --index-url https://pypi.company.com/
+```
+
+### Using keyring as a command line application
+
+Setting `keyring-provider` to `subprocess` makes pip look for and use the
+`keyring` command found on `PATH`.
+
+For this use case, a username *must* be included in the URL, since it is
+required by `keyring`'s command line interface. See the example below or the
+basic HTTP authentication section at the top of this page.
+
+```bash
+# Install keyring from PyPI using pipx, which we assume is installed properly
+# you can also create a venv somewhere and add it to the PATH yourself instead
+$ pipx install keyring --index-url https://pypi.org/simple
+
+# For Azure DevOps, also install its keyring backend.
+$ pipx inject keyring artifacts-keyring --index-url https://pypi.org/simple
+
+# For Google Artifact Registry, also install and initialize its keyring backend.
+$ pipx inject keyring keyrings.google-artifactregistry-auth --index-url https://pypi.org/simple
+$ gcloud auth login
+
+# Note that a username is required in the index URL.
+$ pip install your-package --keyring-provider subprocess --index-url https://username@pypi.example.com/
+```
+
+### Here be dragons
+
+The `auto` provider is conservative and does not query keyring at all when
+`--no-input` is used because the keyring might require user interaction such as
+prompting the user on the console. Third party tools frequently call Pip for
+you and do indeed pass `--no-input` as they are well-behaved and don't have
+much information to work with. (Keyring does have an api to request a backend
+that does not require user input.) You have more information about your system,
+however!
+
+You can force keyring usage by requesting a keyring provider other than `auto`
+(or `disabled`). Leaving `import` and `subprocess`. You do this by passing
+`--keyring-provider import` or one of the following methods:
+
+```bash
+# via config file, possibly with --user, --global or --site
+$ pip config set global.keyring-provider subprocess
+# or via environment variable
+$ export PIP_KEYRING_PROVIDER=import
+```
+
+```{warning}
+Be careful when doing this since it could cause tools such as pipx and Pipenv
+to appear to hang. They show their own progress indicator while hiding output
+from the subprocess in which they run Pip. You won't know whether the keyring
+backend is waiting the user input or not in such situations.
+```
+
+pip is conservative and does not query keyring at all when `--no-input` is used
+because the keyring might require user interaction such as prompting the user
+on the console. You can force keyring usage by passing `--force-keyring` or one
+of the following:
+
+```bash
+# possibly with --user, --global or --site
+$ pip config set global.force-keyring true
+# or
+$ export PIP_FORCE_KEYRING=1
+```
+
+```{warning}
+Be careful when doing this since it could cause tools such as pipx and Pipenv
+to appear to hang. They show their own progress indicator while hiding output
+from the subprocess in which they run Pip. You won't know whether the keyring
+backend is waiting the user input or not in such situations.
 ```
 
 Note that `keyring` (the Python package) needs to be installed separately from
@@ -79,5 +187,4 @@
 the keyring to download and install keyring.
 
 It is, thus, expected that users that wish to use pip's keyring support have
-some mechanism for downloading and installing {pypi}`keyring` in their Python
-environment.
+some mechanism for downloading and installing {pypi}`keyring`.

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/topics/caching.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/topics/caching.md Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/topics/local-project-installs.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/topics/local-project-installs.md Changed

@@ -34,7 +34,7 @@
 With an editable install, you only need to perform a re-installation if you change the project metadata (eg: version, what scripts need to be generated etc). You will still need to run build commands when you need to perform a compilation for non-Python code in the project (eg: C extensions).
 
 ```{caution}
-It is possible to see behaviour differences between regular installs vs editable installs. In case you distribute the project as a "distribution package", users will see the behaviour of regular installs -- thus, it is important to ensure that regular installs work correctly.
+It is possible to see behaviour differences between regular installs vs editable installs. These differences depend on the build-backend, and you should check the build-backend documentation for the details. In case you distribute the project as a "distribution package", users will see the behaviour of regular installs -- thus, it is important to ensure that regular installs work correctly.
 ```
 
 ```{note}

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/topics/secure-installs.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/topics/secure-installs.md Changed

@@ -59,13 +59,13 @@
 
 ### Interaction with caching
 
-The {ref}`locally-built wheel cache <wheel-caching>` is disabled in hash-checking mode to prevent spurious hash mismatch errors.
-
-These would otherwise occur while installing sdists that had already been automatically built into cached wheels: those wheels would be selected for installation, but their hashes would not match the sdist ones from the requirements file.
-
-A further complication is that locally built wheels are nondeterministic: contemporary modification times make their way into the archive, making hashes unpredictable across machines and cache flushes. Compilation of C code adds further nondeterminism, as many compilers include random-seeded values in their output.
+```{versionchanged} 23.1
+The {ref}`locally-built wheel cache <wheel-caching>` is used in hash-checking mode too.
+```
 
-However, wheels fetched from index servers are required to be the same every time. They land in pip's HTTP cache, not its wheel cache, and are used normally in hash-checking mode. The only downside of having the wheel cache disabled is thus extra build time for sdists, and this can be solved by making sure pre-built wheels are available from the index server.
+When installing from the cache of locally built wheels in hash-checking mode, pip verifies
+the hashes against those of the original source distribution that was used to build the wheel.
+These original hashes are obtained from a `origin.json` file stored in each cache entry.
 
 ### Using hashes from PyPI (or other index servers)

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/topics/vcs-support.md -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/topics/vcs-support.md Changed

@@ -18,7 +18,7 @@
 `git+git` and `git`. Here are some of the supported forms:
 
 ```none
-MyProject @ git+ssh://git.example.com/MyProject
+MyProject @ git+ssh://git@git.example.com/MyProject
 MyProject @ git+file:///home/user/projects/MyProject
 MyProject @ git+https://git.example.com/MyProject
 ```
@@ -130,18 +130,19 @@
 looks at the package version, at the target revision to determine what action to
 take on the VCS requirement (not the commit itself).
 
-The {ref}`pip freeze` subcommand will record the VCS requirement specifier
-(referencing a specific commit) only if the install is done with the editable
-option.
-
 ## URL fragments
 
-pip looks at 2 fragments for VCS URLs:
+pip looks at the `subdirectory` fragments of VCS URLs for specifying the path to the
+Python package, when it is not in the root of the VCS directory. eg: `pkg_dir`.
+
+pip also looks at the `egg` fragment specifying the "project name". In practice the
+`egg` fragment is only required to help pip determine the VCS clone location in editable
+mode. In all other circumstances, the `egg` fragment is not necessary and its use is
+discouraged.
 
-- `egg`: For specifying the "project name" for use in pip's dependency
-  resolution logic. eg: `egg=project_name`
-- `subdirectory`: For specifying the path to the Python package, when it is not
-  in the root of the VCS directory. eg: `pkg_dir`
+The `egg` fragment **should** be a bare
+PEP 508(https://peps.python.org/pep-0508/) project name. Anything else
+is not guaranteed to work.
 
 ````{admonition} Example
 If your repository layout is:
@@ -158,6 +159,12 @@
 Then, to install from this repository, the syntax would be:
 
 ```{pip-cli}
+$ pip install "pkg @ vcs+protocol://repo_url/#subdirectory=pkg_dir"
+```
+
+or:
+
+```{pip-cli}
 $ pip install -e "vcs+protocol://repo_url/#egg=pkg&subdirectory=pkg_dir"
 ```
 ````

_service:tar_scm:pip-22.3.1.tar.gz/docs/html/user_guide.rst -> _service:tar_scm:pip-23.1.2.tar.gz/docs/html/user_guide.rst Changed

@@ -127,6 +127,10 @@
 placed in a file. Note that you should not rely on the items in the file being
 installed by pip in any particular order.
 
+Requirements files can also be served via a URL, e.g.
+http://example.com/requirements.txt besides as local files, so that they can
+be stored and served in a centralized place.
+
 In practice, there are 4 common uses of Requirements files:
 
 1. Requirements files are used to hold the result from :ref:`pip freeze` for the
@@ -248,6 +252,10 @@
 and stripped constraints files down to being purely a way to specify
 global (version) limits for packages.
 
+Same as requirements files, constraints files can also be served via a URL,
+e.g. http://example.com/constraints.txt, so that your organization can store and
+serve them in a centralized place.
+
 .. _`Installing from Wheels`:
 
 
@@ -800,7 +808,7 @@
 Python, and so is available from your Python code via ``import pip``, you must
 not use pip's internal APIs in this way. There are a number of reasons for this:
 
-#. The pip code assumes that is in sole control of the global state of the
+#. The pip code assumes that it is in sole control of the global state of the
    program.
    pip manages things like the logging system configuration, or the values of
    the standard IO streams, without considering the possibility that user code

_service:tar_scm:pip-22.3.1.tar.gz/docs/pip_sphinxext.py -> _service:tar_scm:pip-23.1.2.tar.gz/docs/pip_sphinxext.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/docs/requirements.txt -> _service:tar_scm:pip-23.1.2.tar.gz/docs/requirements.txt Changed

_service:tar_scm:pip-23.1.2.tar.gz/news Added

_service:tar_scm:pip-23.1.2.tar.gz/news/.gitignore Added

_service:tar_scm:pip-23.1.2.tar.gz/noxfile.py Added

@@ -0,0 +1,392 @@
+"""Automation using nox.
+"""
+
+import argparse
+import glob
+import os
+import shutil
+import sys
+from pathlib import Path
+from typing import Iterator, List, Tuple
+
+import nox
+
+# fmt: off
+sys.path.append(".")
+from tools import release  # isort:skip  # noqa
+sys.path.pop()
+# fmt: on
+
+nox.options.reuse_existing_virtualenvs = True
+nox.options.sessions = "lint"
+
+LOCATIONS = {
+    "common-wheels": "tests/data/common_wheels",
+    "protected-pip": "tools/protected_pip.py",
+}
+REQUIREMENTS = {
+    "docs": "docs/requirements.txt",
+    "tests": "tests/requirements.txt",
+    "common-wheels": "tests/requirements-common_wheels.txt",
+}
+
+AUTHORS_FILE = "AUTHORS.txt"
+VERSION_FILE = "src/pip/__init__.py"
+
+
+def run_with_protected_pip(session: nox.Session, *arguments: str) -> None:
+    """Do a session.run("pip", *arguments), using a "protected" pip.
+
+    This invokes a wrapper script, that forwards calls to original virtualenv
+    (stable) version, and not the code being tested. This ensures pip being
+    used is not the code being tested.
+    """
+    env = {"VIRTUAL_ENV": session.virtualenv.location}
+
+    command = ("python", LOCATIONS"protected-pip") + arguments
+    session.run(*command, env=env, silent=True)
+
+
+def should_update_common_wheels() -> bool:
+    # If the cache hasn't been created, create it.
+    if not os.path.exists(LOCATIONS"common-wheels"):
+        return True
+
+    # If the requirements was updated after cache, we'll repopulate it.
+    cache_last_populated_at = os.path.getmtime(LOCATIONS"common-wheels")
+    requirements_updated_at = os.path.getmtime(REQUIREMENTS"common-wheels")
+    need_to_repopulate = requirements_updated_at > cache_last_populated_at
+
+    # Clear the stale cache.
+    if need_to_repopulate:
+        shutil.rmtree(LOCATIONS"common-wheels", ignore_errors=True)
+
+    return need_to_repopulate
+
+
+# -----------------------------------------------------------------------------
+# Development Commands
+# -----------------------------------------------------------------------------
+@nox.session(python="3.7", "3.8", "3.9", "3.10", "3.11", "pypy3")
+def test(session: nox.Session) -> None:
+    # Get the common wheels.
+    if should_update_common_wheels():
+        # fmt: off
+        run_with_protected_pip(
+            session,
+            "wheel",
+            "-w", LOCATIONS"common-wheels",
+            "-r", REQUIREMENTS"common-wheels",
+        )
+        # fmt: on
+    else:
+        msg = f"Re-using existing common-wheels at {LOCATIONS'common-wheels'}."
+        session.log(msg)
+
+    # Build source distribution
+    sdist_dir = os.path.join(session.virtualenv.location, "sdist")
+    if os.path.exists(sdist_dir):
+        shutil.rmtree(sdist_dir, ignore_errors=True)
+
+    # fmt: off
+    session.run(
+        "python", "setup.py", "sdist", "--formats=zip", "--dist-dir", sdist_dir,
+        silent=True,
+    )
+    # fmt: on
+
+    generated_files = os.listdir(sdist_dir)
+    assert len(generated_files) == 1
+    generated_sdist = os.path.join(sdist_dir, generated_files0)
+
+    # Install source distribution
+    run_with_protected_pip(session, "install", generated_sdist)
+
+    # Install test dependencies
+    run_with_protected_pip(session, "install", "-r", REQUIREMENTS"tests")
+
+    # Parallelize tests as much as possible, by default.
+    arguments = session.posargs or "-n", "auto"
+
+    # Run the tests
+    #   LC_CTYPE is set to get UTF-8 output inside of the subprocesses that our
+    #   tests use.
+    session.run(
+        "pytest",
+        *arguments,
+        env={
+            "LC_CTYPE": "en_US.UTF-8",
+        },
+    )
+
+
+@nox.session
+def docs(session: nox.Session) -> None:
+    session.install("-e", ".")
+    session.install("-r", REQUIREMENTS"docs")
+
+    def get_sphinx_build_command(kind: str) -> Liststr:
+        # Having the conf.py in the docs/html is weird but needed because we
+        # can not use a different configuration directory vs source directory
+        # on RTD currently. So, we'll pass "-c docs/html" here.
+        # See https://github.com/rtfd/readthedocs.org/issues/1543.
+        # fmt: off
+        return 
+            "sphinx-build",
+            "--keep-going",
+            "-W",
+            "-c", "docs/html",  # see note above
+            "-d", "docs/build/doctrees/" + kind,
+            "-b", kind,
+            "docs/" + kind,
+            "docs/build/" + kind,
+        
+        # fmt: on
+
+    session.run(*get_sphinx_build_command("html"))
+    session.run(*get_sphinx_build_command("man"))
+
+
+@nox.session(name="docs-live")
+def docs_live(session: nox.Session) -> None:
+    session.install("-e", ".")
+    session.install("-r", REQUIREMENTS"docs", "sphinx-autobuild")
+
+    session.run(
+        "sphinx-autobuild",
+        "-d=docs/build/doctrees/livehtml",
+        "-b=dirhtml",
+        "docs/html",
+        "docs/build/livehtml",
+        *session.posargs,
+    )
+
+
+@nox.session
+def lint(session: nox.Session) -> None:
+    session.install("pre-commit")
+
+    if session.posargs:
+        args = session.posargs + "--all-files"
+    else:
+        args = "--all-files", "--show-diff-on-failure"
+
+    session.run("pre-commit", "run", *args)
+
+
+# NOTE: This session will COMMIT upgrades to vendored libraries.
+# You should therefore not run it directly against `main`. If you
+# do (assuming you started with a clean main), you can run:
+#
+# git checkout -b vendoring-updates
+# git checkout main
+# git reset --hard origin/main
+@nox.session
+def vendoring(session: nox.Session) -> None:
+    session.install("vendoring~=1.2.0")
+
+    parser = argparse.ArgumentParser(prog="nox -s vendoring")
+    parser.add_argument("--upgrade-all", action="store_true")
+    parser.add_argument("--upgrade", action="append", default=)
+    parser.add_argument("--skip", action="append", default=)
+    args = parser.parse_args(session.posargs)
+
+    if not (args.upgrade or args.upgrade_all):
+        session.run("vendoring", "sync", "-v")
+        return
+
+    def pinned_requirements(path: Path) -> IteratorTuplestr, str:
+        for line in path.read_text().splitlines(keepends=False):
+            one, sep, two = line.partition("==")
+            if not sep:
+                continue
+            name = one.strip()
+            version = two.split("#", 1)0.strip()
+            if name and version:
+                yield name, version
+
+    vendor_txt = Path("src/pip/_vendor/vendor.txt")
+    for name, old_version in pinned_requirements(vendor_txt):
+        if name in args.skip:
+            continue
+        if args.upgrade and name not in args.upgrade:
+            continue
+
+        # update requirements.txt
+        session.run("vendoring", "update", ".", name)
+
+        # get the updated version
+        new_version = old_version
+        for inner_name, inner_version in pinned_requirements(vendor_txt):
+            if inner_name == name:
+                # this is a dedicated assignment, to make flake8 happy
+                new_version = inner_version
+                break
+        else:
+            session.error(f"Could not find {name} in {vendor_txt}")
+
+        # check if the version changed.
+        if new_version == old_version:
+            continue  # no change, nothing more to do here.
+
+        # synchronize the contents
+        session.run("vendoring", "sync", ".")
+
+        # Determine the correct message
+        message = f"Upgrade {name} to {new_version}"
+
+        # Write our news fragment
+        news_file = Path("news") / (name + ".vendor.rst")
+        news_file.write_text(message + "\n")  # "\n" appeases end-of-line-fixer
+
+        # Commit the changes
+        release.commit_file(session, ".", message=message)
+
+
+@nox.session
+def coverage(session: nox.Session) -> None:
+    # Install source distribution
+    run_with_protected_pip(session, "install", ".")
+
+    # Install test dependencies
+    run_with_protected_pip(session, "install", "-r", REQUIREMENTS"tests")
+
+    if not os.path.exists(".coverage-output"):
+        os.mkdir(".coverage-output")
+    session.run(
+        "pytest",
+        "--cov=pip",
+        "--cov-config=./setup.cfg",
+        *session.posargs,
+        env={
+            "COVERAGE_OUTPUT_DIR": "./.coverage-output",
+            "COVERAGE_PROCESS_START": os.fsdecode(Path("setup.cfg").resolve()),
+        },
+    )
+
+
+# -----------------------------------------------------------------------------
+# Release Commands
+# -----------------------------------------------------------------------------
+@nox.session(name="prepare-release")
+def prepare_release(session: nox.Session) -> None:
+    version = release.get_version_from_arguments(session)
+    if not version:
+        session.error("Usage: nox -s prepare-release -- <version>")
+
+    session.log("# Ensure nothing is staged")
+    if release.modified_files_in_git("--staged"):
+        session.error("There are files staged in git")
+
+    session.log(f"# Updating {AUTHORS_FILE}")
+    release.generate_authors(AUTHORS_FILE)
+    if release.modified_files_in_git():
+        release.commit_file(session, AUTHORS_FILE, message=f"Update {AUTHORS_FILE}")
+    else:
+        session.log(f"# No changes to {AUTHORS_FILE}")
+
+    session.log("# Generating NEWS")
+    release.generate_news(session, version)
+
+    session.log(f"# Bumping for release {version}")
+    release.update_version_file(version, VERSION_FILE)
+    release.commit_file(session, VERSION_FILE, message="Bump for release")
+
+    session.log("# Tagging release")
+    release.create_git_tag(session, version, message=f"Release {version}")
+
+    session.log("# Bumping for development")
+    next_dev_version = release.get_next_development_version(version)
+    release.update_version_file(next_dev_version, VERSION_FILE)
+    release.commit_file(session, VERSION_FILE, message="Bump for development")
+
+
+@nox.session(name="build-release")
+def build_release(session: nox.Session) -> None:
+    version = release.get_version_from_arguments(session)
+    if not version:
+        session.error("Usage: nox -s build-release -- YY.N.P")
+
+    session.log("# Ensure no files in dist/")
+    if release.have_files_in_folder("dist"):
+        session.error(
+            "There are files in dist/. Remove them and try again. "
+            "You can use `git clean -fxdi -- dist` command to do this"
+        )
+
+    session.log("# Install dependencies")
+    session.install("setuptools", "wheel", "twine")
+
+    with release.isolated_temporary_checkout(session, version) as build_dir:
+        session.log(
+            "# Start the build in an isolated, "
+            f"temporary Git checkout at {build_dir!s}",
+        )
+        with release.workdir(session, build_dir):
+            tmp_dists = build_dists(session)
+
+        tmp_dist_paths = (build_dir / p for p in tmp_dists)
+        session.log(f"# Copying dists from {build_dir}")
+        os.makedirs("dist", exist_ok=True)
+        for dist, final in zip(tmp_dist_paths, tmp_dists):
+            session.log(f"# Copying {dist} to {final}")
+            shutil.copy(dist, final)
+
+
+def build_dists(session: nox.Session) -> Liststr:
+    """Return dists with valid metadata."""
+    session.log(
+        "# Check if there's any Git-untracked files before building the wheel",
+    )
+
+    has_forbidden_git_untracked_files = any(
+        # Don't report the environment this session is running in
+        not untracked_file.startswith(".nox/build-release/")
+        for untracked_file in release.get_git_untracked_files()
+    )
+    if has_forbidden_git_untracked_files:
+        session.error(
+            "There are untracked files in the working directory. "
+            "Remove them and try again",
+        )
+
+    session.log("# Build distributions")
+    session.run("python", "setup.py", "sdist", "bdist_wheel", silent=True)
+    produced_dists = glob.glob("dist/*")
+
+    session.log(f"# Verify distributions: {', '.join(produced_dists)}")
+    session.run("twine", "check", *produced_dists, silent=True)
+
+    return produced_dists
+
+
+@nox.session(name="upload-release")
+def upload_release(session: nox.Session) -> None:
+    version = release.get_version_from_arguments(session)
+    if not version:
+        session.error("Usage: nox -s upload-release -- YY.N.P")
+
+    session.log("# Install dependencies")
+    session.install("twine")
+
+    distribution_files = glob.glob("dist/*")
+    session.log(f"# Distribution files: {distribution_files}")
+
+    # Sanity check: Make sure there's 2 distribution files.
+    count = len(distribution_files)
+    if count != 2:
+        session.error(
+            f"Expected 2 distribution files for upload, got {count}. "
+            f"Remove dist/ and run 'nox -s build-release -- {version}'"
+        )
+    # Sanity check: Make sure the files are correctly named.
+    distfile_names = (os.path.basename(fn) for fn in distribution_files)
+    expected_distribution_files = 
+        f"pip-{version}-py3-none-any.whl",
+        f"pip-{version}.tar.gz",
+    
+    if sorted(distfile_names) != sorted(expected_distribution_files):
+        session.error(f"Distribution files do not seem to be for {version} release.")
+
+    session.log("# Upload distributions")
+    session.run("twine", "upload", *distribution_files)

_service:tar_scm:pip-22.3.1.tar.gz/pyproject.toml -> _service:tar_scm:pip-23.1.2.tar.gz/pyproject.toml Changed

_service:tar_scm:pip-22.3.1.tar.gz/setup.cfg -> _service:tar_scm:pip-23.1.2.tar.gz/setup.cfg Changed

@@ -1,96 +1,113 @@
-isort
-profile = black
-skip = 
-	./build,
-	.nox,
-	.tox,
-	.scratch,
-	_vendor,
-	data
-known_third_party = 
-	pip._vendor
-
-flake8
-max-line-length = 88
-exclude = 
-	./build,
-	.nox,
-	.tox,
-	.scratch,
-	_vendor,
-	data
-enable-extensions = G
-extend-ignore = 
-	G200, G202,
-	E203,
-	B019,
-	B020,
-per-file-ignores = 
-	noxfile.py: G
-	tests/*: B011
-
-mypy
-mypy_path = $MYPY_CONFIG_FILE_DIR/src
-ignore_missing_imports = True
-disallow_untyped_defs = True
-disallow_any_generics = True
-warn_unused_ignores = True
-no_implicit_optional = True
-
-mypy-pip._vendor.*
-ignore_errors = True
-
-mypy-pip._vendor.colorama
-follow_imports = skip
-
-mypy-pip._vendor.pkg_resources
-follow_imports = skip
-
-mypy-pip._vendor.progress.*
-follow_imports = skip
-
-mypy-pip._vendor.requests.*
-follow_imports = skip
-
-tool:pytest
-addopts = --ignore src/pip/_vendor --ignore tests/tests_cache -r aR --color=yes
-xfail_strict = True
-markers = 
-	network: tests that need network
-	incompatible_with_sysconfig
-	incompatible_with_test_venv
-	incompatible_with_venv
-	no_auto_tempdir_manager
-	unit: unit tests
-	integration: integration tests
-	bzr: VCS: Bazaar
-	svn: VCS: Subversion
-	mercurial: VCS: Mercurial
-	git: VCS: git
-	search: tests for 'pip search'
-
-coverage:run
-branch = True
-omit = */_vendor/*
-data_file = ${COVERAGE_OUTPUT_DIR}/.coverage
-parallel = True
-disable_warnings = module-not-measured
-
-coverage:paths
-source0 = 
-	src/pip/
-	*/site-packages/pip/
-	*/pip/src/pip/
-
-coverage:report
-exclude_lines = 
-	pragma: no cover
-	if TYPE_CHECKING
-
-metadata
-license_file = LICENSE.txt
-
-egg_info
-tag_build = 
-tag_date = 0
-
+isort
+profile = black
+skip =
+    ./build,
+    .nox,
+    .tox,
+    .scratch,
+    _vendor,
+    data
+known_third_party =
+    pip._vendor
+
+flake8
+max-line-length = 88
+exclude =
+    ./build,
+    .nox,
+    .tox,
+    .scratch,
+    _vendor,
+    data
+enable-extensions = G
+extend-ignore =
+    G200, G202,
+    # black adds spaces around ':'
+    E203,
+    # using a cache
+    B019,
+    # reassigning variables in a loop
+    B020,
+per-file-ignores =
+    # G: The plugin logging-format treats every .log and .error as logging.
+    noxfile.py: G
+    # B011: Do not call assert False since python -O removes these calls
+    tests/*: B011
+
+mypy
+mypy_path = $MYPY_CONFIG_FILE_DIR/src
+ignore_missing_imports = True
+disallow_untyped_defs = True
+disallow_any_generics = True
+warn_unused_ignores = True
+no_implicit_optional = True
+
+mypy-pip._internal.utils._jaraco_text
+ignore_errors = True
+
+mypy-pip._vendor.*
+ignore_errors = True
+
+# These vendored libraries use runtime magic to populate things and don't sit
+# well with static typing out of the box. Eventually we should provide correct
+# typing information for their public interface and remove these configs.
+mypy-pip._vendor.colorama
+follow_imports = skip
+mypy-pip._vendor.pkg_resources
+follow_imports = skip
+mypy-pip._vendor.progress.*
+follow_imports = skip
+mypy-pip._vendor.requests.*
+follow_imports = skip
+
+tool:pytest
+addopts = --ignore src/pip/_vendor --ignore tests/tests_cache -r aR --color=yes
+xfail_strict = True
+markers =
+    network: tests that need network
+    incompatible_with_sysconfig
+    incompatible_with_venv
+    no_auto_tempdir_manager
+    unit: unit tests
+    integration: integration tests
+    bzr: VCS: Bazaar
+    svn: VCS: Subversion
+    mercurial: VCS: Mercurial
+    git: VCS: git
+    search: tests for 'pip search'
+
+coverage:run
+branch = True
+# Do not gather coverage for vendored libraries.
+omit = */_vendor/*
+# Centralized absolute file prefix for coverage files.
+data_file = ${COVERAGE_OUTPUT_DIR}/.coverage
+# By default, each covered process will try to truncate and then write to
+# `data_file`, but with `parallel`, they will write to separate files suffixed
+# with hostname, pid, and a timestamp.
+parallel = True
+# If not set, then at the termination of each worker (when using pytest-xdist),
+# the following is traced: "Coverage.py warning: Module pip was previously
+# imported, but not measured (module-not-measured)"
+disable_warnings = module-not-measured
+
+coverage:paths
+# We intentionally use "source0" here because pytest-cov unconditionally sets
+# "source" after loading the config.
+source0 =
+    # The primary source code path which other paths will be combined into.
+    src/pip/
+    # Unit test source directory e.g.
+    # `.tox/coverage-py3/lib/pythonX.Y/site-packages/pip/...`
+    */site-packages/pip/
+    # Functional test virtual environment directories, which look like
+    # `tmpdir/pip0/pip/src/pip/...`
+    */pip/src/pip/
+
+coverage:report
+exclude_lines =
+    # We must re-state the default because the `exclude_lines` option overrides
+    # it.
+    pragma: no cover
+    # This excludes typing-specific code, which will be validated by mypy anyway.
+    if TYPE_CHECKING

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/build_env.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/build_env.py Changed

@@ -8,9 +8,8 @@
 import sys
 import textwrap
 from collections import OrderedDict
-from sysconfig import get_paths
 from types import TracebackType
-from typing import TYPE_CHECKING, Iterable, List, Optional, Set, Tuple, Type
+from typing import TYPE_CHECKING, Iterable, List, Optional, Set, Tuple, Type, Union
 
 from pip._vendor.certifi import where
 from pip._vendor.packaging.requirements import Requirement
@@ -18,7 +17,7 @@
 
 from pip import __file__ as pip_location
 from pip._internal.cli.spinners import open_spinner
-from pip._internal.locations import get_platlib, get_prefixed_libs, get_purelib
+from pip._internal.locations import get_platlib, get_purelib, get_scheme
 from pip._internal.metadata import get_default_environment, get_environment
 from pip._internal.utils.subprocess import call_subprocess
 from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds
@@ -29,15 +28,17 @@
 logger = logging.getLogger(__name__)
 
 
+def _dedup(a: str, b: str) -> UnionTuplestr, Tuplestr, str:
+    return (a, b) if a != b else (a,)
+
+
 class _Prefix:
     def __init__(self, path: str) -> None:
         self.path = path
         self.setup = False
-        self.bin_dir = get_paths(
-            "nt" if os.name == "nt" else "posix_prefix",
-            vars={"base": path, "platbase": path},
-        )"scripts"
-        self.lib_dirs = get_prefixed_libs(path)
+        scheme = get_scheme("", prefix=path)
+        self.bin_dir = scheme.scripts
+        self.lib_dirs = _dedup(scheme.purelib, scheme.platlib)
 
 
 def get_runnable_pip() -> str:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/cache.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/cache.py Changed

@@ -6,14 +6,13 @@
 import logging
 import os
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Set
+from typing import Any, Dict, List, Optional
 
 from pip._vendor.packaging.tags import Tag, interpreter_name, interpreter_version
 from pip._vendor.packaging.utils import canonicalize_name
 
 from pip._internal.exceptions import InvalidWheelFilename
 from pip._internal.models.direct_url import DirectUrl
-from pip._internal.models.format_control import FormatControl
 from pip._internal.models.link import Link
 from pip._internal.models.wheel import Wheel
 from pip._internal.utils.temp_dir import TempDirectory, tempdir_kinds
@@ -33,25 +32,13 @@
 class Cache:
     """An abstract class - provides cache directories for data from links
 
-
     :param cache_dir: The root of the cache.
-    :param format_control: An object of FormatControl class to limit
-        binaries being read from the cache.
-    :param allowed_formats: which formats of files the cache should store.
-        ('binary' and 'source' are the only allowed values)
     """
 
-    def __init__(
-        self, cache_dir: str, format_control: FormatControl, allowed_formats: Setstr
-    ) -> None:
+    def __init__(self, cache_dir: str) -> None:
         super().__init__()
         assert not cache_dir or os.path.isabs(cache_dir)
         self.cache_dir = cache_dir or None
-        self.format_control = format_control
-        self.allowed_formats = allowed_formats
-
-        _valid_formats = {"source", "binary"}
-        assert self.allowed_formats.union(_valid_formats) == _valid_formats
 
     def _get_cache_path_parts(self, link: Link) -> Liststr:
         """Get parts of part that must be os.path.joined with cache_dir"""
@@ -91,10 +78,6 @@
         if can_not_cache:
             return 
 
-        formats = self.format_control.get_allowed_formats(canonical_package_name)
-        if not self.allowed_formats.intersection(formats):
-            return 
-
         candidates = 
         path = self.get_path_for_link(link)
         if os.path.isdir(path):
@@ -121,8 +104,8 @@
 class SimpleWheelCache(Cache):
     """A cache of wheels for future installs."""
 
-    def __init__(self, cache_dir: str, format_control: FormatControl) -> None:
-        super().__init__(cache_dir, format_control, {"binary"})
+    def __init__(self, cache_dir: str) -> None:
+        super().__init__(cache_dir)
 
     def get_path_for_link(self, link: Link) -> str:
         """Return a directory to store cached wheels for link
@@ -191,13 +174,13 @@
 class EphemWheelCache(SimpleWheelCache):
     """A SimpleWheelCache that creates it's own temporary cache directory"""
 
-    def __init__(self, format_control: FormatControl) -> None:
+    def __init__(self) -> None:
         self._temp_dir = TempDirectory(
             kind=tempdir_kinds.EPHEM_WHEEL_CACHE,
             globally_managed=True,
         )
 
-        super().__init__(self._temp_dir.path, format_control)
+        super().__init__(self._temp_dir.path)
 
 
 class CacheEntry:
@@ -221,14 +204,10 @@
     when a certain link is not found in the simple wheel cache first.
     """
 
-    def __init__(
-        self, cache_dir: str, format_control: OptionalFormatControl = None
-    ) -> None:
-        if format_control is None:
-            format_control = FormatControl()
-        super().__init__(cache_dir, format_control, {"binary"})
-        self._wheel_cache = SimpleWheelCache(cache_dir, format_control)
-        self._ephem_cache = EphemWheelCache(format_control)
+    def __init__(self, cache_dir: str) -> None:
+        super().__init__(cache_dir)
+        self._wheel_cache = SimpleWheelCache(cache_dir)
+        self._ephem_cache = EphemWheelCache()
 
     def get_path_for_link(self, link: Link) -> str:
         return self._wheel_cache.get_path_for_link(link)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/cli/base_command.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/cli/base_command.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/cli/cmdoptions.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/cli/cmdoptions.py Changed

@@ -164,6 +164,14 @@
     ),
 )
 
+override_externally_managed: Callable..., Option = partial(
+    Option,
+    "--break-system-packages",
+    dest="override_externally_managed",
+    action="store_true",
+    help="Allow pip to modify an EXTERNALLY-MANAGED Python installation",
+)
+
 python: Callable..., Option = partial(
     Option,
     "--python",
@@ -244,6 +252,19 @@
     help="Disable prompting for input.",
 )
 
+keyring_provider: Callable..., Option = partial(
+    Option,
+    "--keyring-provider",
+    dest="keyring_provider",
+    choices="auto", "disabled", "import", "subprocess",
+    default="auto",
+    help=(
+        "Enable the credential lookup via the keyring library if user input is allowed."
+        " Specify which mechanism to use disabled, import, subprocess."
+        " (default: disabled)"
+    ),
+)
+
 proxy: Callable..., Option = partial(
     Option,
     "--proxy",
@@ -762,10 +783,14 @@
         """
         raise_option_error(parser, option=option, msg=msg)
 
-    # If user doesn't wish to use pep517, we check if setuptools is installed
+    # If user doesn't wish to use pep517, we check if setuptools and wheel are installed
     # and raise error if it is not.
-    if not importlib.util.find_spec("setuptools"):
-        msg = "It is not possible to use --no-use-pep517 without setuptools installed."
+    packages = ("setuptools", "wheel")
+    if not all(importlib.util.find_spec(package) for package in packages):
+        msg = (
+            f"It is not possible to use --no-use-pep517 "
+            f"without {' and '.join(packages)} installed."
+        )
         raise_option_error(parser, option=option, msg=msg)
 
     # Otherwise, --no-use-pep517 was passed via the command-line.
@@ -803,11 +828,18 @@
     if dest is None:
         dest = {}
         setattr(parser.values, option.dest, dest)
-    destkey = val
+    if key in dest:
+        if isinstance(destkey, list):
+            destkey.append(val)
+        else:
+            destkey = destkey, val
+    else:
+        destkey = val
 
 
 config_settings: Callable..., Option = partial(
     Option,
+    "-C",
     "--config-settings",
     dest="config_settings",
     type=str,
@@ -819,19 +851,6 @@
     "to pass multiple keys to the backend.",
 )
 
-install_options: Callable..., Option = partial(
-    Option,
-    "--install-option",
-    dest="install_options",
-    action="append",
-    metavar="options",
-    help="Extra arguments to be supplied to the setup.py install "
-    'command (use like --install-option="--install-scripts=/usr/local/'
-    'bin"). Use multiple --install-option options to pass multiple '
-    "options to setup.py install. If you are using an option with a "
-    "directory path, be sure to use absolute path.",
-)
-
 build_options: Callable..., Option = partial(
     Option,
     "--build-option",
@@ -975,6 +994,11 @@
 )
 
 
+# Features that are now always on. A warning is printed if they are used.
+ALWAYS_ENABLED_FEATURES = 
+    "no-binary-enable-wheel-cache",  # always on since 23.1
+
+
 use_new_feature: Callable..., Option = partial(
     Option,
     "--use-feature",
@@ -985,8 +1009,8 @@
     choices=
         "fast-deps",
         "truststore",
-        "no-binary-enable-wheel-cache",
-    ,
+    
+    + ALWAYS_ENABLED_FEATURES,
     help="Enable new functionality, that may be backward incompatible.",
 )
 
@@ -1021,6 +1045,7 @@
         quiet,
         log,
         no_input,
+        keyring_provider,
         proxy,
         retries,
         timeout,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/cli/main.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/cli/main.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/cli/req_command.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/cli/req_command.py Changed

@@ -151,6 +151,7 @@
 
         # Determine if we can prompt the user for authentication or not
         session.auth.prompting = not options.no_input
+        session.auth.keyring_provider = options.keyring_provider
 
         return session
 
@@ -343,7 +344,6 @@
             install_req_from_req_string,
             isolated=options.isolated_mode,
             use_pep517=use_pep517,
-            config_settings=getattr(options, "config_settings", None),
         )
         resolver_variant = cls.determine_resolver_variant(options)
         # The long import name and duplicated invocation is needed to convince
@@ -410,7 +410,7 @@
         for req in args:
             req_to_add = install_req_from_line(
                 req,
-                None,
+                comes_from=None,
                 isolated=options.isolated_mode,
                 use_pep517=options.use_pep517,
                 user_supplied=True,
@@ -438,6 +438,9 @@
                     isolated=options.isolated_mode,
                     use_pep517=options.use_pep517,
                     user_supplied=True,
+                    config_settings=parsed_req.options.get("config_settings")
+                    if parsed_req.options
+                    else None,
                 )
                 requirements.append(req_to_add)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/cache.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/cache.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/check.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/check.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/debug.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/debug.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/download.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/download.py Changed

@@ -8,10 +8,7 @@
 from pip._internal.cli.req_command import RequirementCommand, with_cleanup
 from pip._internal.cli.status_codes import SUCCESS
 from pip._internal.operations.build.build_tracker import get_build_tracker
-from pip._internal.req.req_install import (
-    LegacySetupPyOptionsCheckMode,
-    check_legacy_setup_py_options,
-)
+from pip._internal.req.req_install import check_legacy_setup_py_options
 from pip._internal.utils.misc import ensure_dir, normalize_path, write_output
 from pip._internal.utils.temp_dir import TempDirectory
 
@@ -79,7 +76,6 @@
 
     @with_cleanup
     def run(self, options: Values, args: Liststr) -> int:
-
         options.ignore_installed = True
         # editable doesn't really make sense for `pip download`, but the bowels
         # of the RequirementSet code require that property.
@@ -109,9 +105,7 @@
         )
 
         reqs = self.get_requirements(args, options, finder, session)
-        check_legacy_setup_py_options(
-            options, reqs, LegacySetupPyOptionsCheckMode.DOWNLOAD
-        )
+        check_legacy_setup_py_options(options, reqs)
 
         preparer = self.make_requirement_preparer(
             temp_build_dir=directory,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/index.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/index.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/inspect.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/inspect.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/install.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/install.py Changed

@@ -5,9 +5,8 @@
 import shutil
 import site
 from optparse import SUPPRESS_HELP, Values
-from typing import Iterable, List, Optional
+from typing import List, Optional
 
-from pip._vendor.packaging.utils import canonicalize_name
 from pip._vendor.rich import print_json
 
 from pip._internal.cache import WheelCache
@@ -22,25 +21,19 @@
 from pip._internal.exceptions import CommandError, InstallationError
 from pip._internal.locations import get_scheme
 from pip._internal.metadata import get_environment
-from pip._internal.models.format_control import FormatControl
 from pip._internal.models.installation_report import InstallationReport
 from pip._internal.operations.build.build_tracker import get_build_tracker
 from pip._internal.operations.check import ConflictDetails, check_install_conflicts
 from pip._internal.req import install_given_reqs
 from pip._internal.req.req_install import (
     InstallRequirement,
-    LegacySetupPyOptionsCheckMode,
     check_legacy_setup_py_options,
 )
 from pip._internal.utils.compat import WINDOWS
-from pip._internal.utils.deprecation import (
-    LegacyInstallReasonFailedBdistWheel,
-    deprecated,
-)
-from pip._internal.utils.distutils_args import parse_distutils_args
 from pip._internal.utils.filesystem import test_writable_dir
 from pip._internal.utils.logging import getLogger
 from pip._internal.utils.misc import (
+    check_externally_managed,
     ensure_dir,
     get_pip_version,
     protect_pip_from_modification_on_windows,
@@ -51,26 +44,11 @@
     running_under_virtualenv,
     virtualenv_no_global,
 )
-from pip._internal.wheel_builder import (
-    BdistWheelAllowedPredicate,
-    build,
-    should_build_for_install_command,
-)
+from pip._internal.wheel_builder import build, should_build_for_install_command
 
 logger = getLogger(__name__)
 
 
-def get_check_bdist_wheel_allowed(
-    format_control: FormatControl,
-) -> BdistWheelAllowedPredicate:
-    def check_binary_allowed(req: InstallRequirement) -> bool:
-        canonical_name = canonicalize_name(req.name or "")
-        allowed_formats = format_control.get_allowed_formats(canonical_name)
-        return "binary" in allowed_formats
-
-    return check_binary_allowed
-
-
 class InstallCommand(RequirementCommand):
     """
     Install packages from:
@@ -155,7 +133,12 @@
             default=None,
             help=(
                 "Installation prefix where lib, bin and other top-level "
-                "folders are placed"
+                "folders are placed. Note that the resulting installation may "
+                "contain scripts and other resources which reference the "
+                "Python interpreter of pip, and not that of ``--prefix``. "
+                "See also the ``--python`` option if the intention is to "
+                "install packages into another (possibly pip-free) "
+                "environment."
             ),
         )
 
@@ -214,9 +197,9 @@
         self.cmd_opts.add_option(cmdoptions.use_pep517())
         self.cmd_opts.add_option(cmdoptions.no_use_pep517())
         self.cmd_opts.add_option(cmdoptions.check_build_deps())
+        self.cmd_opts.add_option(cmdoptions.override_externally_managed())
 
         self.cmd_opts.add_option(cmdoptions.config_settings())
-        self.cmd_opts.add_option(cmdoptions.install_options())
         self.cmd_opts.add_option(cmdoptions.global_options())
 
         self.cmd_opts.add_option(
@@ -284,14 +267,29 @@
         if options.use_user_site and options.target_dir is not None:
             raise CommandError("Can not combine '--user' and '--target'")
 
+        # Check whether the environment we're installing into is externally
+        # managed, as specified in PEP 668. Specifying --root, --target, or
+        # --prefix disables the check, since there's no reliable way to locate
+        # the EXTERNALLY-MANAGED file for those cases. An exception is also
+        # made specifically for "--dry-run --report" for convenience.
+        installing_into_current_environment = (
+            not (options.dry_run and options.json_report_file)
+            and options.root_path is None
+            and options.target_dir is None
+            and options.prefix_path is None
+        )
+        if (
+            installing_into_current_environment
+            and not options.override_externally_managed
+        ):
+            check_externally_managed()
+
         upgrade_strategy = "to-satisfy-only"
         if options.upgrade:
             upgrade_strategy = options.upgrade_strategy
 
         cmdoptions.check_dist_restriction(options, check_target=True)
 
-        install_options = options.install_options or 
-
         logger.verbose("Using %s", get_pip_version())
         options.use_user_site = decide_user_install(
             options.use_user_site,
@@ -342,28 +340,9 @@
 
         try:
             reqs = self.get_requirements(args, options, finder, session)
-            check_legacy_setup_py_options(
-                options, reqs, LegacySetupPyOptionsCheckMode.INSTALL
-            )
+            check_legacy_setup_py_options(options, reqs)
 
-            if "no-binary-enable-wheel-cache" in options.features_enabled:
-                # TODO: remove format_control from WheelCache when the deprecation cycle
-                # is over
-                wheel_cache = WheelCache(options.cache_dir)
-            else:
-                if options.format_control.no_binary:
-                    deprecated(
-                        reason=(
-                            "--no-binary currently disables reading from "
-                            "the cache of locally built wheels. In the future "
-                            "--no-binary will not influence the wheel cache."
-                        ),
-                        replacement="to use the --no-cache-dir option",
-                        feature_flag="no-binary-enable-wheel-cache",
-                        issue=11453,
-                        gone_in="23.1",
-                    )
-                wheel_cache = WheelCache(options.cache_dir, options.format_control)
+            wheel_cache = WheelCache(options.cache_dir)
 
             # Only when installing is it permitted to use PEP 660.
             # In other circumstances (pip wheel, pip download) we generate
@@ -371,8 +350,6 @@
             for req in reqs:
                 req.permit_editable_wheels = True
 
-            reject_location_related_install_options(reqs, options.install_options)
-
             preparer = self.make_requirement_preparer(
                 temp_build_dir=directory,
                 options=options,
@@ -402,12 +379,6 @@
             )
 
             if options.json_report_file:
-                logger.warning(
-                    "--report is currently an experimental option. "
-                    "The output format may change in a future release "
-                    "without prior warning."
-                )
-
                 report = InstallationReport(requirement_set.requirements_to_install)
                 if options.json_report_file == "-":
                     print_json(data=report.to_dict())
@@ -437,14 +408,10 @@
                 modifying_pip = pip_req.satisfied_by is None
             protect_pip_from_modification_on_windows(modifying_pip=modifying_pip)
 
-            check_bdist_wheel_allowed = get_check_bdist_wheel_allowed(
-                finder.format_control
-            )
-
             reqs_to_build = 
                 r
                 for r in requirement_set.requirements.values()
-                if should_build_for_install_command(r, check_bdist_wheel_allowed)
+                if should_build_for_install_command(r)
             
 
             _, build_failures = build(
@@ -455,26 +422,14 @@
                 global_options=global_options,
             )
 
-            # If we're using PEP 517, we cannot do a legacy setup.py install
-            # so we fail here.
-            pep517_build_failure_names: Liststr = 
-                r.name for r in build_failures if r.use_pep517  # type: ignore
-            
-            if pep517_build_failure_names:
+            if build_failures:
                 raise InstallationError(
                     "Could not build wheels for {}, which is required to "
                     "install pyproject.toml-based projects".format(
-                        ", ".join(pep517_build_failure_names)
+                        ", ".join(r.name for r in build_failures)  # type: ignore
                     )
                 )
 
-            # For now, we just warn about failures building legacy
-            # requirements, as we'll fall through to a setup.py install for
-            # those.
-            for r in build_failures:
-                if not r.use_pep517:
-                    r.legacy_install_reason = LegacyInstallReasonFailedBdistWheel
-
             to_install = resolver.get_installation_order(requirement_set)
 
             # Check for conflicts in the package set we're installing.
@@ -493,7 +448,6 @@
 
             installed = install_given_reqs(
                 to_install,
-                install_options,
                 global_options,
                 root=options.root_path,
                 home=target_temp_dir_path,
@@ -764,45 +718,6 @@
     return True
 
 
-def reject_location_related_install_options(
-    requirements: ListInstallRequirement, options: OptionalListstr
-) -> None:
-    """If any location-changing --install-option arguments were passed for
-    requirements or on the command-line, then show a deprecation warning.
-    """
-
-    def format_options(option_names: Iterablestr) -> Liststr:
-        return "--{}".format(name.replace("_", "-")) for name in option_names
-
-    offenders = 
-
-    for requirement in requirements:
-        install_options = requirement.install_options
-        location_options = parse_distutils_args(install_options)
-        if location_options:
-            offenders.append(
-                "{!r} from {}".format(
-                    format_options(location_options.keys()), requirement
-                )
-            )
-
-    if options:
-        location_options = parse_distutils_args(options)
-        if location_options:
-            offenders.append(
-                "{!r} from command line".format(format_options(location_options.keys()))
-            )
-
-    if not offenders:
-        return
-
-    raise CommandError(
-        "Location-changing options found in --install-option: {}."
-        " This is unsupported, use pip-level options like --user,"
-        " --prefix, --root, and --target instead.".format("; ".join(offenders))
-    )
-
-
 def create_os_error_message(
     error: OSError, show_traceback: bool, using_user_site: bool
 ) -> str:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/show.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/show.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/uninstall.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/uninstall.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/commands/wheel.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/commands/wheel.py Changed

@@ -12,10 +12,8 @@
 from pip._internal.operations.build.build_tracker import get_build_tracker
 from pip._internal.req.req_install import (
     InstallRequirement,
-    LegacySetupPyOptionsCheckMode,
     check_legacy_setup_py_options,
 )
-from pip._internal.utils.deprecation import deprecated
 from pip._internal.utils.misc import ensure_dir, normalize_path
 from pip._internal.utils.temp_dir import TempDirectory
 from pip._internal.wheel_builder import build, should_build_for_wheel_command
@@ -44,7 +42,6 @@
       %prog options <archive url/path> ..."""
 
     def add_options(self) -> None:
-
         self.cmd_opts.add_option(
             "-w",
             "--wheel-dir",
@@ -108,7 +105,6 @@
         session = self.get_default_session(options)
 
         finder = self._build_package_finder(options, session)
-        wheel_cache = WheelCache(options.cache_dir, options.format_control)
 
         options.wheel_dir = normalize_path(options.wheel_dir)
         ensure_dir(options.wheel_dir)
@@ -122,28 +118,9 @@
         )
 
         reqs = self.get_requirements(args, options, finder, session)
-        check_legacy_setup_py_options(
-            options, reqs, LegacySetupPyOptionsCheckMode.WHEEL
-        )
+        check_legacy_setup_py_options(options, reqs)
 
-        if "no-binary-enable-wheel-cache" in options.features_enabled:
-            # TODO: remove format_control from WheelCache when the deprecation cycle
-            # is over
-            wheel_cache = WheelCache(options.cache_dir)
-        else:
-            if options.format_control.no_binary:
-                deprecated(
-                    reason=(
-                        "--no-binary currently disables reading from "
-                        "the cache of locally built wheels. In the future "
-                        "--no-binary will not influence the wheel cache."
-                    ),
-                    replacement="to use the --no-cache-dir option",
-                    feature_flag="no-binary-enable-wheel-cache",
-                    issue=11453,
-                    gone_in="23.1",
-                )
-            wheel_cache = WheelCache(options.cache_dir, options.format_control)
+        wheel_cache = WheelCache(options.cache_dir)
 
         preparer = self.make_requirement_preparer(
             temp_build_dir=directory,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/exceptions.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/exceptions.py Changed

@@ -6,9 +6,14 @@
 """
 
 import configparser
+import contextlib
+import locale
+import logging
+import pathlib
 import re
+import sys
 from itertools import chain, groupby, repeat
-from typing import TYPE_CHECKING, Dict, List, Optional, Union
+from typing import TYPE_CHECKING, Dict, Iterator, List, Optional, Union
 
 from pip._vendor.requests.models import Request, Response
 from pip._vendor.rich.console import Console, ConsoleOptions, RenderResult
@@ -22,6 +27,8 @@
     from pip._internal.metadata import BaseDistribution
     from pip._internal.req.req_install import InstallRequirement
 
+logger = logging.getLogger(__name__)
+
 
 #
 # Scaffolding
@@ -354,20 +361,6 @@
         )
 
 
-class LegacyInstallFailure(DiagnosticPipError):
-    """Error occurred while executing `setup.py install`"""
-
-    reference = "legacy-install-failure"
-
-    def __init__(self, package_details: str) -> None:
-        super().__init__(
-            message="Encountered error while trying to install package.",
-            context=package_details,
-            hint_stmt="See above for output from the failure.",
-            note_stmt="This is an issue with the package mentioned above, not pip.",
-        )
-
-
 class InstallationSubprocessError(DiagnosticPipError, InstallationError):
     """A subprocess call failed."""
 
@@ -658,3 +651,83 @@
             assert self.error is not None
             message_part = f".\n{self.error}\n"
         return f"Configuration file {self.reason}{message_part}"
+
+
+_DEFAULT_EXTERNALLY_MANAGED_ERROR = f"""\
+The Python environment under {sys.prefix} is managed externally, and may not be
+manipulated by the user. Please use specific tooling from the distributor of
+the Python installation to interact with this environment instead.
+"""
+
+
+class ExternallyManagedEnvironment(DiagnosticPipError):
+    """The current environment is externally managed.
+
+    This is raised when the current environment is externally managed, as
+    defined by `PEP 668`_. The ``EXTERNALLY-MANAGED`` configuration is checked
+    and displayed when the error is bubbled up to the user.
+
+    :param error: The error message read from ``EXTERNALLY-MANAGED``.
+    """
+
+    reference = "externally-managed-environment"
+
+    def __init__(self, error: Optionalstr) -> None:
+        if error is None:
+            context = Text(_DEFAULT_EXTERNALLY_MANAGED_ERROR)
+        else:
+            context = Text(error)
+        super().__init__(
+            message="This environment is externally managed",
+            context=context,
+            note_stmt=(
+                "If you believe this is a mistake, please contact your "
+                "Python installation or OS distribution provider. "
+                "You can override this, at the risk of breaking your Python "
+                "installation or OS, by passing --break-system-packages."
+            ),
+            hint_stmt=Text("See PEP 668 for the detailed specification."),
+        )
+
+    @staticmethod
+    def _iter_externally_managed_error_keys() -> Iteratorstr:
+        # LC_MESSAGES is in POSIX, but not the C standard. The most common
+        # platform that does not implement this category is Windows, where
+        # using other categories for console message localization is equally
+        # unreliable, so we fall back to the locale-less vendor message. This
+        # can always be re-evaluated when a vendor proposes a new alternative.
+        try:
+            category = locale.LC_MESSAGES
+        except AttributeError:
+            lang: Optionalstr = None
+        else:
+            lang, _ = locale.getlocale(category)
+        if lang is not None:
+            yield f"Error-{lang}"
+            for sep in ("-", "_"):
+                before, found, _ = lang.partition(sep)
+                if not found:
+                    continue
+                yield f"Error-{before}"
+        yield "Error"
+
+    @classmethod
+    def from_config(
+        cls,
+        config: Unionpathlib.Path, str,
+    ) -> "ExternallyManagedEnvironment":
+        parser = configparser.ConfigParser(interpolation=None)
+        try:
+            parser.read(config, encoding="utf-8")
+            section = parser"externally-managed"
+            for key in cls._iter_externally_managed_error_keys():
+                with contextlib.suppress(KeyError):
+                    return cls(sectionkey)
+        except KeyError:
+            pass
+        except (OSError, UnicodeDecodeError, configparser.ParsingError):
+            from pip._internal.utils._log import VERBOSE
+
+            exc_info = logger.isEnabledFor(VERBOSE)
+            logger.warning("Failed to read %s", config, exc_info=exc_info)
+        return cls(None)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/index/collector.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/index/collector.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/index/package_finder.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/index/package_finder.py Changed

@@ -1,14 +1,11 @@
 """Routines related to PyPI, indexes"""
 
-# The following comment should be removed at some point in the future.
-# mypy: strict-optional=False
-
 import enum
 import functools
 import itertools
 import logging
 import re
-from typing import FrozenSet, Iterable, List, Optional, Set, Tuple, Union
+from typing import TYPE_CHECKING, FrozenSet, Iterable, List, Optional, Set, Tuple, Union
 
 from pip._vendor.packaging import specifiers
 from pip._vendor.packaging.tags import Tag
@@ -39,6 +36,9 @@
 from pip._internal.utils.packaging import check_requires_python
 from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS
 
+if TYPE_CHECKING:
+    from pip._vendor.typing_extensions import TypeGuard
+
 __all__ = "FormatControl", "BestCandidateResult", "PackageFinder"
 
 
@@ -251,7 +251,7 @@
 
 def filter_unallowed_hashes(
     candidates: ListInstallationCandidate,
-    hashes: Hashes,
+    hashes: OptionalHashes,
     project_name: str,
 ) -> ListInstallationCandidate:
     """
@@ -540,6 +540,7 @@
                 binary_preference = 1
             if wheel.build_tag is not None:
                 match = re.match(r"^(\d+)(.*)$", wheel.build_tag)
+                assert match is not None, "guaranteed by filename validation"
                 build_tag_groups = match.groups()
                 build_tag = (int(build_tag_groups0), build_tag_groups1)
         else:  # sdist
@@ -942,43 +943,46 @@
                 "No matching distribution found for {}".format(req)
             )
 
-        best_installed = False
-        if installed_version and (
-            best_candidate is None or best_candidate.version <= installed_version
-        ):
-            best_installed = True
+        def _should_install_candidate(
+            candidate: OptionalInstallationCandidate,
+        ) -> "TypeGuardInstallationCandidate":
+            if installed_version is None:
+                return True
+            if best_candidate is None:
+                return False
+            return best_candidate.version > installed_version
 
         if not upgrade and installed_version is not None:
-            if best_installed:
+            if _should_install_candidate(best_candidate):
                 logger.debug(
-                    "Existing installed version (%s) is most up-to-date and "
-                    "satisfies requirement",
+                    "Existing installed version (%s) satisfies requirement "
+                    "(most up-to-date version is %s)",
                     installed_version,
+                    best_candidate.version,
                 )
             else:
                 logger.debug(
-                    "Existing installed version (%s) satisfies requirement "
-                    "(most up-to-date version is %s)",
+                    "Existing installed version (%s) is most up-to-date and "
+                    "satisfies requirement",
                     installed_version,
-                    best_candidate.version,
                 )
             return None
 
-        if best_installed:
-            # We have an existing version, and its the best version
+        if _should_install_candidate(best_candidate):
             logger.debug(
-                "Installed version (%s) is most up-to-date (past versions: %s)",
-                installed_version,
+                "Using version %s (newest of versions: %s)",
+                best_candidate.version,
                 _format_versions(best_candidate_result.iter_applicable()),
             )
-            raise BestVersionAlreadyInstalled
+            return best_candidate
 
+        # We have an existing version, and its the best version
         logger.debug(
-            "Using version %s (newest of versions: %s)",
-            best_candidate.version,
+            "Installed version (%s) is most up-to-date (past versions: %s)",
+            installed_version,
             _format_versions(best_candidate_result.iter_applicable()),
         )
-        return best_candidate
+        raise BestVersionAlreadyInstalled
 
 
 def _find_name_version_sep(fragment: str, canonical_name: str) -> int:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/index/sources.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/index/sources.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/locations/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/locations/__init__.py Changed

@@ -4,7 +4,7 @@
 import pathlib
 import sys
 import sysconfig
-from typing import Any, Dict, Generator, List, Optional, Tuple
+from typing import Any, Dict, Generator, Optional, Tuple
 
 from pip._internal.models.scheme import SCHEME_KEYS, Scheme
 from pip._internal.utils.compat import WINDOWS
@@ -27,7 +27,6 @@
     "get_bin_user",
     "get_major_minor_version",
     "get_platlib",
-    "get_prefixed_libs",
     "get_purelib",
     "get_scheme",
     "get_src_prefix",
@@ -466,63 +465,3 @@
     if _warn_if_mismatch(pathlib.Path(old), pathlib.Path(new), key="platlib"):
         _log_context()
     return old
-
-
-def _deduplicated(v1: str, v2: str) -> Liststr:
-    """Deduplicate values from a list."""
-    if v1 == v2:
-        return v1
-    return v1, v2
-
-
-def _looks_like_apple_library(path: str) -> bool:
-    """Apple patches sysconfig to *always* look under */Library/Python*."""
-    if sys.platform:6 != "darwin":
-        return False
-    return path == f"/Library/Python/{get_major_minor_version()}/site-packages"
-
-
-def get_prefixed_libs(prefix: str) -> Liststr:
-    """Return the lib locations under ``prefix``."""
-    new_pure, new_plat = _sysconfig.get_prefixed_libs(prefix)
-    if _USE_SYSCONFIG:
-        return _deduplicated(new_pure, new_plat)
-
-    old_pure, old_plat = _distutils.get_prefixed_libs(prefix)
-    old_lib_paths = _deduplicated(old_pure, old_plat)
-
-    # Apple's Python (shipped with Xcode and Command Line Tools) hard-code
-    # platlib and purelib to '/Library/Python/X.Y/site-packages'. This will
-    # cause serious build isolation bugs when Apple starts shipping 3.10 because
-    # pip will install build backends to the wrong location. This tells users
-    # who is at fault so Apple may notice it and fix the issue in time.
-    if all(_looks_like_apple_library(p) for p in old_lib_paths):
-        deprecated(
-            reason=(
-                "Python distributed by Apple's Command Line Tools incorrectly "
-                "patches sysconfig to always point to '/Library/Python'. This "
-                "will cause build isolation to operate incorrectly on Python "
-                "3.10 or later. Please help report this to Apple so they can "
-                "fix this. https://developer.apple.com/bug-reporting/"
-            ),
-            replacement=None,
-            gone_in=None,
-        )
-        return old_lib_paths
-
-    warned = 
-        _warn_if_mismatch(
-            pathlib.Path(old_pure),
-            pathlib.Path(new_pure),
-            key="prefixed-purelib",
-        ),
-        _warn_if_mismatch(
-            pathlib.Path(old_plat),
-            pathlib.Path(new_plat),
-            key="prefixed-platlib",
-        ),
-    
-    if any(warned):
-        _log_context(prefix=prefix)
-
-    return old_lib_paths

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/locations/_distutils.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/locations/_distutils.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/locations/_sysconfig.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/locations/_sysconfig.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/locations/base.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/locations/base.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/models/direct_url.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/models/direct_url.py Changed

@@ -103,17 +103,42 @@
     def __init__(
         self,
         hash: Optionalstr = None,
+        hashes: OptionalDictstr, str = None,
     ) -> None:
+        # set hashes before hash, since the hash setter will further populate hashes
+        self.hashes = hashes
         self.hash = hash
 
+    @property
+    def hash(self) -> Optionalstr:
+        return self._hash
+
+    @hash.setter
+    def hash(self, value: Optionalstr) -> None:
+        if value is not None:
+            # Auto-populate the hashes key to upgrade to the new format automatically.
+            # We don't back-populate the legacy hash key from hashes.
+            try:
+                hash_name, hash_value = value.split("=", 1)
+            except ValueError:
+                raise DirectUrlValidationError(
+                    f"invalid archive_info.hash format: {value!r}"
+                )
+            if self.hashes is None:
+                self.hashes = {hash_name: hash_value}
+            elif hash_name not in self.hashes:
+                self.hashes = self.hashes.copy()
+                self.hasheshash_name = hash_value
+        self._hash = value
+
     @classmethod
     def _from_dict(cls, d: OptionalDictstr, Any) -> Optional"ArchiveInfo":
         if d is None:
             return None
-        return cls(hash=_get(d, str, "hash"))
+        return cls(hash=_get(d, str, "hash"), hashes=_get(d, dict, "hashes"))
 
     def _to_dict(self) -> Dictstr, Any:
-        return _filter_none(hash=self.hash)
+        return _filter_none(hash=self.hash, hashes=self.hashes)
 
 
 class DirInfo:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/models/installation_report.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/models/installation_report.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/models/link.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/models/link.py Changed

@@ -18,6 +18,7 @@
     Union,
 )
 
+from pip._internal.utils.deprecation import deprecated
 from pip._internal.utils.filetypes import WHEEL_EXTENSION
 from pip._internal.utils.hashes import Hashes
 from pip._internal.utils.misc import (
@@ -54,30 +55,45 @@
     name: str
     value: str
 
-    _hash_re = re.compile(
+    _hash_url_fragment_re = re.compile(
         # NB: we do not validate that the second group (.*) is a valid hex
         # digest. Instead, we simply keep that string in this class, and then check it
         # against Hashes when hash-checking is needed. This is easier to debug than
         # proactively discarding an invalid hex digest, as we handle incorrect hashes
         # and malformed hashes in the same place.
-        r"({choices})=(.*)".format(
+        r"#&({choices})=(^&*)".format(
             choices="|".join(re.escape(hash_name) for hash_name in _SUPPORTED_HASHES)
         ),
     )
 
     def __post_init__(self) -> None:
-        assert self._hash_re.match(f"{self.name}={self.value}")
+        assert self.name in _SUPPORTED_HASHES
+
+    @classmethod
+    def parse_pep658_hash(cls, dist_info_metadata: str) -> Optional"LinkHash":
+        """Parse a PEP 658 data-dist-info-metadata hash."""
+        if dist_info_metadata == "true":
+            return None
+        name, sep, value = dist_info_metadata.partition("=")
+        if not sep:
+            return None
+        if name not in _SUPPORTED_HASHES:
+            return None
+        return cls(name=name, value=value)
 
     @classmethod
     @functools.lru_cache(maxsize=None)
-    def split_hash_name_and_value(cls, url: str) -> Optional"LinkHash":
+    def find_hash_url_fragment(cls, url: str) -> Optional"LinkHash":
         """Search a string for a checksum algorithm name and encoded output value."""
-        match = cls._hash_re.search(url)
+        match = cls._hash_url_fragment_re.search(url)
         if match is None:
             return None
         name, value = match.groups()
         return cls(name=name, value=value)
 
+    def as_dict(self) -> Dictstr, str:
+        return {self.name: self.value}
+
     def as_hashes(self) -> Hashes:
         """Return a Hashes instance which checks only for the current hash."""
         return Hashes({self.name: self.value})
@@ -164,8 +180,8 @@
         "requires_python",
         "yanked_reason",
         "dist_info_metadata",
-        "link_hash",
         "cache_link_parsing",
+        "egg_fragment",
     
 
     def __init__(
@@ -175,7 +191,6 @@
         requires_python: Optionalstr = None,
         yanked_reason: Optionalstr = None,
         dist_info_metadata: Optionalstr = None,
-        link_hash: OptionalLinkHash = None,
         cache_link_parsing: bool = True,
         hashes: OptionalMappingstr, str = None,
     ) -> None:
@@ -198,16 +213,11 @@
             attribute, if present, in a simple repository HTML link. This may be parsed
             into its own `Link` by `self.metadata_link()`. See PEP 658 for more
             information and the specification.
-        :param link_hash: a checksum for the content the link points to. If not
-            provided, this will be extracted from the link URL, if the URL has
-            any checksum.
         :param cache_link_parsing: A flag that is used elsewhere to determine
-                                   whether resources retrieved from this link
-                                   should be cached. PyPI index urls should
-                                   generally have this set to False, for
-                                   example.
+            whether resources retrieved from this link should be cached. PyPI
+            URLs should generally have this set to False, for example.
         :param hashes: A mapping of hash names to digests to allow us to
-                       determine the validity of a download.
+            determine the validity of a download.
         """
 
         # url can be a UNC windows share
@@ -218,17 +228,23 @@
         # Store the url as a private attribute to prevent accidentally
         # trying to set a new value.
         self._url = url
-        self._hashes = hashes if hashes is not None else {}
+
+        link_hash = LinkHash.find_hash_url_fragment(url)
+        hashes_from_link = {} if link_hash is None else link_hash.as_dict()
+        if hashes is None:
+            self._hashes = hashes_from_link
+        else:
+            self._hashes = {**hashes, **hashes_from_link}
 
         self.comes_from = comes_from
         self.requires_python = requires_python if requires_python else None
         self.yanked_reason = yanked_reason
         self.dist_info_metadata = dist_info_metadata
-        self.link_hash = link_hash or LinkHash.split_hash_name_and_value(self._url)
 
         super().__init__(key=url, defining_class=Link)
 
         self.cache_link_parsing = cache_link_parsing
+        self.egg_fragment = self._egg_fragment()
 
     @classmethod
     def from_json(
@@ -358,12 +374,28 @@
 
     _egg_fragment_re = re.compile(r"#&egg=(^&*)")
 
-    @property
-    def egg_fragment(self) -> Optionalstr:
+    # Per PEP 508.
+    _project_name_re = re.compile(
+        r"^(A-Z0-9|A-Z0-9A-Z0-9._-*A-Z0-9)$", re.IGNORECASE
+    )
+
+    def _egg_fragment(self) -> Optionalstr:
         match = self._egg_fragment_re.search(self._url)
         if not match:
             return None
-        return match.group(1)
+
+        # An egg fragment looks like a PEP 508 project name, along with
+        # an optional extras specifier. Anything else is invalid.
+        project_name = match.group(1)
+        if not self._project_name_re.match(project_name):
+            deprecated(
+                reason=f"{self} contains an egg fragment with a non-PEP 508 name",
+                replacement="to use the req @ url syntax, and remove the egg fragment",
+                gone_in="25.0",
+                issue=11617,
+            )
+
+        return project_name
 
     _subdirectory_fragment_re = re.compile(r"#&subdirectory=(^&*)")
 
@@ -382,29 +414,21 @@
         if self.dist_info_metadata is None:
             return None
         metadata_url = f"{self.url_without_fragment}.metadata"
-        link_hash: OptionalLinkHash = None
-        # If data-dist-info-metadata="true" is set, then the metadata file exists,
-        # but there is no information about its checksum or anything else.
-        if self.dist_info_metadata != "true":
-            link_hash = LinkHash.split_hash_name_and_value(self.dist_info_metadata)
-        return Link(metadata_url, link_hash=link_hash)
-
-    def as_hashes(self) -> OptionalHashes:
-        if self.link_hash is not None:
-            return self.link_hash.as_hashes()
-        return None
+        metadata_link_hash = LinkHash.parse_pep658_hash(self.dist_info_metadata)
+        if metadata_link_hash is None:
+            return Link(metadata_url)
+        return Link(metadata_url, hashes=metadata_link_hash.as_dict())
+
+    def as_hashes(self) -> Hashes:
+        return Hashes({k: v for k, v in self._hashes.items()})
 
     @property
     def hash(self) -> Optionalstr:
-        if self.link_hash is not None:
-            return self.link_hash.value
-        return None
+        return next(iter(self._hashes.values()), None)
 
     @property
     def hash_name(self) -> Optionalstr:
-        if self.link_hash is not None:
-            return self.link_hash.name
-        return None
+        return next(iter(self._hashes), None)
 
     @property
     def show_url(self) -> str:
@@ -433,15 +457,15 @@
 
     @property
     def has_hash(self) -> bool:
-        return self.link_hash is not None
+        return bool(self._hashes)
 
     def is_hash_allowed(self, hashes: OptionalHashes) -> bool:
         """
         Return True if the link has a hash and it is allowed by `hashes`.
         """
-        if self.link_hash is None:
+        if hashes is None:
             return False
-        return self.link_hash.is_hash_allowed(hashes)
+        return any(hashes.is_hash_allowed(k, v) for k, v in self._hashes.items())
 
 
 class _CleanResult(NamedTuple):

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/models/search_scope.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/models/search_scope.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/network/auth.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/network/auth.py Changed

@@ -3,9 +3,18 @@
 Contains interface (MultiDomainBasicAuth) and associated glue code for
 providing credentials in the context of network requests.
 """
-
+import logging
+import os
+import shutil
+import subprocess
+import sysconfig
+import typing
 import urllib.parse
-from typing import Any, Dict, List, Optional, Tuple
+from abc import ABC, abstractmethod
+from functools import lru_cache
+from os.path import commonprefix
+from pathlib import Path
+from typing import Any, Dict, List, NamedTuple, Optional, Tuple
 
 from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth
 from pip._vendor.requests.models import Request, Response
@@ -23,59 +32,204 @@
 
 logger = getLogger(__name__)
 
-Credentials = Tuplestr, str, str
+KEYRING_DISABLED = False
+
+
+class Credentials(NamedTuple):
+    url: str
+    username: str
+    password: str
+
+
+class KeyRingBaseProvider(ABC):
+    """Keyring base provider interface"""
+
+    has_keyring: bool
+
+    @abstractmethod
+    def get_auth_info(self, url: str, username: Optionalstr) -> OptionalAuthInfo:
+        ...
+
+    @abstractmethod
+    def save_auth_info(self, url: str, username: str, password: str) -> None:
+        ...
+
 
-try:
-    import keyring
-except ImportError:
-    keyring = None  # type: ignoreassignment
-except Exception as exc:
-    logger.warning(
-        "Keyring is skipped due to an exception: %s",
-        str(exc),
-    )
-    keyring = None  # type: ignoreassignment
+class KeyRingNullProvider(KeyRingBaseProvider):
+    """Keyring null provider"""
 
+    has_keyring = False
 
-def get_keyring_auth(url: Optionalstr, username: Optionalstr) -> OptionalAuthInfo:
-    """Return the tuple auth for a given url from keyring."""
-    global keyring
-    if not url or not keyring:
+    def get_auth_info(self, url: str, username: Optionalstr) -> OptionalAuthInfo:
         return None
 
-    try:
-        try:
-            get_credential = keyring.get_credential
-        except AttributeError:
-            pass
-        else:
+    def save_auth_info(self, url: str, username: str, password: str) -> None:
+        return None
+
+
+class KeyRingPythonProvider(KeyRingBaseProvider):
+    """Keyring interface which uses locally imported `keyring`"""
+
+    has_keyring = True
+
+    def __init__(self) -> None:
+        import keyring
+
+        self.keyring = keyring
+
+    def get_auth_info(self, url: str, username: Optionalstr) -> OptionalAuthInfo:
+        # Support keyring's get_credential interface which supports getting
+        # credentials without a username. This is only available for
+        # keyring>=15.2.0.
+        if hasattr(self.keyring, "get_credential"):
             logger.debug("Getting credentials from keyring for %s", url)
-            cred = get_credential(url, username)
+            cred = self.keyring.get_credential(url, username)
             if cred is not None:
                 return cred.username, cred.password
             return None
 
-        if username:
+        if username is not None:
             logger.debug("Getting password from keyring for %s", url)
-            password = keyring.get_password(url, username)
+            password = self.keyring.get_password(url, username)
             if password:
                 return username, password
+        return None
+
+    def save_auth_info(self, url: str, username: str, password: str) -> None:
+        self.keyring.set_password(url, username, password)
+
+
+class KeyRingCliProvider(KeyRingBaseProvider):
+    """Provider which uses `keyring` cli
+
+    Instead of calling the keyring package installed alongside pip
+    we call keyring on the command line which will enable pip to
+    use which ever installation of keyring is available first in
+    PATH.
+    """
+
+    has_keyring = True
+
+    def __init__(self, cmd: str) -> None:
+        self.keyring = cmd
+
+    def get_auth_info(self, url: str, username: Optionalstr) -> OptionalAuthInfo:
+        # This is the default implementation of keyring.get_credential
+        # https://github.com/jaraco/keyring/blob/97689324abcf01bd1793d49063e7ca01e03d7d07/keyring/backend.py#L134-L139
+        if username is not None:
+            password = self._get_password(url, username)
+            if password is not None:
+                return username, password
+        return None
+
+    def save_auth_info(self, url: str, username: str, password: str) -> None:
+        return self._set_password(url, username, password)
+
+    def _get_password(self, service_name: str, username: str) -> Optionalstr:
+        """Mirror the implementation of keyring.get_password using cli"""
+        if self.keyring is None:
+            return None
+
+        cmd = self.keyring, "get", service_name, username
+        env = os.environ.copy()
+        env"PYTHONIOENCODING" = "utf-8"
+        res = subprocess.run(
+            cmd,
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.PIPE,
+            env=env,
+        )
+        if res.returncode:
+            return None
+        return res.stdout.decode("utf-8").strip(os.linesep)
 
-    except Exception as exc:
-        logger.warning(
-            "Keyring is skipped due to an exception: %s",
-            str(exc),
+    def _set_password(self, service_name: str, username: str, password: str) -> None:
+        """Mirror the implementation of keyring.set_password using cli"""
+        if self.keyring is None:
+            return None
+        env = os.environ.copy()
+        env"PYTHONIOENCODING" = "utf-8"
+        subprocess.run(
+            self.keyring, "set", service_name, username,
+            input=f"{password}{os.linesep}".encode("utf-8"),
+            env=env,
+            check=True,
         )
-        keyring = None  # type: ignoreassignment
-    return None
+        return None
+
+
+@lru_cache(maxsize=None)
+def get_keyring_provider(provider: str) -> KeyRingBaseProvider:
+    logger.verbose("Keyring provider requested: %s", provider)
+
+    # keyring has previously failed and been disabled
+    if KEYRING_DISABLED:
+        provider = "disabled"
+    if provider in "import", "auto":
+        try:
+            impl = KeyRingPythonProvider()
+            logger.verbose("Keyring provider set: import")
+            return impl
+        except ImportError:
+            pass
+        except Exception as exc:
+            # In the event of an unexpected exception
+            # we should warn the user
+            msg = "Installed copy of keyring fails with exception %s"
+            if provider == "auto":
+                msg = msg + ", trying to find a keyring executable as a fallback"
+            logger.warning(msg, exc, exc_info=logger.isEnabledFor(logging.DEBUG))
+    if provider in "subprocess", "auto":
+        cli = shutil.which("keyring")
+        if cli and cli.startswith(sysconfig.get_path("scripts")):
+            # all code within this function is stolen from shutil.which implementation
+            @typing.no_type_check
+            def PATH_as_shutil_which_determines_it() -> str:
+                path = os.environ.get("PATH", None)
+                if path is None:
+                    try:
+                        path = os.confstr("CS_PATH")
+                    except (AttributeError, ValueError):
+                        # os.confstr() or CS_PATH is not available
+                        path = os.defpath
+                # bpo-35755: Don't use os.defpath if the PATH environment variable is
+                # set to an empty string
+
+                return path
+
+            scripts = Path(sysconfig.get_path("scripts"))
+
+            paths = 
+            for path in PATH_as_shutil_which_determines_it().split(os.pathsep):
+                p = Path(path)
+                try:
+                    if not p.samefile(scripts):
+                        paths.append(path)
+                except FileNotFoundError:
+                    pass
+
+            path = os.pathsep.join(paths)
+
+            cli = shutil.which("keyring", path=path)
+
+        if cli:
+            logger.verbose("Keyring provider set: subprocess with executable %s", cli)
+            return KeyRingCliProvider(cli)
+
+    logger.verbose("Keyring provider set: disabled")
+    return KeyRingNullProvider()
 
 
 class MultiDomainBasicAuth(AuthBase):
     def __init__(
-        self, prompting: bool = True, index_urls: OptionalListstr = None
+        self,
+        prompting: bool = True,
+        index_urls: OptionalListstr = None,
+        keyring_provider: str = "auto",
     ) -> None:
         self.prompting = prompting
         self.index_urls = index_urls
+        self.keyring_provider = keyring_provider  # type: ignoreassignment
         self.passwords: Dictstr, AuthInfo = {}
         # When the user is prompted to enter credentials and keyring is
         # available, we will offer to save them. If the user accepts,
@@ -84,6 +238,47 @@
         # ``save_credentials`` to save these.
         self._credentials_to_save: OptionalCredentials = None
 
+    @property
+    def keyring_provider(self) -> KeyRingBaseProvider:
+        return get_keyring_provider(self._keyring_provider)
+
+    @keyring_provider.setter
+    def keyring_provider(self, provider: str) -> None:
+        # The free function get_keyring_provider has been decorated with
+        # functools.cache. If an exception occurs in get_keyring_auth that
+        # cache will be cleared and keyring disabled, take that into account
+        # if you want to remove this indirection.
+        self._keyring_provider = provider
+
+    @property
+    def use_keyring(self) -> bool:
+        # We won't use keyring when --no-input is passed unless
+        # a specific provider is requested because it might require
+        # user interaction
+        return self.prompting or self._keyring_provider not in "auto", "disabled"
+
+    def _get_keyring_auth(
+        self,
+        url: Optionalstr,
+        username: Optionalstr,
+    ) -> OptionalAuthInfo:
+        """Return the tuple auth for a given url from keyring."""
+        # Do nothing if no url was provided
+        if not url:
+            return None
+
+        try:
+            return self.keyring_provider.get_auth_info(url, username)
+        except Exception as exc:
+            logger.warning(
+                "Keyring is skipped due to an exception: %s",
+                str(exc),
+            )
+            global KEYRING_DISABLED
+            KEYRING_DISABLED = True
+            get_keyring_provider.cache_clear()
+            return None
+
     def _get_index_url(self, url: str) -> Optionalstr:
         """Return the original index URL matching the requested URL.
 
@@ -100,15 +295,42 @@
         if not url or not self.index_urls:
             return None
 
-        for u in self.index_urls:
-            prefix = remove_auth_from_url(u).rstrip("/") + "/"
-            if url.startswith(prefix):
-                return u
-        return None
+        url = remove_auth_from_url(url).rstrip("/") + "/"
+        parsed_url = urllib.parse.urlsplit(url)
+
+        candidates = 
+
+        for index in self.index_urls:
+            index = index.rstrip("/") + "/"
+            parsed_index = urllib.parse.urlsplit(remove_auth_from_url(index))
+            if parsed_url == parsed_index:
+                return index
+
+            if parsed_url.netloc != parsed_index.netloc:
+                continue
+
+            candidate = urllib.parse.urlsplit(index)
+            candidates.append(candidate)
+
+        if not candidates:
+            return None
+
+        candidates.sort(
+            reverse=True,
+            key=lambda candidate: commonprefix(
+                
+                    parsed_url.path,
+                    candidate.path,
+                
+            ).rfind("/"),
+        )
+
+        return urllib.parse.urlunsplit(candidates0)
 
     def _get_new_credentials(
         self,
         original_url: str,
+        *,
         allow_netrc: bool = True,
         allow_keyring: bool = False,
     ) -> AuthInfo:
@@ -152,8 +374,8 @@
             # The index url is more specific than the netloc, so try it first
             # fmt: off
             kr_auth = (
-                get_keyring_auth(index_url, username) or
-                get_keyring_auth(netloc, username)
+                self._get_keyring_auth(index_url, username) or
+                self._get_keyring_auth(netloc, username)
             )
             # fmt: on
             if kr_auth:
@@ -230,18 +452,23 @@
     def _prompt_for_password(
         self, netloc: str
     ) -> TupleOptionalstr, Optionalstr, bool:
-        username = ask_input(f"User for {netloc}: ")
+        username = ask_input(f"User for {netloc}: ") if self.prompting else None
         if not username:
             return None, None, False
-        auth = get_keyring_auth(netloc, username)
-        if auth and auth0 is not None and auth1 is not None:
-            return auth0, auth1, False
+        if self.use_keyring:
+            auth = self._get_keyring_auth(netloc, username)
+            if auth and auth0 is not None and auth1 is not None:
+                return auth0, auth1, False
         password = ask_password("Password: ")
         return username, password, True
 
     # Factored out to allow for easy patching in tests
     def _should_save_password_to_keyring(self) -> bool:
-        if not keyring:
+        if (
+            not self.prompting
+            or not self.use_keyring
+            or not self.keyring_provider.has_keyring
+        ):
             return False
         return ask("Save credentials to keyring y/N: ", "y", "n") == "y"
 
@@ -251,19 +478,22 @@
         if resp.status_code != 401:
             return resp
 
+        username, password = None, None
+
+        # Query the keyring for credentials:
+        if self.use_keyring:
+            username, password = self._get_new_credentials(
+                resp.url,
+                allow_netrc=False,
+                allow_keyring=True,
+            )
+
         # We are not able to prompt the user so simply return the response
-        if not self.prompting:
+        if not self.prompting and not username and not password:
             return resp
 
         parsed = urllib.parse.urlparse(resp.url)
 
-        # Query the keyring for credentials:
-        username, password = self._get_new_credentials(
-            resp.url,
-            allow_netrc=False,
-            allow_keyring=True,
-        )
-
         # Prompt the user for a new username and password
         save = False
         if not username and not password:
@@ -276,7 +506,11 @@
 
             # Prompt to save the password to keyring
             if save and self._should_save_password_to_keyring():
-                self._credentials_to_save = (parsed.netloc, username, password)
+                self._credentials_to_save = Credentials(
+                    url=parsed.netloc,
+                    username=username,
+                    password=password,
+                )
 
         # Consume content and release the original connection to allow our new
         #   request to reuse the same one.
@@ -309,15 +543,17 @@
 
     def save_credentials(self, resp: Response, **kwargs: Any) -> None:
         """Response callback to save credentials on success."""
-        assert keyring is not None, "should never reach here without keyring"
-        if not keyring:
-            return
+        assert (
+            self.keyring_provider.has_keyring
+        ), "should never reach here without keyring"
 
         creds = self._credentials_to_save
         self._credentials_to_save = None
         if creds and resp.status_code < 400:
             try:
                 logger.info("Saving credentials to keyring")
-                keyring.set_password(*creds)
+                self.keyring_provider.save_auth_info(
+                    creds.url, creds.username, creds.password
+                )
             except Exception:
                 logger.exception("Failed to save credentials")

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/network/lazy_wheel.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/network/lazy_wheel.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/network/session.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/network/session.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/build/metadata.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/build/metadata.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/build/metadata_editable.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/build/metadata_editable.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/build/wheel.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/build/wheel.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/build/wheel_editable.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/build/wheel_editable.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/check.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/check.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/freeze.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/freeze.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/install/editable_legacy.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/install/editable_legacy.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/install/wheel.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/install/wheel.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/operations/prepare.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/operations/prepare.py Changed

@@ -179,7 +179,10 @@
 
 
 def _check_download_dir(
-    link: Link, download_dir: str, hashes: OptionalHashes
+    link: Link,
+    download_dir: str,
+    hashes: OptionalHashes,
+    warn_on_hash_mismatch: bool = True,
 ) -> Optionalstr:
     """Check download_dir for previously downloaded file with correct hash
     If a correct file is found return its path else None
@@ -195,10 +198,11 @@
         try:
             hashes.check_against_path(download_path)
         except HashMismatch:
-            logger.warning(
-                "Previously-downloaded file %s has bad hash. Re-downloading.",
-                download_path,
-            )
+            if warn_on_hash_mismatch:
+                logger.warning(
+                    "Previously-downloaded file %s has bad hash. Re-downloading.",
+                    download_path,
+                )
             os.unlink(download_path)
             return None
     return download_path
@@ -263,18 +267,28 @@
 
     def _log_preparing_link(self, req: InstallRequirement) -> None:
         """Provide context for the requirement being prepared."""
-        if req.link.is_file and not req.original_link_is_in_wheel_cache:
+        if req.link.is_file and not req.is_wheel_from_cache:
             message = "Processing %s"
             information = str(display_path(req.link.file_path))
         else:
             message = "Collecting %s"
             information = str(req.req or req)
 
+        # If we used req.req, inject requirement source if available (this
+        # would already be included if we used req directly)
+        if req.req and req.comes_from:
+            if isinstance(req.comes_from, str):
+                comes_from: Optionalstr = req.comes_from
+            else:
+                comes_from = req.comes_from.from_path()
+            if comes_from:
+                information += f" (from {comes_from})"
+
         if (message, information) != self._previous_requirement_header:
             self._previous_requirement_header = (message, information)
             logger.info(message, information)
 
-        if req.original_link_is_in_wheel_cache:
+        if req.is_wheel_from_cache:
             with indent_log():
                 logger.info("Using cached %s", req.link.filename)
 
@@ -475,7 +489,18 @@
             file_path = None
             if self.download_dir is not None and req.link.is_wheel:
                 hashes = self._get_linked_req_hashes(req)
-                file_path = _check_download_dir(req.link, self.download_dir, hashes)
+                file_path = _check_download_dir(
+                    req.link,
+                    self.download_dir,
+                    hashes,
+                    # When a locally built wheel has been found in cache, we don't warn
+                    # about re-downloading when the already downloaded wheel hash does
+                    # not match. This is because the hash must be checked against the
+                    # original link, not the cached link. It that case the already
+                    # downloaded file will be removed and re-fetched from cache (which
+                    # implies a hash check against the cache entry's origin.json).
+                    warn_on_hash_mismatch=not req.is_wheel_from_cache,
+                )
 
             if file_path is not None:
                 # The file is already available, so mark it as downloaded
@@ -526,9 +551,35 @@
         assert req.link
         link = req.link
 
-        self._ensure_link_req_src_dir(req, parallel_builds)
         hashes = self._get_linked_req_hashes(req)
 
+        if hashes and req.is_wheel_from_cache:
+            assert req.download_info is not None
+            assert link.is_wheel
+            assert link.is_file
+            # We need to verify hashes, and we have found the requirement in the cache
+            # of locally built wheels.
+            if (
+                isinstance(req.download_info.info, ArchiveInfo)
+                and req.download_info.info.hashes
+                and hashes.has_one_of(req.download_info.info.hashes)
+            ):
+                # At this point we know the requirement was built from a hashable source
+                # artifact, and we verified that the cache entry's hash of the original
+                # artifact matches one of the hashes we expect. We don't verify hashes
+                # against the cached wheel, because the wheel is not the original.
+                hashes = None
+            else:
+                logger.warning(
+                    "The hashes of the source archive found in cache entry "
+                    "don't match, ignoring cached built wheel "
+                    "and re-downloading source."
+                )
+                req.link = req.cached_wheel_source_link
+                link = req.link
+
+        self._ensure_link_req_src_dir(req, parallel_builds)
+
         if link.is_existing_dir():
             local_file = None
         elif link.url not in self._downloaded:
@@ -561,12 +612,15 @@
             # Make sure we have a hash in download_info. If we got it as part of the
             # URL, it will have been verified and we can rely on it. Otherwise we
             # compute it from the downloaded file.
+            # FIXME: https://github.com/pypa/pip/issues/11943
             if (
                 isinstance(req.download_info.info, ArchiveInfo)
-                and not req.download_info.info.hash
+                and not req.download_info.info.hashes
                 and local_file
             ):
                 hash = hash_file(local_file.path)0.hexdigest()
+                # We populate info.hash for backward compatibility.
+                # This will automatically populate info.hashes.
                 req.download_info.info.hash = f"sha256={hash}"
 
         # For use in later processing,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/pyproject.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/pyproject.py Changed

@@ -91,14 +91,19 @@
     # If we haven't worked out whether to use PEP 517 yet,
     # and the user hasn't explicitly stated a preference,
     # we do so if the project has a pyproject.toml file
-    # or if we cannot import setuptools.
+    # or if we cannot import setuptools or wheels.
 
-    # We fallback to PEP 517 when without setuptools,
+    # We fallback to PEP 517 when without setuptools or without the wheel package,
     # so setuptools can be installed as a default build backend.
     # For more info see:
     # https://discuss.python.org/t/pip-without-setuptools-could-the-experience-be-improved/11810/9
+    # https://github.com/pypa/pip/issues/8559
     elif use_pep517 is None:
-        use_pep517 = has_pyproject or not importlib.util.find_spec("setuptools")
+        use_pep517 = (
+            has_pyproject
+            or not importlib.util.find_spec("setuptools")
+            or not importlib.util.find_spec("wheel")
+        )
 
     # At this point, we know whether we're going to use PEP 517.
     assert use_pep517 is not None
@@ -159,9 +164,8 @@
     if backend is None:
         # If the user didn't specify a backend, we assume they want to use
         # the setuptools backend. But we can't be sure they have included
-        # a version of setuptools which supplies the backend, or wheel
-        # (which is needed by the backend) in their requirements. So we
-        # make a note to check that those requirements are present once
+        # a version of setuptools which supplies the backend. So we
+        # make a note to check that this requirement is present once
         # we have set up the environment.
         # This is quite a lot of work to check for a very specific case. But
         # the problem is, that case is potentially quite common - projects that
@@ -170,6 +174,6 @@
         # tools themselves. The original PEP 518 code had a similar check (but
         # implemented in a different way).
         backend = "setuptools.build_meta:__legacy__"
-        check = "setuptools>=40.8.0", "wheel"
+        check = "setuptools>=40.8.0"
 
     return BuildSystemDetails(requires, backend, check, backend_path)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/req/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/req/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/req/constructors.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/req/constructors.py Changed

@@ -11,7 +11,7 @@
 import logging
 import os
 import re
-from typing import Any, Dict, Optional, Set, Tuple, Union
+from typing import Dict, List, Optional, Set, Tuple, Union
 
 from pip._vendor.packaging.markers import Marker
 from pip._vendor.packaging.requirements import InvalidRequirement, Requirement
@@ -201,15 +201,16 @@
 def install_req_from_editable(
     editable_req: str,
     comes_from: OptionalUnionInstallRequirement, str = None,
+    *,
     use_pep517: Optionalbool = None,
     isolated: bool = False,
-    options: OptionalDictstr, Any = None,
+    global_options: OptionalListstr = None,
+    hash_options: OptionalDictstr, Liststr = None,
     constraint: bool = False,
     user_supplied: bool = False,
     permit_editable_wheels: bool = False,
-    config_settings: OptionalDictstr, str = None,
+    config_settings: OptionalDictstr, Unionstr, Liststr = None,
 ) -> InstallRequirement:
-
     parts = parse_req_from_editable(editable_req)
 
     return InstallRequirement(
@@ -222,9 +223,8 @@
         constraint=constraint,
         use_pep517=use_pep517,
         isolated=isolated,
-        install_options=options.get("install_options", ) if options else ,
-        global_options=options.get("global_options", ) if options else ,
-        hash_options=options.get("hashes", {}) if options else {},
+        global_options=global_options,
+        hash_options=hash_options,
         config_settings=config_settings,
         extras=parts.extras,
     )
@@ -376,13 +376,15 @@
 def install_req_from_line(
     name: str,
     comes_from: OptionalUnionstr, InstallRequirement = None,
+    *,
     use_pep517: Optionalbool = None,
     isolated: bool = False,
-    options: OptionalDictstr, Any = None,
+    global_options: OptionalListstr = None,
+    hash_options: OptionalDictstr, Liststr = None,
     constraint: bool = False,
     line_source: Optionalstr = None,
     user_supplied: bool = False,
-    config_settings: OptionalDictstr, str = None,
+    config_settings: OptionalDictstr, Unionstr, Liststr = None,
 ) -> InstallRequirement:
     """Creates an InstallRequirement from a name, which might be a
     requirement, directory containing 'setup.py', filename, or URL.
@@ -399,9 +401,8 @@
         markers=parts.markers,
         use_pep517=use_pep517,
         isolated=isolated,
-        install_options=options.get("install_options", ) if options else ,
-        global_options=options.get("global_options", ) if options else ,
-        hash_options=options.get("hashes", {}) if options else {},
+        global_options=global_options,
+        hash_options=hash_options,
         config_settings=config_settings,
         constraint=constraint,
         extras=parts.extras,
@@ -415,7 +416,6 @@
     isolated: bool = False,
     use_pep517: Optionalbool = None,
     user_supplied: bool = False,
-    config_settings: OptionalDictstr, str = None,
 ) -> InstallRequirement:
     try:
         req = get_requirement(req_string)
@@ -445,7 +445,6 @@
         isolated=isolated,
         use_pep517=use_pep517,
         user_supplied=user_supplied,
-        config_settings=config_settings,
     )
 
 
@@ -454,7 +453,7 @@
     isolated: bool = False,
     use_pep517: Optionalbool = None,
     user_supplied: bool = False,
-    config_settings: OptionalDictstr, str = None,
+    config_settings: OptionalDictstr, Unionstr, Liststr = None,
 ) -> InstallRequirement:
     if parsed_req.is_editable:
         req = install_req_from_editable(
@@ -473,7 +472,14 @@
             comes_from=parsed_req.comes_from,
             use_pep517=use_pep517,
             isolated=isolated,
-            options=parsed_req.options,
+            global_options=(
+                parsed_req.options.get("global_options", )
+                if parsed_req.options
+                else 
+            ),
+            hash_options=(
+                parsed_req.options.get("hashes", {}) if parsed_req.options else {}
+            ),
             constraint=parsed_req.constraint,
             line_source=parsed_req.line_source,
             user_supplied=user_supplied,
@@ -493,7 +499,6 @@
         markers=ireq.markers,
         use_pep517=ireq.use_pep517,
         isolated=ireq.isolated,
-        install_options=ireq.install_options,
         global_options=ireq.global_options,
         hash_options=ireq.hash_options,
         config_settings=ireq.config_settings,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/req/req_file.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/req/req_file.py Changed

@@ -2,6 +2,7 @@
 Requirements file parsing
 """
 
+import logging
 import optparse
 import os
 import re
@@ -69,14 +70,16 @@
 
 # options to be passed to requirements
 SUPPORTED_OPTIONS_REQ: ListCallable..., optparse.Option = 
-    cmdoptions.install_options,
     cmdoptions.global_options,
     cmdoptions.hash,
+    cmdoptions.config_settings,
 
 
 # the 'dest' string values
 SUPPORTED_OPTIONS_REQ_DEST = str(o().dest) for o in SUPPORTED_OPTIONS_REQ
 
+logger = logging.getLogger(__name__)
+
 
 class ParsedRequirement:
     def __init__(
@@ -166,7 +169,6 @@
     line: ParsedLine,
     options: Optionaloptparse.Values = None,
 ) -> ParsedRequirement:
-
     # preserve for the nested code path
     line_comes_from = "{} {} (line {})".format(
         "-c" if line.constraint else "-r",
@@ -211,6 +213,12 @@
     options: Optionaloptparse.Values = None,
     session: OptionalPipSession = None,
 ) -> None:
+    if opts.hashes:
+        logger.warning(
+            "%s line %s has --hash but no requirement, and will be ignored.",
+            filename,
+            lineno,
+        )
 
     if options:
         # percolate options upward

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/req/req_install.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/req/req_install.py Changed

@@ -8,7 +8,6 @@
 import sys
 import uuid
 import zipfile
-from enum import Enum
 from optparse import Values
 from typing import Any, Collection, Dict, Iterable, List, Optional, Sequence, Union
 
@@ -18,10 +17,10 @@
 from pip._vendor.packaging.utils import canonicalize_name
 from pip._vendor.packaging.version import Version
 from pip._vendor.packaging.version import parse as parse_version
-from pip._vendor.pep517.wrappers import Pep517HookCaller
+from pip._vendor.pyproject_hooks import BuildBackendHookCaller
 
 from pip._internal.build_env import BuildEnvironment, NoOpBuildEnvironment
-from pip._internal.exceptions import InstallationError, LegacyInstallFailure
+from pip._internal.exceptions import InstallationError
 from pip._internal.locations import get_scheme
 from pip._internal.metadata import (
     BaseDistribution,
@@ -40,18 +39,13 @@
 from pip._internal.operations.install.editable_legacy import (
     install_editable as install_editable_legacy,
 )
-from pip._internal.operations.install.legacy import install as install_legacy
 from pip._internal.operations.install.wheel import install_wheel
 from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path
 from pip._internal.req.req_uninstall import UninstallPathSet
-from pip._internal.utils.deprecation import LegacyInstallReason, deprecated
-from pip._internal.utils.direct_url_helpers import (
-    direct_url_for_editable,
-    direct_url_from_link,
-)
+from pip._internal.utils.deprecation import deprecated
 from pip._internal.utils.hashes import Hashes
 from pip._internal.utils.misc import (
-    ConfiguredPep517HookCaller,
+    ConfiguredBuildBackendHookCaller,
     ask_path_exists,
     backup_dir,
     display_path,
@@ -83,10 +77,10 @@
         markers: OptionalMarker = None,
         use_pep517: Optionalbool = None,
         isolated: bool = False,
-        install_options: OptionalListstr = None,
+        *,
         global_options: OptionalListstr = None,
         hash_options: OptionalDictstr, Liststr = None,
-        config_settings: OptionalDictstr, str = None,
+        config_settings: OptionalDictstr, Unionstr, Liststr = None,
         constraint: bool = False,
         extras: Collectionstr = (),
         user_supplied: bool = False,
@@ -98,7 +92,6 @@
         self.constraint = constraint
         self.editable = editable
         self.permit_editable_wheels = permit_editable_wheels
-        self.legacy_install_reason: OptionalLegacyInstallReason = None
 
         # source_dir is the local directory where the linked requirement is
         # located, or unpacked. In case unpacking is needed, creating and
@@ -115,7 +108,11 @@
             # PEP 508 URL requirement
             link = Link(req.url)
         self.link = self.original_link = link
-        self.original_link_is_in_wheel_cache = False
+
+        # When this InstallRequirement is a wheel obtained from the cache of locally
+        # built wheels, this is the source link corresponding to the cache entry, which
+        # was used to download and build the cached wheel.
+        self.cached_wheel_source_link: OptionalLink = None
 
         # Information about the location of the artifact that was downloaded . This
         # property is guaranteed to be set in resolver results.
@@ -146,7 +143,6 @@
         # Set to True after successful installation
         self.install_succeeded: Optionalbool = None
         # Supplied options
-        self.install_options = install_options if install_options else 
         self.global_options = global_options if global_options else 
         self.hash_options = hash_options if hash_options else {}
         self.config_settings = config_settings
@@ -173,7 +169,7 @@
         self.requirements_to_check: Liststr = 
 
         # The PEP 517 backend we should use to build the project
-        self.pep517_backend: OptionalPep517HookCaller = None
+        self.pep517_backend: OptionalBuildBackendHookCaller = None
 
         # Are we using PEP 517 for this requirement?
         # After pyproject.toml has been loaded, the only valid values are True
@@ -195,7 +191,11 @@
         else:
             s = "<InstallRequirement>"
         if self.satisfied_by is not None:
-            s += " in {}".format(display_path(self.satisfied_by.location))
+            if self.satisfied_by.location is not None:
+                location = display_path(self.satisfied_by.location)
+            else:
+                location = "<memory>"
+            s += f" in {location}"
         if self.comes_from:
             if isinstance(self.comes_from, str):
                 comes_from: Optionalstr = self.comes_from
@@ -291,7 +291,12 @@
 
         """
         good_hashes = self.hash_options.copy()
-        link = self.link if trust_internet else self.original_link
+        if trust_internet:
+            link = self.link
+        elif self.original_link and self.user_supplied:
+            link = self.original_link
+        else:
+            link = None
         if link and link.hash:
             good_hashes.setdefault(link.hash_name, ).append(link.hash)
         return Hashes(good_hashes)
@@ -436,6 +441,12 @@
             return False
         return self.link.is_wheel
 
+    @property
+    def is_wheel_from_cache(self) -> bool:
+        # When True, it means that this InstallRequirement is a local wheel file in the
+        # cache of locally built wheels.
+        return self.cached_wheel_source_link is not None
+
     # Things valid for sdists
     @property
     def unpacked_source_directory(self) -> str:
@@ -475,6 +486,15 @@
         )
 
         if pyproject_toml_data is None:
+            if self.config_settings:
+                deprecated(
+                    reason=f"Config settings are ignored for project {self}.",
+                    replacement=(
+                        "to use --use-pep517 or add a "
+                        "pyproject.toml file to the project"
+                    ),
+                    gone_in="23.3",
+                )
             self.use_pep517 = False
             return
 
@@ -482,7 +502,7 @@
         requires, backend, check, backend_path = pyproject_toml_data
         self.requirements_to_check = check
         self.pyproject_requires = requires
-        self.pep517_backend = ConfiguredPep517HookCaller(
+        self.pep517_backend = ConfiguredBuildBackendHookCaller(
             self,
             self.unpacked_source_directory,
             backend,
@@ -742,7 +762,6 @@
 
     def install(
         self,
-        install_options: Liststr,
         global_options: OptionalSequencestr = None,
         root: Optionalstr = None,
         home: Optionalstr = None,
@@ -760,11 +779,9 @@
             prefix=prefix,
         )
 
-        global_options = global_options if global_options is not None else 
         if self.editable and not self.is_wheel:
             install_editable_legacy(
-                install_options,
-                global_options,
+                global_options=global_options if global_options is not None else ,
                 prefix=prefix,
                 home=home,
                 use_user_site=use_user_site,
@@ -777,82 +794,23 @@
             self.install_succeeded = True
             return
 
-        if self.is_wheel:
-            assert self.local_file_path
-            direct_url = None
-            # TODO this can be refactored to direct_url = self.download_info
-            if self.editable:
-                direct_url = direct_url_for_editable(self.unpacked_source_directory)
-            elif self.original_link:
-                direct_url = direct_url_from_link(
-                    self.original_link,
-                    self.source_dir,
-                    self.original_link_is_in_wheel_cache,
-                )
-            install_wheel(
-                self.name,
-                self.local_file_path,
-                scheme=scheme,
-                req_description=str(self.req),
-                pycompile=pycompile,
-                warn_script_location=warn_script_location,
-                direct_url=direct_url,
-                requested=self.user_supplied,
-            )
-            self.install_succeeded = True
-            return
-
-        # TODO: Why don't we do this for editable installs?
-
-        # Extend the list of global and install options passed on to
-        # the setup.py call with the ones from the requirements file.
-        # Options specified in requirements file override those
-        # specified on the command line, since the last option given
-        # to setup.py is the one that is used.
-        global_options = list(global_options) + self.global_options
-        install_options = list(install_options) + self.install_options
-
-        try:
-            if (
-                self.legacy_install_reason is not None
-                and self.legacy_install_reason.emit_before_install
-            ):
-                self.legacy_install_reason.emit_deprecation(self.name)
-            success = install_legacy(
-                install_options=install_options,
-                global_options=global_options,
-                root=root,
-                home=home,
-                prefix=prefix,
-                use_user_site=use_user_site,
-                pycompile=pycompile,
-                scheme=scheme,
-                setup_py_path=self.setup_py_path,
-                isolated=self.isolated,
-                req_name=self.name,
-                build_env=self.build_env,
-                unpacked_source_directory=self.unpacked_source_directory,
-                req_description=str(self.req),
-            )
-        except LegacyInstallFailure as exc:
-            self.install_succeeded = False
-            raise exc
-        except Exception:
-            self.install_succeeded = True
-            raise
-
-        self.install_succeeded = success
+        assert self.is_wheel
+        assert self.local_file_path
 
-        if (
-            success
-            and self.legacy_install_reason is not None
-            and self.legacy_install_reason.emit_after_success
-        ):
-            self.legacy_install_reason.emit_deprecation(self.name)
+        install_wheel(
+            self.name,
+            self.local_file_path,
+            scheme=scheme,
+            req_description=str(self.req),
+            pycompile=pycompile,
+            warn_script_location=warn_script_location,
+            direct_url=self.download_info if self.original_link else None,
+            requested=self.user_supplied,
+        )
+        self.install_succeeded = True
 
 
 def check_invalid_constraint_type(req: InstallRequirement) -> str:
-
     # Check for unsupported forms
     problem = ""
     if not req.name:
@@ -889,54 +847,21 @@
     return False
 
 
-def _install_option_ignored(
-    install_options: Liststr, reqs: ListInstallRequirement
-) -> bool:
-    for req in reqs:
-        if (install_options or req.install_options) and not req.use_pep517:
-            return False
-    return True
-
-
-class LegacySetupPyOptionsCheckMode(Enum):
-    INSTALL = 1
-    WHEEL = 2
-    DOWNLOAD = 3
-
-
 def check_legacy_setup_py_options(
     options: Values,
     reqs: ListInstallRequirement,
-    mode: LegacySetupPyOptionsCheckMode,
 ) -> None:
-    has_install_options = _has_option(options, reqs, "install_options")
     has_build_options = _has_option(options, reqs, "build_options")
     has_global_options = _has_option(options, reqs, "global_options")
-    legacy_setup_py_options_present = (
-        has_install_options or has_build_options or has_global_options
-    )
-    if not legacy_setup_py_options_present:
-        return
-
-    options.format_control.disallow_binaries()
-    logger.warning(
-        "Implying --no-binary=:all: due to the presence of "
-        "--build-option / --global-option / --install-option. "
-        "Consider using --config-settings for more flexibility.",
-    )
-    if mode == LegacySetupPyOptionsCheckMode.INSTALL and has_install_options:
-        if _install_option_ignored(options.install_options, reqs):
-            logger.warning(
-                "Ignoring --install-option when building using PEP 517",
-            )
-        else:
-            deprecated(
-                reason=(
-                    "--install-option is deprecated because "
-                    "it forces pip to use the 'setup.py install' "
-                    "command which is itself deprecated."
-                ),
-                issue=11358,
-                replacement="to use --config-settings",
-                gone_in="23.1",
-            )
+    if has_build_options or has_global_options:
+        deprecated(
+            reason="--build-option and --global-option are deprecated.",
+            issue=11859,
+            replacement="to use --config-settings",
+            gone_in="23.3",
+        )
+        logger.warning(
+            "Implying --no-binary=:all: due to the presence of "
+            "--build-option / --global-option. "
+        )
+        options.format_control.disallow_binaries()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/req/req_uninstall.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/req/req_uninstall.py Changed

@@ -11,8 +11,9 @@
 from pip._internal.utils.compat import WINDOWS
 from pip._internal.utils.egg_link import egg_link_path_from_location
 from pip._internal.utils.logging import getLogger, indent_log
-from pip._internal.utils.misc import ask, is_local, normalize_path, renames, rmtree
+from pip._internal.utils.misc import ask, normalize_path, renames, rmtree
 from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory
+from pip._internal.utils.virtualenv import running_under_virtualenv
 
 logger = getLogger(__name__)
 
@@ -312,6 +313,10 @@
         self._pth: Dictstr, UninstallPthEntries = {}
         self._dist = dist
         self._moved_paths = StashedUninstallPathSet()
+        # Create local cache of normalize_path results. Creating an UninstallPathSet
+        # can result in hundreds/thousands of redundant calls to normalize_path with
+        # the same args, which hurts performance.
+        self._normalize_path_cached = functools.lru_cache()(normalize_path)
 
     def _permitted(self, path: str) -> bool:
         """
@@ -319,14 +324,17 @@
         remove/modify, False otherwise.
 
         """
-        return is_local(path)
+        # aka is_local, but caching normalized sys.prefix
+        if not running_under_virtualenv():
+            return True
+        return path.startswith(self._normalize_path_cached(sys.prefix))
 
     def add(self, path: str) -> None:
         head, tail = os.path.split(path)
 
         # we normalize the head to resolve parent directory symlinks, but not
         # the tail, since we only want to uninstall symlinks, not their targets
-        path = os.path.join(normalize_path(head), os.path.normcase(tail))
+        path = os.path.join(self._normalize_path_cached(head), os.path.normcase(tail))
 
         if not os.path.exists(path):
             return
@@ -341,7 +349,7 @@
             self.add(cache_from_source(path))
 
     def add_pth(self, pth_file: str, entry: str) -> None:
-        pth_file = normalize_path(pth_file)
+        pth_file = self._normalize_path_cached(pth_file)
         if self._permitted(pth_file):
             if pth_file not in self._pth:
                 self._pthpth_file = UninstallPthEntries(pth_file)
@@ -531,12 +539,14 @@
             # above, so this only covers the setuptools-style editable.
             with open(develop_egg_link) as fh:
                 link_pointer = os.path.normcase(fh.readline().strip())
-                normalized_link_pointer = normalize_path(link_pointer)
+                normalized_link_pointer = paths_to_remove._normalize_path_cached(
+                    link_pointer
+                )
             assert os.path.samefile(
                 normalized_link_pointer, normalized_dist_location
             ), (
-                f"Egg-link {link_pointer} does not match installed location of "
-                f"{dist.raw_name} (at {dist_location})"
+                f"Egg-link {develop_egg_link} (to {link_pointer}) does not match "
+                f"installed location of {dist.raw_name} (at {dist_location})"
             )
             paths_to_remove.add(develop_egg_link)
             easy_install_pth = os.path.join(

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/legacy/resolver.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/legacy/resolver.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/resolvelib/candidates.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/resolvelib/candidates.py Changed

@@ -65,15 +65,13 @@
         use_pep517=template.use_pep517,
         isolated=template.isolated,
         constraint=template.constraint,
-        options=dict(
-            install_options=template.install_options,
-            global_options=template.global_options,
-            hashes=template.hash_options,
-        ),
+        global_options=template.global_options,
+        hash_options=template.hash_options,
         config_settings=template.config_settings,
     )
     ireq.original_link = template.original_link
     ireq.link = link
+    ireq.extras = template.extras
     return ireq
 
 
@@ -81,7 +79,7 @@
     link: Link, template: InstallRequirement
 ) -> InstallRequirement:
     assert template.editable, "template not editable"
-    return install_req_from_editable(
+    ireq = install_req_from_editable(
         link.url,
         user_supplied=template.user_supplied,
         comes_from=template.comes_from,
@@ -89,13 +87,12 @@
         isolated=template.isolated,
         constraint=template.constraint,
         permit_editable_wheels=template.permit_editable_wheels,
-        options=dict(
-            install_options=template.install_options,
-            global_options=template.global_options,
-            hashes=template.hash_options,
-        ),
+        global_options=template.global_options,
+        hash_options=template.hash_options,
         config_settings=template.config_settings,
     )
+    ireq.extras = template.extras
+    return ireq
 
 
 def _make_install_req_from_dist(
@@ -114,11 +111,8 @@
         use_pep517=template.use_pep517,
         isolated=template.isolated,
         constraint=template.constraint,
-        options=dict(
-            install_options=template.install_options,
-            global_options=template.global_options,
-            hashes=template.hash_options,
-        ),
+        global_options=template.global_options,
+        hash_options=template.hash_options,
         config_settings=template.config_settings,
     )
     ireq.satisfied_by = dist
@@ -265,7 +259,7 @@
         version: OptionalCandidateVersion = None,
     ) -> None:
         source_link = link
-        cache_entry = factory.get_wheel_cache_entry(link, name)
+        cache_entry = factory.get_wheel_cache_entry(source_link, name)
         if cache_entry is not None:
             logger.debug("Using cached wheel link: %s", cache_entry.link)
             link = cache_entry.link
@@ -283,13 +277,15 @@
                 )
 
         if cache_entry is not None:
+            assert ireq.link.is_wheel
+            assert ireq.link.is_file
             if cache_entry.persistent and template.link is template.original_link:
-                ireq.original_link_is_in_wheel_cache = True
+                ireq.cached_wheel_source_link = source_link
             if cache_entry.origin is not None:
                 ireq.download_info = cache_entry.origin
             else:
                 # Legacy cache entry that does not have origin.json.
-                # download_info may miss the archive_info.hash field.
+                # download_info may miss the archive_info.hashes field.
                 ireq.download_info = direct_url_from_link(
                     source_link, link_is_in_wheel_cache=cache_entry.persistent
                 )

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/resolvelib/factory.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/resolvelib/factory.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/resolvelib/provider.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/resolvelib/provider.py Changed

@@ -104,7 +104,7 @@
     def identify(self, requirement_or_candidate: UnionRequirement, Candidate) -> str:
         return requirement_or_candidate.name
 
-    def get_preference(  # type: ignore
+    def get_preference(
         self,
         identifier: str,
         resolutions: Mappingstr, Candidate,
@@ -124,14 +124,29 @@
         * If equal, prefer if any requirement is "pinned", i.e. contains
           operator ``===`` or ``==``.
         * If equal, calculate an approximate "depth" and resolve requirements
-          closer to the user-specified requirements first.
+          closer to the user-specified requirements first. If the depth cannot
+          by determined (eg: due to no matching parents), it is considered
+          infinite.
         * Order user-specified requirements by the order they are specified.
         * If equal, prefers "non-free" requirements, i.e. contains at least one
           operator, such as ``>=`` or ``<``.
         * If equal, order alphabetically for consistency (helps debuggability).
         """
-        lookups = (r.get_candidate_lookup() for r, _ in informationidentifier)
-        candidate, ireqs = zip(*lookups)
+        try:
+            next(iter(informationidentifier))
+        except StopIteration:
+            # There is no information for this identifier, so there's no known
+            # candidates.
+            has_information = False
+        else:
+            has_information = True
+
+        if has_information:
+            lookups = (r.get_candidate_lookup() for r, _ in informationidentifier)
+            candidate, ireqs = zip(*lookups)
+        else:
+            candidate, ireqs = None, ()
+
         operators = 
             specifier.operator
             for specifier_set in (ireq.specifier for ireq in ireqs if ireq)
@@ -146,11 +161,14 @@
             requested_order: Unionint, float = self._user_requestedidentifier
         except KeyError:
             requested_order = math.inf
-            parent_depths = (
-                self._known_depthsparent.name if parent is not None else 0.0
-                for _, parent in informationidentifier
-            )
-            inferred_depth = min(d for d in parent_depths) + 1.0
+            if has_information:
+                parent_depths = (
+                    self._known_depthsparent.name if parent is not None else 0.0
+                    for _, parent in informationidentifier
+                )
+                inferred_depth = min(d for d in parent_depths) + 1.0
+            else:
+                inferred_depth = math.inf
         else:
             inferred_depth = 1.0
         self._known_depthsidentifier = inferred_depth
@@ -161,16 +179,6 @@
         # free, so we always do it first to avoid needless work if it fails.
         requires_python = identifier == REQUIRES_PYTHON_IDENTIFIER
 
-        # HACK: Setuptools have a very long and solid backward compatibility
-        # track record, and extremely few projects would request a narrow,
-        # non-recent version range of it since that would break a lot things.
-        # (Most projects specify it only to request for an installer feature,
-        # which does not work, but that's another topic.) Intentionally
-        # delaying Setuptools helps reduce branches the resolver has to check.
-        # This serves as a temporary fix for issues like "apache-airflowall"
-        # while we work on "proper" branch pruning techniques.
-        delay_this = identifier == "setuptools"
-
         # Prefer the causes of backtracking on the assumption that the problem
         # resolving the dependency tree is related to the failures that caused
         # the backtracking
@@ -178,7 +186,6 @@
 
         return (
             not requires_python,
-            delay_this,
             not direct,
             not pinned,
             not backtrack_cause,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/resolvelib/reporter.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/resolvelib/reporter.py Changed

@@ -11,9 +11,9 @@
 
 class PipReporter(BaseReporter):
     def __init__(self) -> None:
-        self.backtracks_by_package: DefaultDictstr, int = defaultdict(int)
+        self.reject_count_by_package: DefaultDictstr, int = defaultdict(int)
 
-        self._messages_at_backtrack = {
+        self._messages_at_reject_count = {
             1: (
                 "pip is looking at multiple versions of {package_name} to "
                 "determine which version is compatible with other "
@@ -32,16 +32,28 @@
             ),
         }
 
-    def backtracking(self, candidate: Candidate) -> None:
-        self.backtracks_by_packagecandidate.name += 1
+    def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None:
+        self.reject_count_by_packagecandidate.name += 1
 
-        count = self.backtracks_by_packagecandidate.name
-        if count not in self._messages_at_backtrack:
+        count = self.reject_count_by_packagecandidate.name
+        if count not in self._messages_at_reject_count:
             return
 
-        message = self._messages_at_backtrackcount
+        message = self._messages_at_reject_countcount
         logger.info("INFO: %s", message.format(package_name=candidate.name))
 
+        msg = "Will try a different candidate, due to conflict:"
+        for req_info in criterion.information:
+            req, parent = req_info.requirement, req_info.parent
+            # Inspired by Factory.get_installation_error
+            msg += "\n    "
+            if parent:
+                msg += f"{parent.name} {parent.version} depends on "
+            else:
+                msg += "The user requested "
+            msg += req.format_for_error()
+        logger.debug(msg)
+
 
 class PipDebuggingReporter(BaseReporter):
     """A reporter that does an info log for every event it sees."""
@@ -61,8 +73,8 @@
     def adding_requirement(self, requirement: Requirement, parent: Candidate) -> None:
         logger.info("Reporter.adding_requirement(%r, %r)", requirement, parent)
 
-    def backtracking(self, candidate: Candidate) -> None:
-        logger.info("Reporter.backtracking(%r)", candidate)
+    def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None:
+        logger.info("Reporter.rejecting_candidate(%r, %r)", criterion, candidate)
 
     def pinning(self, candidate: Candidate) -> None:
         logger.info("Reporter.pinning(%r)", candidate)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/resolvelib/requirements.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/resolvelib/requirements.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/resolution/resolvelib/resolver.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/resolution/resolvelib/resolver.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/self_outdated_check.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/self_outdated_check.py Changed

@@ -133,7 +133,7 @@
         return Group(
             Text(),
             Text.from_markup(
-                f"{notice} A new release of pip available: "
+                f"{notice} A new release of pip is available: "
                 f"red{self.old}reset -> green{self.new}reset"
             ),
             Text.from_markup(
@@ -155,7 +155,7 @@
 
 def _get_current_remote_pip_version(
     session: PipSession, options: optparse.Values
-) -> str:
+) -> Optionalstr:
     # Lets use PackageFinder to see what the latest pip version is
     link_collector = LinkCollector.create(
         session,
@@ -176,7 +176,7 @@
     )
     best_candidate = finder.find_best_candidate("pip").best_candidate
     if best_candidate is None:
-        return
+        return None
 
     return str(best_candidate.version)
 
@@ -186,11 +186,14 @@
     state: SelfCheckState,
     current_time: datetime.datetime,
     local_version: DistributionVersion,
-    get_remote_version: Callable, str,
+    get_remote_version: Callable, Optionalstr,
 ) -> OptionalUpgradePrompt:
     remote_version_str = state.get(current_time)
     if remote_version_str is None:
         remote_version_str = get_remote_version()
+        if remote_version_str is None:
+            logger.debug("No remote pip version found")
+            return None
         state.set(remote_version_str, current_time)
 
     remote_version = parse_version(remote_version_str)

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/_jaraco_text.py Added

@@ -0,0 +1,109 @@
+"""Functions brought over from jaraco.text.
+
+These functions are not supposed to be used within `pip._internal`. These are
+helper functions brought over from `jaraco.text` to enable vendoring newer
+copies of `pkg_resources` without having to vendor `jaraco.text` and its entire
+dependency cone; something that our vendoring setup is not currently capable of
+handling.
+
+License reproduced from original source below:
+
+Copyright Jason R. Coombs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+"""
+
+import functools
+import itertools
+
+
+def _nonblank(str):
+    return str and not str.startswith("#")
+
+
+@functools.singledispatch
+def yield_lines(iterable):
+    r"""
+    Yield valid lines of a string or iterable.
+
+    >>> list(yield_lines(''))
+    
+    >>> list(yield_lines('foo', 'bar'))
+    'foo', 'bar'
+    >>> list(yield_lines('foo\nbar'))
+    'foo', 'bar'
+    >>> list(yield_lines('\nfoo\n#bar\nbaz #comment'))
+    'foo', 'baz #comment'
+    >>> list(yield_lines('foo\nbar', 'baz', 'bing\n\n\n'))
+    'foo', 'bar', 'baz', 'bing'
+    """
+    return itertools.chain.from_iterable(map(yield_lines, iterable))
+
+
+@yield_lines.register(str)
+def _(text):
+    return filter(_nonblank, map(str.strip, text.splitlines()))
+
+
+def drop_comment(line):
+    """
+    Drop comments.
+
+    >>> drop_comment('foo # bar')
+    'foo'
+
+    A hash without a space may be in a URL.
+
+    >>> drop_comment('http://example.com/foo#bar')
+    'http://example.com/foo#bar'
+    """
+    return line.partition(" #")0
+
+
+def join_continuation(lines):
+    r"""
+    Join lines continued by a trailing backslash.
+
+    >>> list(join_continuation('foo \\', 'bar', 'baz'))
+    'foobar', 'baz'
+    >>> list(join_continuation('foo \\', 'bar', 'baz'))
+    'foobar', 'baz'
+    >>> list(join_continuation('foo \\', 'bar \\', 'baz'))
+    'foobarbaz'
+
+    Not sure why, but...
+    The character preceeding the backslash is also elided.
+
+    >>> list(join_continuation('goo\\', 'dly'))
+    'godly'
+
+    A terrible idea, but...
+    If no line is available to continue, suppress the lines.
+
+    >>> list(join_continuation('foo', 'bar\\', 'baz\\'))
+    'foo'
+    """
+    lines = iter(lines)
+    for item in lines:
+        while item.endswith("\\"):
+            try:
+                item = item:-2.strip() + next(lines)
+            except StopIteration:
+                return
+        yield item

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/deprecation.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/deprecation.py Changed

@@ -118,71 +118,3 @@
         raise PipDeprecationWarning(message)
 
     warnings.warn(message, category=PipDeprecationWarning, stacklevel=2)
-
-
-class LegacyInstallReason:
-    def __init__(
-        self,
-        reason: str,
-        replacement: Optionalstr = None,
-        gone_in: Optionalstr = None,
-        feature_flag: Optionalstr = None,
-        issue: Optionalint = None,
-        emit_after_success: bool = False,
-        emit_before_install: bool = False,
-    ):
-        self._reason = reason
-        self._replacement = replacement
-        self._gone_in = gone_in
-        self._feature_flag = feature_flag
-        self._issue = issue
-        self.emit_after_success = emit_after_success
-        self.emit_before_install = emit_before_install
-
-    def emit_deprecation(self, name: str) -> None:
-        deprecated(
-            reason=self._reason.format(name=name),
-            replacement=self._replacement,
-            gone_in=self._gone_in,
-            feature_flag=self._feature_flag,
-            issue=self._issue,
-        )
-
-
-LegacyInstallReasonFailedBdistWheel = LegacyInstallReason(
-    reason=(
-        "{name} was installed using the legacy 'setup.py install' "
-        "method, because a wheel could not be built for it."
-    ),
-    replacement="to fix the wheel build issue reported above",
-    gone_in="23.1",
-    issue=8368,
-    emit_after_success=True,
-)
-
-
-LegacyInstallReasonMissingWheelPackage = LegacyInstallReason(
-    reason=(
-        "{name} is being installed using the legacy "
-        "'setup.py install' method, because it does not have a "
-        "'pyproject.toml' and the 'wheel' package "
-        "is not installed."
-    ),
-    replacement="to enable the '--use-pep517' option",
-    gone_in="23.1",
-    issue=8559,
-    emit_before_install=True,
-)
-
-LegacyInstallReasonNoBinaryForcesSetuptoolsInstall = LegacyInstallReason(
-    reason=(
-        "{name} is being installed using the legacy "
-        "'setup.py install' method, because the '--no-binary' option was enabled "
-        "for it and this currently disables local wheel building for projects that "
-        "don't have a 'pyproject.toml' file."
-    ),
-    replacement="to enable the '--use-pep517' option",
-    gone_in="23.1",
-    issue=11451,
-    emit_before_install=True,
-)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/egg_link.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/egg_link.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/hashes.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/hashes.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/misc.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/misc.py Changed

@@ -12,6 +12,7 @@
 import shutil
 import stat
 import sys
+import sysconfig
 import urllib.parse
 from io import StringIO
 from itertools import filterfalse, tee, zip_longest
@@ -31,14 +32,15 @@
     Tuple,
     Type,
     TypeVar,
+    Union,
     cast,
 )
 
-from pip._vendor.pep517 import Pep517HookCaller
+from pip._vendor.pyproject_hooks import BuildBackendHookCaller
 from pip._vendor.tenacity import retry, stop_after_delay, wait_fixed
 
 from pip import __version__
-from pip._internal.exceptions import CommandError
+from pip._internal.exceptions import CommandError, ExternallyManagedEnvironment
 from pip._internal.locations import get_major_minor_version
 from pip._internal.utils.compat import WINDOWS
 from pip._internal.utils.virtualenv import running_under_virtualenv
@@ -57,10 +59,10 @@
     "captured_stdout",
     "ensure_dir",
     "remove_auth_from_url",
-    "ConfiguredPep517HookCaller",
+    "check_externally_managed",
+    "ConfiguredBuildBackendHookCaller",
 
 
-
 logger = logging.getLogger(__name__)
 
 T = TypeVar("T")
@@ -581,6 +583,21 @@
         )
 
 
+def check_externally_managed() -> None:
+    """Check whether the current environment is externally managed.
+
+    If the ``EXTERNALLY-MANAGED`` config file is found, the current environment
+    is considered externally managed, and an ExternallyManagedEnvironment is
+    raised.
+    """
+    if running_under_virtualenv():
+        return
+    marker = os.path.join(sysconfig.get_path("stdlib"), "EXTERNALLY-MANAGED")
+    if not os.path.isfile(marker):
+        return
+    raise ExternallyManagedEnvironment.from_config(marker)
+
+
 def is_console_interactive() -> bool:
     """Is this console interactive?"""
     return sys.stdin is not None and sys.stdin.isatty()
@@ -598,18 +615,6 @@
     return h, length
 
 
-def is_wheel_installed() -> bool:
-    """
-    Return whether the wheel package is installed.
-    """
-    try:
-        import wheel  # noqa: F401
-    except ImportError:
-        return False
-
-    return True
-
-
 def pairwise(iterable: IterableAny) -> IteratorTupleAny, Any:
     """
     Return paired elements.
@@ -635,7 +640,7 @@
     return filterfalse(pred, t1), filter(pred, t2)
 
 
-class ConfiguredPep517HookCaller(Pep517HookCaller):
+class ConfiguredBuildBackendHookCaller(BuildBackendHookCaller):
     def __init__(
         self,
         config_holder: Any,
@@ -653,7 +658,7 @@
     def build_wheel(
         self,
         wheel_directory: str,
-        config_settings: OptionalDictstr, str = None,
+        config_settings: OptionalDictstr, Unionstr, Liststr = None,
         metadata_directory: Optionalstr = None,
     ) -> str:
         cs = self.config_holder.config_settings
@@ -662,7 +667,9 @@
         )
 
     def build_sdist(
-        self, sdist_directory: str, config_settings: OptionalDictstr, str = None
+        self,
+        sdist_directory: str,
+        config_settings: OptionalDictstr, Unionstr, Liststr = None,
     ) -> str:
         cs = self.config_holder.config_settings
         return super().build_sdist(sdist_directory, config_settings=cs)
@@ -670,7 +677,7 @@
     def build_editable(
         self,
         wheel_directory: str,
-        config_settings: OptionalDictstr, str = None,
+        config_settings: OptionalDictstr, Unionstr, Liststr = None,
         metadata_directory: Optionalstr = None,
     ) -> str:
         cs = self.config_holder.config_settings
@@ -679,19 +686,19 @@
         )
 
     def get_requires_for_build_wheel(
-        self, config_settings: OptionalDictstr, str = None
+        self, config_settings: OptionalDictstr, Unionstr, Liststr = None
     ) -> Liststr:
         cs = self.config_holder.config_settings
         return super().get_requires_for_build_wheel(config_settings=cs)
 
     def get_requires_for_build_sdist(
-        self, config_settings: OptionalDictstr, str = None
+        self, config_settings: OptionalDictstr, Unionstr, Liststr = None
     ) -> Liststr:
         cs = self.config_holder.config_settings
         return super().get_requires_for_build_sdist(config_settings=cs)
 
     def get_requires_for_build_editable(
-        self, config_settings: OptionalDictstr, str = None
+        self, config_settings: OptionalDictstr, Unionstr, Liststr = None
     ) -> Liststr:
         cs = self.config_holder.config_settings
         return super().get_requires_for_build_editable(config_settings=cs)
@@ -699,7 +706,7 @@
     def prepare_metadata_for_build_wheel(
         self,
         metadata_directory: str,
-        config_settings: OptionalDictstr, str = None,
+        config_settings: OptionalDictstr, Unionstr, Liststr = None,
         _allow_fallback: bool = True,
     ) -> str:
         cs = self.config_holder.config_settings
@@ -712,7 +719,7 @@
     def prepare_metadata_for_build_editable(
         self,
         metadata_directory: str,
-        config_settings: OptionalDictstr, str = None,
+        config_settings: OptionalDictstr, Unionstr, Liststr = None,
         _allow_fallback: bool = True,
     ) -> str:
         cs = self.config_holder.config_settings

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/setuptools_build.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/setuptools_build.py Changed

@@ -103,8 +103,8 @@
 
 def make_setuptools_develop_args(
     setup_py_path: str,
+    *,
     global_options: Sequencestr,
-    install_options: Sequencestr,
     no_user_config: bool,
     prefix: Optionalstr,
     home: Optionalstr,
@@ -120,8 +120,6 @@
 
     args += "develop", "--no-deps"
 
-    args += install_options
-
     if prefix:
         args += "--prefix", prefix
     if home is not None:
@@ -146,50 +144,3 @@
         args += "--egg-base", egg_info_dir
 
     return args
-
-
-def make_setuptools_install_args(
-    setup_py_path: str,
-    global_options: Sequencestr,
-    install_options: Sequencestr,
-    record_filename: str,
-    root: Optionalstr,
-    prefix: Optionalstr,
-    header_dir: Optionalstr,
-    home: Optionalstr,
-    use_user_site: bool,
-    no_user_config: bool,
-    pycompile: bool,
-) -> Liststr:
-    assert not (use_user_site and prefix)
-    assert not (use_user_site and root)
-
-    args = make_setuptools_shim_args(
-        setup_py_path,
-        global_options=global_options,
-        no_user_config=no_user_config,
-        unbuffered_output=True,
-    )
-    args += "install", "--record", record_filename
-    args += "--single-version-externally-managed"
-
-    if root is not None:
-        args += "--root", root
-    if prefix is not None:
-        args += "--prefix", prefix
-    if home is not None:
-        args += "--home", home
-    if use_user_site:
-        args += "--user", "--prefix="
-
-    if pycompile:
-        args += "--compile"
-    else:
-        args += "--no-compile"
-
-    if header_dir:
-        args += "--install-headers", header_dir
-
-    args += install_options
-
-    return args

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/subprocess.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/subprocess.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/utils/virtualenv.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/utils/virtualenv.py Changed

@@ -19,7 +19,7 @@
     return sys.prefix != getattr(sys, "base_prefix", sys.prefix)
 
 
-def _running_under_regular_virtualenv() -> bool:
+def _running_under_legacy_virtualenv() -> bool:
     """Checks if sys.real_prefix is set.
 
     This handles virtual environments created with pypa's virtualenv.
@@ -29,8 +29,8 @@
 
 
 def running_under_virtualenv() -> bool:
-    """Return True if we're running inside a virtualenv, False otherwise."""
-    return _running_under_venv() or _running_under_regular_virtualenv()
+    """True if we're running inside a virtual environment, False otherwise."""
+    return _running_under_venv() or _running_under_legacy_virtualenv()
 
 
 def _get_pyvenv_cfg_lines() -> OptionalListstr:
@@ -77,7 +77,7 @@
     return False
 
 
-def _no_global_under_regular_virtualenv() -> bool:
+def _no_global_under_legacy_virtualenv() -> bool:
     """Check if "no-global-site-packages.txt" exists beside site.py
 
     This mirrors logic in pypa/virtualenv for determining whether system
@@ -98,7 +98,7 @@
     if _running_under_venv():
         return _no_global_under_venv()
 
-    if _running_under_regular_virtualenv():
-        return _no_global_under_regular_virtualenv()
+    if _running_under_legacy_virtualenv():
+        return _no_global_under_legacy_virtualenv()
 
     return False

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/vcs/bazaar.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/vcs/bazaar.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/vcs/subversion.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/vcs/subversion.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_internal/wheel_builder.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_internal/wheel_builder.py Changed

@@ -5,7 +5,7 @@
 import os.path
 import re
 import shutil
-from typing import Callable, Iterable, List, Optional, Tuple
+from typing import Iterable, List, Optional, Tuple
 
 from pip._vendor.packaging.utils import canonicalize_name, canonicalize_version
 from pip._vendor.packaging.version import InvalidVersion, Version
@@ -19,12 +19,8 @@
 from pip._internal.operations.build.wheel_editable import build_wheel_editable
 from pip._internal.operations.build.wheel_legacy import build_wheel_legacy
 from pip._internal.req.req_install import InstallRequirement
-from pip._internal.utils.deprecation import (
-    LegacyInstallReasonMissingWheelPackage,
-    LegacyInstallReasonNoBinaryForcesSetuptoolsInstall,
-)
 from pip._internal.utils.logging import indent_log
-from pip._internal.utils.misc import ensure_dir, hash_file, is_wheel_installed
+from pip._internal.utils.misc import ensure_dir, hash_file
 from pip._internal.utils.setuptools_build import make_setuptools_clean_args
 from pip._internal.utils.subprocess import call_subprocess
 from pip._internal.utils.temp_dir import TempDirectory
@@ -35,7 +31,6 @@
 
 _egg_info_re = re.compile(r"(a-z0-9_.+)-(a-z0-9_.!+-+)", re.IGNORECASE)
 
-BdistWheelAllowedPredicate = CallableInstallRequirement, bool
 BuildResult = TupleListInstallRequirement, ListInstallRequirement
 
 
@@ -50,7 +45,6 @@
 def _should_build(
     req: InstallRequirement,
     need_wheel: bool,
-    check_bdist_wheel: OptionalBdistWheelAllowedPredicate = None,
 ) -> bool:
     """Return whether an InstallRequirement should be built into a wheel."""
     if req.constraint:
@@ -78,24 +72,6 @@
         # we only build PEP 660 editable requirements
         return req.supports_pyproject_editable()
 
-    if req.use_pep517:
-        return True
-
-    assert check_bdist_wheel is not None
-    if not check_bdist_wheel(req):
-        # /!\ When we change this to unconditionally return True, we must also remove
-        # support for `--install-option`. Indeed, `--install-option` implies
-        # `--no-binary` so we can return False here and run `setup.py install`.
-        # `--global-option` and `--build-option` can remain until we drop support for
-        # building with `setup.py bdist_wheel`.
-        req.legacy_install_reason = LegacyInstallReasonNoBinaryForcesSetuptoolsInstall
-        return False
-
-    if not is_wheel_installed():
-        # we don't build legacy requirements if wheel is not installed
-        req.legacy_install_reason = LegacyInstallReasonMissingWheelPackage
-        return False
-
     return True
 
 
@@ -107,11 +83,8 @@
 
 def should_build_for_install_command(
     req: InstallRequirement,
-    check_bdist_wheel_allowed: BdistWheelAllowedPredicate,
 ) -> bool:
-    return _should_build(
-        req, need_wheel=False, check_bdist_wheel=check_bdist_wheel_allowed
-    )
+    return _should_build(req, need_wheel=False)
 
 
 def _should_cache(

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/README.rst -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/README.rst Changed

@@ -118,6 +118,30 @@
 ``pip/_vendor/vendor.txt`` and the different patches in
 ``tools/vendoring/patches``.
 Launch it via ``vendoring sync . -v`` (requires ``vendoring>=0.2.2``).
+Tool configuration is done via ``pyproject.toml``.
+
+
+Managing Local Patches
+======================
+
+The ``vendoring`` tool automatically applies our local patches, but updating,
+the patches sometimes no longer apply cleanly. In that case, the update will
+fail. To resolve this, take the following steps:
+
+1. Revert any incomplete changes in the revendoring branch, to ensure you have
+   a clean starting point.
+2. Run the revendoring of the library with a problem again: ``nox -s vendoring
+   -- --upgrade <library_name>``.
+3. This will fail again, but you will have the original source in your working
+   directory. Review the existing patch against the source, and modify the patch
+   to reflect the new version of the source. If you ``git add`` the changes the
+   vendoring made, you can modify the source to reflect the patch file and then
+   generate a new patch with ``git diff``.
+4. Now, revert everything *except* the patch file changes. Leave the modified
+   patch file unstaged but saved in the working tree.
+5. Re-run the vendoring. This time, it should pick up the changed patch file
+   and apply it cleanly. The patch file changes will be committed along with the
+   revendoring, so the new commit should be ready to test and publish as a PR.
 
 
 Debundling

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/cachecontrol.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/certifi/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/certifi/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/certifi/cacert.pem -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/certifi/cacert.pem Changed

@@ -636,37 +636,6 @@
 ZQ==
 -----END CERTIFICATE-----
 
-# Issuer: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
-# Subject: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
-# Label: "Network Solutions Certificate Authority"
-# Serial: 116697915152937497490437556386812487904
-# MD5 Fingerprint: d3:f3:a6:16:c0:fa:6b:1d:59:b1:2d:96:4d:0e:11:2e
-# SHA1 Fingerprint: 74:f8:a3:c3:ef:e7:b3:90:06:4b:83:90:3c:21:64:60:20:e5:df:ce
-# SHA256 Fingerprint: 15:f0:ba:00:a3:ac:7a:f3:ac:88:4c:07:2b:10:11:a0:77:bd:77:c0:97:f4:01:64:b2:f8:59:8a:bd:83:86:0c
------BEGIN CERTIFICATE-----
-MIID5jCCAs6gAwIBAgIQV8szb8JcFuZHFhfjkDFo4DANBgkqhkiG9w0BAQUFADBi
-MQswCQYDVQQGEwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMu
-MTAwLgYDVQQDEydOZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3Jp
-dHkwHhcNMDYxMjAxMDAwMDAwWhcNMjkxMjMxMjM1OTU5WjBiMQswCQYDVQQGEwJV
-UzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMuMTAwLgYDVQQDEydO
-ZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwggEiMA0GCSqG
-SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkvH6SMG3G2I4rC7xGzuAnlt7e+foS0zwz
-c7MEL7xxjOWftiJgPl9dzgn/ggwbmlFQGiaJ3dVhXRncEg8tCqJDXRfQNJIg6nPP
-OCwGJgl6cvf6UDL4wpPTaaIjzkGxzOTVHzbRijr4jGPiFFlp7Q3Tf2vouAPlT2rl
-mGNpSAW+Lv8ztumXWWn4Zxmuk2GWRBXTcrA/vGp97Eh/jcOrqnErU2lBUzS1sLnF
-BgrEsEX1QV1uiUV7PTsmjHTC5dLRfbIR1PtYMiKagMnc/Qzpf14Dl847ABSHJ3A4
-qY5usyd2mFHgBeMhqxrVhSI8KbWaFsWAqPS7azCPL0YCorEMIuDTAgMBAAGjgZcw
-gZQwHQYDVR0OBBYEFCEwyfsA106Y2oeqKtCnLrFAMadMMA4GA1UdDwEB/wQEAwIB
-BjAPBgNVHRMBAf8EBTADAQH/MFIGA1UdHwRLMEkwR6BFoEOGQWh0dHA6Ly9jcmwu
-bmV0c29sc3NsLmNvbS9OZXR3b3JrU29sdXRpb25zQ2VydGlmaWNhdGVBdXRob3Jp
-dHkuY3JsMA0GCSqGSIb3DQEBBQUAA4IBAQC7rkvnt1frf6ott3NHhWrB5KUd5Oc8
-6fRZZXe1eltajSU24HqXLjjAV2CDmAaDn7l2em5Q4LqILPxFzBiwmZVRDuwduIj/
-h1AcgsLj4DKAv6ALR8jDMe+ZZzKATxcheQxpXN5eNK4CtSbqUN9/GGUsyfJj4akH
-/nxxH2szJGoeBfcFaMBqEssuXmHLrijTfsK0ZpEmXzwuJF/LWA/rKOyvEZbz3Htv
-wKeI8lN3s2Berq4o2jUsbzRF0ybh3uxbTydrFny9RAQYgrOJeRcQcT16ohZO9QHN
-pGxlaKFJdlxDydi8NmdspZS11My5vWo1ViHe2MPr+8ukYEywVaCge1ey
------END CERTIFICATE-----
-
 # Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited
 # Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited
 # Label: "COMODO ECC Certification Authority"
@@ -2204,46 +2173,6 @@
 xwy8p2Fp8fc74SrL+SvzZpA3
 -----END CERTIFICATE-----
 
-# Issuer: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
-# Subject: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
-# Label: "Staat der Nederlanden EV Root CA"
-# Serial: 10000013
-# MD5 Fingerprint: fc:06:af:7b:e8:1a:f1:9a:b4:e8:d2:70:1f:c0:f5:ba
-# SHA1 Fingerprint: 76:e2:7e:c1:4f:db:82:c1:c0:a6:75:b5:05:be:3d:29:b4:ed:db:bb
-# SHA256 Fingerprint: 4d:24:91:41:4c:fe:95:67:46:ec:4c:ef:a6:cf:6f:72:e2:8a:13:29:43:2f:9d:8a:90:7a:c4:cb:5d:ad:c1:5a
------BEGIN CERTIFICATE-----
-MIIFcDCCA1igAwIBAgIEAJiWjTANBgkqhkiG9w0BAQsFADBYMQswCQYDVQQGEwJO
-TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSkwJwYDVQQDDCBTdGFh
-dCBkZXIgTmVkZXJsYW5kZW4gRVYgUm9vdCBDQTAeFw0xMDEyMDgxMTE5MjlaFw0y
-MjEyMDgxMTEwMjhaMFgxCzAJBgNVBAYTAk5MMR4wHAYDVQQKDBVTdGFhdCBkZXIg
-TmVkZXJsYW5kZW4xKTAnBgNVBAMMIFN0YWF0IGRlciBOZWRlcmxhbmRlbiBFViBS
-b290IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA48d+ifkkSzrS
-M4M1LGns3Amk41GoJSt5uAg94JG6hIXGhaTK5skuU6TJJB79VWZxXSzFYGgEt9nC
-UiY4iKTWO0Cmws0/zZiTs1QUWJZV1VD+hq2kY39ch/aO5ieSZxeSAgMs3NZmdO3d
-Z//BYY1jTw+bbRcwJu+r0h8QoPnFfxZpgQNH7R5ojXKhTbImxrpsX23Wr9GxE46p
-rfNeaXUmGD5BKyF/7otdBwadQ8QpCiv8Kj6GyzyDOvnJDdrFmeK8eEEzduG/L13l
-pJhQDBXd4Pqcfzho0LKmeqfRMb1+ilgnQ7O6M5HTp5gVXJrm0w912fxBmJc+qiXb
-j5IusHsMX/FjqTf5m3VpTCgmJdrV8hJwRVXj33NeN/UhbJCONVrJ0yPr08C+eKxC
-KFhmpUZtcALXEPlLVPxdhkqHz3/KRawRWrUgUY0viEeXOcDPusBCAUCZSCELa6fS
-/ZbV0b5GnUngC6agIk440ME8MLxwjyx1zNDFjFE7PZQIZCZhfbnDZY8UnCHQqv0X
-cgOPvZuM5l5Tnrmd74K74bzickFbIZTTRTeU0d8JOV3nI6qaHcptqAqGhYqCvkIH
-1vI4gnPah1vlPNOePqc7nvQDs/nxfRN0Av+7oeX6AHkcpmZBiFxgV6YuCcS6/ZrP
-px9Aw7vMWgpVSzs4dlG4Y4uElBbmVvMCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB
-/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFP6rAJCYniT8qcwaivsnuL8wbqg7
-MA0GCSqGSIb3DQEBCwUAA4ICAQDPdyxuVr5Os7aEAJSrR8kN0nbHhp8dB9O2tLsI
-eK9p0gtJ3jPFrK3CiAJ9Brc1AsFgyb/E6JTe1NOpEyVa/m6irn0F3H3zbPB+po3u
-2dfOWBfoqSmuc0iH55vKbimhZF8ZE/euBhD/UcabTVUlT5OZEAFTdfETzsemQUHS
-v4ilf0X8rLiltTMMgsT7B/Zq5SWEXwbKwYY5EdtYzXc7LMJMD16a4/CrPmEbUCTC
-wPTxGfARKbalGAKb12NMcIxHowNDXLldRqANb/9Zjr7dn3LDWyvfjFvO5QxGbJKy
-CqNMVEIYFRIYvdr8unRu/8G2oGTYqV9Vrp9canaW2HNnh/tNf1zuacpzEPuKqf2e
-vTY4SUmH9A4U8OmHuD+nT3pajnnUk+S7aFKErGzp85hwVXIy+TSrK0m1zSBi5Dp6
-Z2Orltxtrpfs/J92VoguZs9btsmksNcFuuEnL5O7Jiqik7Ab846+HUCjuTaPPoIa
-Gl6I6lD4WeKDRikL40Rc4ZW2aZCaFG+XroHPaO+Zmr615+F/+PoTRxZMzG0IQOeL
-eG9QgkRQP2YGiqtDhFZKDyAthg710tvSeopLzaXoTvFeJiUBWSOgftL2fiFX1ye8
-FVdMpEbB4IMeDExNH08GGeL5qPQ6gqGyeUN51q1veieQA6TqJIc/2b3Z6fJfUEkc
-7uzXLg==
------END CERTIFICATE-----
-
 # Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
 # Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
 # Label: "IdenTrust Commercial Root CA 1"
@@ -2851,116 +2780,6 @@
 MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
 -----END CERTIFICATE-----
 
-# Issuer: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Subject: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Label: "TrustCor RootCert CA-1"
-# Serial: 15752444095811006489
-# MD5 Fingerprint: 6e:85:f1:dc:1a:00:d3:22:d5:b2:b2:ac:6b:37:05:45
-# SHA1 Fingerprint: ff:bd:cd:e7:82:c8:43:5e:3c:6f:26:86:5c:ca:a8:3a:45:5b:c3:0a
-# SHA256 Fingerprint: d4:0e:9c:86:cd:8f:e4:68:c1:77:69:59:f4:9e:a7:74:fa:54:86:84:b6:c4:06:f3:90:92:61:f4:dc:e2:57:5c
------BEGIN CERTIFICATE-----
-MIIEMDCCAxigAwIBAgIJANqb7HHzA7AZMA0GCSqGSIb3DQEBCwUAMIGkMQswCQYD
-VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
-MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
-cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRydXN0Q29y
-IFJvb3RDZXJ0IENBLTEwHhcNMTYwMjA0MTIzMjE2WhcNMjkxMjMxMTcyMzE2WjCB
-pDELMAkGA1UEBhMCUEExDzANBgNVBAgMBlBhbmFtYTEUMBIGA1UEBwwLUGFuYW1h
-IENpdHkxJDAiBgNVBAoMG1RydXN0Q29yIFN5c3RlbXMgUy4gZGUgUi5MLjEnMCUG
-A1UECwweVHJ1c3RDb3IgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR8wHQYDVQQDDBZU
-cnVzdENvciBSb290Q2VydCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
-CgKCAQEAv463leLCJhJrMxnHQFgKq1mqjQCj/IDHUHuO1CAmujIS2CNUSSUQIpid
-RtLByZ5OGy4sDjjzGiVoHKZaBeYei0i/mJZ0PmnK6bV4pQa81QBeCQryJ3pS/C3V
-seq0iWEk8xoT26nPUu0MJLq5nux+AHT6k61sKZKuUbS701e/s/OojZz0JEsq1pme
-9J7+wH5COucLlVPat2gOkEz7cD+PSiyU8ybdY2mplNgQTsVHCJCZGxdNuWxu72CV
-EY4hgLW9oHPY0LJ3xEXqWib7ZnZ2+AYfYW0PVcWDtxBWcgYHpfOxGgMFZA6dWorW
-hnAbJN7+KIor0Gqw/Hqi3LJ5DotlDwIDAQABo2MwYTAdBgNVHQ4EFgQU7mtJPHo/
-DeOxCbeKyKsZn3MzUOcwHwYDVR0jBBgwFoAU7mtJPHo/DeOxCbeKyKsZn3MzUOcw
-DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQAD
-ggEBACUY1JGPE+6PHh0RU9otRCkZoB5rMZ5NDp6tPVxBb5UrJKF5mDo4Nvu7Zp5I
-/5CQ7z3UuJu0h3U/IJvOcs+hVcFNZKIZBqEHMwwLKeXx6quj7LUKdJDHfXLy11yf
-ke+Ri7fc7Waiz45mO7yfOgLgJ90WmMCV1Aqk5IGadZQ1nJBfiDcGrVmVCrDRZ9MZ
-yonnMlo2HD6CqFqTvsbQZJG2z9m2GM/bftJlo6bEjhcxwft+dtvTheNYsnd6djts
-L1Ac59v2Z3kf9YKVmgenFK+P3CghZwnS1k1aHBkcjndcw5QkPTJrS37UeJSDvjdN
-zl/HHk484IkzlQsPpTLWPFp5LBk=
------END CERTIFICATE-----
-
-# Issuer: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Subject: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Label: "TrustCor RootCert CA-2"
-# Serial: 2711694510199101698
-# MD5 Fingerprint: a2:e1:f8:18:0b:ba:45:d5:c7:41:2a:bb:37:52:45:64
-# SHA1 Fingerprint: b8:be:6d:cb:56:f1:55:b9:63:d4:12:ca:4e:06:34:c7:94:b2:1c:c0
-# SHA256 Fingerprint: 07:53:e9:40:37:8c:1b:d5:e3:83:6e:39:5d:ae:a5:cb:83:9e:50:46:f1:bd:0e:ae:19:51:cf:10:fe:c7:c9:65
------BEGIN CERTIFICATE-----
-MIIGLzCCBBegAwIBAgIIJaHfyjPLWQIwDQYJKoZIhvcNAQELBQAwgaQxCzAJBgNV
-BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
-IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
-dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEfMB0GA1UEAwwWVHJ1c3RDb3Ig
-Um9vdENlcnQgQ0EtMjAeFw0xNjAyMDQxMjMyMjNaFw0zNDEyMzExNzI2MzlaMIGk
-MQswCQYDVQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEg
-Q2l0eTEkMCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYD
-VQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRy
-dXN0Q29yIFJvb3RDZXJ0IENBLTIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
-AoICAQCnIG7CKqJiJJWQdsg4foDSq8GbZQWU9MEKENUCrO2fk8eHyLAnK0IMPQo+
-QVqedd2NyuCb7GgypGmSaIwLgQ5WoD4a3SwlFIIvl9NkRvRUqdw6VC0xK5mC8tkq
-1+9xALgxpL56JAfDQiDyitSSBBtlVkxs1Pu2YVpHI7TYabS3OtB0PAx1oYxOdqHp
-2yqlO/rOsP9+aij9JxzIsekp8VduZLTQwRVtDr4uDkbIXvRR/u8OYzo7cbrPb1nK
-DOObXUm4TOJXsZiKQlecdu/vvdFoqNL0Cbt3Nb4lggjEFixEIFapRBF37120Hape
-az6LMvYHL1cEksr1/p3C6eizjkxLAjHZ5DxIgif3GIJ2SDpxsROhOdUuxTTCHWKF
-3wP+TfSvPd9cW436cOGlfifHhi5qjxLGhF5DUVCcGZt45vz27Ud+ez1m7xMTiF88
-oWP7+ayHNZ/zgp6kPwqcMWmLmaSISo5uZk3vFsQPeSghYA2FFn3XVDjxklb9tTNM
-g9zXEJ9L/cb4Qr26fHMC4P99zVvh1Kxhe1fVSntb1IVYJ12/+CtgrKAmrhQhJ8Z3
-mjOAPF5GP/fDsaOGM8boXg25NSyqRsGFAnWAoOsk+xWq5Gd/bnc/9ASKL3x74xdh
-8N0JqSDIvgmk0H5Ew7IwSjiqqewYmgeCK9u4nBit2uBGF6zPXQIDAQABo2MwYTAd
-BgNVHQ4EFgQU2f4hQG6UnrybPZx9mCAZ5YwwYrIwHwYDVR0jBBgwFoAU2f4hQG6U
-nrybPZx9mCAZ5YwwYrIwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYw
-DQYJKoZIhvcNAQELBQADggIBAJ5Fngw7tu/hOsh80QA9z+LqBrWyOrsGS2h60COX
-dKcs8AjYeVrXWoSK2BKaG9l9XE1wxaX5q+WjiYndAfrs3fnpkpfbsEZC89NiqpX+
-MWcUaViQCqoL7jcjx1BRtPV+nuN79+TMQjItSQzL/0kMmx40/W5ulop5A7Zv2wnL
-/V9lFDfhOPXzYRZY5LVtDQsEGz9QLX+zx3oaFoBg+Iof6Rsqxvm6ARppv9JYx1RX
-CI/hOWB3S6xZhBqI8d3LT3jX5+EzLfzuQfogsL7L9ziUwOHQhQ+77Sxzq+3+knYa
-ZH9bDTMJBzN7Bj8RpFxwPIXAz+OQqIN3+tvmxYxoZxBnpVIt8MSZj3+/0WvitUfW
-2dCFmU2Umw9Lje4AWkcdEQOsQRivh7dvDDqPys/cA8GiCcjl/YBeyGBCARsaU1q7
-N6a3vLqE6R5sGtRk2tRD/pOLS/IseRYQ1JMLiI+h2IYURpFHmygk71dSTlxCnKr3
-Sewn6EAes6aJInKc9Q0ztFijMDvd1GpUk74aTfOTlPf8hAs/hCBcNANExdqtvArB
-As8e5ZTZ845b2EzwnexhF7sUMlQMAimTHpKG9n/v55IFDlndmQguLvqcAFLTxWYp
-5KeXRKQOKIETNcX2b2TmQcTVL8w0RSXPQQCWPUouwpaYT05KnJe32x+SMsj/D1Fu
-1uwJ
------END CERTIFICATE-----
-
-# Issuer: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Subject: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Label: "TrustCor ECA-1"
-# Serial: 9548242946988625984
-# MD5 Fingerprint: 27:92:23:1d:0a:f5:40:7c:e9:e6:6b:9d:d8:f5:e7:6c
-# SHA1 Fingerprint: 58:d1:df:95:95:67:6b:63:c0:f0:5b:1c:17:4d:8b:84:0b:c8:78:bd
-# SHA256 Fingerprint: 5a:88:5d:b1:9c:01:d9:12:c5:75:93:88:93:8c:af:bb:df:03:1a:b2:d4:8e:91:ee:15:58:9b:42:97:1d:03:9c
------BEGIN CERTIFICATE-----
-MIIEIDCCAwigAwIBAgIJAISCLF8cYtBAMA0GCSqGSIb3DQEBCwUAMIGcMQswCQYD
-VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
-MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
-cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxFzAVBgNVBAMMDlRydXN0Q29y
-IEVDQS0xMB4XDTE2MDIwNDEyMzIzM1oXDTI5MTIzMTE3MjgwN1owgZwxCzAJBgNV
-BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
-IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
-dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEXMBUGA1UEAwwOVHJ1c3RDb3Ig
-RUNBLTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPj+ARtZ+odnbb
-3w9U73NjKYKtR8aja+3+XzP4Q1HpGjORMRegdMTUpwHmspI+ap3tDvl0mEDTPwOA
-BoJA6LHip1GnHYMma6ve+heRK9jGrB6xnhkB1Zem6g23xFUfJ3zSCNV2HykVh0A5
-3ThFEXXQmqc04L/NyFIduUd+Dbi7xgz2c1cWWn5DkR9VOsZtRASqnKmcp0yJF4Ou
-owReUoCLHhIlERnXDH19MURB6tuvsBzvgdAsxZohmz3tQjtQJvLsznFhBmIhVE5/
-wZ0+fyCMgMsq2JdiyIMzkX2woloPV+g7zPIlstR8L+xNxqE6FXrntl019fZISjZF
-ZtS6mFjBAgMBAAGjYzBhMB0GA1UdDgQWBBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAf
-BgNVHSMEGDAWgBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAPBgNVHRMBAf8EBTADAQH/
-MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAQEABT41XBVwm8nHc2Fv
-civUwo/yQ10CzsSUuZQRg2dd4mdsdXa/uwyqNsatR5Nj3B5+1t4u/ukZMjgDfxT2
-AHMsWbEhBuH7rBiVDKP/mZb3Kyeb1STMHd3BOuCYRLDE5D53sXOpZCz2HAF8P11F
-hcCF5yWPldwX8zyfGm6wyuMdKulMY/okYWLW2n62HGz1Ah3UKt1VkOsqEUc8Ll50
-soIipX1TH0XsJ5F95yIW6MBoNtjG8U+ARDL54dHRHareqKucBK+tIA5kmE2la8BI
-WJZpTdwHjFGTot+fDz2LYLSCjaoITmJF4PkL0uDgPFveXHEnJcLmA4GLEFPjx1Wi
-tJ/X5g==
------END CERTIFICATE-----
-
 # Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
 # Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
 # Label: "SSL.com Root Certification Authority RSA"

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/__init__.py Changed

@@ -15,19 +15,29 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import List, Union
+
+from .charsetgroupprober import CharSetGroupProber
+from .charsetprober import CharSetProber
 from .enums import InputState
+from .resultdict import ResultDict
 from .universaldetector import UniversalDetector
 from .version import VERSION, __version__
 
 __all__ = "UniversalDetector", "detect", "detect_all", "__version__", "VERSION"
 
 
-def detect(byte_str):
+def detect(
+    byte_str: Unionbytes, bytearray, should_rename_legacy: bool = False
+) -> ResultDict:
     """
     Detect the encoding of the given byte string.
 
     :param byte_str:     The byte sequence to examine.
     :type byte_str:      ``bytes`` or ``bytearray``
+    :param should_rename_legacy:  Should we rename legacy encodings
+                                  to their more modern equivalents?
+    :type should_rename_legacy:   ``bool``
     """
     if not isinstance(byte_str, bytearray):
         if not isinstance(byte_str, bytes):
@@ -35,12 +45,16 @@
                 f"Expected object of type bytes or bytearray, got: {type(byte_str)}"
             )
         byte_str = bytearray(byte_str)
-    detector = UniversalDetector()
+    detector = UniversalDetector(should_rename_legacy=should_rename_legacy)
     detector.feed(byte_str)
     return detector.close()
 
 
-def detect_all(byte_str, ignore_threshold=False):
+def detect_all(
+    byte_str: Unionbytes, bytearray,
+    ignore_threshold: bool = False,
+    should_rename_legacy: bool = False,
+) -> ListResultDict:
     """
     Detect all the possible encodings of the given byte string.
 
@@ -50,6 +64,9 @@
                               ``UniversalDetector.MINIMUM_THRESHOLD``
                               in results.
     :type ignore_threshold:   ``bool``
+    :param should_rename_legacy:  Should we rename legacy encodings
+                                  to their more modern equivalents?
+    :type should_rename_legacy:   ``bool``
     """
     if not isinstance(byte_str, bytearray):
         if not isinstance(byte_str, bytes):
@@ -58,15 +75,15 @@
             )
         byte_str = bytearray(byte_str)
 
-    detector = UniversalDetector()
+    detector = UniversalDetector(should_rename_legacy=should_rename_legacy)
     detector.feed(byte_str)
     detector.close()
 
     if detector.input_state == InputState.HIGH_BYTE:
-        results = 
-        probers = 
+        results: ListResultDict = 
+        probers: ListCharSetProber = 
         for prober in detector.charset_probers:
-            if hasattr(prober, "probers"):
+            if isinstance(prober, CharSetGroupProber):
                 probers.extend(p for p in prober.probers)
             else:
                 probers.append(prober)
@@ -80,6 +97,11 @@
                     charset_name = detector.ISO_WIN_MAP.get(
                         lower_charset_name, charset_name
                     )
+                # Rename legacy encodings with superset encodings if asked
+                if should_rename_legacy:
+                    charset_name = detector.LEGACY_MAP.get(
+                        charset_name.lower(), charset_name
+                    )
                 results.append(
                     {
                         "encoding": charset_name,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/big5prober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/big5prober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/chardistribution.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/chardistribution.py Changed

@@ -25,6 +25,8 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Tuple, Union
+
 from .big5freq import (
     BIG5_CHAR_TO_FREQ_ORDER,
     BIG5_TABLE_SIZE,
@@ -59,22 +61,22 @@
     SURE_NO = 0.01
     MINIMUM_DATA_THRESHOLD = 3
 
-    def __init__(self):
+    def __init__(self) -> None:
         # Mapping table to get frequency order from char order (get from
         # GetOrder())
-        self._char_to_freq_order = tuple()
-        self._table_size = None  # Size of above table
+        self._char_to_freq_order: Tupleint, ... = tuple()
+        self._table_size = 0  # Size of above table
         # This is a constant value which varies from language to language,
         # used in calculating confidence.  See
         # http://www.mozilla.org/projects/intl/UniversalCharsetDetection.html
         # for further detail.
-        self.typical_distribution_ratio = None
-        self._done = None
-        self._total_chars = None
-        self._freq_chars = None
+        self.typical_distribution_ratio = 0.0
+        self._done = False
+        self._total_chars = 0
+        self._freq_chars = 0
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         """reset analyser, clear any state"""
         # If this flag is set to True, detection is done and conclusion has
         # been made
@@ -83,7 +85,7 @@
         # The number of characters whose frequency order is less than 512
         self._freq_chars = 0
 
-    def feed(self, char, char_len):
+    def feed(self, char: Unionbytes, bytearray, char_len: int) -> None:
         """feed a character with known length"""
         if char_len == 2:
             # we only care about 2-bytes character in our distribution analysis
@@ -97,7 +99,7 @@
                 if 512 > self._char_to_freq_orderorder:
                     self._freq_chars += 1
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         """return confidence based on existing data"""
         # if we didn't receive any character in our consideration range,
         # return negative answer
@@ -114,12 +116,12 @@
         # normalize confidence (we don't want to be 100% sure)
         return self.SURE_YES
 
-    def got_enough_data(self):
+    def got_enough_data(self) -> bool:
         # It is not necessary to receive all data to draw conclusion.
         # For charset detection, certain amount of data is enough
         return self._total_chars > self.ENOUGH_DATA_THRESHOLD
 
-    def get_order(self, _):
+    def get_order(self, _: Unionbytes, bytearray) -> int:
         # We do not handle characters based on the original encoding string,
         # but convert this encoding string to a number, here called order.
         # This allows multiple encodings of a language to share one frequency
@@ -128,13 +130,13 @@
 
 
 class EUCTWDistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = EUCTW_CHAR_TO_FREQ_ORDER
         self._table_size = EUCTW_TABLE_SIZE
         self.typical_distribution_ratio = EUCTW_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         # for euc-TW encoding, we are interested
         #   first  byte range: 0xc4 -- 0xfe
         #   second byte range: 0xa1 -- 0xfe
@@ -146,13 +148,13 @@
 
 
 class EUCKRDistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = EUCKR_CHAR_TO_FREQ_ORDER
         self._table_size = EUCKR_TABLE_SIZE
         self.typical_distribution_ratio = EUCKR_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         # for euc-KR encoding, we are interested
         #   first  byte range: 0xb0 -- 0xfe
         #   second byte range: 0xa1 -- 0xfe
@@ -164,13 +166,13 @@
 
 
 class JOHABDistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = EUCKR_CHAR_TO_FREQ_ORDER
         self._table_size = EUCKR_TABLE_SIZE
         self.typical_distribution_ratio = EUCKR_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         first_char = byte_str0
         if 0x88 <= first_char < 0xD4:
             code = first_char * 256 + byte_str1
@@ -179,13 +181,13 @@
 
 
 class GB2312DistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = GB2312_CHAR_TO_FREQ_ORDER
         self._table_size = GB2312_TABLE_SIZE
         self.typical_distribution_ratio = GB2312_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         # for GB2312 encoding, we are interested
         #  first  byte range: 0xb0 -- 0xfe
         #  second byte range: 0xa1 -- 0xfe
@@ -197,13 +199,13 @@
 
 
 class Big5DistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = BIG5_CHAR_TO_FREQ_ORDER
         self._table_size = BIG5_TABLE_SIZE
         self.typical_distribution_ratio = BIG5_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         # for big5 encoding, we are interested
         #   first  byte range: 0xa4 -- 0xfe
         #   second byte range: 0x40 -- 0x7e , 0xa1 -- 0xfe
@@ -217,13 +219,13 @@
 
 
 class SJISDistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
         self._table_size = JIS_TABLE_SIZE
         self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         # for sjis encoding, we are interested
         #   first  byte range: 0x81 -- 0x9f , 0xe0 -- 0xfe
         #   second byte range: 0x40 -- 0x7e,  0x81 -- oxfe
@@ -242,13 +244,13 @@
 
 
 class EUCJPDistributionAnalysis(CharDistributionAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
         self._table_size = JIS_TABLE_SIZE
         self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> int:
         # for euc-JP encoding, we are interested
         #   first  byte range: 0xa0 -- 0xfe
         #   second byte range: 0xa1 -- 0xfe

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/charsetgroupprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/charsetgroupprober.py Changed

@@ -25,29 +25,30 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import List, Optional, Union
+
 from .charsetprober import CharSetProber
-from .enums import ProbingState
+from .enums import LanguageFilter, ProbingState
 
 
 class CharSetGroupProber(CharSetProber):
-    def __init__(self, lang_filter=None):
+    def __init__(self, lang_filter: LanguageFilter = LanguageFilter.NONE) -> None:
         super().__init__(lang_filter=lang_filter)
         self._active_num = 0
-        self.probers = 
-        self._best_guess_prober = None
+        self.probers: ListCharSetProber = 
+        self._best_guess_prober: OptionalCharSetProber = None
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         self._active_num = 0
         for prober in self.probers:
-            if prober:
-                prober.reset()
-                prober.active = True
-                self._active_num += 1
+            prober.reset()
+            prober.active = True
+            self._active_num += 1
         self._best_guess_prober = None
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> Optionalstr:
         if not self._best_guess_prober:
             self.get_confidence()
             if not self._best_guess_prober:
@@ -55,17 +56,15 @@
         return self._best_guess_prober.charset_name
 
     @property
-    def language(self):
+    def language(self) -> Optionalstr:
         if not self._best_guess_prober:
             self.get_confidence()
             if not self._best_guess_prober:
                 return None
         return self._best_guess_prober.language
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         for prober in self.probers:
-            if not prober:
-                continue
             if not prober.active:
                 continue
             state = prober.feed(byte_str)
@@ -83,7 +82,7 @@
                     return self.state
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         state = self.state
         if state == ProbingState.FOUND_IT:
             return 0.99
@@ -92,8 +91,6 @@
         best_conf = 0.0
         self._best_guess_prober = None
         for prober in self.probers:
-            if not prober:
-                continue
             if not prober.active:
                 self.logger.debug("%s not active", prober.charset_name)
                 continue

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/charsetprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/charsetprober.py Changed

@@ -28,8 +28,9 @@
 
 import logging
 import re
+from typing import Optional, Union
 
-from .enums import ProbingState
+from .enums import LanguageFilter, ProbingState
 
 INTERNATIONAL_WORDS_PATTERN = re.compile(
     b"a-zA-Z*\x80-\xFF+a-zA-Z*^a-zA-Z\x80-\xFF?"
@@ -40,35 +41,40 @@
 
     SHORTCUT_THRESHOLD = 0.95
 
-    def __init__(self, lang_filter=None):
-        self._state = None
+    def __init__(self, lang_filter: LanguageFilter = LanguageFilter.NONE) -> None:
+        self._state = ProbingState.DETECTING
+        self.active = True
         self.lang_filter = lang_filter
         self.logger = logging.getLogger(__name__)
 
-    def reset(self):
+    def reset(self) -> None:
         self._state = ProbingState.DETECTING
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> Optionalstr:
         return None
 
-    def feed(self, byte_str):
+    @property
+    def language(self) -> Optionalstr:
+        raise NotImplementedError
+
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         raise NotImplementedError
 
     @property
-    def state(self):
+    def state(self) -> ProbingState:
         return self._state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         return 0.0
 
     @staticmethod
-    def filter_high_byte_only(buf):
+    def filter_high_byte_only(buf: Unionbytes, bytearray) -> bytes:
         buf = re.sub(b"(\x00-\x7F)+", b" ", buf)
         return buf
 
     @staticmethod
-    def filter_international_words(buf):
+    def filter_international_words(buf: Unionbytes, bytearray) -> bytearray:
         """
         We define three types of bytes:
         alphabet: english alphabets a-zA-Z
@@ -102,7 +108,7 @@
         return filtered
 
     @staticmethod
-    def remove_xml_tags(buf):
+    def remove_xml_tags(buf: Unionbytes, bytearray) -> bytes:
         """
         Returns a copy of ``buf`` that retains only the sequences of English
         alphabet and high byte characters that are not between <> characters.
@@ -117,10 +123,13 @@
 
         for curr, buf_char in enumerate(buf):
             # Check if we're coming out of or entering an XML tag
-            if buf_char == b">":
+
+            # https://github.com/python/typeshed/issues/8182
+            if buf_char == b">":  # type: ignorecomparison-overlap
                 prev = curr + 1
                 in_tag = False
-            elif buf_char == b"<":
+            # https://github.com/python/typeshed/issues/8182
+            elif buf_char == b"<":  # type: ignorecomparison-overlap
                 if curr > prev and not in_tag:
                     # Keep everything after last non-extended-ASCII,
                     # non-alphabetic character

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/cli/chardetect.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/cli/chardetect.py Changed

@@ -15,12 +15,18 @@
 
 import argparse
 import sys
+from typing import Iterable, List, Optional
 
 from .. import __version__
 from ..universaldetector import UniversalDetector
 
 
-def description_of(lines, name="stdin"):
+def description_of(
+    lines: Iterablebytes,
+    name: str = "stdin",
+    minimal: bool = False,
+    should_rename_legacy: bool = False,
+) -> Optionalstr:
     """
     Return a string describing the probable encoding of a file or
     list of strings.
@@ -29,8 +35,11 @@
     :type lines: Iterable of bytes
     :param name: Name of file or collection of lines
     :type name: str
+    :param should_rename_legacy:  Should we rename legacy encodings to
+                                  their more modern equivalents?
+    :type should_rename_legacy:   ``bool``
     """
-    u = UniversalDetector()
+    u = UniversalDetector(should_rename_legacy=should_rename_legacy)
     for line in lines:
         line = bytearray(line)
         u.feed(line)
@@ -39,12 +48,14 @@
             break
     u.close()
     result = u.result
+    if minimal:
+        return result"encoding"
     if result"encoding":
         return f'{name}: {result"encoding"} with confidence {result"confidence"}'
     return f"{name}: no result"
 
 
-def main(argv=None):
+def main(argv: OptionalListstr = None) -> None:
     """
     Handles command line arguments and gets things started.
 
@@ -54,18 +65,29 @@
     """
     # Get command line arguments
     parser = argparse.ArgumentParser(
-        description="Takes one or more file paths and reports their detected \
-                     encodings"
+        description=(
+            "Takes one or more file paths and reports their detected encodings"
+        )
     )
     parser.add_argument(
         "input",
-        help="File whose encoding we would like to determine. \
-                              (default: stdin)",
+        help="File whose encoding we would like to determine. (default: stdin)",
         type=argparse.FileType("rb"),
         nargs="*",
         default=sys.stdin.buffer,
     )
     parser.add_argument(
+        "--minimal",
+        help="Print only the encoding to standard output",
+        action="store_true",
+    )
+    parser.add_argument(
+        "-l",
+        "--legacy",
+        help="Rename legacy encodings to more modern ones.",
+        action="store_true",
+    )
+    parser.add_argument(
         "--version", action="version", version=f"%(prog)s {__version__}"
     )
     args = parser.parse_args(argv)
@@ -79,7 +101,11 @@
                 "--help\n",
                 file=sys.stderr,
             )
-        print(description_of(f, f.name))
+        print(
+            description_of(
+                f, f.name, minimal=args.minimal, should_rename_legacy=args.legacy
+            )
+        )
 
 
 if __name__ == "__main__":

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/codingstatemachine.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/codingstatemachine.py Changed

@@ -27,6 +27,7 @@
 
 import logging
 
+from .codingstatemachinedict import CodingStateMachineDict
 from .enums import MachineState
 
 
@@ -53,18 +54,19 @@
                  encoding from consideration from here on.
     """
 
-    def __init__(self, sm):
+    def __init__(self, sm: CodingStateMachineDict) -> None:
         self._model = sm
         self._curr_byte_pos = 0
         self._curr_char_len = 0
-        self._curr_state = None
+        self._curr_state = MachineState.START
+        self.active = True
         self.logger = logging.getLogger(__name__)
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         self._curr_state = MachineState.START
 
-    def next_state(self, c):
+    def next_state(self, c: int) -> int:
         # for each byte we get its class
         # if it is first byte, we also get byte length
         byte_class = self._model"class_table"c
@@ -77,12 +79,12 @@
         self._curr_byte_pos += 1
         return self._curr_state
 
-    def get_current_charlen(self):
+    def get_current_charlen(self) -> int:
         return self._curr_char_len
 
-    def get_coding_state_machine(self):
+    def get_coding_state_machine(self) -> str:
         return self._model"name"
 
     @property
-    def language(self):
+    def language(self) -> str:
         return self._model"language"

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/codingstatemachinedict.py Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/cp949prober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/cp949prober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/enums.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/enums.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/escprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/escprober.py Changed

@@ -25,6 +25,8 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Optional, Union
+
 from .charsetprober import CharSetProber
 from .codingstatemachine import CodingStateMachine
 from .enums import LanguageFilter, MachineState, ProbingState
@@ -43,7 +45,7 @@
     identify these encodings.
     """
 
-    def __init__(self, lang_filter=None):
+    def __init__(self, lang_filter: LanguageFilter = LanguageFilter.NONE) -> None:
         super().__init__(lang_filter=lang_filter)
         self.coding_sm = 
         if self.lang_filter & LanguageFilter.CHINESE_SIMPLIFIED:
@@ -53,17 +55,15 @@
             self.coding_sm.append(CodingStateMachine(ISO2022JP_SM_MODEL))
         if self.lang_filter & LanguageFilter.KOREAN:
             self.coding_sm.append(CodingStateMachine(ISO2022KR_SM_MODEL))
-        self.active_sm_count = None
-        self._detected_charset = None
-        self._detected_language = None
-        self._state = None
+        self.active_sm_count = 0
+        self._detected_charset: Optionalstr = None
+        self._detected_language: Optionalstr = None
+        self._state = ProbingState.DETECTING
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         for coding_sm in self.coding_sm:
-            if not coding_sm:
-                continue
             coding_sm.active = True
             coding_sm.reset()
         self.active_sm_count = len(self.coding_sm)
@@ -71,20 +71,20 @@
         self._detected_language = None
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> Optionalstr:
         return self._detected_charset
 
     @property
-    def language(self):
+    def language(self) -> Optionalstr:
         return self._detected_language
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         return 0.99 if self._detected_charset else 0.00
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         for c in byte_str:
             for coding_sm in self.coding_sm:
-                if not coding_sm or not coding_sm.active:
+                if not coding_sm.active:
                     continue
                 coding_state = coding_sm.next_state(c)
                 if coding_state == MachineState.ERROR:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/escsm.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/escsm.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/eucjpprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/eucjpprober.py Changed

@@ -25,6 +25,8 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Union
+
 from .chardistribution import EUCJPDistributionAnalysis
 from .codingstatemachine import CodingStateMachine
 from .enums import MachineState, ProbingState
@@ -34,26 +36,29 @@
 
 
 class EUCJPProber(MultiByteCharSetProber):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.coding_sm = CodingStateMachine(EUCJP_SM_MODEL)
         self.distribution_analyzer = EUCJPDistributionAnalysis()
         self.context_analyzer = EUCJPContextAnalysis()
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         self.context_analyzer.reset()
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
         return "EUC-JP"
 
     @property
-    def language(self):
+    def language(self) -> str:
         return "Japanese"
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
+        assert self.coding_sm is not None
+        assert self.distribution_analyzer is not None
+
         for i, byte in enumerate(byte_str):
             # PY3K: byte_str is a byte array, so byte is an int, not a byte
             coding_state = self.coding_sm.next_state(byte)
@@ -89,7 +94,9 @@
 
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
+        assert self.distribution_analyzer is not None
+
         context_conf = self.context_analyzer.get_confidence()
         distrib_conf = self.distribution_analyzer.get_confidence()
         return max(context_conf, distrib_conf)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/euckrprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/euckrprober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/euctwprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/euctwprober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/gb2312prober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/gb2312prober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/hebrewprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/hebrewprober.py Changed

@@ -25,8 +25,11 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Optional, Union
+
 from .charsetprober import CharSetProber
 from .enums import ProbingState
+from .sbcharsetprober import SingleByteCharSetProber
 
 # This prober doesn't actually recognize a language or a charset.
 # It is a helper prober for the use of the Hebrew model probers
@@ -127,6 +130,7 @@
 
 
 class HebrewProber(CharSetProber):
+    SPACE = 0x20
     # windows-1255 / ISO-8859-8 code points of interest
     FINAL_KAF = 0xEA
     NORMAL_KAF = 0xEB
@@ -152,31 +156,35 @@
     VISUAL_HEBREW_NAME = "ISO-8859-8"
     LOGICAL_HEBREW_NAME = "windows-1255"
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
-        self._final_char_logical_score = None
-        self._final_char_visual_score = None
-        self._prev = None
-        self._before_prev = None
-        self._logical_prober = None
-        self._visual_prober = None
+        self._final_char_logical_score = 0
+        self._final_char_visual_score = 0
+        self._prev = self.SPACE
+        self._before_prev = self.SPACE
+        self._logical_prober: OptionalSingleByteCharSetProber = None
+        self._visual_prober: OptionalSingleByteCharSetProber = None
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         self._final_char_logical_score = 0
         self._final_char_visual_score = 0
         # The two last characters seen in the previous buffer,
         # mPrev and mBeforePrev are initialized to space in order to simulate
         # a word delimiter at the beginning of the data
-        self._prev = " "
-        self._before_prev = " "
+        self._prev = self.SPACE
+        self._before_prev = self.SPACE
         # These probers are owned by the group prober.
 
-    def set_model_probers(self, logical_prober, visual_prober):
+    def set_model_probers(
+        self,
+        logical_prober: SingleByteCharSetProber,
+        visual_prober: SingleByteCharSetProber,
+    ) -> None:
         self._logical_prober = logical_prober
         self._visual_prober = visual_prober
 
-    def is_final(self, c):
+    def is_final(self, c: int) -> bool:
         return c in 
             self.FINAL_KAF,
             self.FINAL_MEM,
@@ -185,7 +193,7 @@
             self.FINAL_TSADI,
         
 
-    def is_non_final(self, c):
+    def is_non_final(self, c: int) -> bool:
         # The normal Tsadi is not a good Non-Final letter due to words like
         # 'lechotet' (to chat) containing an apostrophe after the tsadi. This
         # apostrophe is converted to a space in FilterWithoutEnglishLetters
@@ -198,7 +206,7 @@
         # since these words are quite rare.
         return c in self.NORMAL_KAF, self.NORMAL_MEM, self.NORMAL_NUN, self.NORMAL_PE
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         # Final letter analysis for logical-visual decision.
         # Look for evidence that the received buffer is either logical Hebrew
         # or visual Hebrew.
@@ -232,9 +240,9 @@
         byte_str = self.filter_high_byte_only(byte_str)
 
         for cur in byte_str:
-            if cur == " ":
+            if cur == self.SPACE:
                 # We stand on a space - a word just ended
-                if self._before_prev != " ":
+                if self._before_prev != self.SPACE:
                     # next-to-last char was not a space so self._prev is not a
                     # 1 letter word
                     if self.is_final(self._prev):
@@ -247,9 +255,9 @@
             else:
                 # Not standing on a space
                 if (
-                    (self._before_prev == " ")
+                    (self._before_prev == self.SPACE)
                     and (self.is_final(self._prev))
-                    and (cur != " ")
+                    and (cur != self.SPACE)
                 ):
                     # case (3) -2:space-1:final lettercur:not space
                     self._final_char_visual_score += 1
@@ -261,7 +269,10 @@
         return ProbingState.DETECTING
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
+        assert self._logical_prober is not None
+        assert self._visual_prober is not None
+
         # Make the decision: is it Logical or Visual?
         # If the final letter score distance is dominant enough, rely on it.
         finalsub = self._final_char_logical_score - self._final_char_visual_score
@@ -289,11 +300,14 @@
         return self.LOGICAL_HEBREW_NAME
 
     @property
-    def language(self):
+    def language(self) -> str:
         return "Hebrew"
 
     @property
-    def state(self):
+    def state(self) -> ProbingState:
+        assert self._logical_prober is not None
+        assert self._visual_prober is not None
+
         # Remain active as long as any of the model probers are active.
         if (self._logical_prober.state == ProbingState.NOT_ME) and (
             self._visual_prober.state == ProbingState.NOT_ME

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/johabprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/johabprober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/jpcntx.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/jpcntx.py Changed

@@ -25,6 +25,7 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import List, Tuple, Union
 
 # This is hiragana 2-char sequence table, the number in each cell represents its frequency category
 # fmt: off
@@ -123,15 +124,15 @@
     MAX_REL_THRESHOLD = 1000
     MINIMUM_DATA_THRESHOLD = 4
 
-    def __init__(self):
-        self._total_rel = None
-        self._rel_sample = None
-        self._need_to_skip_char_num = None
-        self._last_char_order = None
-        self._done = None
+    def __init__(self) -> None:
+        self._total_rel = 0
+        self._rel_sample: Listint = 
+        self._need_to_skip_char_num = 0
+        self._last_char_order = -1
+        self._done = False
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         self._total_rel = 0  # total sequence received
         # category counters, each integer counts sequence in its category
         self._rel_sample = 0 * self.NUM_OF_CATEGORY
@@ -143,7 +144,7 @@
         # been made
         self._done = False
 
-    def feed(self, byte_str, num_bytes):
+    def feed(self, byte_str: Unionbytes, bytearray, num_bytes: int) -> None:
         if self._done:
             return
 
@@ -172,29 +173,29 @@
                      += 1
                 self._last_char_order = order
 
-    def got_enough_data(self):
+    def got_enough_data(self) -> bool:
         return self._total_rel > self.ENOUGH_REL_THRESHOLD
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         # This is just one way to calculate confidence. It works well for me.
         if self._total_rel > self.MINIMUM_DATA_THRESHOLD:
             return (self._total_rel - self._rel_sample0) / self._total_rel
         return self.DONT_KNOW
 
-    def get_order(self, _):
+    def get_order(self, _: Unionbytes, bytearray) -> Tupleint, int:
         return -1, 1
 
 
 class SJISContextAnalysis(JapaneseContextAnalysis):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self._charset_name = "SHIFT_JIS"
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
         return self._charset_name
 
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> Tupleint, int:
         if not byte_str:
             return -1, 1
         # find out current char's byte length
@@ -216,7 +217,7 @@
 
 
 class EUCJPContextAnalysis(JapaneseContextAnalysis):
-    def get_order(self, byte_str):
+    def get_order(self, byte_str: Unionbytes, bytearray) -> Tupleint, int:
         if not byte_str:
             return -1, 1
         # find out current char's byte length

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/latin1prober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/latin1prober.py Changed

@@ -26,6 +26,8 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import List, Union
+
 from .charsetprober import CharSetProber
 from .enums import ProbingState
 
@@ -96,26 +98,26 @@
 
 
 class Latin1Prober(CharSetProber):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
-        self._last_char_class = None
-        self._freq_counter = None
+        self._last_char_class = OTH
+        self._freq_counter: Listint = 
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         self._last_char_class = OTH
         self._freq_counter = 0 * FREQ_CAT_NUM
         super().reset()
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
         return "ISO-8859-1"
 
     @property
-    def language(self):
+    def language(self) -> str:
         return ""
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         byte_str = self.remove_xml_tags(byte_str)
         for c in byte_str:
             char_class = Latin1_CharToClassc
@@ -128,7 +130,7 @@
 
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         if self.state == ProbingState.NOT_ME:
             return 0.01

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/macromanprober.py Added

@@ -0,0 +1,162 @@
+######################## BEGIN LICENSE BLOCK ########################
+# This code was modified from latin1prober.py by Rob Speer <rob@lumino.so>.
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Rob Speer - adapt to MacRoman encoding
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from typing import List, Union
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState
+
+FREQ_CAT_NUM = 4
+
+UDF = 0  # undefined
+OTH = 1  # other
+ASC = 2  # ascii capital letter
+ASS = 3  # ascii small letter
+ACV = 4  # accent capital vowel
+ACO = 5  # accent capital other
+ASV = 6  # accent small vowel
+ASO = 7  # accent small other
+ODD = 8  # character that is unlikely to appear
+CLASS_NUM = 9  # total classes
+
+# The change from Latin1 is that we explicitly look for extended characters
+# that are infrequently-occurring symbols, and consider them to always be
+# improbable. This should let MacRoman get out of the way of more likely
+# encodings in most situations.
+
+# fmt: off
+MacRoman_CharToClass = (
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 00 - 07
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 08 - 0F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 10 - 17
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 18 - 1F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 20 - 27
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 28 - 2F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 30 - 37
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # 38 - 3F
+    OTH, ASC, ASC, ASC, ASC, ASC, ASC, ASC,  # 40 - 47
+    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,  # 48 - 4F
+    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,  # 50 - 57
+    ASC, ASC, ASC, OTH, OTH, OTH, OTH, OTH,  # 58 - 5F
+    OTH, ASS, ASS, ASS, ASS, ASS, ASS, ASS,  # 60 - 67
+    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,  # 68 - 6F
+    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,  # 70 - 77
+    ASS, ASS, ASS, OTH, OTH, OTH, OTH, OTH,  # 78 - 7F
+    ACV, ACV, ACO, ACV, ACO, ACV, ACV, ASV,  # 80 - 87
+    ASV, ASV, ASV, ASV, ASV, ASO, ASV, ASV,  # 88 - 8F
+    ASV, ASV, ASV, ASV, ASV, ASV, ASO, ASV,  # 90 - 97
+    ASV, ASV, ASV, ASV, ASV, ASV, ASV, ASV,  # 98 - 9F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, ASO,  # A0 - A7
+    OTH, OTH, ODD, ODD, OTH, OTH, ACV, ACV,  # A8 - AF
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,  # B0 - B7
+    OTH, OTH, OTH, OTH, OTH, OTH, ASV, ASV,  # B8 - BF
+    OTH, OTH, ODD, OTH, ODD, OTH, OTH, OTH,  # C0 - C7
+    OTH, OTH, OTH, ACV, ACV, ACV, ACV, ASV,  # C8 - CF
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, ODD,  # D0 - D7
+    ASV, ACV, ODD, OTH, OTH, OTH, OTH, OTH,  # D8 - DF
+    OTH, OTH, OTH, OTH, OTH, ACV, ACV, ACV,  # E0 - E7
+    ACV, ACV, ACV, ACV, ACV, ACV, ACV, ACV,  # E8 - EF
+    ODD, ACV, ACV, ACV, ACV, ASV, ODD, ODD,  # F0 - F7
+    ODD, ODD, ODD, ODD, ODD, ODD, ODD, ODD,  # F8 - FF
+)
+
+# 0 : illegal
+# 1 : very unlikely
+# 2 : normal
+# 3 : very likely
+MacRomanClassModel = (
+# UDF OTH ASC ASS ACV ACO ASV ASO ODD
+    0,  0,  0,  0,  0,  0,  0,  0,  0,  # UDF
+    0,  3,  3,  3,  3,  3,  3,  3,  1,  # OTH
+    0,  3,  3,  3,  3,  3,  3,  3,  1,  # ASC
+    0,  3,  3,  3,  1,  1,  3,  3,  1,  # ASS
+    0,  3,  3,  3,  1,  2,  1,  2,  1,  # ACV
+    0,  3,  3,  3,  3,  3,  3,  3,  1,  # ACO
+    0,  3,  1,  3,  1,  1,  1,  3,  1,  # ASV
+    0,  3,  1,  3,  1,  1,  3,  3,  1,  # ASO
+    0,  1,  1,  1,  1,  1,  1,  1,  1,  # ODD
+)
+# fmt: on
+
+
+class MacRomanProber(CharSetProber):
+    def __init__(self) -> None:
+        super().__init__()
+        self._last_char_class = OTH
+        self._freq_counter: Listint = 
+        self.reset()
+
+    def reset(self) -> None:
+        self._last_char_class = OTH
+        self._freq_counter = 0 * FREQ_CAT_NUM
+
+        # express the prior that MacRoman is a somewhat rare encoding;
+        # this can be done by starting out in a slightly improbable state
+        # that must be overcome
+        self._freq_counter2 = 10
+
+        super().reset()
+
+    @property
+    def charset_name(self) -> str:
+        return "MacRoman"
+
+    @property
+    def language(self) -> str:
+        return ""
+
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
+        byte_str = self.remove_xml_tags(byte_str)
+        for c in byte_str:
+            char_class = MacRoman_CharToClassc
+            freq = MacRomanClassModel(self._last_char_class * CLASS_NUM) + char_class
+            if freq == 0:
+                self._state = ProbingState.NOT_ME
+                break
+            self._freq_counterfreq += 1
+            self._last_char_class = char_class
+
+        return self.state
+
+    def get_confidence(self) -> float:
+        if self.state == ProbingState.NOT_ME:
+            return 0.01
+
+        total = sum(self._freq_counter)
+        confidence = (
+            0.0
+            if total < 0.01
+            else (self._freq_counter3 - self._freq_counter1 * 20.0) / total
+        )
+        confidence = max(confidence, 0.0)
+        # lower the confidence of MacRoman so that other more accurate
+        # detector can take priority.
+        confidence *= 0.73
+        return confidence

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/mbcharsetprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/mbcharsetprober.py Changed

@@ -27,8 +27,12 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Optional, Union
+
+from .chardistribution import CharDistributionAnalysis
 from .charsetprober import CharSetProber
-from .enums import MachineState, ProbingState
+from .codingstatemachine import CodingStateMachine
+from .enums import LanguageFilter, MachineState, ProbingState
 
 
 class MultiByteCharSetProber(CharSetProber):
@@ -36,29 +40,24 @@
     MultiByteCharSetProber
     """
 
-    def __init__(self, lang_filter=None):
+    def __init__(self, lang_filter: LanguageFilter = LanguageFilter.NONE) -> None:
         super().__init__(lang_filter=lang_filter)
-        self.distribution_analyzer = None
-        self.coding_sm = None
-        self._last_char = 0, 0
+        self.distribution_analyzer: OptionalCharDistributionAnalysis = None
+        self.coding_sm: OptionalCodingStateMachine = None
+        self._last_char = bytearray(b"\0\0")
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         if self.coding_sm:
             self.coding_sm.reset()
         if self.distribution_analyzer:
             self.distribution_analyzer.reset()
-        self._last_char = 0, 0
-
-    @property
-    def charset_name(self):
-        raise NotImplementedError
+        self._last_char = bytearray(b"\0\0")
 
-    @property
-    def language(self):
-        raise NotImplementedError
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
+        assert self.coding_sm is not None
+        assert self.distribution_analyzer is not None
 
-    def feed(self, byte_str):
         for i, byte in enumerate(byte_str):
             coding_state = self.coding_sm.next_state(byte)
             if coding_state == MachineState.ERROR:
@@ -91,5 +90,6 @@
 
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
+        assert self.distribution_analyzer is not None
         return self.distribution_analyzer.get_confidence()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/mbcsgroupprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/mbcsgroupprober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/mbcssm.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/mbcssm.py Changed

@@ -25,6 +25,7 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from .codingstatemachinedict import CodingStateMachineDict
 from .enums import MachineState
 
 # BIG5
@@ -74,7 +75,7 @@
 
 BIG5_CHAR_LEN_TABLE = (0, 1, 1, 2, 0)
 
-BIG5_SM_MODEL = {
+BIG5_SM_MODEL: CodingStateMachineDict = {
     "class_table": BIG5_CLS,
     "class_factor": 5,
     "state_table": BIG5_ST,
@@ -117,7 +118,7 @@
 
 CP949_CHAR_LEN_TABLE = (0, 1, 2, 0, 1, 1, 2, 2, 0, 2)
 
-CP949_SM_MODEL = {
+CP949_SM_MODEL: CodingStateMachineDict = {
     "class_table": CP949_CLS,
     "class_factor": 10,
     "state_table": CP949_ST,
@@ -173,7 +174,7 @@
 
 EUCJP_CHAR_LEN_TABLE = (2, 2, 2, 3, 1, 0)
 
-EUCJP_SM_MODEL = {
+EUCJP_SM_MODEL: CodingStateMachineDict = {
     "class_table": EUCJP_CLS,
     "class_factor": 6,
     "state_table": EUCJP_ST,
@@ -226,7 +227,7 @@
 
 EUCKR_CHAR_LEN_TABLE = (0, 1, 2, 0)
 
-EUCKR_SM_MODEL = {
+EUCKR_SM_MODEL: CodingStateMachineDict = {
     "class_table": EUCKR_CLS,
     "class_factor": 4,
     "state_table": EUCKR_ST,
@@ -283,7 +284,7 @@
 
 JOHAB_CHAR_LEN_TABLE = (0, 1, 1, 1, 1, 0, 0, 2, 2, 2)
 
-JOHAB_SM_MODEL = {
+JOHAB_SM_MODEL: CodingStateMachineDict = {
     "class_table": JOHAB_CLS,
     "class_factor": 10,
     "state_table": JOHAB_ST,
@@ -340,7 +341,7 @@
 
 EUCTW_CHAR_LEN_TABLE = (0, 0, 1, 2, 2, 2, 3)
 
-EUCTW_SM_MODEL = {
+EUCTW_SM_MODEL: CodingStateMachineDict = {
     "class_table": EUCTW_CLS,
     "class_factor": 7,
     "state_table": EUCTW_ST,
@@ -402,7 +403,7 @@
 # 2 here.
 GB2312_CHAR_LEN_TABLE = (0, 1, 1, 1, 1, 1, 2)
 
-GB2312_SM_MODEL = {
+GB2312_SM_MODEL: CodingStateMachineDict = {
     "class_table": GB2312_CLS,
     "class_factor": 7,
     "state_table": GB2312_ST,
@@ -458,7 +459,7 @@
 
 SJIS_CHAR_LEN_TABLE = (0, 1, 1, 2, 0, 0)
 
-SJIS_SM_MODEL = {
+SJIS_SM_MODEL: CodingStateMachineDict = {
     "class_table": SJIS_CLS,
     "class_factor": 6,
     "state_table": SJIS_ST,
@@ -516,7 +517,7 @@
 
 UCS2BE_CHAR_LEN_TABLE = (2, 2, 2, 0, 2, 2)
 
-UCS2BE_SM_MODEL = {
+UCS2BE_SM_MODEL: CodingStateMachineDict = {
     "class_table": UCS2BE_CLS,
     "class_factor": 6,
     "state_table": UCS2BE_ST,
@@ -574,7 +575,7 @@
 
 UCS2LE_CHAR_LEN_TABLE = (2, 2, 2, 2, 2, 2)
 
-UCS2LE_SM_MODEL = {
+UCS2LE_SM_MODEL: CodingStateMachineDict = {
     "class_table": UCS2LE_CLS,
     "class_factor": 6,
     "state_table": UCS2LE_ST,
@@ -651,7 +652,7 @@
 
 UTF8_CHAR_LEN_TABLE = (0, 1, 0, 0, 0, 0, 2, 3, 3, 3, 4, 4, 5, 5, 6, 6)
 
-UTF8_SM_MODEL = {
+UTF8_SM_MODEL: CodingStateMachineDict = {
     "class_table": UTF8_CLS,
     "class_factor": 16,
     "state_table": UTF8_ST,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/metadata/languages.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/metadata/languages.py Changed

@@ -6,6 +6,7 @@
 """
 
 from string import ascii_letters
+from typing import List, Optional
 
 # TODO: Add Ukrainian (KOI8-U)
 
@@ -33,13 +34,13 @@
 
     def __init__(
         self,
-        name=None,
-        iso_code=None,
-        use_ascii=True,
-        charsets=None,
-        alphabet=None,
-        wiki_start_pages=None,
-    ):
+        name: Optionalstr = None,
+        iso_code: Optionalstr = None,
+        use_ascii: bool = True,
+        charsets: OptionalListstr = None,
+        alphabet: Optionalstr = None,
+        wiki_start_pages: OptionalListstr = None,
+    ) -> None:
         super().__init__()
         self.name = name
         self.iso_code = iso_code
@@ -55,7 +56,7 @@
         self.alphabet = "".join(sorted(set(alphabet))) if alphabet else None
         self.wiki_start_pages = wiki_start_pages
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         param_str = ", ".join(
             f"{k}={v!r}" for k, v in self.__dict__.items() if not k.startswith("_")
         )
@@ -103,7 +104,7 @@
         name="Danish",
         iso_code="da",
         use_ascii=True,
-        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
         alphabet="æøåÆØÅ",
         wiki_start_pages="Forside",
     ),
@@ -111,8 +112,8 @@
         name="German",
         iso_code="de",
         use_ascii=True,
-        charsets="ISO-8859-1", "WINDOWS-1252",
-        alphabet="äöüßÄÖÜ",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
+        alphabet="äöüßẞÄÖÜ",
         wiki_start_pages="Wikipedia:Hauptseite",
     ),
     "Greek": Language(
@@ -127,7 +128,7 @@
         name="English",
         iso_code="en",
         use_ascii=True,
-        charsets="ISO-8859-1", "WINDOWS-1252",
+        charsets="ISO-8859-1", "WINDOWS-1252", "MacRoman",
         wiki_start_pages="Main_Page",
     ),
     "Esperanto": Language(
@@ -143,7 +144,7 @@
         name="Spanish",
         iso_code="es",
         use_ascii=True,
-        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
         alphabet="ñáéíóúüÑÁÉÍÓÚÜ",
         wiki_start_pages="Wikipedia:Portada",
     ),
@@ -161,7 +162,7 @@
         name="Finnish",
         iso_code="fi",
         use_ascii=True,
-        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
         alphabet="ÅÄÖŠŽåäöšž",
         wiki_start_pages="Wikipedia:Etusivu",
     ),
@@ -169,7 +170,7 @@
         name="French",
         iso_code="fr",
         use_ascii=True,
-        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
         alphabet="œàâçèéîïùûêŒÀÂÇÈÉÎÏÙÛÊ",
         wiki_start_pages="Wikipédia:Accueil_principal", "Bœuf (animal)",
     ),
@@ -203,7 +204,7 @@
         name="Italian",
         iso_code="it",
         use_ascii=True,
-        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
         alphabet="ÀÈÉÌÒÓÙàèéìòóù",
         wiki_start_pages="Pagina_principale",
     ),
@@ -237,7 +238,7 @@
         name="Dutch",
         iso_code="nl",
         use_ascii=True,
-        charsets="ISO-8859-1", "WINDOWS-1252",
+        charsets="ISO-8859-1", "WINDOWS-1252", "MacRoman",
         wiki_start_pages="Hoofdpagina",
     ),
     "Polish": Language(
@@ -253,7 +254,7 @@
         name="Portuguese",
         iso_code="pt",
         use_ascii=True,
-        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252",
+        charsets="ISO-8859-1", "ISO-8859-15", "WINDOWS-1252", "MacRoman",
         alphabet="ÁÂÃÀÇÉÊÍÓÔÕÚáâãàçéêíóôõú",
         wiki_start_pages="Wikipédia:Página_principal",
     ),

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/py.typed Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/resultdict.py Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/sbcharsetprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/sbcharsetprober.py Changed

@@ -26,23 +26,20 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
-from collections import namedtuple
+from typing import Dict, List, NamedTuple, Optional, Union
 
 from .charsetprober import CharSetProber
 from .enums import CharacterCategory, ProbingState, SequenceLikelihood
 
-SingleByteCharSetModel = namedtuple(
-    "SingleByteCharSetModel",
-    
-        "charset_name",
-        "language",
-        "char_to_order_map",
-        "language_model",
-        "typical_positive_ratio",
-        "keep_ascii_letters",
-        "alphabet",
-    ,
-)
+
+class SingleByteCharSetModel(NamedTuple):
+    charset_name: str
+    language: str
+    char_to_order_map: Dictint, int
+    language_model: Dictint, Dictint, int
+    typical_positive_ratio: float
+    keep_ascii_letters: bool
+    alphabet: str
 
 
 class SingleByteCharSetProber(CharSetProber):
@@ -51,22 +48,27 @@
     POSITIVE_SHORTCUT_THRESHOLD = 0.95
     NEGATIVE_SHORTCUT_THRESHOLD = 0.05
 
-    def __init__(self, model, is_reversed=False, name_prober=None):
+    def __init__(
+        self,
+        model: SingleByteCharSetModel,
+        is_reversed: bool = False,
+        name_prober: OptionalCharSetProber = None,
+    ) -> None:
         super().__init__()
         self._model = model
         # TRUE if we need to reverse every pair in the model lookup
         self._reversed = is_reversed
         # Optional auxiliary prober for name decision
         self._name_prober = name_prober
-        self._last_order = None
-        self._seq_counters = None
-        self._total_seqs = None
-        self._total_char = None
-        self._control_char = None
-        self._freq_char = None
+        self._last_order = 255
+        self._seq_counters: Listint = 
+        self._total_seqs = 0
+        self._total_char = 0
+        self._control_char = 0
+        self._freq_char = 0
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         # char order of last character
         self._last_order = 255
@@ -78,18 +80,18 @@
         self._freq_char = 0
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> Optionalstr:
         if self._name_prober:
             return self._name_prober.charset_name
         return self._model.charset_name
 
     @property
-    def language(self):
+    def language(self) -> Optionalstr:
         if self._name_prober:
             return self._name_prober.language
         return self._model.language
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         # TODO: Make filter_international_words keep things in self.alphabet
         if not self._model.keep_ascii_letters:
             byte_str = self.filter_international_words(byte_str)
@@ -139,7 +141,7 @@
 
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         r = 0.01
         if self._total_seqs > 0:
             r = (

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/sbcsgroupprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/sbcsgroupprober.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/sjisprober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/sjisprober.py Changed

@@ -25,6 +25,8 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Union
+
 from .chardistribution import SJISDistributionAnalysis
 from .codingstatemachine import CodingStateMachine
 from .enums import MachineState, ProbingState
@@ -34,26 +36,29 @@
 
 
 class SJISProber(MultiByteCharSetProber):
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.coding_sm = CodingStateMachine(SJIS_SM_MODEL)
         self.distribution_analyzer = SJISDistributionAnalysis()
         self.context_analyzer = SJISContextAnalysis()
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         self.context_analyzer.reset()
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
         return self.context_analyzer.charset_name
 
     @property
-    def language(self):
+    def language(self) -> str:
         return "Japanese"
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
+        assert self.coding_sm is not None
+        assert self.distribution_analyzer is not None
+
         for i, byte in enumerate(byte_str):
             coding_state = self.coding_sm.next_state(byte)
             if coding_state == MachineState.ERROR:
@@ -92,7 +97,9 @@
 
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
+        assert self.distribution_analyzer is not None
+
         context_conf = self.context_analyzer.get_confidence()
         distrib_conf = self.distribution_analyzer.get_confidence()
         return max(context_conf, distrib_conf)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/universaldetector.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/universaldetector.py Changed

@@ -39,12 +39,16 @@
 import codecs
 import logging
 import re
+from typing import List, Optional, Union
 
 from .charsetgroupprober import CharSetGroupProber
+from .charsetprober import CharSetProber
 from .enums import InputState, LanguageFilter, ProbingState
 from .escprober import EscCharSetProber
 from .latin1prober import Latin1Prober
+from .macromanprober import MacRomanProber
 from .mbcsgroupprober import MBCSGroupProber
+from .resultdict import ResultDict
 from .sbcsgroupprober import SBCSGroupProber
 from .utf1632prober import UTF1632Prober
 
@@ -80,34 +84,55 @@
         "iso-8859-9": "Windows-1254",
         "iso-8859-13": "Windows-1257",
     }
+    # Based on https://encoding.spec.whatwg.org/#names-and-labels
+    # but altered to match Python names for encodings and remove mappings
+    # that break tests.
+    LEGACY_MAP = {
+        "ascii": "Windows-1252",
+        "iso-8859-1": "Windows-1252",
+        "tis-620": "ISO-8859-11",
+        "iso-8859-9": "Windows-1254",
+        "gb2312": "GB18030",
+        "euc-kr": "CP949",
+        "utf-16le": "UTF-16",
+    }
 
-    def __init__(self, lang_filter=LanguageFilter.ALL):
-        self._esc_charset_prober = None
-        self._utf1632_prober = None
-        self._charset_probers = 
-        self.result = None
-        self.done = None
-        self._got_data = None
-        self._input_state = None
-        self._last_char = None
+    def __init__(
+        self,
+        lang_filter: LanguageFilter = LanguageFilter.ALL,
+        should_rename_legacy: bool = False,
+    ) -> None:
+        self._esc_charset_prober: OptionalEscCharSetProber = None
+        self._utf1632_prober: OptionalUTF1632Prober = None
+        self._charset_probers: ListCharSetProber = 
+        self.result: ResultDict = {
+            "encoding": None,
+            "confidence": 0.0,
+            "language": None,
+        }
+        self.done = False
+        self._got_data = False
+        self._input_state = InputState.PURE_ASCII
+        self._last_char = b""
         self.lang_filter = lang_filter
         self.logger = logging.getLogger(__name__)
-        self._has_win_bytes = None
+        self._has_win_bytes = False
+        self.should_rename_legacy = should_rename_legacy
         self.reset()
 
     @property
-    def input_state(self):
+    def input_state(self) -> int:
         return self._input_state
 
     @property
-    def has_win_bytes(self):
+    def has_win_bytes(self) -> bool:
         return self._has_win_bytes
 
     @property
-    def charset_probers(self):
+    def charset_probers(self) -> ListCharSetProber:
         return self._charset_probers
 
-    def reset(self):
+    def reset(self) -> None:
         """
         Reset the UniversalDetector and all of its probers back to their
         initial states.  This is called by ``__init__``, so you only need to
@@ -126,7 +151,7 @@
         for prober in self._charset_probers:
             prober.reset()
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> None:
         """
         Takes a chunk of a document and feeds it through all of the relevant
         charset probers.
@@ -166,6 +191,7 @@
             elif byte_str.startswith(b"\xFE\xFF\x00\x00"):
                 # FE FF 00 00  UCS-4, unusual octet order BOM (3412)
                 self.result = {
+                    # TODO: This encoding is not supported by Python. Should remove?
                     "encoding": "X-ISO-10646-UCS-4-3412",
                     "confidence": 1.0,
                     "language": "",
@@ -173,6 +199,7 @@
             elif byte_str.startswith(b"\x00\x00\xFF\xFE"):
                 # 00 00 FF FE  UCS-4, unusual octet order BOM (2143)
                 self.result = {
+                    # TODO: This encoding is not supported by Python. Should remove?
                     "encoding": "X-ISO-10646-UCS-4-2143",
                     "confidence": 1.0,
                     "language": "",
@@ -242,6 +269,7 @@
                 if self.lang_filter & LanguageFilter.NON_CJK:
                     self._charset_probers.append(SBCSGroupProber())
                 self._charset_probers.append(Latin1Prober())
+                self._charset_probers.append(MacRomanProber())
             for prober in self._charset_probers:
                 if prober.feed(byte_str) == ProbingState.FOUND_IT:
                     self.result = {
@@ -254,7 +282,7 @@
             if self.WIN_BYTE_DETECTOR.search(byte_str):
                 self._has_win_bytes = True
 
-    def close(self):
+    def close(self) -> ResultDict:
         """
         Stop analyzing the current document and come up with a final
         prediction.
@@ -288,7 +316,8 @@
                     max_prober = prober
             if max_prober and (max_prober_confidence > self.MINIMUM_THRESHOLD):
                 charset_name = max_prober.charset_name
-                lower_charset_name = max_prober.charset_name.lower()
+                assert charset_name is not None
+                lower_charset_name = charset_name.lower()
                 confidence = max_prober.get_confidence()
                 # Use Windows encoding name instead of ISO-8859 if we saw any
                 # extra Windows-specific bytes
@@ -297,6 +326,11 @@
                         charset_name = self.ISO_WIN_MAP.get(
                             lower_charset_name, charset_name
                         )
+                # Rename legacy encodings with superset encodings if asked
+                if self.should_rename_legacy:
+                    charset_name = self.LEGACY_MAP.get(
+                        (charset_name or "").lower(), charset_name
+                    )
                 self.result = {
                     "encoding": charset_name,
                     "confidence": confidence,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/utf1632prober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/utf1632prober.py Changed

@@ -18,6 +18,8 @@
 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
+from typing import List, Union
+
 from .charsetprober import CharSetProber
 from .enums import ProbingState
 
@@ -36,7 +38,7 @@
     # a fixed constant ratio of expected zeros or non-zeros in modulo-position.
     EXPECTED_RATIO = 0.94
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.position = 0
         self.zeros_at_mod = 0 * 4
@@ -51,7 +53,7 @@
         self.first_half_surrogate_pair_detected_16le = False
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         self.position = 0
         self.zeros_at_mod = 0 * 4
@@ -66,7 +68,7 @@
         self.quad = 0, 0, 0, 0
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
         if self.is_likely_utf32be():
             return "utf-32be"
         if self.is_likely_utf32le():
@@ -79,16 +81,16 @@
         return "utf-16"
 
     @property
-    def language(self):
+    def language(self) -> str:
         return ""
 
-    def approx_32bit_chars(self):
+    def approx_32bit_chars(self) -> float:
         return max(1.0, self.position / 4.0)
 
-    def approx_16bit_chars(self):
+    def approx_16bit_chars(self) -> float:
         return max(1.0, self.position / 2.0)
 
-    def is_likely_utf32be(self):
+    def is_likely_utf32be(self) -> bool:
         approx_chars = self.approx_32bit_chars()
         return approx_chars >= self.MIN_CHARS_FOR_DETECTION and (
             self.zeros_at_mod0 / approx_chars > self.EXPECTED_RATIO
@@ -98,7 +100,7 @@
             and not self.invalid_utf32be
         )
 
-    def is_likely_utf32le(self):
+    def is_likely_utf32le(self) -> bool:
         approx_chars = self.approx_32bit_chars()
         return approx_chars >= self.MIN_CHARS_FOR_DETECTION and (
             self.nonzeros_at_mod0 / approx_chars > self.EXPECTED_RATIO
@@ -108,7 +110,7 @@
             and not self.invalid_utf32le
         )
 
-    def is_likely_utf16be(self):
+    def is_likely_utf16be(self) -> bool:
         approx_chars = self.approx_16bit_chars()
         return approx_chars >= self.MIN_CHARS_FOR_DETECTION and (
             (self.nonzeros_at_mod1 + self.nonzeros_at_mod3) / approx_chars
@@ -118,7 +120,7 @@
             and not self.invalid_utf16be
         )
 
-    def is_likely_utf16le(self):
+    def is_likely_utf16le(self) -> bool:
         approx_chars = self.approx_16bit_chars()
         return approx_chars >= self.MIN_CHARS_FOR_DETECTION and (
             (self.nonzeros_at_mod0 + self.nonzeros_at_mod2) / approx_chars
@@ -128,7 +130,7 @@
             and not self.invalid_utf16le
         )
 
-    def validate_utf32_characters(self, quad):
+    def validate_utf32_characters(self, quad: Listint) -> None:
         """
         Validate if the quad of bytes is valid UTF-32.
 
@@ -150,7 +152,7 @@
         ):
             self.invalid_utf32le = True
 
-    def validate_utf16_characters(self, pair):
+    def validate_utf16_characters(self, pair: Listint) -> None:
         """
         Validate if the pair of bytes is  valid UTF-16.
 
@@ -182,7 +184,7 @@
             else:
                 self.invalid_utf16le = True
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         for c in byte_str:
             mod4 = self.position % 4
             self.quadmod4 = c
@@ -198,7 +200,7 @@
         return self.state
 
     @property
-    def state(self):
+    def state(self) -> ProbingState:
         if self._state in {ProbingState.NOT_ME, ProbingState.FOUND_IT}:
             # terminal, decided states
             return self._state
@@ -210,7 +212,7 @@
             self._state = ProbingState.NOT_ME
         return self._state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         return (
             0.85
             if (

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/utf8prober.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/utf8prober.py Changed

@@ -25,6 +25,8 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
+from typing import Union
+
 from .charsetprober import CharSetProber
 from .codingstatemachine import CodingStateMachine
 from .enums import MachineState, ProbingState
@@ -34,26 +36,26 @@
 class UTF8Prober(CharSetProber):
     ONE_CHAR_PROB = 0.5
 
-    def __init__(self):
+    def __init__(self) -> None:
         super().__init__()
         self.coding_sm = CodingStateMachine(UTF8_SM_MODEL)
-        self._num_mb_chars = None
+        self._num_mb_chars = 0
         self.reset()
 
-    def reset(self):
+    def reset(self) -> None:
         super().reset()
         self.coding_sm.reset()
         self._num_mb_chars = 0
 
     @property
-    def charset_name(self):
+    def charset_name(self) -> str:
         return "utf-8"
 
     @property
-    def language(self):
+    def language(self) -> str:
         return ""
 
-    def feed(self, byte_str):
+    def feed(self, byte_str: Unionbytes, bytearray) -> ProbingState:
         for c in byte_str:
             coding_state = self.coding_sm.next_state(c)
             if coding_state == MachineState.ERROR:
@@ -72,7 +74,7 @@
 
         return self.state
 
-    def get_confidence(self):
+    def get_confidence(self) -> float:
         unlike = 0.99
         if self._num_mb_chars < 6:
             unlike *= self.ONE_CHAR_PROB**self._num_mb_chars

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/chardet/version.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/chardet/version.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/colorama/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/colorama/ansitowin32.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/ansitowin32.py Changed

@@ -4,7 +4,7 @@
 import os
 
 from .ansi import AnsiFore, AnsiBack, AnsiStyle, Style, BEL
-from .winterm import WinTerm, WinColor, WinStyle
+from .winterm import enable_vt_processing, WinTerm, WinColor, WinStyle
 from .win32 import windll, winapi_test
 
 
@@ -94,15 +94,22 @@
         # (e.g. Cygwin Terminal). In this case it's up to the terminal
         # to support the ANSI codes.
         conversion_supported = on_windows and winapi_test()
+        try:
+            fd = wrapped.fileno()
+        except Exception:
+            fd = -1
+        system_has_native_ansi = not on_windows or enable_vt_processing(fd)
+        have_tty = not self.stream.closed and self.stream.isatty()
+        need_conversion = conversion_supported and not system_has_native_ansi
 
         # should we strip ANSI sequences from our output?
         if strip is None:
-            strip = conversion_supported or (not self.stream.closed and not self.stream.isatty())
+            strip = need_conversion or not have_tty
         self.strip = strip
 
         # should we should convert ANSI sequences into win32 calls?
         if convert is None:
-            convert = conversion_supported and not self.stream.closed and self.stream.isatty()
+            convert = need_conversion and have_tty
         self.convert = convert
 
         # dict of ansi codes to win32 functions and parameters
@@ -264,3 +271,7 @@
                     if params0 in '02':
                         winterm.set_title(params1)
         return text
+
+
+    def flush(self):
+        self.wrapped.flush()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/colorama/initialise.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/initialise.py Changed

@@ -6,13 +6,27 @@
 from .ansitowin32 import AnsiToWin32
 
 
-orig_stdout = None
-orig_stderr = None
+def _wipe_internal_state_for_tests():
+    global orig_stdout, orig_stderr
+    orig_stdout = None
+    orig_stderr = None
+
+    global wrapped_stdout, wrapped_stderr
+    wrapped_stdout = None
+    wrapped_stderr = None
 
-wrapped_stdout = None
-wrapped_stderr = None
+    global atexit_done
+    atexit_done = False
+
+    global fixed_windows_console
+    fixed_windows_console = False
 
-atexit_done = False
+    try:
+        # no-op if it wasn't registered
+        atexit.unregister(reset_all)
+    except AttributeError:
+        # python 2: no atexit.unregister. Oh well, we did our best.
+        pass
 
 
 def reset_all():
@@ -55,6 +69,29 @@
         sys.stderr = orig_stderr
 
 
+def just_fix_windows_console():
+    global fixed_windows_console
+
+    if sys.platform != "win32":
+        return
+    if fixed_windows_console:
+        return
+    if wrapped_stdout is not None or wrapped_stderr is not None:
+        # Someone already ran init() and it did stuff, so we won't second-guess them
+        return
+
+    # On newer versions of Windows, AnsiToWin32.__init__ will implicitly enable the
+    # native ANSI support in the console as a side-effect. We only need to actually
+    # replace sys.stdout/stderr if we're in the old-style conversion mode.
+    new_stdout = AnsiToWin32(sys.stdout, convert=None, strip=None, autoreset=False)
+    if new_stdout.convert:
+        sys.stdout = new_stdout
+    new_stderr = AnsiToWin32(sys.stderr, convert=None, strip=None, autoreset=False)
+    if new_stderr.convert:
+        sys.stderr = new_stderr
+
+    fixed_windows_console = True
+
 @contextlib.contextmanager
 def colorama_text(*args, **kwargs):
     init(*args, **kwargs)
@@ -78,3 +115,7 @@
         if wrapper.should_wrap():
             stream = wrapper.stream
     return stream
+
+
+# Use this for initial setup as well, to reduce code duplication
+_wipe_internal_state_for_tests()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/ansi_test.py Added

@@ -0,0 +1,76 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main
+
+from ..ansi import Back, Fore, Style
+from ..ansitowin32 import AnsiToWin32
+
+stdout_orig = sys.stdout
+stderr_orig = sys.stderr
+
+
+class AnsiTest(TestCase):
+
+    def setUp(self):
+        # sanity check: stdout should be a file or StringIO object.
+        # It will only be AnsiToWin32 if init() has previously wrapped it
+        self.assertNotEqual(type(sys.stdout), AnsiToWin32)
+        self.assertNotEqual(type(sys.stderr), AnsiToWin32)
+
+    def tearDown(self):
+        sys.stdout = stdout_orig
+        sys.stderr = stderr_orig
+
+
+    def testForeAttributes(self):
+        self.assertEqual(Fore.BLACK, '\03330m')
+        self.assertEqual(Fore.RED, '\03331m')
+        self.assertEqual(Fore.GREEN, '\03332m')
+        self.assertEqual(Fore.YELLOW, '\03333m')
+        self.assertEqual(Fore.BLUE, '\03334m')
+        self.assertEqual(Fore.MAGENTA, '\03335m')
+        self.assertEqual(Fore.CYAN, '\03336m')
+        self.assertEqual(Fore.WHITE, '\03337m')
+        self.assertEqual(Fore.RESET, '\03339m')
+
+        # Check the light, extended versions.
+        self.assertEqual(Fore.LIGHTBLACK_EX, '\03390m')
+        self.assertEqual(Fore.LIGHTRED_EX, '\03391m')
+        self.assertEqual(Fore.LIGHTGREEN_EX, '\03392m')
+        self.assertEqual(Fore.LIGHTYELLOW_EX, '\03393m')
+        self.assertEqual(Fore.LIGHTBLUE_EX, '\03394m')
+        self.assertEqual(Fore.LIGHTMAGENTA_EX, '\03395m')
+        self.assertEqual(Fore.LIGHTCYAN_EX, '\03396m')
+        self.assertEqual(Fore.LIGHTWHITE_EX, '\03397m')
+
+
+    def testBackAttributes(self):
+        self.assertEqual(Back.BLACK, '\03340m')
+        self.assertEqual(Back.RED, '\03341m')
+        self.assertEqual(Back.GREEN, '\03342m')
+        self.assertEqual(Back.YELLOW, '\03343m')
+        self.assertEqual(Back.BLUE, '\03344m')
+        self.assertEqual(Back.MAGENTA, '\03345m')
+        self.assertEqual(Back.CYAN, '\03346m')
+        self.assertEqual(Back.WHITE, '\03347m')
+        self.assertEqual(Back.RESET, '\03349m')
+
+        # Check the light, extended versions.
+        self.assertEqual(Back.LIGHTBLACK_EX, '\033100m')
+        self.assertEqual(Back.LIGHTRED_EX, '\033101m')
+        self.assertEqual(Back.LIGHTGREEN_EX, '\033102m')
+        self.assertEqual(Back.LIGHTYELLOW_EX, '\033103m')
+        self.assertEqual(Back.LIGHTBLUE_EX, '\033104m')
+        self.assertEqual(Back.LIGHTMAGENTA_EX, '\033105m')
+        self.assertEqual(Back.LIGHTCYAN_EX, '\033106m')
+        self.assertEqual(Back.LIGHTWHITE_EX, '\033107m')
+
+
+    def testStyleAttributes(self):
+        self.assertEqual(Style.DIM, '\0332m')
+        self.assertEqual(Style.NORMAL, '\03322m')
+        self.assertEqual(Style.BRIGHT, '\0331m')
+
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/ansitowin32_test.py Added

@@ -0,0 +1,294 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from io import StringIO, TextIOWrapper
+from unittest import TestCase, main
+try:
+    from contextlib import ExitStack
+except ImportError:
+    # python 2
+    from contextlib2 import ExitStack
+
+try:
+    from unittest.mock import MagicMock, Mock, patch
+except ImportError:
+    from mock import MagicMock, Mock, patch
+
+from ..ansitowin32 import AnsiToWin32, StreamWrapper
+from ..win32 import ENABLE_VIRTUAL_TERMINAL_PROCESSING
+from .utils import osname
+
+
+class StreamWrapperTest(TestCase):
+
+    def testIsAProxy(self):
+        mockStream = Mock()
+        wrapper = StreamWrapper(mockStream, None)
+        self.assertTrue( wrapper.random_attr is mockStream.random_attr )
+
+    def testDelegatesWrite(self):
+        mockStream = Mock()
+        mockConverter = Mock()
+        wrapper = StreamWrapper(mockStream, mockConverter)
+        wrapper.write('hello')
+        self.assertTrue(mockConverter.write.call_args, (('hello',), {}))
+
+    def testDelegatesContext(self):
+        mockConverter = Mock()
+        s = StringIO()
+        with StreamWrapper(s, mockConverter) as fp:
+            fp.write(u'hello')
+        self.assertTrue(s.closed)
+
+    def testProxyNoContextManager(self):
+        mockStream = MagicMock()
+        mockStream.__enter__.side_effect = AttributeError()
+        mockConverter = Mock()
+        with self.assertRaises(AttributeError) as excinfo:
+            with StreamWrapper(mockStream, mockConverter) as wrapper:
+                wrapper.write('hello')
+
+    def test_closed_shouldnt_raise_on_closed_stream(self):
+        stream = StringIO()
+        stream.close()
+        wrapper = StreamWrapper(stream, None)
+        self.assertEqual(wrapper.closed, True)
+
+    def test_closed_shouldnt_raise_on_detached_stream(self):
+        stream = TextIOWrapper(StringIO())
+        stream.detach()
+        wrapper = StreamWrapper(stream, None)
+        self.assertEqual(wrapper.closed, True)
+
+class AnsiToWin32Test(TestCase):
+
+    def testInit(self):
+        mockStdout = Mock()
+        auto = Mock()
+        stream = AnsiToWin32(mockStdout, autoreset=auto)
+        self.assertEqual(stream.wrapped, mockStdout)
+        self.assertEqual(stream.autoreset, auto)
+
+    @patch('colorama.ansitowin32.winterm', None)
+    @patch('colorama.ansitowin32.winapi_test', lambda *_: True)
+    def testStripIsTrueOnWindows(self):
+        with osname('nt'):
+            mockStdout = Mock()
+            stream = AnsiToWin32(mockStdout)
+            self.assertTrue(stream.strip)
+
+    def testStripIsFalseOffWindows(self):
+        with osname('posix'):
+            mockStdout = Mock(closed=False)
+            stream = AnsiToWin32(mockStdout)
+            self.assertFalse(stream.strip)
+
+    def testWriteStripsAnsi(self):
+        mockStdout = Mock()
+        stream = AnsiToWin32(mockStdout)
+        stream.wrapped = Mock()
+        stream.write_and_convert = Mock()
+        stream.strip = True
+
+        stream.write('abc')
+
+        self.assertFalse(stream.wrapped.write.called)
+        self.assertEqual(stream.write_and_convert.call_args, (('abc',), {}))
+
+    def testWriteDoesNotStripAnsi(self):
+        mockStdout = Mock()
+        stream = AnsiToWin32(mockStdout)
+        stream.wrapped = Mock()
+        stream.write_and_convert = Mock()
+        stream.strip = False
+        stream.convert = False
+
+        stream.write('abc')
+
+        self.assertFalse(stream.write_and_convert.called)
+        self.assertEqual(stream.wrapped.write.call_args, (('abc',), {}))
+
+    def assert_autoresets(self, convert, autoreset=True):
+        stream = AnsiToWin32(Mock())
+        stream.convert = convert
+        stream.reset_all = Mock()
+        stream.autoreset = autoreset
+        stream.winterm = Mock()
+
+        stream.write('abc')
+
+        self.assertEqual(stream.reset_all.called, autoreset)
+
+    def testWriteAutoresets(self):
+        self.assert_autoresets(convert=True)
+        self.assert_autoresets(convert=False)
+        self.assert_autoresets(convert=True, autoreset=False)
+        self.assert_autoresets(convert=False, autoreset=False)
+
+    def testWriteAndConvertWritesPlainText(self):
+        stream = AnsiToWin32(Mock())
+        stream.write_and_convert( 'abc' )
+        self.assertEqual( stream.wrapped.write.call_args, (('abc',), {}) )
+
+    def testWriteAndConvertStripsAllValidAnsi(self):
+        stream = AnsiToWin32(Mock())
+        stream.call_win32 = Mock()
+        data = 
+            'abc\033mdef',
+            'abc\0330mdef',
+            'abc\0332mdef',
+            'abc\03302mdef',
+            'abc\033002mdef',
+            'abc\03340mdef',
+            'abc\033040mdef',
+            'abc\0330;1mdef',
+            'abc\03340;50mdef',
+            'abc\03350;30;40mdef',
+            'abc\033Adef',
+            'abc\0330Gdef',
+            'abc\0331;20;128Hdef',
+        
+        for datum in data:
+            stream.wrapped.write.reset_mock()
+            stream.write_and_convert( datum )
+            self.assertEqual(
+               args0 for args in stream.wrapped.write.call_args_list,
+                ('abc',), ('def',) 
+            )
+
+    def testWriteAndConvertSkipsEmptySnippets(self):
+        stream = AnsiToWin32(Mock())
+        stream.call_win32 = Mock()
+        stream.write_and_convert( '\03340m\03341m' )
+        self.assertFalse( stream.wrapped.write.called )
+
+    def testWriteAndConvertCallsWin32WithParamsAndCommand(self):
+        stream = AnsiToWin32(Mock())
+        stream.convert = True
+        stream.call_win32 = Mock()
+        stream.extract_params = Mock(return_value='params')
+        data = {
+            'abc\033adef':         ('a', 'params'),
+            'abc\033;;bdef':       ('b', 'params'),
+            'abc\0330cdef':        ('c', 'params'),
+            'abc\033;;0;;Gdef':    ('G', 'params'),
+            'abc\0331;20;128Hdef': ('H', 'params'),
+        }
+        for datum, expected in data.items():
+            stream.call_win32.reset_mock()
+            stream.write_and_convert( datum )
+            self.assertEqual( stream.call_win32.call_args0, expected )
+
+    def test_reset_all_shouldnt_raise_on_closed_orig_stdout(self):
+        stream = StringIO()
+        converter = AnsiToWin32(stream)
+        stream.close()
+
+        converter.reset_all()
+
+    def test_wrap_shouldnt_raise_on_closed_orig_stdout(self):
+        stream = StringIO()
+        stream.close()
+        with \
+            patch("colorama.ansitowin32.os.name", "nt"), \
+            patch("colorama.ansitowin32.winapi_test", lambda: True):
+                converter = AnsiToWin32(stream)
+        self.assertTrue(converter.strip)
+        self.assertFalse(converter.convert)
+
+    def test_wrap_shouldnt_raise_on_missing_closed_attr(self):
+        with \
+            patch("colorama.ansitowin32.os.name", "nt"), \
+            patch("colorama.ansitowin32.winapi_test", lambda: True):
+                converter = AnsiToWin32(object())
+        self.assertTrue(converter.strip)
+        self.assertFalse(converter.convert)
+
+    def testExtractParams(self):
+        stream = AnsiToWin32(Mock())
+        data = {
+            '':               (0,),
+            ';;':             (0,),
+            '2':              (2,),
+            ';;002;;':        (2,),
+            '0;1':            (0, 1),
+            ';;003;;456;;':   (3, 456),
+            '11;22;33;44;55': (11, 22, 33, 44, 55),
+        }
+        for datum, expected in data.items():
+            self.assertEqual(stream.extract_params('m', datum), expected)
+
+    def testCallWin32UsesLookup(self):
+        listener = Mock()
+        stream = AnsiToWin32(listener)
+        stream.win32_calls = {
+            1: (lambda *_, **__: listener(11),),
+            2: (lambda *_, **__: listener(22),),
+            3: (lambda *_, **__: listener(33),),
+        }
+        stream.call_win32('m', (3, 1, 99, 2))
+        self.assertEqual(
+            a00 for a in listener.call_args_list,
+            33, 11, 22 )
+
+    def test_osc_codes(self):
+        mockStdout = Mock()
+        stream = AnsiToWin32(mockStdout, convert=True)
+        with patch('colorama.ansitowin32.winterm') as winterm:
+            data = 
+                '\0330\x07',                      # missing arguments
+                '\0330;foo\x08',                  # wrong OSC command
+                '\0330;colorama_test_title\x07',  # should work
+                '\0331;colorama_test_title\x07',  # wrong set command
+                '\0332;colorama_test_title\x07',  # should work
+                '\033' + ';' * 64 + '\x08',       # see issue #247
+            
+            for code in data:
+                stream.write(code)
+            self.assertEqual(winterm.set_title.call_count, 2)
+
+    def test_native_windows_ansi(self):
+        with ExitStack() as stack:
+            def p(a, b):
+                stack.enter_context(patch(a, b, create=True))
+            # Pretend to be on Windows
+            p("colorama.ansitowin32.os.name", "nt")
+            p("colorama.ansitowin32.winapi_test", lambda: True)
+            p("colorama.win32.winapi_test", lambda: True)
+            p("colorama.winterm.win32.windll", "non-None")
+            p("colorama.winterm.get_osfhandle", lambda _: 1234)
+
+            # Pretend that our mock stream has native ANSI support
+            p(
+                "colorama.winterm.win32.GetConsoleMode",
+                lambda _: ENABLE_VIRTUAL_TERMINAL_PROCESSING,
+            )
+            SetConsoleMode = Mock()
+            p("colorama.winterm.win32.SetConsoleMode", SetConsoleMode)
+
+            stdout = Mock()
+            stdout.closed = False
+            stdout.isatty.return_value = True
+            stdout.fileno.return_value = 1
+
+            # Our fake console says it has native vt support, so AnsiToWin32 should
+            # enable that support and do nothing else.
+            stream = AnsiToWin32(stdout)
+            SetConsoleMode.assert_called_with(1234, ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+            self.assertFalse(stream.strip)
+            self.assertFalse(stream.convert)
+            self.assertFalse(stream.should_wrap())
+
+            # Now let's pretend we're on an old Windows console, that doesn't have
+            # native ANSI support.
+            p("colorama.winterm.win32.GetConsoleMode", lambda _: 0)
+            SetConsoleMode = Mock()
+            p("colorama.winterm.win32.SetConsoleMode", SetConsoleMode)
+
+            stream = AnsiToWin32(stdout)
+            SetConsoleMode.assert_called_with(1234, ENABLE_VIRTUAL_TERMINAL_PROCESSING)
+            self.assertTrue(stream.strip)
+            self.assertTrue(stream.convert)
+            self.assertTrue(stream.should_wrap())
+
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/initialise_test.py Added

@@ -0,0 +1,189 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main, skipUnless
+
+try:
+    from unittest.mock import patch, Mock
+except ImportError:
+    from mock import patch, Mock
+
+from ..ansitowin32 import StreamWrapper
+from ..initialise import init, just_fix_windows_console, _wipe_internal_state_for_tests
+from .utils import osname, replace_by
+
+orig_stdout = sys.stdout
+orig_stderr = sys.stderr
+
+
+class InitTest(TestCase):
+
+    @skipUnless(sys.stdout.isatty(), "sys.stdout is not a tty")
+    def setUp(self):
+        # sanity check
+        self.assertNotWrapped()
+
+    def tearDown(self):
+        _wipe_internal_state_for_tests()
+        sys.stdout = orig_stdout
+        sys.stderr = orig_stderr
+
+    def assertWrapped(self):
+        self.assertIsNot(sys.stdout, orig_stdout, 'stdout should be wrapped')
+        self.assertIsNot(sys.stderr, orig_stderr, 'stderr should be wrapped')
+        self.assertTrue(isinstance(sys.stdout, StreamWrapper),
+            'bad stdout wrapper')
+        self.assertTrue(isinstance(sys.stderr, StreamWrapper),
+            'bad stderr wrapper')
+
+    def assertNotWrapped(self):
+        self.assertIs(sys.stdout, orig_stdout, 'stdout should not be wrapped')
+        self.assertIs(sys.stderr, orig_stderr, 'stderr should not be wrapped')
+
+    @patch('colorama.initialise.reset_all')
+    @patch('colorama.ansitowin32.winapi_test', lambda *_: True)
+    @patch('colorama.ansitowin32.enable_vt_processing', lambda *_: False)
+    def testInitWrapsOnWindows(self, _):
+        with osname("nt"):
+            init()
+            self.assertWrapped()
+
+    @patch('colorama.initialise.reset_all')
+    @patch('colorama.ansitowin32.winapi_test', lambda *_: False)
+    def testInitDoesntWrapOnEmulatedWindows(self, _):
+        with osname("nt"):
+            init()
+            self.assertNotWrapped()
+
+    def testInitDoesntWrapOnNonWindows(self):
+        with osname("posix"):
+            init()
+            self.assertNotWrapped()
+
+    def testInitDoesntWrapIfNone(self):
+        with replace_by(None):
+            init()
+            # We can't use assertNotWrapped here because replace_by(None)
+            # changes stdout/stderr already.
+            self.assertIsNone(sys.stdout)
+            self.assertIsNone(sys.stderr)
+
+    def testInitAutoresetOnWrapsOnAllPlatforms(self):
+        with osname("posix"):
+            init(autoreset=True)
+            self.assertWrapped()
+
+    def testInitWrapOffDoesntWrapOnWindows(self):
+        with osname("nt"):
+            init(wrap=False)
+            self.assertNotWrapped()
+
+    def testInitWrapOffIncompatibleWithAutoresetOn(self):
+        self.assertRaises(ValueError, lambda: init(autoreset=True, wrap=False))
+
+    @patch('colorama.win32.SetConsoleTextAttribute')
+    @patch('colorama.initialise.AnsiToWin32')
+    def testAutoResetPassedOn(self, mockATW32, _):
+        with osname("nt"):
+            init(autoreset=True)
+            self.assertEqual(len(mockATW32.call_args_list), 2)
+            self.assertEqual(mockATW32.call_args_list11'autoreset', True)
+            self.assertEqual(mockATW32.call_args_list01'autoreset', True)
+
+    @patch('colorama.initialise.AnsiToWin32')
+    def testAutoResetChangeable(self, mockATW32):
+        with osname("nt"):
+            init()
+
+            init(autoreset=True)
+            self.assertEqual(len(mockATW32.call_args_list), 4)
+            self.assertEqual(mockATW32.call_args_list21'autoreset', True)
+            self.assertEqual(mockATW32.call_args_list31'autoreset', True)
+
+            init()
+            self.assertEqual(len(mockATW32.call_args_list), 6)
+            self.assertEqual(
+                mockATW32.call_args_list41'autoreset', False)
+            self.assertEqual(
+                mockATW32.call_args_list51'autoreset', False)
+
+
+    @patch('colorama.initialise.atexit.register')
+    def testAtexitRegisteredOnlyOnce(self, mockRegister):
+        init()
+        self.assertTrue(mockRegister.called)
+        mockRegister.reset_mock()
+        init()
+        self.assertFalse(mockRegister.called)
+
+
+class JustFixWindowsConsoleTest(TestCase):
+    def _reset(self):
+        _wipe_internal_state_for_tests()
+        sys.stdout = orig_stdout
+        sys.stderr = orig_stderr
+
+    def tearDown(self):
+        self._reset()
+
+    @patch("colorama.ansitowin32.winapi_test", lambda: True)
+    def testJustFixWindowsConsole(self):
+        if sys.platform != "win32":
+            # just_fix_windows_console should be a no-op
+            just_fix_windows_console()
+            self.assertIs(sys.stdout, orig_stdout)
+            self.assertIs(sys.stderr, orig_stderr)
+        else:
+            def fake_std():
+                # Emulate stdout=not a tty, stderr=tty
+                # to check that we handle both cases correctly
+                stdout = Mock()
+                stdout.closed = False
+                stdout.isatty.return_value = False
+                stdout.fileno.return_value = 1
+                sys.stdout = stdout
+
+                stderr = Mock()
+                stderr.closed = False
+                stderr.isatty.return_value = True
+                stderr.fileno.return_value = 2
+                sys.stderr = stderr
+
+            for native_ansi in False, True:
+                with patch(
+                    'colorama.ansitowin32.enable_vt_processing',
+                    lambda *_: native_ansi
+                ):
+                    self._reset()
+                    fake_std()
+
+                    # Regular single-call test
+                    prev_stdout = sys.stdout
+                    prev_stderr = sys.stderr
+                    just_fix_windows_console()
+                    self.assertIs(sys.stdout, prev_stdout)
+                    if native_ansi:
+                        self.assertIs(sys.stderr, prev_stderr)
+                    else:
+                        self.assertIsNot(sys.stderr, prev_stderr)
+
+                    # second call without resetting is always a no-op
+                    prev_stdout = sys.stdout
+                    prev_stderr = sys.stderr
+                    just_fix_windows_console()
+                    self.assertIs(sys.stdout, prev_stdout)
+                    self.assertIs(sys.stderr, prev_stderr)
+
+                    self._reset()
+                    fake_std()
+
+                    # If init() runs first, just_fix_windows_console should be a no-op
+                    init()
+                    prev_stdout = sys.stdout
+                    prev_stderr = sys.stderr
+                    just_fix_windows_console()
+                    self.assertIs(prev_stdout, sys.stdout)
+                    self.assertIs(prev_stderr, sys.stderr)
+
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/isatty_test.py Added

@@ -0,0 +1,57 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main
+
+from ..ansitowin32 import StreamWrapper, AnsiToWin32
+from .utils import pycharm, replace_by, replace_original_by, StreamTTY, StreamNonTTY
+
+
+def is_a_tty(stream):
+    return StreamWrapper(stream, None).isatty()
+
+class IsattyTest(TestCase):
+
+    def test_TTY(self):
+        tty = StreamTTY()
+        self.assertTrue(is_a_tty(tty))
+        with pycharm():
+            self.assertTrue(is_a_tty(tty))
+
+    def test_nonTTY(self):
+        non_tty = StreamNonTTY()
+        self.assertFalse(is_a_tty(non_tty))
+        with pycharm():
+            self.assertFalse(is_a_tty(non_tty))
+
+    def test_withPycharm(self):
+        with pycharm():
+            self.assertTrue(is_a_tty(sys.stderr))
+            self.assertTrue(is_a_tty(sys.stdout))
+
+    def test_withPycharmTTYOverride(self):
+        tty = StreamTTY()
+        with pycharm(), replace_by(tty):
+            self.assertTrue(is_a_tty(tty))
+
+    def test_withPycharmNonTTYOverride(self):
+        non_tty = StreamNonTTY()
+        with pycharm(), replace_by(non_tty):
+            self.assertFalse(is_a_tty(non_tty))
+
+    def test_withPycharmNoneOverride(self):
+        with pycharm():
+            with replace_by(None), replace_original_by(None):
+                self.assertFalse(is_a_tty(None))
+                self.assertFalse(is_a_tty(StreamNonTTY()))
+                self.assertTrue(is_a_tty(StreamTTY()))
+
+    def test_withPycharmStreamWrapped(self):
+        with pycharm():
+            self.assertTrue(AnsiToWin32(StreamTTY()).stream.isatty())
+            self.assertFalse(AnsiToWin32(StreamNonTTY()).stream.isatty())
+            self.assertTrue(AnsiToWin32(sys.stdout).stream.isatty())
+            self.assertTrue(AnsiToWin32(sys.stderr).stream.isatty())
+
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/utils.py Added

@@ -0,0 +1,49 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from contextlib import contextmanager
+from io import StringIO
+import sys
+import os
+
+
+class StreamTTY(StringIO):
+    def isatty(self):
+        return True
+
+class StreamNonTTY(StringIO):
+    def isatty(self):
+        return False
+
+@contextmanager
+def osname(name):
+    orig = os.name
+    os.name = name
+    yield
+    os.name = orig
+
+@contextmanager
+def replace_by(stream):
+    orig_stdout = sys.stdout
+    orig_stderr = sys.stderr
+    sys.stdout = stream
+    sys.stderr = stream
+    yield
+    sys.stdout = orig_stdout
+    sys.stderr = orig_stderr
+
+@contextmanager
+def replace_original_by(stream):
+    orig_stdout = sys.__stdout__
+    orig_stderr = sys.__stderr__
+    sys.__stdout__ = stream
+    sys.__stderr__ = stream
+    yield
+    sys.__stdout__ = orig_stdout
+    sys.__stderr__ = orig_stderr
+
+@contextmanager
+def pycharm():
+    os.environ"PYCHARM_HOSTED" = "1"
+    non_tty = StreamNonTTY()
+    with replace_by(non_tty), replace_original_by(non_tty):
+        yield
+    del os.environ"PYCHARM_HOSTED"

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/tests/winterm_test.py Added

@@ -0,0 +1,131 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import sys
+from unittest import TestCase, main, skipUnless
+
+try:
+    from unittest.mock import Mock, patch
+except ImportError:
+    from mock import Mock, patch
+
+from ..winterm import WinColor, WinStyle, WinTerm
+
+
+class WinTermTest(TestCase):
+
+    @patch('colorama.winterm.win32')
+    def testInit(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 7 + 6 * 16 + 8
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+        self.assertEqual(term._fore, 7)
+        self.assertEqual(term._back, 6)
+        self.assertEqual(term._style, 8)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testGetAttrs(self):
+        term = WinTerm()
+
+        term._fore = 0
+        term._back = 0
+        term._style = 0
+        self.assertEqual(term.get_attrs(), 0)
+
+        term._fore = WinColor.YELLOW
+        self.assertEqual(term.get_attrs(), WinColor.YELLOW)
+
+        term._back = WinColor.MAGENTA
+        self.assertEqual(
+            term.get_attrs(),
+            WinColor.YELLOW + WinColor.MAGENTA * 16)
+
+        term._style = WinStyle.BRIGHT
+        self.assertEqual(
+            term.get_attrs(),
+            WinColor.YELLOW + WinColor.MAGENTA * 16 + WinStyle.BRIGHT)
+
+    @patch('colorama.winterm.win32')
+    def testResetAll(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 1 + 2 * 16 + 8
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+
+        term.set_console = Mock()
+        term._fore = -1
+        term._back = -1
+        term._style = -1
+
+        term.reset_all()
+
+        self.assertEqual(term._fore, 1)
+        self.assertEqual(term._back, 2)
+        self.assertEqual(term._style, 8)
+        self.assertEqual(term.set_console.called, True)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testFore(self):
+        term = WinTerm()
+        term.set_console = Mock()
+        term._fore = 0
+
+        term.fore(5)
+
+        self.assertEqual(term._fore, 5)
+        self.assertEqual(term.set_console.called, True)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testBack(self):
+        term = WinTerm()
+        term.set_console = Mock()
+        term._back = 0
+
+        term.back(5)
+
+        self.assertEqual(term._back, 5)
+        self.assertEqual(term.set_console.called, True)
+
+    @skipUnless(sys.platform.startswith("win"), "requires Windows")
+    def testStyle(self):
+        term = WinTerm()
+        term.set_console = Mock()
+        term._style = 0
+
+        term.style(22)
+
+        self.assertEqual(term._style, 22)
+        self.assertEqual(term.set_console.called, True)
+
+    @patch('colorama.winterm.win32')
+    def testSetConsole(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 0
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+        term.windll = Mock()
+
+        term.set_console()
+
+        self.assertEqual(
+            mockWin32.SetConsoleTextAttribute.call_args,
+            ((mockWin32.STDOUT, term.get_attrs()), {})
+        )
+
+    @patch('colorama.winterm.win32')
+    def testSetConsoleOnStderr(self, mockWin32):
+        mockAttr = Mock()
+        mockAttr.wAttributes = 0
+        mockWin32.GetConsoleScreenBufferInfo.return_value = mockAttr
+        term = WinTerm()
+        term.windll = Mock()
+
+        term.set_console(on_stderr=True)
+
+        self.assertEqual(
+            mockWin32.SetConsoleTextAttribute.call_args,
+            ((mockWin32.STDERR, term.get_attrs()), {})
+        )
+
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/colorama/win32.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/win32.py Changed

@@ -4,6 +4,8 @@
 STDOUT = -11
 STDERR = -12
 
+ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004
+
 try:
     import ctypes
     from ctypes import LibraryLoader
@@ -89,6 +91,20 @@
     
     _SetConsoleTitleW.restype = wintypes.BOOL
 
+    _GetConsoleMode = windll.kernel32.GetConsoleMode
+    _GetConsoleMode.argtypes = 
+        wintypes.HANDLE,
+        POINTER(wintypes.DWORD)
+    
+    _GetConsoleMode.restype = wintypes.BOOL
+
+    _SetConsoleMode = windll.kernel32.SetConsoleMode
+    _SetConsoleMode.argtypes = 
+        wintypes.HANDLE,
+        wintypes.DWORD
+    
+    _SetConsoleMode.restype = wintypes.BOOL
+
     def _winapi_test(handle):
         csbi = CONSOLE_SCREEN_BUFFER_INFO()
         success = _GetConsoleScreenBufferInfo(
@@ -150,3 +166,15 @@
 
     def SetConsoleTitle(title):
         return _SetConsoleTitleW(title)
+
+    def GetConsoleMode(handle):
+        mode = wintypes.DWORD()
+        success = _GetConsoleMode(handle, byref(mode))
+        if not success:
+            raise ctypes.WinError()
+        return mode.value
+
+    def SetConsoleMode(handle, mode):
+        success = _SetConsoleMode(handle, mode)
+        if not success:
+            raise ctypes.WinError()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/colorama/winterm.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/colorama/winterm.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/distlib.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/distro/distro.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/distro/distro.py Changed

@@ -55,7 +55,7 @@
     # Python 3.7
     TypedDict = dict
 
-__version__ = "1.7.0"
+__version__ = "1.8.0"
 
 
 class VersionDict(TypedDict):
@@ -122,6 +122,26 @@
 # Pattern for base file name of distro release file
 _DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)-_(release|version)$")
 
+# Base file names to be looked up for if _UNIXCONFDIR is not readable.
+_DISTRO_RELEASE_BASENAMES = 
+    "SuSE-release",
+    "arch-release",
+    "base-release",
+    "centos-release",
+    "fedora-release",
+    "gentoo-release",
+    "mageia-release",
+    "mandrake-release",
+    "mandriva-release",
+    "mandrivalinux-release",
+    "manjaro-release",
+    "oracle-release",
+    "redhat-release",
+    "rocky-release",
+    "sl-release",
+    "slackware-version",
+
+
 # Base file names to be ignored when searching for distro release file
 _DISTRO_RELEASE_IGNORE_BASENAMES = (
     "debian_version",
@@ -200,6 +220,7 @@
     "opensuse"      openSUSE
     "amzn"          Amazon Linux
     "arch"          Arch Linux
+    "buildroot"     Buildroot
     "cloudlinux"    CloudLinux OS
     "exherbo"       Exherbo Linux
     "gentoo"        GenToo Linux
@@ -221,6 +242,7 @@
     "midnightbsd"   MidnightBSD
     "rocky"         Rocky Linux
     "aix"           AIX
+    "guix"          Guix System
     ==============  =========================================
 
     If you have a need to get distros for reliable IDs added into this set,
@@ -876,6 +898,9 @@
         if self.uname_attr("id").startswith("aix"):
             # On AIX platforms, prefer oslevel command output.
             versions.insert(0, self.oslevel_info())
+        elif self.id() == "debian" or "debian" in self.like().split():
+            # On Debian-like, add debian_version file content to candidates list.
+            versions.append(self._debian_version)
         version = ""
         if best:
             # This algorithm uses the last version in priority order that has
@@ -1186,6 +1211,16 @@
             return ""
         return self._to_str(stdout).strip()
 
+    @cached_property
+    def _debian_version(self) -> str:
+        try:
+            with open(
+                os.path.join(self.etc_dir, "debian_version"), encoding="ascii"
+            ) as fp:
+                return fp.readline().rstrip()
+        except FileNotFoundError:
+            return ""
+
     @staticmethod
     def _parse_uname_content(lines: Sequencestr) -> Dictstr, str:
         if not lines:
@@ -1228,14 +1263,14 @@
             # file), because we want to use what was specified as best as
             # possible.
             match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
-            if "name" in distro_info and "cloudlinux" in distro_info"name".lower():
-                distro_info"id" = "cloudlinux"
-            elif match:
-                distro_info"id" = match.group(1)
-            return distro_info
         else:
             try:
-                basenames = os.listdir(self.etc_dir)
+                basenames = 
+                    basename
+                    for basename in os.listdir(self.etc_dir)
+                    if basename not in _DISTRO_RELEASE_IGNORE_BASENAMES
+                    and os.path.isfile(os.path.join(self.etc_dir, basename))
+                
                 # We sort for repeatability in cases where there are multiple
                 # distro specific files; e.g. CentOS, Oracle, Enterprise all
                 # containing `redhat-release` on top of their own.
@@ -1245,39 +1280,29 @@
                 # sure about the *-release files. Check common entries of
                 # /etc for information. If they turn out to not be there the
                 # error is handled in `_parse_distro_release_file()`.
-                basenames = 
-                    "SuSE-release",
-                    "arch-release",
-                    "base-release",
-                    "centos-release",
-                    "fedora-release",
-                    "gentoo-release",
-                    "mageia-release",
-                    "mandrake-release",
-                    "mandriva-release",
-                    "mandrivalinux-release",
-                    "manjaro-release",
-                    "oracle-release",
-                    "redhat-release",
-                    "rocky-release",
-                    "sl-release",
-                    "slackware-version",
-                
+                basenames = _DISTRO_RELEASE_BASENAMES
             for basename in basenames:
-                if basename in _DISTRO_RELEASE_IGNORE_BASENAMES:
-                    continue
                 match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
-                if match:
-                    filepath = os.path.join(self.etc_dir, basename)
-                    distro_info = self._parse_distro_release_file(filepath)
-                    if "name" in distro_info:
-                        # The name is always present if the pattern matches
-                        self.distro_release_file = filepath
-                        distro_info"id" = match.group(1)
-                        if "cloudlinux" in distro_info"name".lower():
-                            distro_info"id" = "cloudlinux"
-                        return distro_info
-            return {}
+                if match is None:
+                    continue
+                filepath = os.path.join(self.etc_dir, basename)
+                distro_info = self._parse_distro_release_file(filepath)
+                # The name is always present if the pattern matches.
+                if "name" not in distro_info:
+                    continue
+                self.distro_release_file = filepath
+                break
+            else:  # the loop didn't "break": no candidate.
+                return {}
+
+        if match is not None:
+            distro_info"id" = match.group(1)
+
+        # CloudLinux < 7: manually enrich info with proper id.
+        if "cloudlinux" in distro_info.get("name", "").lower():
+            distro_info"id" = "cloudlinux"
+
+        return distro_info
 
     def _parse_distro_release_file(self, filepath: str) -> Dictstr, str:
         """

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/msgpack.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/msgpack/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/msgpack/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/msgpack/ext.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/msgpack/ext.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/msgpack/fallback.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/msgpack/fallback.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pkg_resources.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pkg_resources/LICENSE -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pkg_resources/LICENSE Changed

@@ -1,19 +1,19 @@
-Copyright (C) 2016 Jason R Coombs <jaraco@jaraco.com>
+Copyright Jason R. Coombs
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pkg_resources/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pkg_resources/__init__.py Changed

@@ -1,4 +1,3 @@
-# coding: utf-8
 """
 Package resource API
 --------------------
@@ -13,9 +12,13 @@
 .egg files, and unpacked .egg files.  It can also work in a limited way with
 .zip files and with custom PEP 302 loaders that support the ``get_data()``
 method.
-"""
 
-from __future__ import absolute_import
+This module is deprecated. Users are directed to
+`importlib.resources <https://docs.python.org/3/library/importlib.resources.html>`_
+and
+`importlib.metadata <https://docs.python.org/3/library/importlib.metadata.html>`_
+instead.
+"""
 
 import sys
 import os
@@ -37,10 +40,10 @@
 import errno
 import tempfile
 import textwrap
-import itertools
 import inspect
 import ntpath
 import posixpath
+import importlib
 from pkgutil import get_importer
 
 try:
@@ -54,13 +57,12 @@
 except NameError:
     FileExistsError = OSError
 
-from pip._vendor import six
-from pip._vendor.six.moves import urllib, map, filter
-
 # capture these to bypass sandboxing
 from os import utime
+
 try:
     from os import mkdir, rename, unlink
+
     WRITE_SUPPORT = True
 except ImportError:
     # no write support, probably under GAE
@@ -71,31 +73,30 @@
 
 try:
     import importlib.machinery as importlib_machinery
+
     # access attribute to force import under delayed import mechanisms.
     importlib_machinery.__name__
 except ImportError:
     importlib_machinery = None
 
-from . import py31compat
+from pip._internal.utils._jaraco_text import (
+    yield_lines,
+    drop_comment,
+    join_continuation,
+)
+
 from pip._vendor import platformdirs
 from pip._vendor import packaging
+
 __import__('pip._vendor.packaging.version')
 __import__('pip._vendor.packaging.specifiers')
 __import__('pip._vendor.packaging.requirements')
 __import__('pip._vendor.packaging.markers')
+__import__('pip._vendor.packaging.utils')
 
-
-__metaclass__ = type
-
-
-if (3, 0) < sys.version_info < (3, 5):
+if sys.version_info < (3, 5):
     raise RuntimeError("Python 3.5 or later is required")
 
-if six.PY2:
-    # Those builtin exceptions are only defined in Python 3
-    PermissionError = None
-    NotADirectoryError = None
-
 # declare some globals that will be defined later to
 # satisfy the linters.
 require = None
@@ -117,6 +118,12 @@
 _namespace_packages = None
 
 
+warnings.warn("pkg_resources is deprecated as an API", DeprecationWarning)
+
+
+_PEP440_FALLBACK = re.compile(r"^v?(?P<safe>(?:0-9+!)?0-9+(?:\.0-9+)*)", re.I)
+
+
 class PEP440Warning(RuntimeWarning):
     """
     Used when there is an issue with a version or specifier not complying with
@@ -124,11 +131,7 @@
     """
 
 
-def parse_version(v):
-    try:
-        return packaging.version.Version(v)
-    except packaging.version.InvalidVersion:
-        return packaging.version.LegacyVersion(v)
+parse_version = packaging.version.Version
 
 
 _state_vars = {}
@@ -178,10 +181,10 @@
     """Return this platform's maximum compatible version.
 
     distutils.util.get_platform() normally reports the minimum version
-    of Mac OS X that would be required to *use* extensions produced by
+    of macOS that would be required to *use* extensions produced by
     distutils.  But what we want when checking compatibility is to know the
-    version of Mac OS X that we are *running*.  To allow usage of packages that
-    explicitly require a newer version of Mac OS X, we must also know the
+    version of macOS that we are *running*.  To allow usage of packages that
+    explicitly require a newer version of macOS, we must also know the
     current version of the OS.
 
     If this condition occurs for any other platform with a version in its
@@ -191,60 +194,96 @@
     m = macosVersionString.match(plat)
     if m is not None and sys.platform == "darwin":
         try:
-            plat = 'macosx-%s-%s' % ('.'.join(_macosx_vers():2), m.group(3))
+            plat = 'macosx-%s-%s' % ('.'.join(_macos_vers():2), m.group(3))
         except ValueError:
-            # not Mac OS X
+            # not macOS
             pass
     return plat
 
 
 __all__ = 
     # Basic resource access and distribution/entry point discovery
-    'require', 'run_script', 'get_provider', 'get_distribution',
-    'load_entry_point', 'get_entry_map', 'get_entry_info',
+    'require',
+    'run_script',
+    'get_provider',
+    'get_distribution',
+    'load_entry_point',
+    'get_entry_map',
+    'get_entry_info',
     'iter_entry_points',
-    'resource_string', 'resource_stream', 'resource_filename',
-    'resource_listdir', 'resource_exists', 'resource_isdir',
-
+    'resource_string',
+    'resource_stream',
+    'resource_filename',
+    'resource_listdir',
+    'resource_exists',
+    'resource_isdir',
     # Environmental control
-    'declare_namespace', 'working_set', 'add_activation_listener',
-    'find_distributions', 'set_extraction_path', 'cleanup_resources',
+    'declare_namespace',
+    'working_set',
+    'add_activation_listener',
+    'find_distributions',
+    'set_extraction_path',
+    'cleanup_resources',
     'get_default_cache',
-
     # Primary implementation classes
-    'Environment', 'WorkingSet', 'ResourceManager',
-    'Distribution', 'Requirement', 'EntryPoint',
-
+    'Environment',
+    'WorkingSet',
+    'ResourceManager',
+    'Distribution',
+    'Requirement',
+    'EntryPoint',
     # Exceptions
-    'ResolutionError', 'VersionConflict', 'DistributionNotFound',
-    'UnknownExtra', 'ExtractionError',
-
+    'ResolutionError',
+    'VersionConflict',
+    'DistributionNotFound',
+    'UnknownExtra',
+    'ExtractionError',
     # Warnings
     'PEP440Warning',
-
     # Parsing functions and string utilities
-    'parse_requirements', 'parse_version', 'safe_name', 'safe_version',
-    'get_platform', 'compatible_platforms', 'yield_lines', 'split_sections',
-    'safe_extra', 'to_filename', 'invalid_marker', 'evaluate_marker',
-
+    'parse_requirements',
+    'parse_version',
+    'safe_name',
+    'safe_version',
+    'get_platform',
+    'compatible_platforms',
+    'yield_lines',
+    'split_sections',
+    'safe_extra',
+    'to_filename',
+    'invalid_marker',
+    'evaluate_marker',
     # filesystem utilities
-    'ensure_directory', 'normalize_path',
-
+    'ensure_directory',
+    'normalize_path',
     # Distribution "precedence" constants
-    'EGG_DIST', 'BINARY_DIST', 'SOURCE_DIST', 'CHECKOUT_DIST', 'DEVELOP_DIST',
-
+    'EGG_DIST',
+    'BINARY_DIST',
+    'SOURCE_DIST',
+    'CHECKOUT_DIST',
+    'DEVELOP_DIST',
     # "Provider" interfaces, implementations, and registration/lookup APIs
-    'IMetadataProvider', 'IResourceProvider', 'FileMetadata',
-    'PathMetadata', 'EggMetadata', 'EmptyProvider', 'empty_provider',
-    'NullProvider', 'EggProvider', 'DefaultProvider', 'ZipProvider',
-    'register_finder', 'register_namespace_handler', 'register_loader_type',
-    'fixup_namespace_packages', 'get_importer',
-
+    'IMetadataProvider',
+    'IResourceProvider',
+    'FileMetadata',
+    'PathMetadata',
+    'EggMetadata',
+    'EmptyProvider',
+    'empty_provider',
+    'NullProvider',
+    'EggProvider',
+    'DefaultProvider',
+    'ZipProvider',
+    'register_finder',
+    'register_namespace_handler',
+    'register_loader_type',
+    'fixup_namespace_packages',
+    'get_importer',
     # Warnings
     'PkgResourcesDeprecationWarning',
-
     # Deprecated/backward compatibility only
-    'run_main', 'AvailableDistributions',
+    'run_main',
+    'AvailableDistributions',
 
 
 
@@ -303,8 +342,10 @@
 class DistributionNotFound(ResolutionError):
     """A requested distribution was not found"""
 
-    _template = ("The '{self.req}' distribution was not found "
-                 "and is required by {self.requirers_str}")
+    _template = (
+        "The '{self.req}' distribution was not found "
+        "and is required by {self.requirers_str}"
+    )
 
     @property
     def req(self):
@@ -364,7 +405,7 @@
     return _find_adapter(_provider_factories, loader)(module)
 
 
-def _macosx_vers(_cache=):
+def _macos_vers(_cache=):
     if not _cache:
         version = platform.mac_ver()0
         # fallback for MacPorts
@@ -380,7 +421,7 @@
     return _cache0
 
 
-def _macosx_arch(machine):
+def _macos_arch(machine):
     return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)
 
 
@@ -388,18 +429,19 @@
     """Return this platform's string for platform-specific distributions
 
     XXX Currently this is the same as ``distutils.util.get_platform()``, but it
-    needs some hacks for Linux and Mac OS X.
+    needs some hacks for Linux and macOS.
     """
     from sysconfig import get_platform
 
     plat = get_platform()
     if sys.platform == "darwin" and not plat.startswith('macosx-'):
         try:
-            version = _macosx_vers()
+            version = _macos_vers()
             machine = os.uname()4.replace(" ", "_")
             return "macosx-%d.%d-%s" % (
-                int(version0), int(version1),
-                _macosx_arch(machine),
+                int(version0),
+                int(version1),
+                _macos_arch(machine),
             )
         except ValueError:
             # if someone is running a non-Mac darwin system, this will fall
@@ -425,7 +467,7 @@
         # easy case
         return True
 
-    # Mac OS X special cases
+    # macOS special cases
     reqMac = macosVersionString.match(required)
     if reqMac:
         provMac = macosVersionString.match(provided)
@@ -434,20 +476,23 @@
         if not provMac:
             # this is backwards compatibility for packages built before
             # setuptools 0.6. All packages built after this point will
-            # use the new macosx designation.
+            # use the new macOS designation.
             provDarwin = darwinVersionString.match(provided)
             if provDarwin:
                 dversion = int(provDarwin.group(1))
                 macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
-                if dversion == 7 and macosversion >= "10.3" or \
-                        dversion == 8 and macosversion >= "10.4":
+                if (
+                    dversion == 7
+                    and macosversion >= "10.3"
+                    or dversion == 8
+                    and macosversion >= "10.4"
+                ):
                     return True
-            # egg isn't macosx or legacy darwin
+            # egg isn't macOS or legacy darwin
             return False
 
         # are they the same major version and machine type?
-        if provMac.group(1) != reqMac.group(1) or \
-                provMac.group(3) != reqMac.group(3):
+        if provMac.group(1) != reqMac.group(1) or provMac.group(3) != reqMac.group(3):
             return False
 
         # is the required OS major update >= the provided one?
@@ -475,7 +520,7 @@
 
 def get_distribution(dist):
     """Return a current distribution object for a Requirement or string"""
-    if isinstance(dist, six.string_types):
+    if isinstance(dist, str):
         dist = Requirement.parse(dist)
     if isinstance(dist, Requirement):
         dist = get_provider(dist)
@@ -509,8 +554,8 @@
     def get_metadata_lines(name):
         """Yield named metadata resource as list of non-blank non-comment lines
 
-       Leading and trailing whitespace is stripped from each line, and lines
-       with ``#`` as the first non-blank character are omitted."""
+        Leading and trailing whitespace is stripped from each line, and lines
+        with ``#`` as the first non-blank character are omitted."""
 
     def metadata_isdir(name):
         """Is the named metadata a directory?  (like ``os.path.isdir()``)"""
@@ -558,6 +603,7 @@
         self.entries = 
         self.entry_keys = {}
         self.by_key = {}
+        self.normalized_to_canonical_keys = {}
         self.callbacks = 
 
         if entries is None:
@@ -638,6 +684,14 @@
         is returned.
         """
         dist = self.by_key.get(req.key)
+
+        if dist is None:
+            canonical_key = self.normalized_to_canonical_keys.get(req.key)
+
+            if canonical_key is not None:
+                req.key = canonical_key
+                dist = self.by_key.get(canonical_key)
+
         if dist is not None and dist not in req:
             # XXX add more info
             raise VersionConflict(dist, req)
@@ -706,14 +760,22 @@
             return
 
         self.by_keydist.key = dist
+        normalized_name = packaging.utils.canonicalize_name(dist.key)
+        self.normalized_to_canonical_keysnormalized_name = dist.key
         if dist.key not in keys:
             keys.append(dist.key)
         if dist.key not in keys2:
             keys2.append(dist.key)
         self._added_new(dist)
 
-    def resolve(self, requirements, env=None, installer=None,
-                replace_conflicting=False, extras=None):
+    def resolve(
+        self,
+        requirements,
+        env=None,
+        installer=None,
+        replace_conflicting=False,
+        extras=None,
+    ):
         """List all distributions needed to (recursively) meet `requirements`
 
         `requirements` must be a sequence of ``Requirement`` objects.  `env`,
@@ -762,33 +824,9 @@
             if not req_extras.markers_pass(req, extras):
                 continue
 
-            dist = best.get(req.key)
-            if dist is None:
-                # Find the best distribution and add it to the map
-                dist = self.by_key.get(req.key)
-                if dist is None or (dist not in req and replace_conflicting):
-                    ws = self
-                    if env is None:
-                        if dist is None:
-                            env = Environment(self.entries)
-                        else:
-                            # Use an empty environment and workingset to avoid
-                            # any further conflicts with the conflicting
-                            # distribution
-                            env = Environment()
-                            ws = WorkingSet()
-                    dist = bestreq.key = env.best_match(
-                        req, ws, installer,
-                        replace_conflicting=replace_conflicting
-                    )
-                    if dist is None:
-                        requirers = required_by.get(req, None)
-                        raise DistributionNotFound(req, requirers)
-                to_activate.append(dist)
-            if dist not in req:
-                # Oops, the "best" so far conflicts with a dependency
-                dependent_req = required_byreq
-                raise VersionConflict(dist, req).with_context(dependent_req)
+            dist = self._resolve_dist(
+                req, best, replace_conflicting, env, installer, required_by, to_activate
+            )
 
             # push the new requirements onto the stack
             new_requirements = dist.requires(req.extras)::-1
@@ -804,8 +842,38 @@
         # return list of distros to activate
         return to_activate
 
-    def find_plugins(
-            self, plugin_env, full_env=None, installer=None, fallback=True):
+    def _resolve_dist(
+        self, req, best, replace_conflicting, env, installer, required_by, to_activate
+    ):
+        dist = best.get(req.key)
+        if dist is None:
+            # Find the best distribution and add it to the map
+            dist = self.by_key.get(req.key)
+            if dist is None or (dist not in req and replace_conflicting):
+                ws = self
+                if env is None:
+                    if dist is None:
+                        env = Environment(self.entries)
+                    else:
+                        # Use an empty environment and workingset to avoid
+                        # any further conflicts with the conflicting
+                        # distribution
+                        env = Environment()
+                        ws = WorkingSet()
+                dist = bestreq.key = env.best_match(
+                    req, ws, installer, replace_conflicting=replace_conflicting
+                )
+                if dist is None:
+                    requirers = required_by.get(req, None)
+                    raise DistributionNotFound(req, requirers)
+            to_activate.append(dist)
+        if dist not in req:
+            # Oops, the "best" so far conflicts with a dependency
+            dependent_req = required_byreq
+            raise VersionConflict(dist, req).with_context(dependent_req)
+        return dist
+
+    def find_plugins(self, plugin_env, full_env=None, installer=None, fallback=True):
         """Find all activatable distributions in `plugin_env`
 
         Example usage::
@@ -858,9 +926,7 @@
         list(map(shadow_set.add, self))
 
         for project_name in plugin_projects:
-
             for dist in plugin_envproject_name:
-
                 req = dist.as_requirement()
 
                 try:
@@ -924,15 +990,19 @@
 
     def __getstate__(self):
         return (
-            self.entries:, self.entry_keys.copy(), self.by_key.copy(),
-            self.callbacks:
+            self.entries:,
+            self.entry_keys.copy(),
+            self.by_key.copy(),
+            self.normalized_to_canonical_keys.copy(),
+            self.callbacks:,
         )
 
-    def __setstate__(self, e_k_b_c):
-        entries, keys, by_key, callbacks = e_k_b_c
+    def __setstate__(self, e_k_b_n_c):
+        entries, keys, by_key, normalized_to_canonical_keys, callbacks = e_k_b_n_c
         self.entries = entries:
         self.entry_keys = keys.copy()
         self.by_key = by_key.copy()
+        self.normalized_to_canonical_keys = normalized_to_canonical_keys.copy()
         self.callbacks = callbacks:
 
 
@@ -960,8 +1030,8 @@
     """Searchable snapshot of distributions on a search path"""
 
     def __init__(
-            self, search_path=None, platform=get_supported_platform(),
-            python=PY_MAJOR):
+        self, search_path=None, platform=get_supported_platform(), python=PY_MAJOR
+    ):
         """Snapshot distributions available on a search path
 
         Any distributions found on `search_path` are added to the environment.
@@ -1028,16 +1098,14 @@
         return self._distmap.get(distribution_key, )
 
     def add(self, dist):
-        """Add `dist` if we ``can_add()`` it and it has not already been added
-        """
+        """Add `dist` if we ``can_add()`` it and it has not already been added"""
         if self.can_add(dist) and dist.has_version():
             dists = self._distmap.setdefault(dist.key, )
             if dist not in dists:
                 dists.append(dist)
                 dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)
 
-    def best_match(
-            self, req, working_set, installer=None, replace_conflicting=False):
+    def best_match(self, req, working_set, installer=None, replace_conflicting=False):
         """Find distribution best matching `req` and usable on `working_set`
 
         This calls the ``find(req)`` method of the `working_set` to see if a
@@ -1124,6 +1192,7 @@
 
 class ResourceManager:
     """Manage resource extraction and packages"""
+
     extraction_path = None
 
     def __init__(self):
@@ -1135,9 +1204,7 @@
 
     def resource_isdir(self, package_or_requirement, resource_name):
         """Is the named resource an existing directory?"""
-        return get_provider(package_or_requirement).resource_isdir(
-            resource_name
-        )
+        return get_provider(package_or_requirement).resource_isdir(resource_name)
 
     def resource_filename(self, package_or_requirement, resource_name):
         """Return a true filesystem path for specified resource"""
@@ -1159,9 +1226,7 @@
 
     def resource_listdir(self, package_or_requirement, resource_name):
         """List the contents of the named resource directory"""
-        return get_provider(package_or_requirement).resource_listdir(
-            resource_name
-        )
+        return get_provider(package_or_requirement).resource_listdir(resource_name)
 
     def extraction_error(self):
         """Give an error message for problems extracting file(s)"""
@@ -1169,7 +1234,8 @@
         old_exc = sys.exc_info()1
         cache_path = self.extraction_path or get_default_cache()
 
-        tmpl = textwrap.dedent("""
+        tmpl = textwrap.dedent(
+            """
             Can't extract file(s) to egg cache
 
             The following error occurred while trying to extract file(s)
@@ -1184,7 +1250,8 @@
             Perhaps your account does not have write access to this directory?
             You can change the cache directory by setting the PYTHON_EGG_CACHE
             environment variable to point to an accessible directory.
-            """).lstrip()
+            """
+        ).lstrip()
         err = ExtractionError(tmpl.format(**locals()))
         err.manager = self
         err.cache_path = cache_path
@@ -1234,12 +1301,13 @@
         mode = os.stat(path).st_mode
         if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
             msg = (
-                "%s is writable by group/others and vulnerable to attack "
-                "when "
-                "used with get_resource_filename. Consider a more secure "
+                "Extraction path is writable by group/others "
+                "and vulnerable to attack when "
+                "used with get_resource_filename ({path}). "
+                "Consider a more secure "
                 "location (set with .set_extraction_path or the "
-                "PYTHON_EGG_CACHE environment variable)." % path
-            )
+                "PYTHON_EGG_CACHE environment variable)."
+            ).format(**locals())
             warnings.warn(msg, UserWarning)
 
     def postprocess(self, tempname, filename):
@@ -1282,9 +1350,7 @@
         ``cleanup_resources()``.)
         """
         if self.cached_files:
-            raise ValueError(
-                "Can't change extraction path, files already extracted"
-            )
+            raise ValueError("Can't change extraction path, files already extracted")
 
         self.extraction_path = path
 
@@ -1308,9 +1374,8 @@
     or a platform-relevant user cache dir for an app
     named "Python-Eggs".
     """
-    return (
-        os.environ.get('PYTHON_EGG_CACHE')
-        or platformdirs.user_cache_dir(appname='Python-Eggs')
+    return os.environ.get('PYTHON_EGG_CACHE') or platformdirs.user_cache_dir(
+        appname='Python-Eggs'
     )
 
 
@@ -1334,6 +1399,38 @@
         return re.sub('^A-Za-z0-9.+', '-', version)
 
 
+def _forgiving_version(version):
+    """Fallback when ``safe_version`` is not safe enough
+    >>> parse_version(_forgiving_version('0.23ubuntu1'))
+    <Version('0.23.dev0+sanitized.ubuntu1')>
+    >>> parse_version(_forgiving_version('0.23-'))
+    <Version('0.23.dev0+sanitized')>
+    >>> parse_version(_forgiving_version('0.-_'))
+    <Version('0.dev0+sanitized')>
+    >>> parse_version(_forgiving_version('42.+?1'))
+    <Version('42.dev0+sanitized.1')>
+    >>> parse_version(_forgiving_version('hello world'))
+    <Version('0.dev0+sanitized.hello.world')>
+    """
+    version = version.replace(' ', '.')
+    match = _PEP440_FALLBACK.search(version)
+    if match:
+        safe = match"safe"
+        rest = versionlen(safe):
+    else:
+        safe = "0"
+        rest = version
+    local = f"sanitized.{_safe_segment(rest)}".strip(".")
+    return f"{safe}.dev0+{local}"
+
+
+def _safe_segment(segment):
+    """Convert an arbitrary string into a safe segment"""
+    segment = re.sub('^A-Za-z0-9.+', '-', segment)
+    segment = re.sub('-^A-Za-z0-9+', '-', segment)
+    return re.sub(r'\.^A-Za-z0-9+', '.', segment).strip(".-")
+
+
 def safe_extra(extra):
     """Convert an arbitrary string to a standard 'extra' name
 
@@ -1377,7 +1474,7 @@
         marker = packaging.markers.Marker(text)
         return marker.evaluate()
     except packaging.markers.InvalidMarker as e:
-        raise SyntaxError(e)
+        raise SyntaxError(e) from e
 
 
 class NullProvider:
@@ -1418,8 +1515,6 @@
             return ""
         path = self._get_metadata_path(name)
         value = self._get(path)
-        if six.PY2:
-            return value
         try:
             return value.decode('utf-8')
         except UnicodeDecodeError as exc:
@@ -1449,21 +1544,27 @@
         script = 'scripts/' + script_name
         if not self.has_metadata(script):
             raise ResolutionError(
-                "Script {script!r} not found in metadata at {self.egg_info!r}"
-                .format(**locals()),
+                "Script {script!r} not found in metadata at {self.egg_info!r}".format(
+                    **locals()
+                ),
             )
         script_text = self.get_metadata(script).replace('\r\n', '\n')
         script_text = script_text.replace('\r', '\n')
         script_filename = self._fn(self.egg_info, script)
         namespace'__file__' = script_filename
         if os.path.exists(script_filename):
-            source = open(script_filename).read()
+            with open(script_filename) as fid:
+                source = fid.read()
             code = compile(source, script_filename, 'exec')
             exec(code, namespace, namespace)
         else:
             from linecache import cache
+
             cachescript_filename = (
-                len(script_text), 0, script_text.split('\n'), script_filename
+                len(script_text),
+                0,
+                script_text.split('\n'),
+                script_filename,
             )
             script_code = compile(script_text, script_filename, 'exec')
             exec(script_code, namespace, namespace)
@@ -1493,7 +1594,7 @@
     def _validate_resource_path(path):
         """
         Validate the resource paths according to the docs.
-        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access
+        https://setuptools.pypa.io/en/latest/pkg_resources.html#basic-resource-access
 
         >>> warned = getfixture('recwarn')
         >>> warnings.simplefilter('always')
@@ -1543,9 +1644,9 @@
         AttributeError: ...
         """
         invalid = (
-            os.path.pardir in path.split(posixpath.sep) or
-            posixpath.isabs(path) or
-            ntpath.isabs(path)
+            os.path.pardir in path.split(posixpath.sep)
+            or posixpath.isabs(path)
+            or ntpath.isabs(path)
         )
         if not invalid:
             return
@@ -1575,26 +1676,35 @@
 register_loader_type(object, NullProvider)
 
 
+def _parents(path):
+    """
+    yield all parents of path including path
+    """
+    last = None
+    while path != last:
+        yield path
+        last = path
+        path, _ = os.path.split(path)
+
+
 class EggProvider(NullProvider):
     """Provider based on a virtual filesystem"""
 
     def __init__(self, module):
-        NullProvider.__init__(self, module)
+        super().__init__(module)
         self._setup_prefix()
 
     def _setup_prefix(self):
-        # we assume here that our metadata may be nested inside a "basket"
-        # of multiple eggs; that's why we use module_path instead of .archive
-        path = self.module_path
-        old = None
-        while path != old:
-            if _is_egg_path(path):
-                self.egg_name = os.path.basename(path)
-                self.egg_info = os.path.join(path, 'EGG-INFO')
-                self.egg_root = path
-                break
-            old = path
-            path, base = os.path.split(path)
+        # Assume that metadata may be nested inside a "basket"
+        # of multiple eggs and use module_path instead of .archive.
+        eggs = filter(_is_egg_path, _parents(self.module_path))
+        egg = next(eggs, None)
+        egg and self._set_egg(egg)
+
+    def _set_egg(self, path):
+        self.egg_name = os.path.basename(path)
+        self.egg_info = os.path.join(path, 'EGG-INFO')
+        self.egg_root = path
 
 
 class DefaultProvider(EggProvider):
@@ -1618,7 +1728,10 @@
 
     @classmethod
     def _register(cls):
-        loader_names = 'SourceFileLoader', 'SourcelessFileLoader',
+        loader_names = (
+            'SourceFileLoader',
+            'SourcelessFileLoader',
+        )
         for name in loader_names:
             loader_cls = getattr(importlib_machinery, name, type(None))
             register_loader_type(loader_cls, cls)
@@ -1678,6 +1791,7 @@
     """
     Memoized zipfile manifests.
     """
+
     manifest_mod = collections.namedtuple('manifest_mod', 'manifest mtime')
 
     def load(self, path):
@@ -1701,7 +1815,7 @@
     _zip_manifests = MemoizedZipManifests()
 
     def __init__(self, module):
-        EggProvider.__init__(self, module)
+        super().__init__(module)
         self.zip_pre = self.loader.archive + os.sep
 
     def _zipinfo_name(self, fspath):
@@ -1711,20 +1825,16 @@
         if fspath == self.loader.archive:
             return ''
         if fspath.startswith(self.zip_pre):
-            return fspathlen(self.zip_pre):
-        raise AssertionError(
-            "%s is not a subpath of %s" % (fspath, self.zip_pre)
-        )
+            return fspathlen(self.zip_pre) :
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.zip_pre))
 
     def _parts(self, zip_path):
         # Convert a zipfile subpath into an egg-relative path part list.
         # pseudo-fs path
         fspath = self.zip_pre + zip_path
         if fspath.startswith(self.egg_root + os.sep):
-            return fspathlen(self.egg_root) + 1:.split(os.sep)
-        raise AssertionError(
-            "%s is not a subpath of %s" % (fspath, self.egg_root)
-        )
+            return fspathlen(self.egg_root) + 1 :.split(os.sep)
+        raise AssertionError("%s is not a subpath of %s" % (fspath, self.egg_root))
 
     @property
     def zipinfo(self):
@@ -1752,26 +1862,22 @@
         timestamp = time.mktime(date_time)
         return timestamp, size
 
-    def _extract_resource(self, manager, zip_path):
-
+    # FIXME: 'ZipProvider._extract_resource' is too complex (12)
+    def _extract_resource(self, manager, zip_path):  # noqa: C901
         if zip_path in self._index():
             for name in self._index()zip_path:
-                last = self._extract_resource(
-                    manager, os.path.join(zip_path, name)
-                )
+                last = self._extract_resource(manager, os.path.join(zip_path, name))
             # return the extracted directory name
             return os.path.dirname(last)
 
         timestamp, size = self._get_date_and_size(self.zipinfozip_path)
 
         if not WRITE_SUPPORT:
-            raise IOError('"os.rename" and "os.unlink" are not supported '
-                          'on this platform')
-        try:
-
-            real_path = manager.get_cache_path(
-                self.egg_name, self._parts(zip_path)
+            raise IOError(
+                '"os.rename" and "os.unlink" are not supported ' 'on this platform'
             )
+        try:
+            real_path = manager.get_cache_path(self.egg_name, self._parts(zip_path))
 
             if self._is_current(real_path, zip_path):
                 return real_path
@@ -1900,8 +2006,7 @@
         return metadata
 
     def _warn_on_replacement(self, metadata):
-        # Python 2.7 compat for: replacement_char = '�'
-        replacement_char = b'\xef\xbf\xbd'.decode('utf-8')
+        replacement_char = '�'
         if replacement_char in metadata:
             tmpl = "{self.path} could not be properly decoded in UTF-8"
             msg = tmpl.format(**locals())
@@ -1991,7 +2096,7 @@
             dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
             for dist in dists:
                 yield dist
-        elif subitem.lower().endswith('.dist-info'):
+        elif subitem.lower().endswith(('.dist-info', '.egg-info')):
             subpath = os.path.join(path_item, subitem)
             submeta = EggMetadata(zipimport.zipimporter(subpath))
             submeta.egg_info = subpath
@@ -2008,58 +2113,21 @@
 register_finder(object, find_nothing)
 
 
-def _by_version_descending(names):
-    """
-    Given a list of filenames, return them in descending order
-    by version number.
-
-    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
-    >>> _by_version_descending(names)
-    'Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar'
-    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
-    >>> _by_version_descending(names)
-    'Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg'
-    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
-    >>> _by_version_descending(names)
-    'Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg'
-    """
-    def _by_version(name):
-        """
-        Parse each component of the filename
-        """
-        name, ext = os.path.splitext(name)
-        parts = itertools.chain(name.split('-'), ext)
-        return packaging.version.parse(part) for part in parts
-
-    return sorted(names, key=_by_version, reverse=True)
-
-
 def find_on_path(importer, path_item, only=False):
     """Yield distributions accessible on a sys.path directory"""
     path_item = _normalize_cached(path_item)
 
     if _is_unpacked_egg(path_item):
         yield Distribution.from_filename(
-            path_item, metadata=PathMetadata(
-                path_item, os.path.join(path_item, 'EGG-INFO')
-            )
+            path_item,
+            metadata=PathMetadata(path_item, os.path.join(path_item, 'EGG-INFO')),
         )
         return
 
-    entries = safe_listdir(path_item)
-
-    # for performance, before sorting by version,
-    # screen entries for only those that will yield
-    # distributions
-    filtered = (
-        entry
-        for entry in entries
-        if dist_factory(path_item, entry, only)
-    )
+    entries = (os.path.join(path_item, child) for child in safe_listdir(path_item))
 
     # scan for .egg and .egg-info in directory
-    path_item_entries = _by_version_descending(filtered)
-    for entry in path_item_entries:
+    for entry in sorted(entries):
         fullpath = os.path.join(path_item, entry)
         factory = dist_factory(path_item, entry, only)
         for dist in factory(fullpath):
@@ -2067,19 +2135,21 @@
 
 
 def dist_factory(path_item, entry, only):
-    """
-    Return a dist_factory for a path_item and entry
-    """
+    """Return a dist_factory for the given entry."""
     lower = entry.lower()
-    is_meta = any(map(lower.endswith, ('.egg-info', '.dist-info')))
+    is_egg_info = lower.endswith('.egg-info')
+    is_dist_info = lower.endswith('.dist-info') and os.path.isdir(
+        os.path.join(path_item, entry)
+    )
+    is_meta = is_egg_info or is_dist_info
     return (
         distributions_from_metadata
-        if is_meta else
-        find_distributions
-        if not only and _is_egg_path(entry) else
-        resolve_egg_link
-        if not only and lower.endswith('.egg-link') else
-        NoDists()
+        if is_meta
+        else find_distributions
+        if not only and _is_egg_path(entry)
+        else resolve_egg_link
+        if not only and lower.endswith('.egg-link')
+        else NoDists()
     )
 
 
@@ -2091,10 +2161,9 @@
     >>> list(NoDists()('anything'))
     
     """
+
     def __bool__(self):
         return False
-    if six.PY2:
-        __nonzero__ = __bool__
 
     def __call__(self, fullpath):
         return iter(())
@@ -2111,12 +2180,7 @@
     except OSError as e:
         # Ignore the directory if does not exist, not a directory or
         # permission denied
-        ignorable = (
-            e.errno in (errno.ENOTDIR, errno.EACCES, errno.ENOENT)
-            # Python 2 on Windows needs to be handled this way :(
-            or getattr(e, "winerror", None) == 267
-        )
-        if not ignorable:
+        if e.errno not in (errno.ENOTDIR, errno.EACCES, errno.ENOENT):
             raise
     return ()
 
@@ -2132,7 +2196,10 @@
         metadata = FileMetadata(path)
     entry = os.path.basename(path)
     yield Distribution.from_location(
-        root, entry, metadata, precedence=DEVELOP_DIST,
+        root,
+        entry,
+        metadata,
+        precedence=DEVELOP_DIST,
     )
 
 
@@ -2154,17 +2221,16 @@
     """
     referenced_paths = non_empty_lines(path)
     resolved_paths = (
-        os.path.join(os.path.dirname(path), ref)
-        for ref in referenced_paths
+        os.path.join(os.path.dirname(path), ref) for ref in referenced_paths
     )
     dist_groups = map(find_distributions, resolved_paths)
     return next(dist_groups, ())
 
 
-register_finder(pkgutil.ImpImporter, find_on_path)
+if hasattr(pkgutil, 'ImpImporter'):
+    register_finder(pkgutil.ImpImporter, find_on_path)
 
-if hasattr(importlib_machinery, 'FileFinder'):
-    register_finder(importlib_machinery.FileFinder, find_on_path)
+register_finder(importlib_machinery.FileFinder, find_on_path)
 
 _declare_state('dict', _namespace_handlers={})
 _declare_state('dict', _namespace_packages={})
@@ -2195,10 +2261,16 @@
     if importer is None:
         return None
 
-    # capture warnings due to #1111
-    with warnings.catch_warnings():
-        warnings.simplefilter("ignore")
-        loader = importer.find_module(packageName)
+    # use find_spec (PEP 451) and fall-back to find_module (PEP 302)
+    try:
+        spec = importer.find_spec(packageName)
+    except AttributeError:
+        # capture warnings due to #1111
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore")
+            loader = importer.find_module(packageName)
+    else:
+        loader = spec.loader if spec else None
 
     if loader is None:
         return None
@@ -2214,7 +2286,7 @@
     if subpath is not None:
         path = module.__path__
         path.append(subpath)
-        loader.load_module(packageName)
+        importlib.import_module(packageName)
         _rebuild_mod_path(path, packageName, module)
     return subpath
 
@@ -2256,6 +2328,15 @@
 def declare_namespace(packageName):
     """Declare that package 'packageName' is a namespace package"""
 
+    msg = (
+        f"Deprecated call to `pkg_resources.declare_namespace({packageName!r})`.\n"
+        "Implementing implicit namespace packages (as specified in PEP 420) "
+        "is preferred to `pkg_resources.declare_namespace`. "
+        "See https://setuptools.pypa.io/en/latest/references/"
+        "keywords.html#keyword-namespace-packages"
+    )
+    warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
     _imp.acquire_lock()
     try:
         if packageName in _namespace_packages:
@@ -2270,8 +2351,8 @@
                 __import__(parent)
             try:
                 path = sys.modulesparent.__path__
-            except AttributeError:
-                raise TypeError("Not a package:", parent)
+            except AttributeError as e:
+                raise TypeError("Not a package:", parent) from e
 
         # Track what packages are namespaces, so when new path items are added,
         # they can be updated
@@ -2312,11 +2393,11 @@
         return subpath
 
 
-register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
-register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+if hasattr(pkgutil, 'ImpImporter'):
+    register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
 
-if hasattr(importlib_machinery, 'FileFinder'):
-    register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler)
+register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler)
 
 
 def null_ns_handler(importer, path_item, packageName, module):
@@ -2354,16 +2435,23 @@
     """
     Determine if given path appears to be an egg.
     """
-    return path.lower().endswith('.egg')
+    return _is_zip_egg(path) or _is_unpacked_egg(path)
+
+
+def _is_zip_egg(path):
+    return (
+        path.lower().endswith('.egg')
+        and os.path.isfile(path)
+        and zipfile.is_zipfile(path)
+    )
 
 
 def _is_unpacked_egg(path):
     """
     Determine if given path appears to be an unpacked egg.
     """
-    return (
-        _is_egg_path(path) and
-        os.path.isfile(os.path.join(path, 'EGG-INFO', 'PKG-INFO'))
+    return path.lower().endswith('.egg') and os.path.isfile(
+        os.path.join(path, 'EGG-INFO', 'PKG-INFO')
     )
 
 
@@ -2375,20 +2463,6 @@
         setattr(sys.modulesparent, name, sys.modulespackageName)
 
 
-def yield_lines(strs):
-    """Yield non-empty/non-comment lines of a string or sequence"""
-    if isinstance(strs, six.string_types):
-        for s in strs.splitlines():
-            s = s.strip()
-            # skip blank lines/comments
-            if s and not s.startswith('#'):
-                yield s
-    else:
-        for ss in strs:
-            for s in yield_lines(ss):
-                yield s
-
-
 MODULE = re.compile(r"\w+(\.\w+)*$").match
 EGG_NAME = re.compile(
     r"""
@@ -2450,7 +2524,7 @@
         try:
             return functools.reduce(getattr, self.attrs, module)
         except AttributeError as exc:
-            raise ImportError(str(exc))
+            raise ImportError(str(exc)) from exc
 
     def require(self, env=None, installer=None):
         if self.extras and not self.dist:
@@ -2536,22 +2610,15 @@
         return maps
 
 
-def _remove_md5_fragment(location):
-    if not location:
-        return ''
-    parsed = urllib.parse.urlparse(location)
-    if parsed-1.startswith('md5='):
-        return urllib.parse.urlunparse(parsed:-1 + ('',))
-    return location
-
-
 def _version_from_file(lines):
     """
     Given an iterable of lines from a Metadata file, return
     the value of the Version field, if present, or None otherwise.
     """
+
     def is_version_line(line):
         return line.lower().startswith('version:')
+
     version_lines = filter(is_version_line, lines)
     line = next(iter(version_lines), '')
     _, _, value = line.partition(':')
@@ -2560,12 +2627,19 @@
 
 class Distribution:
     """Wrap an actual or potential sys.path entry w/metadata"""
+
     PKG_INFO = 'PKG-INFO'
 
     def __init__(
-            self, location=None, metadata=None, project_name=None,
-            version=None, py_version=PY_MAJOR, platform=None,
-            precedence=EGG_DIST):
+        self,
+        location=None,
+        metadata=None,
+        project_name=None,
+        version=None,
+        py_version=PY_MAJOR,
+        platform=None,
+        precedence=EGG_DIST,
+    ):
         self.project_name = safe_name(project_name or 'Unknown')
         if version is not None:
             self._version = safe_version(version)
@@ -2588,8 +2662,13 @@
                     'name', 'ver', 'pyver', 'plat'
                 )
         return cls(
-            location, metadata, project_name=project_name, version=version,
-            py_version=py_version, platform=platform, **kw
+            location,
+            metadata,
+            project_name=project_name,
+            version=version,
+            py_version=py_version,
+            platform=platform,
+            **kw,
         )._reload_version()
 
     def _reload_version(self):
@@ -2598,10 +2677,10 @@
     @property
     def hashcmp(self):
         return (
-            self.parsed_version,
+            self._forgiving_parsed_version,
             self.precedence,
             self.key,
-            _remove_md5_fragment(self.location),
+            self.location,
             self.py_version or '',
             self.platform or '',
         )
@@ -2645,48 +2724,55 @@
     @property
     def parsed_version(self):
         if not hasattr(self, "_parsed_version"):
-            self._parsed_version = parse_version(self.version)
+            try:
+                self._parsed_version = parse_version(self.version)
+            except packaging.version.InvalidVersion as ex:
+                info = f"(package: {self.project_name})"
+                if hasattr(ex, "add_note"):
+                    ex.add_note(info)  # PEP 678
+                    raise
+                raise packaging.version.InvalidVersion(f"{str(ex)} {info}") from None
 
         return self._parsed_version
 
-    def _warn_legacy_version(self):
-        LV = packaging.version.LegacyVersion
-        is_legacy = isinstance(self._parsed_version, LV)
-        if not is_legacy:
-            return
-
-        # While an empty version is technically a legacy version and
-        # is not a valid PEP 440 version, it's also unlikely to
-        # actually come from someone and instead it is more likely that
-        # it comes from setuptools attempting to parse a filename and
-        # including it in the list. So for that we'll gate this warning
-        # on if the version is anything at all or not.
-        if not self.version:
-            return
-
-        tmpl = textwrap.dedent("""
-            '{project_name} ({version})' is being parsed as a legacy,
-            non PEP 440,
-            version. You may find odd behavior and sort order.
-            In particular it will be sorted as less than 0.0. It
-            is recommended to migrate to PEP 440 compatible
-            versions.
-            """).strip().replace('\n', ' ')
+    @property
+    def _forgiving_parsed_version(self):
+        try:
+            return self.parsed_version
+        except packaging.version.InvalidVersion as ex:
+            self._parsed_version = parse_version(_forgiving_version(self.version))
+
+            notes = "\n".join(getattr(ex, "__notes__", ))  # PEP 678
+            msg = f"""!!\n\n
+            *************************************************************************
+            {str(ex)}\n{notes}
+
+            This is a long overdue deprecation.
+            For the time being, `pkg_resources` will use `{self._parsed_version}`
+            as a replacement to avoid breaking existing environments,
+            but no future compatibility is guaranteed.
+
+            If you maintain package {self.project_name} you should implement
+            the relevant changes to adequate the project to PEP 440 immediately.
+            *************************************************************************
+            \n\n!!
+            """
+            warnings.warn(msg, DeprecationWarning)
 
-        warnings.warn(tmpl.format(**vars(self)), PEP440Warning)
+            return self._parsed_version
 
     @property
     def version(self):
         try:
             return self._version
-        except AttributeError:
+        except AttributeError as e:
             version = self._get_version()
             if version is None:
                 path = self._get_metadata_path_for_display(self.PKG_INFO)
-                msg = (
-                    "Missing 'Version:' header and/or {} file at path: {}"
-                ).format(self.PKG_INFO, path)
-                raise ValueError(msg, self)
+                msg = ("Missing 'Version:' header and/or {} file at path: {}").format(
+                    self.PKG_INFO, path
+                )
+                raise ValueError(msg, self) from e
 
             return version
 
@@ -2714,8 +2800,7 @@
             reqs = dm.pop(extra)
             new_extra, _, marker = extra.partition(':')
             fails_marker = marker and (
-                invalid_marker(marker)
-                or not evaluate_marker(marker)
+                invalid_marker(marker) or not evaluate_marker(marker)
             )
             if fails_marker:
                 reqs = 
@@ -2739,10 +2824,10 @@
         for ext in extras:
             try:
                 deps.extend(dmsafe_extra(ext))
-            except KeyError:
+            except KeyError as e:
                 raise UnknownExtra(
                     "%s has no such extra feature %r" % (self, ext)
-                )
+                ) from e
         return deps
 
     def _get_metadata_path_for_display(self, name):
@@ -2787,8 +2872,9 @@
     def egg_name(self):
         """Return what this distribution's standard .egg filename should be"""
         filename = "%s-%s-py%s" % (
-            to_filename(self.project_name), to_filename(self.version),
-            self.py_version or PY_MAJOR
+            to_filename(self.project_name),
+            to_filename(self.version),
+            self.py_version or PY_MAJOR,
         )
 
         if self.platform:
@@ -2818,21 +2904,13 @@
     def __dir__(self):
         return list(
             set(super(Distribution, self).__dir__())
-            | set(
-                attr for attr in self._provider.__dir__()
-                if not attr.startswith('_')
-            )
+            | set(attr for attr in self._provider.__dir__() if not attr.startswith('_'))
         )
 
-    if not hasattr(object, '__dir__'):
-        # python 2.7 not supported
-        del __dir__
-
     @classmethod
     def from_filename(cls, filename, metadata=None, **kw):
         return cls.from_location(
-            _normalize_cached(filename), os.path.basename(filename), metadata,
-            **kw
+            _normalize_cached(filename), os.path.basename(filename), metadata, **kw
         )
 
     def as_requirement(self):
@@ -2867,7 +2945,8 @@
         """Return the EntryPoint object for `group`+`name`, or ``None``"""
         return self.get_entry_map(group).get(name)
 
-    def insert_on(self, path, loc=None, replace=False):
+    # FIXME: 'Distribution.insert_on' is too complex (13)
+    def insert_on(self, path, loc=None, replace=False):  # noqa: C901
         """Ensure self.location is on path
 
         If replace=False (default):
@@ -2943,14 +3022,18 @@
         nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
         loc = normalize_path(self.location)
         for modname in self._get_metadata('top_level.txt'):
-            if (modname not in sys.modules or modname in nsp
-                    or modname in _namespace_packages):
+            if (
+                modname not in sys.modules
+                or modname in nsp
+                or modname in _namespace_packages
+            ):
                 continue
             if modname in ('pkg_resources', 'setuptools', 'site'):
                 continue
             fn = getattr(sys.modulesmodname, '__file__', None)
-            if fn and (normalize_path(fn).startswith(loc) or
-                       fn.startswith(self.location)):
+            if fn and (
+                normalize_path(fn).startswith(loc) or fn.startswith(self.location)
+            ):
                 continue
             issue_warning(
                 "Module %s was already imported from %s, but %s is being added"
@@ -2963,6 +3046,9 @@
         except ValueError:
             issue_warning("Unbuilt egg for " + repr(self))
             return False
+        except SystemError:
+            # TODO: remove this except clause when python/cpython#103632 is fixed.
+            return False
         return True
 
     def clone(self, **kw):
@@ -3002,6 +3088,7 @@
     Wrap an actual or potential sys.path entry
     w/metadata, .dist-info style.
     """
+
     PKG_INFO = 'METADATA'
     EQEQ = re.compile(r"($,)\s*(\d.*?)\s*(,$)")
 
@@ -3037,12 +3124,12 @@
                 if not req.marker or req.marker.evaluate({'extra': extra}):
                     yield req
 
-        common = frozenset(reqs_for_extra(None))
+        common = types.MappingProxyType(dict.fromkeys(reqs_for_extra(None)))
         dmNone.extend(common)
 
         for extra in self._parsed_pkg_info.get_all('Provides-Extra') or :
             s_extra = safe_extra(extra.strip())
-            dms_extra = list(frozenset(reqs_for_extra(extra)) - common)
+            dms_extra = r for r in reqs_for_extra(extra) if r not in common
 
         return dm
 
@@ -3067,45 +3154,27 @@
     warnings.warn(stacklevel=level + 1, *args, **kw)
 
 
-class RequirementParseError(ValueError):
-    def __str__(self):
-        return ' '.join(self.args)
-
-
 def parse_requirements(strs):
-    """Yield ``Requirement`` objects for each specification in `strs`
+    """
+    Yield ``Requirement`` objects for each specification in `strs`.
 
     `strs` must be a string, or a (possibly-nested) iterable thereof.
     """
-    # create a steppable iterator, so we can handle \-continuations
-    lines = iter(yield_lines(strs))
+    return map(Requirement, join_continuation(map(drop_comment, yield_lines(strs))))
 
-    for line in lines:
-        # Drop comments -- a hash without a space may be in a URL.
-        if ' #' in line:
-            line = line:line.find(' #')
-        # If there is a line continuation, drop it, and append the next line.
-        if line.endswith('\\'):
-            line = line:-2.strip()
-            try:
-                line += next(lines)
-            except StopIteration:
-                return
-        yield Requirement(line)
+
+class RequirementParseError(packaging.requirements.InvalidRequirement):
+    "Compatibility wrapper for InvalidRequirement"
 
 
 class Requirement(packaging.requirements.Requirement):
     def __init__(self, requirement_string):
         """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
-        try:
-            super(Requirement, self).__init__(requirement_string)
-        except packaging.requirements.InvalidRequirement as e:
-            raise RequirementParseError(str(e))
+        super(Requirement, self).__init__(requirement_string)
         self.unsafe_name = self.name
         project_name = safe_name(self.name)
         self.project_name, self.key = project_name, project_name.lower()
-        self.specs = 
-            (spec.operator, spec.version) for spec in self.specifier
+        self.specs = (spec.operator, spec.version) for spec in self.specifier
         self.extras = tuple(map(safe_extra, self.extras))
         self.hashCmp = (
             self.key,
@@ -3117,10 +3186,7 @@
         self.__hash = hash(self.hashCmp)
 
     def __eq__(self, other):
-        return (
-            isinstance(other, Requirement) and
-            self.hashCmp == other.hashCmp
-        )
+        return isinstance(other, Requirement) and self.hashCmp == other.hashCmp
 
     def __ne__(self, other):
         return not self == other
@@ -3145,7 +3211,7 @@
 
     @staticmethod
     def parse(s):
-        req, = parse_requirements(s)
+        (req,) = parse_requirements(s)
         return req
 
 
@@ -3170,7 +3236,7 @@
 def ensure_directory(path):
     """Ensure that the parent directory of `path` exists"""
     dirname = os.path.dirname(path)
-    py31compat.makedirs(dirname, exist_ok=True)
+    os.makedirs(dirname, exist_ok=True)
 
 
 def _bypass_ensure_directory(path):
@@ -3248,6 +3314,15 @@
     )
 
 
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
+
+
 @_call_aside
 def _initialize_master_working_set():
     """
@@ -3274,10 +3349,7 @@
     # ensure that all distributions added to the working set in the future
     # (e.g. by calling ``require()``) will get activated as well,
     # with higher priority (replace=True).
-    tuple(
-        dist.activate(replace=False)
-        for dist in working_set
-    )
+    tuple(dist.activate(replace=False) for dist in working_set)
     add_activation_listener(
         lambda dist: dist.activate(replace=True),
         existing=False,
@@ -3286,11 +3358,3 @@
     # match order
     list(map(working_set.add_entry, sys.path))
     globals().update(locals())
-
-class PkgResourcesDeprecationWarning(Warning):
-    """
-    Base class for warning about deprecations in ``pkg_resources``
-
-    This class is not derived from ``DeprecationWarning``, and as such is
-    visible by default.
-    """

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/LICENSE Added

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2010-202x The platformdirs developers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/__init__.py Changed

@@ -7,13 +7,15 @@
 import os
 import sys
 from pathlib import Path
-from typing import TYPE_CHECKING
 
-if TYPE_CHECKING:
-    from pip._vendor.typing_extensions import Literal  # pragma: no cover
+if sys.version_info >= (3, 8):  # pragma: no cover (py38+)
+    from typing import Literal
+else:  # pragma: no cover (py38+)
+    from pip._vendor.typing_extensions import Literal
 
 from .api import PlatformDirsABC
-from .version import __version__, __version_info__
+from .version import __version__
+from .version import __version_tuple__ as __version_info__
 
 
 def _set_platform_dir_class() -> typePlatformDirsABC:
@@ -25,8 +27,7 @@
         from pip._vendor.platformdirs.unix import Unix as Result
 
     if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
-
-        if os.getenv("SHELL") is not None:
+        if os.getenv("SHELL") or os.getenv("PREFIX"):
             return Result
 
         from pip._vendor.platformdirs.android import _android_folder
@@ -48,15 +49,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     roaming: bool = False,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
-    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: data directory tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_data_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_data_dir
 
 
 def site_data_dir(
@@ -64,15 +73,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     multipath: bool = False,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: data directory shared by users
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_data_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_data_dir
 
 
 def user_config_dir(
@@ -80,15 +97,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     roaming: bool = False,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
-    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: config directory tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_config_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_config_dir
 
 
 def site_config_dir(
@@ -96,15 +121,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     multipath: bool = False,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: config directory shared by the users
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_config_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_dir
 
 
 def user_cache_dir(
@@ -112,15 +145,47 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     opinion: bool = True,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_cache_dir
+
+
+def site_cache_dir(
+    appname: str | None = None,
+    appauthor: str | None | LiteralFalse = None,
+    version: str | None = None,
+    opinion: bool = True,
+    ensure_exists: bool = False,
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: cache directory tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_cache_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_dir
 
 
 def user_state_dir(
@@ -128,15 +193,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     roaming: bool = False,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
-    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: state directory tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_state_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_state_dir
 
 
 def user_log_dir(
@@ -144,15 +217,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     opinion: bool = True,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: log directory tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_log_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_log_dir
 
 
 def user_documents_dir() -> str:
@@ -167,15 +248,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     opinion: bool = True,
+    ensure_exists: bool = False,
 ) -> str:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: runtime directory tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_runtime_dir
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_runtime_dir
 
 
 def user_data_path(
@@ -183,15 +272,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     roaming: bool = False,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
-    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: data path tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_data_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_data_path
 
 
 def site_data_path(
@@ -199,15 +296,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     multipath: bool = False,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: data path shared by users
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_data_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_data_path
 
 
 def user_config_path(
@@ -215,15 +320,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     roaming: bool = False,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
-    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: config path tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_config_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_config_path
 
 
 def site_config_path(
@@ -231,15 +344,47 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     multipath: bool = False,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: config path shared by the users
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, multipath=multipath).site_config_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_path
+
+
+def site_cache_path(
+    appname: str | None = None,
+    appauthor: str | None | LiteralFalse = None,
+    version: str | None = None,
+    opinion: bool = True,
+    ensure_exists: bool = False,
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_path
 
 
 def user_cache_path(
@@ -247,15 +392,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     opinion: bool = True,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: cache path tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_cache_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_cache_path
 
 
 def user_state_path(
@@ -263,15 +416,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     roaming: bool = False,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
-    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: state path tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, roaming=roaming).user_state_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_state_path
 
 
 def user_log_path(
@@ -279,15 +440,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     opinion: bool = True,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: log path tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_log_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_log_path
 
 
 def user_documents_path() -> Path:
@@ -302,15 +471,23 @@
     appauthor: str | None | LiteralFalse = None,
     version: str | None = None,
     opinion: bool = True,
+    ensure_exists: bool = False,
 ) -> Path:
     """
     :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
     :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
     :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
     :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     :returns: runtime path tied to the user
     """
-    return PlatformDirs(appname=appname, appauthor=appauthor, version=version, opinion=opinion).user_runtime_path
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_runtime_path
 
 
 __all__ = 
@@ -328,6 +505,7 @@
     "user_runtime_dir",
     "site_data_dir",
     "site_config_dir",
+    "site_cache_dir",
     "user_data_path",
     "user_config_path",
     "user_cache_path",
@@ -337,4 +515,5 @@
     "user_runtime_path",
     "site_data_path",
     "site_config_path",
+    "site_cache_path",

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/__main__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/__main__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/android.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/android.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/api.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/api.py Changed

@@ -22,6 +22,7 @@
         roaming: bool = False,
         multipath: bool = False,
         opinion: bool = True,
+        ensure_exists: bool = False,
     ):
         """
         Create a new platform directory.
@@ -32,6 +33,7 @@
         :param roaming: See `roaming`.
         :param multipath: See `multipath`.
         :param opinion: See `opinion`.
+        :param ensure_exists: See `ensure_exists`.
         """
         self.appname = appname  #: The name of application.
         self.appauthor = appauthor
@@ -56,6 +58,11 @@
         returned. By default, the first item would only be returned.
         """
         self.opinion = opinion  #: A flag to indicating to use opinionated values.
+        self.ensure_exists = ensure_exists
+        """
+        Optionally create the directory (and any missing parents) upon access if it does not exist.
+        By default, no directories are created.
+        """
 
     def _append_app_name_and_version(self, *base: str) -> str:
         params = list(base1:)
@@ -63,7 +70,13 @@
             params.append(self.appname)
             if self.version:
                 params.append(self.version)
-        return os.path.join(base0, *params)
+        path = os.path.join(base0, *params)
+        self._optionally_create_directory(path)
+        return path
+
+    def _optionally_create_directory(self, path: str) -> None:
+        if self.ensure_exists:
+            Path(path).mkdir(parents=True, exist_ok=True)
 
     @property
     @abstractmethod
@@ -92,6 +105,11 @@
 
     @property
     @abstractmethod
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users"""
+
+    @property
+    @abstractmethod
     def user_state_dir(self) -> str:
         """:return: state directory tied to the user"""
 
@@ -136,6 +154,11 @@
         return Path(self.user_cache_dir)
 
     @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users"""
+        return Path(self.site_cache_dir)
+
+    @property
     def user_state_path(self) -> Path:
         """:return: state path tied to the user"""
         return Path(self.user_state_dir)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/macos.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/macos.py Changed

@@ -9,14 +9,15 @@
     """
     Platform directories for the macOS operating system. Follows the guidance from `Apple documentation
     <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_.
-    Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>` and
-    `version <platformdirs.api.PlatformDirsABC.version>`.
+    Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`,
+    `version <platformdirs.api.PlatformDirsABC.version>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     """
 
     @property
     def user_data_dir(self) -> str:
         """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``"""
-        return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support/"))
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support"))
 
     @property
     def site_data_dir(self) -> str:
@@ -25,13 +26,13 @@
 
     @property
     def user_config_dir(self) -> str:
-        """:return: config directory tied to the user, e.g. ``~/Library/Preferences/$appname/$version``"""
-        return self._append_app_name_and_version(os.path.expanduser("~/Library/Preferences/"))
+        """:return: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
 
     @property
     def site_config_dir(self) -> str:
-        """:return: config directory shared by the users, e.g. ``/Library/Preferences/$appname``"""
-        return self._append_app_name_and_version("/Library/Preferences")
+        """:return: config directory shared by the users, same as `site_data_dir`"""
+        return self.site_data_dir
 
     @property
     def user_cache_dir(self) -> str:
@@ -39,6 +40,11 @@
         return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches"))
 
     @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``"""
+        return self._append_app_name_and_version("/Library/Caches")
+
+    @property
     def user_state_dir(self) -> str:
         """:return: state directory tied to the user, same as `user_data_dir`"""
         return self.user_data_dir

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/unix.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/unix.py Changed

@@ -24,7 +24,8 @@
     `appname <platformdirs.api.PlatformDirsABC.appname>`,
     `version <platformdirs.api.PlatformDirsABC.version>`,
     `multipath <platformdirs.api.PlatformDirsABC.multipath>`,
-    `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    `opinion <platformdirs.api.PlatformDirsABC.opinion>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
     """
 
     @property
@@ -94,6 +95,13 @@
         return self._append_app_name_and_version(path)
 
     @property
+    def site_cache_dir(self) -> str:
+        """
+        :return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``
+        """
+        return self._append_app_name_and_version("/var/tmp")
+
+    @property
     def user_state_dir(self) -> str:
         """
         :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or
@@ -107,9 +115,9 @@
     @property
     def user_log_dir(self) -> str:
         """
-        :return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``log`` in it
+        :return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it
         """
-        path = self.user_cache_dir
+        path = self.user_state_dir
         if self.opinion:
             path = os.path.join(path, "log")
         return path
@@ -148,6 +156,11 @@
         """:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``"""
         return self._first_item_as_path_if_multipath(self.site_config_dir)
 
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+
     def _first_item_as_path_if_multipath(self, directory: str) -> Path:
         if self.multipath:
             # If multipath is True, the first path is returned.

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/version.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/version.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/platformdirs/windows.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/platformdirs/windows.py Changed

@@ -2,6 +2,7 @@
 
 import ctypes
 import os
+import sys
 from functools import lru_cache
 from typing import Callable
 
@@ -16,7 +17,9 @@
     `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`,
     `version <platformdirs.api.PlatformDirsABC.version>`,
     `roaming <platformdirs.api.PlatformDirsABC.roaming>`,
-    `opinion <platformdirs.api.PlatformDirsABC.opinion>`."""
+    `opinion <platformdirs.api.PlatformDirsABC.opinion>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    """
 
     @property
     def user_data_dir(self) -> str:
@@ -40,7 +43,9 @@
                 params.append(opinion_value)
             if self.version:
                 params.append(self.version)
-        return os.path.join(path, *params)
+        path = os.path.join(path, *params)
+        self._optionally_create_directory(path)
+        return path
 
     @property
     def site_data_dir(self) -> str:
@@ -68,6 +73,12 @@
         return self._append_parts(path, opinion_value="Cache")
 
     @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname\\Cache\\$version``"""
+        path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
+        return self._append_parts(path, opinion_value="Cache")
+
+    @property
     def user_state_dir(self) -> str:
         """:return: state directory tied to the user, same as `user_data_dir`"""
         return self.user_data_dir
@@ -80,6 +91,7 @@
         path = self.user_data_dir
         if self.opinion:
             path = os.path.join(path, "Logs")
+            self._optionally_create_directory(path)
         return path
 
     @property
@@ -132,7 +144,8 @@
     }.get(csidl_name)
     if shell_folder_name is None:
         raise ValueError(f"Unknown CSIDL name: {csidl_name}")
-
+    if sys.platform != "win32":  # only needed for mypy type checker to know that this code runs only on Windows
+        raise NotImplementedError
     import winreg
 
     key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/formatters/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/formatters/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/formatters/html.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/formatters/html.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/formatters/irc.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/formatters/irc.py Changed

@@ -128,38 +128,12 @@
         self._lineno = 0
 
     def _write_lineno(self, outfile):
-        self._lineno += 1
-        outfile.write("\n%04d: " % self._lineno)
-
-    def _format_unencoded_with_lineno(self, tokensource, outfile):
-        self._write_lineno(outfile)
-
-        for ttype, value in tokensource:
-            if value.endswith("\n"):
-                self._write_lineno(outfile)
-                value = value:-1
-            color = self.colorscheme.get(ttype)
-            while color is None:
-                ttype = ttype.parent
-                color = self.colorscheme.get(ttype)
-            if color:
-                color = colorself.darkbg
-                spl = value.split('\n')
-                for line in spl:-1:
-                    self._write_lineno(outfile)
-                    if line:
-                        outfile.write(ircformat(color, line:-1))
-                if spl-1:
-                    outfile.write(ircformat(color, spl-1))
-            else:
-                outfile.write(value)
-
-        outfile.write("\n")
+        if self.linenos:
+            self._lineno += 1
+            outfile.write("%04d: " % self._lineno)
 
     def format_unencoded(self, tokensource, outfile):
-        if self.linenos:
-            self._format_unencoded_with_lineno(tokensource, outfile)
-            return
+        self._write_lineno(outfile)
 
         for ttype, value in tokensource:
             color = self.colorscheme.get(ttype)
@@ -173,6 +147,7 @@
                     if line:
                         outfile.write(ircformat(color, line))
                     outfile.write('\n')
+                    self._write_lineno(outfile)
                 if spl-1:
                     outfile.write(ircformat(color, spl-1))
             else:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/lexer.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/lexer.py Changed

@@ -14,15 +14,16 @@
 
 from pip._vendor.pygments.filter import apply_filters, Filter
 from pip._vendor.pygments.filters import get_filter_by_name
-from pip._vendor.pygments.token import Error, Text, Other, _TokenType
+from pip._vendor.pygments.token import Error, Text, Other, Whitespace, _TokenType
 from pip._vendor.pygments.util import get_bool_opt, get_int_opt, get_list_opt, \
     make_analysator, Future, guess_decode
 from pip._vendor.pygments.regexopt import regex_opt
 
 __all__ = 'Lexer', 'RegexLexer', 'ExtendedRegexLexer', 'DelegatingLexer',
            'LexerContext', 'include', 'inherit', 'bygroups', 'using', 'this',
-           'default', 'words'
+           'default', 'words', 'line_re'
 
+line_re = re.compile('.*?\n')
 
 _encoding_map = (b'\xef\xbb\xbf', 'utf-8'),
                  (b'\xff\xfe\0\0', 'utf-32'),
@@ -670,7 +671,7 @@
                         # at EOL, reset state to "root"
                         statestack = 'root'
                         statetokens = tokendefs'root'
-                        yield pos, Text, '\n'
+                        yield pos, Whitespace, '\n'
                         pos += 1
                         continue
                     yield pos, Error, textpos

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/lexers/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/lexers/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/lexers/_mapping.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/lexers/_mapping.py Changed

@@ -30,6 +30,7 @@
     'AppleScriptLexer': ('pip._vendor.pygments.lexers.scripting', 'AppleScript', ('applescript',), ('*.applescript',), ()),
     'ArduinoLexer': ('pip._vendor.pygments.lexers.c_like', 'Arduino', ('arduino',), ('*.ino',), ('text/x-arduino',)),
     'ArrowLexer': ('pip._vendor.pygments.lexers.arrow', 'Arrow', ('arrow',), ('*.arw',), ()),
+    'ArturoLexer': ('pip._vendor.pygments.lexers.arturo', 'Arturo', ('arturo', 'art'), ('*.art',), ()),
     'AscLexer': ('pip._vendor.pygments.lexers.asc', 'ASCII armored', ('asc', 'pem'), ('*.asc', '*.pem', 'id_dsa', 'id_ecdsa', 'id_ecdsa_sk', 'id_ed25519', 'id_ed25519_sk', 'id_rsa'), ('application/pgp-keys', 'application/pgp-encrypted', 'application/pgp-signature')),
     'AspectJLexer': ('pip._vendor.pygments.lexers.jvm', 'AspectJ', ('aspectj',), ('*.aj',), ('text/x-aspectj',)),
     'AsymptoteLexer': ('pip._vendor.pygments.lexers.graphics', 'Asymptote', ('asymptote', 'asy'), ('*.asy',), ('text/x-asymptote',)),
@@ -152,13 +153,14 @@
     'EvoqueXmlLexer': ('pip._vendor.pygments.lexers.templates', 'XML+Evoque', ('xml+evoque',), ('*.xml',), ('application/xml+evoque',)),
     'ExeclineLexer': ('pip._vendor.pygments.lexers.shell', 'execline', ('execline',), ('*.exec',), ()),
     'EzhilLexer': ('pip._vendor.pygments.lexers.ezhil', 'Ezhil', ('ezhil',), ('*.n',), ('text/x-ezhil',)),
-    'FSharpLexer': ('pip._vendor.pygments.lexers.dotnet', 'F#', ('fsharp', 'f#'), ('*.fs', '*.fsi'), ('text/x-fsharp',)),
+    'FSharpLexer': ('pip._vendor.pygments.lexers.dotnet', 'F#', ('fsharp', 'f#'), ('*.fs', '*.fsi', '*.fsx'), ('text/x-fsharp',)),
     'FStarLexer': ('pip._vendor.pygments.lexers.ml', 'FStar', ('fstar',), ('*.fst', '*.fsti'), ('text/x-fstar',)),
     'FactorLexer': ('pip._vendor.pygments.lexers.factor', 'Factor', ('factor',), ('*.factor',), ('text/x-factor',)),
     'FancyLexer': ('pip._vendor.pygments.lexers.ruby', 'Fancy', ('fancy', 'fy'), ('*.fy', '*.fancypack'), ('text/x-fancysrc',)),
     'FantomLexer': ('pip._vendor.pygments.lexers.fantom', 'Fantom', ('fan',), ('*.fan',), ('application/x-fantom',)),
     'FelixLexer': ('pip._vendor.pygments.lexers.felix', 'Felix', ('felix', 'flx'), ('*.flx', '*.flxh'), ('text/x-felix',)),
     'FennelLexer': ('pip._vendor.pygments.lexers.lisp', 'Fennel', ('fennel', 'fnl'), ('*.fnl',), ()),
+    'FiftLexer': ('pip._vendor.pygments.lexers.fift', 'Fift', ('fift', 'fif'), ('*.fif',), ()),
     'FishShellLexer': ('pip._vendor.pygments.lexers.shell', 'Fish', ('fish', 'fishshell'), ('*.fish', '*.load'), ('application/x-fish',)),
     'FlatlineLexer': ('pip._vendor.pygments.lexers.dsls', 'Flatline', ('flatline',), (), ('text/x-flatline',)),
     'FloScriptLexer': ('pip._vendor.pygments.lexers.floscript', 'FloScript', ('floscript', 'flo'), ('*.flo',), ()),
@@ -167,7 +169,9 @@
     'FortranLexer': ('pip._vendor.pygments.lexers.fortran', 'Fortran', ('fortran', 'f90'), ('*.f03', '*.f90', '*.F03', '*.F90'), ('text/x-fortran',)),
     'FoxProLexer': ('pip._vendor.pygments.lexers.foxpro', 'FoxPro', ('foxpro', 'vfp', 'clipper', 'xbase'), ('*.PRG', '*.prg'), ()),
     'FreeFemLexer': ('pip._vendor.pygments.lexers.freefem', 'Freefem', ('freefem',), ('*.edp',), ('text/x-freefem',)),
+    'FuncLexer': ('pip._vendor.pygments.lexers.func', 'FunC', ('func', 'fc'), ('*.fc', '*.func'), ()),
     'FutharkLexer': ('pip._vendor.pygments.lexers.futhark', 'Futhark', ('futhark',), ('*.fut',), ('text/x-futhark',)),
+    'GAPConsoleLexer': ('pip._vendor.pygments.lexers.algebra', 'GAP session', ('gap-console', 'gap-repl'), ('*.tst',), ()),
     'GAPLexer': ('pip._vendor.pygments.lexers.algebra', 'GAP', ('gap',), ('*.g', '*.gd', '*.gi', '*.gap'), ()),
     'GDScriptLexer': ('pip._vendor.pygments.lexers.gdscript', 'GDScript', ('gdscript', 'gd'), ('*.gd',), ('text/x-gdscript', 'application/x-gdscript')),
     'GLShaderLexer': ('pip._vendor.pygments.lexers.graphics', 'GLSL', ('glsl',), ('*.vert', '*.frag', '*.geo'), ('text/x-glslsrc',)),
@@ -196,7 +200,7 @@
     'HaxeLexer': ('pip._vendor.pygments.lexers.haxe', 'Haxe', ('haxe', 'hxsl', 'hx'), ('*.hx', '*.hxsl'), ('text/haxe', 'text/x-haxe', 'text/x-hx')),
     'HexdumpLexer': ('pip._vendor.pygments.lexers.hexdump', 'Hexdump', ('hexdump',), (), ()),
     'HsailLexer': ('pip._vendor.pygments.lexers.asm', 'HSAIL', ('hsail', 'hsa'), ('*.hsail',), ('text/x-hsail',)),
-    'HspecLexer': ('pip._vendor.pygments.lexers.haskell', 'Hspec', ('hspec',), (), ()),
+    'HspecLexer': ('pip._vendor.pygments.lexers.haskell', 'Hspec', ('hspec',), ('*Spec.hs',), ()),
     'HtmlDjangoLexer': ('pip._vendor.pygments.lexers.templates', 'HTML+Django/Jinja', ('html+django', 'html+jinja', 'htmldjango'), ('*.html.j2', '*.htm.j2', '*.xhtml.j2', '*.html.jinja2', '*.htm.jinja2', '*.xhtml.jinja2'), ('text/html+django', 'text/html+jinja')),
     'HtmlGenshiLexer': ('pip._vendor.pygments.lexers.templates', 'HTML+Genshi', ('html+genshi', 'html+kid'), (), ('text/html+genshi',)),
     'HtmlLexer': ('pip._vendor.pygments.lexers.html', 'HTML', ('html',), ('*.html', '*.htm', '*.xhtml', '*.xslt'), ('text/html', 'application/xhtml+xml')),
@@ -236,6 +240,7 @@
     'JsonBareObjectLexer': ('pip._vendor.pygments.lexers.data', 'JSONBareObject', (), (), ()),
     'JsonLdLexer': ('pip._vendor.pygments.lexers.data', 'JSON-LD', ('jsonld', 'json-ld'), ('*.jsonld',), ('application/ld+json',)),
     'JsonLexer': ('pip._vendor.pygments.lexers.data', 'JSON', ('json', 'json-object'), ('*.json', 'Pipfile.lock'), ('application/json', 'application/json-object')),
+    'JsonnetLexer': ('pip._vendor.pygments.lexers.jsonnet', 'Jsonnet', ('jsonnet',), ('*.jsonnet', '*.libsonnet'), ()),
     'JspLexer': ('pip._vendor.pygments.lexers.templates', 'Java Server Page', ('jsp',), ('*.jsp',), ('application/x-jsp',)),
     'JuliaConsoleLexer': ('pip._vendor.pygments.lexers.julia', 'Julia console', ('jlcon', 'julia-repl'), (), ()),
     'JuliaLexer': ('pip._vendor.pygments.lexers.julia', 'Julia', ('julia', 'jl'), ('*.jl',), ('text/x-julia', 'application/x-julia')),
@@ -270,8 +275,10 @@
     'LogosLexer': ('pip._vendor.pygments.lexers.objective', 'Logos', ('logos',), ('*.x', '*.xi', '*.xm', '*.xmi'), ('text/x-logos',)),
     'LogtalkLexer': ('pip._vendor.pygments.lexers.prolog', 'Logtalk', ('logtalk',), ('*.lgt', '*.logtalk'), ('text/x-logtalk',)),
     'LuaLexer': ('pip._vendor.pygments.lexers.scripting', 'Lua', ('lua',), ('*.lua', '*.wlua'), ('text/x-lua', 'application/x-lua')),
-    'MCFunctionLexer': ('pip._vendor.pygments.lexers.mcfunction', 'MCFunction', ('mcfunction', 'mcf'), ('*.mcfunction',), ('text/mcfunction',)),
+    'MCFunctionLexer': ('pip._vendor.pygments.lexers.minecraft', 'MCFunction', ('mcfunction', 'mcf'), ('*.mcfunction',), ('text/mcfunction',)),
+    'MCSchemaLexer': ('pip._vendor.pygments.lexers.minecraft', 'MCSchema', ('mcschema',), ('*.mcschema',), ('text/mcschema',)),
     'MIMELexer': ('pip._vendor.pygments.lexers.mime', 'MIME', ('mime',), (), ('multipart/mixed', 'multipart/related', 'multipart/alternative')),
+    'MIPSLexer': ('pip._vendor.pygments.lexers.mips', 'MIPS', ('mips',), ('*.mips', '*.MIPS'), ()),
     'MOOCodeLexer': ('pip._vendor.pygments.lexers.scripting', 'MOOCode', ('moocode', 'moo'), ('*.moo',), ('text/x-moocode',)),
     'MSDOSSessionLexer': ('pip._vendor.pygments.lexers.shell', 'MSDOS Session', ('doscon',), (), ()),
     'Macaulay2Lexer': ('pip._vendor.pygments.lexers.macaulay2', 'Macaulay2', ('macaulay2',), ('*.m2',), ()),
@@ -316,7 +323,7 @@
     'MyghtyXmlLexer': ('pip._vendor.pygments.lexers.templates', 'XML+Myghty', ('xml+myghty',), (), ('application/xml+myghty',)),
     'NCLLexer': ('pip._vendor.pygments.lexers.ncl', 'NCL', ('ncl',), ('*.ncl',), ('text/ncl',)),
     'NSISLexer': ('pip._vendor.pygments.lexers.installers', 'NSIS', ('nsis', 'nsi', 'nsh'), ('*.nsi', '*.nsh'), ('text/x-nsis',)),
-    'NasmLexer': ('pip._vendor.pygments.lexers.asm', 'NASM', ('nasm',), ('*.asm', '*.ASM'), ('text/x-nasm',)),
+    'NasmLexer': ('pip._vendor.pygments.lexers.asm', 'NASM', ('nasm',), ('*.asm', '*.ASM', '*.nasm'), ('text/x-nasm',)),
     'NasmObjdumpLexer': ('pip._vendor.pygments.lexers.asm', 'objdump-nasm', ('objdump-nasm',), ('*.objdump-intel',), ('text/x-nasm-objdump',)),
     'NemerleLexer': ('pip._vendor.pygments.lexers.dotnet', 'Nemerle', ('nemerle',), ('*.n',), ('text/x-nemerle',)),
     'NesCLexer': ('pip._vendor.pygments.lexers.c_like', 'nesC', ('nesc',), ('*.nc',), ('text/x-nescsrc',)),
@@ -350,6 +357,7 @@
     'PegLexer': ('pip._vendor.pygments.lexers.grammar_notation', 'PEG', ('peg',), ('*.peg',), ('text/x-peg',)),
     'Perl6Lexer': ('pip._vendor.pygments.lexers.perl', 'Perl6', ('perl6', 'pl6', 'raku'), ('*.pl', '*.pm', '*.nqp', '*.p6', '*.6pl', '*.p6l', '*.pl6', '*.6pm', '*.p6m', '*.pm6', '*.t', '*.raku', '*.rakumod', '*.rakutest', '*.rakudoc'), ('text/x-perl6', 'application/x-perl6')),
     'PerlLexer': ('pip._vendor.pygments.lexers.perl', 'Perl', ('perl', 'pl'), ('*.pl', '*.pm', '*.t', '*.perl'), ('text/x-perl', 'application/x-perl')),
+    'PhixLexer': ('pip._vendor.pygments.lexers.phix', 'Phix', ('phix',), ('*.exw',), ('text/x-phix',)),
     'PhpLexer': ('pip._vendor.pygments.lexers.php', 'PHP', ('php', 'php3', 'php4', 'php5'), ('*.php', '*.php345', '*.inc'), ('text/x-php',)),
     'PigLexer': ('pip._vendor.pygments.lexers.jvm', 'Pig', ('pig',), ('*.pig',), ('text/x-pig',)),
     'PikeLexer': ('pip._vendor.pygments.lexers.c_like', 'Pike', ('pike',), ('*.pike', '*.pmod'), ('text/x-pike',)),
@@ -357,6 +365,7 @@
     'PlPgsqlLexer': ('pip._vendor.pygments.lexers.sql', 'PL/pgSQL', ('plpgsql',), (), ('text/x-plpgsql',)),
     'PointlessLexer': ('pip._vendor.pygments.lexers.pointless', 'Pointless', ('pointless',), ('*.ptls',), ()),
     'PonyLexer': ('pip._vendor.pygments.lexers.pony', 'Pony', ('pony',), ('*.pony',), ()),
+    'PortugolLexer': ('pip._vendor.pygments.lexers.pascal', 'Portugol', ('portugol',), ('*.alg', '*.portugol'), ()),
     'PostScriptLexer': ('pip._vendor.pygments.lexers.graphics', 'PostScript', ('postscript', 'postscr'), ('*.ps', '*.eps'), ('application/postscript',)),
     'PostgresConsoleLexer': ('pip._vendor.pygments.lexers.sql', 'PostgreSQL console (psql)', ('psql', 'postgresql-console', 'postgres-console'), (), ('text/x-postgresql-psql',)),
     'PostgresLexer': ('pip._vendor.pygments.lexers.sql', 'PostgreSQL SQL dialect', ('postgresql', 'postgres'), (), ('text/x-postgresql',)),
@@ -376,7 +385,7 @@
     'Python2Lexer': ('pip._vendor.pygments.lexers.python', 'Python 2.x', ('python2', 'py2'), (), ('text/x-python2', 'application/x-python2')),
     'Python2TracebackLexer': ('pip._vendor.pygments.lexers.python', 'Python 2.x Traceback', ('py2tb',), ('*.py2tb',), ('text/x-python2-traceback',)),
     'PythonConsoleLexer': ('pip._vendor.pygments.lexers.python', 'Python console session', ('pycon',), (), ('text/x-python-doctest',)),
-    'PythonLexer': ('pip._vendor.pygments.lexers.python', 'Python', ('python', 'py', 'sage', 'python3', 'py3'), ('*.py', '*.pyw', '*.jy', '*.sage', '*.sc', 'SConstruct', 'SConscript', '*.bzl', 'BUCK', 'BUILD', 'BUILD.bazel', 'WORKSPACE', '*.tac'), ('text/x-python', 'application/x-python', 'text/x-python3', 'application/x-python3')),
+    'PythonLexer': ('pip._vendor.pygments.lexers.python', 'Python', ('python', 'py', 'sage', 'python3', 'py3'), ('*.py', '*.pyw', '*.pyi', '*.jy', '*.sage', '*.sc', 'SConstruct', 'SConscript', '*.bzl', 'BUCK', 'BUILD', 'BUILD.bazel', 'WORKSPACE', '*.tac'), ('text/x-python', 'application/x-python', 'text/x-python3', 'application/x-python3')),
     'PythonTracebackLexer': ('pip._vendor.pygments.lexers.python', 'Python Traceback', ('pytb', 'py3tb'), ('*.pytb', '*.py3tb'), ('text/x-python-traceback', 'text/x-python3-traceback')),
     'PythonUL4Lexer': ('pip._vendor.pygments.lexers.ul4', 'Python+UL4', ('py+ul4',), ('*.pyul4',), ()),
     'QBasicLexer': ('pip._vendor.pygments.lexers.basic', 'QBasic', ('qbasic', 'basic'), ('*.BAS', '*.bas'), ('text/basic',)),
@@ -421,7 +430,7 @@
     'SASLexer': ('pip._vendor.pygments.lexers.sas', 'SAS', ('sas',), ('*.SAS', '*.sas'), ('text/x-sas', 'text/sas', 'application/x-sas')),
     'SLexer': ('pip._vendor.pygments.lexers.r', 'S', ('splus', 's', 'r'), ('*.S', '*.R', '.Rhistory', '.Rprofile', '.Renviron'), ('text/S-plus', 'text/S', 'text/x-r-source', 'text/x-r', 'text/x-R', 'text/x-r-history', 'text/x-r-profile')),
     'SMLLexer': ('pip._vendor.pygments.lexers.ml', 'Standard ML', ('sml',), ('*.sml', '*.sig', '*.fun'), ('text/x-standardml', 'application/x-standardml')),
-    'SNBTLexer': ('pip._vendor.pygments.lexers.mcfunction', 'SNBT', ('snbt',), ('*.snbt',), ('text/snbt',)),
+    'SNBTLexer': ('pip._vendor.pygments.lexers.minecraft', 'SNBT', ('snbt',), ('*.snbt',), ('text/snbt',)),
     'SarlLexer': ('pip._vendor.pygments.lexers.jvm', 'SARL', ('sarl',), ('*.sarl',), ('text/x-sarl',)),
     'SassLexer': ('pip._vendor.pygments.lexers.css', 'Sass', ('sass',), ('*.sass',), ('text/x-sass',)),
     'SaviLexer': ('pip._vendor.pygments.lexers.savi', 'Savi', ('savi',), ('*.savi',), ()),
@@ -485,6 +494,7 @@
     'ThingsDBLexer': ('pip._vendor.pygments.lexers.thingsdb', 'ThingsDB', ('ti', 'thingsdb'), ('*.ti',), ()),
     'ThriftLexer': ('pip._vendor.pygments.lexers.dsls', 'Thrift', ('thrift',), ('*.thrift',), ('application/x-thrift',)),
     'TiddlyWiki5Lexer': ('pip._vendor.pygments.lexers.markup', 'tiddler', ('tid',), ('*.tid',), ('text/vnd.tiddlywiki',)),
+    'TlbLexer': ('pip._vendor.pygments.lexers.tlb', 'Tl-b', ('tlb',), ('*.tlb',), ()),
     'TodotxtLexer': ('pip._vendor.pygments.lexers.textfmts', 'Todotxt', ('todotxt',), ('todo.txt', '*.todotxt'), ('text/x-todo',)),
     'TransactSqlLexer': ('pip._vendor.pygments.lexers.sql', 'Transact-SQL', ('tsql', 't-sql'), ('*.sql',), ('text/x-tsql',)),
     'TreetopLexer': ('pip._vendor.pygments.lexers.parsers', 'Treetop', ('treetop',), ('*.treetop', '*.tt'), ()),
@@ -519,6 +529,8 @@
     'WatLexer': ('pip._vendor.pygments.lexers.webassembly', 'WebAssembly', ('wast', 'wat'), ('*.wat', '*.wast'), ()),
     'WebIDLLexer': ('pip._vendor.pygments.lexers.webidl', 'Web IDL', ('webidl',), ('*.webidl',), ()),
     'WhileyLexer': ('pip._vendor.pygments.lexers.whiley', 'Whiley', ('whiley',), ('*.whiley',), ('text/x-whiley',)),
+    'WoWTocLexer': ('pip._vendor.pygments.lexers.wowtoc', 'World of Warcraft TOC', ('wowtoc',), ('*.toc',), ()),
+    'WrenLexer': ('pip._vendor.pygments.lexers.wren', 'Wren', ('wren',), ('*.wren',), ()),
     'X10Lexer': ('pip._vendor.pygments.lexers.x10', 'X10', ('x10', 'xten'), ('*.x10',), ('text/x-x10',)),
     'XMLUL4Lexer': ('pip._vendor.pygments.lexers.ul4', 'XML+UL4', ('xml+ul4',), ('*.xmlul4',), ()),
     'XQueryLexer': ('pip._vendor.pygments.lexers.webmisc', 'XQuery', ('xquery', 'xqy', 'xq', 'xql', 'xqm'), ('*.xqy', '*.xquery', '*.xq', '*.xql', '*.xqm'), ('text/xquery', 'application/xquery')),

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/lexers/python.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/lexers/python.py Changed

@@ -12,18 +12,16 @@
 import keyword
 
 from pip._vendor.pygments.lexer import Lexer, RegexLexer, include, bygroups, using, \
-    default, words, combined, do_insertions, this
+    default, words, combined, do_insertions, this, line_re
 from pip._vendor.pygments.util import get_bool_opt, shebang_matches
 from pip._vendor.pygments.token import Text, Comment, Operator, Keyword, Name, String, \
-    Number, Punctuation, Generic, Other, Error
+    Number, Punctuation, Generic, Other, Error, Whitespace
 from pip._vendor.pygments import unistring as uni
 
 __all__ = 'PythonLexer', 'PythonConsoleLexer', 'PythonTracebackLexer',
            'Python2Lexer', 'Python2TracebackLexer',
            'CythonLexer', 'DgLexer', 'NumPyLexer'
 
-line_re = re.compile('.*?\n')
-
 
 class PythonLexer(RegexLexer):
     """
@@ -42,6 +40,8 @@
     filenames = 
         '*.py',
         '*.pyw',
+        # Type stubs
+        '*.pyi',
         # Jython
         '*.jy',
         # Sage
@@ -100,11 +100,11 @@
 
     tokens = {
         'root': 
-            (r'\n', Text),
+            (r'\n', Whitespace),
             (r'^(\s*)(rRuUbB{,2})("""(?:.|\n)*?""")',
-             bygroups(Text, String.Affix, String.Doc)),
+             bygroups(Whitespace, String.Affix, String.Doc)),
             (r"^(\s*)(rRuUbB{,2})('''(?:.|\n)*?''')",
-             bygroups(Text, String.Affix, String.Doc)),
+             bygroups(Whitespace, String.Affix, String.Doc)),
             (r'\A#!.+$', Comment.Hashbang),
             (r'#.*$', Comment.Single),
             (r'\\\n', Text),
@@ -169,7 +169,7 @@
              combined('bytesescape', 'dqs')),
             ("(bB)(')", bygroups(String.Affix, String.Single),
              combined('bytesescape', 'sqs')),
-            
+
             (r'^\S\n+', Text),
             include('numbers'),
             (r'!=|==|<<|>>|:=|-~+/*%=<>&^|.', Operator),
@@ -192,13 +192,13 @@
             (r'(=\s*)?'         # debug (https://bugs.python.org/issue36817)
              r'(\!sraf)?'     # conversion
              r':', String.Interpol, '#pop'),
-            (r'\s+', Text),  # allow new lines
+            (r'\s+', Whitespace),  # allow new lines
             include('expr'),
         ,
         'expr-inside-fstring-inner': 
             (r'{(', Punctuation, 'expr-inside-fstring-inner'),
             (r')}', Punctuation, '#pop'),
-            (r'\s+', Text),  # allow new lines
+            (r'\s+', Whitespace),  # allow new lines
             include('expr'),
         ,
         'expr-keywords': 
@@ -229,7 +229,7 @@
         ,
         'soft-keywords-inner': 
             # optional `_` keyword
-            (r'(\s+)(^\n_*)(_\b)', bygroups(Text, using(this), Keyword)),
+            (r'(\s+)(^\n_*)(_\b)', bygroups(Whitespace, using(this), Keyword)),
             default('#pop')
         ,
         'builtins': 
@@ -445,11 +445,11 @@
 
     tokens = {
         'root': 
-            (r'\n', Text),
+            (r'\n', Whitespace),
             (r'^(\s*)(rRuUbB{,2})("""(?:.|\n)*?""")',
-             bygroups(Text, String.Affix, String.Doc)),
+             bygroups(Whitespace, String.Affix, String.Doc)),
             (r"^(\s*)(rRuUbB{,2})('''(?:.|\n)*?''')",
-             bygroups(Text, String.Affix, String.Doc)),
+             bygroups(Whitespace, String.Affix, String.Doc)),
             (r'^\S\n+', Text),
             (r'\A#!.+$', Comment.Hashbang),
             (r'#.*$', Comment.Single),
@@ -742,7 +742,7 @@
 
     tokens = {
         'root': 
-            (r'\n', Text),
+            (r'\n', Whitespace),
             (r'^Traceback $most recent call last$:\n', Generic.Traceback, 'intb'),
             (r'^During handling of the above exception, another '
              r'exception occurred:\n\n', Generic.Traceback),
@@ -753,24 +753,24 @@
         ,
         'intb': 
             (r'^(  File )("^"+")(, line )(\d+)(, in )(.+)(\n)',
-             bygroups(Text, Name.Builtin, Text, Number, Text, Name, Text)),
+             bygroups(Text, Name.Builtin, Text, Number, Text, Name, Whitespace)),
             (r'^(  File )("^"+")(, line )(\d+)(\n)',
-             bygroups(Text, Name.Builtin, Text, Number, Text)),
+             bygroups(Text, Name.Builtin, Text, Number, Whitespace)),
             (r'^(    )(.+)(\n)',
-             bygroups(Text, using(PythonLexer), Text), 'markers'),
+             bygroups(Whitespace, using(PythonLexer), Whitespace), 'markers'),
             (r'^( \t*)(\.\.\.)(\n)',
-             bygroups(Text, Comment, Text)),  # for doctests...
+             bygroups(Whitespace, Comment, Whitespace)),  # for doctests...
             (r'^(^:+)(: )(.+)(\n)',
-             bygroups(Generic.Error, Text, Name, Text), '#pop'),
+             bygroups(Generic.Error, Text, Name, Whitespace), '#pop'),
             (r'^(a-zA-Z_\w.*)(:?\n)',
-             bygroups(Generic.Error, Text), '#pop')
+             bygroups(Generic.Error, Whitespace), '#pop')
         ,
         'markers': 
             # Either `PEP 657 <https://www.python.org/dev/peps/pep-0657/>`
             # error locations in Python 3.11+, or single-caret markers
             # for syntax errors before that.
             (r'^( {4,})(~^+)(\n)',
-             bygroups(Text, Punctuation.Marker, Text),
+             bygroups(Whitespace, Punctuation.Marker, Whitespace),
              '#pop'),
             default('#pop'),
         ,
@@ -808,17 +808,17 @@
         ,
         'intb': 
             (r'^(  File )("^"+")(, line )(\d+)(, in )(.+)(\n)',
-             bygroups(Text, Name.Builtin, Text, Number, Text, Name, Text)),
+             bygroups(Text, Name.Builtin, Text, Number, Text, Name, Whitespace)),
             (r'^(  File )("^"+")(, line )(\d+)(\n)',
-             bygroups(Text, Name.Builtin, Text, Number, Text)),
+             bygroups(Text, Name.Builtin, Text, Number, Whitespace)),
             (r'^(    )(.+)(\n)',
-             bygroups(Text, using(Python2Lexer), Text), 'marker'),
+             bygroups(Text, using(Python2Lexer), Whitespace), 'marker'),
             (r'^( \t*)(\.\.\.)(\n)',
-             bygroups(Text, Comment, Text)),  # for doctests...
+             bygroups(Text, Comment, Whitespace)),  # for doctests...
             (r'^(^:+)(: )(.+)(\n)',
-             bygroups(Generic.Error, Text, Name, Text), '#pop'),
+             bygroups(Generic.Error, Text, Name, Whitespace), '#pop'),
             (r'^(a-zA-Z_\w*)(:?\n)',
-             bygroups(Generic.Error, Text), '#pop')
+             bygroups(Generic.Error, Whitespace), '#pop')
         ,
         'marker': 
             # For syntax errors.
@@ -843,13 +843,13 @@
 
     tokens = {
         'root': 
-            (r'\n', Text),
-            (r'^(\s*)("""(?:.|\n)*?""")', bygroups(Text, String.Doc)),
-            (r"^(\s*)('''(?:.|\n)*?''')", bygroups(Text, String.Doc)),
+            (r'\n', Whitespace),
+            (r'^(\s*)("""(?:.|\n)*?""")', bygroups(Whitespace, String.Doc)),
+            (r"^(\s*)('''(?:.|\n)*?''')", bygroups(Whitespace, String.Doc)),
             (r'^\S\n+', Text),
             (r'#.*$', Comment),
             (r'{}:(),;', Punctuation),
-            (r'\\\n', Text),
+            (r'\\\n', Whitespace),
             (r'\\', Text),
             (r'(in|is|and|or|not)\b', Operator.Word),
             (r'(<)(a-zA-Z0-9.?+)(>)',

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/pygments/sphinxext.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pygments/sphinxext.py Changed

@@ -74,6 +74,8 @@
             out = self.document_formatters()
         elif self.arguments0 == 'filters':
             out = self.document_filters()
+        elif self.arguments0 == 'lexers_overview':
+            out = self.document_lexers_overview()
         else:
             raise Exception('invalid argument for "pygmentsdoc" directive')
         node = nodes.compound()
@@ -83,6 +85,66 @@
             self.state.document.settings.record_dependencies.add(fn)
         return node.children
 
+    def document_lexers_overview(self):
+        """Generate a tabular overview of all lexers.
+
+        The columns are the lexer name, the extensions handled by this lexer
+        (or "None"), the aliases and a link to the lexer class."""
+        from pip._vendor.pygments.lexers._mapping import LEXERS
+        from pip._vendor.pygments.lexers import find_lexer_class
+        out = 
+
+        table = 
+
+        def format_link(name, url):
+            if url:
+                return f'`{name} <{url}>`_'
+            return name
+
+        for classname, data in sorted(LEXERS.items(), key=lambda x: x11.lower()):
+            lexer_cls = find_lexer_class(data1)
+            extensions = lexer_cls.filenames + lexer_cls.alias_filenames
+
+            table.append({
+                'name': format_link(data1, lexer_cls.url),
+                'extensions': ', '.join(extensions).replace('*', '\\*').replace('_', '\\') or 'None',
+                'aliases': ', '.join(data2),
+                'class': f'{data0}.{classname}'
+            })
+
+        column_names = 'name', 'extensions', 'aliases', 'class'
+        column_lengths = max(len(rowcolumn) for row in table if rowcolumn)
+                          for column in column_names
+
+        def write_row(*columns):
+            """Format a table row"""
+            out = 
+            for l, c in zip(column_lengths, columns):
+                if c:
+                    out.append(c.ljust(l))
+                else:
+                    out.append(' '*l)
+
+            return ' '.join(out)
+
+        def write_seperator():
+            """Write a table separator row"""
+            sep = '='*c for c in column_lengths
+            return write_row(*sep)
+
+        out.append(write_seperator())
+        out.append(write_row('Name', 'Extension(s)', 'Short name(s)', 'Lexer class'))
+        out.append(write_seperator())
+        for row in table:
+            out.append(write_row(
+                row'name',
+                row'extensions',
+                row'aliases',
+                f':class:`~{row"class"}`'))
+        out.append(write_seperator())
+
+        return '\n'.join(out)
+
     def document_lexers(self):
         from pip._vendor.pygments.lexers._mapping import LEXERS
         out =

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks.pyi Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/LICENSE Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/_compat.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/_impl.py Added

@@ -0,0 +1,330 @@
+import json
+import os
+import sys
+import tempfile
+from contextlib import contextmanager
+from os.path import abspath
+from os.path import join as pjoin
+from subprocess import STDOUT, check_call, check_output
+
+from ._in_process import _in_proc_script_path
+
+
+def write_json(obj, path, **kwargs):
+    with open(path, 'w', encoding='utf-8') as f:
+        json.dump(obj, f, **kwargs)
+
+
+def read_json(path):
+    with open(path, encoding='utf-8') as f:
+        return json.load(f)
+
+
+class BackendUnavailable(Exception):
+    """Will be raised if the backend cannot be imported in the hook process."""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+class BackendInvalid(Exception):
+    """Will be raised if the backend is invalid."""
+    def __init__(self, backend_name, backend_path, message):
+        super().__init__(message)
+        self.backend_name = backend_name
+        self.backend_path = backend_path
+
+
+class HookMissing(Exception):
+    """Will be raised on missing hooks (if a fallback can't be used)."""
+    def __init__(self, hook_name):
+        super().__init__(hook_name)
+        self.hook_name = hook_name
+
+
+class UnsupportedOperation(Exception):
+    """May be raised by build_sdist if the backend indicates that it can't."""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+def default_subprocess_runner(cmd, cwd=None, extra_environ=None):
+    """The default method of calling the wrapper subprocess.
+
+    This uses :func:`subprocess.check_call` under the hood.
+    """
+    env = os.environ.copy()
+    if extra_environ:
+        env.update(extra_environ)
+
+    check_call(cmd, cwd=cwd, env=env)
+
+
+def quiet_subprocess_runner(cmd, cwd=None, extra_environ=None):
+    """Call the subprocess while suppressing output.
+
+    This uses :func:`subprocess.check_output` under the hood.
+    """
+    env = os.environ.copy()
+    if extra_environ:
+        env.update(extra_environ)
+
+    check_output(cmd, cwd=cwd, env=env, stderr=STDOUT)
+
+
+def norm_and_check(source_tree, requested):
+    """Normalise and check a backend path.
+
+    Ensure that the requested backend path is specified as a relative path,
+    and resolves to a location under the given source tree.
+
+    Return an absolute version of the requested path.
+    """
+    if os.path.isabs(requested):
+        raise ValueError("paths must be relative")
+
+    abs_source = os.path.abspath(source_tree)
+    abs_requested = os.path.normpath(os.path.join(abs_source, requested))
+    # We have to use commonprefix for Python 2.7 compatibility. So we
+    # normalise case to avoid problems because commonprefix is a character
+    # based comparison :-(
+    norm_source = os.path.normcase(abs_source)
+    norm_requested = os.path.normcase(abs_requested)
+    if os.path.commonprefix(norm_source, norm_requested) != norm_source:
+        raise ValueError("paths must be inside source tree")
+
+    return abs_requested
+
+
+class BuildBackendHookCaller:
+    """A wrapper to call the build backend hooks for a source directory.
+    """
+
+    def __init__(
+            self,
+            source_dir,
+            build_backend,
+            backend_path=None,
+            runner=None,
+            python_executable=None,
+    ):
+        """
+        :param source_dir: The source directory to invoke the build backend for
+        :param build_backend: The build backend spec
+        :param backend_path: Additional path entries for the build backend spec
+        :param runner: The :ref:`subprocess runner <Subprocess Runners>` to use
+        :param python_executable:
+            The Python executable used to invoke the build backend
+        """
+        if runner is None:
+            runner = default_subprocess_runner
+
+        self.source_dir = abspath(source_dir)
+        self.build_backend = build_backend
+        if backend_path:
+            backend_path = 
+                norm_and_check(self.source_dir, p) for p in backend_path
+            
+        self.backend_path = backend_path
+        self._subprocess_runner = runner
+        if not python_executable:
+            python_executable = sys.executable
+        self.python_executable = python_executable
+
+    @contextmanager
+    def subprocess_runner(self, runner):
+        """A context manager for temporarily overriding the default
+        :ref:`subprocess runner <Subprocess Runners>`.
+
+        .. code-block:: python
+
+            hook_caller = BuildBackendHookCaller(...)
+            with hook_caller.subprocess_runner(quiet_subprocess_runner):
+                ...
+        """
+        prev = self._subprocess_runner
+        self._subprocess_runner = runner
+        try:
+            yield
+        finally:
+            self._subprocess_runner = prev
+
+    def _supported_features(self):
+        """Return the list of optional features supported by the backend."""
+        return self._call_hook('_supported_features', {})
+
+    def get_requires_for_build_wheel(self, config_settings=None):
+        """Get additional dependencies required for building a wheel.
+
+        :returns: A list of :pep:`dependency specifiers <508>`.
+        :rtype: liststr
+
+        .. admonition:: Fallback
+
+            If the build backend does not defined a hook with this name, an
+            empty list will be returned.
+        """
+        return self._call_hook('get_requires_for_build_wheel', {
+            'config_settings': config_settings
+        })
+
+    def prepare_metadata_for_build_wheel(
+            self, metadata_directory, config_settings=None,
+            _allow_fallback=True):
+        """Prepare a ``*.dist-info`` folder with metadata for this project.
+
+        :returns: Name of the newly created subfolder within
+                  ``metadata_directory``, containing the metadata.
+        :rtype: str
+
+        .. admonition:: Fallback
+
+            If the build backend does not define a hook with this name and
+            ``_allow_fallback`` is truthy, the backend will be asked to build a
+            wheel via the ``build_wheel`` hook and the dist-info extracted from
+            that will be returned.
+        """
+        return self._call_hook('prepare_metadata_for_build_wheel', {
+            'metadata_directory': abspath(metadata_directory),
+            'config_settings': config_settings,
+            '_allow_fallback': _allow_fallback,
+        })
+
+    def build_wheel(
+            self, wheel_directory, config_settings=None,
+            metadata_directory=None):
+        """Build a wheel from this project.
+
+        :returns:
+            The name of the newly created wheel within ``wheel_directory``.
+
+        .. admonition:: Interaction with fallback
+
+            If the ``build_wheel`` hook was called in the fallback for
+            :meth:`prepare_metadata_for_build_wheel`, the build backend would
+            not be invoked. Instead, the previously built wheel will be copied
+            to ``wheel_directory`` and the name of that file will be returned.
+        """
+        if metadata_directory is not None:
+            metadata_directory = abspath(metadata_directory)
+        return self._call_hook('build_wheel', {
+            'wheel_directory': abspath(wheel_directory),
+            'config_settings': config_settings,
+            'metadata_directory': metadata_directory,
+        })
+
+    def get_requires_for_build_editable(self, config_settings=None):
+        """Get additional dependencies required for building an editable wheel.
+
+        :returns: A list of :pep:`dependency specifiers <508>`.
+        :rtype: liststr
+
+        .. admonition:: Fallback
+
+            If the build backend does not defined a hook with this name, an
+            empty list will be returned.
+        """
+        return self._call_hook('get_requires_for_build_editable', {
+            'config_settings': config_settings
+        })
+
+    def prepare_metadata_for_build_editable(
+            self, metadata_directory, config_settings=None,
+            _allow_fallback=True):
+        """Prepare a ``*.dist-info`` folder with metadata for this project.
+
+        :returns: Name of the newly created subfolder within
+                  ``metadata_directory``, containing the metadata.
+        :rtype: str
+
+        .. admonition:: Fallback
+
+            If the build backend does not define a hook with this name and
+            ``_allow_fallback`` is truthy, the backend will be asked to build a
+            wheel via the ``build_editable`` hook and the dist-info
+            extracted from that will be returned.
+        """
+        return self._call_hook('prepare_metadata_for_build_editable', {
+            'metadata_directory': abspath(metadata_directory),
+            'config_settings': config_settings,
+            '_allow_fallback': _allow_fallback,
+        })
+
+    def build_editable(
+            self, wheel_directory, config_settings=None,
+            metadata_directory=None):
+        """Build an editable wheel from this project.
+
+        :returns:
+            The name of the newly created wheel within ``wheel_directory``.
+
+        .. admonition:: Interaction with fallback
+
+            If the ``build_editable`` hook was called in the fallback for
+            :meth:`prepare_metadata_for_build_editable`, the build backend
+            would not be invoked. Instead, the previously built wheel will be
+            copied to ``wheel_directory`` and the name of that file will be
+            returned.
+        """
+        if metadata_directory is not None:
+            metadata_directory = abspath(metadata_directory)
+        return self._call_hook('build_editable', {
+            'wheel_directory': abspath(wheel_directory),
+            'config_settings': config_settings,
+            'metadata_directory': metadata_directory,
+        })
+
+    def get_requires_for_build_sdist(self, config_settings=None):
+        """Get additional dependencies required for building an sdist.
+
+        :returns: A list of :pep:`dependency specifiers <508>`.
+        :rtype: liststr
+        """
+        return self._call_hook('get_requires_for_build_sdist', {
+            'config_settings': config_settings
+        })
+
+    def build_sdist(self, sdist_directory, config_settings=None):
+        """Build an sdist from this project.
+
+        :returns:
+            The name of the newly created sdist within ``wheel_directory``.
+        """
+        return self._call_hook('build_sdist', {
+            'sdist_directory': abspath(sdist_directory),
+            'config_settings': config_settings,
+        })
+
+    def _call_hook(self, hook_name, kwargs):
+        extra_environ = {'PEP517_BUILD_BACKEND': self.build_backend}
+
+        if self.backend_path:
+            backend_path = os.pathsep.join(self.backend_path)
+            extra_environ'PEP517_BACKEND_PATH' = backend_path
+
+        with tempfile.TemporaryDirectory() as td:
+            hook_input = {'kwargs': kwargs}
+            write_json(hook_input, pjoin(td, 'input.json'), indent=2)
+
+            # Run the hook in a subprocess
+            with _in_proc_script_path() as script:
+                python = self.python_executable
+                self._subprocess_runner(
+                    python, abspath(str(script)), hook_name, td,
+                    cwd=self.source_dir,
+                    extra_environ=extra_environ
+                )
+
+            data = read_json(pjoin(td, 'output.json'))
+            if data.get('unsupported'):
+                raise UnsupportedOperation(data.get('traceback', ''))
+            if data.get('no_backend'):
+                raise BackendUnavailable(data.get('traceback', ''))
+            if data.get('backend_invalid'):
+                raise BackendInvalid(
+                    backend_name=self.build_backend,
+                    backend_path=self.backend_path,
+                    message=data.get('backend_error', '')
+                )
+            if data.get('hook_missing'):
+                raise HookMissing(data.get('missing_hook_name') or hook_name)
+            return data'return_val'

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/_in_process Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/_in_process/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/pyproject_hooks/_in_process/_in_process.py Added

@@ -0,0 +1,353 @@
+"""This is invoked in a subprocess to call the build backend hooks.
+
+It expects:
+- Command line args: hook_name, control_dir
+- Environment variables:
+      PEP517_BUILD_BACKEND=entry.point:spec
+      PEP517_BACKEND_PATH=paths (separated with os.pathsep)
+- control_dir/input.json:
+  - {"kwargs": {...}}
+
+Results:
+- control_dir/output.json
+  - {"return_val": ...}
+"""
+import json
+import os
+import os.path
+import re
+import shutil
+import sys
+import traceback
+from glob import glob
+from importlib import import_module
+from os.path import join as pjoin
+
+# This file is run as a script, and `import wrappers` is not zip-safe, so we
+# include write_json() and read_json() from wrappers.py.
+
+
+def write_json(obj, path, **kwargs):
+    with open(path, 'w', encoding='utf-8') as f:
+        json.dump(obj, f, **kwargs)
+
+
+def read_json(path):
+    with open(path, encoding='utf-8') as f:
+        return json.load(f)
+
+
+class BackendUnavailable(Exception):
+    """Raised if we cannot import the backend"""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+class BackendInvalid(Exception):
+    """Raised if the backend is invalid"""
+    def __init__(self, message):
+        self.message = message
+
+
+class HookMissing(Exception):
+    """Raised if a hook is missing and we are not executing the fallback"""
+    def __init__(self, hook_name=None):
+        super().__init__(hook_name)
+        self.hook_name = hook_name
+
+
+def contained_in(filename, directory):
+    """Test if a file is located within the given directory."""
+    filename = os.path.normcase(os.path.abspath(filename))
+    directory = os.path.normcase(os.path.abspath(directory))
+    return os.path.commonprefix(filename, directory) == directory
+
+
+def _build_backend():
+    """Find and load the build backend"""
+    # Add in-tree backend directories to the front of sys.path.
+    backend_path = os.environ.get('PEP517_BACKEND_PATH')
+    if backend_path:
+        extra_pathitems = backend_path.split(os.pathsep)
+        sys.path:0 = extra_pathitems
+
+    ep = os.environ'PEP517_BUILD_BACKEND'
+    mod_path, _, obj_path = ep.partition(':')
+    try:
+        obj = import_module(mod_path)
+    except ImportError:
+        raise BackendUnavailable(traceback.format_exc())
+
+    if backend_path:
+        if not any(
+            contained_in(obj.__file__, path)
+            for path in extra_pathitems
+        ):
+            raise BackendInvalid("Backend was not loaded from backend-path")
+
+    if obj_path:
+        for path_part in obj_path.split('.'):
+            obj = getattr(obj, path_part)
+    return obj
+
+
+def _supported_features():
+    """Return the list of options features supported by the backend.
+
+    Returns a list of strings.
+    The only possible value is 'build_editable'.
+    """
+    backend = _build_backend()
+    features = 
+    if hasattr(backend, "build_editable"):
+        features.append("build_editable")
+    return features
+
+
+def get_requires_for_build_wheel(config_settings):
+    """Invoke the optional get_requires_for_build_wheel hook
+
+    Returns  if the hook is not defined.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.get_requires_for_build_wheel
+    except AttributeError:
+        return 
+    else:
+        return hook(config_settings)
+
+
+def get_requires_for_build_editable(config_settings):
+    """Invoke the optional get_requires_for_build_editable hook
+
+    Returns  if the hook is not defined.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.get_requires_for_build_editable
+    except AttributeError:
+        return 
+    else:
+        return hook(config_settings)
+
+
+def prepare_metadata_for_build_wheel(
+        metadata_directory, config_settings, _allow_fallback):
+    """Invoke optional prepare_metadata_for_build_wheel
+
+    Implements a fallback by building a wheel if the hook isn't defined,
+    unless _allow_fallback is False in which case HookMissing is raised.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.prepare_metadata_for_build_wheel
+    except AttributeError:
+        if not _allow_fallback:
+            raise HookMissing()
+    else:
+        return hook(metadata_directory, config_settings)
+    # fallback to build_wheel outside the try block to avoid exception chaining
+    # which can be confusing to users and is not relevant
+    whl_basename = backend.build_wheel(metadata_directory, config_settings)
+    return _get_wheel_metadata_from_wheel(whl_basename, metadata_directory,
+                                          config_settings)
+
+
+def prepare_metadata_for_build_editable(
+        metadata_directory, config_settings, _allow_fallback):
+    """Invoke optional prepare_metadata_for_build_editable
+
+    Implements a fallback by building an editable wheel if the hook isn't
+    defined, unless _allow_fallback is False in which case HookMissing is
+    raised.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.prepare_metadata_for_build_editable
+    except AttributeError:
+        if not _allow_fallback:
+            raise HookMissing()
+        try:
+            build_hook = backend.build_editable
+        except AttributeError:
+            raise HookMissing(hook_name='build_editable')
+        else:
+            whl_basename = build_hook(metadata_directory, config_settings)
+            return _get_wheel_metadata_from_wheel(whl_basename,
+                                                  metadata_directory,
+                                                  config_settings)
+    else:
+        return hook(metadata_directory, config_settings)
+
+
+WHEEL_BUILT_MARKER = 'PEP517_ALREADY_BUILT_WHEEL'
+
+
+def _dist_info_files(whl_zip):
+    """Identify the .dist-info folder inside a wheel ZipFile."""
+    res = 
+    for path in whl_zip.namelist():
+        m = re.match(r'^/\\+-^/\\+\.dist-info/', path)
+        if m:
+            res.append(path)
+    if res:
+        return res
+    raise Exception("No .dist-info folder found in wheel")
+
+
+def _get_wheel_metadata_from_wheel(
+        whl_basename, metadata_directory, config_settings):
+    """Extract the metadata from a wheel.
+
+    Fallback for when the build backend does not
+    define the 'get_wheel_metadata' hook.
+    """
+    from zipfile import ZipFile
+    with open(os.path.join(metadata_directory, WHEEL_BUILT_MARKER), 'wb'):
+        pass  # Touch marker file
+
+    whl_file = os.path.join(metadata_directory, whl_basename)
+    with ZipFile(whl_file) as zipf:
+        dist_info = _dist_info_files(zipf)
+        zipf.extractall(path=metadata_directory, members=dist_info)
+    return dist_info0.split('/')0
+
+
+def _find_already_built_wheel(metadata_directory):
+    """Check for a wheel already built during the get_wheel_metadata hook.
+    """
+    if not metadata_directory:
+        return None
+    metadata_parent = os.path.dirname(metadata_directory)
+    if not os.path.isfile(pjoin(metadata_parent, WHEEL_BUILT_MARKER)):
+        return None
+
+    whl_files = glob(os.path.join(metadata_parent, '*.whl'))
+    if not whl_files:
+        print('Found wheel built marker, but no .whl files')
+        return None
+    if len(whl_files) > 1:
+        print('Found multiple .whl files; unspecified behaviour. '
+              'Will call build_wheel.')
+        return None
+
+    # Exactly one .whl file
+    return whl_files0
+
+
+def build_wheel(wheel_directory, config_settings, metadata_directory=None):
+    """Invoke the mandatory build_wheel hook.
+
+    If a wheel was already built in the
+    prepare_metadata_for_build_wheel fallback, this
+    will copy it rather than rebuilding the wheel.
+    """
+    prebuilt_whl = _find_already_built_wheel(metadata_directory)
+    if prebuilt_whl:
+        shutil.copy2(prebuilt_whl, wheel_directory)
+        return os.path.basename(prebuilt_whl)
+
+    return _build_backend().build_wheel(wheel_directory, config_settings,
+                                        metadata_directory)
+
+
+def build_editable(wheel_directory, config_settings, metadata_directory=None):
+    """Invoke the optional build_editable hook.
+
+    If a wheel was already built in the
+    prepare_metadata_for_build_editable fallback, this
+    will copy it rather than rebuilding the wheel.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.build_editable
+    except AttributeError:
+        raise HookMissing()
+    else:
+        prebuilt_whl = _find_already_built_wheel(metadata_directory)
+        if prebuilt_whl:
+            shutil.copy2(prebuilt_whl, wheel_directory)
+            return os.path.basename(prebuilt_whl)
+
+        return hook(wheel_directory, config_settings, metadata_directory)
+
+
+def get_requires_for_build_sdist(config_settings):
+    """Invoke the optional get_requires_for_build_wheel hook
+
+    Returns  if the hook is not defined.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.get_requires_for_build_sdist
+    except AttributeError:
+        return 
+    else:
+        return hook(config_settings)
+
+
+class _DummyException(Exception):
+    """Nothing should ever raise this exception"""
+
+
+class GotUnsupportedOperation(Exception):
+    """For internal use when backend raises UnsupportedOperation"""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+def build_sdist(sdist_directory, config_settings):
+    """Invoke the mandatory build_sdist hook."""
+    backend = _build_backend()
+    try:
+        return backend.build_sdist(sdist_directory, config_settings)
+    except getattr(backend, 'UnsupportedOperation', _DummyException):
+        raise GotUnsupportedOperation(traceback.format_exc())
+
+
+HOOK_NAMES = {
+    'get_requires_for_build_wheel',
+    'prepare_metadata_for_build_wheel',
+    'build_wheel',
+    'get_requires_for_build_editable',
+    'prepare_metadata_for_build_editable',
+    'build_editable',
+    'get_requires_for_build_sdist',
+    'build_sdist',
+    '_supported_features',
+}
+
+
+def main():
+    if len(sys.argv) < 3:
+        sys.exit("Needs args: hook_name, control_dir")
+    hook_name = sys.argv1
+    control_dir = sys.argv2
+    if hook_name not in HOOK_NAMES:
+        sys.exit("Unknown hook: %s" % hook_name)
+    hook = globals()hook_name
+
+    hook_input = read_json(pjoin(control_dir, 'input.json'))
+
+    json_out = {'unsupported': False, 'return_val': None}
+    try:
+        json_out'return_val' = hook(**hook_input'kwargs')
+    except BackendUnavailable as e:
+        json_out'no_backend' = True
+        json_out'traceback' = e.traceback
+    except BackendInvalid as e:
+        json_out'backend_invalid' = True
+        json_out'backend_error' = e.message
+    except GotUnsupportedOperation as e:
+        json_out'unsupported' = True
+        json_out'traceback' = e.traceback
+    except HookMissing as e:
+        json_out'hook_missing' = True
+        json_out'missing_hook_name' = e.hook_name or hook_name
+
+    write_json(json_out, pjoin(control_dir, 'output.json'), indent=2)
+
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/requests.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/requests/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/requests/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/requests/__version__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/requests/__version__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/requests/models.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/requests/models.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/resolvelib/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/__init__.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/__init__.pyi Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/compat/collections_abc.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/resolvelib/providers.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/providers.py Changed

@@ -1,5 +1,5 @@
 class AbstractProvider(object):
-    """Delegate class to provide requirement interface for the resolver."""
+    """Delegate class to provide the required interface for the resolver."""
 
     def identify(self, requirement_or_candidate):
         """Given a requirement, return an identifier for it.
@@ -24,9 +24,9 @@
         this group of arguments is.
 
         :param identifier: An identifier as returned by ``identify()``. This
-            identifies the dependency matches of which should be returned.
+            identifies the dependency matches which should be returned.
         :param resolutions: Mapping of candidates currently pinned by the
-            resolver. Each key is an identifier, and the value a candidate.
+            resolver. Each key is an identifier, and the value is a candidate.
             The candidate may conflict with requirements from ``information``.
         :param candidates: Mapping of each dependency's possible candidates.
             Each value is an iterator of candidates.
@@ -39,10 +39,10 @@
 
         * ``requirement`` specifies a requirement contributing to the current
           list of candidates.
-        * ``parent`` specifies the candidate that provides (dependend on) the
+        * ``parent`` specifies the candidate that provides (depended on) the
           requirement, or ``None`` to indicate a root requirement.
 
-        The preference could depend on a various of issues, including (not
+        The preference could depend on various issues, including (not
         necessarily in this order):
 
         * Is this package pinned in the current resolution result?
@@ -61,7 +61,7 @@
         raise NotImplementedError
 
     def find_matches(self, identifier, requirements, incompatibilities):
-        """Find all possible candidates that satisfy given constraints.
+        """Find all possible candidates that satisfy the given constraints.
 
         :param identifier: An identifier as returned by ``identify()``. This
             identifies the dependency matches of which should be returned.
@@ -92,7 +92,7 @@
     def is_satisfied_by(self, requirement, candidate):
         """Whether the given requirement can be satisfied by a candidate.
 
-        The candidate is guarenteed to have been generated from the
+        The candidate is guaranteed to have been generated from the
         requirement.
 
         A boolean should be returned to indicate whether ``candidate`` is a

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/providers.pyi Added

@@ -0,0 +1,44 @@
+from typing import (
+    Any,
+    Generic,
+    Iterable,
+    Iterator,
+    Mapping,
+    Protocol,
+    Sequence,
+    Union,
+)
+
+from .reporters import BaseReporter
+from .resolvers import RequirementInformation
+from .structs import CT, KT, RT, Matches
+
+class Preference(Protocol):
+    def __lt__(self, __other: Any) -> bool: ...
+
+class AbstractProvider(GenericRT, CT, KT):
+    def identify(self, requirement_or_candidate: UnionRT, CT) -> KT: ...
+    def get_preference(
+        self,
+        identifier: KT,
+        resolutions: MappingKT, CT,
+        candidates: MappingKT, IteratorCT,
+        information: MappingKT, IteratorRequirementInformationRT, CT,
+        backtrack_causes: SequenceRequirementInformationRT, CT,
+    ) -> Preference: ...
+    def find_matches(
+        self,
+        identifier: KT,
+        requirements: MappingKT, IteratorRT,
+        incompatibilities: MappingKT, IteratorCT,
+    ) -> Matches: ...
+    def is_satisfied_by(self, requirement: RT, candidate: CT) -> bool: ...
+    def get_dependencies(self, candidate: CT) -> IterableRT: ...
+
+class AbstractResolver(GenericRT, CT, KT):
+    base_exception = Exception
+    provider: AbstractProviderRT, CT, KT
+    reporter: BaseReporter
+    def __init__(
+        self, provider: AbstractProviderRT, CT, KT, reporter: BaseReporter
+    ): ...

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/resolvelib/reporters.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/reporters.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/reporters.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/resolvelib/resolvers.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/resolvers.py Changed

@@ -1,4 +1,5 @@
 import collections
+import itertools
 import operator
 
 from .providers import AbstractResolver
@@ -173,6 +174,31 @@
             raise RequirementsConflicted(criterion)
         criteriaidentifier = criterion
 
+    def _remove_information_from_criteria(self, criteria, parents):
+        """Remove information from parents of criteria.
+
+        Concretely, removes all values from each criterion's ``information``
+        field that have one of ``parents`` as provider of the requirement.
+
+        :param criteria: The criteria to update.
+        :param parents: Identifiers for which to remove information from all criteria.
+        """
+        if not parents:
+            return
+        for key, criterion in criteria.items():
+            criteriakey = Criterion(
+                criterion.candidates,
+                
+                    information
+                    for information in criterion.information
+                    if (
+                        information.parent is None
+                        or self._p.identify(information.parent) not in parents
+                    )
+                ,
+                criterion.incompatibilities,
+            )
+
     def _get_preference(self, name):
         return self._p.get_preference(
             identifier=name,
@@ -212,6 +238,7 @@
             try:
                 criteria = self._get_updated_criteria(candidate)
             except RequirementsConflicted as e:
+                self._r.rejecting_candidate(e.criterion, candidate)
                 causes.append(e.criterion)
                 continue
 
@@ -240,8 +267,8 @@
         # end, signal for backtracking.
         return causes
 
-    def _backtrack(self):
-        """Perform backtracking.
+    def _backjump(self, causes):
+        """Perform backjumping.
 
         When we enter here, the stack is like this::
 
@@ -257,22 +284,46 @@
 
         Each iteration of the loop will:
 
-        1.  Discard Z.
-        2.  Discard Y but remember its incompatibility information gathered
+        1.  Identify Z. The incompatibility is not always caused by the latest
+            state. For example, given three requirements A, B and C, with
+            dependencies A1, B1 and C1, where A1 and B1 are incompatible: the
+            last state might be related to C, so we want to discard the
+            previous state.
+        2.  Discard Z.
+        3.  Discard Y but remember its incompatibility information gathered
             previously, and the failure we're dealing with right now.
-        3.  Push a new state Y' based on X, and apply the incompatibility
+        4.  Push a new state Y' based on X, and apply the incompatibility
             information from Y to Y'.
-        4a. If this causes Y' to conflict, we need to backtrack again. Make Y'
+        5a. If this causes Y' to conflict, we need to backtrack again. Make Y'
             the new Z and go back to step 2.
-        4b. If the incompatibilities apply cleanly, end backtracking.
+        5b. If the incompatibilities apply cleanly, end backtracking.
         """
+        incompatible_reqs = itertools.chain(
+            (c.parent for c in causes if c.parent is not None),
+            (c.requirement for c in causes),
+        )
+        incompatible_deps = {self._p.identify(r) for r in incompatible_reqs}
         while len(self._states) >= 3:
             # Remove the state that triggered backtracking.
             del self._states-1
 
-            # Retrieve the last candidate pin and known incompatibilities.
-            broken_state = self._states.pop()
-            name, candidate = broken_state.mapping.popitem()
+            # Ensure to backtrack to a state that caused the incompatibility
+            incompatible_state = False
+            while not incompatible_state:
+                # Retrieve the last candidate pin and known incompatibilities.
+                try:
+                    broken_state = self._states.pop()
+                    name, candidate = broken_state.mapping.popitem()
+                except (IndexError, KeyError):
+                    raise ResolutionImpossible(causes)
+                current_dependencies = {
+                    self._p.identify(d)
+                    for d in self._p.get_dependencies(candidate)
+                }
+                incompatible_state = not current_dependencies.isdisjoint(
+                    incompatible_deps
+                )
+
             incompatibilities_from_broken = 
                 (k, list(v.incompatibilities))
                 for k, v in broken_state.criteria.items()
@@ -281,8 +332,6 @@
             # Also mark the newly known incompatibility.
             incompatibilities_from_broken.append((name, candidate))
 
-            self._r.backtracking(candidate=candidate)
-
             # Create a new state from the last known-to-work one, and apply
             # the previously gathered incompatibility information.
             def _patch_criteria():
@@ -368,22 +417,38 @@
                 self._r.ending(state=self.state)
                 return self.state
 
+            # keep track of satisfied names to calculate diff after pinning
+            satisfied_names = set(self.state.criteria.keys()) - set(
+                unsatisfied_names
+            )
+
             # Choose the most preferred unpinned criterion to try.
             name = min(unsatisfied_names, key=self._get_preference)
             failure_causes = self._attempt_to_pin_criterion(name)
 
             if failure_causes:
                 causes = i for c in failure_causes for i in c.information
-                # Backtrack if pinning fails. The backtrack process puts us in
+                # Backjump if pinning fails. The backjump process puts us in
                 # an unpinned state, so we can work on it in the next round.
                 self._r.resolving_conflicts(causes=causes)
-                success = self._backtrack()
+                success = self._backjump(causes)
                 self.state.backtrack_causes: = causes
 
                 # Dead ends everywhere. Give up.
                 if not success:
                     raise ResolutionImpossible(self.state.backtrack_causes)
             else:
+                # discard as information sources any invalidated names
+                # (unsatisfied names that were previously satisfied)
+                newly_unsatisfied_names = {
+                    key
+                    for key, criterion in self.state.criteria.items()
+                    if key in satisfied_names
+                    and not self._is_current_pin_satisfying(key, criterion)
+                }
+                self._remove_information_from_criteria(
+                    self.state.criteria, newly_unsatisfied_names
+                )
                 # Pinning was successful. Push a new state to do another pin.
                 self._push_new_state()

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/resolvers.pyi Added

@@ -0,0 +1,79 @@
+from typing import (
+    Collection,
+    Generic,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+)
+
+from .providers import AbstractProvider, AbstractResolver
+from .structs import CT, KT, RT, DirectedGraph, IterableView
+
+# This should be a NamedTuple, but Python 3.6 has a bug that prevents it.
+# https://stackoverflow.com/a/50531189/1376863
+class RequirementInformation(tuple, GenericRT, CT):
+    requirement: RT
+    parent: OptionalCT
+
+class Criterion(GenericRT, CT, KT):
+    candidates: IterableViewCT
+    information: CollectionRequirementInformationRT, CT
+    incompatibilities: ListCT
+    @classmethod
+    def from_requirement(
+        cls,
+        provider: AbstractProviderRT, CT, KT,
+        requirement: RT,
+        parent: OptionalCT,
+    ) -> CriterionRT, CT, KT: ...
+    def iter_requirement(self) -> IteratorRT: ...
+    def iter_parent(self) -> IteratorOptionalCT: ...
+    def merged_with(
+        self,
+        provider: AbstractProviderRT, CT, KT,
+        requirement: RT,
+        parent: OptionalCT,
+    ) -> CriterionRT, CT, KT: ...
+    def excluded_of(self, candidates: ListCT) -> CriterionRT, CT, KT: ...
+
+class ResolverException(Exception): ...
+
+class RequirementsConflicted(ResolverException, GenericRT, CT, KT):
+    criterion: CriterionRT, CT, KT
+
+class ResolutionError(ResolverException): ...
+
+class InconsistentCandidate(ResolverException, GenericRT, CT, KT):
+    candidate: CT
+    criterion: CriterionRT, CT, KT
+
+class ResolutionImpossible(ResolutionError, GenericRT, CT):
+    causes: ListRequirementInformationRT, CT
+
+class ResolutionTooDeep(ResolutionError):
+    round_count: int
+
+# This should be a NamedTuple, but Python 3.6 has a bug that prevents it.
+# https://stackoverflow.com/a/50531189/1376863
+class State(tuple, GenericRT, CT, KT):
+    mapping: MappingKT, CT
+    criteria: MappingKT, CriterionRT, CT, KT
+    backtrack_causes: CollectionRequirementInformationRT, CT
+
+class Resolution(GenericRT, CT, KT):
+    def resolve(
+        self, requirements: IterableRT, max_rounds: int
+    ) -> StateRT, CT, KT: ...
+
+class Result(GenericRT, CT, KT):
+    mapping: MappingKT, CT
+    graph: DirectedGraphOptionalKT
+    criteria: MappingKT, CriterionRT, CT, KT
+
+class Resolver(AbstractResolver, GenericRT, CT, KT):
+    base_exception = ResolverException
+    def resolve(
+        self, requirements: IterableRT, max_rounds: int = 100
+    ) -> ResultRT, CT, KT: ...

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/resolvelib/structs.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/structs.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/resolvelib/structs.pyi Added

@@ -0,0 +1,40 @@
+from abc import ABCMeta
+from typing import (
+    Callable,
+    Container,
+    Generic,
+    Iterable,
+    Iterator,
+    Mapping,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+KT = TypeVar("KT")  # Identifier.
+RT = TypeVar("RT")  # Requirement.
+CT = TypeVar("CT")  # Candidate.
+_T = TypeVar("_T")
+
+Matches = UnionIterableCT, Callable, IterableCT
+
+class IteratorMapping(MappingKT, _T, metaclass=ABCMeta):
+    pass
+
+class IterableView(ContainerCT, IterableCT, metaclass=ABCMeta):
+    pass
+
+class DirectedGraph(GenericKT):
+    def __iter__(self) -> IteratorKT: ...
+    def __len__(self) -> int: ...
+    def __contains__(self, key: KT) -> bool: ...
+    def copy(self) -> "DirectedGraphKT": ...
+    def add(self, key: KT) -> None: ...
+    def remove(self, key: KT) -> None: ...
+    def connected(self, f: KT, t: KT) -> bool: ...
+    def connect(self, f: KT, t: KT) -> None: ...
+    def iter_edges(self) -> IterableTupleKT, KT: ...
+    def iter_children(self, key: KT) -> IterableKT: ...
+    def iter_parents(self, key: KT) -> IterableKT: ...
+
+def build_iter_view(matches: Matches) -> IterableViewCT: ...

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/__init__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/__main__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/__main__.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/_export_format.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/_export_format.py Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/_fileno.py Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/_null_file.py Added

@@ -0,0 +1,69 @@
+from types import TracebackType
+from typing import IO, Iterable, Iterator, List, Optional, Type
+
+
+class NullFile(IOstr):
+    def close(self) -> None:
+        pass
+
+    def isatty(self) -> bool:
+        return False
+
+    def read(self, __n: int = 1) -> str:
+        return ""
+
+    def readable(self) -> bool:
+        return False
+
+    def readline(self, __limit: int = 1) -> str:
+        return ""
+
+    def readlines(self, __hint: int = 1) -> Liststr:
+        return 
+
+    def seek(self, __offset: int, __whence: int = 1) -> int:
+        return 0
+
+    def seekable(self) -> bool:
+        return False
+
+    def tell(self) -> int:
+        return 0
+
+    def truncate(self, __size: Optionalint = 1) -> int:
+        return 0
+
+    def writable(self) -> bool:
+        return False
+
+    def writelines(self, __lines: Iterablestr) -> None:
+        pass
+
+    def __next__(self) -> str:
+        return ""
+
+    def __iter__(self) -> Iteratorstr:
+        return iter("")
+
+    def __enter__(self) -> IOstr:
+        pass
+
+    def __exit__(
+        self,
+        __t: OptionalTypeBaseException,
+        __value: OptionalBaseException,
+        __traceback: OptionalTracebackType,
+    ) -> None:
+        pass
+
+    def write(self, text: str) -> int:
+        return 0
+
+    def flush(self) -> None:
+        pass
+
+    def fileno(self) -> int:
+        return -1
+
+
+NULL_FILE = NullFile()

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/align.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/align.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/ansi.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/ansi.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/box.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/box.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/cells.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/cells.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/color.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/color.py Changed

@@ -29,6 +29,9 @@
     def __repr__(self) -> str:
         return f"ColorSystem.{self.name}"
 
+    def __str__(self) -> str:
+        return repr(self)
+
 
 class ColorType(IntEnum):
     """Type of color stored in Color class."""
@@ -310,7 +313,7 @@
     """A triplet of color components, if an RGB color."""
 
     def __rich__(self) -> "Text":
-        """Dispays the actual color if Rich printed."""
+        """Displays the actual color if Rich printed."""
         from .style import Style
         from .text import Text
 
@@ -510,15 +513,14 @@
     def downgrade(self, system: ColorSystem) -> "Color":
         """Downgrade a color system to a system with fewer colors."""
 
-        if self.type in ColorType.DEFAULT, system:
+        if self.type in (ColorType.DEFAULT, system):
             return self
         # Convert to 8-bit color from truecolor color
         if system == ColorSystem.EIGHT_BIT and self.system == ColorSystem.TRUECOLOR:
             assert self.triplet is not None
-            red, green, blue = self.triplet.normalized
-            _h, l, s = rgb_to_hls(red, green, blue)
-            # If saturation is under 10% assume it is grayscale
-            if s < 0.1:
+            _h, l, s = rgb_to_hls(*self.triplet.normalized)
+            # If saturation is under 15% assume it is grayscale
+            if s < 0.15:
                 gray = round(l * 25.0)
                 if gray == 0:
                     color_number = 16
@@ -528,8 +530,13 @@
                     color_number = 231 + gray
                 return Color(self.name, ColorType.EIGHT_BIT, number=color_number)
 
+            red, green, blue = self.triplet
+            six_red = red / 95 if red < 95 else 1 + (red - 95) / 40
+            six_green = green / 95 if green < 95 else 1 + (green - 95) / 40
+            six_blue = blue / 95 if blue < 95 else 1 + (blue - 95) / 40
+
             color_number = (
-                16 + 36 * round(red * 5.0) + 6 * round(green * 5.0) + round(blue * 5.0)
+                16 + 36 * round(six_red) + 6 * round(six_green) + round(six_blue)
             )
             return Color(self.name, ColorType.EIGHT_BIT, number=color_number)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/console.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/console.py Changed

@@ -1,5 +1,4 @@
 import inspect
-import io
 import os
 import platform
 import sys
@@ -34,6 +33,8 @@
     cast,
 )
 
+from pip._vendor.rich._null_file import NULL_FILE
+
 if sys.version_info >= (3, 8):
     from typing import Literal, Protocol, runtime_checkable
 else:
@@ -46,6 +47,7 @@
 from . import errors, themes
 from ._emoji_replace import _emoji_replace
 from ._export_format import CONSOLE_HTML_FORMAT, CONSOLE_SVG_FORMAT
+from ._fileno import get_fileno
 from ._log_render import FormatTimeCallable, LogRender
 from .align import Align, AlignMethod
 from .color import ColorSystem, blend_rgb
@@ -104,7 +106,11 @@
 _STD_STREAMS_OUTPUT = (_STDOUT_FILENO, _STDERR_FILENO)
 
 
-_TERM_COLORS = {"256color": ColorSystem.EIGHT_BIT, "16color": ColorSystem.STANDARD}
+_TERM_COLORS = {
+    "kitty": ColorSystem.EIGHT_BIT,
+    "256color": ColorSystem.EIGHT_BIT,
+    "16color": ColorSystem.STANDARD,
+}
 
 
 class ConsoleDimensions(NamedTuple):
@@ -516,7 +522,11 @@
         return False
     ipython = get_ipython()  # type: ignorename-defined
     shell = ipython.__class__.__name__
-    if "google.colab" in str(ipython.__class__) or shell == "ZMQInteractiveShell":
+    if (
+        "google.colab" in str(ipython.__class__)
+        or os.getenv("DATABRICKS_RUNTIME_VERSION")
+        or shell == "ZMQInteractiveShell"
+    ):
         return True  # Jupyter notebook or qtconsole
     elif shell == "TerminalInteractiveShell":
         return False  # Terminal running IPython
@@ -697,7 +707,11 @@
         self._height = height
 
         self._color_system: OptionalColorSystem
-        self._force_terminal = force_terminal
+
+        self._force_terminal = None
+        if force_terminal is not None:
+            self._force_terminal = force_terminal
+
         self._file = file
         self.quiet = quiet
         self.stderr = stderr
@@ -739,13 +753,15 @@
         self._is_alt_screen = False
 
     def __repr__(self) -> str:
-        return f"<console width={self.width} {str(self._color_system)}>"
+        return f"<console width={self.width} {self._color_system!s}>"
 
     @property
     def file(self) -> IOstr:
         """Get the file object to write to."""
         file = self._file or (sys.stderr if self.stderr else sys.stdout)
         file = getattr(file, "rich_proxied_file", file)
+        if file is None:
+            file = NULL_FILE
         return file
 
     @file.setter
@@ -928,6 +944,15 @@
             # Return False for Idle which claims to be a tty but can't handle ansi codes
             return False
 
+        if self.is_jupyter:
+            # return False for Jupyter, which may have FORCE_COLOR set
+            return False
+
+        # If FORCE_COLOR env var has any value at all, we assume a terminal.
+        force_color = self._environ.get("FORCE_COLOR")
+        if force_color is not None:
+            self._force_terminal = True
+
         isatty: OptionalCallable, bool = getattr(self.file, "isatty", None)
         try:
             return False if isatty is None else isatty()
@@ -1125,7 +1150,7 @@
         status: RenderableType,
         *,
         spinner: str = "dots",
-        spinner_style: str = "status.spinner",
+        spinner_style: StyleType = "status.spinner",
         speed: float = 1.0,
         refresh_per_second: float = 12.5,
     ) -> "Status":
@@ -1502,7 +1527,7 @@
             if text:
                 sep_text = Text(sep, justify=justify, end=end)
                 append(sep_text.join(text))
-                del text:
+                text.clear()
 
         for renderable in objects:
             renderable = rich_cast(renderable)
@@ -1701,7 +1726,7 @@
         indent: UnionNone, int, str = 2,
         highlight: bool = True,
         skip_keys: bool = False,
-        ensure_ascii: bool = True,
+        ensure_ascii: bool = False,
         check_circular: bool = True,
         allow_nan: bool = True,
         default: OptionalCallableAny, Any = None,
@@ -1985,31 +2010,50 @@
                     if WINDOWS:
                         use_legacy_windows_render = False
                         if self.legacy_windows:
-                            try:
+                            fileno = get_fileno(self.file)
+                            if fileno is not None:
                                 use_legacy_windows_render = (
-                                    self.file.fileno() in _STD_STREAMS_OUTPUT
+                                    fileno in _STD_STREAMS_OUTPUT
                                 )
-                            except (ValueError, io.UnsupportedOperation):
-                                pass
 
                         if use_legacy_windows_render:
                             from pip._vendor.rich._win32_console import LegacyWindowsTerm
                             from pip._vendor.rich._windows_renderer import legacy_windows_render
 
-                            legacy_windows_render(
-                                self._buffer:, LegacyWindowsTerm(self.file)
-                            )
+                            buffer = self._buffer:
+                            if self.no_color and self._color_system:
+                                buffer = list(Segment.remove_color(buffer))
+
+                            legacy_windows_render(buffer, LegacyWindowsTerm(self.file))
                         else:
                             # Either a non-std stream on legacy Windows, or modern Windows.
                             text = self._render_buffer(self._buffer:)
                             # https://bugs.python.org/issue37871
+                            # https://github.com/python/cpython/issues/82052
+                            # We need to avoid writing more than 32Kb in a single write, due to the above bug
                             write = self.file.write
-                            for line in text.splitlines(True):
-                                try:
-                                    write(line)
-                                except UnicodeEncodeError as error:
-                                    error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***"
-                                    raise
+                            # Worse case scenario, every character is 4 bytes of utf-8
+                            MAX_WRITE = 32 * 1024 // 4
+                            try:
+                                if len(text) <= MAX_WRITE:
+                                    write(text)
+                                else:
+                                    batch: Liststr = 
+                                    batch_append = batch.append
+                                    size = 0
+                                    for line in text.splitlines(True):
+                                        if size + len(line) > MAX_WRITE and batch:
+                                            write("".join(batch))
+                                            batch.clear()
+                                            size = 0
+                                        batch_append(line)
+                                        size += len(line)
+                                    if batch:
+                                        write("".join(batch))
+                                        batch.clear()
+                            except UnicodeEncodeError as error:
+                                error.reason = f"{error.reason}\n*** You may need to add PYTHONIOENCODING=utf-8 to your environment ***"
+                                raise
                     else:
                         text = self._render_buffer(self._buffer:)
                         try:
@@ -2238,18 +2282,24 @@
         theme: OptionalTerminalTheme = None,
         clear: bool = True,
         code_format: str = CONSOLE_SVG_FORMAT,
+        font_aspect_ratio: float = 0.61,
+        unique_id: Optionalstr = None,
     ) -> str:
         """
         Generate an SVG from the console contents (requires record=True in Console constructor).
 
         Args:
-            path (str): The path to write the SVG to.
-            title (str): The title of the tab in the output image
+            title (str, optional): The title of the tab in the output image
             theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
             clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
-            code_format (str): Format string used to generate the SVG. Rich will inject a number of variables
+            code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables
                 into the string in order to form the final SVG output. The default template used and the variables
                 injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable.
+            font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format``
+                string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font).
+                If you aren't specifying a different font inside ``code_format``, you probably don't need this.
+            unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node
+                ids). If not set, this defaults to a computed value based on the recorded content.
         """
 
         from pip._vendor.rich.cells import cell_len
@@ -2293,7 +2343,7 @@
 
         width = self.width
         char_height = 20
-        char_width = char_height * 0.61
+        char_width = char_height * font_aspect_ratio
         line_height = char_height * 1.22
 
         margin_top = 1
@@ -2345,14 +2395,16 @@
             if clear:
                 self._record_buffer.clear()
 
-        unique_id = "terminal-" + str(
-            zlib.adler32(
-                ("".join(segment.text for segment in segments)).encode(
-                    "utf-8", "ignore"
+        if unique_id is None:
+            unique_id = "terminal-" + str(
+                zlib.adler32(
+                    ("".join(repr(segment) for segment in segments)).encode(
+                        "utf-8",
+                        "ignore",
+                    )
+                    + title.encode("utf-8", "ignore")
                 )
-                + title.encode("utf-8", "ignore")
             )
-        )
         y = 0
         for y, line in enumerate(Segment.split_and_crop_lines(segments, length=width)):
             x = 0
@@ -2482,23 +2534,32 @@
         theme: OptionalTerminalTheme = None,
         clear: bool = True,
         code_format: str = CONSOLE_SVG_FORMAT,
+        font_aspect_ratio: float = 0.61,
+        unique_id: Optionalstr = None,
     ) -> None:
         """Generate an SVG file from the console contents (requires record=True in Console constructor).
 
         Args:
             path (str): The path to write the SVG to.
-            title (str): The title of the tab in the output image
+            title (str, optional): The title of the tab in the output image
             theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal
             clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``
-            code_format (str): Format string used to generate the SVG. Rich will inject a number of variables
+            code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables
                 into the string in order to form the final SVG output. The default template used and the variables
                 injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable.
+            font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format``
+                string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font).
+                If you aren't specifying a different font inside ``code_format``, you probably don't need this.
+            unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node
+                ids). If not set, this defaults to a computed value based on the recorded content.
         """
         svg = self.export_svg(
             title=title,
             theme=theme,
             clear=clear,
             code_format=code_format,
+            font_aspect_ratio=font_aspect_ratio,
+            unique_id=unique_id,
         )
         with open(path, "wt", encoding="utf-8") as write_file:
             write_file.write(svg)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/default_styles.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/default_styles.py Changed

@@ -138,10 +138,11 @@
     "tree.line": Style(),
     "markdown.paragraph": Style(),
     "markdown.text": Style(),
-    "markdown.emph": Style(italic=True),
+    "markdown.em": Style(italic=True),
+    "markdown.emph": Style(italic=True),  # For commonmark backwards compatibility
     "markdown.strong": Style(bold=True),
-    "markdown.code": Style(bgcolor="black", color="bright_white"),
-    "markdown.code_block": Style(dim=True, color="cyan", bgcolor="black"),
+    "markdown.code": Style(bold=True, color="cyan", bgcolor="black"),
+    "markdown.code_block": Style(color="cyan", bgcolor="black"),
     "markdown.block_quote": Style(color="magenta"),
     "markdown.list": Style(color="cyan"),
     "markdown.item": Style(),
@@ -157,7 +158,8 @@
     "markdown.h6": Style(italic=True),
     "markdown.h7": Style(italic=True, dim=True),
     "markdown.link": Style(color="bright_blue"),
-    "markdown.link_url": Style(color="blue"),
+    "markdown.link_url": Style(color="blue", underline=True),
+    "markdown.s": Style(strike=True),
     "iso8601.date": Style(color="blue"),
     "iso8601.time": Style(color="magenta"),
     "iso8601.timezone": Style(color="yellow"),

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/file_proxy.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/file_proxy.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/filesize.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/filesize.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/highlighter.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/highlighter.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/json.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/json.py Changed

@@ -1,3 +1,4 @@
+from pathlib import Path
 from json import loads, dumps
 from typing import Any, Callable, Optional, Union
 
@@ -27,7 +28,7 @@
         indent: UnionNone, int, str = 2,
         highlight: bool = True,
         skip_keys: bool = False,
-        ensure_ascii: bool = True,
+        ensure_ascii: bool = False,
         check_circular: bool = True,
         allow_nan: bool = True,
         default: OptionalCallableAny, Any = None,
@@ -56,7 +57,7 @@
         indent: UnionNone, int, str = 2,
         highlight: bool = True,
         skip_keys: bool = False,
-        ensure_ascii: bool = True,
+        ensure_ascii: bool = False,
         check_circular: bool = True,
         allow_nan: bool = True,
         default: OptionalCallableAny, Any = None,
@@ -131,8 +132,7 @@
         if args.path == "-":
             json_data = sys.stdin.read()
         else:
-            with open(args.path, "rt") as json_file:
-                json_data = json_file.read()
+            json_data = Path(args.path).read_text()
     except Exception as error:
         error_console.print(f"Unable to read {args.path!r}; {error}")
         sys.exit(-1)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/layout.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/layout.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/live.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/live.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/logging.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/logging.py Changed

@@ -3,10 +3,12 @@
 from logging import Handler, LogRecord
 from pathlib import Path
 from types import ModuleType
-from typing import ClassVar, List, Optional, Iterable, Type, Union
+from typing import ClassVar, Iterable, List, Optional, Type, Union
+
+from pip._vendor.rich._null_file import NullFile
 
 from . import get_console
-from ._log_render import LogRender, FormatTimeCallable
+from ._log_render import FormatTimeCallable, LogRender
 from .console import Console, ConsoleRenderable
 from .highlighter import Highlighter, ReprHighlighter
 from .text import Text
@@ -158,16 +160,23 @@
         log_renderable = self.render(
             record=record, traceback=traceback, message_renderable=message_renderable
         )
-        try:
-            self.console.print(log_renderable)
-        except Exception:
+        if isinstance(self.console.file, NullFile):
+            # Handles pythonw, where stdout/stderr are null, and we return NullFile
+            # instance from Console.file. In this case, we still want to make a log record
+            # even though we won't be writing anything to a file.
             self.handleError(record)
+        else:
+            try:
+                self.console.print(log_renderable)
+            except Exception:
+                self.handleError(record)
 
     def render_message(self, record: LogRecord, message: str) -> "ConsoleRenderable":
         """Render message text in to Text.
 
-        record (LogRecord): logging Record.
-        message (str): String containing log message.
+        Args:
+            record (LogRecord): logging Record.
+            message (str): String containing log message.
 
         Returns:
             ConsoleRenderable: Renderable to display log message.

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/panel.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/panel.py Changed

@@ -2,11 +2,12 @@
 
 from .align import AlignMethod
 from .box import ROUNDED, Box
+from .cells import cell_len
 from .jupyter import JupyterMixin
 from .measure import Measurement, measure_renderables
 from .padding import Padding, PaddingDimensions
 from .segment import Segment
-from .style import StyleType
+from .style import Style, StyleType
 from .text import Text, TextType
 
 if TYPE_CHECKING:
@@ -149,9 +150,53 @@
         safe_box: bool = console.safe_box if self.safe_box is None else self.safe_box
         box = self.box.substitute(options, safe=safe_box)
 
+        def align_text(
+            text: Text, width: int, align: str, character: str, style: Style
+        ) -> Text:
+            """Gets new aligned text.
+
+            Args:
+                text (Text): Title or subtitle text.
+                width (int): Desired width.
+                align (str): Alignment.
+                character (str): Character for alignment.
+                style (Style): Border style
+
+            Returns:
+                Text: New text instance
+            """
+            text = text.copy()
+            text.truncate(width)
+            excess_space = width - cell_len(text.plain)
+            if excess_space:
+                if align == "left":
+                    return Text.assemble(
+                        text,
+                        (character * excess_space, style),
+                        no_wrap=True,
+                        end="",
+                    )
+                elif align == "center":
+                    left = excess_space // 2
+                    return Text.assemble(
+                        (character * left, style),
+                        text,
+                        (character * (excess_space - left), style),
+                        no_wrap=True,
+                        end="",
+                    )
+                else:
+                    return Text.assemble(
+                        (character * excess_space, style),
+                        text,
+                        no_wrap=True,
+                        end="",
+                    )
+            return text
+
         title_text = self._title
         if title_text is not None:
-            title_text.style = border_style
+            title_text.stylize_before(border_style)
 
         child_width = (
             width - 2
@@ -180,7 +225,13 @@
         if title_text is None or width <= 4:
             yield Segment(box.get_top(width - 2), border_style)
         else:
-            title_text.align(self.title_align, width - 4, character=box.top)
+            title_text = align_text(
+                title_text,
+                width - 4,
+                self.title_align,
+                box.top,
+                border_style,
+            )
             yield Segment(box.top_left + box.top, border_style)
             yield from console.render(title_text, child_options.update_width(width - 4))
             yield Segment(box.top + box.top_right, border_style)
@@ -194,12 +245,18 @@
 
         subtitle_text = self._subtitle
         if subtitle_text is not None:
-            subtitle_text.style = border_style
+            subtitle_text.stylize_before(border_style)
 
         if subtitle_text is None or width <= 4:
             yield Segment(box.get_bottom(width - 2), border_style)
         else:
-            subtitle_text.align(self.subtitle_align, width - 4, character=box.bottom)
+            subtitle_text = align_text(
+                subtitle_text,
+                width - 4,
+                self.subtitle_align,
+                box.bottom,
+                border_style,
+            )
             yield Segment(box.bottom_left + box.bottom, border_style)
             yield from console.render(
                 subtitle_text, child_options.update_width(width - 4)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/pretty.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/pretty.py Changed

@@ -30,7 +30,7 @@
 try:
     import attr as _attr_module
 
-    _has_attrs = True
+    _has_attrs = hasattr(_attr_module, "ib")
 except ImportError:  # pragma: no cover
     _has_attrs = False
 
@@ -55,13 +55,6 @@
     )
 
 
-JUPYTER_CLASSES_TO_NOT_RENDER = {
-    # Matplotlib "Artists" manage their own rendering in a Jupyter notebook, and we should not try to render them too.
-    # "Typically, all Matplotlib visible elements in a figure are subclasses of Artist."
-    "matplotlib.artist.Artist",
-}
-
-
 def _is_attr_object(obj: Any) -> bool:
     """Check if an object was created with attrs module."""
     return _has_attrs and _attr_module.has(type(obj))
@@ -120,69 +113,42 @@
     indent_guides: bool = False,
     max_length: Optionalint = None,
     max_string: Optionalint = None,
+    max_depth: Optionalint = None,
     expand_all: bool = False,
-) -> None:
+) -> Unionstr, None:
     # needed here to prevent circular import:
-    from ._inspect import is_object_one_of_types
     from .console import ConsoleRenderable
 
     # always skip rich generated jupyter renderables or None values
     if _safe_isinstance(value, JupyterRenderable) or value is None:
-        return
+        return None
 
     console = console or get_console()
-    if console.is_jupyter:
-        # Delegate rendering to IPython if the object (and IPython) supports it
-        #  https://ipython.readthedocs.io/en/stable/config/integrating.html#rich-display
-        ipython_repr_methods = 
-            "_repr_html_",
-            "_repr_markdown_",
-            "_repr_json_",
-            "_repr_latex_",
-            "_repr_jpeg_",
-            "_repr_png_",
-            "_repr_svg_",
-            "_repr_mimebundle_",
-        
-        for repr_method in ipython_repr_methods:
-            method = getattr(value, repr_method, None)
-            if inspect.ismethod(method):
-                # Calling the method ourselves isn't ideal. The interface for the `_repr_*_` methods
-                #  specifies that if they return None, then they should not be rendered
-                #  by the notebook.
-                try:
-                    repr_result = method()
-                except Exception:
-                    continue  # If the method raises, treat it as if it doesn't exist, try any others
-                if repr_result is not None:
-                    return  # Delegate rendering to IPython
-
-        # When in a Jupyter notebook let's avoid the display of some specific classes,
-        # as they result in the rendering of useless and noisy lines such as `<Figure size 432x288 with 1 Axes>`.
-        # What does this do?
-        # --> if the class has "matplotlib.artist.Artist" in its hierarchy for example, we don't render it.
-        if is_object_one_of_types(value, JUPYTER_CLASSES_TO_NOT_RENDER):
-            return
-
-    # certain renderables should start on a new line
-    if _safe_isinstance(value, ConsoleRenderable):
-        console.line()
-
-    console.print(
-        value
-        if _safe_isinstance(value, RichRenderable)
-        else Pretty(
-            value,
-            overflow=overflow,
-            indent_guides=indent_guides,
-            max_length=max_length,
-            max_string=max_string,
-            expand_all=expand_all,
-            margin=12,
-        ),
-        crop=crop,
-        new_line_start=True,
-    )
+
+    with console.capture() as capture:
+        # certain renderables should start on a new line
+        if _safe_isinstance(value, ConsoleRenderable):
+            console.line()
+        console.print(
+            value
+            if _safe_isinstance(value, RichRenderable)
+            else Pretty(
+                value,
+                overflow=overflow,
+                indent_guides=indent_guides,
+                max_length=max_length,
+                max_string=max_string,
+                max_depth=max_depth,
+                expand_all=expand_all,
+                margin=12,
+            ),
+            crop=crop,
+            new_line_start=True,
+            end="",
+        )
+    # strip trailing newline, not usually part of a text repr
+    # I'm not sure if this should be prevented at a lower level
+    return capture.get().rstrip("\n")
 
 
 def _safe_isinstance(
@@ -202,6 +168,7 @@
     indent_guides: bool = False,
     max_length: Optionalint = None,
     max_string: Optionalint = None,
+    max_depth: Optionalint = None,
     expand_all: bool = False,
 ) -> None:
     """Install automatic pretty printing in the Python REPL.
@@ -214,6 +181,7 @@
         max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
             Defaults to None.
         max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to None.
+        max_depth (int, optional): Maximum depth of nested data structures, or None for no maximum. Defaults to None.
         expand_all (bool, optional): Expand all containers. Defaults to False.
         max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
     """
@@ -236,13 +204,14 @@
                     indent_guides=indent_guides,
                     max_length=max_length,
                     max_string=max_string,
+                    max_depth=max_depth,
                     expand_all=expand_all,
                 ),
                 crop=crop,
             )
             builtins._ = value  # type: ignoreattr-defined
 
-    try:  # pragma: no cover
+    if "get_ipython" in globals():
         ip = get_ipython()  # type: ignorename-defined
         from IPython.core.formatters import BaseFormatter
 
@@ -258,6 +227,7 @@
                         indent_guides=indent_guides,
                         max_length=max_length,
                         max_string=max_string,
+                        max_depth=max_depth,
                         expand_all=expand_all,
                     )
                 else:
@@ -266,7 +236,7 @@
         # replace plain text formatter with rich formatter
         rich_formatter = RichFormatter()
         ip.display_formatter.formatters"text/plain" = rich_formatter
-    except Exception:
+    else:
         sys.displayhook = display_hook
 
 
@@ -333,7 +303,7 @@
             max_depth=self.max_depth,
             expand_all=self.expand_all,
         )
-        pretty_text = Text(
+        pretty_text = Text.from_ansi(
             pretty_str,
             justify=self.justify or options.justify,
             overflow=self.overflow or options.overflow,
@@ -365,6 +335,7 @@
             indent_size=self.indent_size,
             max_length=self.max_length,
             max_string=self.max_string,
+            max_depth=self.max_depth,
             expand_all=self.expand_all,
         )
         text_width = (
@@ -427,7 +398,7 @@
     is_tuple: bool = False
     is_namedtuple: bool = False
     children: OptionalList"Node" = None
-    key_separator = ": "
+    key_separator: str = ": "
     separator: str = ", "
 
     def iter_tokens(self) -> Iterablestr:
@@ -630,8 +601,12 @@
     def _traverse(obj: Any, root: bool = False, depth: int = 0) -> Node:
         """Walk the object depth first."""
 
+        obj_id = id(obj)
+        if obj_id in visited_ids:
+            # Recursion detected
+            return Node(value_repr="...")
+
         obj_type = type(obj)
-        py_version = (sys.version_info.major, sys.version_info.minor)
         children: ListNode
         reached_max_depth = max_depth is not None and depth >= max_depth
 
@@ -667,6 +642,7 @@
                 pass
 
         if rich_repr_result is not None:
+            push_visited(obj_id)
             angular = getattr(obj.__rich_repr__, "angular", False)
             args = list(iter_rich_args(rich_repr_result))
             class_name = obj.__class__.__name__
@@ -676,7 +652,10 @@
                 append = children.append
 
                 if reached_max_depth:
-                    node = Node(value_repr=f"...")
+                    if angular:
+                        node = Node(value_repr=f"<{class_name}...>")
+                    else:
+                        node = Node(value_repr=f"{class_name}(...)")
                 else:
                     if angular:
                         node = Node(
@@ -711,14 +690,16 @@
                     children=,
                     last=root,
                 )
+            pop_visited(obj_id)
         elif _is_attr_object(obj) and not fake_attributes:
+            push_visited(obj_id)
             children = 
             append = children.append
 
             attr_fields = _get_attr_fields(obj)
             if attr_fields:
                 if reached_max_depth:
-                    node = Node(value_repr=f"...")
+                    node = Node(value_repr=f"{obj.__class__.__name__}(...)")
                 else:
                     node = Node(
                         open_brace=f"{obj.__class__.__name__}(",
@@ -758,29 +739,25 @@
                 node = Node(
                     value_repr=f"{obj.__class__.__name__}()", children=, last=root
                 )
-
+            pop_visited(obj_id)
         elif (
             is_dataclass(obj)
             and not _safe_isinstance(obj, type)
             and not fake_attributes
-            and (_is_dataclass_repr(obj) or py_version == (3, 6))
+            and _is_dataclass_repr(obj)
         ):
-            obj_id = id(obj)
-            if obj_id in visited_ids:
-                # Recursion detected
-                return Node(value_repr="...")
             push_visited(obj_id)
-
             children = 
             append = children.append
             if reached_max_depth:
-                node = Node(value_repr=f"...")
+                node = Node(value_repr=f"{obj.__class__.__name__}(...)")
             else:
                 node = Node(
                     open_brace=f"{obj.__class__.__name__}(",
                     close_brace=")",
                     children=children,
                     last=root,
+                    empty=f"{obj.__class__.__name__}()",
                 )
 
                 for last, field in loop_last(
@@ -792,42 +769,43 @@
                     child_node.key_separator = "="
                     append(child_node)
 
-                pop_visited(obj_id)
+            pop_visited(obj_id)
         elif _is_namedtuple(obj) and _has_default_namedtuple_repr(obj):
+            push_visited(obj_id)
+            class_name = obj.__class__.__name__
             if reached_max_depth:
-                node = Node(value_repr="...")
+                # If we've reached the max depth, we still show the class name, but not its contents
+                node = Node(
+                    value_repr=f"{class_name}(...)",
+                )
             else:
                 children = 
-                class_name = obj.__class__.__name__
+                append = children.append
                 node = Node(
                     open_brace=f"{class_name}(",
                     close_brace=")",
                     children=children,
                     empty=f"{class_name}()",
                 )
-                append = children.append
                 for last, (key, value) in loop_last(obj._asdict().items()):
                     child_node = _traverse(value, depth=depth + 1)
                     child_node.key_repr = key
                     child_node.last = last
                     child_node.key_separator = "="
                     append(child_node)
+            pop_visited(obj_id)
         elif _safe_isinstance(obj, _CONTAINERS):
             for container_type in _CONTAINERS:
                 if _safe_isinstance(obj, container_type):
                     obj_type = container_type
                     break
 
-            obj_id = id(obj)
-            if obj_id in visited_ids:
-                # Recursion detected
-                return Node(value_repr="...")
             push_visited(obj_id)
 
             open_brace, close_brace, empty = _BRACESobj_type(obj)
 
             if reached_max_depth:
-                node = Node(value_repr=f"...", last=root)
+                node = Node(value_repr=f"{open_brace}...{close_brace}")
             elif obj_type.__repr__ != type(obj).__repr__:
                 node = Node(value_repr=to_repr(obj), last=root)
             elif obj:
@@ -1007,4 +985,10 @@
 
     from pip._vendor.rich import print
 
-    print(Pretty(data, indent_guides=True, max_string=20))
+    # print(Pretty(data, indent_guides=True, max_string=20))
+
+    class Thing:
+        def __repr__(self) -> str:
+            return "Hello\x1b38;5;239m World!"
+
+    print(Pretty(Thing()))

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/progress.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/progress.py Changed

@@ -4,12 +4,12 @@
 import warnings
 from abc import ABC, abstractmethod
 from collections import deque
-from collections.abc import Sized
 from dataclasses import dataclass, field
 from datetime import timedelta
 from io import RawIOBase, UnsupportedOperation
 from math import ceil
 from mmap import mmap
+from operator import length_hint
 from os import PathLike, stat
 from threading import Event, RLock, Thread
 from types import TracebackType
@@ -129,7 +129,7 @@
         refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
         style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
         complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
-        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.done".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
         pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
         update_period (float, optional): Minimum time (in seconds) between calls to update(). Defaults to 0.1.
         disable (bool, optional): Disable display of progress.
@@ -151,7 +151,7 @@
                 pulse_style=pulse_style,
             ),
             TaskProgressColumn(show_speed=show_speed),
-            TimeRemainingColumn(),
+            TimeRemainingColumn(elapsed_when_finished=True),
         )
     )
     progress = Progress(
@@ -217,6 +217,10 @@
         return self.handle.isatty()
 
     @property
+    def mode(self) -> str:
+        return self.handle.mode
+
+    @property
     def name(self) -> str:
         return self.handle.name
 
@@ -315,7 +319,7 @@
         refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
         style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
         complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
-        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.done".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
         pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
         disable (bool, optional): Disable display of progress.
     Returns:
@@ -440,7 +444,7 @@
         refresh_per_second (float): Number of times per second to refresh the progress information. Defaults to 10.
         style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
         complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
-        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.done".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
         pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
         disable (bool, optional): Disable display of progress.
         encoding (str, optional): The encoding to use when reading in text mode.
@@ -634,7 +638,7 @@
         bar_width (Optionalint, optional): Width of bar or None for full width. Defaults to 40.
         style (StyleType, optional): Style for the bar background. Defaults to "bar.back".
         complete_style (StyleType, optional): Style for the completed bar. Defaults to "bar.complete".
-        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.done".
+        finished_style (StyleType, optional): Style for a finished bar. Defaults to "bar.finished".
         pulse_style (StyleType, optional): Style for pulsing bars. Defaults to "bar.pulse".
     """
 
@@ -673,7 +677,7 @@
     """Renders time elapsed."""
 
     def render(self, task: "Task") -> Text:
-        """Show time remaining."""
+        """Show time elapsed."""
         elapsed = task.finished_time if task.finished else task.elapsed
         if elapsed is None:
             return Text("-:--:--", style="progress.elapsed")
@@ -1193,18 +1197,13 @@
         Returns:
             IterableProgressType: An iterable of values taken from the provided sequence.
         """
-
-        task_total: Optionalfloat = None
         if total is None:
-            if isinstance(sequence, Sized):
-                task_total = float(len(sequence))
-        else:
-            task_total = total
+            total = float(length_hint(sequence)) or None
 
         if task_id is None:
-            task_id = self.add_task(description, total=task_total)
+            task_id = self.add_task(description, total=total)
         else:
-            self.update(task_id, total=task_total)
+            self.update(task_id, total=total)
 
         if self.live.auto_refresh:
             with _TrackThread(self, task_id, update_period) as track_thread:
@@ -1338,7 +1337,7 @@
                 RuntimeWarning,
             )
             buffering = -1
-        elif _mode == "rt" or _mode == "r":
+        elif _mode in ("rt", "r"):
             if buffering == 0:
                 raise ValueError("can't have unbuffered text I/O")
             elif buffering == 1:
@@ -1359,7 +1358,7 @@
         reader = _Reader(handle, self, task_id, close_handle=True)
 
         # wrap the reader in a `TextIOWrapper` if text mode
-        if mode == "r" or mode == "rt":
+        if mode in ("r", "rt"):
             return io.TextIOWrapper(
                 reader,
                 encoding=encoding,

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/progress_bar.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/progress_bar.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/repr.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/repr.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/rule.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/rule.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/scope.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/scope.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/segment.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/segment.py Changed

@@ -119,7 +119,7 @@
 
         cell_size = get_character_cell_size
 
-        pos = int((cut / cell_length) * len(text))
+        pos = int((cut / cell_length) * (len(text) - 1))
 
         before = text:pos
         cell_pos = cell_len(before)
@@ -303,7 +303,7 @@
                         if include_new_lines:
                             cropped_line.append(new_line_segment)
                         yield cropped_line
-                        del line:
+                        line.clear()
             else:
                 append(segment)
         if line:
@@ -365,7 +365,7 @@
             int: The length of the line.
         """
         _cell_len = cell_len
-        return sum(_cell_len(segment.text) for segment in line)
+        return sum(_cell_len(text) for text, style, control in line if not control)
 
     @classmethod
     def get_shape(cls, lines: ListList"Segment") -> Tupleint, int:
@@ -727,7 +727,7 @@
     console.print(Syntax(code, "python", line_numbers=True))
     console.print()
     console.print(
-        "When you call bprint()/b, Rich irenders/i the object in to the the following:\n"
+        "When you call bprint()/b, Rich irenders/i the object in to the following:\n"
     )
     fragments = list(console.render(text))
     console.print(fragments)

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/spinner.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/spinner.py Changed

@@ -11,6 +11,18 @@
 
 
 class Spinner:
+    """A spinner animation.
+
+    Args:
+        name (str): Name of spinner (run python -m rich.spinner).
+        text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "".
+        style (StyleType, optional): Style for spinner animation. Defaults to None.
+        speed (float, optional): Speed factor for animation. Defaults to 1.0.
+
+    Raises:
+        KeyError: If name isn't one of the supported spinner animations.
+    """
+
     def __init__(
         self,
         name: str,
@@ -19,17 +31,6 @@
         style: Optional"StyleType" = None,
         speed: float = 1.0,
     ) -> None:
-        """A spinner animation.
-
-        Args:
-            name (str): Name of spinner (run python -m rich.spinner).
-            text (RenderableType, optional): A renderable to display at the right of the spinner (str or Text typically). Defaults to "".
-            style (StyleType, optional): Style for spinner animation. Defaults to None.
-            speed (float, optional): Speed factor for animation. Defaults to 1.0.
-
-        Raises:
-            KeyError: If name isn't one of the supported spinner animations.
-        """
         try:
             spinner = SPINNERSname
         except KeyError:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/style.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/style.py Changed

@@ -188,8 +188,10 @@
         )
 
         self._link = link
-        self._link_id = f"{randint(0, 999999)}" if link else ""
         self._meta = None if meta is None else dumps(meta)
+        self._link_id = (
+            f"{randint(0, 999999)}{hash(self._meta)}" if (link or meta) else ""
+        )
         self._hash: Optionalint = None
         self._null = not (self._set_attributes or color or bgcolor or link or meta)
 
@@ -237,8 +239,8 @@
         style._set_attributes = 0
         style._attributes = 0
         style._link = None
-        style._link_id = ""
         style._meta = dumps(meta)
+        style._link_id = f"{randint(0, 999999)}{hash(style._meta)}"
         style._hash = None
         style._null = not (meta)
         return style
@@ -643,6 +645,29 @@
         style._meta = self._meta
         return style
 
+    @lru_cache(maxsize=128)
+    def clear_meta_and_links(self) -> "Style":
+        """Get a copy of this style with link and meta information removed.
+
+        Returns:
+            Style: New style object.
+        """
+        if self._null:
+            return NULL_STYLE
+        style: Style = self.__new__(Style)
+        style._ansi = self._ansi
+        style._style_definition = self._style_definition
+        style._color = self._color
+        style._bgcolor = self._bgcolor
+        style._attributes = self._attributes
+        style._set_attributes = self._set_attributes
+        style._link = None
+        style._link_id = ""
+        style._hash = self._hash
+        style._null = False
+        style._meta = None
+        return style
+
     def update_link(self, link: Optionalstr = None) -> "Style":
         """Get a copy with a different value for link.

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/syntax.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/syntax.py Changed

@@ -4,6 +4,7 @@
 import sys
 import textwrap
 from abc import ABC, abstractmethod
+from pathlib import Path
 from typing import (
     Any,
     Dict,
@@ -40,6 +41,7 @@
 from pip._vendor.rich.padding import Padding, PaddingDimensions
 
 from ._loop import loop_first
+from .cells import cell_len
 from .color import Color, blend_rgb
 from .console import Console, ConsoleOptions, JustifyMethod, RenderResult
 from .jupyter import JupyterMixin
@@ -337,8 +339,7 @@
         Returns:
             Syntax: A Syntax object that may be printed to the console
         """
-        with open(path, "rt", encoding=encoding) as code_file:
-            code = code_file.read()
+        code = Path(path).read_text(encoding=encoding)
 
         if not lexer:
             lexer = cls.guess_lexer(path, code=code)
@@ -493,7 +494,10 @@
 
                     # Skip over tokens until line start
                     while line_no < _line_start:
-                        _token_type, token = next(tokens)
+                        try:
+                            _token_type, token = next(tokens)
+                        except StopIteration:
+                            break
                         yield (token, None)
                         if token.endswith("\n"):
                             line_no += 1
@@ -586,11 +590,21 @@
     def __rich_measure__(
         self, console: "Console", options: "ConsoleOptions"
     ) -> "Measurement":
+
         _, right, _, left = Padding.unpack(self.padding)
+        padding = left + right
         if self.code_width is not None:
-            width = self.code_width + self._numbers_column_width + right + left
+            width = self.code_width + self._numbers_column_width + padding + 1
             return Measurement(self._numbers_column_width, width)
-        return Measurement(self._numbers_column_width, options.max_width)
+        lines = self.code.splitlines()
+        width = (
+            self._numbers_column_width
+            + padding
+            + (max(cell_len(line) for line in lines) if lines else 0)
+        )
+        if self.line_numbers:
+            width += 1
+        return Measurement(self._numbers_column_width, width)
 
     def __rich_console__(
         self, console: Console, options: ConsoleOptions
@@ -660,6 +674,8 @@
             line_offset = max(0, start_line - 1)
         lines: UnionListText, Lines = text.split("\n", allow_blank=ends_on_nl)
         if self.line_range:
+            if line_offset > len(lines):
+                return
             lines = linesline_offset:end_line
 
         if self.indent_guides and not options.ascii_only:

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/table.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/table.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/text.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/text.py Changed

@@ -53,11 +53,7 @@
     """Style associated with the span."""
 
     def __repr__(self) -> str:
-        return (
-            f"Span({self.start}, {self.end}, {self.style!r})"
-            if (isinstance(self.style, Style) and self.style._meta)
-            else f"Span({self.start}, {self.end}, {repr(self.style)})"
-        )
+        return f"Span({self.start}, {self.end}, {self.style!r})"
 
     def __bool__(self) -> bool:
         return self.end > self.start
@@ -450,7 +446,6 @@
             style (Unionstr, Style): Style instance or style definition to apply.
             start (int): Start offset (negative indexing is supported). Defaults to 0.
             end (Optionalint, optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
-
         """
         if style:
             length = len(self)
@@ -465,6 +460,32 @@
                 return
             self._spans.append(Span(start, min(length, end), style))
 
+    def stylize_before(
+        self,
+        style: Unionstr, Style,
+        start: int = 0,
+        end: Optionalint = None,
+    ) -> None:
+        """Apply a style to the text, or a portion of the text. Styles will be applied before other styles already present.
+
+        Args:
+            style (Unionstr, Style): Style instance or style definition to apply.
+            start (int): Start offset (negative indexing is supported). Defaults to 0.
+            end (Optionalint, optional): End offset (negative indexing is supported), or None for end of text. Defaults to None.
+        """
+        if style:
+            length = len(self)
+            if start < 0:
+                start = length + start
+            if end is None:
+                end = length
+            if end < 0:
+                end = length + end
+            if start >= length or end <= start:
+                # Span not in text or not valid
+                return
+            self._spans.insert(0, Span(start, min(length, end), style))
+
     def apply_meta(
         self, meta: Dictstr, Any, start: int = 0, end: Optionalint = None
     ) -> None:
@@ -1179,7 +1200,7 @@
             width (int): Maximum characters in a line.
 
         Returns:
-            Lines: List of lines.
+            Lines: Lines container.
         """
         lines: Lines = Lines()
         append = lines.append

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/theme.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/theme.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/rich/traceback.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/rich/traceback.py Changed

@@ -1,12 +1,24 @@
 from __future__ import absolute_import
 
+import linecache
 import os
 import platform
 import sys
 from dataclasses import dataclass, field
 from traceback import walk_tb
 from types import ModuleType, TracebackType
-from typing import Any, Callable, Dict, Iterable, List, Optional, Sequence, Type, Union
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    Union,
+)
 
 from pip._vendor.pygments.lexers import guess_lexer_for_filename
 from pip._vendor.pygments.token import Comment, Keyword, Name, Number, Operator, String
@@ -41,6 +53,10 @@
     theme: Optionalstr = None,
     word_wrap: bool = False,
     show_locals: bool = False,
+    locals_max_length: int = LOCALS_MAX_LENGTH,
+    locals_max_string: int = LOCALS_MAX_STRING,
+    locals_hide_dunder: bool = True,
+    locals_hide_sunder: Optionalbool = None,
     indent_guides: bool = True,
     suppress: IterableUnionstr, ModuleType = (),
     max_frames: int = 100,
@@ -58,6 +74,11 @@
             a theme appropriate for the platform.
         word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False.
         show_locals (bool, optional): Enable display of local variables. Defaults to False.
+        locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
+            Defaults to 10.
+        locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+        locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
         indent_guides (bool, optional): Enable indent guides in code and locals. Defaults to True.
         suppress (SequenceUnionstr, ModuleType): Optional sequence of modules or paths to exclude from traceback.
 
@@ -65,7 +86,13 @@
         Callable: The previous exception handler that was replaced.
 
     """
-    traceback_console = Console(file=sys.stderr) if console is None else console
+    traceback_console = Console(stderr=True) if console is None else console
+
+    locals_hide_sunder = (
+        True
+        if (traceback_console.is_jupyter and locals_hide_sunder is None)
+        else locals_hide_sunder
+    )
 
     def excepthook(
         type_: TypeBaseException,
@@ -82,6 +109,10 @@
                 theme=theme,
                 word_wrap=word_wrap,
                 show_locals=show_locals,
+                locals_max_length=locals_max_length,
+                locals_max_string=locals_max_string,
+                locals_hide_dunder=locals_hide_dunder,
+                locals_hide_sunder=bool(locals_hide_sunder),
                 indent_guides=indent_guides,
                 suppress=suppress,
                 max_frames=max_frames,
@@ -192,6 +223,8 @@
         locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
             Defaults to 10.
         locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+        locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+        locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
         suppress (SequenceUnionstr, ModuleType): Optional sequence of modules or paths to exclude from traceback.
         max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
 
@@ -208,14 +241,17 @@
     def __init__(
         self,
         trace: OptionalTrace = None,
+        *,
         width: Optionalint = 100,
         extra_lines: int = 3,
         theme: Optionalstr = None,
         word_wrap: bool = False,
         show_locals: bool = False,
-        indent_guides: bool = True,
         locals_max_length: int = LOCALS_MAX_LENGTH,
         locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+        indent_guides: bool = True,
         suppress: IterableUnionstr, ModuleType = (),
         max_frames: int = 100,
     ):
@@ -237,6 +273,8 @@
         self.indent_guides = indent_guides
         self.locals_max_length = locals_max_length
         self.locals_max_string = locals_max_string
+        self.locals_hide_dunder = locals_hide_dunder
+        self.locals_hide_sunder = locals_hide_sunder
 
         self.suppress: Sequencestr = 
         for suppress_entity in suppress:
@@ -257,14 +295,17 @@
         exc_type: TypeAny,
         exc_value: BaseException,
         traceback: OptionalTracebackType,
+        *,
         width: Optionalint = 100,
         extra_lines: int = 3,
         theme: Optionalstr = None,
         word_wrap: bool = False,
         show_locals: bool = False,
-        indent_guides: bool = True,
         locals_max_length: int = LOCALS_MAX_LENGTH,
         locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
+        indent_guides: bool = True,
         suppress: IterableUnionstr, ModuleType = (),
         max_frames: int = 100,
     ) -> "Traceback":
@@ -283,6 +324,8 @@
             locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
                 Defaults to 10.
             locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+            locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
             suppress (IterableUnionstr, ModuleType): Optional sequence of modules or paths to exclude from traceback.
             max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100.
 
@@ -290,8 +333,16 @@
             Traceback: A Traceback instance that may be printed.
         """
         rich_traceback = cls.extract(
-            exc_type, exc_value, traceback, show_locals=show_locals
+            exc_type,
+            exc_value,
+            traceback,
+            show_locals=show_locals,
+            locals_max_length=locals_max_length,
+            locals_max_string=locals_max_string,
+            locals_hide_dunder=locals_hide_dunder,
+            locals_hide_sunder=locals_hide_sunder,
         )
+
         return cls(
             rich_traceback,
             width=width,
@@ -302,6 +353,8 @@
             indent_guides=indent_guides,
             locals_max_length=locals_max_length,
             locals_max_string=locals_max_string,
+            locals_hide_dunder=locals_hide_dunder,
+            locals_hide_sunder=locals_hide_sunder,
             suppress=suppress,
             max_frames=max_frames,
         )
@@ -312,9 +365,12 @@
         exc_type: TypeBaseException,
         exc_value: BaseException,
         traceback: OptionalTracebackType,
+        *,
         show_locals: bool = False,
         locals_max_length: int = LOCALS_MAX_LENGTH,
         locals_max_string: int = LOCALS_MAX_STRING,
+        locals_hide_dunder: bool = True,
+        locals_hide_sunder: bool = False,
     ) -> Trace:
         """Extract traceback information.
 
@@ -326,6 +382,8 @@
             locals_max_length (int, optional): Maximum length of containers before abbreviating, or None for no abbreviation.
                 Defaults to 10.
             locals_max_string (int, optional): Maximum length of string before truncating, or None to disable. Defaults to 80.
+            locals_hide_dunder (bool, optional): Hide locals prefixed with double underscore. Defaults to True.
+            locals_hide_sunder (bool, optional): Hide locals prefixed with single underscore. Defaults to False.
 
         Returns:
             Trace: A Trace instance which you can use to construct a `Traceback`.
@@ -337,7 +395,7 @@
         from pip._vendor.rich import _IMPORT_CWD
 
         def safe_str(_object: Any) -> str:
-            """Don't allow exceptions from __str__ to propegate."""
+            """Don't allow exceptions from __str__ to propagate."""
             try:
                 return str(_object)
             except Exception:
@@ -362,6 +420,20 @@
             stacks.append(stack)
             append = stack.frames.append
 
+            def get_locals(
+                iter_locals: IterableTuplestr, object
+            ) -> IterableTuplestr, object:
+                """Extract locals from an iterator of key pairs."""
+                if not (locals_hide_dunder or locals_hide_sunder):
+                    yield from iter_locals
+                    return
+                for key, value in iter_locals:
+                    if locals_hide_dunder and key.startswith("__"):
+                        continue
+                    if locals_hide_sunder and key.startswith("_"):
+                        continue
+                    yield key, value
+
             for frame_summary, line_no in walk_tb(traceback):
                 filename = frame_summary.f_code.co_filename
                 if filename and not filename.startswith("<"):
@@ -369,6 +441,7 @@
                         filename = os.path.join(_IMPORT_CWD, filename)
                 if frame_summary.f_locals.get("_rich_traceback_omit", False):
                     continue
+
                 frame = Frame(
                     filename=filename or "?",
                     lineno=line_no,
@@ -379,7 +452,7 @@
                             max_length=locals_max_length,
                             max_string=locals_max_string,
                         )
-                        for key, value in frame_summary.f_locals.items()
+                        for key, value in get_locals(frame_summary.f_locals.items())
                     }
                     if show_locals
                     else None,
@@ -389,19 +462,17 @@
                     del stack.frames:
 
             cause = getattr(exc_value, "__cause__", None)
-            if cause and cause.__traceback__:
+            if cause:
                 exc_type = cause.__class__
                 exc_value = cause
+                # __traceback__ can be None, e.g. for exceptions raised by the
+                # 'multiprocessing' module
                 traceback = cause.__traceback__
                 is_cause = True
                 continue
 
             cause = exc_value.__context__
-            if (
-                cause
-                and cause.__traceback__
-                and not getattr(exc_value, "__suppress_context__", False)
-            ):
+            if cause and not getattr(exc_value, "__suppress_context__", False):
                 exc_type = cause.__class__
                 exc_value = cause
                 traceback = cause.__traceback__
@@ -496,13 +567,14 @@
         highlighter = ReprHighlighter()
         path_highlighter = PathHighlighter()
         if syntax_error.filename != "<stdin>":
-            text = Text.assemble(
-                (f" {syntax_error.filename}", "pygments.string"),
-                (":", "pygments.text"),
-                (str(syntax_error.lineno), "pygments.number"),
-                style="pygments.text",
-            )
-            yield path_highlighter(text)
+            if os.path.exists(syntax_error.filename):
+                text = Text.assemble(
+                    (f" {syntax_error.filename}", "pygments.string"),
+                    (":", "pygments.text"),
+                    (str(syntax_error.lineno), "pygments.number"),
+                    style="pygments.text",
+                )
+                yield path_highlighter(text)
         syntax_error_text = highlighter(syntax_error.line.rstrip())
         syntax_error_text.no_wrap = True
         offset = min(syntax_error.offset - 1, len(syntax_error_text))
@@ -533,7 +605,6 @@
     def _render_stack(self, stack: Stack) -> RenderResult:
         path_highlighter = PathHighlighter()
         theme = self.theme
-        code_cache: Dictstr, str = {}
 
         def read_code(filename: str) -> str:
             """Read files, and cache results on filename.
@@ -544,14 +615,7 @@
             Returns:
                 str: Contents of file
             """
-            code = code_cache.get(filename)
-            if code is None:
-                with open(
-                    filename, "rt", encoding="utf-8", errors="replace"
-                ) as code_file:
-                    code = code_file.read()
-                code_cachefilename = code
-            return code
+            return "".join(linecache.getlines(filename))
 
         def render_locals(frame: Frame) -> IterableConsoleRenderable:
             if frame.locals:
@@ -590,14 +654,23 @@
             frame_filename = frame.filename
             suppressed = any(frame_filename.startswith(path) for path in self.suppress)
 
-            text = Text.assemble(
-                path_highlighter(Text(frame.filename, style="pygments.string")),
-                (":", "pygments.text"),
-                (str(frame.lineno), "pygments.number"),
-                " in ",
-                (frame.name, "pygments.function"),
-                style="pygments.text",
-            )
+            if os.path.exists(frame.filename):
+                text = Text.assemble(
+                    path_highlighter(Text(frame.filename, style="pygments.string")),
+                    (":", "pygments.text"),
+                    (str(frame.lineno), "pygments.number"),
+                    " in ",
+                    (frame.name, "pygments.function"),
+                    style="pygments.text",
+                )
+            else:
+                text = Text.assemble(
+                    "in ",
+                    (frame.name, "pygments.function"),
+                    (":", "pygments.text"),
+                    (str(frame.lineno), "pygments.number"),
+                    style="pygments.text",
+                )
             if not frame.filename.startswith("<") and not first:
                 yield ""
             yield text
@@ -607,6 +680,10 @@
             if not suppressed:
                 try:
                     code = read_code(frame.filename)
+                    if not code:
+                        # code may be an empty string if the file doesn't exist, OR
+                        # if the traceback filename is generated dynamically
+                        continue
                     lexer_name = self._guess_lexer(frame.filename, code)
                     syntax = Syntax(
                         code,

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/six Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/six/__init__.pyi Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/six/moves Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/six/moves/__init__.pyi Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/six/moves/configparser.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/__init__.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/__init__.py Changed

@@ -16,6 +16,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 import functools
 import sys
 import threading
@@ -88,51 +89,13 @@
 if t.TYPE_CHECKING:
     import types
 
-    from .wait import wait_base
-    from .stop import stop_base
-
-
-WrappedFn = t.TypeVar("WrappedFn", bound=t.Callable)
-_RetValT = t.TypeVar("_RetValT")
-
-
-@t.overload
-def retry(fn: WrappedFn) -> WrappedFn:
-    pass
-
-
-@t.overload
-def retry(*dargs: t.Any, **dkw: t.Any) -> t.CallableWrappedFn, WrappedFn:  # noqa
-    pass
-
-
-def retry(*dargs: t.Any, **dkw: t.Any) -> t.UnionWrappedFn, t.CallableWrappedFn, WrappedFn:  # noqa
-    """Wrap a function with a new `Retrying` object.
-
-    :param dargs: positional arguments passed to Retrying object
-    :param dkw: keyword arguments passed to the Retrying object
-    """
-    # support both @retry and @retry() as valid syntax
-    if len(dargs) == 1 and callable(dargs0):
-        return retry()(dargs0)
-    else:
-
-        def wrap(f: WrappedFn) -> WrappedFn:
-            if isinstance(f, retry_base):
-                warnings.warn(
-                    f"Got retry_base instance ({f.__class__.__name__}) as callable argument, "
-                    f"this will probably hang indefinitely (did you mean retry={f.__class__.__name__}(...)?)"
-                )
-            if iscoroutinefunction(f):
-                r: "BaseRetrying" = AsyncRetrying(*dargs, **dkw)
-            elif tornado and hasattr(tornado.gen, "is_coroutine_function") and tornado.gen.is_coroutine_function(f):
-                r = TornadoRetrying(*dargs, **dkw)
-            else:
-                r = Retrying(*dargs, **dkw)
+    from .retry import RetryBaseT
+    from .stop import StopBaseT
+    from .wait import WaitBaseT
 
-            return r.wraps(f)
 
-        return wrap
+WrappedFnReturnT = t.TypeVar("WrappedFnReturnT")
+WrappedFn = t.TypeVar("WrappedFn", bound=t.Callable..., t.Any)
 
 
 class TryAgain(Exception):
@@ -216,7 +179,7 @@
         exc_value: t.OptionalBaseException,
         traceback: t.Optional"types.TracebackType",
     ) -> t.Optionalbool:
-        if isinstance(exc_value, BaseException):
+        if exc_type is not None and exc_value is not None:
             self.retry_state.set_exception((exc_type, exc_value, traceback))
             return True  # Swallow exception.
         else:
@@ -229,9 +192,9 @@
     def __init__(
         self,
         sleep: t.Callablet.Unionint, float, None = sleep,
-        stop: "stop_base" = stop_never,
-        wait: "wait_base" = wait_none(),
-        retry: retry_base = retry_if_exception_type(),
+        stop: "StopBaseT" = stop_never,
+        wait: "WaitBaseT" = wait_none(),
+        retry: "RetryBaseT" = retry_if_exception_type(),
         before: t.Callable"RetryCallState", None = before_nothing,
         after: t.Callable"RetryCallState", None = after_nothing,
         before_sleep: t.Optionalt.Callable"RetryCallState", None = None,
@@ -254,8 +217,8 @@
     def copy(
         self,
         sleep: t.Uniont.Callablet.Unionint, float, None, object = _unset,
-        stop: t.Union"stop_base", object = _unset,
-        wait: t.Union"wait_base", object = _unset,
+        stop: t.Union"StopBaseT", object = _unset,
+        wait: t.Union"WaitBaseT", object = _unset,
         retry: t.Unionretry_base, object = _unset,
         before: t.Uniont.Callable"RetryCallState", None, object = _unset,
         after: t.Uniont.Callable"RetryCallState", None, object = _unset,
@@ -312,9 +275,9 @@
                   statistics from each thread).
         """
         try:
-            return self._local.statistics
+            return self._local.statistics  # type: ignoreno-any-return
         except AttributeError:
-            self._local.statistics = {}
+            self._local.statistics = t.cast(t.Dictstr, t.Any, {})
             return self._local.statistics
 
     def wraps(self, f: WrappedFn) -> WrappedFn:
@@ -330,10 +293,10 @@
         def retry_with(*args: t.Any, **kwargs: t.Any) -> WrappedFn:
             return self.copy(*args, **kwargs).wraps(f)
 
-        wrapped_f.retry = self
-        wrapped_f.retry_with = retry_with
+        wrapped_f.retry = self  # type: ignoreattr-defined
+        wrapped_f.retry_with = retry_with  # type: ignoreattr-defined
 
-        return wrapped_f
+        return wrapped_f  # type: ignorereturn-value
 
     def begin(self) -> None:
         self.statistics.clear()
@@ -348,15 +311,15 @@
                 self.before(retry_state)
             return DoAttempt()
 
-        is_explicit_retry = retry_state.outcome.failed and isinstance(retry_state.outcome.exception(), TryAgain)
-        if not (is_explicit_retry or self.retry(retry_state=retry_state)):
+        is_explicit_retry = fut.failed and isinstance(fut.exception(), TryAgain)
+        if not (is_explicit_retry or self.retry(retry_state)):
             return fut.result()
 
         if self.after is not None:
             self.after(retry_state)
 
         self.statistics"delay_since_first_attempt" = retry_state.seconds_since_start
-        if self.stop(retry_state=retry_state):
+        if self.stop(retry_state):
             if self.retry_error_callback:
                 return self.retry_error_callback(retry_state)
             retry_exc = self.retry_error_cls(fut)
@@ -365,7 +328,7 @@
             raise retry_exc from fut.exception()
 
         if self.wait:
-            sleep = self.wait(retry_state=retry_state)
+            sleep = self.wait(retry_state)
         else:
             sleep = 0.0
         retry_state.next_action = RetryAction(sleep)
@@ -393,14 +356,24 @@
                 break
 
     @abstractmethod
-    def __call__(self, fn: t.Callable..., _RetValT, *args: t.Any, **kwargs: t.Any) -> _RetValT:
+    def __call__(
+        self,
+        fn: t.Callable..., WrappedFnReturnT,
+        *args: t.Any,
+        **kwargs: t.Any,
+    ) -> WrappedFnReturnT:
         pass
 
 
 class Retrying(BaseRetrying):
     """Retrying controller."""
 
-    def __call__(self, fn: t.Callable..., _RetValT, *args: t.Any, **kwargs: t.Any) -> _RetValT:
+    def __call__(
+        self,
+        fn: t.Callable..., WrappedFnReturnT,
+        *args: t.Any,
+        **kwargs: t.Any,
+    ) -> WrappedFnReturnT:
         self.begin()
 
         retry_state = RetryCallState(retry_object=self, fn=fn, args=args, kwargs=kwargs)
@@ -410,17 +383,23 @@
                 try:
                     result = fn(*args, **kwargs)
                 except BaseException:  # noqa: B902
-                    retry_state.set_exception(sys.exc_info())
+                    retry_state.set_exception(sys.exc_info())  # type: ignorearg-type
                 else:
                     retry_state.set_result(result)
             elif isinstance(do, DoSleep):
                 retry_state.prepare_for_next_attempt()
                 self.sleep(do)
             else:
-                return do
+                return do  # type: ignoreno-any-return
+
+
+if sys.version_info1 >= 9:
+    FutureGenericT = futures.Futuret.Any
+else:
+    FutureGenericT = futures.Future
 
 
-class Future(futures.Future):
+class Future(FutureGenericT):
     """Encapsulates a (future or past) attempted call to a target function."""
 
     def __init__(self, attempt_number: int) -> None:
@@ -493,13 +472,15 @@
         fut.set_result(val)
         self.outcome, self.outcome_timestamp = fut, ts
 
-    def set_exception(self, exc_info: t.Tuplet.TypeBaseException, BaseException, "types.TracebackType") -> None:
+    def set_exception(
+        self, exc_info: t.Tuplet.TypeBaseException, BaseException, "types.TracebackType| None"
+    ) -> None:
         ts = time.monotonic()
         fut = Future(self.attempt_number)
         fut.set_exception(exc_info1)
         self.outcome, self.outcome_timestamp = fut, ts
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         if self.outcome is None:
             result = "none yet"
         elif self.outcome.failed:
@@ -513,7 +494,115 @@
         return f"<{clsname} {id(self)}: attempt #{self.attempt_number}; slept for {slept}; last result: {result}>"
 
 
+@t.overload
+def retry(func: WrappedFn) -> WrappedFn:
+    ...
+
+
+@t.overload
+def retry(
+    sleep: t.Callablet.Unionint, float, None = sleep,
+    stop: "StopBaseT" = stop_never,
+    wait: "WaitBaseT" = wait_none(),
+    retry: "RetryBaseT" = retry_if_exception_type(),
+    before: t.Callable"RetryCallState", None = before_nothing,
+    after: t.Callable"RetryCallState", None = after_nothing,
+    before_sleep: t.Optionalt.Callable"RetryCallState", None = None,
+    reraise: bool = False,
+    retry_error_cls: t.Type"RetryError" = RetryError,
+    retry_error_callback: t.Optionalt.Callable"RetryCallState", t.Any = None,
+) -> t.CallableWrappedFn, WrappedFn:
+    ...
+
+
+def retry(*dargs: t.Any, **dkw: t.Any) -> t.Any:
+    """Wrap a function with a new `Retrying` object.
+
+    :param dargs: positional arguments passed to Retrying object
+    :param dkw: keyword arguments passed to the Retrying object
+    """
+    # support both @retry and @retry() as valid syntax
+    if len(dargs) == 1 and callable(dargs0):
+        return retry()(dargs0)
+    else:
+
+        def wrap(f: WrappedFn) -> WrappedFn:
+            if isinstance(f, retry_base):
+                warnings.warn(
+                    f"Got retry_base instance ({f.__class__.__name__}) as callable argument, "
+                    f"this will probably hang indefinitely (did you mean retry={f.__class__.__name__}(...)?)"
+                )
+            r: "BaseRetrying"
+            if iscoroutinefunction(f):
+                r = AsyncRetrying(*dargs, **dkw)
+            elif tornado and hasattr(tornado.gen, "is_coroutine_function") and tornado.gen.is_coroutine_function(f):
+                r = TornadoRetrying(*dargs, **dkw)
+            else:
+                r = Retrying(*dargs, **dkw)
+
+            return r.wraps(f)
+
+        return wrap
+
+
 from pip._vendor.tenacity._asyncio import AsyncRetrying  # noqa:E402,I100
 
 if tornado:
     from pip._vendor.tenacity.tornadoweb import TornadoRetrying
+
+
+__all__ = 
+    "retry_base",
+    "retry_all",
+    "retry_always",
+    "retry_any",
+    "retry_if_exception",
+    "retry_if_exception_type",
+    "retry_if_exception_cause_type",
+    "retry_if_not_exception_type",
+    "retry_if_not_result",
+    "retry_if_result",
+    "retry_never",
+    "retry_unless_exception_type",
+    "retry_if_exception_message",
+    "retry_if_not_exception_message",
+    "sleep",
+    "sleep_using_event",
+    "stop_after_attempt",
+    "stop_after_delay",
+    "stop_all",
+    "stop_any",
+    "stop_never",
+    "stop_when_event_set",
+    "wait_chain",
+    "wait_combine",
+    "wait_exponential",
+    "wait_fixed",
+    "wait_incrementing",
+    "wait_none",
+    "wait_random",
+    "wait_random_exponential",
+    "wait_full_jitter",
+    "wait_exponential_jitter",
+    "before_log",
+    "before_nothing",
+    "after_log",
+    "after_nothing",
+    "before_sleep_log",
+    "before_sleep_nothing",
+    "retry",
+    "WrappedFn",
+    "TryAgain",
+    "NO_RESULT",
+    "DoAttempt",
+    "DoSleep",
+    "BaseAction",
+    "RetryAction",
+    "RetryError",
+    "AttemptManager",
+    "BaseRetrying",
+    "Retrying",
+    "Future",
+    "RetryCallState",
+    "AsyncRetrying",
+

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/_asyncio.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/_asyncio.py Changed

@@ -17,7 +17,7 @@
 
 import functools
 import sys
-import typing
+import typing as t
 from asyncio import sleep
 
 from pip._vendor.tenacity import AttemptManager
@@ -26,21 +26,20 @@
 from pip._vendor.tenacity import DoSleep
 from pip._vendor.tenacity import RetryCallState
 
-WrappedFn = typing.TypeVar("WrappedFn", bound=typing.Callable)
-_RetValT = typing.TypeVar("_RetValT")
+WrappedFnReturnT = t.TypeVar("WrappedFnReturnT")
+WrappedFn = t.TypeVar("WrappedFn", bound=t.Callable..., t.Awaitablet.Any)
 
 
 class AsyncRetrying(BaseRetrying):
-    def __init__(self, sleep: typing.Callablefloat, typing.Awaitable = sleep, **kwargs: typing.Any) -> None:
+    sleep: t.Callablefloat, t.Awaitablet.Any
+
+    def __init__(self, sleep: t.Callablefloat, t.Awaitablet.Any = sleep, **kwargs: t.Any) -> None:
         super().__init__(**kwargs)
         self.sleep = sleep
 
-    async def __call__(  # type: ignore  # Change signature from supertype
-        self,
-        fn: typing.Callable..., typing.Awaitable_RetValT,
-        *args: typing.Any,
-        **kwargs: typing.Any,
-    ) -> _RetValT:
+    async def __call__(  # type: ignoreoverride
+        self, fn: WrappedFn, *args: t.Any, **kwargs: t.Any
+    ) -> WrappedFnReturnT:
         self.begin()
 
         retry_state = RetryCallState(retry_object=self, fn=fn, args=args, kwargs=kwargs)
@@ -50,21 +49,24 @@
                 try:
                     result = await fn(*args, **kwargs)
                 except BaseException:  # noqa: B902
-                    retry_state.set_exception(sys.exc_info())
+                    retry_state.set_exception(sys.exc_info())  # type: ignorearg-type
                 else:
                     retry_state.set_result(result)
             elif isinstance(do, DoSleep):
                 retry_state.prepare_for_next_attempt()
                 await self.sleep(do)
             else:
-                return do
+                return do  # type: ignoreno-any-return
+
+    def __iter__(self) -> t.GeneratorAttemptManager, None, None:
+        raise TypeError("AsyncRetrying object is not iterable")
 
     def __aiter__(self) -> "AsyncRetrying":
         self.begin()
         self._retry_state = RetryCallState(self, fn=None, args=(), kwargs={})
         return self
 
-    async def __anext__(self) -> typing.UnionAttemptManager, typing.Any:
+    async def __anext__(self) -> AttemptManager:
         while True:
             do = self.iter(retry_state=self._retry_state)
             if do is None:
@@ -75,18 +77,18 @@
                 self._retry_state.prepare_for_next_attempt()
                 await self.sleep(do)
             else:
-                return do
+                raise StopAsyncIteration
 
     def wraps(self, fn: WrappedFn) -> WrappedFn:
         fn = super().wraps(fn)
         # Ensure wrapper is recognized as a coroutine function.
 
         @functools.wraps(fn)
-        async def async_wrapped(*args: typing.Any, **kwargs: typing.Any) -> typing.Any:
+        async def async_wrapped(*args: t.Any, **kwargs: t.Any) -> t.Any:
             return await fn(*args, **kwargs)
 
         # Preserve attributes
-        async_wrapped.retry = fn.retry
-        async_wrapped.retry_with = fn.retry_with
+        async_wrapped.retry = fn.retry  # type: ignoreattr-defined
+        async_wrapped.retry_with = fn.retry_with  # type: ignoreattr-defined
 
-        return async_wrapped
+        return async_wrapped  # type: ignorereturn-value

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/_utils.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/_utils.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/after.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/after.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/before.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/before.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/before_sleep.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/before_sleep.py Changed

@@ -36,6 +36,14 @@
     """Before call strategy that logs to some logger the attempt."""
 
     def log_it(retry_state: "RetryCallState") -> None:
+        local_exc_info: BaseException | bool | None
+
+        if retry_state.outcome is None:
+            raise RuntimeError("log_it() called before outcome was set")
+
+        if retry_state.next_action is None:
+            raise RuntimeError("log_it() called before next_action was set")
+
         if retry_state.outcome.failed:
             ex = retry_state.outcome.exception()
             verb, value = "raised", f"{ex.__class__.__name__}: {ex}"
@@ -48,10 +56,15 @@
             verb, value = "returned", retry_state.outcome.result()
             local_exc_info = False  # exc_info does not apply when no exception
 
+        if retry_state.fn is None:
+            # NOTE(sileht): can't really happen, but we must please mypy
+            fn_name = "<unknown>"
+        else:
+            fn_name = _utils.get_callback_name(retry_state.fn)
+
         logger.log(
             log_level,
-            f"Retrying {_utils.get_callback_name(retry_state.fn)} "
-            f"in {retry_state.next_action.sleep} seconds as it {verb} {value}.",
+            f"Retrying {fn_name} " f"in {retry_state.next_action.sleep} seconds as it {verb} {value}.",
             exc_info=local_exc_info,
         )

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/retry.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/retry.py Changed

@@ -36,6 +36,9 @@
         return retry_any(self, other)
 
 
+RetryBaseT = typing.Unionretry_base, typing.Callable"RetryCallState", bool
+
+
 class _retry_never(retry_base):
     """Retry strategy that never rejects any result."""
 
@@ -63,8 +66,14 @@
         self.predicate = predicate
 
     def __call__(self, retry_state: "RetryCallState") -> bool:
+        if retry_state.outcome is None:
+            raise RuntimeError("__call__() called before outcome was set")
+
         if retry_state.outcome.failed:
-            return self.predicate(retry_state.outcome.exception())
+            exception = retry_state.outcome.exception()
+            if exception is None:
+                raise RuntimeError("outcome failed but the exception is None")
+            return self.predicate(exception)
         else:
             return False
 
@@ -111,10 +120,17 @@
         super().__init__(lambda e: not isinstance(e, exception_types))
 
     def __call__(self, retry_state: "RetryCallState") -> bool:
+        if retry_state.outcome is None:
+            raise RuntimeError("__call__() called before outcome was set")
+
         # always retry if no exception was raised
         if not retry_state.outcome.failed:
             return True
-        return self.predicate(retry_state.outcome.exception())
+
+        exception = retry_state.outcome.exception()
+        if exception is None:
+            raise RuntimeError("outcome failed but the exception is None")
+        return self.predicate(exception)
 
 
 class retry_if_exception_cause_type(retry_base):
@@ -134,6 +150,9 @@
         self.exception_cause_types = exception_types
 
     def __call__(self, retry_state: "RetryCallState") -> bool:
+        if retry_state.outcome is None:
+            raise RuntimeError("__call__ called before outcome was set")
+
         if retry_state.outcome.failed:
             exc = retry_state.outcome.exception()
             while exc is not None:
@@ -151,6 +170,9 @@
         self.predicate = predicate
 
     def __call__(self, retry_state: "RetryCallState") -> bool:
+        if retry_state.outcome is None:
+            raise RuntimeError("__call__() called before outcome was set")
+
         if not retry_state.outcome.failed:
             return self.predicate(retry_state.outcome.result())
         else:
@@ -164,6 +186,9 @@
         self.predicate = predicate
 
     def __call__(self, retry_state: "RetryCallState") -> bool:
+        if retry_state.outcome is None:
+            raise RuntimeError("__call__() called before outcome was set")
+
         if not retry_state.outcome.failed:
             return not self.predicate(retry_state.outcome.result())
         else:
@@ -215,9 +240,16 @@
         self.predicate = lambda *args_, **kwargs_: not if_predicate(*args_, **kwargs_)
 
     def __call__(self, retry_state: "RetryCallState") -> bool:
+        if retry_state.outcome is None:
+            raise RuntimeError("__call__() called before outcome was set")
+
         if not retry_state.outcome.failed:
             return True
-        return self.predicate(retry_state.outcome.exception())
+
+        exception = retry_state.outcome.exception()
+        if exception is None:
+            raise RuntimeError("outcome failed but the exception is None")
+        return self.predicate(exception)
 
 
 class retry_any(retry_base):

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/stop.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/stop.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/tornadoweb.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/tornadoweb.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/tenacity/wait.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/tenacity/wait.py Changed

@@ -17,19 +17,12 @@
 import abc
 import random
 import typing
-from datetime import timedelta
 
 from pip._vendor.tenacity import _utils
 
 if typing.TYPE_CHECKING:
     from pip._vendor.tenacity import RetryCallState
 
-wait_unit_type = typing.Unionint, float, timedelta
-
-
-def to_seconds(wait_unit: wait_unit_type) -> float:
-    return float(wait_unit.total_seconds() if isinstance(wait_unit, timedelta) else wait_unit)
-
 
 class wait_base(abc.ABC):
     """Abstract base class for wait strategies."""
@@ -43,16 +36,19 @@
 
     def __radd__(self, other: "wait_base") -> typing.Union"wait_combine", "wait_base":
         # make it possible to use multiple waits with the built-in sum function
-        if other == 0:
+        if other == 0:  # type: ignorecomparison-overlap
             return self
         return self.__add__(other)
 
 
+WaitBaseT = typing.Unionwait_base, typing.Callable"RetryCallState", typing.Unionfloat, int
+
+
 class wait_fixed(wait_base):
     """Wait strategy that waits a fixed amount of time between each retry."""
 
-    def __init__(self, wait: wait_unit_type) -> None:
-        self.wait_fixed = to_seconds(wait)
+    def __init__(self, wait: _utils.time_unit_type) -> None:
+        self.wait_fixed = _utils.to_seconds(wait)
 
     def __call__(self, retry_state: "RetryCallState") -> float:
         return self.wait_fixed
@@ -68,9 +64,9 @@
 class wait_random(wait_base):
     """Wait strategy that waits a random amount of time between min/max."""
 
-    def __init__(self, min: wait_unit_type = 0, max: wait_unit_type = 1) -> None:  # noqa
-        self.wait_random_min = to_seconds(min)
-        self.wait_random_max = to_seconds(max)
+    def __init__(self, min: _utils.time_unit_type = 0, max: _utils.time_unit_type = 1) -> None:  # noqa
+        self.wait_random_min = _utils.to_seconds(min)
+        self.wait_random_max = _utils.to_seconds(max)
 
     def __call__(self, retry_state: "RetryCallState") -> float:
         return self.wait_random_min + (random.random() * (self.wait_random_max - self.wait_random_min))
@@ -120,13 +116,13 @@
 
     def __init__(
         self,
-        start: wait_unit_type = 0,
-        increment: wait_unit_type = 100,
-        max: wait_unit_type = _utils.MAX_WAIT,  # noqa
+        start: _utils.time_unit_type = 0,
+        increment: _utils.time_unit_type = 100,
+        max: _utils.time_unit_type = _utils.MAX_WAIT,  # noqa
     ) -> None:
-        self.start = to_seconds(start)
-        self.increment = to_seconds(increment)
-        self.max = to_seconds(max)
+        self.start = _utils.to_seconds(start)
+        self.increment = _utils.to_seconds(increment)
+        self.max = _utils.to_seconds(max)
 
     def __call__(self, retry_state: "RetryCallState") -> float:
         result = self.start + (self.increment * (retry_state.attempt_number - 1))
@@ -149,13 +145,13 @@
     def __init__(
         self,
         multiplier: typing.Unionint, float = 1,
-        max: wait_unit_type = _utils.MAX_WAIT,  # noqa
+        max: _utils.time_unit_type = _utils.MAX_WAIT,  # noqa
         exp_base: typing.Unionint, float = 2,
-        min: wait_unit_type = 0,  # noqa
+        min: _utils.time_unit_type = 0,  # noqa
     ) -> None:
         self.multiplier = multiplier
-        self.min = to_seconds(min)
-        self.max = to_seconds(max)
+        self.min = _utils.to_seconds(min)
+        self.max = _utils.to_seconds(max)
         self.exp_base = exp_base
 
     def __call__(self, retry_state: "RetryCallState") -> float:
@@ -206,7 +202,7 @@
     This implements the strategy described here:
     https://cloud.google.com/storage/docs/retry-strategy
 
-    The wait time is min(initial * (2**n + random.uniform(0, jitter)), maximum)
+    The wait time is min(initial * 2**n + random.uniform(0, jitter), maximum)
     where n is the retry count.
     """

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/typing_extensions.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/typing_extensions.py Changed

@@ -2,10 +2,12 @@
 import collections
 import collections.abc
 import functools
+import inspect
 import operator
 import sys
 import types as _types
 import typing
+import warnings
 
 
 __all__ = 
@@ -51,6 +53,7 @@
     'assert_type',
     'clear_overloads',
     'dataclass_transform',
+    'deprecated',
     'get_overloads',
     'final',
     'get_args',
@@ -728,6 +731,8 @@
     _typeddict_new.__text_signature__ = ('($cls, _typename, _fields=None,'
                                          ' /, *, total=True, **kwargs)')
 
+    _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters
+
     class _TypedDictMeta(type):
         def __init__(cls, name, bases, ns, total=True):
             super().__init__(name, bases, ns)
@@ -753,8 +758,10 @@
             annotations = {}
             own_annotations = ns.get('__annotations__', {})
             msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
+            kwds = {"module": tp_dict.__module__} if _TAKES_MODULE else {}
             own_annotations = {
-                n: typing._type_check(tp, msg) for n, tp in own_annotations.items()
+                n: typing._type_check(tp, msg, **kwds)
+                for n, tp in own_annotations.items()
             }
             required_keys = set()
             optional_keys = set()
@@ -1157,7 +1164,7 @@
         if isinstance(default, (tuple, list)):
             self.__default__ = tuple((typing._type_check(d, "Default must be a type")
                                       for d in default))
-        elif default:
+        elif default != _marker:
             self.__default__ = typing._type_check(default, "Default must be a type")
         else:
             self.__default__ = None
@@ -1171,7 +1178,7 @@
 
     def __init__(self, name, *constraints, bound=None,
                  covariant=False, contravariant=False,
-                 default=None, infer_variance=False):
+                 default=_marker, infer_variance=False):
         super().__init__(name, *constraints, bound=bound, covariant=covariant,
                          contravariant=contravariant)
         _DefaultMixin.__init__(self, default)
@@ -1258,7 +1265,7 @@
         __module__ = 'typing'
 
         def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     default=None):
+                     default=_marker):
             super().__init__(name, bound=bound, covariant=covariant,
                              contravariant=contravariant)
             _DefaultMixin.__init__(self, default)
@@ -1334,7 +1341,7 @@
             return ParamSpecKwargs(self)
 
         def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     default=None):
+                     default=_marker):
             super().__init__(self)
             self.__name__ = name
             self.__covariant__ = bool(covariant)
@@ -1850,7 +1857,7 @@
     class TypeVarTuple(typing.TypeVarTuple, _DefaultMixin, _root=True):
         """Type variable tuple."""
 
-        def __init__(self, name, *, default=None):
+        def __init__(self, name, *, default=_marker):
             super().__init__(name)
             _DefaultMixin.__init__(self, default)
 
@@ -1913,7 +1920,7 @@
         def __iter__(self):
             yield self.__unpacked__
 
-        def __init__(self, name, *, default=None):
+        def __init__(self, name, *, default=_marker):
             self.__name__ = name
             _DefaultMixin.__init__(self, default)
 
@@ -1993,7 +2000,8 @@
         raise AssertionError("Expected code to be unreachable")
 
 
-if hasattr(typing, 'dataclass_transform'):
+if sys.version_info >= (3, 12):
+    # dataclass_transform exists in 3.11 but lacks the frozen_default parameter
     dataclass_transform = typing.dataclass_transform
 else:
     def dataclass_transform(
@@ -2001,6 +2009,7 @@
         eq_default: bool = True,
         order_default: bool = False,
         kw_only_default: bool = False,
+        frozen_default: bool = False,
         field_specifiers: typing.Tuple
             typing.Uniontyping.Typetyping.Any, typing.Callable..., typing.Any,
             ...
@@ -2057,6 +2066,8 @@
           assumed to be True or False if it is omitted by the caller.
         - ``kw_only_default`` indicates whether the ``kw_only`` parameter is
           assumed to be True or False if it is omitted by the caller.
+        - ``frozen_default`` indicates whether the ``frozen`` parameter is
+          assumed to be True or False if it is omitted by the caller.
         - ``field_specifiers`` specifies a static list of supported classes
           or functions that describe fields, similar to ``dataclasses.field()``.
 
@@ -2071,6 +2082,7 @@
                 "eq_default": eq_default,
                 "order_default": order_default,
                 "kw_only_default": kw_only_default,
+                "frozen_default": frozen_default,
                 "field_specifiers": field_specifiers,
                 "kwargs": kwargs,
             }
@@ -2102,12 +2114,103 @@
         This helps prevent bugs that may occur when a base class is changed
         without an equivalent change to a child class.
 
+        There is no runtime checking of these properties. The decorator
+        sets the ``__override__`` attribute to ``True`` on the decorated object
+        to allow runtime introspection.
+
         See PEP 698 for details.
 
         """
+        try:
+            __arg.__override__ = True
+        except (AttributeError, TypeError):
+            # Skip the attribute silently if it is not writable.
+            # AttributeError happens if the object has __slots__ or a
+            # read-only property, TypeError if it's a builtin class.
+            pass
         return __arg
 
 
+if hasattr(typing, "deprecated"):
+    deprecated = typing.deprecated
+else:
+    _T = typing.TypeVar("_T")
+
+    def deprecated(
+        __msg: str,
+        *,
+        category: typing.Optionaltyping.TypeWarning = DeprecationWarning,
+        stacklevel: int = 1,
+    ) -> typing.Callable_T, _T:
+        """Indicate that a class, function or overload is deprecated.
+
+        Usage:
+
+            @deprecated("Use B instead")
+            class A:
+                pass
+
+            @deprecated("Use g instead")
+            def f():
+                pass
+
+            @overload
+            @deprecated("int support is deprecated")
+            def g(x: int) -> int: ...
+            @overload
+            def g(x: str) -> int: ...
+
+        When this decorator is applied to an object, the type checker
+        will generate a diagnostic on usage of the deprecated object.
+
+        No runtime warning is issued. The decorator sets the ``__deprecated__``
+        attribute on the decorated object to the deprecation message
+        passed to the decorator. If applied to an overload, the decorator
+        must be after the ``@overload`` decorator for the attribute to
+        exist on the overload as returned by ``get_overloads()``.
+
+        See PEP 702 for details.
+
+        """
+        def decorator(__arg: _T) -> _T:
+            if category is None:
+                __arg.__deprecated__ = __msg
+                return __arg
+            elif isinstance(__arg, type):
+                original_new = __arg.__new__
+                has_init = __arg.__init__ is not object.__init__
+
+                @functools.wraps(original_new)
+                def __new__(cls, *args, **kwargs):
+                    warnings.warn(__msg, category=category, stacklevel=stacklevel + 1)
+                    # Mirrors a similar check in object.__new__.
+                    if not has_init and (args or kwargs):
+                        raise TypeError(f"{cls.__name__}() takes no arguments")
+                    if original_new is not object.__new__:
+                        return original_new(cls, *args, **kwargs)
+                    else:
+                        return original_new(cls)
+
+                __arg.__new__ = staticmethod(__new__)
+                __arg.__deprecated__ = __new__.__deprecated__ = __msg
+                return __arg
+            elif callable(__arg):
+                @functools.wraps(__arg)
+                def wrapper(*args, **kwargs):
+                    warnings.warn(__msg, category=category, stacklevel=stacklevel + 1)
+                    return __arg(*args, **kwargs)
+
+                __arg.__deprecated__ = wrapper.__deprecated__ = __msg
+                return wrapper
+            else:
+                raise TypeError(
+                    "@deprecated decorator with non-None category must be applied to "
+                    f"a class or callable, not {__arg!r}"
+                )
+
+        return decorator
+
+
 # We have to do some monkey patching to deal with the dual nature of
 # Unpack/TypeVarTuple:
 # - We want Unpack to be a kind of TypeVar so it gets accepted in

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/typing_extensions.pyi Added

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3.pyi Added

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/_version.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/_version.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/connection.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/connection.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/connectionpool.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/connectionpool.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/contrib/appengine.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/contrib/appengine.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/contrib/ntlmpool.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/contrib/ntlmpool.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/contrib/pyopenssl.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/contrib/pyopenssl.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/response.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/response.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/util/retry.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/util/retry.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/util/timeout.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/util/timeout.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/urllib3/util/url.py -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/urllib3/util/url.py Changed

_service:tar_scm:pip-22.3.1.tar.gz/src/pip/_vendor/vendor.txt -> _service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/vendor.txt Changed

_service:tar_scm:pip-23.1.2.tar.gz/src/pip/_vendor/webencodings.pyi Added

_service:tar_scm:pip-23.1.2.tar.gz/tests Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/conftest.py Added

@@ -0,0 +1,747 @@
+import compileall
+import fnmatch
+import io
+import os
+import re
+import shutil
+import subprocess
+import sys
+from contextlib import ExitStack, contextmanager
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    AnyStr,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Union,
+)
+from unittest.mock import patch
+from zipfile import ZipFile
+
+import pytest
+
+# Config will be available from the public API in pytest >= 7.0.0:
+# https://github.com/pytest-dev/pytest/commit/88d84a57916b592b070f4201dc84f0286d1f9fef
+from _pytest.config import Config
+
+# Parser will be available from the public API in pytest >= 7.0.0:
+# https://github.com/pytest-dev/pytest/commit/538b5c24999e9ebb4fab43faabc8bcc28737bcdf
+from _pytest.config.argparsing import Parser
+from installer import install
+from installer.destinations import SchemeDictionaryDestination
+from installer.sources import WheelFile
+
+from pip import __file__ as pip_location
+from pip._internal.cli.main import main as pip_entry_point
+from pip._internal.locations import _USE_SYSCONFIG
+from pip._internal.utils.temp_dir import global_tempdir_manager
+from tests.lib import DATA_DIR, SRC_DIR, PipTestEnvironment, TestData
+from tests.lib.server import MockServer as _MockServer
+from tests.lib.server import make_mock_server, server_running
+from tests.lib.venv import VirtualEnvironment, VirtualEnvironmentType
+
+from .lib.compat import nullcontext
+
+if TYPE_CHECKING:
+    from typing import Protocol
+
+    from wsgi import WSGIApplication
+else:
+    # TODO: Protocol was introduced in Python 3.8. Remove this branch when
+    # dropping support for Python 3.7.
+    Protocol = object
+
+
+def pytest_addoption(parser: Parser) -> None:
+    parser.addoption(
+        "--keep-tmpdir",
+        action="store_true",
+        default=False,
+        help="keep temporary test directories",
+    )
+    parser.addoption(
+        "--resolver",
+        action="store",
+        default="2020-resolver",
+        choices="2020-resolver", "legacy",
+        help="use given resolver in tests",
+    )
+    parser.addoption(
+        "--use-venv",
+        action="store_true",
+        default=False,
+        help="use venv for virtual environment creation",
+    )
+    parser.addoption(
+        "--run-search",
+        action="store_true",
+        default=False,
+        help="run 'pip search' tests",
+    )
+    parser.addoption(
+        "--proxy",
+        action="store",
+        default=None,
+        help="use given proxy in session network tests",
+    )
+    parser.addoption(
+        "--use-zipapp",
+        action="store_true",
+        default=False,
+        help="use a zipapp when running pip in tests",
+    )
+
+
+def pytest_collection_modifyitems(config: Config, items: Listpytest.Function) -> None:
+    for item in items:
+        if not hasattr(item, "module"):  # e.g.: DoctestTextfile
+            continue
+
+        if item.get_closest_marker("search") and not config.getoption("--run-search"):
+            item.add_marker(pytest.mark.skip("pip search test skipped"))
+
+        if "CI" in os.environ:
+            # Mark network tests as flaky
+            if item.get_closest_marker("network") is not None:
+                item.add_marker(pytest.mark.flaky(reruns=3, reruns_delay=2))
+
+        if (
+            item.get_closest_marker("incompatible_with_venv")
+            and sys.prefix != sys.base_prefix
+        ):
+            item.add_marker(pytest.mark.skip("Incompatible with venv"))
+
+        if item.get_closest_marker("incompatible_with_sysconfig") and _USE_SYSCONFIG:
+            item.add_marker(pytest.mark.skip("Incompatible with sysconfig"))
+
+        module_file = item.module.__file__
+        module_path = os.path.relpath(
+            module_file, os.path.commonprefix(__file__, module_file)
+        )
+
+        module_root_dir = module_path.split(os.pathsep)0
+        if (
+            module_root_dir.startswith("functional")
+            or module_root_dir.startswith("integration")
+            or module_root_dir.startswith("lib")
+        ):
+            item.add_marker(pytest.mark.integration)
+        elif module_root_dir.startswith("unit"):
+            item.add_marker(pytest.mark.unit)
+
+            # We don't want to allow using the script resource if this is a
+            # unit test, as unit tests should not need all that heavy lifting
+            if "script" in item.fixturenames:
+                raise RuntimeError(
+                    "Cannot use the ``script`` funcarg in a unit test: "
+                    "(filename = {}, item = {})".format(module_path, item)
+                )
+        else:
+            raise RuntimeError(f"Unknown test type (filename = {module_path})")
+
+
+@pytest.fixture(scope="session", autouse=True)
+def resolver_variant(request: pytest.FixtureRequest) -> Iteratorstr:
+    """Set environment variable to make pip default to the correct resolver."""
+    resolver = request.config.getoption("--resolver")
+
+    # Handle the environment variables for this test.
+    features = set(os.environ.get("PIP_USE_FEATURE", "").split())
+    deprecated_features = set(os.environ.get("PIP_USE_DEPRECATED", "").split())
+
+    if resolver == "legacy":
+        deprecated_features.add("legacy-resolver")
+    else:
+        deprecated_features.discard("legacy-resolver")
+
+    env = {
+        "PIP_USE_FEATURE": " ".join(features),
+        "PIP_USE_DEPRECATED": " ".join(deprecated_features),
+    }
+    with patch.dict(os.environ, env):
+        yield resolver
+
+
+@pytest.fixture(scope="session")
+def tmp_path_factory(
+    request: pytest.FixtureRequest, tmp_path_factory: pytest.TempPathFactory
+) -> Iteratorpytest.TempPathFactory:
+    """Modified `tmpdir_factory` session fixture
+    that will automatically cleanup after itself.
+    """
+    yield tmp_path_factory
+    if not request.config.getoption("--keep-tmpdir"):
+        shutil.rmtree(
+            tmp_path_factory.getbasetemp(),
+            ignore_errors=True,
+        )
+
+
+@pytest.fixture(scope="session")
+def tmpdir_factory(tmp_path_factory: pytest.TempPathFactory) -> pytest.TempPathFactory:
+    """Override Pytest's ``tmpdir_factory`` with our pathlib implementation.
+
+    This prevents mis-use of this fixture.
+    """
+    return tmp_path_factory
+
+
+@pytest.fixture
+def tmp_path(request: pytest.FixtureRequest, tmp_path: Path) -> IteratorPath:
+    """
+    Return a temporary directory path object which is unique to each test
+    function invocation, created as a sub directory of the base temporary
+    directory. The returned object is a ``Path`` object.
+
+    This uses the built-in tmp_path fixture from pytest itself, but deletes the
+    temporary directories at the end of each test case.
+    """
+    assert tmp_path.is_dir()
+    yield tmp_path
+    # Clear out the temporary directory after the test has finished using it.
+    # This should prevent us from needing a multiple gigabyte temporary
+    # directory while running the tests.
+    if not request.config.getoption("--keep-tmpdir"):
+        shutil.rmtree(tmp_path, ignore_errors=True)
+
+
+@pytest.fixture()
+def tmpdir(tmp_path: Path) -> Path:
+    """Override Pytest's ``tmpdir`` with our pathlib implementation.
+
+    This prevents mis-use of this fixture.
+    """
+    return tmp_path
+
+
+@pytest.fixture(autouse=True)
+def isolate(tmpdir: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    """
+    Isolate our tests so that things like global configuration files and the
+    like do not affect our test results.
+
+    We use an autouse function scoped fixture because we want to ensure that
+    every test has it's own isolated home directory.
+    """
+
+    # TODO: Figure out how to isolate from *system* level configuration files
+    #       as well as user level configuration files.
+
+    # Create a directory to use as our home location.
+    home_dir = os.path.join(str(tmpdir), "home")
+    os.makedirs(home_dir)
+
+    # Create a directory to use as a fake root
+    fake_root = os.path.join(str(tmpdir), "fake-root")
+    os.makedirs(fake_root)
+
+    if sys.platform == "win32":
+        # Note: this will only take effect in subprocesses...
+        home_drive, home_path = os.path.splitdrive(home_dir)
+        monkeypatch.setenv("USERPROFILE", home_dir)
+        monkeypatch.setenv("HOMEDRIVE", home_drive)
+        monkeypatch.setenv("HOMEPATH", home_path)
+        for env_var, sub_path in (
+            ("APPDATA", "AppData/Roaming"),
+            ("LOCALAPPDATA", "AppData/Local"),
+        ):
+            path = os.path.join(home_dir, *sub_path.split("/"))
+            monkeypatch.setenv(env_var, path)
+            os.makedirs(path)
+    else:
+        # Set our home directory to our temporary directory, this should force
+        # all of our relative configuration files to be read from here instead
+        # of the user's actual $HOME directory.
+        monkeypatch.setenv("HOME", home_dir)
+        # Isolate ourselves from XDG directories
+        monkeypatch.setenv(
+            "XDG_DATA_HOME",
+            os.path.join(
+                home_dir,
+                ".local",
+                "share",
+            ),
+        )
+        monkeypatch.setenv(
+            "XDG_CONFIG_HOME",
+            os.path.join(
+                home_dir,
+                ".config",
+            ),
+        )
+        monkeypatch.setenv("XDG_CACHE_HOME", os.path.join(home_dir, ".cache"))
+        monkeypatch.setenv(
+            "XDG_RUNTIME_DIR",
+            os.path.join(
+                home_dir,
+                ".runtime",
+            ),
+        )
+        monkeypatch.setenv(
+            "XDG_DATA_DIRS",
+            os.pathsep.join(
+                
+                    os.path.join(fake_root, "usr", "local", "share"),
+                    os.path.join(fake_root, "usr", "share"),
+                
+            ),
+        )
+        monkeypatch.setenv(
+            "XDG_CONFIG_DIRS",
+            os.path.join(
+                fake_root,
+                "etc",
+                "xdg",
+            ),
+        )
+
+    # Configure git, because without an author name/email git will complain
+    # and cause test failures.
+    monkeypatch.setenv("GIT_CONFIG_NOSYSTEM", "1")
+    monkeypatch.setenv("GIT_AUTHOR_NAME", "pip")
+    monkeypatch.setenv("GIT_AUTHOR_EMAIL", "distutils-sig@python.org")
+
+    # We want to disable the version check from running in the tests
+    monkeypatch.setenv("PIP_DISABLE_PIP_VERSION_CHECK", "true")
+
+    # Make sure tests don't share a requirements tracker.
+    monkeypatch.delenv("PIP_BUILD_TRACKER", False)
+
+    # FIXME: Windows...
+    os.makedirs(os.path.join(home_dir, ".config", "git"))
+    with open(os.path.join(home_dir, ".config", "git", "config"), "wb") as fp:
+        fp.write(b"user\n\tname = pip\n\temail = distutils-sig@python.org\n")
+
+
+@pytest.fixture(autouse=True)
+def scoped_global_tempdir_manager(request: pytest.FixtureRequest) -> IteratorNone:
+    """Make unit tests with globally-managed tempdirs easier
+
+    Each test function gets its own individual scope for globally-managed
+    temporary directories in the application.
+    """
+    if "no_auto_tempdir_manager" in request.keywords:
+        ctx = nullcontext
+    else:
+        ctx = global_tempdir_manager
+
+    with ctx():
+        yield
+
+
+@pytest.fixture(scope="session")
+def pip_src(tmpdir_factory: pytest.TempPathFactory) -> Path:
+    def not_code_files_and_folders(path: str, names: Liststr) -> Iterablestr:
+        # In the root directory...
+        if os.path.samefile(path, SRC_DIR):
+            # ignore all folders except "src"
+            folders = {
+                name for name in names if os.path.isdir(os.path.join(path, name))
+            }
+            to_ignore = folders - {"src"}
+            # and ignore ".git" if present (which may be a file if in a linked
+            # worktree).
+            if ".git" in names:
+                to_ignore.add(".git")
+            return to_ignore
+
+        # Ignore all compiled files and egg-info.
+        ignored = set()
+        for pattern in ("__pycache__", "*.pyc", "pip.egg-info"):
+            ignored.update(fnmatch.filter(names, pattern))
+        return ignored
+
+    pip_src = tmpdir_factory.mktemp("pip_src").joinpath("pip_src")
+    # Copy over our source tree so that each use is self contained
+    shutil.copytree(
+        SRC_DIR,
+        pip_src.resolve(),
+        ignore=not_code_files_and_folders,
+    )
+    return pip_src
+
+
+def _common_wheel_editable_install(
+    tmpdir_factory: pytest.TempPathFactory, common_wheels: Path, package: str
+) -> Path:
+    wheel_candidates = list(common_wheels.glob(f"{package}-*.whl"))
+    assert len(wheel_candidates) == 1, wheel_candidates
+    install_dir = tmpdir_factory.mktemp(package) / "install"
+    lib_install_dir = install_dir / "lib"
+    bin_install_dir = install_dir / "bin"
+    with WheelFile.open(wheel_candidates0) as source:
+        install(
+            source,
+            SchemeDictionaryDestination(
+                {
+                    "purelib": os.fspath(lib_install_dir),
+                    "platlib": os.fspath(lib_install_dir),
+                    "scripts": os.fspath(bin_install_dir),
+                },
+                interpreter=sys.executable,
+                script_kind="posix",
+            ),
+            additional_metadata={},
+        )
+    # The scripts are not necessary for our use cases, and they would be installed with
+    # the wrong interpreter, so remove them.
+    # TODO consider a refactoring by adding a install_from_wheel(path) method
+    # to the virtualenv fixture.
+    if bin_install_dir.exists():
+        shutil.rmtree(bin_install_dir)
+    return lib_install_dir
+
+
+@pytest.fixture(scope="session")
+def setuptools_install(
+    tmpdir_factory: pytest.TempPathFactory, common_wheels: Path
+) -> Path:
+    return _common_wheel_editable_install(tmpdir_factory, common_wheels, "setuptools")
+
+
+@pytest.fixture(scope="session")
+def wheel_install(tmpdir_factory: pytest.TempPathFactory, common_wheels: Path) -> Path:
+    return _common_wheel_editable_install(tmpdir_factory, common_wheels, "wheel")
+
+
+@pytest.fixture(scope="session")
+def coverage_install(
+    tmpdir_factory: pytest.TempPathFactory, common_wheels: Path
+) -> Path:
+    return _common_wheel_editable_install(tmpdir_factory, common_wheels, "coverage")
+
+
+def install_pth_link(
+    venv: VirtualEnvironment, project_name: str, lib_dir: Path
+) -> None:
+    venv.site.joinpath(f"_pip_testsuite_{project_name}.pth").write_text(
+        str(lib_dir.resolve()), encoding="utf-8"
+    )
+
+
+@pytest.fixture(scope="session")
+def virtualenv_template(
+    request: pytest.FixtureRequest,
+    tmpdir_factory: pytest.TempPathFactory,
+    pip_src: Path,
+    setuptools_install: Path,
+    wheel_install: Path,
+    coverage_install: Path,
+) -> IteratorVirtualEnvironment:
+    venv_type: VirtualEnvironmentType
+    if request.config.getoption("--use-venv"):
+        venv_type = "venv"
+    else:
+        venv_type = "virtualenv"
+
+    # Create the virtual environment
+    tmpdir = tmpdir_factory.mktemp("virtualenv")
+    venv = VirtualEnvironment(tmpdir.joinpath("venv_orig"), venv_type=venv_type)
+
+    # Install setuptools, wheel and pip.
+    install_pth_link(venv, "setuptools", setuptools_install)
+    install_pth_link(venv, "wheel", wheel_install)
+    pip_editable = tmpdir_factory.mktemp("pip") / "pip"
+    shutil.copytree(pip_src, pip_editable, symlinks=True)
+    # noxfile.py is Python 3 only
+    assert compileall.compile_dir(
+        str(pip_editable),
+        quiet=1,
+        rx=re.compile("noxfile.py$"),
+    )
+    subprocess.check_call(
+        os.fspath(venv.bin / "python"), "setup.py", "-q", "develop", cwd=pip_editable
+    )
+
+    # Install coverage and pth file for executing it in any spawned processes
+    # in this virtual environment.
+    install_pth_link(venv, "coverage", coverage_install)
+    # zz prefix ensures the file is after easy-install.pth.
+    with open(venv.site / "zz-coverage-helper.pth", "a") as f:
+        f.write("import coverage; coverage.process_startup()")
+
+    # Drop (non-relocatable) launchers.
+    for exe in os.listdir(venv.bin):
+        if not (
+            exe.startswith("python")
+            or exe.startswith("libpy")  # Don't remove libpypy-c.so...
+        ):
+            (venv.bin / exe).unlink()
+
+    # Rename original virtualenv directory to make sure
+    # it's not reused by mistake from one of the copies.
+    venv_template = tmpdir / "venv_template"
+    venv.move(venv_template)
+    yield venv
+
+
+@pytest.fixture(scope="session")
+def virtualenv_factory(
+    virtualenv_template: VirtualEnvironment,
+) -> CallablePath, VirtualEnvironment:
+    def factory(tmpdir: Path) -> VirtualEnvironment:
+        return VirtualEnvironment(tmpdir, virtualenv_template)
+
+    return factory
+
+
+@pytest.fixture
+def virtualenv(
+    virtualenv_factory: CallablePath, VirtualEnvironment, tmpdir: Path
+) -> IteratorVirtualEnvironment:
+    """
+    Return a virtual environment which is unique to each test function
+    invocation created inside of a sub directory of the test function's
+    temporary directory. The returned object is a
+    ``tests.lib.venv.VirtualEnvironment`` object.
+    """
+    yield virtualenv_factory(tmpdir.joinpath("workspace", "venv"))
+
+
+class ScriptFactory(Protocol):
+    def __call__(
+        self,
+        tmpdir: Path,
+        virtualenv: OptionalVirtualEnvironment = None,
+        environ: OptionalDictAnyStr, AnyStr = None,
+    ) -> PipTestEnvironment:
+        ...
+
+
+@pytest.fixture(scope="session")
+def script_factory(
+    virtualenv_factory: CallablePath, VirtualEnvironment,
+    deprecated_python: bool,
+    zipapp: Optionalstr,
+) -> ScriptFactory:
+    def factory(
+        tmpdir: Path,
+        virtualenv: OptionalVirtualEnvironment = None,
+        environ: OptionalDictAnyStr, AnyStr = None,
+    ) -> PipTestEnvironment:
+        kwargs = {}
+        if environ:
+            kwargs"environ" = environ
+        if virtualenv is None:
+            virtualenv = virtualenv_factory(tmpdir.joinpath("venv"))
+        return PipTestEnvironment(
+            # The base location for our test environment
+            tmpdir,
+            # Tell the Test Environment where our virtualenv is located
+            virtualenv=virtualenv,
+            # Do not ignore hidden files, they need to be checked as well
+            ignore_hidden=False,
+            # We are starting with an already empty directory
+            start_clear=False,
+            # We want to ensure no temporary files are left behind, so the
+            # PipTestEnvironment needs to capture and assert against temp
+            capture_temp=True,
+            assert_no_temp=True,
+            # Deprecated python versions produce an extra deprecation warning
+            pip_expect_warning=deprecated_python,
+            # Tell the Test Environment if we want to run pip via a zipapp
+            zipapp=zipapp,
+            **kwargs,
+        )
+
+    return factory
+
+
+ZIPAPP_MAIN = """\
+#!/usr/bin/env python
+
+import os
+import runpy
+import sys
+
+lib = os.path.join(os.path.dirname(__file__), "lib")
+sys.path.insert(0, lib)
+
+runpy.run_module("pip", run_name="__main__")
+"""
+
+
+def make_zipapp_from_pip(zipapp_name: Path) -> None:
+    pip_dir = Path(pip_location).parent
+    with zipapp_name.open("wb") as zipapp_file:
+        zipapp_file.write(b"#!/usr/bin/env python\n")
+        with ZipFile(zipapp_file, "w") as zipapp:
+            for pip_file in pip_dir.rglob("*"):
+                if pip_file.suffix == ".pyc":
+                    continue
+                if pip_file.name == "__pycache__":
+                    continue
+                rel_name = pip_file.relative_to(pip_dir.parent)
+                zipapp.write(pip_file, arcname=f"lib/{rel_name}")
+            zipapp.writestr("__main__.py", ZIPAPP_MAIN)
+
+
+@pytest.fixture(scope="session")
+def zipapp(
+    request: pytest.FixtureRequest, tmpdir_factory: pytest.TempPathFactory
+) -> Optionalstr:
+    """
+    If the user requested for pip to be run from a zipapp, build that zipapp
+    and return its location. If the user didn't request a zipapp, return None.
+
+    This fixture is session scoped, so the zipapp will only be created once.
+    """
+    if not request.config.getoption("--use-zipapp"):
+        return None
+
+    temp_location = tmpdir_factory.mktemp("zipapp")
+    pyz_file = temp_location / "pip.pyz"
+    make_zipapp_from_pip(pyz_file)
+    return str(pyz_file)
+
+
+@pytest.fixture
+def script(
+    request: pytest.FixtureRequest,
+    tmpdir: Path,
+    virtualenv: VirtualEnvironment,
+    script_factory: ScriptFactory,
+) -> PipTestEnvironment:
+    """
+    Return a PipTestEnvironment which is unique to each test function and
+    will execute all commands inside of the unique virtual environment for this
+    test function. The returned object is a
+    ``tests.lib.PipTestEnvironment``.
+    """
+    return script_factory(tmpdir.joinpath("workspace"), virtualenv)
+
+
+@pytest.fixture(scope="session")
+def common_wheels() -> Path:
+    """Provide a directory with latest setuptools and wheel wheels"""
+    return DATA_DIR.joinpath("common_wheels")
+
+
+@pytest.fixture(scope="session")
+def shared_data(tmpdir_factory: pytest.TempPathFactory) -> TestData:
+    return TestData.copy(tmpdir_factory.mktemp("data"))
+
+
+@pytest.fixture
+def data(tmpdir: Path) -> TestData:
+    return TestData.copy(tmpdir.joinpath("data"))
+
+
+class InMemoryPipResult:
+    def __init__(self, returncode: int, stdout: str) -> None:
+        self.returncode = returncode
+        self.stdout = stdout
+
+
+class InMemoryPip:
+    def pip(self, *args: Unionstr, Path) -> InMemoryPipResult:
+        orig_stdout = sys.stdout
+        stdout = io.StringIO()
+        sys.stdout = stdout
+        try:
+            returncode = pip_entry_point(os.fspath(a) for a in args)
+        except SystemExit as e:
+            returncode = e.code or 0
+        finally:
+            sys.stdout = orig_stdout
+        return InMemoryPipResult(returncode, stdout.getvalue())
+
+
+@pytest.fixture
+def in_memory_pip() -> InMemoryPip:
+    return InMemoryPip()
+
+
+@pytest.fixture(scope="session")
+def deprecated_python() -> bool:
+    """Used to indicate whether pip deprecated this Python version"""
+    return sys.version_info:2 in 
+
+
+CertFactory = Callable, str
+
+
+@pytest.fixture(scope="session")
+def cert_factory(tmpdir_factory: pytest.TempPathFactory) -> CertFactory:
+    # Delay the import requiring cryptography in order to make it possible
+    # to deselect relevant tests on systems where cryptography cannot
+    # be installed.
+    from tests.lib.certs import make_tls_cert, serialize_cert, serialize_key
+
+    def factory() -> str:
+        """Returns path to cert/key file."""
+        output_path = tmpdir_factory.mktemp("certs") / "cert.pem"
+        # Must be Text on PY2.
+        cert, key = make_tls_cert("localhost")
+        with open(str(output_path), "wb") as f:
+            f.write(serialize_cert(cert))
+            f.write(serialize_key(key))
+
+        return str(output_path)
+
+    return factory
+
+
+class MockServer:
+    def __init__(self, server: _MockServer) -> None:
+        self._server = server
+        self._running = False
+        self.context = ExitStack()
+
+    @property
+    def port(self) -> int:
+        return self._server.port
+
+    @property
+    def host(self) -> str:
+        return self._server.host
+
+    def set_responses(self, responses: Iterable"WSGIApplication") -> None:
+        assert not self._running, "responses cannot be set on running server"
+        self._server.mock.side_effect = responses
+
+    def start(self) -> None:
+        assert not self._running, "running server cannot be started"
+        self.context.enter_context(server_running(self._server))
+        self.context.enter_context(self._set_running())
+
+    @contextmanager
+    def _set_running(self) -> IteratorNone:
+        self._running = True
+        try:
+            yield
+        finally:
+            self._running = False
+
+    def stop(self) -> None:
+        assert self._running, "idle server cannot be stopped"
+        self.context.close()
+
+    def get_requests(self) -> ListDictstr, str:
+        """Get environ for each received request."""
+        assert not self._running, "cannot get mock from running server"
+        # Legacy: replace call00 with call.args0
+        # when pip drops support for python3.7
+        return call00 for call in self._server.mock.call_args_list
+
+
+@pytest.fixture
+def mock_server() -> IteratorMockServer:
+    server = make_mock_server()
+    test_server = MockServer(server)
+    with test_server.context:
+        yield test_server
+
+
+@pytest.fixture
+def proxy(request: pytest.FixtureRequest) -> str:
+    return request.config.getoption("proxy")
+
+
+@pytest.fixture
+def enable_user_site(virtualenv: VirtualEnvironment) -> None:
+    virtualenv.user_site_packages = True

_service:tar_scm:pip-23.1.2.tar.gz/tests/data Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/backends Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/backends/dummy_backend-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/backends/test_backend-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/backends/test_backend-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/README.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/REPLAY Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/REPLAY/video.mpeg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/requirements.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/resources Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/resources/images Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/completion_paths/resources/images/icon.png Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/README.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/datarequire Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/datarequire/fakepackage Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/datarequire/fakepackage/index.html Added

@@ -0,0 +1,8 @@
+<!DOCTYPE html>
+<html><head><title>Links for fakepackage</title><meta name="api-version" value="2" /></head><body><h1>Links for fakepackage</h1>
+    <a data-requires-python=''                href="/fakepackage-1.0.0.tar.gz#md5=00000000000000000000000000000000" rel="internal">fakepackage-1.0.0.tar.gz</a><br/>
+    <a data-requires-python='&lt;2.7'         href="/fakepackage-2.6.0.tar.gz#md5=00000000000000000000000000000000" rel="internal">fakepackage-2.6.0.tar.gz</a><br/>
+    <a data-requires-python='&gt;=2.7,&lt;3'  href="/fakepackage-2.7.0.tar.gz#md5=00000000000000000000000000000000" rel="internal">fakepackage-2.7.0.tar.gz</a><br/>
+    <a data-requires-python='&gt;=3.3'        href="/fakepackage-3.3.0.tar.gz#md5=00000000000000000000000000000000" rel="internal">fakepackage-3.3.0.tar.gz</a><br/>
+    <a data-requires-python='&gt;&lt;X.y.z'   href="/fakepackage-9.9.9.tar.gz#md5=00000000000000000000000000000000" rel="internal">fakepackage-9.9.9.tar.gz</a><br/>
+</body></html>

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/dev Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/dev/bar Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/dev/bar/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/empty_with_pkg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/empty_with_pkg/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/empty_with_pkg/simple-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/in dex Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/in dex/README.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/in dex/simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/in dex/simple/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/pre Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/pre/bar Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/pre/bar/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/simple/simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/simple/simple/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/yanked Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/yanked/simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/yanked/simple/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/yanked_all Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/yanked_all/simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/indexes/yanked_all/simple/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/BrokenEmitsUTF8 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/BrokenEmitsUTF8/broken.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/BrokenEmitsUTF8/setup.py Added

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+
+import sys
+from distutils.core import setup
+
+
+class FakeError(Exception):
+    pass
+
+
+if sys.argv1 in ("install", "bdist_wheel"):
+    if hasattr(sys.stdout, "buffer"):
+        sys.stdout.buffer.write(
+            "\nThis package prints out UTF-8 stuff like:\n".encode("utf-8")
+        )
+        sys.stdout.buffer.write(
+            "* return type of ‘main’ is not ‘int’\n".encode("utf-8")
+        )
+        sys.stdout.buffer.write(
+            "* Björk Guðmundsdóttir ˈpjœr̥k ˈkvʏðmʏntsˌtoʊhtɪr".encode("utf-8")
+        )
+    else:
+        pass
+        sys.stdout.write("\nThis package prints out UTF-8 stuff like:\n")
+        sys.stdout.write(
+            "* return type of \xe2\x80\x98main\xe2\x80\x99 is not \xe2\x80\x98int\xe2\x80\x99\n"
+        )
+        sys.stdout.write(
+            "* Bj\xc3\xb6rk Gu\xc3\xb0mundsd\xc3\xb3ttir \xcb\x88pj\xc5\x93r\xcc\xa5k \xcb\x88kv\xca\x8f\xc3\xb0m\xca\x8fnts\xcb\x8cto\xca\x8aht\xc9\xaar\n"
+        )
+
+    raise FakeError("this package designed to fail on install")
+
+setup(
+    name="broken",
+    version="0.2",
+    py_modules="broken",
+)

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/FSPkg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/FSPkg/fspkg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/FSPkg/fspkg/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/FSPkg/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/HackedEggInfo Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/HackedEggInfo/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/INITools-0.2.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LineEndings Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LineEndings/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalEnvironMarker Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalEnvironMarker/.gitignore Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalEnvironMarker/localenvironmarker Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalEnvironMarker/localenvironmarker/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalEnvironMarker/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras-0.0.2 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras-0.0.2/.gitignore Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras-0.0.2/localextras Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras-0.0.2/localextras/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras-0.0.2/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras/.gitignore Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras/localextras Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras/localextras/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/LocalExtras/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/README.txt Added

@@ -0,0 +1,106 @@
+
+Details on Test Packages
+========================
+
+broken-0.1.tar.gz
+-----------------
+This package exists for testing uninstall-rollback.
+
+broken-0.2broken.tar.gz
+-----------------------
+Version 0.2broken has a setup.py crafted to fail on install (and only on
+install). If any earlier step would fail (i.e. egg-info-generation), the
+already-installed version would never be uninstalled, so uninstall-rollback
+would not come into play.
+
+brokenegginfo-0.1.tar.gz
+------------------------
+crafted to fail on egg_info
+
+BrokenEmitsUTF8
+---------------
+for generating unicode error in py3.x
+
+duplicate-1.0.tar.gz
+--------------------
+for testing finding dupes across multiple find-links
+
+FSPkg
+-----
+for installing from the file system
+
+gmpy-1.15.tar.gz
+----------------
+hash testing (although this pkg isn't needed explicitly)
+
+gmpy2-2.0.tar.gz
+----------------
+for testing finder logic when name *contains* the name of the package specified
+
+HackedEggInfo
+-------------
+has its own egg_info class
+
+LineEndings
+-----------
+contains DOS line endings
+
+LocalExtras
+-----------
+has an extra in a local file:// dependency link
+
+parent/child-0.1.tar.gz
+-----------------------
+The parent-0.1.tar.gz and child-0.1.tar.gz packages are used by
+test_uninstall:test_uninstall_overlapping_package.
+
+pkgwithmpkg-1.0.tar.gz; pkgwithmpkg-1.0-py2.7-macosx10.7.mpkg.zip
+-----------------------------------------------------------------
+used for osx test case (tests.test_finder:test_no_mpkg)
+
+priority-*
+----------
+used for testing wheel priority over sdists
+
+TopoRequires1234-0.0.1.tar.gz
+--------------------------------
+
+These are used for testing topological handling of requirements: we have
+TopoRequires, which is install-required by TopoRequires2 and TopoRequires3
+and finally TopoRequires4 which install-requires both TopoRequires2 and 3
+and also install-Requires TopoRequires.
+This creates a diamond where no matter which way we walk without topological
+awareness we'll end up attempting to install TopoRequires after one of
+TopoRequires2, TopoRequires3 or TopoRequires4. (prefix iteration works as its
+topological, suffix iteration likewise, infix breaks).
+
+simple2-123.0.tar.gz
+------------------------
+contains "simple2" package; good for basic testing and version logic.
+
+wheelbroken-0.1.tar.gz
+----------------------
+fails for "setup.py bdist_wheel"
+
+Upper-12.0.tar.gz and requiresuppper-1.0.tar.gz
+--------------------------------------------------
+'requiresupper' requires 'upper'
+used for testing case mismatch case for url requirements
+
+meta-1.0-py2.py3-none-any.whl
+--------------------------------------------------
+Is an empty package which install_requires the simple and simple2 packages.
+
+requires_simple_extra-0.1-py2.py3-none-any.whl
+----------------------------------------------
+requires_simple_extraextra requires simple==1.0
+
+requires_wheelbroken_upper
+--------------------------
+Requires wheelbroken and upper - used for testing implicit wheel building
+during install.
+
+require_simple-1.0.tar.gz
+------------------------
+contains "require_simple" package which requires simple>=2.0 - used for testing
+if dependencies are handled correctly.

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/SetupPyLatin1 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/SetupPyLatin1/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/SetupPyUTF8 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/SetupPyUTF8/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/TopoRequires-0.0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/TopoRequires2-0.0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/TopoRequires3-0.0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/TopoRequires4-0.0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/Upper-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/Upper-2.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/argparse-1.2.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/broken-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/broken-0.2broken.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/brokenegginfo-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/brokenwheel-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/child-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/colander-0.9.9-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/compilewheel-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/complex_dist-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/console_scripts_uppercase-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/corruptwheel-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/distribute-0.7.3.zip Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/duplicate-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/gmpy-1.15.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/gmpy2-2.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/has.script-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/invalid.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/meta-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/mypy-0.782-py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/parent-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_setup_and_pyproject Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_setup_and_pyproject/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_setup_and_pyproject/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_setup_and_pyproject/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_wrapper_buildsys Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_wrapper_buildsys/mybuildsys.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_wrapper_buildsys/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_wrapper_buildsys/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep517_wrapper_buildsys/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep518-3.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep518_forkbomb-235.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep518_twin_forkbombs_first-234.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep518_twin_forkbombs_second-238.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pep518_with_extra_and_markers-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pip-test-package-0.1.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pip-test-package-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pkgwithmpkg-1.0-py2.7-macosx10.7.mpkg.zip Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/pkgwithmpkg-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/priority-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/priority-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/prjwithdatafile-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/require_simple-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requiresPaste Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requiresPaste/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requiresPaste/requiresPaste.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requires_simple_extra-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requires_source-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requires_wheelbroken_upper Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requires_wheelbroken_upper/requires_wheelbroken_upper Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requires_wheelbroken_upper/requires_wheelbroken_upper/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requires_wheelbroken_upper/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/requiresupper-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/script.wheel1-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/script.wheel1a-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/script.wheel2-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/script.wheel2a-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/script.wheel3-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/setuptools-0.9.6.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/setuptools-0.9.8-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple-2.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple-3.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple.dist-0.1-py1-none-invalid.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple.dist-0.1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple2-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple2-2.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple2-3.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simple_namespace-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simplewheel-1.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simplewheel-2.0-1-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simplewheel-2.0-py2.py3-none-any.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/simplewheel-2.0-py3-fakeabi-fakeplat.whl Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/singlemodule-0.0.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/singlemodule-0.0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/singlemodule-0.0.1.tar.lzma Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/singlemodule-0.0.1.tar.xz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/source-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/doc Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/doc/intro Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/docs Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/symlinks Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/symlinks/symlinks/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/test_tar.tgz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/test_zip.zip Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/translationstring-1.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/virtualenv-1.10.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/virtualenv-1.9.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/wheelbroken-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages/wheelbrokenafter-0.1.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages2 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages2/duplicate-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/dinner Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/dinner/Dinner-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/dinner/Dinner-2.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/dinner/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/requiredinner Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/requiredinner/index.html Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/packages3/requiredinner/requiredinner-1.0.tar.gz Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/reqfiles Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/reqfiles/README.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/reqfiles/supported_options2.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires/toporequires Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires/toporequires/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires2 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires2/setup.cfg.pending Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires2/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires2/toporequires2 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires2/toporequires2/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires3 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires3/setup.cfg.pending Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires3/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires3/toporequires3 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires3/toporequires3/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires4 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires4/setup.cfg.pending Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires4/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires4/toporequires4 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/TopoRequires4/toporequires4/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/chattymodule Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/chattymodule/chattymodule.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/chattymodule/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/chattymodule/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/compilewheel Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/compilewheel/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/compilewheel/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/compilewheel/simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/compilewheel/simple/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/extension Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/extension/extension.c Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/extension/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_pyproject_only Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_pyproject_only/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_and_pyproject Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_and_pyproject/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_and_pyproject/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_cfg_only Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_cfg_only/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_only Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep517_setup_only/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518-3.0 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518-3.0/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518-3.0/pep518.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518-3.0/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518-3.0/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518-3.0/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_conflicting_requires Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_conflicting_requires/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_conflicting_requires/pep518.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_conflicting_requires/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_conflicting_requires/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_forkbomb-235 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_forkbomb-235/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_forkbomb-235/pep518_forkbomb.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_forkbomb-235/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_forkbomb-235/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_forkbomb-235/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_build_system Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_build_system/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_build_system/pep518.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_build_system/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_build_system/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_requires Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_requires/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_requires/pep518.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_requires/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_invalid_requires/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_missing_requires Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_missing_requires/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_missing_requires/pep518.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_missing_requires/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_missing_requires/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_first-234 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_first-234/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_first-234/pep518_twin_forkbombs_first.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_first-234/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_first-234/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_first-234/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_second-238 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_second-238/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_second-238/pep518_twin_forkbombs_second.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_second-238/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_second-238/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_twin_forkbombs_second-238/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_extra_and_markers-1.0 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_extra_and_markers-1.0/MANIFEST.in Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_extra_and_markers-1.0/pep518_with_extra_and_markers.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_extra_and_markers-1.0/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_extra_and_markers-1.0/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_extra_and_markers-1.0/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_namespace_package-1.0 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_namespace_package-1.0/pep518_with_namespace_package.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_namespace_package-1.0/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_namespace_package-1.0/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/pep518_with_namespace_package-1.0/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/prjwithdatafile Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/prjwithdatafile/prjwithdatafile Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/prjwithdatafile/prjwithdatafile/README.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/prjwithdatafile/prjwithdatafile/somemodule.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/prjwithdatafile/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_capitalized Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_capitalized/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_requires_capitalized Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_requires_capitalized/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple/requires_simple Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple/requires_simple/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple_extra Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple_extra/requires_simple_extra.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple_extra/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/requires_simple_extra/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/setup_error Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/setup_error/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace/simple_namespace Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace/simple_namespace/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace/simple_namespace/module Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simple_namespace/simple_namespace/module/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-1.0 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-1.0/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-1.0/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-1.0/simplewheel Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-1.0/simplewheel/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-2.0 Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-2.0/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-2.0/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-2.0/simplewheel Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/simplewheel-2.0/simplewheel/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/singlemodule Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/singlemodule/setup.cfg Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/singlemodule/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/singlemodule/singlemodule.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/withpyproject Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/withpyproject/pyproject.toml Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/data/src/withpyproject/setup.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_bad_url.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_broken_stdout.py Added

@@ -0,0 +1,80 @@
+import os
+import subprocess
+from pathlib import Path
+from typing import List, Tuple
+
+_BROKEN_STDOUT_RETURN_CODE = 120
+
+
+def setup_broken_stdout_test(
+    args: Liststr, deprecated_python: bool
+) -> Tuplestr, int:
+    proc = subprocess.Popen(
+        args,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+    # Call close() on stdout to cause a broken pipe.
+    assert proc.stdout is not None
+    proc.stdout.close()
+    returncode = proc.wait()
+    assert proc.stderr is not None
+    stderr = proc.stderr.read().decode("utf-8")
+
+    expected_msg = "ERROR: Pipe to stdout was broken"
+    if deprecated_python:
+        assert expected_msg in stderr
+    else:
+        assert stderr.startswith(expected_msg)
+
+    return stderr, returncode
+
+
+def test_broken_stdout_pipe(deprecated_python: bool) -> None:
+    """
+    Test a broken pipe to stdout.
+    """
+    stderr, returncode = setup_broken_stdout_test(
+        "pip", "list",
+        deprecated_python=deprecated_python,
+    )
+
+    # Check that no traceback occurs.
+    assert "raise BrokenStdoutLoggingError()" not in stderr
+    assert stderr.count("Traceback") == 0
+
+    assert returncode == _BROKEN_STDOUT_RETURN_CODE
+
+
+def test_broken_stdout_pipe__log_option(deprecated_python: bool, tmpdir: Path) -> None:
+    """
+    Test a broken pipe to stdout when --log is passed.
+    """
+    log_path = os.path.join(str(tmpdir), "log.txt")
+    stderr, returncode = setup_broken_stdout_test(
+        "pip", "--log", log_path, "list",
+        deprecated_python=deprecated_python,
+    )
+
+    # Check that no traceback occurs.
+    assert "raise BrokenStdoutLoggingError()" not in stderr
+    assert stderr.count("Traceback") == 0
+
+    assert returncode == _BROKEN_STDOUT_RETURN_CODE
+
+
+def test_broken_stdout_pipe__verbose(deprecated_python: bool) -> None:
+    """
+    Test a broken pipe to stdout with verbose logging enabled.
+    """
+    stderr, returncode = setup_broken_stdout_test(
+        "pip", "-vv", "list",
+        deprecated_python=deprecated_python,
+    )
+
+    # Check that a traceback occurs and that it occurs at most once.
+    # We permit up to two because the exception can be chained.
+    assert "raise BrokenStdoutLoggingError()" in stderr
+    assert 1 <= stderr.count("Traceback") <= 2
+
+    assert returncode == _BROKEN_STDOUT_RETURN_CODE

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_build_env.py Added

@@ -0,0 +1,262 @@
+import os
+from textwrap import dedent
+from typing import Optional
+
+import pytest
+
+from pip._internal.build_env import BuildEnvironment, _get_system_sitepackages
+from tests.lib import (
+    PipTestEnvironment,
+    TestPipResult,
+    create_basic_wheel_for_package,
+    make_test_finder,
+)
+
+
+def indent(text: str, prefix: str) -> str:
+    return "\n".join((prefix if line else "") + line for line in text.split("\n"))
+
+
+def run_with_build_env(
+    script: PipTestEnvironment,
+    setup_script_contents: str,
+    test_script_contents: Optionalstr = None,
+) -> TestPipResult:
+    build_env_script = script.scratch_path / "build_env.py"
+    build_env_script.write_text(
+        dedent(
+            """
+            import subprocess
+            import sys
+
+            from pip._internal.build_env import BuildEnvironment
+            from pip._internal.index.collector import LinkCollector
+            from pip._internal.index.package_finder import PackageFinder
+            from pip._internal.models.search_scope import SearchScope
+            from pip._internal.models.selection_prefs import (
+                SelectionPreferences
+            )
+            from pip._internal.network.session import PipSession
+            from pip._internal.utils.temp_dir import global_tempdir_manager
+
+            link_collector = LinkCollector(
+                session=PipSession(),
+                search_scope=SearchScope.create({scratch!r}, , False),
+            )
+            selection_prefs = SelectionPreferences(
+                allow_yanked=True,
+            )
+            finder = PackageFinder.create(
+                link_collector=link_collector,
+                selection_prefs=selection_prefs,
+            )
+
+            with global_tempdir_manager():
+                build_env = BuildEnvironment()
+            """.format(
+                scratch=str(script.scratch_path)
+            )
+        )
+        + indent(dedent(setup_script_contents), "    ")
+        + indent(
+            dedent(
+                """
+                if len(sys.argv) > 1:
+                    with build_env:
+                        subprocess.check_call((sys.executable, sys.argv1))
+                """
+            ),
+            "    ",
+        )
+    )
+    args = "python", os.fspath(build_env_script)
+    if test_script_contents is not None:
+        test_script = script.scratch_path / "test.py"
+        test_script.write_text(dedent(test_script_contents))
+        args.append(os.fspath(test_script))
+    return script.run(*args)
+
+
+def test_build_env_allow_empty_requirements_install() -> None:
+    finder = make_test_finder()
+    build_env = BuildEnvironment()
+    for prefix in ("normal", "overlay"):
+        build_env.install_requirements(
+            finder, , prefix, kind="Installing build dependencies"
+        )
+
+
+def test_build_env_allow_only_one_install(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "foo", "1.0")
+    create_basic_wheel_for_package(script, "bar", "1.0")
+    finder = make_test_finder(find_links=os.fspath(script.scratch_path))
+    build_env = BuildEnvironment()
+    for prefix in ("normal", "overlay"):
+        build_env.install_requirements(
+            finder, "foo", prefix, kind=f"installing foo in {prefix}"
+        )
+        with pytest.raises(AssertionError):
+            build_env.install_requirements(
+                finder, "bar", prefix, kind=f"installing bar in {prefix}"
+            )
+        with pytest.raises(AssertionError):
+            build_env.install_requirements(
+                finder, , prefix, kind=f"installing in {prefix}"
+            )
+
+
+def test_build_env_requirements_check(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "foo", "2.0")
+    create_basic_wheel_for_package(script, "bar", "1.0")
+    create_basic_wheel_for_package(script, "bar", "3.0")
+    create_basic_wheel_for_package(script, "other", "0.5")
+
+    script.pip_install_local("-f", script.scratch_path, "foo", "bar", "other")
+
+    run_with_build_env(
+        script,
+        """
+        r = build_env.check_requirements('foo', 'bar', 'other')
+        assert r == (set(), {'foo', 'bar', 'other'}), repr(r)
+
+        r = build_env.check_requirements('foo>1.0', 'bar==3.0')
+        assert r == (set(), {'foo>1.0', 'bar==3.0'}), repr(r)
+
+        r = build_env.check_requirements('foo>3.0', 'bar>=2.5')
+        assert r == (set(), {'foo>3.0', 'bar>=2.5'}), repr(r)
+        """,
+    )
+
+    run_with_build_env(
+        script,
+        """
+        build_env.install_requirements(finder, 'foo', 'bar==3.0', 'normal',
+                                       kind='installing foo in normal')
+
+        r = build_env.check_requirements('foo', 'bar', 'other')
+        assert r == (set(), {'other'}), repr(r)
+
+        r = build_env.check_requirements('foo>1.0', 'bar==3.0')
+        assert r == (set(), set()), repr(r)
+
+        r = build_env.check_requirements('foo>3.0', 'bar>=2.5')
+        assert r == ({('foo==2.0', 'foo>3.0')}, set()), repr(r)
+        """,
+    )
+
+    run_with_build_env(
+        script,
+        """
+        build_env.install_requirements(finder, 'foo', 'bar==3.0', 'normal',
+                                       kind='installing foo in normal')
+        build_env.install_requirements(finder, 'bar==1.0', 'overlay',
+                                       kind='installing foo in overlay')
+
+        r = build_env.check_requirements('foo', 'bar', 'other')
+        assert r == (set(), {'other'}), repr(r)
+
+        r = build_env.check_requirements('foo>1.0', 'bar==3.0')
+        assert r == ({('bar==1.0', 'bar==3.0')}, set()), repr(r)
+
+        r = build_env.check_requirements('foo>3.0', 'bar>=2.5')
+        assert r == ({('bar==1.0', 'bar>=2.5'), ('foo==2.0', 'foo>3.0')}, \
+            set()), repr(r)
+        """,
+    )
+
+    run_with_build_env(
+        script,
+        """
+        build_env.install_requirements(
+            finder,
+            "bar==3.0",
+            "normal",
+            kind="installing bar in normal",
+        )
+        r = build_env.check_requirements(
+            
+                "bar==2.0; python_version < '3.0'",
+                "bar==3.0; python_version >= '3.0'",
+                "foo==4.0; extra == 'dev'",
+            ,
+        )
+        assert r == (set(), set()), repr(r)
+        """,
+    )
+
+
+def test_build_env_overlay_prefix_has_priority(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "pkg", "2.0")
+    create_basic_wheel_for_package(script, "pkg", "4.3")
+    result = run_with_build_env(
+        script,
+        """
+        build_env.install_requirements(finder, 'pkg==2.0', 'overlay',
+                                       kind='installing pkg==2.0 in overlay')
+        build_env.install_requirements(finder, 'pkg==4.3', 'normal',
+                                       kind='installing pkg==4.3 in normal')
+        """,
+        """
+        print(__import__('pkg').__version__)
+        """,
+    )
+    assert result.stdout.strip() == "2.0", str(result)
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_build_env_isolation(script: PipTestEnvironment) -> None:
+    # Create dummy `pkg` wheel.
+    pkg_whl = create_basic_wheel_for_package(script, "pkg", "1.0")
+
+    # Install it to site packages.
+    script.pip_install_local(pkg_whl)
+
+    # And a copy in the user site.
+    script.pip_install_local("--ignore-installed", "--user", pkg_whl)
+
+    # And to another directory available through a .pth file.
+    target = script.scratch_path / "pth_install"
+    script.pip_install_local("-t", target, pkg_whl)
+    (script.site_packages_path / "build_requires.pth").write_text(str(target) + "\n")
+
+    # And finally to yet another directory available through PYTHONPATH.
+    target = script.scratch_path / "pypath_install"
+    script.pip_install_local("-t", target, pkg_whl)
+    script.environ"PYTHONPATH" = target
+
+    system_sites = _get_system_sitepackages()
+    # there should always be something to exclude
+    assert system_sites
+
+    run_with_build_env(
+        script,
+        "",
+        r"""
+        from distutils.sysconfig import get_python_lib
+        import sys
+
+        try:
+            import pkg
+        except ImportError:
+            pass
+        else:
+            print(
+                f'imported `pkg` from `{pkg.__file__}`',
+                file=sys.stderr)
+            print('system sites:\n  ' + '\n  '.join(sorted({
+                          get_python_lib(plat_specific=0),
+                          get_python_lib(plat_specific=1),
+                    })), file=sys.stderr)
+            print('sys.path:\n  ' + '\n  '.join(sys.path), file=sys.stderr)
+            sys.exit(1)
+        """
+        f"""
+        # second check: direct check of exclusion of system site packages
+        import os
+
+        normalized_path = os.path.normcase(path) for path in sys.path
+        for system_path in {system_sites!r}:
+            assert system_path not in normalized_path, \
+            f"{{system_path}} found in {{normalized_path}}"
+        """,
+    )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_cache.py Added

@@ -0,0 +1,422 @@
+import os
+import shutil
+from glob import glob
+from typing import Callable, List, Tuple
+
+import pytest
+
+from tests.lib import PipTestEnvironment, TestPipResult
+
+
+@pytest.fixture
+def cache_dir(script: PipTestEnvironment) -> str:
+    result = script.run(
+        "python",
+        "-c",
+        "from pip._internal.locations import USER_CACHE_DIR;print(USER_CACHE_DIR)",
+    )
+    return result.stdout.strip()
+
+
+@pytest.fixture
+def http_cache_dir(cache_dir: str) -> str:
+    return os.path.normcase(os.path.join(cache_dir, "http"))
+
+
+@pytest.fixture
+def wheel_cache_dir(cache_dir: str) -> str:
+    return os.path.normcase(os.path.join(cache_dir, "wheels"))
+
+
+@pytest.fixture
+def http_cache_files(http_cache_dir: str) -> Liststr:
+    destination = os.path.join(http_cache_dir, "arbitrary", "pathname")
+
+    if not os.path.exists(destination):
+        return 
+
+    filenames = glob(os.path.join(destination, "*"))
+    files = 
+    for filename in filenames:
+        files.append(os.path.join(destination, filename))
+    return files
+
+
+@pytest.fixture
+def wheel_cache_files(wheel_cache_dir: str) -> Liststr:
+    destination = os.path.join(wheel_cache_dir, "arbitrary", "pathname")
+
+    if not os.path.exists(destination):
+        return 
+
+    filenames = glob(os.path.join(destination, "*.whl"))
+    files = 
+    for filename in filenames:
+        files.append(os.path.join(destination, filename))
+    return files
+
+
+@pytest.fixture
+def populate_http_cache(http_cache_dir: str) -> ListTuplestr, str:
+    destination = os.path.join(http_cache_dir, "arbitrary", "pathname")
+    os.makedirs(destination)
+
+    files = 
+        ("aaaaaaaaa", os.path.join(destination, "aaaaaaaaa")),
+        ("bbbbbbbbb", os.path.join(destination, "bbbbbbbbb")),
+        ("ccccccccc", os.path.join(destination, "ccccccccc")),
+    
+
+    for _name, filename in files:
+        with open(filename, "w"):
+            pass
+
+    return files
+
+
+@pytest.fixture
+def populate_wheel_cache(wheel_cache_dir: str) -> ListTuplestr, str:
+    destination = os.path.join(wheel_cache_dir, "arbitrary", "pathname")
+    os.makedirs(destination)
+
+    files = 
+        ("yyy-1.2.3", os.path.join(destination, "yyy-1.2.3-py3-none-any.whl")),
+        ("zzz-4.5.6", os.path.join(destination, "zzz-4.5.6-py3-none-any.whl")),
+        ("zzz-4.5.7", os.path.join(destination, "zzz-4.5.7-py3-none-any.whl")),
+        ("zzz-7.8.9", os.path.join(destination, "zzz-7.8.9-py3-none-any.whl")),
+    
+
+    for _name, filename in files:
+        with open(filename, "w"):
+            pass
+
+    return files
+
+
+@pytest.fixture
+def empty_wheel_cache(wheel_cache_dir: str) -> None:
+    if os.path.exists(wheel_cache_dir):
+        shutil.rmtree(wheel_cache_dir)
+
+
+def list_matches_wheel(wheel_name: str, result: TestPipResult) -> bool:
+    """Returns True if any line in `result`, which should be the output of
+    a `pip cache list` call, matches `wheel_name`.
+
+    E.g., If wheel_name is `foo-1.2.3` it searches for a line starting with
+          `- foo-1.2.3-py3-none-any.whl `."""
+    lines = result.stdout.splitlines()
+    expected = f" - {wheel_name}-py3-none-any.whl "
+    return any(map(lambda line: line.startswith(expected), lines))
+
+
+def list_matches_wheel_abspath(wheel_name: str, result: TestPipResult) -> bool:
+    """Returns True if any line in `result`, which should be the output of
+    a `pip cache list --format=abspath` call, is a valid path and belongs to
+    `wheel_name`.
+
+    E.g., If wheel_name is `foo-1.2.3` it searches for a line starting with
+          `foo-1.2.3-py3-none-any.whl`."""
+    lines = result.stdout.splitlines()
+    expected = f"{wheel_name}-py3-none-any.whl"
+    return any(
+        map(
+            lambda line: (
+                os.path.basename(line).startswith(expected) and os.path.exists(line)
+            ),
+            lines,
+        )
+    )
+
+
+RemoveMatches = Callablestr, TestPipResult, bool
+
+
+@pytest.fixture
+def remove_matches_http(http_cache_dir: str) -> RemoveMatches:
+    """Returns True if any line in `result`, which should be the output of
+    a `pip cache purge` call, matches `http_filename`.
+
+    E.g., If http_filename is `aaaaaaaaa`, it searches for a line equal to
+    `Removed <http files cache dir>/arbitrary/pathname/aaaaaaaaa`.
+    """
+
+    def _remove_matches_http(http_filename: str, result: TestPipResult) -> bool:
+        lines = result.stdout.splitlines()
+
+        # The "/arbitrary/pathname/" bit is an implementation detail of how
+        # the `populate_http_cache` fixture is implemented.
+        path = os.path.join(
+            http_cache_dir,
+            "arbitrary",
+            "pathname",
+            http_filename,
+        )
+        expected = f"Removed {path}"
+        return expected in lines
+
+    return _remove_matches_http
+
+
+@pytest.fixture
+def remove_matches_wheel(wheel_cache_dir: str) -> RemoveMatches:
+    """Returns True if any line in `result`, which should be the output of
+    a `pip cache remove`/`pip cache purge` call, matches `wheel_name`.
+
+    E.g., If wheel_name is `foo-1.2.3`, it searches for a line equal to
+    `Removed <wheel cache dir>/arbitrary/pathname/foo-1.2.3-py3-none-any.whl`.
+    """
+
+    def _remove_matches_wheel(wheel_name: str, result: TestPipResult) -> bool:
+        lines = result.stdout.splitlines()
+
+        wheel_filename = f"{wheel_name}-py3-none-any.whl"
+
+        # The "/arbitrary/pathname/" bit is an implementation detail of how
+        # the `populate_wheel_cache` fixture is implemented.
+        path = os.path.join(
+            wheel_cache_dir,
+            "arbitrary",
+            "pathname",
+            wheel_filename,
+        )
+        expected = f"Removed {path}"
+        return expected in lines
+
+    return _remove_matches_wheel
+
+
+def test_cache_dir(script: PipTestEnvironment, cache_dir: str) -> None:
+    result = script.pip("cache", "dir")
+
+    assert os.path.normcase(cache_dir) == result.stdout.strip()
+
+
+def test_cache_dir_too_many_args(script: PipTestEnvironment, cache_dir: str) -> None:
+    result = script.pip("cache", "dir", "aaa", expect_error=True)
+
+    assert result.stdout == ""
+
+    # This would be `result.stderr == ...`, but pip prints deprecation
+    # warnings on Python 2.7, so we check if the _line_ is in stderr.
+    assert "ERROR: Too many arguments" in result.stderr.splitlines()
+
+
+@pytest.mark.usefixtures("populate_http_cache", "populate_wheel_cache")
+def test_cache_info(
+    script: PipTestEnvironment,
+    http_cache_dir: str,
+    wheel_cache_dir: str,
+    wheel_cache_files: Liststr,
+) -> None:
+    result = script.pip("cache", "info")
+
+    assert f"Package index page cache location: {http_cache_dir}" in result.stdout
+    assert f"Locally built wheels location: {wheel_cache_dir}" in result.stdout
+    num_wheels = len(wheel_cache_files)
+    assert f"Number of locally built wheels: {num_wheels}" in result.stdout
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_list(script: PipTestEnvironment) -> None:
+    """Running `pip cache list` should return exactly what the
+    populate_wheel_cache fixture adds."""
+    result = script.pip("cache", "list")
+
+    assert list_matches_wheel("yyy-1.2.3", result)
+    assert list_matches_wheel("zzz-4.5.6", result)
+    assert list_matches_wheel("zzz-4.5.7", result)
+    assert list_matches_wheel("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_list_abspath(script: PipTestEnvironment) -> None:
+    """Running `pip cache list --format=abspath` should return full
+    paths of exactly what the populate_wheel_cache fixture adds."""
+    result = script.pip("cache", "list", "--format=abspath")
+
+    assert list_matches_wheel_abspath("yyy-1.2.3", result)
+    assert list_matches_wheel_abspath("zzz-4.5.6", result)
+    assert list_matches_wheel_abspath("zzz-4.5.7", result)
+    assert list_matches_wheel_abspath("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("empty_wheel_cache")
+def test_cache_list_with_empty_cache(script: PipTestEnvironment) -> None:
+    """Running `pip cache list` with an empty cache should print
+    "No locally built wheels cached." and exit."""
+    result = script.pip("cache", "list")
+    assert result.stdout == "No locally built wheels cached.\n"
+
+
+@pytest.mark.usefixtures("empty_wheel_cache")
+def test_cache_list_with_empty_cache_abspath(script: PipTestEnvironment) -> None:
+    """Running `pip cache list --format=abspath` with an empty cache should not
+    print anything and exit."""
+    result = script.pip("cache", "list", "--format=abspath")
+    assert result.stdout.strip() == ""
+
+
+@pytest.mark.usefixtures("empty_wheel_cache")
+def test_cache_purge_with_empty_cache(script: PipTestEnvironment) -> None:
+    """Running `pip cache purge` with an empty cache should print a warning
+    and exit without an error code."""
+    result = script.pip("cache", "purge", allow_stderr_warning=True)
+    assert result.stderr == "WARNING: No matching packages\n"
+    assert result.stdout == "Files removed: 0\n"
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_remove_with_bad_pattern(script: PipTestEnvironment) -> None:
+    """Running `pip cache remove` with a bad pattern should print a warning
+    and exit without an error code."""
+    result = script.pip("cache", "remove", "aaa", allow_stderr_warning=True)
+    assert result.stderr == 'WARNING: No matching packages for pattern "aaa"\n'
+    assert result.stdout == "Files removed: 0\n"
+
+
+def test_cache_list_too_many_args(script: PipTestEnvironment) -> None:
+    """Passing `pip cache list` too many arguments should cause an error."""
+    script.pip("cache", "list", "aaa", "bbb", expect_error=True)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_list_name_match(script: PipTestEnvironment) -> None:
+    """Running `pip cache list zzz` should list zzz-4.5.6, zzz-4.5.7,
+    zzz-7.8.9, but nothing else."""
+    result = script.pip("cache", "list", "zzz", "--verbose")
+
+    assert not list_matches_wheel("yyy-1.2.3", result)
+    assert list_matches_wheel("zzz-4.5.6", result)
+    assert list_matches_wheel("zzz-4.5.7", result)
+    assert list_matches_wheel("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_list_name_match_abspath(script: PipTestEnvironment) -> None:
+    """Running `pip cache list zzz --format=abspath` should list paths of
+    zzz-4.5.6, zzz-4.5.7, zzz-7.8.9, but nothing else."""
+    result = script.pip("cache", "list", "zzz", "--format=abspath", "--verbose")
+
+    assert not list_matches_wheel_abspath("yyy-1.2.3", result)
+    assert list_matches_wheel_abspath("zzz-4.5.6", result)
+    assert list_matches_wheel_abspath("zzz-4.5.7", result)
+    assert list_matches_wheel_abspath("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_list_name_and_version_match(script: PipTestEnvironment) -> None:
+    """Running `pip cache list zzz-4.5.6` should list zzz-4.5.6, but
+    nothing else."""
+    result = script.pip("cache", "list", "zzz-4.5.6", "--verbose")
+
+    assert not list_matches_wheel("yyy-1.2.3", result)
+    assert list_matches_wheel("zzz-4.5.6", result)
+    assert not list_matches_wheel("zzz-4.5.7", result)
+    assert not list_matches_wheel("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_list_name_and_version_match_abspath(script: PipTestEnvironment) -> None:
+    """Running `pip cache list zzz-4.5.6 --format=abspath` should list path of
+    zzz-4.5.6, but nothing else."""
+    result = script.pip("cache", "list", "zzz-4.5.6", "--format=abspath", "--verbose")
+
+    assert not list_matches_wheel_abspath("yyy-1.2.3", result)
+    assert list_matches_wheel_abspath("zzz-4.5.6", result)
+    assert not list_matches_wheel_abspath("zzz-4.5.7", result)
+    assert not list_matches_wheel_abspath("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_remove_no_arguments(script: PipTestEnvironment) -> None:
+    """Running `pip cache remove` with no arguments should cause an error."""
+    script.pip("cache", "remove", expect_error=True)
+
+
+def test_cache_remove_too_many_args(script: PipTestEnvironment) -> None:
+    """Passing `pip cache remove` too many arguments should cause an error."""
+    script.pip("cache", "remove", "aaa", "bbb", expect_error=True)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_remove_name_match(
+    script: PipTestEnvironment, remove_matches_wheel: RemoveMatches
+) -> None:
+    """Running `pip cache remove zzz` should remove zzz-4.5.6 and zzz-7.8.9,
+    but nothing else."""
+    result = script.pip("cache", "remove", "zzz", "--verbose")
+
+    assert not remove_matches_wheel("yyy-1.2.3", result)
+    assert remove_matches_wheel("zzz-4.5.6", result)
+    assert remove_matches_wheel("zzz-4.5.7", result)
+    assert remove_matches_wheel("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_wheel_cache")
+def test_cache_remove_name_and_version_match(
+    script: PipTestEnvironment, remove_matches_wheel: RemoveMatches
+) -> None:
+    """Running `pip cache remove zzz-4.5.6` should remove zzz-4.5.6, but
+    nothing else."""
+    result = script.pip("cache", "remove", "zzz-4.5.6", "--verbose")
+
+    assert not remove_matches_wheel("yyy-1.2.3", result)
+    assert remove_matches_wheel("zzz-4.5.6", result)
+    assert not remove_matches_wheel("zzz-4.5.7", result)
+    assert not remove_matches_wheel("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_http_cache", "populate_wheel_cache")
+def test_cache_purge(
+    script: PipTestEnvironment,
+    remove_matches_http: RemoveMatches,
+    remove_matches_wheel: RemoveMatches,
+) -> None:
+    """Running `pip cache purge` should remove all cached http files and
+    wheels."""
+    result = script.pip("cache", "purge", "--verbose")
+
+    assert remove_matches_http("aaaaaaaaa", result)
+    assert remove_matches_http("bbbbbbbbb", result)
+    assert remove_matches_http("ccccccccc", result)
+
+    assert remove_matches_wheel("yyy-1.2.3", result)
+    assert remove_matches_wheel("zzz-4.5.6", result)
+    assert remove_matches_wheel("zzz-4.5.7", result)
+    assert remove_matches_wheel("zzz-7.8.9", result)
+
+
+@pytest.mark.usefixtures("populate_http_cache", "populate_wheel_cache")
+def test_cache_purge_too_many_args(
+    script: PipTestEnvironment,
+    http_cache_files: Liststr,
+    wheel_cache_files: Liststr,
+) -> None:
+    """Running `pip cache purge aaa` should raise an error and remove no
+    cached http files or wheels."""
+    result = script.pip("cache", "purge", "aaa", "--verbose", expect_error=True)
+    assert result.stdout == ""
+
+    # This would be `result.stderr == ...`, but pip prints deprecation
+    # warnings on Python 2.7, so we check if the _line_ is in stderr.
+    assert "ERROR: Too many arguments" in result.stderr.splitlines()
+
+    # Make sure nothing was deleted.
+    for filename in http_cache_files + wheel_cache_files:
+        assert os.path.exists(filename)
+
+
+@pytest.mark.parametrize("command", "info", "list", "remove", "purge")
+def test_cache_abort_when_no_cache_dir(
+    script: PipTestEnvironment, command: str
+) -> None:
+    """Running any pip cache command when cache is disabled should
+    abort and log an informative error"""
+    result = script.pip("cache", command, "--no-cache-dir", expect_error=True)
+    assert result.stdout == ""
+
+    assert (
+        "ERROR: pip cache commands can not function"
+        " since cache is disabled." in result.stderr.splitlines()
+    )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_check.py Added

@@ -0,0 +1,311 @@
+from typing import Collection
+
+from tests.lib import PipTestEnvironment, create_test_package_with_setup
+
+
+def matches_expected_lines(string: str, expected_lines: Collectionstr) -> bool:
+    # Ignore empty lines
+    output_lines = list(filter(None, string.splitlines()))
+    # We'll match the last n lines, given n lines to match.
+    last_few_output_lines = output_lines-len(expected_lines) :
+    # And order does not matter
+    return set(last_few_output_lines) == set(expected_lines)
+
+
+def test_basic_check_clean(script: PipTestEnvironment) -> None:
+    """On a clean environment, check should print a helpful message."""
+    result = script.pip("check")
+
+    expected_lines = ("No broken requirements found.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 0
+
+
+def test_basic_check_missing_dependency(script: PipTestEnvironment) -> None:
+    # Setup a small project
+    pkga_path = create_test_package_with_setup(
+        script,
+        name="pkga",
+        version="1.0",
+        install_requires="missing==0.1",
+    )
+    # Let's install pkga without its dependency
+    res = script.pip("install", "--no-index", pkga_path, "--no-deps")
+    assert "Successfully installed pkga-1.0" in res.stdout, str(res)
+
+    result = script.pip("check", expect_error=True)
+
+    expected_lines = ("pkga 1.0 requires missing, which is not installed.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1
+
+
+def test_basic_check_broken_dependency(script: PipTestEnvironment) -> None:
+    # Setup pkga depending on pkgb>=1.0
+    pkga_path = create_test_package_with_setup(
+        script,
+        name="pkga",
+        version="1.0",
+        install_requires="broken>=1.0",
+    )
+    # Let's install pkga without its dependency
+    res = script.pip("install", "--no-index", pkga_path, "--no-deps")
+    assert "Successfully installed pkga-1.0" in res.stdout, str(res)
+
+    # Setup broken==0.1
+    broken_path = create_test_package_with_setup(
+        script,
+        name="broken",
+        version="0.1",
+    )
+    # Let's install broken==0.1
+    res = script.pip(
+        "install",
+        "--no-index",
+        broken_path,
+        "--no-warn-conflicts",
+    )
+    assert "Successfully installed broken-0.1" in res.stdout, str(res)
+
+    result = script.pip("check", expect_error=True)
+
+    expected_lines = ("pkga 1.0 has requirement broken>=1.0, but you have broken 0.1.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1
+
+
+def test_basic_check_broken_dependency_and_missing_dependency(
+    script: PipTestEnvironment,
+) -> None:
+    pkga_path = create_test_package_with_setup(
+        script,
+        name="pkga",
+        version="1.0",
+        install_requires="broken>=1.0",
+    )
+    # Let's install pkga without its dependency
+    res = script.pip("install", "--no-index", pkga_path, "--no-deps")
+    assert "Successfully installed pkga-1.0" in res.stdout, str(res)
+
+    # Setup broken==0.1
+    broken_path = create_test_package_with_setup(
+        script,
+        name="broken",
+        version="0.1",
+        install_requires="missing",
+    )
+    # Let's install broken==0.1
+    res = script.pip("install", "--no-index", broken_path, "--no-deps")
+    assert "Successfully installed broken-0.1" in res.stdout, str(res)
+
+    result = script.pip("check", expect_error=True)
+
+    expected_lines = (
+        "broken 0.1 requires missing, which is not installed.",
+        "pkga 1.0 has requirement broken>=1.0, but you have broken 0.1.",
+    )
+
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1
+
+
+def test_check_complicated_name_missing(script: PipTestEnvironment) -> None:
+    package_a_path = create_test_package_with_setup(
+        script,
+        name="package_A",
+        version="1.0",
+        install_requires="Dependency-B>=1.0",
+    )
+
+    # Without dependency
+    result = script.pip("install", "--no-index", package_a_path, "--no-deps")
+    assert "Successfully installed package-A-1.0" in result.stdout, str(result)
+
+    result = script.pip("check", expect_error=True)
+    expected_lines = ("package-a 1.0 requires dependency-b, which is not installed.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1
+
+
+def test_check_complicated_name_broken(script: PipTestEnvironment) -> None:
+    package_a_path = create_test_package_with_setup(
+        script,
+        name="package_A",
+        version="1.0",
+        install_requires="Dependency-B>=1.0",
+    )
+    dependency_b_path_incompatible = create_test_package_with_setup(
+        script,
+        name="dependency-b",
+        version="0.1",
+    )
+
+    # With broken dependency
+    result = script.pip("install", "--no-index", package_a_path, "--no-deps")
+    assert "Successfully installed package-A-1.0" in result.stdout, str(result)
+
+    result = script.pip(
+        "install",
+        "--no-index",
+        dependency_b_path_incompatible,
+        "--no-deps",
+    )
+    assert "Successfully installed dependency-b-0.1" in result.stdout
+
+    result = script.pip("check", expect_error=True)
+    expected_lines = (
+        "package-a 1.0 has requirement Dependency-B>=1.0, but you have "
+        "dependency-b 0.1.",
+    )
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1
+
+
+def test_check_complicated_name_clean(script: PipTestEnvironment) -> None:
+    package_a_path = create_test_package_with_setup(
+        script,
+        name="package_A",
+        version="1.0",
+        install_requires="Dependency-B>=1.0",
+    )
+    dependency_b_path = create_test_package_with_setup(
+        script,
+        name="dependency-b",
+        version="1.0",
+    )
+
+    result = script.pip("install", "--no-index", package_a_path, "--no-deps")
+    assert "Successfully installed package-A-1.0" in result.stdout, str(result)
+
+    result = script.pip(
+        "install",
+        "--no-index",
+        dependency_b_path,
+        "--no-deps",
+    )
+    assert "Successfully installed dependency-b-1.0" in result.stdout
+
+    result = script.pip("check")
+    expected_lines = ("No broken requirements found.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 0
+
+
+def test_check_considers_conditional_reqs(script: PipTestEnvironment) -> None:
+    package_a_path = create_test_package_with_setup(
+        script,
+        name="package_A",
+        version="1.0",
+        install_requires=
+            "Dependency-B>=1.0; python_version != '2.7'",
+            "Dependency-B>=2.0; python_version == '2.7'",
+        ,
+    )
+
+    result = script.pip("install", "--no-index", package_a_path, "--no-deps")
+    assert "Successfully installed package-A-1.0" in result.stdout, str(result)
+
+    result = script.pip("check", expect_error=True)
+    expected_lines = ("package-a 1.0 requires dependency-b, which is not installed.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1
+
+
+def test_check_development_versions_are_also_considered(
+    script: PipTestEnvironment,
+) -> None:
+    # Setup pkga depending on pkgb>=1.0
+    pkga_path = create_test_package_with_setup(
+        script,
+        name="pkga",
+        version="1.0",
+        install_requires="depend>=1.0",
+    )
+    # Let's install pkga without its dependency
+    res = script.pip("install", "--no-index", pkga_path, "--no-deps")
+    assert "Successfully installed pkga-1.0" in res.stdout, str(res)
+
+    # Setup depend==1.1.0.dev0
+    depend_path = create_test_package_with_setup(
+        script,
+        name="depend",
+        version="1.1.0.dev0",
+    )
+    # Let's install depend==1.1.0.dev0
+    res = script.pip(
+        "install",
+        "--no-index",
+        depend_path,
+        "--no-warn-conflicts",
+    )
+    assert "Successfully installed depend-1.1.0.dev0" in res.stdout, str(res)
+
+    result = script.pip("check")
+    expected_lines = ("No broken requirements found.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 0
+
+
+def test_basic_check_broken_metadata(script: PipTestEnvironment) -> None:
+    # Create some corrupt metadata
+    dist_info_dir = script.site_packages_path / "pkga-1.0.dist-info"
+    dist_info_dir.mkdir()
+    with open(dist_info_dir / "METADATA", "w") as f:
+        f.write(
+            "Metadata-Version: 2.1\n"
+            "Name: pkga\n"
+            "Version: 1.0\n"
+            'Requires-Dist: pip; python_version == "3.4";extra == "test"\n'
+        )
+
+    result = script.pip("check", expect_error=True)
+
+    assert "Error parsing requirements" in result.stderr
+    assert result.returncode == 1
+
+
+def test_check_skip_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that check should not include package
+    present in working directory
+    """
+
+    # Create a test package with dependency missing
+    # and create .egg-info dir
+    pkg_path = create_test_package_with_setup(
+        script, name="simple", version="1.0", install_requires="missing==0.1"
+    )
+
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    # Check should not complain about broken requirements
+    # when run from package directory
+    result = script.pip("check", cwd=pkg_path)
+    expected_lines = ("No broken requirements found.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 0
+
+
+def test_check_include_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that check should include package in working directory
+    if working directory is added in PYTHONPATH
+    """
+
+    # Create a test package with dependency missing
+    # and create .egg-info dir
+    pkg_path = create_test_package_with_setup(
+        script, name="simple", version="1.0", install_requires="missing==0.1"
+    )
+
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    script.environ.update({"PYTHONPATH": pkg_path})
+
+    # Check should mention about missing requirement simple
+    # when run from package directory, when package directory
+    # is in PYTHONPATH
+    result = script.pip("check", expect_error=True, cwd=pkg_path)
+    expected_lines = ("simple 1.0 requires missing, which is not installed.",)
+    assert matches_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 1

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_cli.py Added

@@ -0,0 +1,49 @@
+"""Basic CLI functionality checks.
+"""
+from textwrap import dedent
+
+import pytest
+
+from tests.lib import PipTestEnvironment
+
+
+@pytest.mark.parametrize(
+    "entrypoint",
+    
+        ("fake_pip = pip._internal.main:main",),
+        ("fake_pip = pip._internal:main",),
+        ("fake_pip = pip:main",),
+    ,
+)
+def test_entrypoints_work(entrypoint: str, script: PipTestEnvironment) -> None:
+    if script.zipapp:
+        pytest.skip("Zipapp does not include entrypoints")
+
+    fake_pkg = script.temp_path / "fake_pkg"
+    fake_pkg.mkdir()
+    fake_pkg.joinpath("setup.py").write_text(
+        dedent(
+            """
+    from setuptools import setup
+
+    setup(
+        name="fake-pip",
+        version="0.1.0",
+        entry_points={{
+            "console_scripts": 
+                {!r}
+            
+        }}
+    )
+    """.format(
+                entrypoint
+            )
+        )
+    )
+
+    # expect_temp because pip install will generate fake_pkg.egg-info
+    script.pip("install", "-vvv", str(fake_pkg), expect_temp=True)
+    result = script.pip("-V")
+    result2 = script.run("fake_pip", "-V", allow_stderr_warning=True)
+    assert result.stdout == result2.stdout
+    assert "old script wrapper" in result2.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_completion.py Added

@@ -0,0 +1,407 @@
+import os
+import sys
+from pathlib import Path
+from typing import TYPE_CHECKING, Tuple, Union
+
+import pytest
+
+from tests.conftest import ScriptFactory
+from tests.lib import PipTestEnvironment, TestData, TestPipResult
+
+if TYPE_CHECKING:
+    from typing import Protocol
+else:
+    # TODO: Protocol was introduced in Python 3.8. Remove this branch when
+    # dropping support for Python 3.7.
+    Protocol = object
+
+
+COMPLETION_FOR_SUPPORTED_SHELLS_TESTS = (
+    (
+        "bash",
+        """\
+_pip_completion()
+{
+    COMPREPLY=( $( COMP_WORDS="${COMP_WORDS*}" \\
+                   COMP_CWORD=$COMP_CWORD \\
+                   PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) )
+}
+complete -o default -F _pip_completion pip""",
+    ),
+    (
+        "fish",
+        """\
+function __fish_complete_pip
+    set -lx COMP_WORDS (commandline -o) ""
+    set -lx COMP_CWORD ( \\
+        math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\
+    )
+    set -lx PIP_AUTO_COMPLETE 1
+    string split \\  -- (eval $COMP_WORDS1)
+end
+complete -fa "(__fish_complete_pip)" -c pip""",
+    ),
+    (
+        "zsh",
+        """\
+function _pip_completion {
+  local words cword
+  read -Ac words
+  read -cn cword
+  reply=( $( COMP_WORDS="$words*" \\
+             COMP_CWORD=$(( cword-1 )) \\
+             PIP_AUTO_COMPLETE=1 $words1 2>/dev/null ))
+}
+compctl -K _pip_completion pip""",
+    ),
+    (
+        "powershell",
+        """\
+if ((Test-Path Function:\\TabExpansion) -and -not `
+    (Test-Path Function:\\_pip_completeBackup)) {
+    Rename-Item Function:\\TabExpansion _pip_completeBackup
+}
+function TabExpansion($line, $lastWord) {
+    $lastBlock = regex::Split($line, '|;')-1.TrimStart()
+    if ($lastBlock.StartsWith("pip ")) {
+        $Env:COMP_WORDS=$lastBlock
+        $Env:COMP_CWORD=$lastBlock.Split().Length - 1
+        $Env:PIP_AUTO_COMPLETE=1
+        (& pip).Split()
+        Remove-Item Env:COMP_WORDS
+        Remove-Item Env:COMP_CWORD
+        Remove-Item Env:PIP_AUTO_COMPLETE
+    }
+    elseif (Test-Path Function:\\_pip_completeBackup) {
+        # Fall back on existing tab expansion
+        _pip_completeBackup $line $lastWord
+    }
+}""",
+    ),
+)
+
+
+@pytest.fixture(scope="session")
+def script_with_launchers(
+    tmpdir_factory: pytest.TempPathFactory,
+    script_factory: ScriptFactory,
+    common_wheels: Path,
+    pip_src: Path,
+) -> PipTestEnvironment:
+    tmpdir = tmpdir_factory.mktemp("script_with_launchers")
+    script = script_factory(tmpdir.joinpath("workspace"))
+    # Re-install pip so we get the launchers.
+    script.pip_install_local("-f", common_wheels, pip_src)
+    return script
+
+
+@pytest.mark.parametrize(
+    "shell, completion",
+    COMPLETION_FOR_SUPPORTED_SHELLS_TESTS,
+    ids=t0 for t in COMPLETION_FOR_SUPPORTED_SHELLS_TESTS,
+)
+def test_completion_for_supported_shells(
+    script_with_launchers: PipTestEnvironment, shell: str, completion: str
+) -> None:
+    """
+    Test getting completion for bash shell
+    """
+    result = script_with_launchers.pip("completion", "--" + shell, use_module=False)
+    actual = str(result.stdout)
+    if script_with_launchers.zipapp:
+        # The zipapp reports its name as "pip.pyz", but the expected
+        # output assumes "pip"
+        actual = actual.replace("pip.pyz", "pip")
+    assert completion in actual, actual
+
+
+@pytest.fixture(scope="session")
+def autocomplete_script(
+    tmpdir_factory: pytest.TempPathFactory, script_factory: ScriptFactory
+) -> PipTestEnvironment:
+    tmpdir = tmpdir_factory.mktemp("autocomplete_script")
+    return script_factory(tmpdir.joinpath("workspace"))
+
+
+class DoAutocomplete(Protocol):
+    def __call__(
+        self, words: str, cword: str, cwd: UnionPath, str, None = None
+    ) -> TupleTestPipResult, PipTestEnvironment:
+        ...
+
+
+@pytest.fixture
+def autocomplete(
+    autocomplete_script: PipTestEnvironment, monkeypatch: pytest.MonkeyPatch
+) -> DoAutocomplete:
+    monkeypatch.setattr(autocomplete_script, "environ", os.environ.copy())
+    autocomplete_script.environ"PIP_AUTO_COMPLETE" = "1"
+
+    def do_autocomplete(
+        words: str, cword: str, cwd: UnionPath, str, None = None
+    ) -> TupleTestPipResult, PipTestEnvironment:
+        autocomplete_script.environ"COMP_WORDS" = words
+        autocomplete_script.environ"COMP_CWORD" = cword
+        result = autocomplete_script.run(
+            "python",
+            "-c",
+            "from pip._internal.cli.autocompletion import autocomplete;"
+            "autocomplete()",
+            expect_error=True,
+            cwd=cwd,
+        )
+
+        return result, autocomplete_script
+
+    return do_autocomplete
+
+
+def test_completion_for_unknown_shell(autocomplete_script: PipTestEnvironment) -> None:
+    """
+    Test getting completion for an unknown shell
+    """
+    error_msg = "no such option: --myfooshell"
+    result = autocomplete_script.pip("completion", "--myfooshell", expect_error=True)
+    assert error_msg in result.stderr, "tests for an unknown shell failed"
+
+
+def test_completion_alone(autocomplete_script: PipTestEnvironment) -> None:
+    """
+    Test getting completion for none shell, just pip completion
+    """
+    result = autocomplete_script.pip("completion", allow_stderr_error=True)
+    assert (
+        "ERROR: You must pass --bash or --fish or --powershell or --zsh"
+        in result.stderr
+    ), ("completion alone failed -- " + result.stderr)
+
+
+def test_completion_for_un_snippet(autocomplete: DoAutocomplete) -> None:
+    """
+    Test getting completion for ``un`` should return uninstall
+    """
+
+    res, env = autocomplete("pip un", "1")
+    assert res.stdout.strip().split() == "uninstall", res.stdout
+
+
+def test_completion_for_default_parameters(autocomplete: DoAutocomplete) -> None:
+    """
+    Test getting completion for ``--`` should contain --help
+    """
+
+    res, env = autocomplete("pip --", "1")
+    assert "--help" in res.stdout, "autocomplete function could not complete ``--``"
+
+
+def test_completion_option_for_command(autocomplete: DoAutocomplete) -> None:
+    """
+    Test getting completion for ``--`` in command (e.g. ``pip search --``)
+    """
+
+    res, env = autocomplete("pip search --", "2")
+    assert "--help" in res.stdout, "autocomplete function could not complete ``--``"
+
+
+def test_completion_short_option(autocomplete: DoAutocomplete) -> None:
+    """
+    Test getting completion for short options after ``-`` (eg. pip -)
+    """
+
+    res, env = autocomplete("pip -", "1")
+
+    assert (
+        "-h" in res.stdout.split()
+    ), "autocomplete function could not complete short options after ``-``"
+
+
+def test_completion_short_option_for_command(autocomplete: DoAutocomplete) -> None:
+    """
+    Test getting completion for short options after ``-`` in command
+    (eg. pip search -)
+    """
+
+    res, env = autocomplete("pip search -", "2")
+
+    assert (
+        "-h" in res.stdout.split()
+    ), "autocomplete function could not complete short options after ``-``"
+
+
+def test_completion_files_after_option(
+    autocomplete: DoAutocomplete, data: TestData
+) -> None:
+    """
+    Test getting completion for <file> or <dir> after options in command
+    (e.g. ``pip install -r``)
+    """
+    res, env = autocomplete(
+        words=("pip install -r r"),
+        cword="3",
+        cwd=data.completion_paths,
+    )
+    assert (
+        "requirements.txt" in res.stdout
+    ), "autocomplete function could not complete <file> after options in command"
+    assert (
+        os.path.join("resources", "") in res.stdout
+    ), "autocomplete function could not complete <dir> after options in command"
+    assert not any(
+        out in res.stdout for out in (os.path.join("REPLAY", ""), "README.txt")
+    ), (
+        "autocomplete function completed <file> or <dir> that "
+        "should not be completed"
+    )
+    if sys.platform != "win32":
+        return
+    assert (
+        "readme.txt" in res.stdout
+    ), "autocomplete function could not complete <file> after options in command"
+    assert (
+        os.path.join("replay", "") in res.stdout
+    ), "autocomplete function could not complete <dir> after options in command"
+
+
+def test_completion_not_files_after_option(
+    autocomplete: DoAutocomplete, data: TestData
+) -> None:
+    """
+    Test not getting completion files after options which not applicable
+    (e.g. ``pip wheel``)
+    """
+    res, env = autocomplete(
+        words=("pip wheel r"),
+        cword="2",
+        cwd=data.completion_paths,
+    )
+    assert not any(
+        out in res.stdout
+        for out in (
+            "requirements.txt",
+            "readme.txt",
+        )
+    ), "autocomplete function completed <file> when it should not complete"
+    assert not any(
+        os.path.join(out, "") in res.stdout for out in ("replay", "resources")
+    ), "autocomplete function completed <dir> when it should not complete"
+
+
+def test_pip_install_complete_files(
+    autocomplete: DoAutocomplete, data: TestData
+) -> None:
+    """``pip install`` autocompletes wheel and sdist files."""
+    res, env = autocomplete(
+        words=("pip install r"),
+        cword="2",
+        cwd=data.completion_paths,
+    )
+    assert all(
+        out in res.stdout
+        for out in (
+            "requirements.txt",
+            "resources",
+        )
+    ), "autocomplete function could not complete <path>"
+
+
+@pytest.mark.parametrize("cl_opts", "-U", "--user", "-h")
+def test_completion_not_files_after_nonexpecting_option(
+    autocomplete: DoAutocomplete, data: TestData, cl_opts: str
+) -> None:
+    """
+    Test not getting completion files after options which not applicable
+    (e.g. ``pip install``)
+    """
+    res, env = autocomplete(
+        words=(f"pip install {cl_opts} r"),
+        cword="2",
+        cwd=data.completion_paths,
+    )
+    assert not any(
+        out in res.stdout
+        for out in (
+            "requirements.txt",
+            "readme.txt",
+        )
+    ), "autocomplete function completed <file> when it should not complete"
+    assert not any(
+        os.path.join(out, "") in res.stdout for out in ("replay", "resources")
+    ), "autocomplete function completed <dir> when it should not complete"
+
+
+def test_completion_directories_after_option(
+    autocomplete: DoAutocomplete, data: TestData
+) -> None:
+    """
+    Test getting completion <dir> after options in command
+    (e.g. ``pip --cache-dir``)
+    """
+    res, env = autocomplete(
+        words=("pip --cache-dir r"),
+        cword="2",
+        cwd=data.completion_paths,
+    )
+    assert (
+        os.path.join("resources", "") in res.stdout
+    ), "autocomplete function could not complete <dir> after options"
+    assert not any(
+        out in res.stdout
+        for out in ("requirements.txt", "README.txt", os.path.join("REPLAY", ""))
+    ), "autocomplete function completed <dir> when it should not complete"
+    if sys.platform == "win32":
+        assert (
+            os.path.join("replay", "") in res.stdout
+        ), "autocomplete function could not complete <dir> after options"
+
+
+def test_completion_subdirectories_after_option(
+    autocomplete: DoAutocomplete, data: TestData
+) -> None:
+    """
+    Test getting completion <dir> after options in command
+    given path of a directory
+    """
+    res, env = autocomplete(
+        words=("pip --cache-dir " + os.path.join("resources", "")),
+        cword="2",
+        cwd=data.completion_paths,
+    )
+    assert os.path.join("resources", os.path.join("images", "")) in res.stdout, (
+        "autocomplete function could not complete <dir> "
+        "given path of a directory after options"
+    )
+
+
+def test_completion_path_after_option(
+    autocomplete: DoAutocomplete, data: TestData
+) -> None:
+    """
+    Test getting completion <path> after options in command
+    given absolute path
+    """
+    res, env = autocomplete(
+        words=("pip install -e " + os.path.join(data.completion_paths, "R")),
+        cword="3",
+    )
+    assert all(
+        os.path.normcase(os.path.join(data.completion_paths, out)) in res.stdout
+        for out in ("README.txt", os.path.join("REPLAY", ""))
+    ), (
+        "autocomplete function could not complete <path> "
+        "after options in command given absolute path"
+    )
+
+
+@pytest.mark.parametrize("flag", "--bash", "--zsh", "--fish", "--powershell")
+def test_completion_uses_same_executable_name(
+    autocomplete_script: PipTestEnvironment, flag: str, deprecated_python: bool
+) -> None:
+    executable_name = "pip{}".format(sys.version_info0)
+    # Deprecated python versions produce an extra deprecation warning
+    result = autocomplete_script.run(
+        executable_name,
+        "completion",
+        flag,
+        expect_stderr=deprecated_python,
+    )
+    assert executable_name in result.stdout

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_config_settings.py Added

@@ -0,0 +1,303 @@
+import json
+import tarfile
+from pathlib import Path
+from typing import List, Optional, Tuple
+from zipfile import ZipFile
+
+from pip._internal.utils.urls import path_to_url
+from tests.lib import PipTestEnvironment, create_basic_sdist_for_package
+
+PYPROJECT_TOML = """\
+build-system
+requires = 
+build-backend = "dummy_backend:main"
+backend-path = "backend"
+"""
+
+BACKEND_SRC = '''
+import csv
+import json
+import os.path
+from zipfile import ZipFile
+import hashlib
+import base64
+import io
+
+WHEEL = """\
+Wheel-Version: 1.0
+Generator: dummy_backend 1.0
+Root-Is-Purelib: true
+Tag: py3-none-any
+"""
+
+METADATA = """\
+Metadata-Version: 2.1
+Name: {project}
+Version: {version}
+Summary: A dummy package
+Author: None
+Author-email: none@example.org
+License: MIT
+{requires_dist}
+"""
+
+def make_wheel(z, project, version, requires_dist, files):
+    record = 
+    def add_file(name, data):
+        data = data.encode("utf-8")
+        z.writestr(name, data)
+        digest = hashlib.sha256(data).digest()
+        hash = base64.urlsafe_b64encode(digest).rstrip(b"=").decode("ASCII")
+        record.append((name, f"sha256={hash}", len(data)))
+    distinfo = f"{project}-{version}.dist-info"
+    add_file(f"{distinfo}/WHEEL", WHEEL)
+    add_file(f"{distinfo}/METADATA", METADATA.format(
+        project=project, version=version, requires_dist=requires_dist
+    ))
+    for name, data in files:
+        add_file(name, data)
+    record_name = f"{distinfo}/RECORD"
+    record.append((record_name, "", ""))
+    b = io.BytesIO()
+    rec = io.TextIOWrapper(b, newline="", encoding="utf-8")
+    w = csv.writer(rec)
+    w.writerows(record)
+    z.writestr(record_name, b.getvalue())
+    rec.close()
+
+
+class Backend:
+    def build_wheel(
+        self,
+        wheel_directory,
+        config_settings=None,
+        metadata_directory=None
+    ):
+        if config_settings is None:
+            config_settings = {}
+        w = os.path.join(wheel_directory, "{{name}}-1.0-py3-none-any.whl")
+        with open(w, "wb") as f:
+            with ZipFile(f, "w") as z:
+                make_wheel(
+                    z, "{{name}}", "1.0", "{{requires_dist}}",
+                    ("{{name}}-config.json", json.dumps(config_settings))
+                )
+        return "{{name}}-1.0-py3-none-any.whl"
+
+    build_editable = build_wheel
+
+main = Backend()
+'''
+
+
+def make_project(
+    path: Path, name: str = "foo", dependencies: OptionalListstr = None
+) -> Tuplestr, str, Path:
+    version = "1.0"
+    project_dir = path / name
+    backend = project_dir / "backend"
+    backend.mkdir(parents=True)
+    (project_dir / "pyproject.toml").write_text(PYPROJECT_TOML)
+    requires_dist = f"Requires-Dist: {dep}" for dep in dependencies or 
+    (backend / "dummy_backend.py").write_text(
+        BACKEND_SRC.replace("{{name}}", name).replace(
+            "{{requires_dist}}", "\n".join(requires_dist)
+        )
+    )
+    return name, version, project_dir
+
+
+def test_backend_sees_config(script: PipTestEnvironment) -> None:
+    name, version, project_dir = make_project(script.scratch_path)
+    script.pip(
+        "wheel",
+        "--config-settings",
+        "FOO=Hello",
+        project_dir,
+    )
+    wheel_file_name = f"{name}-{version}-py3-none-any.whl"
+    wheel_file_path = script.cwd / wheel_file_name
+    with open(wheel_file_path, "rb") as f:
+        with ZipFile(f) as z:
+            output = z.read(f"{name}-config.json")
+            assert json.loads(output) == {"FOO": "Hello"}
+
+
+def test_backend_sees_config_reqs(script: PipTestEnvironment) -> None:
+    name, version, project_dir = make_project(script.scratch_path)
+    script.scratch_path.joinpath("reqs.txt").write_text(
+        f"{project_dir} --config-settings FOO=Hello"
+    )
+    script.pip("wheel", "-r", "reqs.txt")
+    wheel_file_name = f"{name}-{version}-py3-none-any.whl"
+    wheel_file_path = script.cwd / wheel_file_name
+    with open(wheel_file_path, "rb") as f:
+        with ZipFile(f) as z:
+            output = z.read(f"{name}-config.json")
+            assert json.loads(output) == {"FOO": "Hello"}
+
+
+def test_backend_sees_config_via_constraint(script: PipTestEnvironment) -> None:
+    name, version, project_dir = make_project(script.scratch_path)
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"{name} @ {path_to_url(str(project_dir))}")
+    script.pip(
+        "wheel",
+        "--config-settings",
+        "FOO=Hello",
+        "-c",
+        "constraints.txt",
+        name,
+    )
+    wheel_file_name = f"{name}-{version}-py3-none-any.whl"
+    wheel_file_path = script.cwd / wheel_file_name
+    with open(wheel_file_path, "rb") as f:
+        with ZipFile(f) as z:
+            output = z.read(f"{name}-config.json")
+            assert json.loads(output) == {"FOO": "Hello"}
+
+
+def test_backend_sees_config_via_sdist(script: PipTestEnvironment) -> None:
+    name, version, project_dir = make_project(script.scratch_path)
+    dists_dir = script.scratch_path / "dists"
+    dists_dir.mkdir()
+    with tarfile.open(dists_dir / f"{name}-{version}.tar.gz", "w:gz") as dist_tar:
+        dist_tar.add(project_dir, arcname=name)
+    script.pip(
+        "wheel",
+        "--config-settings",
+        "FOO=Hello",
+        "-f",
+        dists_dir,
+        name,
+    )
+    wheel_file_name = f"{name}-{version}-py3-none-any.whl"
+    wheel_file_path = script.cwd / wheel_file_name
+    with open(wheel_file_path, "rb") as f:
+        with ZipFile(f) as z:
+            output = z.read(f"{name}-config.json")
+            assert json.loads(output) == {"FOO": "Hello"}
+
+
+def test_req_file_does_not_see_config(script: PipTestEnvironment) -> None:
+    """Test that CLI config settings do not propagate to requirement files."""
+    name, _, project_dir = make_project(script.scratch_path)
+    reqs_file = script.scratch_path / "reqs.txt"
+    reqs_file.write_text(f"{project_dir}")
+    script.pip(
+        "install",
+        "--config-settings",
+        "FOO=Hello",
+        "-r",
+        reqs_file,
+    )
+    config = script.site_packages_path / f"{name}-config.json"
+    with open(config, "rb") as f:
+        assert json.load(f) == {}
+
+
+def test_dep_does_not_see_config(script: PipTestEnvironment) -> None:
+    """Test that CLI config settings do not propagate to dependencies."""
+    _, _, bar_project_dir = make_project(script.scratch_path, name="bar")
+    _, _, foo_project_dir = make_project(
+        script.scratch_path,
+        name="foo",
+        dependencies=f"bar @ {path_to_url(str(bar_project_dir))}",
+    )
+    script.pip(
+        "install",
+        "--config-settings",
+        "FOO=Hello",
+        foo_project_dir,
+    )
+    foo_config = script.site_packages_path / "foo-config.json"
+    with open(foo_config, "rb") as f:
+        assert json.load(f) == {"FOO": "Hello"}
+    bar_config = script.site_packages_path / "bar-config.json"
+    with open(bar_config, "rb") as f:
+        assert json.load(f) == {}
+
+
+def test_dep_in_req_file_does_not_see_config(script: PipTestEnvironment) -> None:
+    """Test that CLI config settings do not propagate to dependencies found in
+    requirement files."""
+    _, _, bar_project_dir = make_project(script.scratch_path, name="bar")
+    _, _, foo_project_dir = make_project(
+        script.scratch_path,
+        name="foo",
+        dependencies="bar",
+    )
+    reqs_file = script.scratch_path / "reqs.txt"
+    reqs_file.write_text(f"bar @ {path_to_url(str(bar_project_dir))}")
+    script.pip(
+        "install",
+        "--config-settings",
+        "FOO=Hello",
+        "-r",
+        reqs_file,
+        foo_project_dir,
+    )
+    foo_config = script.site_packages_path / "foo-config.json"
+    with open(foo_config, "rb") as f:
+        assert json.load(f) == {"FOO": "Hello"}
+    bar_config = script.site_packages_path / "bar-config.json"
+    with open(bar_config, "rb") as f:
+        assert json.load(f) == {}
+
+
+def test_install_sees_config(script: PipTestEnvironment) -> None:
+    name, _, project_dir = make_project(script.scratch_path)
+    script.pip(
+        "install",
+        "--config-settings",
+        "FOO=Hello",
+        project_dir,
+    )
+    config = script.site_packages_path / f"{name}-config.json"
+    with open(config, "rb") as f:
+        assert json.load(f) == {"FOO": "Hello"}
+
+
+def test_install_sees_config_reqs(script: PipTestEnvironment) -> None:
+    name, _, project_dir = make_project(script.scratch_path)
+    script.scratch_path.joinpath("reqs.txt").write_text(
+        f"{project_dir} --config-settings FOO=Hello"
+    )
+    script.pip("install", "-r", "reqs.txt")
+    config = script.site_packages_path / f"{name}-config.json"
+    with open(config, "rb") as f:
+        assert json.load(f) == {"FOO": "Hello"}
+
+
+def test_install_editable_sees_config(script: PipTestEnvironment) -> None:
+    name, _, project_dir = make_project(script.scratch_path)
+    script.pip(
+        "install",
+        "--config-settings",
+        "FOO=Hello",
+        "--editable",
+        project_dir,
+    )
+    config = script.site_packages_path / f"{name}-config.json"
+    with open(config, "rb") as f:
+        assert json.load(f) == {"FOO": "Hello"}
+
+
+def test_install_config_reqs(script: PipTestEnvironment) -> None:
+    name, _, project_dir = make_project(script.scratch_path)
+    a_sdist = create_basic_sdist_for_package(
+        script,
+        "foo",
+        "1.0",
+        {"pyproject.toml": PYPROJECT_TOML, "backend/dummy_backend.py": BACKEND_SRC},
+    )
+    script.scratch_path.joinpath("reqs.txt").write_text(
+        f'{project_dir} --config-settings "--build-option=--cffi" '
+        '--config-settings "--build-option=--avx2" '
+        "--config-settings FOO=BAR"
+    )
+    script.pip("install", "--no-index", "-f", str(a_sdist.parent), "-r", "reqs.txt")
+    script.assert_installed(foo="1.0")
+    config = script.site_packages_path / f"{name}-config.json"
+    with open(config, "rb") as f:
+        assert json.load(f) == {"--build-option": "--cffi", "--avx2", "FOO": "BAR"}

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_configuration.py Added

@@ -0,0 +1,149 @@
+"""Tests for the config command
+"""
+import re
+import textwrap
+
+from pip._internal.cli.status_codes import ERROR
+from pip._internal.configuration import CONFIG_BASENAME, get_configuration_files
+from tests.lib import PipTestEnvironment
+from tests.lib.configuration_helpers import ConfigurationMixin, kinds
+from tests.lib.venv import VirtualEnvironment
+
+
+def test_no_options_passed_should_error(script: PipTestEnvironment) -> None:
+    result = script.pip("config", expect_error=True)
+    assert result.returncode == ERROR
+
+
+class TestBasicLoading(ConfigurationMixin):
+    def test_basic_modification_pipeline(self, script: PipTestEnvironment) -> None:
+        script.pip("config", "get", "test.blah", expect_error=True)
+        script.pip("config", "set", "test.blah", "1")
+
+        result = script.pip("config", "get", "test.blah")
+        assert result.stdout.strip() == "1"
+
+        script.pip("config", "unset", "test.blah")
+        script.pip("config", "get", "test.blah", expect_error=True)
+
+    def test_listing_is_correct(self, script: PipTestEnvironment) -> None:
+        script.pip("config", "set", "test.listing-beta", "2")
+        script.pip("config", "set", "test.listing-alpha", "1")
+        script.pip("config", "set", "test.listing-gamma", "3")
+
+        result = script.pip("config", "list")
+
+        lines = list(
+            filter(lambda x: x.startswith("test.listing-"), result.stdout.splitlines())
+        )
+
+        expected = """
+            test.listing-alpha='1'
+            test.listing-beta='2'
+            test.listing-gamma='3'
+        """
+
+        assert lines == textwrap.dedent(expected).strip().splitlines()
+
+    def test_forget_section(self, script: PipTestEnvironment) -> None:
+        result = script.pip("config", "set", "isolated", "true", expect_error=True)
+        assert "global.isolated" in result.stderr
+
+    def test_env_var_values(self, script: PipTestEnvironment) -> None:
+        """Test that pip configuration set with environment variables
+        is correctly displayed under "env_var".
+        """
+
+        env_vars = {
+            "PIP_DEFAULT_TIMEOUT": "60",
+            "PIP_FIND_LINKS": "http://mirror.example.com",
+        }
+        script.environ.update(env_vars)
+
+        result = script.pip("config", "debug")
+        assert "PIP_DEFAULT_TIMEOUT='60'" in result.stdout
+        assert "PIP_FIND_LINKS='http://mirror.example.com'" in result.stdout
+        assert re.search(r"env_var:\n(  .+\n)+", result.stdout)
+
+    def test_env_values(self, script: PipTestEnvironment) -> None:
+        """Test that custom pip configuration using the environment variable
+        PIP_CONFIG_FILE is correctly displayed under "env". This configuration
+        takes place of per-user configuration file displayed under "user".
+        """
+
+        config_file = script.scratch_path / "test-pip.cfg"
+        script.environ"PIP_CONFIG_FILE" = str(config_file)
+        config_file.write_text(
+            textwrap.dedent(
+                """\
+            global
+            timeout = 60
+
+            freeze
+            timeout = 10
+            """
+            )
+        )
+
+        result = script.pip("config", "debug")
+        assert f"{config_file}, exists: True" in result.stdout
+        assert "global.timeout: 60" in result.stdout
+        assert "freeze.timeout: 10" in result.stdout
+        assert re.search(r"env:\n(  .+\n)+", result.stdout)
+
+    def test_user_values(self, script: PipTestEnvironment) -> None:
+        """Test that the user pip configuration set using --user
+        is correctly displayed under "user".  This configuration takes place
+        of custom path location using the environment variable PIP_CONFIG_FILE
+        displayed under "env".
+        """
+
+        # Use new config file
+        new_config_file = get_configuration_files()kinds.USER1
+
+        script.pip("config", "--user", "set", "global.timeout", "60")
+        script.pip("config", "--user", "set", "freeze.timeout", "10")
+
+        result = script.pip("config", "debug")
+        assert f"{new_config_file}, exists: True" in result.stdout
+        assert "global.timeout: 60" in result.stdout
+        assert "freeze.timeout: 10" in result.stdout
+        assert re.search(r"user:\n(  .+\n)+", result.stdout)
+
+    def test_site_values(
+        self, script: PipTestEnvironment, virtualenv: VirtualEnvironment
+    ) -> None:
+        """Test that the current environment configuration set using --site
+        is correctly displayed under "site".
+        """
+
+        # Site config file will be inside the virtualenv
+        site_config_file = virtualenv.location / CONFIG_BASENAME
+
+        script.pip("config", "--site", "set", "global.timeout", "60")
+        script.pip("config", "--site", "set", "freeze.timeout", "10")
+
+        result = script.pip("config", "debug")
+        assert f"{site_config_file}, exists: True" in result.stdout
+        assert "global.timeout: 60" in result.stdout
+        assert "freeze.timeout: 10" in result.stdout
+        assert re.search(r"site:\n(  .+\n)+", result.stdout)
+
+    def test_global_config_file(self, script: PipTestEnvironment) -> None:
+        """Test that the system-wide  configuration can be identified"""
+
+        # We cannot  write to system-wide files which might have permissions
+        # defined in a way that the tox virtualenvcannot write to those
+        # locations. Additionally we cannot patch those paths since pip config
+        # commands runs inside a subprocess.
+        # So we just check if the file can be identified
+        global_config_file = get_configuration_files()kinds.GLOBAL0
+        result = script.pip("config", "debug")
+        assert f"{global_config_file}, exists:" in result.stdout
+
+    def test_editor_does_not_exist(self, script: PipTestEnvironment) -> None:
+        """Ensure that FileNotFoundError sets filename correctly"""
+        result = script.pip(
+            "config", "edit", "--editor", "notrealeditor", expect_error=True
+        )
+        assert "notrealeditor" in result.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_debug.py Added

@@ -0,0 +1,97 @@
+import re
+from typing import List
+
+import pytest
+from pip._vendor.packaging.version import Version
+
+from pip._internal.commands.debug import create_vendor_txt_map
+from pip._internal.utils import compatibility_tags
+from tests.lib import PipTestEnvironment
+
+
+@pytest.mark.parametrize(
+    "expected_text",
+    
+        "sys.executable: ",
+        "sys.getdefaultencoding: ",
+        "sys.getfilesystemencoding: ",
+        "locale.getpreferredencoding: ",
+        "sys.platform: ",
+        "sys.implementation:",
+        "'cert' config value: ",
+        "REQUESTS_CA_BUNDLE: ",
+        "CURL_CA_BUNDLE: ",
+        "pip._vendor.certifi.where(): ",
+        "pip._vendor.DEBUNDLED: ",
+        "vendored library versions:",
+    ,
+)
+def test_debug(script: PipTestEnvironment, expected_text: str) -> None:
+    """
+    Check that certain strings are present in the output.
+    """
+    args = "debug"
+    result = script.pip(*args, allow_stderr_warning=True)
+    stdout = result.stdout
+
+    assert expected_text in stdout
+
+
+def test_debug__library_versions(script: PipTestEnvironment) -> None:
+    """
+    Check the library versions normal output.
+    """
+    args = "debug"
+    result = script.pip(*args, allow_stderr_warning=True)
+    print(result.stdout)
+
+    vendored_versions = create_vendor_txt_map()
+    for name, value in vendored_versions.items():
+        match = re.search(rf"{name}==(\S+)", result.stdout)
+        assert match is not None, f"Could not find {name} in output"
+        assert Version(match.group(1)) == Version(value)
+
+
+@pytest.mark.parametrize(
+    "args",
+    
+        ,
+        "--verbose",
+    ,
+)
+def test_debug__tags(script: PipTestEnvironment, args: Liststr) -> None:
+    """
+    Check the compatible tag output.
+    """
+    args = "debug" + args
+    result = script.pip(*args, allow_stderr_warning=True)
+    stdout = result.stdout
+
+    tags = compatibility_tags.get_supported()
+    expected_tag_header = "Compatible tags: {}".format(len(tags))
+    assert expected_tag_header in stdout
+
+    show_verbose_note = "--verbose" not in args
+    assert (
+        "...\n  First 10 tags shown. Pass --verbose to show all." in stdout
+    ) == show_verbose_note
+
+
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        ("--python-version", "3.7", "(target: version_info='3.7')"),
+    ,
+)
+def test_debug__target_options(
+    script: PipTestEnvironment, args: Liststr, expected: str
+) -> None:
+    """
+    Check passing target-related options.
+    """
+    args = "debug" + args
+    result = script.pip(*args, allow_stderr_warning=True)
+    stdout = result.stdout
+
+    assert "Compatible tags: " in stdout
+    assert expected in stdout

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_download.py Added

@@ -0,0 +1,1583 @@
+import os
+import re
+import shutil
+import textwrap
+import uuid
+from dataclasses import dataclass
+from enum import Enum
+from hashlib import sha256
+from pathlib import Path
+from textwrap import dedent
+from typing import Callable, Dict, List, Tuple
+
+import pytest
+
+from pip._internal.cli.status_codes import ERROR
+from pip._internal.utils.urls import path_to_url
+from tests.conftest import MockServer, ScriptFactory
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    TestPipResult,
+    create_basic_sdist_for_package,
+    create_really_basic_wheel,
+)
+from tests.lib.server import file_response
+
+
+def fake_wheel(data: TestData, wheel_path: str) -> None:
+    wheel_name = os.path.basename(wheel_path)
+    name, version, rest = wheel_name.split("-", 2)
+    wheel_data = create_really_basic_wheel(name, version)
+    data.packages.joinpath(wheel_path).write_bytes(wheel_data)
+
+
+@pytest.mark.network
+def test_download_if_requested(script: PipTestEnvironment) -> None:
+    """
+    It should download (in the scratch path) and not install if requested.
+    """
+    result = script.pip("download", "-d", "pip_downloads", "INITools==0.1")
+    result.did_create(Path("scratch") / "pip_downloads" / "INITools-0.1.tar.gz")
+    result.did_not_create(script.site_packages / "initools")
+
+
+@pytest.mark.network
+def test_basic_download_setuptools(script: PipTestEnvironment) -> None:
+    """
+    It should download (in the scratch path) and not install if requested.
+    """
+    result = script.pip("download", "setuptools")
+    setuptools_prefix = str(Path("scratch") / "setuptools")
+    assert any(os.fspath(p).startswith(setuptools_prefix) for p in result.files_created)
+
+
+def test_download_wheel(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test using "pip download" to download a *.whl archive.
+    """
+    result = script.pip(
+        "download", "--no-index", "-f", data.packages, "-d", ".", "meta"
+    )
+    result.did_create(Path("scratch") / "meta-1.0-py2.py3-none-any.whl")
+    result.did_not_create(script.site_packages / "piptestpackage")
+
+
+@pytest.mark.network
+def test_single_download_from_requirements_file(script: PipTestEnvironment) -> None:
+    """
+    It should support download (in the scratch path) from PyPI from a
+    requirements file
+    """
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+        INITools==0.1
+        """
+        )
+    )
+    result = script.pip(
+        "download",
+        "-r",
+        script.scratch_path / "test-req.txt",
+        "-d",
+        ".",
+    )
+    result.did_create(Path("scratch") / "INITools-0.1.tar.gz")
+    result.did_not_create(script.site_packages / "initools")
+
+
+@pytest.mark.network
+def test_basic_download_should_download_dependencies(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    It should download dependencies (in the scratch path)
+    """
+    result = script.pip("download", "Pasteopenid==1.7.5.1", "-d", ".")
+    result.did_create(Path("scratch") / "Paste-1.7.5.1.tar.gz")
+    openid_tarball_prefix = str(Path("scratch") / "python-openid-")
+    assert any(
+        os.fspath(path).startswith(openid_tarball_prefix)
+        for path in result.files_created
+    )
+    result.did_not_create(script.site_packages / "openid")
+
+
+def test_download_wheel_archive(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    It should download a wheel archive path
+    """
+    wheel_filename = "colander-0.9.9-py2.py3-none-any.whl"
+    wheel_path = "/".join((data.find_links, wheel_filename))
+    result = script.pip("download", wheel_path, "-d", ".", "--no-deps")
+    result.did_create(Path("scratch") / wheel_filename)
+
+
+def test_download_should_download_wheel_deps(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    It should download dependencies for wheels(in the scratch path)
+    """
+    wheel_filename = "colander-0.9.9-py2.py3-none-any.whl"
+    dep_filename = "translationstring-1.1.tar.gz"
+    wheel_path = "/".join((data.find_links, wheel_filename))
+    result = script.pip(
+        "download", wheel_path, "-d", ".", "--find-links", data.find_links, "--no-index"
+    )
+    result.did_create(Path("scratch") / wheel_filename)
+    result.did_create(Path("scratch") / dep_filename)
+
+
+@pytest.mark.network
+def test_download_should_skip_existing_files(script: PipTestEnvironment) -> None:
+    """
+    It should not download files already existing in the scratch dir
+    """
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+        INITools==0.1
+        """
+        )
+    )
+
+    result = script.pip(
+        "download",
+        "-r",
+        script.scratch_path / "test-req.txt",
+        "-d",
+        ".",
+    )
+    result.did_create(Path("scratch") / "INITools-0.1.tar.gz")
+    result.did_not_create(script.site_packages / "initools")
+
+    # adding second package to test-req.txt
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+        INITools==0.1
+        python-openid==2.2.5
+        """
+        )
+    )
+
+    # only the second package should be downloaded
+    result = script.pip(
+        "download",
+        "-r",
+        script.scratch_path / "test-req.txt",
+        "-d",
+        ".",
+    )
+    openid_tarball_prefix = str(Path("scratch") / "python-openid-")
+    assert any(
+        os.fspath(path).startswith(openid_tarball_prefix)
+        for path in result.files_created
+    )
+    result.did_not_create(Path("scratch") / "INITools-0.1.tar.gz")
+    result.did_not_create(script.site_packages / "initools")
+    result.did_not_create(script.site_packages / "openid")
+
+
+@pytest.mark.network
+def test_download_vcs_link(script: PipTestEnvironment) -> None:
+    """
+    It should allow -d flag for vcs links, regression test for issue #798.
+    """
+    result = script.pip(
+        "download", "-d", ".", "git+https://github.com/pypa/pip-test-package.git"
+    )
+    result.did_create(Path("scratch") / "pip-test-package-0.1.1.zip")
+    result.did_not_create(script.site_packages / "piptestpackage")
+
+
+def test_only_binary_set_then_download_specific_platform(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Confirm that specifying an interpreter/platform constraint
+    is allowed when ``--only-binary=:all:`` is set.
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+
+def test_no_deps_set_then_download_specific_platform(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Confirm that specifying an interpreter/platform constraint
+    is allowed when ``--no-deps`` is set.
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--no-deps",
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+
+def test_download_specific_platform_fails(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Confirm that specifying an interpreter/platform constraint
+    enforces that ``--no-deps`` or ``--only-binary=:all:`` is set.
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake",
+        expect_error=True,
+    )
+    assert "--only-binary=:all:" in result.stderr
+
+
+def test_no_binary_set_then_download_specific_platform_fails(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Confirm that specifying an interpreter/platform constraint
+    enforces that ``--only-binary=:all:`` is set without ``--no-binary``.
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--no-binary=fake",
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake",
+        expect_error=True,
+    )
+    assert "--only-binary=:all:" in result.stderr
+
+
+def test_download_specify_platform(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test using "pip download --platform" to download a .whl archive
+    supported for a specific platform
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+
+    # Confirm that universal wheels are returned even for specific
+    # platforms.
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "macosx_10_9_x86_64",
+        "fake",
+    )
+
+    data.reset()
+    fake_wheel(data, "fake-1.0-py2.py3-none-macosx_10_9_x86_64.whl")
+    fake_wheel(data, "fake-2.0-py2.py3-none-linux_x86_64.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "macosx_10_10_x86_64",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-macosx_10_9_x86_64.whl")
+
+    # OSX platform wheels are not backward-compatible.
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "macosx_10_8_x86_64",
+        "fake",
+        expect_error=True,
+    )
+
+    # No linux wheel provided for this version.
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake==1",
+        expect_error=True,
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "linux_x86_64",
+        "fake==2",
+    )
+    result.did_create(Path("scratch") / "fake-2.0-py2.py3-none-linux_x86_64.whl")
+
+    # Test with multiple supported platforms specified.
+    data.reset()
+    fake_wheel(data, "fake-3.0-py2.py3-none-linux_x86_64.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--platform",
+        "manylinux1_x86_64",
+        "--platform",
+        "linux_x86_64",
+        "--platform",
+        "any",
+        "fake==3",
+    )
+    result.did_create(Path("scratch") / "fake-3.0-py2.py3-none-linux_x86_64.whl")
+
+
+class TestDownloadPlatformManylinuxes:
+    """
+    "pip download --platform" downloads a .whl archive supported for
+    manylinux platforms.
+    """
+
+    @pytest.mark.parametrize(
+        "platform",
+        
+            "linux_x86_64",
+            "manylinux1_x86_64",
+            "manylinux2010_x86_64",
+            "manylinux2014_x86_64",
+        ,
+    )
+    def test_download_universal(
+        self, platform: str, script: PipTestEnvironment, data: TestData
+    ) -> None:
+        """
+        Universal wheels are returned even for specific platforms.
+        """
+        fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+        result = script.pip(
+            "download",
+            "--no-index",
+            "--find-links",
+            data.find_links,
+            "--only-binary=:all:",
+            "--dest",
+            ".",
+            "--platform",
+            platform,
+            "fake",
+        )
+        result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+    @pytest.mark.parametrize(
+        "wheel_abi,platform",
+        
+            ("manylinux1_x86_64", "manylinux1_x86_64"),
+            ("manylinux1_x86_64", "manylinux2010_x86_64"),
+            ("manylinux2010_x86_64", "manylinux2010_x86_64"),
+            ("manylinux1_x86_64", "manylinux2014_x86_64"),
+            ("manylinux2010_x86_64", "manylinux2014_x86_64"),
+            ("manylinux2014_x86_64", "manylinux2014_x86_64"),
+        ,
+    )
+    def test_download_compatible_manylinuxes(
+        self,
+        wheel_abi: str,
+        platform: str,
+        script: PipTestEnvironment,
+        data: TestData,
+    ) -> None:
+        """
+        Earlier manylinuxes are compatible with later manylinuxes.
+        """
+        wheel = f"fake-1.0-py2.py3-none-{wheel_abi}.whl"
+        fake_wheel(data, wheel)
+        result = script.pip(
+            "download",
+            "--no-index",
+            "--find-links",
+            data.find_links,
+            "--only-binary=:all:",
+            "--dest",
+            ".",
+            "--platform",
+            platform,
+            "fake",
+        )
+        result.did_create(Path("scratch") / wheel)
+
+    def test_explicit_platform_only(
+        self, data: TestData, script: PipTestEnvironment
+    ) -> None:
+        """
+        When specifying the platform, manylinux1 needs to be the
+        explicit platform--it won't ever be added to the compatible
+        tags.
+        """
+        fake_wheel(data, "fake-1.0-py2.py3-none-linux_x86_64.whl")
+        script.pip(
+            "download",
+            "--no-index",
+            "--find-links",
+            data.find_links,
+            "--only-binary=:all:",
+            "--dest",
+            ".",
+            "--platform",
+            "linux_x86_64",
+            "fake",
+        )
+
+
+def test_download__python_version(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test using "pip download --python-version" to download a .whl archive
+    supported for a specific interpreter
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "2",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "3",
+        "fake",
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "27",
+        "fake",
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "33",
+        "fake",
+    )
+
+    data.reset()
+    fake_wheel(data, "fake-1.0-py2-none-any.whl")
+    fake_wheel(data, "fake-2.0-py3-none-any.whl")
+
+    # No py3 provided for version 1.
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "3",
+        "fake==1.0",
+        expect_error=True,
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "2",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "26",
+        "fake",
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "3",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-2.0-py3-none-any.whl")
+
+
+def make_wheel_with_python_requires(
+    script: PipTestEnvironment, package_name: str, python_requires: str
+) -> Path:
+    """
+    Create a wheel using the given python_requires.
+
+    :return: the path to the wheel file.
+    """
+    package_dir = script.scratch_path / package_name
+    package_dir.mkdir()
+
+    text = textwrap.dedent(
+        """\
+    from setuptools import setup
+    setup(name='{}',
+          python_requires='{}',
+          version='1.0')
+    """
+    ).format(package_name, python_requires)
+    package_dir.joinpath("setup.py").write_text(text)
+    script.run(
+        "python",
+        "setup.py",
+        "bdist_wheel",
+        "--universal",
+        cwd=package_dir,
+    )
+
+    file_name = f"{package_name}-1.0-py2.py3-none-any.whl"
+    return package_dir / "dist" / file_name
+
+
+def test_download__python_version_used_for_python_requires(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test that --python-version is used for the Requires-Python check.
+    """
+    wheel_path = make_wheel_with_python_requires(
+        script,
+        "mypackage",
+        python_requires="==3.2",
+    )
+    wheel_dir = os.path.dirname(wheel_path)
+
+    def make_args(python_version: str) -> Liststr:
+        return 
+            "download",
+            "--no-index",
+            "--find-links",
+            wheel_dir,
+            "--only-binary=:all:",
+            "--dest",
+            ".",
+            "--python-version",
+            python_version,
+            "mypackage==1.0",
+        
+
+    args = make_args("33")
+    result = script.pip(*args, expect_error=True)
+    expected_err = (
+        "ERROR: Package 'mypackage' requires a different Python: "
+        "3.3.0 not in '==3.2'"
+    )
+    assert expected_err in result.stderr, f"stderr: {result.stderr}"
+
+    # Now try with a --python-version that satisfies the Requires-Python.
+    args = make_args("32")
+    script.pip(*args)  # no exception
+
+
+def test_download_ignore_requires_python_dont_fail_with_wrong_python(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test that --ignore-requires-python ignores Requires-Python check.
+    """
+    wheel_path = make_wheel_with_python_requires(
+        script,
+        "mypackage",
+        python_requires="==999",
+    )
+    wheel_dir = os.path.dirname(wheel_path)
+
+    result = script.pip(
+        "download",
+        "--ignore-requires-python",
+        "--no-index",
+        "--find-links",
+        wheel_dir,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "mypackage==1.0",
+    )
+    result.did_create(Path("scratch") / "mypackage-1.0-py2.py3-none-any.whl")
+
+
+def test_download_specify_abi(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test using "pip download --abi" to download a .whl archive
+    supported for a specific abi
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--implementation",
+        "fk",
+        "--abi",
+        "fake_abi",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--implementation",
+        "fk",
+        "--abi",
+        "none",
+        "fake",
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--abi",
+        "cp27m",
+        "fake",
+    )
+
+    data.reset()
+    fake_wheel(data, "fake-1.0-fk2-fakeabi-fake_platform.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "2",
+        "--implementation",
+        "fk",
+        "--platform",
+        "fake_platform",
+        "--abi",
+        "fakeabi",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-fk2-fakeabi-fake_platform.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--implementation",
+        "fk",
+        "--platform",
+        "fake_platform",
+        "--abi",
+        "none",
+        "fake",
+        expect_error=True,
+    )
+
+    data.reset()
+    fake_wheel(data, "fake-1.0-fk2-otherabi-fake_platform.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--python-version",
+        "2",
+        "--implementation",
+        "fk",
+        "--platform",
+        "fake_platform",
+        "--abi",
+        "fakeabi",
+        "--abi",
+        "otherabi",
+        "--abi",
+        "none",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-fk2-otherabi-fake_platform.whl")
+
+
+def test_download_specify_implementation(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test using "pip download --abi" to download a .whl archive
+    supported for a specific abi
+    """
+    fake_wheel(data, "fake-1.0-py2.py3-none-any.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--implementation",
+        "fk",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-py2.py3-none-any.whl")
+
+    data.reset()
+    fake_wheel(data, "fake-1.0-fk3-none-any.whl")
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--implementation",
+        "fk",
+        "--python-version",
+        "3",
+        "fake",
+    )
+    result.did_create(Path("scratch") / "fake-1.0-fk3-none-any.whl")
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--dest",
+        ".",
+        "--implementation",
+        "fk",
+        "--python-version",
+        "2",
+        "fake",
+        expect_error=True,
+    )
+
+
+def test_download_exit_status_code_when_no_requirements(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test download exit status code when no requirements specified
+    """
+    result = script.pip("download", expect_error=True)
+    assert "You must give at least one requirement to download" in result.stderr
+    assert result.returncode == ERROR
+
+
+def test_download_exit_status_code_when_blank_requirements_file(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test download exit status code when blank requirements file specified
+    """
+    script.scratch_path.joinpath("blank.txt").write_text("\n")
+    script.pip("download", "-r", "blank.txt")
+
+
+def test_download_prefer_binary_when_tarball_higher_than_wheel(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    fake_wheel(data, "source-0.8-py2.py3-none-any.whl")
+    result = script.pip(
+        "download",
+        "--prefer-binary",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-d",
+        ".",
+        "source",
+    )
+    result.did_create(Path("scratch") / "source-0.8-py2.py3-none-any.whl")
+    result.did_not_create(Path("scratch") / "source-1.0.tar.gz")
+
+
+def test_prefer_binary_tarball_higher_than_wheel_req_file(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    fake_wheel(data, "source-0.8-py2.py3-none-any.whl")
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+                --prefer-binary
+                 source
+                """
+        )
+    )
+    result = script.pip(
+        "download",
+        "-r",
+        script.scratch_path / "test-req.txt",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-d",
+        ".",
+    )
+
+    result.did_create(Path("scratch") / "source-0.8-py2.py3-none-any.whl")
+    result.did_not_create(Path("scratch") / "source-1.0.tar.gz")
+
+
+def test_download_prefer_binary_when_wheel_doesnt_satisfy_req(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    fake_wheel(data, "source-0.8-py2.py3-none-any.whl")
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+        source>0.9
+        """
+        )
+    )
+
+    result = script.pip(
+        "download",
+        "--prefer-binary",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-d",
+        ".",
+        "-r",
+        script.scratch_path / "test-req.txt",
+    )
+    result.did_create(Path("scratch") / "source-1.0.tar.gz")
+    result.did_not_create(Path("scratch") / "source-0.8-py2.py3-none-any.whl")
+
+
+def test_prefer_binary_when_wheel_doesnt_satisfy_req_req_file(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    fake_wheel(data, "source-0.8-py2.py3-none-any.whl")
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+        --prefer-binary
+        source>0.9
+        """
+        )
+    )
+
+    result = script.pip(
+        "download",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-d",
+        ".",
+        "-r",
+        script.scratch_path / "test-req.txt",
+    )
+    result.did_create(Path("scratch") / "source-1.0.tar.gz")
+    result.did_not_create(Path("scratch") / "source-0.8-py2.py3-none-any.whl")
+
+
+def test_download_prefer_binary_when_only_tarball_exists(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    result = script.pip(
+        "download",
+        "--prefer-binary",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-d",
+        ".",
+        "source",
+    )
+    result.did_create(Path("scratch") / "source-1.0.tar.gz")
+
+
+def test_prefer_binary_when_only_tarball_exists_req_file(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+            --prefer-binary
+            source
+            """
+        )
+    )
+    result = script.pip(
+        "download",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-d",
+        ".",
+        "-r",
+        script.scratch_path / "test-req.txt",
+    )
+    result.did_create(Path("scratch") / "source-1.0.tar.gz")
+
+
+@pytest.fixture(scope="session")
+def shared_script(
+    tmpdir_factory: pytest.TempPathFactory, script_factory: ScriptFactory
+) -> PipTestEnvironment:
+    tmpdir = tmpdir_factory.mktemp("download_shared_script")
+    script = script_factory(tmpdir.joinpath("workspace"))
+    return script
+
+
+def test_download_file_url(
+    shared_script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    download_dir = tmpdir / "download"
+    download_dir.mkdir()
+    downloaded_path = download_dir / "simple-1.0.tar.gz"
+
+    simple_pkg = shared_data.packages / "simple-1.0.tar.gz"
+
+    shared_script.pip(
+        "download",
+        "-d",
+        str(download_dir),
+        "--no-index",
+        simple_pkg.as_uri(),
+    )
+
+    assert downloaded_path.exists()
+    assert simple_pkg.read_bytes() == downloaded_path.read_bytes()
+
+
+def test_download_file_url_existing_ok_download(
+    shared_script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    download_dir = tmpdir / "download"
+    download_dir.mkdir()
+    downloaded_path = download_dir / "simple-1.0.tar.gz"
+    fake_existing_package = shared_data.packages / "simple-2.0.tar.gz"
+    shutil.copy(str(fake_existing_package), str(downloaded_path))
+    downloaded_path_bytes = downloaded_path.read_bytes()
+
+    simple_pkg = shared_data.packages / "simple-1.0.tar.gz"
+    url = f"{simple_pkg.as_uri()}#sha256={sha256(downloaded_path_bytes).hexdigest()}"
+
+    shared_script.pip("download", "-d", str(download_dir), url)
+
+    assert downloaded_path_bytes == downloaded_path.read_bytes()
+
+
+def test_download_file_url_existing_bad_download(
+    shared_script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    download_dir = tmpdir / "download"
+    download_dir.mkdir()
+    downloaded_path = download_dir / "simple-1.0.tar.gz"
+    fake_existing_package = shared_data.packages / "simple-2.0.tar.gz"
+    shutil.copy(str(fake_existing_package), str(downloaded_path))
+
+    simple_pkg = shared_data.packages / "simple-1.0.tar.gz"
+    simple_pkg_bytes = simple_pkg.read_bytes()
+    url = f"{simple_pkg.as_uri()}#sha256={sha256(simple_pkg_bytes).hexdigest()}"
+
+    result = shared_script.pip(
+        "download",
+        "-d",
+        str(download_dir),
+        url,
+        allow_stderr_warning=True,  # bad hash
+    )
+
+    assert simple_pkg_bytes == downloaded_path.read_bytes()
+    assert "WARNING: Previously-downloaded file" in result.stderr
+    assert "has bad hash. Re-downloading." in result.stderr
+
+
+def test_download_http_url_bad_hash(
+    shared_script: PipTestEnvironment,
+    shared_data: TestData,
+    tmpdir: Path,
+    mock_server: MockServer,
+) -> None:
+    """
+    If already-downloaded file has bad checksum, re-download.
+    """
+    download_dir = tmpdir / "download"
+    download_dir.mkdir()
+    downloaded_path = download_dir / "simple-1.0.tar.gz"
+    fake_existing_package = shared_data.packages / "simple-2.0.tar.gz"
+    shutil.copy(str(fake_existing_package), str(downloaded_path))
+
+    simple_pkg = shared_data.packages / "simple-1.0.tar.gz"
+    simple_pkg_bytes = simple_pkg.read_bytes()
+    digest = sha256(simple_pkg_bytes).hexdigest()
+    mock_server.set_responses(file_response(simple_pkg))
+    mock_server.start()
+    base_address = f"http://{mock_server.host}:{mock_server.port}"
+    url = f"{base_address}/simple-1.0.tar.gz#sha256={digest}"
+
+    result = shared_script.pip(
+        "download",
+        "-d",
+        str(download_dir),
+        url,
+        allow_stderr_warning=True,  # bad hash
+    )
+
+    assert simple_pkg_bytes == downloaded_path.read_bytes()
+    assert "WARNING: Previously-downloaded file" in result.stderr
+    assert "has bad hash. Re-downloading." in result.stderr
+
+    mock_server.stop()
+    requests = mock_server.get_requests()
+    assert len(requests) == 1
+    assert requests0"PATH_INFO" == "/simple-1.0.tar.gz"
+    assert requests0"HTTP_ACCEPT_ENCODING" == "identity"
+
+
+def test_download_editable(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test 'pip download' of editables in requirement file.
+    """
+    editable_path = str(data.src / "simplewheel-1.0").replace(os.path.sep, "/")
+    requirements_path = tmpdir / "requirements.txt"
+    requirements_path.write_text("-e " + editable_path + "\n")
+    download_dir = tmpdir / "download_dir"
+    script.pip(
+        "download", "--no-deps", "-r", str(requirements_path), "-d", str(download_dir)
+    )
+    downloads = os.listdir(download_dir)
+    assert len(downloads) == 1
+    assert downloads0.endswith(".zip")
+
+
+def test_download_use_pep517_propagation(
+    script: PipTestEnvironment, tmpdir: Path, common_wheels: Path
+) -> None:
+    """
+    Check that --use-pep517 applies not just to the requirements specified
+    on the command line, but to their dependencies too.
+    """
+
+    create_basic_sdist_for_package(script, "fake_proj", "1.0", depends="fake_dep")
+
+    # If --use-pep517 is in effect, then setup.py should be running in an isolated
+    # environment that doesn't have pip in it.
+    create_basic_sdist_for_package(
+        script,
+        "fake_dep",
+        "1.0",
+        setup_py_prelude=textwrap.dedent(
+            """\
+            try:
+                import pip
+            except ImportError:
+                pass
+            else:
+                raise Exception(f"not running in isolation")
+            """
+        ),
+    )
+
+    download_dir = tmpdir / "download_dir"
+    script.pip(
+        "download",
+        f"--dest={download_dir}",
+        "--no-index",
+        f"--find-links={common_wheels}",
+        f"--find-links={script.scratch_path}",
+        "--use-pep517",
+        "fake_proj",
+    )
+
+    downloads = os.listdir(download_dir)
+    assert len(downloads) == 2
+
+
+class MetadataKind(Enum):
+    """All the types of values we might be provided for the data-dist-info-metadata
+    attribute from PEP 658."""
+
+    # Valid: will read metadata from the dist instead.
+    No = "none"
+    # Valid: will read the .metadata file, but won't check its hash.
+    Unhashed = "unhashed"
+    # Valid: will read the .metadata file and check its hash matches.
+    Sha256 = "sha256"
+    # Invalid: will error out after checking the hash.
+    WrongHash = "wrong-hash"
+    # Invalid: will error out after failing to fetch the .metadata file.
+    NoFile = "no-file"
+
+
+@dataclass(frozen=True)
+class Package:
+    """Mock package structure used to generate a PyPI repository.
+
+    Package name and version should correspond to sdists (.tar.gz files) in our test
+    data."""
+
+    name: str
+    version: str
+    filename: str
+    metadata: MetadataKind
+    # This will override any dependencies specified in the actual dist's METADATA.
+    requires_dist: Tuplestr, ... = ()
+
+    def metadata_filename(self) -> str:
+        """This is specified by PEP 658."""
+        return f"{self.filename}.metadata"
+
+    def generate_additional_tag(self) -> str:
+        """This gets injected into the <a> tag in the generated PyPI index page for this
+        package."""
+        if self.metadata == MetadataKind.No:
+            return ""
+        if self.metadata in MetadataKind.Unhashed, MetadataKind.NoFile:
+            return 'data-dist-info-metadata="true"'
+        if self.metadata == MetadataKind.WrongHash:
+            return 'data-dist-info-metadata="sha256=WRONG-HASH"'
+        assert self.metadata == MetadataKind.Sha256
+        checksum = sha256(self.generate_metadata()).hexdigest()
+        return f'data-dist-info-metadata="sha256={checksum}"'
+
+    def requires_str(self) -> str:
+        if not self.requires_dist:
+            return ""
+        joined = " and ".join(self.requires_dist)
+        return f"Requires-Dist: {joined}"
+
+    def generate_metadata(self) -> bytes:
+        """This is written to `self.metadata_filename()` and will override the actual
+        dist's METADATA, unless `self.metadata == MetadataKind.NoFile`."""
+        return dedent(
+            f"""\
+        Metadata-Version: 2.1
+        Name: {self.name}
+        Version: {self.version}
+        {self.requires_str()}
+        """
+        ).encode("utf-8")
+
+
+@pytest.fixture(scope="function")
+def write_index_html_content(tmpdir: Path) -> Callablestr, Path:
+    """Generate a PyPI package index.html within a temporary local directory."""
+    html_dir = tmpdir / "index_html_content"
+    html_dir.mkdir()
+
+    def generate_index_html_subdir(index_html: str) -> Path:
+        """Create a new subdirectory after a UUID and write an index.html."""
+        new_subdir = html_dir / uuid.uuid4().hex
+        new_subdir.mkdir()
+
+        with open(new_subdir / "index.html", "w") as f:
+            f.write(index_html)
+
+        return new_subdir
+
+    return generate_index_html_subdir
+
+
+@pytest.fixture(scope="function")
+def html_index_for_packages(
+    shared_data: TestData,
+    write_index_html_content: Callablestr, Path,
+) -> Callable..., Path:
+    """Generate a PyPI HTML package index within a local directory pointing to
+    blank data."""
+
+    def generate_html_index_for_packages(packages: Dictstr, ListPackage) -> Path:
+        """
+        Produce a PyPI directory structure pointing to the specified packages.
+        """
+        # (1) Generate the content for a PyPI index.html.
+        pkg_links = "\n".join(
+            f'    <a href="{pkg}/index.html">{pkg}</a>' for pkg in packages.keys()
+        )
+        index_html = f"""\
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta name="pypi:repository-version" content="1.0">
+    <title>Simple index</title>
+  </head>
+  <body>
+{pkg_links}
+  </body>
+</html>"""
+        # (2) Generate the index.html in a new subdirectory of the temp directory.
+        index_html_subdir = write_index_html_content(index_html)
+
+        # (3) Generate subdirectories for individual packages, each with their own
+        # index.html.
+        for pkg, links in packages.items():
+            pkg_subdir = index_html_subdir / pkg
+            pkg_subdir.mkdir()
+
+            download_links: Liststr = 
+            for package_link in links:
+                # (3.1) Generate the <a> tag which pip can crawl pointing to this
+                # specific package version.
+                download_links.append(
+                    f'    <a href="{package_link.filename}" {package_link.generate_additional_tag()}>{package_link.filename}</a><br/>'  # noqa: E501
+                )
+                # (3.2) Copy over the corresponding file in `shared_data.packages`.
+                shutil.copy(
+                    shared_data.packages / package_link.filename,
+                    pkg_subdir / package_link.filename,
+                )
+                # (3.3) Write a metadata file, if applicable.
+                if package_link.metadata != MetadataKind.NoFile:
+                    with open(pkg_subdir / package_link.metadata_filename(), "wb") as f:
+                        f.write(package_link.generate_metadata())
+
+            # (3.4) After collating all the download links and copying over the files,
+            # write an index.html with the generated download links for each
+            # copied file for this specific package name.
+            download_links_str = "\n".join(download_links)
+            pkg_index_content = f"""\
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta name="pypi:repository-version" content="1.0">
+    <title>Links for {pkg}</title>
+  </head>
+  <body>
+    <h1>Links for {pkg}</h1>
+{download_links_str}
+  </body>
+</html>"""
+            with open(pkg_subdir / "index.html", "w") as f:
+                f.write(pkg_index_content)
+
+        return index_html_subdir
+
+    return generate_html_index_for_packages
+
+
+@pytest.fixture(scope="function")
+def download_generated_html_index(
+    script: PipTestEnvironment,
+    html_index_for_packages: CallableDictstr, ListPackage, Path,
+    tmpdir: Path,
+) -> Callable..., TupleTestPipResult, Path:
+    """Execute `pip download` against a generated PyPI index."""
+    download_dir = tmpdir / "download_dir"
+
+    def run_for_generated_index(
+        packages: Dictstr, ListPackage,
+        args: Liststr,
+        allow_error: bool = False,
+    ) -> TupleTestPipResult, Path:
+        """
+        Produce a PyPI directory structure pointing to the specified packages, then
+        execute `pip download -i ...` pointing to our generated index.
+        """
+        index_dir = html_index_for_packages(packages)
+        pip_args = 
+            "download",
+            "-d",
+            str(download_dir),
+            "-i",
+            path_to_url(str(index_dir)),
+            *args,
+        
+        result = script.pip(*pip_args, allow_error=allow_error)
+        return (result, download_dir)
+
+    return run_for_generated_index
+
+
+# The package database we generate for testing PEP 658 support.
+_simple_packages: Dictstr, ListPackage = {
+    "simple": 
+        Package("simple", "1.0", "simple-1.0.tar.gz", MetadataKind.Sha256),
+        Package("simple", "2.0", "simple-2.0.tar.gz", MetadataKind.No),
+        # This will raise a hashing error.
+        Package("simple", "3.0", "simple-3.0.tar.gz", MetadataKind.WrongHash),
+    ,
+    "simple2": 
+        # Override the dependencies here in order to force pip to download
+        # simple-1.0.tar.gz as well.
+        Package(
+            "simple2",
+            "1.0",
+            "simple2-1.0.tar.gz",
+            MetadataKind.Unhashed,
+            ("simple==1.0",),
+        ),
+        # This will raise an error when pip attempts to fetch the metadata file.
+        Package("simple2", "2.0", "simple2-2.0.tar.gz", MetadataKind.NoFile),
+    ,
+    "colander": 
+        # Ensure we can read the dependencies from a metadata file within a wheel
+        # *without* PEP 658 metadata.
+        Package(
+            "colander", "0.9.9", "colander-0.9.9-py2.py3-none-any.whl", MetadataKind.No
+        ),
+    ,
+    "compilewheel": 
+        # Ensure we can override the dependencies of a wheel file by injecting PEP
+        # 658 metadata.
+        Package(
+            "compilewheel",
+            "1.0",
+            "compilewheel-1.0-py2.py3-none-any.whl",
+            MetadataKind.Unhashed,
+            ("simple==1.0",),
+        ),
+    ,
+    "has-script": 
+        # Ensure we check PEP 658 metadata hashing errors for wheel files.
+        Package(
+            "has-script",
+            "1.0",
+            "has.script-1.0-py2.py3-none-any.whl",
+            MetadataKind.WrongHash,
+        ),
+    ,
+    "translationstring": 
+        Package(
+            "translationstring", "1.1", "translationstring-1.1.tar.gz", MetadataKind.No
+        ),
+    ,
+    "priority": 
+        # Ensure we check for a missing metadata file for wheels.
+        Package(
+            "priority", "1.0", "priority-1.0-py2.py3-none-any.whl", MetadataKind.NoFile
+        ),
+    ,
+}
+
+
+@pytest.mark.parametrize(
+    "requirement_to_download, expected_outputs",
+    
+        ("simple2==1.0", "simple-1.0.tar.gz", "simple2-1.0.tar.gz"),
+        ("simple==2.0", "simple-2.0.tar.gz"),
+        (
+            "colander",
+            "colander-0.9.9-py2.py3-none-any.whl", "translationstring-1.1.tar.gz",
+        ),
+        (
+            "compilewheel",
+            "compilewheel-1.0-py2.py3-none-any.whl", "simple-1.0.tar.gz",
+        ),
+    ,
+)
+def test_download_metadata(
+    download_generated_html_index: Callable..., TupleTestPipResult, Path,
+    requirement_to_download: str,
+    expected_outputs: Liststr,
+) -> None:
+    """Verify that if a data-dist-info-metadata attribute is present, then it is used
+    instead of the actual dist's METADATA."""
+    _, download_dir = download_generated_html_index(
+        _simple_packages,
+        requirement_to_download,
+    )
+    assert sorted(os.listdir(download_dir)) == expected_outputs
+
+
+@pytest.mark.parametrize(
+    "requirement_to_download, real_hash",
+    
+        (
+            "simple==3.0",
+            "95e0f200b6302989bcf2cead9465cf229168295ea330ca30d1ffeab5c0fed996",
+        ),
+        (
+            "has-script",
+            "16ba92d7f6f992f6de5ecb7d58c914675cf21f57f8e674fb29dcb4f4c9507e5b",
+        ),
+    ,
+)
+def test_incorrect_metadata_hash(
+    download_generated_html_index: Callable..., TupleTestPipResult, Path,
+    requirement_to_download: str,
+    real_hash: str,
+) -> None:
+    """Verify that if a hash for data-dist-info-metadata is provided, it must match the
+    actual hash of the metadata file."""
+    result, _ = download_generated_html_index(
+        _simple_packages,
+        requirement_to_download,
+        allow_error=True,
+    )
+    assert result.returncode != 0
+    expected_msg = f"""\
+        Expected sha256 WRONG-HASH
+             Got        {real_hash}"""
+    assert expected_msg in result.stderr
+
+
+@pytest.mark.parametrize(
+    "requirement_to_download, expected_url",
+    
+        ("simple2==2.0", "simple2-2.0.tar.gz.metadata"),
+        ("priority", "priority-1.0-py2.py3-none-any.whl.metadata"),
+    ,
+)
+def test_metadata_not_found(
+    download_generated_html_index: Callable..., TupleTestPipResult, Path,
+    requirement_to_download: str,
+    expected_url: str,
+) -> None:
+    """Verify that if a data-dist-info-metadata attribute is provided, that pip will
+    fetch the .metadata file at the location specified by PEP 658, and error
+    if unavailable."""
+    result, _ = download_generated_html_index(
+        _simple_packages,
+        requirement_to_download,
+        allow_error=True,
+    )
+    assert result.returncode != 0
+    expected_re = re.escape(expected_url)
+    pattern = re.compile(
+        f"ERROR: 404 Client Error: FileNotFoundError for url:.*{expected_re}"
+    )
+    assert pattern.search(result.stderr), (pattern, result.stderr)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_fast_deps.py Added

@@ -0,0 +1,103 @@
+import fnmatch
+import json
+import os
+import pathlib
+from os.path import basename
+from typing import Iterable
+
+from pip._vendor.packaging.utils import canonicalize_name
+from pytest import mark
+
+from tests.lib import PipTestEnvironment, TestData, TestPipResult
+
+
+def pip(script: PipTestEnvironment, command: str, requirement: str) -> TestPipResult:
+    return script.pip(
+        command,
+        "--prefer-binary",
+        "--no-cache-dir",
+        "--use-feature=fast-deps",
+        requirement,
+        allow_stderr_warning=True,
+    )
+
+
+def assert_installed(script: PipTestEnvironment, names: str) -> None:
+    list_output = json.loads(script.pip("list", "--format=json").stdout)
+    installed = {canonicalize_name(item"name") for item in list_output}
+    assert installed.issuperset(map(canonicalize_name, names))
+
+
+@mark.network
+@mark.parametrize(
+    ("requirement", "expected"),
+    (
+        ("Paste==3.4.2", ("Paste", "six")),
+        ("Pasteflup==3.4.2", ("Paste", "six", "flup")),
+    ),
+)
+def test_install_from_pypi(
+    requirement: str, expected: str, script: PipTestEnvironment
+) -> None:
+    pip(script, "install", requirement)
+    assert_installed(script, expected)
+
+
+@mark.network
+@mark.parametrize(
+    ("requirement", "expected"),
+    (
+        ("Paste==3.4.2", ("Paste-3.4.2-*.whl", "six-*.whl")),
+        ("Pasteflup==3.4.2", ("Paste-3.4.2-*.whl", "six-*.whl", "flup-*")),
+    ),
+)
+def test_download_from_pypi(
+    requirement: str, expected: Iterablestr, script: PipTestEnvironment
+) -> None:
+    result = pip(script, "download", requirement)
+    created = basename(f) for f in result.files_created
+    assert all(fnmatch.filter(created, f) for f in expected)
+
+
+@mark.network
+def test_build_wheel_with_deps(data: TestData, script: PipTestEnvironment) -> None:
+    result = pip(script, "wheel", os.fspath(data.packages / "requiresPaste"))
+    created = basename(f) for f in result.files_created
+    assert fnmatch.filter(created, "requirespaste-3.1.4-*.whl")
+    assert fnmatch.filter(created, "Paste-3.4.2-*.whl")
+    assert fnmatch.filter(created, "six-*.whl")
+
+
+@mark.network
+def test_require_hash(script: PipTestEnvironment, tmp_path: pathlib.Path) -> None:
+    reqs = tmp_path / "requirements.txt"
+    reqs.write_text(
+        "idna==2.10"
+        " --hash=sha256:"
+        "b97d804b1e9b523befed77c48dacec60e6dcb0b5391d57af6a65a312a90648c0"
+        " --hash=sha256:"
+        "b307872f855b18632ce0c21c5e45be78c0ea7ae4c15c828c20788b26921eb3f6"
+    )
+    result = script.pip(
+        "download",
+        "--use-feature=fast-deps",
+        "-r",
+        str(reqs),
+        allow_stderr_warning=True,
+    )
+    created = basename(f) for f in result.files_created
+    assert fnmatch.filter(created, "idna-2.10*")
+
+
+@mark.network
+def test_hash_mismatch(script: PipTestEnvironment, tmp_path: pathlib.Path) -> None:
+    reqs = tmp_path / "requirements.txt"
+    reqs.write_text("idna==2.10 --hash=sha256:irna")
+    result = script.pip(
+        "download",
+        "--use-feature=fast-deps",
+        "-r",
+        str(reqs),
+        expect_error=True,
+    )
+    assert "DO NOT MATCH THE HASHES" in result.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_freeze.py Added

@@ -0,0 +1,1023 @@
+import os
+import re
+import sys
+import textwrap
+from doctest import ELLIPSIS, OutputChecker
+from pathlib import Path
+
+import pytest
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal.models.direct_url import DirectUrl, DirInfo
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    _create_test_package,
+    _create_test_package_with_srcdir,
+    _git_commit,
+    _vcs_add,
+    create_test_package_with_setup,
+    need_bzr,
+    need_mercurial,
+    need_svn,
+    wheel,
+)
+from tests.lib.direct_url import get_created_direct_url_path
+from tests.lib.venv import VirtualEnvironment
+
+distribute_re = re.compile("^distribute==0-9.+\n", re.MULTILINE)
+
+
+def _check_output(result: str, expected: str) -> None:
+    checker = OutputChecker()
+    actual = str(result)
+
+    # FIXME!  The following is a TOTAL hack.  For some reason the
+    # __str__ result for pkg_resources.Requirement gets downcased on
+    # Windows.  Since INITools is the only package we're installing
+    # in this file with funky case requirements, I'm forcibly
+    # upcasing it.  You can also normalize everything to lowercase,
+    # but then you have to remember to upcase <BLANKLINE>.  The right
+    # thing to do in the end is probably to find out how to report
+    # the proper fully-cased package name in our error message.
+    if sys.platform == "win32":
+        actual = actual.replace("initools", "INITools")
+
+    # This allows our existing tests to work when run in a context
+    # with distribute installed.
+    actual = distribute_re.sub("", actual)
+
+    def banner(msg: str) -> str:
+        return f"\n========== {msg} ==========\n"
+
+    assert checker.check_output(expected, actual, ELLIPSIS), (
+        banner("EXPECTED") + expected + banner("ACTUAL") + actual + banner(6 * "=")
+    )
+
+
+def test_basic_freeze(script: PipTestEnvironment) -> None:
+    """
+    Some tests of freeze, first we have to install some stuff.  Note that
+    the test is a little crude at the end because Python 2.5+ adds egg
+    info to the standard library, so stuff like wsgiref will show up in
+    the freezing.  (Probably that should be accounted for in pip, but
+    currently it is not).
+
+    """
+    script.scratch_path.joinpath("initools-req.txt").write_text(
+        textwrap.dedent(
+            """\
+        simple==2.0
+        # and something else to test out:
+        simple2<=3.0
+        """
+        )
+    )
+    script.pip_install_local(
+        "-r",
+        script.scratch_path / "initools-req.txt",
+    )
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """\
+        ...simple==2.0
+        simple2==3.0...
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+
+
+def test_freeze_with_pip(script: PipTestEnvironment) -> None:
+    """Test pip shows itself"""
+    result = script.pip("freeze", "--all")
+    assert "pip==" in result.stdout
+
+
+def test_exclude_and_normalization(script: PipTestEnvironment, tmpdir: Path) -> None:
+    req_path = wheel.make_wheel(name="Normalizable_Name", version="1.0").save_to_dir(
+        tmpdir
+    )
+    script.pip("install", "--no-index", req_path)
+    result = script.pip("freeze")
+    assert "Normalizable_Name" in result.stdout
+    result = script.pip("freeze", "--exclude", "normalizablE-namE")
+    assert "Normalizable_Name" not in result.stdout
+
+
+def test_freeze_multiple_exclude_with_all(script: PipTestEnvironment) -> None:
+    result = script.pip("freeze", "--all")
+    assert "pip==" in result.stdout
+    assert "wheel==" in result.stdout
+    result = script.pip("freeze", "--all", "--exclude", "pip", "--exclude", "wheel")
+    assert "pip==" not in result.stdout
+    assert "wheel==" not in result.stdout
+
+
+def test_freeze_with_invalid_names(script: PipTestEnvironment) -> None:
+    """
+    Test that invalid names produce warnings and are passed over gracefully.
+    """
+
+    def fake_install(pkgname: str, dest: str) -> None:
+        egg_info_path = os.path.join(
+            dest,
+            "{}-1.0-py{}.{}.egg-info".format(
+                pkgname.replace("-", "_"), sys.version_info0, sys.version_info1
+            ),
+        )
+        with open(egg_info_path, "w") as egg_info_file:
+            egg_info_file.write(
+                textwrap.dedent(
+                    """\
+                Metadata-Version: 1.0
+                Name: {}
+                Version: 1.0
+                """.format(
+                        pkgname
+                    )
+                )
+            )
+
+    valid_pkgnames = ("middle-dash", "middle_underscore", "middle.dot")
+    invalid_pkgnames = (
+        "-leadingdash",
+        "_leadingunderscore",
+        ".leadingdot",
+        "trailingdash-",
+        "trailingunderscore_",
+        "trailingdot.",
+    )
+    for pkgname in valid_pkgnames + invalid_pkgnames:
+        fake_install(pkgname, os.fspath(script.site_packages_path))
+
+    result = script.pip("freeze", expect_stderr=True)
+
+    # Check all valid names are in the output.
+    output_lines = {line.strip() for line in result.stdout.splitlines()}
+    for name in valid_pkgnames:
+        assert f"{name}==1.0" in output_lines
+
+    # Check all invalid names are excluded from the output.
+    canonical_invalid_names = {canonicalize_name(n) for n in invalid_pkgnames}
+    for line in output_lines:
+        output_name, _, _ = line.partition("=")
+        assert canonicalize_name(output_name) not in canonical_invalid_names
+
+    # The invalid names should be logged.
+    for name in canonical_invalid_names:
+        assert f"Ignoring invalid distribution {name} (" in result.stderr
+
+
+@pytest.mark.git
+def test_freeze_editable_not_vcs(script: PipTestEnvironment) -> None:
+    """
+    Test an editable install that is not version controlled.
+    """
+    pkg_path = _create_test_package(script.scratch_path)
+    # Rename the .git directory so the directory is no longer recognized
+    # as a VCS directory.
+    os.rename(os.path.join(pkg_path, ".git"), os.path.join(pkg_path, ".bak"))
+    script.pip("install", "-e", pkg_path)
+    result = script.pip("freeze")
+
+    # We need to apply os.path.normcase() to the path since that is what
+    # the freeze code does.
+    expected = textwrap.dedent(
+        """\
+    ...# Editable install with no version control (version-pkg==0.1)
+    -e {}
+    ...""".format(
+            os.path.normcase(pkg_path)
+        )
+    )
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.git
+def test_freeze_editable_git_with_no_remote(
+    script: PipTestEnvironment, deprecated_python: bool
+) -> None:
+    """
+    Test an editable Git install with no remote url.
+    """
+    pkg_path = _create_test_package(script.scratch_path)
+    script.pip("install", "-e", pkg_path)
+    result = script.pip("freeze")
+
+    if not deprecated_python:
+        assert result.stderr == ""
+
+    # We need to apply os.path.normcase() to the path since that is what
+    # the freeze code does.
+    expected = textwrap.dedent(
+        """\
+    ...# Editable Git install with no remote (version-pkg==0.1)
+    -e {}
+    ...""".format(
+            os.path.normcase(pkg_path)
+        )
+    )
+    _check_output(result.stdout, expected)
+
+
+@need_svn
+def test_freeze_svn(script: PipTestEnvironment) -> None:
+    """Test freezing a svn checkout"""
+
+    checkout_path = _create_test_package(script.scratch_path, vcs="svn")
+
+    # Install with develop
+    script.run("python", "setup.py", "develop", cwd=checkout_path, expect_stderr=True)
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """\
+        ...-e svn+...#egg=version_pkg
+        ..."""
+    )
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.git
+@pytest.mark.xfail(
+    condition=True,
+    reason="xfail means editable is not in output",
+    run=True,
+    strict=True,
+)
+def test_freeze_exclude_editable(script: PipTestEnvironment) -> None:
+    """
+    Test excluding editable from freezing list.
+    """
+    # Returns path to a generated package called "version_pkg"
+    pkg_version = _create_test_package(script.scratch_path)
+
+    result = script.run(
+        "git",
+        "clone",
+        os.fspath(pkg_version),
+        "pip-test-package",
+        expect_stderr=True,
+    )
+    repo_dir = script.scratch_path / "pip-test-package"
+    result = script.run(
+        "python",
+        "setup.py",
+        "develop",
+        cwd=repo_dir,
+        expect_stderr=True,
+    )
+    result = script.pip("freeze", "--exclude-editable", expect_stderr=True)
+    expected = textwrap.dedent(
+        """
+            ...-e git+...#egg=version_pkg
+            ...
+        """
+    ).strip()
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.git
+def test_freeze_git_clone(script: PipTestEnvironment) -> None:
+    """
+    Test freezing a Git clone.
+    """
+    # Returns path to a generated package called "version_pkg"
+    pkg_version = _create_test_package(script.scratch_path)
+
+    result = script.run(
+        "git",
+        "clone",
+        os.fspath(pkg_version),
+        "pip-test-package",
+        expect_stderr=True,
+    )
+    repo_dir = script.scratch_path / "pip-test-package"
+    result = script.run(
+        "python",
+        "setup.py",
+        "develop",
+        cwd=repo_dir,
+        expect_stderr=True,
+    )
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """
+            ...-e git+...#egg=version_pkg
+            ...
+        """
+    ).strip()
+    _check_output(result.stdout, expected)
+
+    # Check that slashes in branch or tag names are translated.
+    # See also issue #1083: https://github.com/pypa/pip/issues/1083
+    script.run(
+        "git",
+        "checkout",
+        "-b",
+        "branch/name/with/slash",
+        cwd=repo_dir,
+        expect_stderr=True,
+    )
+    # Create a new commit to ensure that the commit has only one branch
+    # or tag name associated to it (to avoid the non-determinism reported
+    # in issue #1867).
+    (repo_dir / "newfile").touch()
+    script.run("git", "add", "newfile", cwd=repo_dir)
+    _git_commit(script, repo_dir, message="...")
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """
+            ...-e ...@...#egg=version_pkg
+            ...
+        """
+    ).strip()
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.git
+def test_freeze_git_clone_srcdir(script: PipTestEnvironment) -> None:
+    """
+    Test freezing a Git clone where setup.py is in a subdirectory
+    relative the repo root and the source code is in a subdirectory
+    relative to setup.py.
+    """
+    # Returns path to a generated package called "version_pkg"
+    pkg_version = _create_test_package_with_srcdir(script.scratch_path)
+
+    result = script.run(
+        "git",
+        "clone",
+        os.fspath(pkg_version),
+        "pip-test-package",
+        expect_stderr=True,
+    )
+    repo_dir = script.scratch_path / "pip-test-package"
+    result = script.run(
+        "python",
+        "setup.py",
+        "develop",
+        cwd=repo_dir / "subdir",
+        expect_stderr=True,
+    )
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """
+            ...-e git+...#egg=version_pkg&subdirectory=subdir
+            ...
+        """
+    ).strip()
+    _check_output(result.stdout, expected)
+
+
+@need_mercurial
+def test_freeze_mercurial_clone_srcdir(script: PipTestEnvironment) -> None:
+    """
+    Test freezing a Mercurial clone where setup.py is in a subdirectory
+    relative to the repo root and the source code is in a subdirectory
+    relative to setup.py.
+    """
+    # Returns path to a generated package called "version_pkg"
+    pkg_version = _create_test_package_with_srcdir(script.scratch_path, vcs="hg")
+
+    result = script.run("hg", "clone", os.fspath(pkg_version), "pip-test-package")
+    repo_dir = script.scratch_path / "pip-test-package"
+    result = script.run("python", "setup.py", "develop", cwd=repo_dir / "subdir")
+    result = script.pip("freeze")
+    expected = textwrap.dedent(
+        """
+            ...-e hg+...#egg=version_pkg&subdirectory=subdir
+            ...
+        """
+    ).strip()
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.git
+def test_freeze_git_remote(script: PipTestEnvironment) -> None:
+    """
+    Test freezing a Git clone.
+    """
+    # Returns path to a generated package called "version_pkg"
+    pkg_version = _create_test_package(script.scratch_path)
+
+    result = script.run(
+        "git",
+        "clone",
+        os.fspath(pkg_version),
+        "pip-test-package",
+        expect_stderr=True,
+    )
+    repo_dir = script.scratch_path / "pip-test-package"
+    result = script.run(
+        "python",
+        "setup.py",
+        "develop",
+        cwd=repo_dir,
+        expect_stderr=True,
+    )
+    origin_remote = pkg_version
+    # check frozen remote after clone
+    result = script.pip("freeze", expect_stderr=True)
+    expected = (
+        textwrap.dedent(
+            """
+            ...-e git+{remote}@...#egg=version_pkg
+            ...
+        """
+        )
+        .format(remote=origin_remote.as_uri())
+        .strip()
+    )
+    _check_output(result.stdout, expected)
+    # check frozen remote when there is no remote named origin
+    script.run("git", "remote", "rename", "origin", "other", cwd=repo_dir)
+    result = script.pip("freeze", expect_stderr=True)
+    expected = (
+        textwrap.dedent(
+            """
+            ...-e git+{remote}@...#egg=version_pkg
+            ...
+        """
+        )
+        .format(remote=origin_remote.as_uri())
+        .strip()
+    )
+    _check_output(result.stdout, expected)
+    # When the remote is a local path, it must exist.
+    # If it doesn't, it gets flagged as invalid.
+    other_remote = f"{pkg_version}-other"
+    script.run("git", "remote", "set-url", "other", other_remote, cwd=repo_dir)
+    result = script.pip("freeze", expect_stderr=True)
+    expected = os.path.normcase(
+        textwrap.dedent(
+            f"""
+            ...# Editable Git...(version-pkg...)...
+            # '{other_remote}'
+            -e {repo_dir}...
+        """
+        ).strip()
+    )
+    _check_output(os.path.normcase(result.stdout), expected)
+    # when there are more than one origin, priority is given to the
+    # remote named origin
+    script.run("git", "remote", "add", "origin", os.fspath(origin_remote), cwd=repo_dir)
+    result = script.pip("freeze", expect_stderr=True)
+    expected = (
+        textwrap.dedent(
+            """
+            ...-e git+{remote}@...#egg=version_pkg
+            ...
+        """
+        )
+        .format(remote=origin_remote.as_uri())
+        .strip()
+    )
+    _check_output(result.stdout, expected)
+
+
+@need_mercurial
+def test_freeze_mercurial_clone(script: PipTestEnvironment) -> None:
+    """
+    Test freezing a Mercurial clone.
+
+    """
+    # Returns path to a generated package called "version_pkg"
+    pkg_version = _create_test_package(script.scratch_path, vcs="hg")
+
+    result = script.run(
+        "hg",
+        "clone",
+        os.fspath(pkg_version),
+        "pip-test-package",
+        expect_stderr=True,
+    )
+    repo_dir = script.scratch_path / "pip-test-package"
+    result = script.run(
+        "python",
+        "setup.py",
+        "develop",
+        cwd=repo_dir,
+        expect_stderr=True,
+    )
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """
+            ...-e hg+...#egg=version_pkg
+            ...
+        """
+    ).strip()
+    _check_output(result.stdout, expected)
+
+
+@need_bzr
+def test_freeze_bazaar_clone(script: PipTestEnvironment) -> None:
+    """
+    Test freezing a Bazaar clone.
+
+    """
+    try:
+        checkout_path = _create_test_package(script.scratch_path, vcs="bazaar")
+    except OSError as e:
+        pytest.fail(f"Invoking `bzr` failed: {e}")
+
+    result = script.run("bzr", "checkout", os.fspath(checkout_path), "bzr-package")
+    result = script.run(
+        "python",
+        "setup.py",
+        "develop",
+        cwd=script.scratch_path / "bzr-package",
+        expect_stderr=True,
+    )
+    result = script.pip("freeze", expect_stderr=True)
+    expected = textwrap.dedent(
+        """\
+        ...-e bzr+file://...@1#egg=version_pkg
+        ..."""
+    )
+    _check_output(result.stdout, expected)
+
+
+@need_mercurial
+@pytest.mark.git
+@pytest.mark.parametrize(
+    "outer_vcs, inner_vcs",
+    ("hg", "git"), ("git", "hg"),
+)
+def test_freeze_nested_vcs(
+    script: PipTestEnvironment, outer_vcs: str, inner_vcs: str
+) -> None:
+    """Test VCS can be correctly freezed when resides inside another VCS repo."""
+    # Create Python package.
+    pkg_path = _create_test_package(script.scratch_path, vcs=inner_vcs)
+
+    # Create outer repo to clone into.
+    root_path = script.scratch_path.joinpath("test_freeze_nested_vcs")
+    root_path.mkdir()
+    root_path.joinpath(".hgignore").write_text("src")
+    root_path.joinpath(".gitignore").write_text("src")
+    _vcs_add(script, root_path, outer_vcs)
+
+    # Clone Python package into inner directory and install it.
+    src_path = root_path.joinpath("src")
+    src_path.mkdir()
+    script.run(
+        inner_vcs,
+        "clone",
+        os.fspath(pkg_path),
+        os.fspath(src_path),
+        expect_stderr=True,
+    )
+    script.pip("install", "-e", src_path, expect_stderr=True)
+
+    # Check the freeze output recognizes the inner VCS.
+    result = script.pip("freeze", expect_stderr=True)
+    _check_output(
+        result.stdout,
+        f"...-e {inner_vcs}+...#egg=version_pkg\n...",
+    )
+
+
+# used by the test_freeze_with_requirement_* tests below
+_freeze_req_opts = textwrap.dedent(
+    """\
+    # Unchanged requirements below this line
+    -r ignore.txt
+    --requirement ignore.txt
+    -f http://ignore
+    -i http://ignore
+    --pre
+    --trusted-host url
+    --process-dependency-links
+    --extra-index-url http://ignore
+    --find-links http://ignore
+    --index-url http://ignore
+    --use-feature 2020-resolver
+"""
+)
+
+
+def test_freeze_with_requirement_option_file_url_egg_not_installed(
+    script: PipTestEnvironment, deprecated_python: bool
+) -> None:
+    """
+    Test "freeze -r requirements.txt" with a local file URL whose egg name
+    is not installed.
+    """
+
+    url = "file:///my-package.tar.gz#egg=Does.Not-Exist"
+    requirements_path = script.scratch_path.joinpath("requirements.txt")
+    requirements_path.write_text(url + "\n")
+
+    result = script.pip(
+        "freeze",
+        "--requirement",
+        "requirements.txt",
+        expect_stderr=True,
+    )
+    expected_err = (
+        "WARNING: Requirement file requirements.txt contains {}, "
+        "but package 'Does.Not-Exist' is not installed\n"
+    ).format(url)
+    if deprecated_python:
+        assert expected_err in result.stderr
+    else:
+        assert expected_err == result.stderr
+
+
+def test_freeze_with_requirement_option(script: PipTestEnvironment) -> None:
+    """
+    Test that new requirements are created correctly with --requirement hints
+
+    """
+
+    script.scratch_path.joinpath("hint1.txt").write_text(
+        textwrap.dedent(
+            """\
+        INITools==0.1
+        NoExist==4.2  # A comment that ensures end of line comments work.
+        simple==3.0; python_version > '1.0'
+        """
+        )
+        + _freeze_req_opts
+    )
+    script.scratch_path.joinpath("hint2.txt").write_text(
+        textwrap.dedent(
+            """\
+        iniTools==0.1
+        Noexist==4.2  # A comment that ensures end of line comments work.
+        Simple==3.0; python_version > '1.0'
+        """
+        )
+        + _freeze_req_opts
+    )
+    result = script.pip_install_local("initools==0.2")
+    result = script.pip_install_local("simple")
+    result = script.pip(
+        "freeze",
+        "--requirement",
+        "hint1.txt",
+        expect_stderr=True,
+    )
+    expected = textwrap.dedent(
+        """\
+        INITools==0.2
+        simple==3.0
+    """
+    )
+    expected += _freeze_req_opts
+    expected += "## The following requirements were added by pip freeze:..."
+    _check_output(result.stdout, expected)
+    assert (
+        "Requirement file hint1.txt contains NoExist==4.2, but package "
+        "'NoExist' is not installed"
+    ) in result.stderr
+    result = script.pip(
+        "freeze",
+        "--requirement",
+        "hint2.txt",
+        expect_stderr=True,
+    )
+    _check_output(result.stdout, expected)
+    assert (
+        "Requirement file hint2.txt contains Noexist==4.2, but package "
+        "'Noexist' is not installed"
+    ) in result.stderr
+
+
+def test_freeze_with_requirement_option_multiple(script: PipTestEnvironment) -> None:
+    """
+    Test that new requirements are created correctly with multiple
+    --requirement hints
+
+    """
+    script.scratch_path.joinpath("hint1.txt").write_text(
+        textwrap.dedent(
+            """\
+        INITools==0.1
+        NoExist==4.2
+        simple==3.0; python_version > '1.0'
+    """
+        )
+        + _freeze_req_opts
+    )
+    script.scratch_path.joinpath("hint2.txt").write_text(
+        textwrap.dedent(
+            """\
+        NoExist2==2.0
+        simple2==1.0
+    """
+        )
+        + _freeze_req_opts
+    )
+    result = script.pip_install_local("initools==0.2")
+    result = script.pip_install_local("simple")
+    result = script.pip_install_local("simple2==1.0")
+    result = script.pip_install_local("meta")
+    result = script.pip(
+        "freeze",
+        "--requirement",
+        "hint1.txt",
+        "--requirement",
+        "hint2.txt",
+        expect_stderr=True,
+    )
+    expected = textwrap.dedent(
+        """\
+        INITools==0.2
+        simple==1.0
+    """
+    )
+    expected += _freeze_req_opts
+    expected += textwrap.dedent(
+        """\
+        simple2==1.0
+    """
+    )
+    expected += "## The following requirements were added by pip freeze:"
+    expected += "\n" + textwrap.dedent(
+        """\
+        ...meta==1.0...
+    """
+    )
+    _check_output(result.stdout, expected)
+    assert (
+        "Requirement file hint1.txt contains NoExist==4.2, but package "
+        "'NoExist' is not installed"
+    ) in result.stderr
+    assert (
+        "Requirement file hint2.txt contains NoExist2==2.0, but package "
+        "'NoExist2' is not installed"
+    ) in result.stderr
+    # any options like '--index-url http://ignore' should only be emitted once
+    # even if they are listed in multiple requirements files
+    assert result.stdout.count("--index-url http://ignore") == 1
+
+
+def test_freeze_with_requirement_option_package_repeated_one_file(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test freezing with single requirements file that contains a package
+    multiple times
+    """
+    script.scratch_path.joinpath("hint1.txt").write_text(
+        textwrap.dedent(
+            """\
+        simple2
+        simple2
+        NoExist
+    """
+        )
+        + _freeze_req_opts
+    )
+    result = script.pip_install_local("simple2==1.0")
+    result = script.pip_install_local("meta")
+    result = script.pip(
+        "freeze",
+        "--requirement",
+        "hint1.txt",
+        expect_stderr=True,
+    )
+    expected_out = textwrap.dedent(
+        """\
+        simple2==1.0
+    """
+    )
+    expected_out += _freeze_req_opts
+    expected_out += "## The following requirements were added by pip freeze:"
+    expected_out += "\n" + textwrap.dedent(
+        """\
+        ...meta==1.0...
+    """
+    )
+    _check_output(result.stdout, expected_out)
+    err1 = (
+        "Requirement file hint1.txt contains NoExist, "
+        "but package 'NoExist' is not installed\n"
+    )
+    err2 = "Requirement simple2 included multiple times hint1.txt\n"
+    assert err1 in result.stderr
+    assert err2 in result.stderr
+    # there shouldn't be any other 'is not installed' warnings
+    assert result.stderr.count("is not installed") == 1
+
+
+def test_freeze_with_requirement_option_package_repeated_multi_file(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test freezing with multiple requirements file that contain a package
+    """
+    script.scratch_path.joinpath("hint1.txt").write_text(
+        textwrap.dedent(
+            """\
+        simple
+    """
+        )
+        + _freeze_req_opts
+    )
+    script.scratch_path.joinpath("hint2.txt").write_text(
+        textwrap.dedent(
+            """\
+        simple
+        NoExist
+    """
+        )
+        + _freeze_req_opts
+    )
+    result = script.pip_install_local("simple==1.0")
+    result = script.pip_install_local("meta")
+    result = script.pip(
+        "freeze",
+        "--requirement",
+        "hint1.txt",
+        "--requirement",
+        "hint2.txt",
+        expect_stderr=True,
+    )
+    expected_out = textwrap.dedent(
+        """\
+        simple==1.0
+    """
+    )
+    expected_out += _freeze_req_opts
+    expected_out += "## The following requirements were added by pip freeze:"
+    expected_out += "\n" + textwrap.dedent(
+        """\
+        ...meta==1.0...
+    """
+    )
+    _check_output(result.stdout, expected_out)
+
+    err1 = (
+        "Requirement file hint2.txt contains NoExist, but package "
+        "'NoExist' is not installed\n"
+    )
+    err2 = "Requirement simple included multiple times hint1.txt, hint2.txt\n"
+    assert err1 in result.stderr
+    assert err2 in result.stderr
+    # there shouldn't be any other 'is not installed' warnings
+    assert result.stderr.count("is not installed") == 1
+
+
+@pytest.mark.network
+@pytest.mark.usefixtures("enable_user_site")
+def test_freeze_user(
+    script: PipTestEnvironment, virtualenv: VirtualEnvironment, data: TestData
+) -> None:
+    """
+    Testing freeze with --user, first we have to install some stuff.
+    """
+    script.pip("download", "setuptools", "wheel", "-d", data.packages)
+    script.pip_install_local("--find-links", data.find_links, "--user", "simple==2.0")
+    script.pip_install_local("--find-links", data.find_links, "simple2==3.0")
+    result = script.pip("freeze", "--user", expect_stderr=True)
+    expected = textwrap.dedent(
+        """\
+        simple==2.0
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+    assert "simple2" not in result.stdout
+
+
+@pytest.mark.network
+def test_freeze_path(tmpdir: Path, script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test freeze with --path.
+    """
+    script.pip(
+        "install", "--find-links", data.find_links, "--target", tmpdir, "simple==2.0"
+    )
+    result = script.pip("freeze", "--path", tmpdir)
+    expected = textwrap.dedent(
+        """\
+        simple==2.0
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.network
+@pytest.mark.usefixtures("enable_user_site")
+def test_freeze_path_exclude_user(
+    tmpdir: Path, script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test freeze with --path and make sure packages from --user are not picked
+    up.
+    """
+    script.pip_install_local("--find-links", data.find_links, "--user", "simple2")
+    script.pip(
+        "install", "--find-links", data.find_links, "--target", tmpdir, "simple==1.0"
+    )
+    result = script.pip("freeze", "--user")
+    expected = textwrap.dedent(
+        """\
+        simple2==3.0
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+    result = script.pip("freeze", "--path", tmpdir)
+    expected = textwrap.dedent(
+        """\
+        simple==1.0
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+
+
+@pytest.mark.network
+def test_freeze_path_multiple(
+    tmpdir: Path, script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test freeze with multiple --path arguments.
+    """
+    path1 = tmpdir / "path1"
+    os.mkdir(path1)
+    path2 = tmpdir / "path2"
+    os.mkdir(path2)
+    script.pip(
+        "install", "--find-links", data.find_links, "--target", path1, "simple==2.0"
+    )
+    script.pip(
+        "install", "--find-links", data.find_links, "--target", path2, "simple2==3.0"
+    )
+    result = script.pip("freeze", "--path", path1)
+    expected = textwrap.dedent(
+        """\
+        simple==2.0
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+    result = script.pip("freeze", "--path", path1, "--path", path2)
+    expected = textwrap.dedent(
+        """\
+        simple==2.0
+        simple2==3.0
+        <BLANKLINE>"""
+    )
+    _check_output(result.stdout, expected)
+
+
+def test_freeze_direct_url_archive(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    req = "simple @ " + shared_data.packages.joinpath("simple-2.0.tar.gz").as_uri()
+    script.pip("install", req)
+    result = script.pip("freeze")
+    assert req in result.stdout
+
+
+def test_freeze_skip_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that freeze should not include package
+    present in working directory
+    """
+
+    # Create a test package and create .egg-info dir
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    # Freeze should not include package simple when run from package directory
+    result = script.pip("freeze", cwd=pkg_path)
+    assert "simple" not in result.stdout
+
+
+def test_freeze_include_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that freeze should include package in working directory
+    if working directory is added in PYTHONPATH
+    """
+
+    # Create a test package and create .egg-info dir
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    script.environ.update({"PYTHONPATH": pkg_path})
+
+    # Freeze should include package simple when run from package directory,
+    # when package directory is in PYTHONPATH
+    result = script.pip("freeze", cwd=pkg_path)
+    assert "simple==1.0" in result.stdout
+
+
+def test_freeze_pep610_editable(script: PipTestEnvironment) -> None:
+    """
+    Test that a package installed with a direct_url.json with editable=true
+    is correctly frozeon as editable.
+    """
+    pkg_path = _create_test_package(script.scratch_path, name="testpkg")
+    result = script.pip("install", pkg_path)
+    direct_url_path = get_created_direct_url_path(result, "testpkg")
+    assert direct_url_path
+    # patch direct_url.json to simulate an editable install
+    with open(direct_url_path) as f:
+        direct_url = DirectUrl.from_json(f.read())
+    assert isinstance(direct_url.info, DirInfo)
+    direct_url.info.editable = True
+    with open(direct_url_path, "w") as f:
+        f.write(direct_url.to_json())
+    result = script.pip("freeze")
+    assert "# Editable Git install with no remote (testpkg==0.1)" in result.stdout

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_hash.py Added

@@ -0,0 +1,40 @@
+"""Tests for the ``pip hash`` command"""
+from pathlib import Path
+
+from tests.lib import PipTestEnvironment
+
+
+def test_basic_hash(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """Run 'pip hash' through its default behavior."""
+    expected = (
+        "--hash=sha256:2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425"
+        "e73043362938b9824"
+    )
+    result = script.pip("hash", _hello_file(tmpdir))
+    assert expected in str(result)
+
+
+def test_good_algo_option(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """Make sure the -a option works."""
+    expected = (
+        "--hash=sha512:9b71d224bd62f3785d96d46ad3ea3d73319bfbc2890caad"
+        "ae2dff72519673ca72323c3d99ba5c11d7c7acc6e14b8c5da0c4663475c2e"
+        "5c3adef46f73bcdec043"
+    )
+    result = script.pip("hash", "-a", "sha512", _hello_file(tmpdir))
+    assert expected in str(result)
+
+
+def test_bad_algo_option(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """Make sure the -a option raises an error when given a bad operand."""
+    result = script.pip(
+        "hash", "-a", "invalidname", _hello_file(tmpdir), expect_error=True
+    )
+    assert "invalid choice: 'invalidname'" in str(result)
+
+
+def _hello_file(tmpdir: Path) -> Path:
+    """Return a temp file to hash containing "hello"."""
+    file = tmpdir / "hashable"
+    file.write_text("hello")
+    return file

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_help.py Added

@@ -0,0 +1,118 @@
+from unittest.mock import Mock
+
+import pytest
+
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from pip._internal.commands import commands_dict, create_command
+from pip._internal.exceptions import CommandError
+from tests.conftest import InMemoryPip
+from tests.lib import PipTestEnvironment
+
+
+def test_run_method_should_return_success_when_finds_command_name() -> None:
+    """
+    Test HelpCommand.run for existing command
+    """
+    options_mock = Mock()
+    args = "freeze"
+    help_cmd = create_command("help")
+    status = help_cmd.run(options_mock, args)
+    assert status == SUCCESS
+
+
+def test_run_method_should_return_success_when_command_name_not_specified() -> None:
+    """
+    Test HelpCommand.run when there are no args
+    """
+    options_mock = Mock()
+    help_cmd = create_command("help")
+    status = help_cmd.run(options_mock, )
+    assert status == SUCCESS
+
+
+def test_run_method_should_raise_command_error_when_command_does_not_exist() -> None:
+    """
+    Test HelpCommand.run for non-existing command
+    """
+    options_mock = Mock()
+    args = "mycommand"
+    help_cmd = create_command("help")
+
+    with pytest.raises(CommandError):
+        help_cmd.run(options_mock, args)
+
+
+def test_help_command_should_exit_status_ok_when_command_exists(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test `help` command for existing command
+    """
+    result = script.pip("help", "freeze")
+    assert result.returncode == SUCCESS
+
+
+def test_help_command_should_exit_status_ok_when_no_cmd_is_specified(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test `help` command for no command
+    """
+    result = script.pip("help")
+    assert result.returncode == SUCCESS
+
+
+def test_help_command_should_exit_status_error_when_cmd_does_not_exist(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test `help` command for non-existing command
+    """
+    result = script.pip("help", "mycommand", expect_error=True)
+    assert result.returncode == ERROR
+
+
+def test_help_command_redact_auth_from_url(script: PipTestEnvironment) -> None:
+    """
+    Test `help` on various subcommands redact auth from url
+    """
+    script.environ"PIP_INDEX_URL" = "https://user:secret@example.com"
+    result = script.pip("install", "--help")
+    assert result.returncode == SUCCESS
+    assert "secret" not in result.stdout
+
+
+def test_help_command_redact_auth_from_url_with_extra_index_url(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test `help` on various subcommands redact auth from url with extra index url
+    """
+    script.environ"PIP_INDEX_URL" = "https://user:secret@example.com"
+    script.environ"PIP_EXTRA_INDEX_URL" = "https://user:secret@example2.com"
+    result = script.pip("install", "--help")
+    assert result.returncode == SUCCESS
+    assert "secret" not in result.stdout
+
+
+def test_help_commands_equally_functional(in_memory_pip: InMemoryPip) -> None:
+    """
+    Test if `pip help` and 'pip --help' behave the same way.
+    """
+    results = list(map(in_memory_pip.pip, ("help", "--help")))
+    results.append(in_memory_pip.pip())
+
+    out = map(lambda x: x.stdout, results)
+    ret = map(lambda x: x.returncode, results)
+
+    msg = '"pip --help" != "pip help" != "pip"'
+    assert len(set(out)) == 1, "output of: " + msg
+    assert sum(ret) == 0, "exit codes of: " + msg
+    assert all(len(o) > 0 for o in out)
+
+    for name in commands_dict:
+        assert (
+            in_memory_pip.pip("help", name).stdout
+            == in_memory_pip.pip(name, "--help").stdout
+            != ""
+        )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_index.py Added

@@ -0,0 +1,75 @@
+import pytest
+
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from pip._internal.commands import create_command
+from tests.lib import PipTestEnvironment
+
+
+@pytest.mark.network
+def test_list_all_versions_basic_search(script: PipTestEnvironment) -> None:
+    """
+    End to end test of index versions command.
+    """
+    output = script.pip("index", "versions", "pip", allow_stderr_warning=True)
+    assert "Available versions:" in output.stdout
+    assert (
+        "20.2.3, 20.2.2, 20.2.1, 20.2, 20.1.1, 20.1, 20.0.2"
+        ", 20.0.1, 19.3.1, 19.3, 19.2.3, 19.2.2, 19.2.1, 19.2, 19.1.1"
+        ", 19.1, 19.0.3, 19.0.2, 19.0.1, 19.0, 18.1, 18.0, 10.0.1, 10.0.0, "
+        "9.0.3, 9.0.2, 9.0.1, 9.0.0, 8.1.2, 8.1.1, "
+        "8.1.0, 8.0.3, 8.0.2, 8.0.1, 8.0.0, 7.1.2, 7.1.1, 7.1.0, 7.0.3, "
+        "7.0.2, 7.0.1, 7.0.0, 6.1.1, 6.1.0, 6.0.8, 6.0.7, 6.0.6, 6.0.5, "
+        "6.0.4, 6.0.3, 6.0.2, 6.0.1, 6.0, 1.5.6, 1.5.5, 1.5.4, 1.5.3, "
+        "1.5.2, 1.5.1, 1.5, 1.4.1, 1.4, 1.3.1, 1.3, 1.2.1, 1.2, 1.1, 1.0.2,"
+        " 1.0.1, 1.0, 0.8.3, 0.8.2, 0.8.1, 0.8, 0.7.2, 0.7.1, 0.7, 0.6.3, "
+        "0.6.2, 0.6.1, 0.6, 0.5.1, 0.5, 0.4, 0.3.1, "
+        "0.3, 0.2.1, 0.2" in output.stdout
+    )
+
+
+@pytest.mark.network
+def test_list_all_versions_search_with_pre(script: PipTestEnvironment) -> None:
+    """
+    See that adding the --pre flag adds pre-releases
+    """
+    output = script.pip("index", "versions", "pip", "--pre", allow_stderr_warning=True)
+    assert "Available versions:" in output.stdout
+    assert (
+        "20.2.3, 20.2.2, 20.2.1, 20.2, 20.2b1, 20.1.1, 20.1, 20.1b1, 20.0.2"
+        ", 20.0.1, 19.3.1, 19.3, 19.2.3, 19.2.2, 19.2.1, 19.2, 19.1.1"
+        ", 19.1, 19.0.3, 19.0.2, 19.0.1, 19.0, 18.1, 18.0, 10.0.1, 10.0.0, "
+        "10.0.0b2, 10.0.0b1, 9.0.3, 9.0.2, 9.0.1, 9.0.0, 8.1.2, 8.1.1, "
+        "8.1.0, 8.0.3, 8.0.2, 8.0.1, 8.0.0, 7.1.2, 7.1.1, 7.1.0, 7.0.3, "
+        "7.0.2, 7.0.1, 7.0.0, 6.1.1, 6.1.0, 6.0.8, 6.0.7, 6.0.6, 6.0.5, "
+        "6.0.4, 6.0.3, 6.0.2, 6.0.1, 6.0, 1.5.6, 1.5.5, 1.5.4, 1.5.3, "
+        "1.5.2, 1.5.1, 1.5, 1.4.1, 1.4, 1.3.1, 1.3, 1.2.1, 1.2, 1.1, 1.0.2,"
+        " 1.0.1, 1.0, 0.8.3, 0.8.2, 0.8.1, 0.8, 0.7.2, 0.7.1, 0.7, 0.6.3, "
+        "0.6.2, 0.6.1, 0.6, 0.5.1, 0.5, 0.4, 0.3.1, "
+        "0.3, 0.2.1, 0.2" in output.stdout
+    )
+
+
+@pytest.mark.network
+def test_list_all_versions_returns_no_matches_found_when_name_not_exact() -> None:
+    """
+    Test that non exact name do not match
+    """
+    command = create_command("index")
+    cmdline = "versions pand"
+    with command.main_context():
+        options, args = command.parse_args(cmdline.split())
+        status = command.run(options, args)
+    assert status == ERROR
+
+
+@pytest.mark.network
+def test_list_all_versions_returns_matches_found_when_name_is_exact() -> None:
+    """
+    Test that exact name matches
+    """
+    command = create_command("index")
+    cmdline = "versions pandas"
+    with command.main_context():
+        options, args = command.parse_args(cmdline.split())
+        status = command.run(options, args)
+    assert status == SUCCESS

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_inspect.py Added

@@ -0,0 +1,46 @@
+import json
+
+import pytest
+
+from tests.conftest import ScriptFactory
+from tests.lib import PipTestEnvironment, TestData
+
+
+@pytest.fixture(scope="session")
+def simple_script(
+    tmpdir_factory: pytest.TempPathFactory,
+    script_factory: ScriptFactory,
+    shared_data: TestData,
+) -> PipTestEnvironment:
+    tmpdir = tmpdir_factory.mktemp("pip_test_package")
+    script = script_factory(tmpdir.joinpath("workspace"))
+    script.pip(
+        "install",
+        "-f",
+        shared_data.find_links,
+        "--no-index",
+        "simplewheel==1.0",
+    )
+    return script
+
+
+def test_inspect_basic(simple_script: PipTestEnvironment) -> None:
+    """
+    Test default behavior of inspect command.
+    """
+    result = simple_script.pip("inspect")
+    report = json.loads(result.stdout)
+    installed = report"installed"
+    assert len(installed) == 5
+    installed_by_name = {i"metadata""name": i for i in installed}
+    assert installed_by_name.keys() == {
+        "pip",
+        "setuptools",
+        "wheel",
+        "coverage",
+        "simplewheel",
+    }
+    assert installed_by_name"simplewheel""metadata""version" == "1.0"
+    assert installed_by_name"simplewheel""requested" is True
+    assert installed_by_name"simplewheel""installer" == "pip"
+    assert "environment" in report

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install.py Added

@@ -0,0 +1,2470 @@
+import hashlib
+import os
+import re
+import ssl
+import sys
+import sysconfig
+import textwrap
+from os.path import curdir, join, pardir
+from pathlib import Path
+from typing import Dict, List, Tuple
+
+import pytest
+
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from pip._internal.models.index import PyPI, TestPyPI
+from pip._internal.utils.misc import rmtree
+from pip._internal.utils.urls import path_to_url
+from tests.conftest import CertFactory
+from tests.lib import (
+    PipTestEnvironment,
+    ResolverVariant,
+    TestData,
+    _create_svn_repo,
+    _create_test_package,
+    create_basic_wheel_for_package,
+    create_test_package_with_setup,
+    need_bzr,
+    need_mercurial,
+    need_svn,
+    pyversion,
+    requirements_file,
+)
+from tests.lib.local_repos import local_checkout
+from tests.lib.server import (
+    file_response,
+    make_mock_server,
+    package_page,
+    server_running,
+)
+
+
+@pytest.mark.parametrize("command", ("install", "wheel"))
+@pytest.mark.parametrize("variant", ("missing_setuptools", "bad_setuptools"))
+def test_pep518_uses_build_env(
+    script: PipTestEnvironment,
+    data: TestData,
+    common_wheels: Path,
+    command: str,
+    variant: str,
+) -> None:
+    if variant == "missing_setuptools":
+        script.pip("uninstall", "-y", "setuptools")
+    elif variant == "bad_setuptools":
+        setuptools_mod = script.site_packages_path.joinpath("setuptools.py")
+        with open(setuptools_mod, "a") as f:
+            f.write('\nraise ImportError("toto")')
+    else:
+        raise ValueError(variant)
+    script.pip(
+        command,
+        "--no-index",
+        "-f",
+        common_wheels,
+        "-f",
+        data.packages,
+        data.src.joinpath("pep518-3.0"),
+    )
+
+
+def test_pep518_build_env_uses_same_pip(
+    script: PipTestEnvironment,
+    data: TestData,
+    pip_src: Path,
+    common_wheels: Path,
+    deprecated_python: bool,
+) -> None:
+    """Ensure the subprocess call to pip for installing the
+    build dependencies is using the same version of pip.
+    """
+    with open(script.scratch_path / "pip.py", "w") as fp:
+        fp.write("raise ImportError")
+    script.run(
+        "python",
+        os.fspath(pip_src / "src/pip"),
+        "install",
+        "--no-index",
+        "-f",
+        os.fspath(common_wheels),
+        "-f",
+        os.fspath(data.packages),
+        os.fspath(data.src.joinpath("pep518-3.0")),
+        expect_stderr=deprecated_python,
+    )
+
+
+def test_pep518_refuses_conflicting_requires(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    create_basic_wheel_for_package(script, "setuptools", "1.0")
+    create_basic_wheel_for_package(script, "wheel", "1.0")
+    project_dir = data.src.joinpath("pep518_conflicting_requires")
+    result = script.pip_install_local(
+        "-f", script.scratch_path, project_dir, expect_error=True
+    )
+    assert (
+        result.returncode != 0
+        and (
+            "Some build dependencies for {url} conflict "
+            "with PEP 517/518 supported "
+            "requirements: setuptools==1.0 is incompatible with "
+            "setuptools>=40.8.0.".format(url=project_dir.as_uri())
+        )
+        in result.stderr
+    ), str(result)
+
+
+def test_pep518_refuses_invalid_requires(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    result = script.pip(
+        "install",
+        "-f",
+        common_wheels,
+        data.src.joinpath("pep518_invalid_requires"),
+        expect_error=True,
+    )
+    assert result.returncode == 1
+
+    # Ensure the relevant things are mentioned.
+    assert "PEP 518" in result.stderr
+    assert "not a list of strings" in result.stderr
+    assert "build-system.requires" in result.stderr
+    assert "pyproject.toml" in result.stderr
+
+
+def test_pep518_refuses_invalid_build_system(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    result = script.pip(
+        "install",
+        "-f",
+        common_wheels,
+        data.src.joinpath("pep518_invalid_build_system"),
+        expect_error=True,
+    )
+    assert result.returncode == 1
+
+    # Ensure the relevant things are mentioned.
+    assert "PEP 518" in result.stderr
+    assert "mandatory `requires` key" in result.stderr
+    assert "build-system table" in result.stderr
+    assert "pyproject.toml" in result.stderr
+
+
+def test_pep518_allows_missing_requires(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    result = script.pip(
+        "install",
+        "-f",
+        common_wheels,
+        data.src.joinpath("pep518_missing_requires"),
+        expect_stderr=True,
+    )
+    # Make sure we don't warn when this occurs.
+    assert "PEP 518" not in result.stderr
+
+    # We want it to go through isolation for now.
+    assert "Installing build dependencies" in result.stdout, result.stdout
+
+    assert result.returncode == 0
+    assert result.files_created
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_pep518_with_user_pip(
+    script: PipTestEnvironment, pip_src: Path, data: TestData, common_wheels: Path
+) -> None:
+    """
+    Check that build dependencies are installed into the build
+    environment without using build isolation for the pip invocation.
+
+    To ensure that we're not using build isolation when installing
+    the build dependencies, we install a user copy of pip in the
+    non-isolated environment, and break pip in the system site-packages,
+    so that isolated uses of pip will fail.
+    """
+    script.pip(
+        "install",
+        "--ignore-installed",
+        "-f",
+        common_wheels,
+        "--user",
+        pip_src,
+        # WARNING: The scripts pip, pip3, ... are installed in ... which is not on PATH
+        allow_stderr_warning=True,
+    )
+    system_pip_dir = script.site_packages_path / "pip"
+    assert not system_pip_dir.exists()
+    system_pip_dir.mkdir()
+    with open(system_pip_dir / "__init__.py", "w") as fp:
+        fp.write("raise ImportError\n")
+    script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        common_wheels,
+        "-f",
+        data.packages,
+        data.src.joinpath("pep518-3.0"),
+    )
+
+
+def test_pep518_with_extra_and_markers(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        common_wheels,
+        "-f",
+        data.find_links,
+        data.src.joinpath("pep518_with_extra_and_markers-1.0"),
+    )
+
+
+def test_pep518_with_namespace_package(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        common_wheels,
+        "-f",
+        data.find_links,
+        data.src.joinpath("pep518_with_namespace_package-1.0"),
+        use_module=True,
+    )
+
+
+@pytest.mark.parametrize("command", ("install", "wheel"))
+@pytest.mark.parametrize(
+    "package",
+    ("pep518_forkbomb", "pep518_twin_forkbombs_first", "pep518_twin_forkbombs_second"),
+)
+def test_pep518_forkbombs(
+    script: PipTestEnvironment,
+    data: TestData,
+    common_wheels: Path,
+    command: str,
+    package: str,
+) -> None:
+    package_source = next(data.packages.glob(package + "-0-9*.tar.gz"))
+    result = script.pip(
+        command,
+        "--no-index",
+        "-v",
+        "-f",
+        common_wheels,
+        "-f",
+        data.find_links,
+        package,
+        expect_error=True,
+    )
+    assert (
+        "{1} is already being built: {0} from {1}".format(
+            package,
+            package_source.as_uri(),
+        )
+        in result.stderr
+    ), str(result)
+
+
+@pytest.mark.network
+def test_pip_second_command_line_interface_works(
+    script: PipTestEnvironment,
+    pip_src: Path,
+    data: TestData,
+    common_wheels: Path,
+    deprecated_python: bool,
+) -> None:
+    """
+    Check if ``pip<PYVERSION>`` commands behaves equally
+    """
+    # Re-install pip so we get the launchers.
+    script.pip_install_local("-f", common_wheels, pip_src)
+    args = f"pip{pyversion}"
+    args.extend("install", "INITools==0.2")
+    args.extend("-f", os.fspath(data.packages))
+    result = script.run(*args)
+    dist_info_folder = script.site_packages / "INITools-0.2.dist-info"
+    initools_folder = script.site_packages / "initools"
+    result.did_create(dist_info_folder)
+    result.did_create(initools_folder)
+
+
+def test_install_exit_status_code_when_no_requirements(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test install exit status code when no requirements specified
+    """
+    result = script.pip("install", expect_error=True)
+    assert "You must give at least one requirement to install" in result.stderr
+    assert result.returncode == ERROR
+
+
+def test_install_exit_status_code_when_blank_requirements_file(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test install exit status code when blank requirements file specified
+    """
+    script.scratch_path.joinpath("blank.txt").write_text("\n")
+    script.pip("install", "-r", "blank.txt")
+
+
+@pytest.mark.network
+def test_basic_install_from_pypi(script: PipTestEnvironment) -> None:
+    """
+    Test installing a package from PyPI.
+    """
+    result = script.pip("install", "INITools==0.2")
+    dist_info_folder = script.site_packages / "INITools-0.2.dist-info"
+    initools_folder = script.site_packages / "initools"
+    result.did_create(dist_info_folder)
+    result.did_create(initools_folder)
+
+    # Should not display where it's looking for files
+    assert "Looking in indexes: " not in result.stdout
+    assert "Looking in links: " not in result.stdout
+
+    # Ensure that we don't print the full URL.
+    #    The URL should be trimmed to only the last part of the path in it,
+    #    when installing from PyPI. The assertion here only checks for
+    #    `https://` since that's likely to show up if we're not trimming in
+    #    the correct circumstances.
+    assert "https://" not in result.stdout
+
+
+def test_basic_editable_install(script: PipTestEnvironment) -> None:
+    """
+    Test editable installation.
+    """
+    result = script.pip("install", "-e", "INITools==0.2", expect_error=True)
+    assert "INITools==0.2 is not a valid editable requirement" in result.stderr
+    assert not result.files_created
+
+
+@need_svn
+def test_basic_install_editable_from_svn(script: PipTestEnvironment) -> None:
+    """
+    Test checking out from svn.
+    """
+    checkout_path = _create_test_package(script.scratch_path)
+    repo_url = _create_svn_repo(script.scratch_path, checkout_path)
+    result = script.pip("install", "-e", "svn+" + repo_url + "#egg=version-pkg")
+    result.assert_installed("version-pkg", with_files=".svn")
+
+
+def _test_install_editable_from_git(script: PipTestEnvironment) -> None:
+    """Test cloning from Git."""
+    pkg_path = _create_test_package(script.scratch_path, name="testpackage", vcs="git")
+    args = 
+        "install",
+        "-e",
+        f"git+{pkg_path.as_uri()}#egg=testpackage",
+    
+    result = script.pip(*args)
+    result.assert_installed("testpackage", with_files=".git")
+
+
+def test_basic_install_editable_from_git(script: PipTestEnvironment) -> None:
+    _test_install_editable_from_git(script)
+
+
+def test_install_editable_from_git_autobuild_wheel(script: PipTestEnvironment) -> None:
+    _test_install_editable_from_git(script)
+
+
+@pytest.mark.network
+def test_install_editable_uninstalls_existing(
+    data: TestData, script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test that installing an editable uninstalls a previously installed
+    non-editable version.
+    https://github.com/pypa/pip/issues/1548
+    https://github.com/pypa/pip/pull/1552
+    """
+    to_install = data.packages.joinpath("pip-test-package-0.1.tar.gz")
+    result = script.pip_install_local(to_install)
+    assert "Successfully installed pip-test-package" in result.stdout
+    result.assert_installed("piptestpackage", editable=False)
+
+    result = script.pip(
+        "install",
+        "-e",
+        "{dir}#egg=pip-test-package".format(
+            dir=local_checkout(
+                "git+https://github.com/pypa/pip-test-package.git",
+                tmpdir,
+            )
+        ),
+    )
+    result.assert_installed("pip-test-package", with_files=".git")
+    assert "Found existing installation: pip-test-package 0.1" in result.stdout
+    assert "Uninstalling pip-test-package-" in result.stdout
+    assert "Successfully uninstalled pip-test-package" in result.stdout
+
+
+def test_install_editable_uninstalls_existing_from_path(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test that installing an editable uninstalls a previously installed
+    non-editable version from path
+    """
+    to_install = data.src.joinpath("simplewheel-1.0")
+    result = script.pip_install_local(to_install)
+    assert "Successfully installed simplewheel" in result.stdout
+    simple_folder = script.site_packages / "simplewheel"
+    result.assert_installed("simplewheel", editable=False)
+    result.did_create(simple_folder)
+
+    result = script.pip(
+        "install",
+        "-e",
+        to_install,
+    )
+    install_path = script.site_packages / "simplewheel.egg-link"
+    result.did_create(install_path)
+    assert "Found existing installation: simplewheel 1.0" in result.stdout
+    assert "Uninstalling simplewheel-" in result.stdout
+    assert "Successfully uninstalled simplewheel" in result.stdout
+    assert simple_folder in result.files_deleted, str(result.stdout)
+
+
+@need_mercurial
+def test_basic_install_editable_from_hg(script: PipTestEnvironment) -> None:
+    """Test cloning and hg+file install from Mercurial."""
+    pkg_path = _create_test_package(script.scratch_path, name="testpackage", vcs="hg")
+    url = f"hg+{pkg_path.as_uri()}#egg=testpackage"
+    assert url.startswith("hg+file")
+    args = "install", "-e", url
+    result = script.pip(*args)
+    result.assert_installed("testpackage", with_files=".hg")
+
+
+@need_mercurial
+def test_vcs_url_final_slash_normalization(script: PipTestEnvironment) -> None:
+    """
+    Test that presence or absence of final slash in VCS URL is normalized.
+    """
+    pkg_path = _create_test_package(script.scratch_path, name="testpackage", vcs="hg")
+    args = 
+        "install",
+        "-e",
+        f"hg+{pkg_path.as_uri()}/#egg=testpackage",
+    
+    result = script.pip(*args)
+    result.assert_installed("testpackage", with_files=".hg")
+
+
+@need_bzr
+def test_install_editable_from_bazaar(script: PipTestEnvironment) -> None:
+    """Test checking out from Bazaar."""
+    pkg_path = _create_test_package(
+        script.scratch_path, name="testpackage", vcs="bazaar"
+    )
+    args = 
+        "install",
+        "-e",
+        f"bzr+{pkg_path.as_uri()}/#egg=testpackage",
+    
+    result = script.pip(*args)
+    result.assert_installed("testpackage", with_files=".bzr")
+
+
+@pytest.mark.network
+@need_bzr
+def test_vcs_url_urlquote_normalization(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test that urlquoted characters are normalized for repo URL comparison.
+    """
+    script.pip(
+        "install",
+        "-e",
+        "{url}/#egg=django-wikiapp".format(
+            url=local_checkout(
+                "bzr+http://bazaar.launchpad.net/"
+                "%7Edjango-wikiapp/django-wikiapp"
+                "/release-0.1",
+                tmpdir,
+            )
+        ),
+    )
+
+
+@pytest.mark.parametrize("resolver", "", "--use-deprecated=legacy-resolver")
+def test_basic_install_from_local_directory(
+    script: PipTestEnvironment, data: TestData, resolver: str
+) -> None:
+    """
+    Test installing from a local directory.
+    """
+    args = "install"
+    if resolver:
+        args.append(resolver)
+    to_install = data.packages.joinpath("FSPkg")
+    args.append(os.fspath(to_install))
+    result = script.pip(*args)
+    fspkg_folder = script.site_packages / "fspkg"
+    dist_info_folder = script.site_packages / "FSPkg-0.1.dev0.dist-info"
+    result.did_create(fspkg_folder)
+    result.did_create(dist_info_folder)
+
+
+@pytest.mark.parametrize(
+    "test_type,editable",
+    
+        ("rel_path", False),
+        ("rel_path", True),
+        ("rel_url", False),
+        ("rel_url", True),
+        ("embedded_rel_path", False),
+        ("embedded_rel_path", True),
+    ,
+)
+def test_basic_install_relative_directory(
+    script: PipTestEnvironment, data: TestData, test_type: str, editable: bool
+) -> None:
+    """
+    Test installing a requirement using a relative path.
+    """
+    dist_info_folder = script.site_packages / "FSPkg-0.1.dev0.dist-info"
+    egg_link_file = script.site_packages / "FSPkg.egg-link"
+    package_folder = script.site_packages / "fspkg"
+
+    # Compute relative install path to FSPkg from scratch path.
+    full_rel_path = Path(
+        os.path.relpath(data.packages.joinpath("FSPkg"), script.scratch_path)
+    )
+    full_rel_url = f"file:{full_rel_path.as_posix()}#egg=FSPkg"
+    embedded_rel_path = script.scratch_path.joinpath(full_rel_path)
+
+    req_path = {
+        "rel_path": os.fspath(full_rel_path),
+        "rel_url": full_rel_url,
+        "embedded_rel_path": os.fspath(embedded_rel_path),
+    }test_type
+
+    # Install as either editable or not.
+    if not editable:
+        result = script.pip("install", req_path, cwd=script.scratch_path)
+        result.did_create(dist_info_folder)
+        result.did_create(package_folder)
+    else:
+        # Editable install.
+        result = script.pip("install", "-e", req_path, cwd=script.scratch_path)
+        result.did_create(egg_link_file)
+
+
+def test_install_quiet(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test that install -q is actually quiet.
+    """
+    # Apparently if pip install -q is not actually quiet, then it breaks
+    # everything. See:
+    #   https://github.com/pypa/pip/issues/3418
+    #   https://github.com/docker-library/python/issues/83
+    to_install = data.packages.joinpath("FSPkg")
+    result = script.pip("install", "-qqq", to_install)
+    assert result.stdout == ""
+    assert result.stderr == ""
+
+
+def test_hashed_install_success(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test that installing various sorts of requirements with correct hashes
+    works.
+
+    Test file URLs and index packages (which become HTTP URLs behind the
+    scenes).
+
+    """
+    file_url = data.packages.joinpath("simple-1.0.tar.gz").resolve().as_uri()
+    with requirements_file(
+        "simple2==1.0 --hash=sha256:9336af72ca661e6336eb87bc7de3e8844d853e"
+        "3848c2b9bbd2e8bf01db88c2c7\n"
+        "{simple} --hash=sha256:393043e672415891885c9a2a0929b1af95fb866d6c"
+        "a016b42d2e6ce53619b653".format(simple=file_url),
+        tmpdir,
+    ) as reqs_file:
+        script.pip_install_local("-r", reqs_file.resolve())
+
+
+def test_hashed_install_failure(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """Test that wrong hashes stop installation.
+
+    This makes sure prepare_files() is called in the course of installation
+    and so has the opportunity to halt if hashes are wrong. Checks on various
+    kinds of hashes are in test_req.py.
+
+    """
+    with requirements_file(
+        "simple2==1.0 --hash=sha256:9336af72ca661e6336eb87b"
+        "c7de3e8844d853e3848c2b9bbd2e8bf01db88c2c\n",
+        tmpdir,
+    ) as reqs_file:
+        result = script.pip_install_local("-r", reqs_file.resolve(), expect_error=True)
+    assert len(result.files_created) == 0
+
+
+def test_link_hash_pass_require_hashes(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    """Test that a good hash in user provided direct URL is
+    considered valid for --require-hashes."""
+    url = path_to_url(str(shared_data.packages.joinpath("simple-1.0.tar.gz")))
+    url = (
+        f"{url}#sha256="
+        "393043e672415891885c9a2a0929b1af95fb866d6ca016b42d2e6ce53619b653"
+    )
+    script.pip_install_local("--no-deps", "--require-hashes", url)
+
+
+def test_bad_link_hash_install_failure(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    """Test that wrong hash in direct URL stops installation."""
+    url = path_to_url(str(shared_data.packages.joinpath("simple-1.0.tar.gz")))
+    url = f"{url}#sha256=invalidhash"
+    result = script.pip_install_local("--no-deps", url, expect_error=True)
+    assert "THESE PACKAGES DO NOT MATCH THE HASHES" in result.stderr
+
+
+def test_bad_link_hash_good_user_hash_install_success(
+    script: PipTestEnvironment, shared_data: TestData, tmp_path: Path
+) -> None:
+    """Test that wrong hash in direct URL ignored when good --hash provided.
+
+    This behaviour may be accidental?
+    """
+    url = path_to_url(str(shared_data.packages.joinpath("simple-1.0.tar.gz")))
+    url = f"{url}#sha256=invalidhash"
+    digest = "393043e672415891885c9a2a0929b1af95fb866d6ca016b42d2e6ce53619b653"
+    with requirements_file(
+        f"simple @ {url} --hash sha256:{digest}", tmp_path
+    ) as reqs_file:
+        script.pip_install_local("--no-deps", "--require-hashes", "-r", reqs_file)
+
+
+def test_link_hash_in_dep_fails_require_hashes(
+    script: PipTestEnvironment, tmp_path: Path, shared_data: TestData
+) -> None:
+    """Test that a good hash in direct URL dependency is not considered
+    for --require-hashes."""
+    # Create a project named pkga that depends on the simple-1.0.tar.gz with a direct
+    # URL including a hash.
+    simple_url = path_to_url(str(shared_data.packages.joinpath("simple-1.0.tar.gz")))
+    simple_url_with_hash = (
+        f"{simple_url}#sha256="
+        "393043e672415891885c9a2a0929b1af95fb866d6ca016b42d2e6ce53619b653"
+    )
+    project_path = tmp_path / "pkga"
+    project_path.mkdir()
+    project_path.joinpath("pyproject.toml").write_text(
+        textwrap.dedent(
+            f"""\
+            project
+            name = "pkga"
+            version = "1.0"
+            dependencies = "simple @ {simple_url_with_hash}"
+            """
+        )
+    )
+    # Build a wheel for pkga and compute its hash.
+    wheelhouse = tmp_path / "wheehouse"
+    wheelhouse.mkdir()
+    script.pip("wheel", "--no-deps", "-w", wheelhouse, project_path)
+    digest = hashlib.sha256(
+        wheelhouse.joinpath("pkga-1.0-py3-none-any.whl").read_bytes()
+    ).hexdigest()
+    # Install pkga from a requirements file with hash, using --require-hashes.
+    # This should fail because we have not provided a hash for the 'simple' dependency.
+    with requirements_file(f"pkga==1.0 --hash sha256:{digest}", tmp_path) as reqs_file:
+        result = script.pip(
+            "install",
+            "--no-build-isolation",
+            "--require-hashes",
+            "--no-index",
+            "-f",
+            wheelhouse,
+            "-r",
+            reqs_file,
+            expect_error=True,
+        )
+    assert "Hashes are required in --require-hashes mode" in result.stderr
+
+
+def test_bad_link_hash_in_dep_install_failure(
+    script: PipTestEnvironment, tmp_path: Path, shared_data: TestData
+) -> None:
+    """Test that wrong hash in direct URL dependency stops installation."""
+    url = path_to_url(str(shared_data.packages.joinpath("simple-1.0.tar.gz")))
+    url = f"{url}#sha256=invalidhash"
+    project_path = tmp_path / "pkga"
+    project_path.mkdir()
+    project_path.joinpath("pyproject.toml").write_text(
+        textwrap.dedent(
+            f"""\
+            project
+            name = "pkga"
+            version = "1.0"
+            dependencies = "simple @ {url}"
+            """
+        )
+    )
+    result = script.pip_install_local(
+        "--no-build-isolation", project_path, expect_error=True
+    )
+    assert "THESE PACKAGES DO NOT MATCH THE HASHES" in result.stderr, result.stderr
+
+
+def test_hashed_install_from_cache(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test that installing from a cached built wheel works and that the hash is verified
+    against the hash of the original source archived stored in the cache entry.
+    """
+    with requirements_file(
+        "simple2==1.0 --hash=sha256:"
+        "9336af72ca661e6336eb87bc7de3e8844d853e3848c2b9bbd2e8bf01db88c2c7\n",
+        tmpdir,
+    ) as reqs_file:
+        result = script.pip_install_local(
+            "--use-pep517", "--no-build-isolation", "-r", reqs_file.resolve()
+        )
+        assert "Created wheel for simple2" in result.stdout
+        script.pip("uninstall", "simple2", "-y")
+        result = script.pip_install_local(
+            "--use-pep517", "--no-build-isolation", "-r", reqs_file.resolve()
+        )
+        assert "Using cached simple2" in result.stdout
+    # now try with an invalid hash
+    with requirements_file(
+        "simple2==1.0 --hash=sha256:invalid\n",
+        tmpdir,
+    ) as reqs_file:
+        script.pip("uninstall", "simple2", "-y")
+        result = script.pip_install_local(
+            "--use-pep517",
+            "--no-build-isolation",
+            "-r",
+            reqs_file.resolve(),
+            expect_error=True,
+        )
+        assert (
+            "WARNING: The hashes of the source archive found in cache entry "
+            "don't match, ignoring cached built wheel and re-downloading source."
+        ) in result.stderr
+        assert "Using cached simple2" in result.stdout
+        assert "ERROR: THESE PACKAGES DO NOT MATCH THE HASHES" in result.stderr
+
+
+def assert_re_match(pattern: str, text: str) -> None:
+    assert re.search(pattern, text), f"Could not find {pattern!r} in {text!r}"
+
+
+@pytest.mark.network
+@pytest.mark.skip("Fails on new resolver")
+def test_hashed_install_failure_later_flag(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    with requirements_file(
+        "blessings==1.0\n"
+        "tracefront==0.1 --hash=sha256:somehash\n"
+        "https://files.pythonhosted.org/packages/source/m/more-itertools/"
+        "more-itertools-1.0.tar.gz#md5=b21850c3cfa7efbb70fd662ab5413bdd\n"
+        "https://files.pythonhosted.org/"
+        "packages/source/p/peep/peep-3.1.1.tar.gz\n",
+        tmpdir,
+    ) as reqs_file:
+        result = script.pip("install", "-r", reqs_file.resolve(), expect_error=True)
+
+    assert_re_match(
+        r"Hashes are required in --require-hashes mode, but they are "
+        r"missing .*\n"
+        r"    https://files\.pythonhosted\.org/packages/source/p/peep/peep"
+        r"-3\.1\.1\.tar\.gz --hash=sha256:0-9a-f+\n"
+        r"    blessings==1.0 --hash=sha256:0-9a-f+\n"
+        r"THESE PACKAGES DO NOT MATCH THE HASHES.*\n"
+        r"    tracefront==0.1 .*:\n"
+        r"        Expected sha256 somehash\n"
+        r"             Got        0-9a-f+",
+        result.stderr,
+    )
+
+
+def test_install_from_local_directory_with_in_tree_build(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing from a local directory with default in tree build.
+    """
+    to_install = data.packages.joinpath("FSPkg")
+
+    in_tree_build_dir = to_install / "build"
+    assert not in_tree_build_dir.exists()
+    result = script.pip("install", to_install)
+    fspkg_folder = script.site_packages / "fspkg"
+    dist_info_folder = script.site_packages / "FSPkg-0.1.dev0.dist-info"
+    result.did_create(fspkg_folder)
+    result.did_create(dist_info_folder)
+    assert in_tree_build_dir.exists()
+
+
+def test_install_from_local_directory_with_no_setup_py(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing from a local directory with no 'setup.py'.
+    """
+    result = script.pip("install", data.root, expect_error=True)
+    assert not result.files_created
+    assert "Neither 'setup.py' nor 'pyproject.toml' found." in result.stderr
+
+
+def test_editable_install__local_dir_no_setup_py(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing in editable mode from a local directory with no setup.py.
+    """
+    result = script.pip("install", "-e", data.root, expect_error=True)
+    assert not result.files_created
+    assert (
+        "does not appear to be a Python project: "
+        "neither 'setup.py' nor 'pyproject.toml' found" in result.stderr
+    )
+
+
+@pytest.mark.network
+def test_editable_install__local_dir_no_setup_py_with_pyproject(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test installing in editable mode from a local directory with no setup.py
+    but that does have pyproject.toml with a build backend that does not support
+    the build_editable hook.
+    """
+    local_dir = script.scratch_path.joinpath("temp")
+    local_dir.mkdir()
+    pyproject_path = local_dir.joinpath("pyproject.toml")
+    pyproject_path.write_text(
+        textwrap.dedent(
+            """
+                build-system
+                requires = "setuptools<64"
+                build-backend = "setuptools.build_meta"
+            """
+        )
+    )
+
+    result = script.pip("install", "-e", local_dir, expect_error=True)
+    assert not result.files_created
+
+    msg = result.stderr
+    assert "has a 'pyproject.toml'" in msg
+    assert "does not have a 'setup.py' nor a 'setup.cfg'" in msg
+    assert "cannot be installed in editable mode" in msg
+
+
+def test_editable_install__local_dir_setup_requires_with_pyproject(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    """
+    Test installing in editable mode from a local directory with a setup.py
+    that has setup_requires and a pyproject.toml.
+
+    https://github.com/pypa/pip/issues/10573
+    """
+    local_dir = script.scratch_path.joinpath("temp")
+    local_dir.mkdir()
+    pyproject_path = local_dir.joinpath("pyproject.toml")
+    pyproject_path.write_text("")
+    setup_py_path = local_dir.joinpath("setup.py")
+    setup_py_path.write_text(
+        "from setuptools import setup\n"
+        "setup(name='dummy', setup_requires='simplewheel')\n"
+    )
+
+    script.pip("install", "--find-links", shared_data.find_links, "-e", local_dir)
+
+
+def test_install_pre__setup_requires_with_pyproject(
+    script: PipTestEnvironment, shared_data: TestData, common_wheels: Path
+) -> None:
+    """
+    Test installing with a pre-release build dependency declared in both
+    setup.py and pyproject.toml.
+
+    https://github.com/pypa/pip/issues/10573
+    """
+    depends_package = "prerelease_dependency"
+    depends_path = create_basic_wheel_for_package(script, depends_package, "1.0.0a1")
+
+    local_dir = script.scratch_path.joinpath("temp")
+    local_dir.mkdir()
+    pyproject_path = local_dir.joinpath("pyproject.toml")
+    pyproject_path.write_text(
+        "build-system\n"
+        f'requires = "setuptools", "wheel", "{depends_package}"\n'
+        'build-backend = "setuptools.build_meta"\n'
+    )
+    setup_py_path = local_dir.joinpath("setup.py")
+    setup_py_path.write_text(
+        "from setuptools import setup\n"
+        f"setup(name='dummy', setup_requires='{depends_package}')\n"
+    )
+
+    script.pip(
+        "install",
+        "--pre",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        common_wheels,
+        "--find-links",
+        depends_path.parent,
+        local_dir,
+    )
+
+
+@pytest.mark.network
+def test_upgrade_argparse_shadowed(script: PipTestEnvironment) -> None:
+    # If argparse is installed - even if shadowed for imported - we support
+    # upgrading it and properly remove the older versions files.
+    script.pip("install", "argparse==1.3")
+    result = script.pip("install", "argparse>=1.4")
+    assert "Not uninstalling argparse" not in result.stdout
+
+
+def test_install_curdir(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test installing current directory ('.').
+    """
+    run_from = data.packages.joinpath("FSPkg")
+    # Python 2.4 Windows balks if this exists already
+    egg_info = join(run_from, "FSPkg.egg-info")
+    if os.path.isdir(egg_info):
+        rmtree(egg_info)
+    result = script.pip("install", curdir, cwd=run_from)
+    fspkg_folder = script.site_packages / "fspkg"
+    dist_info_folder = script.site_packages / "FSPkg-0.1.dev0.dist-info"
+    result.did_create(fspkg_folder)
+    result.did_create(dist_info_folder)
+
+
+def test_install_pardir(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test installing parent directory ('..').
+    """
+    run_from = data.packages.joinpath("FSPkg", "fspkg")
+    result = script.pip("install", pardir, cwd=run_from)
+    fspkg_folder = script.site_packages / "fspkg"
+    dist_info_folder = script.site_packages / "FSPkg-0.1.dev0.dist-info"
+    result.did_create(fspkg_folder)
+    result.did_create(dist_info_folder)
+
+
+@pytest.mark.network
+def test_install_global_option(script: PipTestEnvironment) -> None:
+    """
+    Test using global distutils options.
+    (In particular those that disable the actual install action)
+    """
+    result = script.pip(
+        "install",
+        "--global-option=--version",
+        "INITools==0.1",
+        expect_error=True,  # build is going to fail because of --version
+    )
+    assert "INITools==0.1\n" in result.stdout
+    assert not result.files_created
+    assert "Implying --no-binary=:all:" in result.stderr
+    assert "A possible replacement is to use --config-settings" in result.stderr
+
+
+def test_install_with_hacked_egg_info(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    test installing a package which defines its own egg_info class
+    """
+    run_from = data.packages.joinpath("HackedEggInfo")
+    result = script.pip("install", ".", cwd=run_from)
+    assert "Successfully installed hackedegginfo-0.0.0\n" in result.stdout
+
+
+@pytest.mark.xfail
+@pytest.mark.network
+@need_mercurial
+def test_install_global_option_using_editable(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test using global distutils options, but in an editable installation
+    """
+    url = "hg+http://bitbucket.org/runeh/anyjson"
+    result = script.pip(
+        "install",
+        "--global-option=--version",
+        "-e",
+        f"{local_checkout(url, tmpdir)}@0.2.5#egg=anyjson",
+        expect_stderr=True,
+    )
+    assert "Successfully installed anyjson" in result.stdout
+
+
+@pytest.mark.network
+def test_install_package_with_same_name_in_curdir(script: PipTestEnvironment) -> None:
+    """
+    Test installing a package with the same name of a local folder
+    """
+    script.scratch_path.joinpath("mock==0.6").mkdir()
+    result = script.pip("install", "mock==0.6")
+    dist_info_folder = script.site_packages / "mock-0.6.0.dist-info"
+    result.did_create(dist_info_folder)
+
+
+mock100_setup_py = textwrap.dedent(
+    """\
+                        from setuptools import setup
+                        setup(name='mock',
+                              version='100.1')"""
+)
+
+
+def test_install_folder_using_dot_slash(script: PipTestEnvironment) -> None:
+    """
+    Test installing a folder using pip install ./foldername
+    """
+    script.scratch_path.joinpath("mock").mkdir()
+    pkg_path = script.scratch_path / "mock"
+    pkg_path.joinpath("setup.py").write_text(mock100_setup_py)
+    result = script.pip("install", "./mock")
+    dist_info_folder = script.site_packages / "mock-100.1.dist-info"
+    result.did_create(dist_info_folder)
+
+
+def test_install_folder_using_slash_in_the_end(script: PipTestEnvironment) -> None:
+    r"""
+    Test installing a folder using pip install foldername/ or foldername\
+    """
+    script.scratch_path.joinpath("mock").mkdir()
+    pkg_path = script.scratch_path / "mock"
+    pkg_path.joinpath("setup.py").write_text(mock100_setup_py)
+    result = script.pip("install", "mock" + os.path.sep)
+    dist_info_folder = script.site_packages / "mock-100.1.dist-info"
+    result.did_create(dist_info_folder)
+
+
+def test_install_folder_using_relative_path(script: PipTestEnvironment) -> None:
+    """
+    Test installing a folder using pip install folder1/folder2
+    """
+    script.scratch_path.joinpath("initools").mkdir()
+    script.scratch_path.joinpath("initools", "mock").mkdir()
+    pkg_path = script.scratch_path / "initools" / "mock"
+    pkg_path.joinpath("setup.py").write_text(mock100_setup_py)
+    result = script.pip("install", Path("initools") / "mock")
+    dist_info_folder = script.site_packages / "mock-100.1.dist-info"
+    result.did_create(dist_info_folder)
+
+
+@pytest.mark.network
+def test_install_package_which_contains_dev_in_name(script: PipTestEnvironment) -> None:
+    """
+    Test installing package from PyPI which contains 'dev' in name
+    """
+    result = script.pip("install", "django-devserver==0.0.4")
+    devserver_folder = script.site_packages / "devserver"
+    dist_info_folder = script.site_packages / "django_devserver-0.0.4.dist-info"
+    result.did_create(devserver_folder)
+    result.did_create(dist_info_folder)
+
+
+def test_install_package_with_target(script: PipTestEnvironment) -> None:
+    """
+    Test installing a package using pip install --target
+    """
+    target_dir = script.scratch_path / "target"
+    result = script.pip_install_local("-t", target_dir, "simple==1.0")
+    result.did_create(Path("scratch") / "target" / "simple")
+
+    # Test repeated call without --upgrade, no files should have changed
+    result = script.pip_install_local(
+        "-t",
+        target_dir,
+        "simple==1.0",
+        expect_stderr=True,
+    )
+    result.did_not_update(Path("scratch") / "target" / "simple")
+
+    # Test upgrade call, check that new version is installed
+    result = script.pip_install_local("--upgrade", "-t", target_dir, "simple==2.0")
+    result.did_update(Path("scratch") / "target" / "simple")
+    dist_info_folder = Path("scratch") / "target" / "simple-2.0.dist-info"
+    result.did_create(dist_info_folder)
+
+    # Test install and upgrade of single-module package
+    result = script.pip_install_local("-t", target_dir, "singlemodule==0.0.0")
+    singlemodule_py = Path("scratch") / "target" / "singlemodule.py"
+    result.did_create(singlemodule_py)
+
+    result = script.pip_install_local(
+        "-t", target_dir, "singlemodule==0.0.1", "--upgrade"
+    )
+    result.did_update(singlemodule_py)
+
+
+@pytest.mark.parametrize("target_option", "--target", "-t")
+def test_install_package_to_usersite_with_target_must_fail(
+    script: PipTestEnvironment, target_option: str
+) -> None:
+    """
+    Test that installing package to usersite with target
+    must raise error
+    """
+    target_dir = script.scratch_path / "target"
+    result = script.pip_install_local(
+        "--user", target_option, target_dir, "simple==1.0", expect_error=True
+    )
+    assert "Can not combine '--user' and '--target'" in result.stderr, str(result)
+
+
+def test_install_nonlocal_compatible_wheel(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    target_dir = script.scratch_path / "target"
+
+    # Test install with --target
+    result = script.pip(
+        "install",
+        "-t",
+        target_dir,
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--python",
+        "3",
+        "--platform",
+        "fakeplat",
+        "--abi",
+        "fakeabi",
+        "simplewheel",
+    )
+    assert result.returncode == SUCCESS
+
+    distinfo = Path("scratch") / "target" / "simplewheel-2.0-1.dist-info"
+    result.did_create(distinfo)
+
+    # Test install without --target
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links",
+        data.find_links,
+        "--only-binary=:all:",
+        "--python",
+        "3",
+        "--platform",
+        "fakeplat",
+        "--abi",
+        "fakeabi",
+        "simplewheel",
+        expect_error=True,
+    )
+    assert result.returncode == ERROR
+
+
+def test_install_nonlocal_compatible_wheel_path(
+    script: PipTestEnvironment,
+    data: TestData,
+    resolver_variant: ResolverVariant,
+) -> None:
+    target_dir = script.scratch_path / "target"
+
+    # Test a full path requirement
+    result = script.pip(
+        "install",
+        "-t",
+        target_dir,
+        "--no-index",
+        "--only-binary=:all:",
+        Path(data.packages) / "simplewheel-2.0-py3-fakeabi-fakeplat.whl",
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        assert result.returncode == ERROR
+    else:
+        assert result.returncode == SUCCESS
+
+        distinfo = Path("scratch") / "target" / "simplewheel-2.0.dist-info"
+        result.did_create(distinfo)
+
+    # Test a full path requirement (without --target)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--only-binary=:all:",
+        Path(data.packages) / "simplewheel-2.0-py3-fakeabi-fakeplat.whl",
+        expect_error=True,
+    )
+    assert result.returncode == ERROR
+
+
+@pytest.mark.parametrize("opt", ("--target", "--prefix"))
+def test_install_with_target_or_prefix_and_scripts_no_warning(
+    opt: str, script: PipTestEnvironment
+) -> None:
+    """
+    Test that installing with --target does not trigger the "script not
+    in PATH" warning (issue #5201)
+    """
+    target_dir = script.scratch_path / "target"
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.mkdir()
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              version='0.1',
+              py_modules="pkga",
+              entry_points={
+                  'console_scripts': 'pkga=pkga:main'
+              }
+        )
+    """
+        )
+    )
+    pkga_path.joinpath("pkga.py").write_text(
+        textwrap.dedent(
+            """
+        def main(): pass
+    """
+        )
+    )
+    result = script.pip("install", opt, target_dir, pkga_path)
+    # This assertion isn't actually needed, if we get the script warning
+    # the script.pip() call will fail with "stderr not expected". But we
+    # leave the assertion to make the intention of the code clearer.
+    assert "--no-warn-script-location" not in result.stderr, str(result)
+
+
+def test_install_package_with_root(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test installing a package using pip install --root
+    """
+    root_dir = script.scratch_path / "root"
+    result = script.pip(
+        "install",
+        "--root",
+        root_dir,
+        "-f",
+        data.find_links,
+        "--no-index",
+        "simple==1.0",
+    )
+    normal_install_path = os.fspath(
+        script.base_path / script.site_packages / "simple-1.0.dist-info"
+    )
+    # use a function borrowed from distutils
+    # to change the root exactly how the --root option does it
+    from pip._internal.locations.base import change_root
+
+    root_path = change_root(os.path.join(script.scratch, "root"), normal_install_path)
+    result.did_create(root_path)
+
+    # Should show find-links location in output
+    assert "Looking in indexes: " not in result.stdout
+    assert "Looking in links: " in result.stdout
+
+
+def test_install_package_with_prefix(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing a package using pip install --prefix
+    """
+    prefix_path = script.scratch_path / "prefix"
+    result = script.pip(
+        "install",
+        "--prefix",
+        prefix_path,
+        "-f",
+        data.find_links,
+        "--no-binary",
+        "simple",
+        "--no-index",
+        "simple==1.0",
+    )
+
+    rel_prefix_path = script.scratch / "prefix"
+    install_path = join(
+        sysconfig.get_path("purelib", vars={"base": rel_prefix_path}),
+        "simple-1.0.dist-info",
+    )
+    result.did_create(install_path)
+
+
+def _test_install_editable_with_prefix(
+    script: PipTestEnvironment, files: Dictstr, str
+) -> None:
+    # make a dummy project
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.mkdir()
+
+    for fn, contents in files.items():
+        pkga_path.joinpath(fn).write_text(textwrap.dedent(contents))
+
+    if hasattr(sys, "pypy_version_info"):
+        site_packages = os.path.join(
+            "prefix", "lib", f"python{pyversion}", "site-packages"
+        )
+    else:
+        site_packages = sysconfig.get_path("purelib", vars={"base": "prefix"})
+
+    # make sure target path is in PYTHONPATH
+    pythonpath = script.scratch_path / site_packages
+    pythonpath.mkdir(parents=True)
+    script.environ"PYTHONPATH" = pythonpath
+
+    # install pkga package into the absolute prefix directory
+    prefix_path = script.scratch_path / "prefix"
+    result = script.pip("install", "--editable", pkga_path, "--prefix", prefix_path)
+
+    # assert pkga is installed at correct location
+    install_path = script.scratch / site_packages / "pkga.egg-link"
+    result.did_create(install_path)
+
+
+@pytest.mark.network
+def test_install_editable_with_target(script: PipTestEnvironment) -> None:
+    pkg_path = script.scratch_path / "pkg"
+    pkg_path.mkdir()
+    pkg_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(
+            name='pkg',
+            install_requires='watching_testrunner'
+        )
+    """
+        )
+    )
+
+    target = script.scratch_path / "target"
+    target.mkdir()
+    result = script.pip("install", "--editable", pkg_path, "--target", target)
+
+    result.did_create(script.scratch / "target" / "pkg.egg-link")
+    result.did_create(script.scratch / "target" / "watching_testrunner.py")
+
+
+def test_install_editable_with_prefix_setup_py(script: PipTestEnvironment) -> None:
+    setup_py = """
+from setuptools import setup
+setup(name='pkga', version='0.1')
+"""
+    _test_install_editable_with_prefix(script, {"setup.py": setup_py})
+
+
+@pytest.mark.network
+def test_install_editable_with_prefix_setup_cfg(script: PipTestEnvironment) -> None:
+    setup_cfg = """metadata
+name = pkga
+version = 0.1
+"""
+    pyproject_toml = """build-system
+requires = "setuptools<64", "wheel"
+build-backend = "setuptools.build_meta"
+"""
+    _test_install_editable_with_prefix(
+        script, {"setup.cfg": setup_cfg, "pyproject.toml": pyproject_toml}
+    )
+
+
+def test_install_package_conflict_prefix_and_user(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing a package using pip install --prefix --user errors out
+    """
+    prefix_path = script.scratch_path / "prefix"
+    result = script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--user",
+        "--prefix",
+        prefix_path,
+        "simple==1.0",
+        expect_error=True,
+        quiet=True,
+    )
+    assert "Can not combine '--user' and '--prefix'" in result.stderr
+
+
+def test_install_package_that_emits_unicode(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Install a package with a setup.py that emits UTF-8 output and then fails.
+
+    Refs https://github.com/pypa/pip/issues/326
+    """
+    to_install = data.packages.joinpath("BrokenEmitsUTF8")
+    result = script.pip(
+        "install",
+        to_install,
+        expect_error=True,
+        expect_temp=True,
+        quiet=True,
+    )
+    assert (
+        "FakeError: this package designed to fail on install" in result.stderr
+    ), f"stderr: {result.stderr}"
+    assert "UnicodeDecodeError" not in result.stderr
+    assert "UnicodeDecodeError" not in result.stdout
+
+
+def test_install_package_with_utf8_setup(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Install a package with a setup.py that declares a utf-8 encoding."""
+    to_install = data.packages.joinpath("SetupPyUTF8")
+    script.pip("install", to_install)
+
+
+def test_install_package_with_latin1_setup(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Install a package with a setup.py that declares a latin-1 encoding."""
+    to_install = data.packages.joinpath("SetupPyLatin1")
+    script.pip("install", to_install)
+
+
+def test_url_req_case_mismatch_no_index(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    tar ball url requirements (with no egg fragment), that happen to have upper
+    case project names, should be considered equal to later requirements that
+    reference the project name using lower case.
+
+    tests/data/packages contains Upper-1.0.tar.gz and Upper-2.0.tar.gz
+    'requiresupper' has install_requires = 'upper'
+    """
+    Upper = "/".join((data.find_links, "Upper-1.0.tar.gz"))
+    result = script.pip(
+        "install", "--no-index", "-f", data.find_links, Upper, "requiresupper"
+    )
+
+    # only Upper-1.0.tar.gz should get installed.
+    dist_info_folder = script.site_packages / "Upper-1.0.dist-info"
+    result.did_create(dist_info_folder)
+    dist_info_folder = script.site_packages / "Upper-2.0.dist-info"
+    result.did_not_create(dist_info_folder)
+
+
+def test_url_req_case_mismatch_file_index(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    tar ball url requirements (with no egg fragment), that happen to have upper
+    case project names, should be considered equal to later requirements that
+    reference the project name using lower case.
+
+    tests/data/packages3 contains Dinner-1.0.tar.gz and Dinner-2.0.tar.gz
+    'requiredinner' has install_requires = 'dinner'
+
+    This test is similar to test_url_req_case_mismatch_no_index; that test
+    tests behaviour when using "--no-index -f", while this one does the same
+    test when using "--index-url". Unfortunately this requires a different
+    set of packages as it requires a prepared index.html file and
+    subdirectory-per-package structure.
+    """
+    Dinner = "/".join((data.find_links3, "dinner", "Dinner-1.0.tar.gz"))
+    result = script.pip(
+        "install", "--index-url", data.find_links3, Dinner, "requiredinner"
+    )
+
+    # only Upper-1.0.tar.gz should get installed.
+    dist_info_folder = script.site_packages / "Dinner-1.0.dist-info"
+    result.did_create(dist_info_folder)
+    dist_info_folder = script.site_packages / "Dinner-2.0.dist-info"
+    result.did_not_create(dist_info_folder)
+
+
+def test_url_incorrect_case_no_index(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Same as test_url_req_case_mismatch_no_index, except testing for the case
+    where the incorrect case is given in the name of the package to install
+    rather than in a requirements file.
+    """
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "upper",
+    )
+
+    # only Upper-2.0.tar.gz should get installed.
+    dist_info_folder = script.site_packages / "Upper-1.0.dist-info"
+    result.did_not_create(dist_info_folder)
+    dist_info_folder = script.site_packages / "Upper-2.0.dist-info"
+    result.did_create(dist_info_folder)
+
+
+def test_url_incorrect_case_file_index(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Same as test_url_req_case_mismatch_file_index, except testing for the case
+    where the incorrect case is given in the name of the package to install
+    rather than in a requirements file.
+    """
+    result = script.pip(
+        "install",
+        "--index-url",
+        data.find_links3,
+        "dinner",
+        expect_stderr=True,
+    )
+
+    # only Upper-2.0.tar.gz should get installed.
+    dist_info_folder = script.site_packages / "Dinner-1.0.dist-info"
+    result.did_not_create(dist_info_folder)
+    dist_info_folder = script.site_packages / "Dinner-2.0.dist-info"
+    result.did_create(dist_info_folder)
+
+    # Should show index-url location in output
+    assert "Looking in indexes: " in result.stdout
+    assert "Looking in links: " not in result.stdout
+
+
+@pytest.mark.network
+def test_compiles_pyc(script: PipTestEnvironment) -> None:
+    """
+    Test installing with --compile on
+    """
+    del script.environ"PYTHONDONTWRITEBYTECODE"
+    script.pip("install", "--compile", "--no-binary=:all:", "INITools==0.2")
+
+    # There are many locations for the __init__.pyc file so attempt to find
+    #   any of them
+    exists = 
+        os.path.exists(script.site_packages_path / "initools/__init__.pyc"),
+        *script.site_packages_path.glob("initools/__pycache__/__init__*.pyc"),
+    
+
+    assert any(exists)
+
+
+@pytest.mark.network
+def test_no_compiles_pyc(script: PipTestEnvironment) -> None:
+    """
+    Test installing from wheel with --compile on
+    """
+    del script.environ"PYTHONDONTWRITEBYTECODE"
+    script.pip("install", "--no-compile", "--no-binary=:all:", "INITools==0.2")
+
+    # There are many locations for the __init__.pyc file so attempt to find
+    #   any of them
+    exists = 
+        os.path.exists(script.site_packages_path / "initools/__init__.pyc"),
+        *script.site_packages_path.glob("initools/__pycache__/__init__*.pyc"),
+    
+
+    assert not any(exists)
+
+
+def test_install_upgrade_editable_depending_on_other_editable(
+    script: PipTestEnvironment,
+) -> None:
+    script.scratch_path.joinpath("pkga").mkdir()
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              version='0.1')
+    """
+        )
+    )
+    script.pip("install", "--editable", pkga_path)
+    result = script.pip("list", "--format=freeze")
+    assert "pkga==0.1" in result.stdout
+
+    script.scratch_path.joinpath("pkgb").mkdir()
+    pkgb_path = script.scratch_path / "pkgb"
+    pkgb_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkgb',
+              version='0.1',
+              install_requires='pkga')
+    """
+        )
+    )
+    script.pip("install", "--upgrade", "--editable", pkgb_path, "--no-index")
+    result = script.pip("list", "--format=freeze")
+    assert "pkgb==0.1" in result.stdout
+
+
+def test_install_subprocess_output_handling(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    args = "install", os.fspath(data.src.joinpath("chattymodule"))
+
+    # Regular install should not show output from the chatty setup.py
+    result = script.pip(*args)
+    assert 0 == result.stdout.count("HELLO FROM CHATTYMODULE")
+    script.pip("uninstall", "-y", "chattymodule")
+
+    # With --verbose we should show the output.
+    # Only count examples with sys.argv1 == egg_info, because we call
+    # setup.py multiple times, which should not count as duplicate output.
+    result = script.pip(*(args + "--verbose"), expect_stderr=True)
+    assert 1 == result.stderr.count("HELLO FROM CHATTYMODULE egg_info")
+    script.pip("uninstall", "-y", "chattymodule")
+
+    # If the install fails, then we *should* show the output... but only once,
+    # even if --verbose is given.
+    result = script.pip(*(args + "--global-option=--fail"), expect_error=True)
+    # This error is emitted 3 times:
+    # - by setup.py bdist_wheel
+    # - by setup.py clean
+    assert 2 == result.stderr.count("I DIE, I DIE")
+
+    result = script.pip(
+        *(args + "--global-option=--fail", "--verbose"), expect_error=True
+    )
+    assert 2 == result.stderr.count("I DIE, I DIE")
+
+
+def test_install_log(script: PipTestEnvironment, data: TestData, tmpdir: Path) -> None:
+    # test that verbose logs go to "--log" file
+    f = tmpdir.joinpath("log.txt")
+    result = script.pip(f"--log={f}", "install", data.src.joinpath("chattymodule"))
+    assert 0 == result.stdout.count("HELLO FROM CHATTYMODULE")
+    with open(f) as fp:
+        # one from egg_info, one from install
+        assert 2 == fp.read().count("HELLO FROM CHATTYMODULE")
+
+
+def test_install_topological_sort(script: PipTestEnvironment, data: TestData) -> None:
+    res = str(script.pip("install", "TopoRequires4", "--no-index", "-f", data.packages))
+    order1 = "TopoRequires, TopoRequires2, TopoRequires3, TopoRequires4"
+    order2 = "TopoRequires, TopoRequires3, TopoRequires2, TopoRequires4"
+    assert order1 in res or order2 in res, res
+
+
+def test_cleanup_after_failed_wheel(script: PipTestEnvironment) -> None:
+    res = script.pip_install_local("wheelbrokenafter", expect_error=True)
+    assert "ERROR: Failed building wheel for wheelbrokenafter" in res.stderr
+    # OK, assert that we *said* we were cleaning up:
+    # /!\ if in need to change this, also change test_pep517_no_legacy_cleanup
+    assert "Running setup.py clean for wheelbrokenafter" in str(res), str(res)
+
+
+def test_install_builds_wheels(script: PipTestEnvironment, data: TestData) -> None:
+    # We need to use a subprocess to get the right value on Windows.
+    res = script.run(
+        "python",
+        "-c",
+        (
+            "from pip._internal.utils import appdirs; "
+            'print(appdirs.user_cache_dir("pip"))'
+        ),
+    )
+    wheels_cache = os.path.join(res.stdout.rstrip("\n"), "wheels")
+    # NB This incidentally tests a local tree + tarball inputs
+    # see test_install_editable_from_git_autobuild_wheel for editable
+    # vcs coverage.
+    to_install = data.packages.joinpath("requires_wheelbroken_upper")
+    res = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        to_install,
+        expect_error=True,  # error building wheelbroken
+    )
+    wheels: Liststr = 
+    for _, _, files in os.walk(wheels_cache):
+        wheels.extend(f for f in files if f.endswith(".whl"))
+    # Built wheel for upper
+    assert "Building wheel for upper" in str(res), str(res)
+    # Built wheel for wheelbroken, but failed
+    assert "Building wheel for wheelb" in str(res), str(res)
+    assert "Failed to build wheelbroken" in str(res), str(res)
+    # Wheels are built for local directories, but not cached.
+    assert "Building wheel for requir" in str(res), str(res)
+    # into the cache
+    assert wheels != , str(res)
+    assert wheels == 
+        "Upper-2.0-py{}-none-any.whl".format(sys.version_info0),
+    
+
+
+def test_install_no_binary_builds_wheels(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.packages.joinpath("requires_wheelbroken_upper")
+    res = script.pip(
+        "install",
+        "--no-index",
+        "--no-binary=upper",
+        "-f",
+        data.find_links,
+        to_install,
+        expect_error=True,  # error building wheelbroken
+    )
+    # Wheels are built for all requirements
+    assert "Building wheel for wheelb" in str(res), str(res)
+    assert "Building wheel for requir" in str(res), str(res)
+    assert "Building wheel for upper" in str(res), str(res)
+    # Wheelbroken failed to build
+    assert "Failed to build wheelbroken" in str(res), str(res)
+
+
+@pytest.mark.network
+def test_install_no_binary_builds_pep_517_wheel(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.packages.joinpath("pep517_setup_and_pyproject")
+    res = script.pip("install", "--no-binary=:all:", "-f", data.find_links, to_install)
+    expected = "Successfully installed pep517-setup-and-pyproject"
+    # Must have installed the package
+    assert expected in str(res), str(res)
+
+    assert "Building wheel for pep517-setup" in str(res), str(res)
+
+
+@pytest.mark.network
+def test_install_no_binary_uses_local_backend(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    to_install = data.packages.joinpath("pep517_wrapper_buildsys")
+    script.environ"PIP_TEST_MARKER_FILE" = marker = str(tmpdir / "marker")
+    res = script.pip("install", "--no-binary=:all:", "-f", data.find_links, to_install)
+    expected = "Successfully installed pep517-wrapper-buildsys"
+    # Must have installed the package
+    assert expected in str(res), str(res)
+
+    assert os.path.isfile(marker), "Local PEP 517 backend not used"
+
+
+def test_install_no_binary_uses_cached_wheels(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    # Seed the cache
+    script.pip("install", "--no-index", "-f", data.find_links, "upper")
+    script.pip("uninstall", "upper", "-y")
+    res = script.pip(
+        "install",
+        "--no-index",
+        "--no-binary=:all:",
+        "-f",
+        data.find_links,
+        "upper",
+        expect_stderr=True,
+    )
+    assert "Successfully installed upper-2.0" in str(res), str(res)
+    # upper is built and not obtained from cache
+    assert "Building wheel for upper" not in str(res), str(res)
+
+
+def test_install_editable_with_wrong_egg_name(
+    script: PipTestEnvironment, resolver_variant: ResolverVariant
+) -> None:
+    script.scratch_path.joinpath("pkga").mkdir()
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              version='0.1')
+    """
+        )
+    )
+    result = script.pip(
+        "install",
+        "--editable",
+        f"file://{pkga_path}#egg=pkgb",
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    assert (
+        "Generating metadata for package pkgb produced metadata "
+        "for project name pkga. Fix your #egg=pkgb "
+        "fragments."
+    ) in result.stderr
+    if resolver_variant == "2020-resolver":
+        assert "has inconsistent" in result.stdout, str(result)
+    else:
+        assert "Successfully installed pkga" in str(result), str(result)
+
+
+def test_install_tar_xz(script: PipTestEnvironment, data: TestData) -> None:
+    try:
+        import lzma  # noqa
+    except ImportError:
+        pytest.skip("No lzma support")
+    res = script.pip("install", data.packages / "singlemodule-0.0.1.tar.xz")
+    assert "Successfully installed singlemodule-0.0.1" in res.stdout, res
+
+
+def test_install_tar_lzma(script: PipTestEnvironment, data: TestData) -> None:
+    try:
+        import lzma  # noqa
+    except ImportError:
+        pytest.skip("No lzma support")
+    res = script.pip("install", data.packages / "singlemodule-0.0.1.tar.lzma")
+    assert "Successfully installed singlemodule-0.0.1" in res.stdout, res
+
+
+def test_double_install(script: PipTestEnvironment) -> None:
+    """
+    Test double install passing with two same version requirements
+    """
+    result = script.pip("install", "pip", "pip")
+    msg = "Double requirement given: pip (already in pip, name='pip')"
+    assert msg not in result.stderr
+
+
+def test_double_install_fail(
+    script: PipTestEnvironment, resolver_variant: ResolverVariant
+) -> None:
+    """
+    Test double install failing with two different version requirements
+    """
+    result = script.pip(
+        "install",
+        "pip==7.*",
+        "pip==7.1.2",
+        # The new resolver is perfectly capable of handling this
+        expect_error=(resolver_variant == "legacy"),
+    )
+    if resolver_variant == "legacy":
+        msg = "Double requirement given: pip==7.1.2 (already in pip==7.*, name='pip')"
+        assert msg in result.stderr
+
+
+def _get_expected_error_text() -> str:
+    return ("Package 'pkga' requires a different Python: {} not in '<1.0'").format(
+        ".".join(map(str, sys.version_info:3))
+    )
+
+
+def test_install_incompatible_python_requires(script: PipTestEnvironment) -> None:
+    script.scratch_path.joinpath("pkga").mkdir()
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              python_requires='<1.0',
+              version='0.1')
+    """
+        )
+    )
+    result = script.pip("install", pkga_path, expect_error=True)
+    assert _get_expected_error_text() in result.stderr, str(result)
+
+
+def test_install_incompatible_python_requires_editable(
+    script: PipTestEnvironment,
+) -> None:
+    script.scratch_path.joinpath("pkga").mkdir()
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              python_requires='<1.0',
+              version='0.1')
+    """
+        )
+    )
+    result = script.pip("install", f"--editable={pkga_path}", expect_error=True)
+    assert _get_expected_error_text() in result.stderr, str(result)
+
+
+def test_install_incompatible_python_requires_wheel(script: PipTestEnvironment) -> None:
+    script.scratch_path.joinpath("pkga").mkdir()
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              python_requires='<1.0',
+              version='0.1')
+    """
+        )
+    )
+    script.run(
+        "python",
+        "setup.py",
+        "bdist_wheel",
+        "--universal",
+        cwd=pkga_path,
+    )
+    result = script.pip(
+        "install", "./pkga/dist/pkga-0.1-py2.py3-none-any.whl", expect_error=True
+    )
+    assert _get_expected_error_text() in result.stderr, str(result)
+
+
+def test_install_compatible_python_requires(script: PipTestEnvironment) -> None:
+    script.scratch_path.joinpath("pkga").mkdir()
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              python_requires='>1.0',
+              version='0.1')
+    """
+        )
+    )
+    res = script.pip("install", pkga_path)
+    assert "Successfully installed pkga-0.1" in res.stdout, res
+
+
+@pytest.mark.network
+def test_install_pep508_with_url(script: PipTestEnvironment) -> None:
+    res = script.pip(
+        "install",
+        "--no-index",
+        "packaging@https://files.pythonhosted.org/packages/2f/2b/"
+        "c681de3e1dbcd469537aefb15186b800209aa1f299d933d23b48d85c9d56/"
+        "packaging-15.3-py2.py3-none-any.whl#sha256="
+        "ce1a869fe039fbf7e217df36c4653d1dbe657778b2d41709593a0003584405f4",
+    )
+    assert "Successfully installed packaging-15.3" in str(res), str(res)
+
+
+@pytest.mark.network
+def test_install_pep508_with_url_in_install_requires(
+    script: PipTestEnvironment,
+) -> None:
+    pkga_path = create_test_package_with_setup(
+        script,
+        name="pkga",
+        version="1.0",
+        install_requires=
+            "packaging@https://files.pythonhosted.org/packages/2f/2b/"
+            "c681de3e1dbcd469537aefb15186b800209aa1f299d933d23b48d85c9d56/"
+            "packaging-15.3-py2.py3-none-any.whl#sha256="
+            "ce1a869fe039fbf7e217df36c4653d1dbe657778b2d41709593a0003584405f4"
+        ,
+    )
+    res = script.pip("install", pkga_path)
+    assert "Successfully installed packaging-15.3" in str(res), str(res)
+
+
+@pytest.mark.network
+@pytest.mark.parametrize("index", (PyPI.simple_url, TestPyPI.simple_url))
+def test_install_from_test_pypi_with_ext_url_dep_is_blocked(
+    script: PipTestEnvironment, index: str
+) -> None:
+    res = script.pip(
+        "install",
+        "--index-url",
+        index,
+        "pep-508-url-deps",
+        expect_error=True,
+    )
+    error_message = (
+        "Packages installed from PyPI cannot depend on packages "
+        "which are not also hosted on PyPI."
+    )
+    error_cause = (
+        "pep-508-url-deps depends on sampleproject@ "
+        "https://github.com/pypa/sampleproject/archive/master.zip"
+    )
+    assert res.returncode == 1
+    assert error_message in res.stderr, str(res)
+    assert error_cause in res.stderr, str(res)
+
+
+@pytest.mark.xfail(
+    reason="No longer possible to trigger the warning with either --prefix or --target"
+)
+def test_installing_scripts_outside_path_prints_warning(
+    script: PipTestEnvironment,
+) -> None:
+    result = script.pip_install_local("--prefix", script.scratch_path, "script_wheel1")
+    assert "Successfully installed script_wheel1" in result.stdout, str(result)
+    assert "--no-warn-script-location" in result.stderr
+
+
+def test_installing_scripts_outside_path_can_suppress_warning(
+    script: PipTestEnvironment,
+) -> None:
+    result = script.pip_install_local(
+        "--prefix", script.scratch_path, "--no-warn-script-location", "script_wheel1"
+    )
+    assert "Successfully installed script_wheel1" in result.stdout, str(result)
+    assert "--no-warn-script-location" not in result.stderr
+
+
+def test_installing_scripts_on_path_does_not_print_warning(
+    script: PipTestEnvironment,
+) -> None:
+    result = script.pip_install_local("script_wheel1")
+    assert "Successfully installed script_wheel1" in result.stdout, str(result)
+    assert "--no-warn-script-location" not in result.stderr
+
+
+def test_install_conflict_results_in_warning(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    pkgA_path = create_test_package_with_setup(
+        script,
+        name="pkgA",
+        version="1.0",
+        install_requires="pkgb == 1.0",
+    )
+    pkgB_path = create_test_package_with_setup(
+        script,
+        name="pkgB",
+        version="2.0",
+    )
+
+    # Install pkgA without its dependency
+    result1 = script.pip("install", "--no-index", pkgA_path, "--no-deps")
+    assert "Successfully installed pkgA-1.0" in result1.stdout, str(result1)
+
+    # Then install an incorrect version of the dependency
+    result2 = script.pip(
+        "install",
+        "--no-index",
+        pkgB_path,
+        allow_stderr_error=True,
+    )
+    assert "pkga 1.0 requires pkgb==1.0" in result2.stderr, str(result2)
+    assert "Successfully installed pkgB-2.0" in result2.stdout, str(result2)
+
+
+def test_install_conflict_warning_can_be_suppressed(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    pkgA_path = create_test_package_with_setup(
+        script,
+        name="pkgA",
+        version="1.0",
+        install_requires="pkgb == 1.0",
+    )
+    pkgB_path = create_test_package_with_setup(
+        script,
+        name="pkgB",
+        version="2.0",
+    )
+
+    # Install pkgA without its dependency
+    result1 = script.pip("install", "--no-index", pkgA_path, "--no-deps")
+    assert "Successfully installed pkgA-1.0" in result1.stdout, str(result1)
+
+    # Then install an incorrect version of the dependency; suppressing warning
+    result2 = script.pip("install", "--no-index", pkgB_path, "--no-warn-conflicts")
+    assert "Successfully installed pkgB-2.0" in result2.stdout, str(result2)
+
+
+def test_target_install_ignores_distutils_config_install_prefix(
+    script: PipTestEnvironment,
+) -> None:
+    prefix = script.scratch_path / "prefix"
+    distutils_config = Path.home().joinpath(
+        "pydistutils.cfg" if sys.platform == "win32" else ".pydistutils.cfg",
+    )
+    distutils_config.write_text(
+        textwrap.dedent(
+            f"""
+        install
+        prefix={prefix}
+        """
+        )
+    )
+    target = script.scratch_path / "target"
+    result = script.pip_install_local("simplewheel", "-t", target)
+
+    assert "Successfully installed simplewheel" in result.stdout
+
+    relative_target = os.path.relpath(target, script.base_path)
+    relative_script_base = os.path.relpath(prefix, script.base_path)
+    result.did_create(relative_target)
+    result.did_not_create(relative_script_base)
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_user_config_accepted(script: PipTestEnvironment) -> None:
+    # user set in the config file is parsed as 0/1 instead of True/False.
+    # Check that this doesn't cause a problem.
+    config_file = script.scratch_path / "pip.conf"
+    script.environ"PIP_CONFIG_FILE" = str(config_file)
+    config_file.write_text("install\nuser = true")
+    result = script.pip_install_local("simplewheel")
+
+    assert "Successfully installed simplewheel" in result.stdout
+
+    relative_user = os.path.relpath(script.user_site_path, script.base_path)
+    result.did_create(join(relative_user, "simplewheel"))
+
+
+@pytest.mark.parametrize(
+    "install_args, expected_message",
+    
+        (, "Requirement already satisfied: pip"),
+        ("--upgrade", "Requirement already {}: pip in"),
+    ,
+)
+@pytest.mark.parametrize("use_module", True, False)
+def test_install_pip_does_not_modify_pip_when_satisfied(
+    script: PipTestEnvironment,
+    install_args: Liststr,
+    expected_message: str,
+    use_module: bool,
+    resolver_variant: ResolverVariant,
+) -> None:
+    """
+    Test it doesn't upgrade the pip if it already satisfies the requirement.
+    """
+    variation = "satisfied" if resolver_variant else "up-to-date"
+    expected_message = expected_message.format(variation)
+    result = script.pip_install_local("pip", *install_args, use_module=use_module)
+    assert expected_message in result.stdout, str(result)
+
+
+def test_ignore_yanked_file(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test ignore a "yanked" file.
+    """
+    result = script.pip(
+        "install",
+        "simple",
+        "--index-url",
+        data.index_url("yanked"),
+    )
+    # Make sure a "yanked" release is ignored
+    assert "Successfully installed simple-2.0\n" in result.stdout, str(result)
+
+
+def test_invalid_index_url_argument(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    """
+    Test the behaviour of an invalid --index-url argument
+    """
+
+    result = script.pip(
+        "install",
+        "--index-url",
+        "--user",
+        shared_data.find_links3,
+        "Dinner",
+        expect_error=True,
+    )
+
+    assert (
+        'WARNING: The index url "--user" seems invalid, please provide a scheme.'
+    ) in result.stderr, str(result)
+
+
+def test_valid_index_url_argument(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    """
+    Test the behaviour of an valid --index-url argument
+    """
+
+    result = script.pip("install", "--index-url", shared_data.find_links3, "Dinner")
+
+    assert "Successfully installed Dinner" in result.stdout, str(result)
+
+
+def test_install_yanked_file_and_print_warning(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test install a "yanked" file and print a warning.
+
+    Yanked files are always ignored, unless they are the only file that
+    matches a version specifier that "pins" to an exact version (PEP 592).
+    """
+    result = script.pip(
+        "install",
+        "simple==3.0",
+        "--index-url",
+        data.index_url("yanked"),
+        expect_stderr=True,
+    )
+    expected_warning = "Reason for being yanked: test reason message"
+    assert expected_warning in result.stderr, str(result)
+    # Make sure a "yanked" release is installed
+    assert "Successfully installed simple-3.0\n" in result.stdout, str(result)
+
+
+def test_error_all_yanked_files_and_no_pin(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test raising an error if there are only "yanked" files available and no pin
+    """
+    result = script.pip(
+        "install",
+        "simple",
+        "--index-url",
+        data.index_url("yanked_all"),
+        expect_error=True,
+    )
+    # Make sure an error is raised
+    assert (
+        result.returncode == 1
+        and "ERROR: No matching distribution found for simple\n" in result.stderr
+    ), str(result)
+
+
+@pytest.mark.skipif(
+    sys.platform == "linux" and sys.version_info < (3, 8),
+    reason="Custom SSL certification not running well in CI",
+)
+@pytest.mark.parametrize(
+    "install_args",
+    
+        (),
+        ("--trusted-host", "localhost"),
+    ,
+)
+def test_install_sends_client_cert(
+    install_args: Tuplestr, ...,
+    script: PipTestEnvironment,
+    cert_factory: CertFactory,
+    data: TestData,
+) -> None:
+    cert_path = cert_factory()
+    ctx = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
+    ctx.load_cert_chain(cert_path, cert_path)
+    ctx.load_verify_locations(cafile=cert_path)
+    ctx.verify_mode = ssl.CERT_REQUIRED
+
+    server = make_mock_server(ssl_context=ctx)
+    server.mock.side_effect = 
+        package_page(
+            {
+                "simple-3.0.tar.gz": "/files/simple-3.0.tar.gz",
+            }
+        ),
+        file_response(data.packages / "simple-3.0.tar.gz"),
+    
+
+    url = f"https://{server.host}:{server.port}/simple"
+
+    args = "install", "-vvv", "--cert", cert_path, "--client-cert", cert_path
+    args.extend("--index-url", url)
+    args.extend(install_args)
+    args.append("simple")
+
+    with server_running(server):
+        script.pip(*args)
+
+    assert server.mock.call_count == 2
+    for call_args in server.mock.call_args_list:
+        # Legacy: replace call_args0 with call_args.args
+        # when pip drops support for python3.7
+        environ, _ = call_args0
+        assert "SSL_CLIENT_CERT" in environ
+        assert environ"SSL_CLIENT_CERT"
+
+
+def test_install_skip_work_dir_pkg(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test that install of a package in working directory
+    should pass on the second attempt after an install
+    and an uninstall
+    """
+
+    # Create a test package, install it and then uninstall it
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.pip("install", "-e", ".", expect_stderr=True, cwd=pkg_path)
+
+    script.pip("uninstall", "simple", "-y")
+
+    # Running the install command again from the working directory
+    # will install the package as it was uninstalled earlier
+    result = script.pip(
+        "install",
+        "--find-links",
+        data.find_links,
+        "simple",
+        expect_stderr=True,
+        cwd=pkg_path,
+    )
+
+    assert "Requirement already satisfied: simple" not in result.stdout
+    assert "Successfully installed simple" in result.stdout
+
+
+@pytest.mark.parametrize(
+    "package_name", ("simple-package", "simple_package", "simple.package")
+)
+def test_install_verify_package_name_normalization(
+    script: PipTestEnvironment, package_name: str
+) -> None:
+    """
+    Test that install of a package again using a name which
+    normalizes to the original package name, is a no-op
+    since the package is already installed
+    """
+    pkg_path = create_test_package_with_setup(
+        script, name="simple-package", version="1.0"
+    )
+    result = script.pip("install", "-e", ".", expect_stderr=True, cwd=pkg_path)
+    assert "Successfully installed simple-package" in result.stdout
+
+    result = script.pip("install", package_name)
+    assert "Requirement already satisfied: {}".format(package_name) in result.stdout
+
+
+def test_install_logs_pip_version_in_debug(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    fake_package = shared_data.packages / "simple-2.0.tar.gz"
+    result = script.pip("install", "-v", fake_package)
+    pattern = "Using pip .* from .*"
+    assert_re_match(pattern, result.stdout)
+
+
+def test_install_dry_run(script: PipTestEnvironment, data: TestData) -> None:
+    """Test that pip install --dry-run logs what it would install."""
+    result = script.pip(
+        "install", "--dry-run", "--find-links", data.find_links, "simple"
+    )
+    assert "Would install simple-3.0" in result.stdout
+    assert "Successfully installed" not in result.stdout
+
+
+@pytest.mark.skipif(
+    sys.version_info < (3, 11),
+    reason="3.11 required to find distributions via importlib metadata",
+)
+def test_install_existing_memory_distribution(script: PipTestEnvironment) -> None:
+    sitecustomize_text = textwrap.dedent(
+        """
+        import sys
+        from importlib.metadata import Distribution, DistributionFinder
+
+
+        EXAMPLE_METADATA = '''Metadata-Version: 2.1
+        Name: example
+        Version: 1.0.0
+
+        '''
+
+        class ExampleDistribution(Distribution):
+            def locate_file(self, path):
+                return path
+
+            def read_text(self, filename):
+                if filename == 'METADATA':
+                    return EXAMPLE_METADATA
+
+
+        class CustomFinder(DistributionFinder):
+            def find_distributions(self, context=None):
+                return ExampleDistribution()
+
+
+        sys.meta_path.append(CustomFinder())
+        """
+    )
+    with open(script.site_packages_path / "sitecustomize.py", "w") as sitecustomize:
+        sitecustomize.write(sitecustomize_text)
+
+    result = script.pip("install", "example")
+
+    assert "Requirement already satisfied: example in <memory>" in result.stdout
+
+
+def test_install_pip_prints_req_chain_local(script: PipTestEnvironment) -> None:
+    """
+    Test installing a local package with a dependency and check that the
+    dependency chain is reported.
+    """
+
+    req_path = script.scratch_path.joinpath("requirements.txt")
+    req_path.write_text("base==0.1.0")
+
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    dep_path = create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-r",
+        req_path,
+    )
+    assert_re_match(
+        rf"Processing .*{re.escape(os.path.basename(dep_path))} "
+        rf"$from base==0.1.0->-r {re.escape(str(req_path))} \(line 1$\)",
+        result.stdout,
+    )
+
+
+@pytest.mark.network
+def test_install_pip_prints_req_chain_pypi(script: PipTestEnvironment) -> None:
+    """
+    Test installing a package with a dependency from PyPI and check that the
+    dependency chain is reported.
+    """
+    req_path = script.scratch_path.joinpath("requirements.txt")
+    req_path.write_text("Pasteopenid==1.7.5.1")
+
+    result = script.pip(
+        "install",
+        "-r",
+        req_path,
+    )
+
+    assert (
+        f"Collecting python-openid "
+        f"(from Pasteopenid==1.7.5.1->-r {req_path} (line 1))" in result.stdout
+    )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_check.py Added

@@ -0,0 +1,125 @@
+from typing import Iterable
+
+from tests.lib import PipTestEnvironment, create_test_package_with_setup
+
+
+def assert_contains_expected_lines(string: str, expected_lines: Iterablestr) -> None:
+    for expected_line in expected_lines:
+        assert (expected_line + "\n") in string
+
+
+def test_check_install_canonicalization(script: PipTestEnvironment) -> None:
+    pkga_path = create_test_package_with_setup(
+        script,
+        name="pkgA",
+        version="1.0",
+        install_requires="normal-missing", "SPECIAL.missing",
+    )
+    normal_path = create_test_package_with_setup(
+        script,
+        name="normal-missing",
+        version="0.1",
+    )
+    special_path = create_test_package_with_setup(
+        script,
+        name="SPECIAL.missing",
+        version="0.1",
+    )
+
+    # Let's install pkgA without its dependency
+    result = script.pip("install", "--no-index", pkga_path, "--no-deps")
+    assert "Successfully installed pkgA-1.0" in result.stdout, str(result)
+
+    # Install the first missing dependency. Only an error for the
+    # second dependency should remain.
+    result = script.pip(
+        "install",
+        "--no-index",
+        normal_path,
+        "--quiet",
+        allow_stderr_error=True,
+    )
+    expected_lines = 
+        "pkga 1.0 requires SPECIAL.missing, which is not installed.",
+    
+    # Deprecated python versions produce an extra warning on stderr
+    assert_contains_expected_lines(result.stderr, expected_lines)
+    assert result.returncode == 0
+
+    # Install the second missing package and expect that there is no warning
+    # during the installation. This is special as the package name requires
+    # name normalization (as in https://github.com/pypa/pip/issues/5134)
+    result = script.pip(
+        "install",
+        "--no-index",
+        special_path,
+        "--quiet",
+    )
+    assert "requires" not in result.stderr
+    assert result.returncode == 0
+
+    # Double check that all errors are resolved in the end
+    result = script.pip("check")
+    expected_lines = 
+        "No broken requirements found.",
+    
+    assert_contains_expected_lines(result.stdout, expected_lines)
+    assert result.returncode == 0
+
+
+def test_check_install_does_not_warn_for_out_of_graph_issues(
+    script: PipTestEnvironment,
+) -> None:
+    pkg_broken_path = create_test_package_with_setup(
+        script,
+        name="broken",
+        version="1.0",
+        install_requires="missing", "conflict < 1.0",
+    )
+    pkg_unrelated_path = create_test_package_with_setup(
+        script,
+        name="unrelated",
+        version="1.0",
+    )
+    pkg_conflict_path = create_test_package_with_setup(
+        script,
+        name="conflict",
+        version="1.0",
+    )
+
+    # Install a package without it's dependencies
+    result = script.pip("install", "--no-index", pkg_broken_path, "--no-deps")
+    assert "requires" not in result.stderr
+
+    # Install conflict package
+    result = script.pip(
+        "install",
+        "--no-index",
+        pkg_conflict_path,
+        allow_stderr_error=True,
+    )
+    assert_contains_expected_lines(
+        result.stderr,
+        
+            "broken 1.0 requires missing, which is not installed.",
+            "broken 1.0 requires conflict<1.0, "
+            "but you have conflict 1.0 which is incompatible.",
+        ,
+    )
+
+    # Install unrelated package
+    result = script.pip(
+        "install",
+        "--no-index",
+        pkg_unrelated_path,
+        "--quiet",
+    )
+    # should not warn about broken's deps when installing unrelated package
+    assert "requires" not in result.stderr
+
+    result = script.pip("check", expect_error=True)
+    expected_lines = 
+        "broken 1.0 requires missing, which is not installed.",
+        "broken 1.0 has requirement conflict<1.0, but you have conflict 1.0.",
+    
+    assert_contains_expected_lines(result.stdout, expected_lines)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_cleanup.py Added

@@ -0,0 +1,43 @@
+from os.path import exists
+
+import pytest
+
+from tests.lib import PipTestEnvironment, TestData
+
+
+@pytest.mark.network
+@pytest.mark.xfail(reason="The --build option was removed")
+def test_no_clean_option_blocks_cleaning_after_install(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test --no-clean option blocks cleaning after install
+    """
+    build = script.base_path / "pip-build"
+    script.pip(
+        "install",
+        "--no-clean",
+        "--no-index",
+        "--build",
+        build,
+        f"--find-links={data.find_links}",
+        "simple",
+        expect_temp=True,
+        # TODO: allow_stderr_warning is used for the --build deprecation,
+        #       remove it when removing support for --build
+        allow_stderr_warning=True,
+    )
+    assert exists(build)
+
+
+@pytest.mark.network
+def test_pep517_no_legacy_cleanup(script: PipTestEnvironment, data: TestData) -> None:
+    """Test a PEP 517 failed build does not attempt a legacy cleanup"""
+    to_install = data.packages.joinpath("pep517_wrapper_buildsys")
+    script.environ"PIP_TEST_FAIL_BUILD_WHEEL" = "1"
+    res = script.pip("install", "-f", data.find_links, to_install, expect_error=True)
+    # Must not have built the package
+    expected = "Failed building wheel for pep517-wrapper-buildsys"
+    assert expected in str(res)
+    # Must not have attempted legacy cleanup
+    assert "setup.py clean" not in str(res)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_compat.py Added

@@ -0,0 +1,74 @@
+"""
+Tests for compatibility workarounds.
+
+"""
+import os
+from pathlib import Path
+
+import pytest
+
+from tests.lib import pyversion  # noqa: F401
+from tests.lib import PipTestEnvironment, TestData, assert_all_changes
+
+
+@pytest.mark.network
+def test_debian_egg_name_workaround(
+    script: PipTestEnvironment,
+    shared_data: TestData,
+    tmp_path: Path,
+) -> None:
+    """
+    We can uninstall packages installed with the pyversion removed from the
+    egg-info metadata directory name.
+
+    Refs:
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=618367
+    https://bugs.launchpad.net/ubuntu/+source/distribute/+bug/725178
+    https://bitbucket.org/ianb/pip/issue/104/pip-uninstall-on-ubuntu-linux
+
+    """
+    result = script.run(
+        "python",
+        "setup.py",
+        "install",
+        "--single-version-externally-managed",
+        f"--record={tmp_path / 'record'}",
+        cwd=shared_data.src / "simplewheel-2.0",
+    )
+
+    egg_info = os.path.join(
+        script.site_packages, f"simplewheel-2.0-py{pyversion}.egg-info"
+    )
+
+    # Debian only removes pyversion for global installs, not inside a venv
+    # so even if this test runs on a Debian/Ubuntu system with broken
+    # setuptools, since our test runs inside a venv we'll still have the normal
+    # .egg-info
+    result.did_create(egg_info, message=f"Couldn't find {egg_info}")
+
+    # The Debian no-pyversion version of the .egg-info
+    mangled = os.path.join(script.site_packages, "simplewheel-2.0.egg-info")
+    result.did_not_create(mangled, message=f"Found unexpected {mangled}")
+
+    # Simulate a Debian install by copying the .egg-info to their name for it
+    full_egg_info = os.path.join(script.base_path, egg_info)
+    assert os.path.isdir(full_egg_info)
+    full_mangled = os.path.join(script.base_path, mangled)
+    os.renames(full_egg_info, full_mangled)
+    assert os.path.isdir(full_mangled)
+
+    # Try the uninstall and verify that everything is removed.
+    result2 = script.pip("uninstall", "simplewheel", "-y")
+    assert_all_changes(result, result2, script.venv / "build", "cache")
+
+
+def test_setup_py_with_dos_line_endings(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    It doesn't choke on a setup.py file that uses DOS line endings (\\r\\n).
+
+    Refs https://github.com/pypa/pip/issues/237
+    """
+    to_install = data.packages.joinpath("LineEndings")
+    script.pip("install", to_install)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_config.py Added

@@ -0,0 +1,535 @@
+import os
+import ssl
+import sys
+import tempfile
+import textwrap
+from pathlib import Path
+from typing import Callable, List
+
+import pytest
+
+from tests.conftest import CertFactory, MockServer, ScriptFactory
+from tests.lib import PipTestEnvironment, TestData
+from tests.lib.server import (
+    authorization_response,
+    file_response,
+    make_mock_server,
+    package_page,
+    server_running,
+)
+from tests.lib.venv import VirtualEnvironment
+
+TEST_PYPI_INITOOLS = "https://test.pypi.org/simple/initools/"
+
+
+def test_options_from_env_vars(script: PipTestEnvironment) -> None:
+    """
+    Test if ConfigOptionParser reads env vars (e.g. not using PyPI here)
+
+    """
+    script.environ"PIP_NO_INDEX" = "1"
+    result = script.pip("install", "-vvv", "INITools", expect_error=True)
+    assert "Ignoring indexes:" in result.stdout, str(result)
+    msg = "DistributionNotFound: No matching distribution found for INITools"
+    # Case insensitive as the new resolver canonicalizes the project name
+    assert msg.lower() in result.stdout.lower(), str(result)
+
+
+def test_command_line_options_override_env_vars(
+    script: PipTestEnvironment, virtualenv: VirtualEnvironment
+) -> None:
+    """
+    Test that command line options override environmental variables.
+
+    """
+    script.environ"PIP_INDEX_URL" = "https://example.com/simple/"
+    result = script.pip("install", "-vvv", "INITools", expect_error=True)
+    assert "Getting page https://example.com/simple/initools" in result.stdout
+    virtualenv.clear()
+    result = script.pip(
+        "install",
+        "-vvv",
+        "--index-url",
+        "https://download.zope.org/ppix",
+        "INITools",
+        expect_error=True,
+    )
+    assert "example.com" not in result.stdout
+    assert "Getting page https://download.zope.org/ppix" in result.stdout
+
+
+@pytest.mark.network
+def test_env_vars_override_config_file(
+    script: PipTestEnvironment, virtualenv: VirtualEnvironment
+) -> None:
+    """
+    Test that environmental variables override settings in config files.
+    """
+    config_file = script.scratch_path / "test-pip.cfg"
+    # set this to make pip load it
+    script.environ"PIP_CONFIG_FILE" = str(config_file)
+    # It's important that we test this particular config value ('no-index')
+    # because there is/was a bug which only shows up in cases in which
+    # 'config-item' and 'config_item' hash to the same value modulo the size
+    # of the config dictionary.
+    config_file.write_text(
+        textwrap.dedent(
+            """\
+        global
+        no-index = 1
+        """
+        )
+    )
+    result = script.pip("install", "-vvv", "INITools", expect_error=True)
+    msg = "DistributionNotFound: No matching distribution found for INITools"
+    # Case insensitive as the new resolver canonicalizes the project name
+    assert msg.lower() in result.stdout.lower(), str(result)
+    script.environ"PIP_NO_INDEX" = "0"
+    virtualenv.clear()
+    result = script.pip("install", "-vvv", "INITools")
+    assert "Successfully installed INITools" in result.stdout
+
+
+@pytest.mark.network
+def test_command_line_append_flags(
+    script: PipTestEnvironment, virtualenv: VirtualEnvironment, data: TestData
+) -> None:
+    """
+    Test command line flags that append to defaults set by environmental
+    variables.
+
+    """
+    script.environ"PIP_FIND_LINKS" = TEST_PYPI_INITOOLS
+    result = script.pip(
+        "install",
+        "-vvv",
+        "INITools",
+        "--trusted-host",
+        "test.pypi.org",
+    )
+    assert (
+        "Fetching project page and analyzing links: https://test.pypi.org"
+        in result.stdout
+    ), str(result)
+    virtualenv.clear()
+    result = script.pip(
+        "install",
+        "-vvv",
+        "--find-links",
+        data.find_links,
+        "INITools",
+        "--trusted-host",
+        "test.pypi.org",
+    )
+    assert (
+        "Fetching project page and analyzing links: https://test.pypi.org"
+        in result.stdout
+    )
+    assert (
+        f"Skipping link: not a file: {data.find_links}" in result.stdout
+    ), f"stdout: {result.stdout}"
+
+
+@pytest.mark.network
+def test_command_line_appends_correctly(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test multiple appending options set by environmental variables.
+
+    """
+    script.environ"PIP_FIND_LINKS" = f"{TEST_PYPI_INITOOLS} {data.find_links}"
+    result = script.pip(
+        "install",
+        "-vvv",
+        "INITools",
+        "--trusted-host",
+        "test.pypi.org",
+    )
+
+    assert (
+        "Fetching project page and analyzing links: https://test.pypi.org"
+        in result.stdout
+    ), result.stdout
+    assert (
+        f"Skipping link: not a file: {data.find_links}" in result.stdout
+    ), f"stdout: {result.stdout}"
+
+
+def test_config_file_override_stack(
+    script: PipTestEnvironment,
+    virtualenv: VirtualEnvironment,
+    mock_server: MockServer,
+    shared_data: TestData,
+) -> None:
+    """
+    Test config files (global, overriding a global config with a
+    local, overriding all with a command line flag).
+    """
+    mock_server.set_responses(
+        
+            package_page({}),
+            package_page({}),
+            package_page({"INITools-0.2.tar.gz": "/files/INITools-0.2.tar.gz"}),
+            file_response(shared_data.packages.joinpath("INITools-0.2.tar.gz")),
+        
+    )
+    mock_server.start()
+    base_address = f"http://{mock_server.host}:{mock_server.port}"
+
+    config_file = script.scratch_path / "test-pip.cfg"
+
+    # set this to make pip load it
+    script.environ"PIP_CONFIG_FILE" = str(config_file)
+
+    config_file.write_text(
+        textwrap.dedent(
+            """\
+        global
+        index-url = {}/simple1
+        """.format(
+                base_address
+            )
+        )
+    )
+    script.pip("install", "-vvv", "INITools", expect_error=True)
+    virtualenv.clear()
+
+    config_file.write_text(
+        textwrap.dedent(
+            """\
+        global
+        index-url = {address}/simple1
+        install
+        index-url = {address}/simple2
+        """.format(
+                address=base_address
+            )
+        )
+    )
+    script.pip("install", "-vvv", "INITools", expect_error=True)
+    script.pip(
+        "install",
+        "-vvv",
+        "--index-url",
+        f"{base_address}/simple3",
+        "INITools",
+    )
+
+    mock_server.stop()
+    requests = mock_server.get_requests()
+    assert len(requests) == 4
+    assert requests0"PATH_INFO" == "/simple1/initools/"
+    assert requests1"PATH_INFO" == "/simple2/initools/"
+    assert requests2"PATH_INFO" == "/simple3/initools/"
+    assert requests3"PATH_INFO" == "/files/INITools-0.2.tar.gz"
+
+
+def test_options_from_venv_config(
+    script: PipTestEnvironment, virtualenv: VirtualEnvironment
+) -> None:
+    """
+    Test if ConfigOptionParser reads a virtualenv-local config file
+
+    """
+    from pip._internal.configuration import CONFIG_BASENAME
+
+    conf = "global\nno-index = true"
+    ini = virtualenv.location / CONFIG_BASENAME
+    with open(ini, "w") as f:
+        f.write(conf)
+    result = script.pip("install", "-vvv", "INITools", expect_error=True)
+    assert "Ignoring indexes:" in result.stdout, str(result)
+    msg = "DistributionNotFound: No matching distribution found for INITools"
+    # Case insensitive as the new resolver canonicalizes the project name
+    assert msg.lower() in result.stdout.lower(), str(result)
+
+
+def test_install_no_binary_via_config_disables_cached_wheels(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    config_file = tempfile.NamedTemporaryFile(mode="wt", delete=False)
+    try:
+        script.environ"PIP_CONFIG_FILE" = config_file.name
+        config_file.write(
+            textwrap.dedent(
+                """\
+            global
+            no-binary = :all:
+            """
+            )
+        )
+        config_file.close()
+        res = script.pip(
+            "install", "--no-index", "-f", data.find_links, "upper", expect_stderr=True
+        )
+    finally:
+        os.unlink(config_file.name)
+    assert "Successfully installed upper-2.0" in str(res), str(res)
+    # upper is built and not obtained from cache
+    assert "Building wheel for upper" in str(res), str(res)
+
+
+@pytest.mark.skipif(
+    sys.platform == "linux" and sys.version_info < (3, 8),
+    reason="Custom SSL certification not running well in CI",
+)
+def test_prompt_for_authentication(
+    script: PipTestEnvironment, data: TestData, cert_factory: CertFactory
+) -> None:
+    """Test behaviour while installing from a index url
+    requiring authentication
+    """
+    cert_path = cert_factory()
+    ctx = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
+    ctx.load_cert_chain(cert_path, cert_path)
+    ctx.load_verify_locations(cafile=cert_path)
+    ctx.verify_mode = ssl.CERT_REQUIRED
+
+    server = make_mock_server(ssl_context=ctx)
+    server.mock.side_effect = 
+        package_page(
+            {
+                "simple-3.0.tar.gz": "/files/simple-3.0.tar.gz",
+            }
+        ),
+        authorization_response(data.packages / "simple-3.0.tar.gz"),
+    
+
+    url = f"https://{server.host}:{server.port}/simple"
+
+    with server_running(server):
+        result = script.pip(
+            "install",
+            "--index-url",
+            url,
+            "--cert",
+            cert_path,
+            "--client-cert",
+            cert_path,
+            "simple",
+            expect_error=True,
+        )
+
+    assert f"User for {server.host}:{server.port}" in result.stdout, str(result)
+
+
+@pytest.mark.skipif(
+    sys.platform == "linux" and sys.version_info < (3, 8),
+    reason="Custom SSL certification not running well in CI",
+)
+def test_do_not_prompt_for_authentication(
+    script: PipTestEnvironment, data: TestData, cert_factory: CertFactory
+) -> None:
+    """Test behaviour if --no-input option is given while installing
+    from a index url requiring authentication
+    """
+    cert_path = cert_factory()
+    ctx = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
+    ctx.load_cert_chain(cert_path, cert_path)
+    ctx.load_verify_locations(cafile=cert_path)
+    ctx.verify_mode = ssl.CERT_REQUIRED
+
+    server = make_mock_server(ssl_context=ctx)
+
+    server.mock.side_effect = 
+        package_page(
+            {
+                "simple-3.0.tar.gz": "/files/simple-3.0.tar.gz",
+            }
+        ),
+        authorization_response(data.packages / "simple-3.0.tar.gz"),
+    
+
+    url = f"https://{server.host}:{server.port}/simple"
+
+    with server_running(server):
+        result = script.pip(
+            "install",
+            "--index-url",
+            url,
+            "--cert",
+            cert_path,
+            "--client-cert",
+            cert_path,
+            "--no-input",
+            "simple",
+            expect_error=True,
+        )
+
+    assert "ERROR: HTTP error 401" in result.stderr
+
+
+@pytest.fixture(params=(True, False), ids=("interactive", "noninteractive"))
+def interactive(request: pytest.FixtureRequest) -> bool:
+    return request.param
+
+
+@pytest.fixture(params=(True, False), ids=("auth_needed", "auth_not_needed"))
+def auth_needed(request: pytest.FixtureRequest) -> bool:
+    return request.param
+
+
+@pytest.fixture(params=(None, "disabled", "import", "subprocess", "auto"))
+def keyring_provider(request: pytest.FixtureRequest) -> str:
+    return request.param
+
+
+@pytest.fixture(params=("disabled", "import", "subprocess"))
+def keyring_provider_implementation(request: pytest.FixtureRequest) -> str:
+    return request.param
+
+
+@pytest.fixture()
+def flags(
+    request: pytest.FixtureRequest,
+    interactive: bool,
+    auth_needed: bool,
+    keyring_provider: str,
+    keyring_provider_implementation: str,
+) -> Liststr:
+    if (
+        keyring_provider not in None, "auto"
+        and keyring_provider_implementation != keyring_provider
+    ):
+        pytest.skip()
+
+    flags = 
+    if keyring_provider is not None:
+        flags.append("--keyring-provider")
+        flags.append(keyring_provider)
+    if not interactive:
+        flags.append("--no-input")
+    if auth_needed:
+        if keyring_provider_implementation == "disabled" or (
+            not interactive and keyring_provider in None, "auto"
+        ):
+            request.applymarker(pytest.mark.xfail())
+    return flags
+
+
+@pytest.mark.skipif(
+    sys.platform == "linux" and sys.version_info < (3, 8),
+    reason="Custom SSL certification not running well in CI",
+)
+def test_prompt_for_keyring_if_needed(
+    data: TestData,
+    cert_factory: CertFactory,
+    auth_needed: bool,
+    flags: Liststr,
+    keyring_provider: str,
+    keyring_provider_implementation: str,
+    tmpdir: Path,
+    script_factory: ScriptFactory,
+    virtualenv_factory: CallablePath, VirtualEnvironment,
+) -> None:
+    """Test behaviour while installing from an index url
+    requiring authentication and keyring is possible.
+    """
+    environ = os.environ.copy()
+    workspace = tmpdir.joinpath("workspace")
+
+    if keyring_provider_implementation == "subprocess":
+        keyring_virtualenv = virtualenv_factory(workspace.joinpath("keyring"))
+        keyring_script = script_factory(
+            workspace.joinpath("keyring"), keyring_virtualenv
+        )
+        keyring_script.pip(
+            "install",
+            "keyring",
+        )
+
+        environ"PATH" = str(keyring_script.bin_path) + os.pathsep + environ"PATH"
+
+    virtualenv = virtualenv_factory(workspace.joinpath("venv"))
+    script = script_factory(workspace.joinpath("venv"), virtualenv, environ=environ)
+
+    if (
+        keyring_provider not in None, "auto"
+        or keyring_provider_implementation != "subprocess"
+    ):
+        script.pip(
+            "install",
+            "keyring",
+        )
+
+    if keyring_provider_implementation != "subprocess":
+        keyring_script = script
+
+    cert_path = cert_factory()
+    ctx = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
+    ctx.load_cert_chain(cert_path, cert_path)
+    ctx.load_verify_locations(cafile=cert_path)
+    ctx.verify_mode = ssl.CERT_REQUIRED
+
+    response = authorization_response if auth_needed else file_response
+
+    server = make_mock_server(ssl_context=ctx)
+    server.mock.side_effect = 
+        package_page(
+            {
+                "simple-3.0.tar.gz": "/files/simple-3.0.tar.gz",
+            }
+        ),
+        response(data.packages / "simple-3.0.tar.gz"),
+        response(data.packages / "simple-3.0.tar.gz"),
+    
+
+    url = f"https://USERNAME@{server.host}:{server.port}/simple"
+
+    keyring_content = textwrap.dedent(
+        """\
+        import os
+        import sys
+        import keyring
+        from keyring.backend import KeyringBackend
+        from keyring.credentials import SimpleCredential
+
+        class TestBackend(KeyringBackend):
+            priority = 1
+
+            def get_credential(self, url, username):
+                sys.stderr.write("get_credential was called" + os.linesep)
+                return SimpleCredential(username="USERNAME", password="PASSWORD")
+
+            def get_password(self, url, username):
+                sys.stderr.write("get_password was called" + os.linesep)
+                return "PASSWORD"
+
+            def set_password(self, url, username):
+                pass
+    """
+    )
+    keyring_path = keyring_script.site_packages_path / "keyring_test.py"
+    keyring_path.write_text(keyring_content)
+
+    keyring_content = (
+        "import keyring_test;"
+        " import keyring;"
+        " keyring.set_keyring(keyring_test.TestBackend())" + os.linesep
+    )
+    keyring_path = keyring_path.with_suffix(".pth")
+    keyring_path.write_text(keyring_content)
+
+    with server_running(server):
+        result = script.pip(
+            "install",
+            "--index-url",
+            url,
+            "--cert",
+            cert_path,
+            "--client-cert",
+            cert_path,
+            *flags,
+            "simple",
+        )
+
+    function_name = (
+        "get_credential"
+        if keyring_provider_implementation == "import"
+        else "get_password"
+    )
+    if auth_needed:
+        assert function_name + " was called" in result.stderr
+    else:
+        assert function_name + " was called" not in result.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_direct_url.py Added

@@ -0,0 +1,59 @@
+import pytest
+
+from pip._internal.models.direct_url import VcsInfo
+from tests.lib import PipTestEnvironment, TestData, _create_test_package
+from tests.lib.direct_url import get_created_direct_url
+
+
+def test_install_find_links_no_direct_url(script: PipTestEnvironment) -> None:
+    result = script.pip_install_local("simple")
+    assert not get_created_direct_url(result, "simple")
+
+
+def test_install_vcs_editable_no_direct_url(script: PipTestEnvironment) -> None:
+    pkg_path = _create_test_package(script.scratch_path, name="testpkg")
+    args = "install", "-e", f"git+{pkg_path.as_uri()}#egg=testpkg"
+    result = script.pip(*args)
+    # legacy editable installs do not generate .dist-info,
+    # hence no direct_url.json
+    assert not get_created_direct_url(result, "testpkg")
+
+
+def test_install_vcs_non_editable_direct_url(script: PipTestEnvironment) -> None:
+    pkg_path = _create_test_package(script.scratch_path, name="testpkg")
+    url = pkg_path.as_uri()
+    args = "install", f"git+{url}#egg=testpkg"
+    result = script.pip(*args)
+    direct_url = get_created_direct_url(result, "testpkg")
+    assert direct_url
+    assert direct_url.url == url
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.info.vcs == "git"
+
+
+def test_install_archive_direct_url(script: PipTestEnvironment, data: TestData) -> None:
+    req = "simple @ " + data.packages.joinpath("simple-2.0.tar.gz").as_uri()
+    assert req.startswith("simple @ file://")
+    result = script.pip("install", req)
+    assert get_created_direct_url(result, "simple")
+
+
+@pytest.mark.network
+def test_install_vcs_constraint_direct_url(script: PipTestEnvironment) -> None:
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(
+        "git+https://github.com/pypa/pip-test-package"
+        "@5547fa909e83df8bd743d3978d6667497983a4b7"
+        "#egg=pip-test-package"
+    )
+    result = script.pip("install", "pip-test-package", "-c", constraints_file)
+    assert get_created_direct_url(result, "pip_test_package")
+
+
+def test_install_vcs_constraint_direct_file_url(script: PipTestEnvironment) -> None:
+    pkg_path = _create_test_package(script.scratch_path, name="testpkg")
+    url = pkg_path.as_uri()
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"git+{url}#egg=testpkg")
+    result = script.pip("install", "testpkg", "-c", constraints_file)
+    assert get_created_direct_url(result, "testpkg")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_extras.py Added

@@ -0,0 +1,225 @@
+import re
+import textwrap
+from os.path import join
+
+import pytest
+
+from tests.lib import PipTestEnvironment, ResolverVariant, TestData
+
+
+@pytest.mark.network
+def test_simple_extras_install_from_pypi(script: PipTestEnvironment) -> None:
+    """
+    Test installing a package from PyPI using extras dependency Pasteopenid.
+    """
+    result = script.pip(
+        "install",
+        "Pasteopenid==1.7.5.1",
+        expect_stderr=True,
+    )
+    initools_folder = script.site_packages / "openid"
+    result.did_create(initools_folder)
+
+
+def test_extras_after_wheel(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test installing a package with extras after installing from a wheel.
+    """
+    simple = script.site_packages / "simple"
+
+    no_extra = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "requires_simple_extra",
+        expect_stderr=True,
+    )
+    no_extra.did_not_create(simple)
+
+    extra = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "requires_simple_extraextra",
+        expect_stderr=True,
+    )
+    extra.did_create(simple)
+
+
+@pytest.mark.network
+def test_no_extras_uninstall(script: PipTestEnvironment) -> None:
+    """
+    No extras dependency gets uninstalled when the root package is uninstalled
+    """
+    result = script.pip(
+        "install",
+        "Pasteopenid==1.7.5.1",
+        expect_stderr=True,
+    )
+    result.did_create(join(script.site_packages, "paste"))
+    result.did_create(join(script.site_packages, "openid"))
+    result2 = script.pip("uninstall", "Paste", "-y")
+    # openid should not be uninstalled
+    initools_folder = script.site_packages / "openid"
+    assert initools_folder not in result2.files_deleted, result.files_deleted
+
+
+def test_nonexistent_extra_warns_user_no_wheel(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    A warning is logged telling the user that the extra option they requested
+    does not exist in the project they are wishing to install.
+
+    This exercises source installs.
+    """
+    result = script.pip(
+        "install",
+        "--no-binary=:all:",
+        "--no-index",
+        "--find-links=" + data.find_links,
+        "simplenonexistent",
+        expect_stderr=True,
+    )
+    assert "simple 3.0 does not provide the extra 'nonexistent'" in result.stderr, str(
+        result
+    )
+
+
+def test_nonexistent_extra_warns_user_with_wheel(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    A warning is logged telling the user that the extra option they requested
+    does not exist in the project they are wishing to install.
+
+    This exercises wheel installs.
+    """
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links=" + data.find_links,
+        "simplewheelnonexistent",
+        expect_stderr=True,
+    )
+    assert "simplewheel 2.0 does not provide the extra 'nonexistent'" in result.stderr
+
+
+def test_nonexistent_options_listed_in_order(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Warn the user for each extra that doesn't exist.
+    """
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links=" + data.find_links,
+        "simplewheelnonexistent, nope",
+        expect_stderr=True,
+    )
+    matches = re.findall(
+        "WARNING: simplewheel 2.0 does not provide the extra '(a-z*)'", result.stderr
+    )
+    assert matches == "nonexistent", "nope"
+
+
+def test_install_fails_if_extra_at_end(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Fail if order of specifiers and extras is incorrect.
+
+    Test uses a requirements file to avoid a testing issue where
+    the specifier gets interpreted as shell redirect.
+    """
+    script.scratch_path.joinpath("requirements.txt").write_text(
+        "requires_simple_extra>=0.1extra"
+    )
+
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links=" + data.find_links,
+        "-r",
+        script.scratch_path / "requirements.txt",
+        expect_error=True,
+    )
+    assert "Extras after version" in result.stderr
+
+
+def test_install_special_extra(script: PipTestEnvironment) -> None:
+    # Check that uppercase letters and '-' are dealt with
+    # make a dummy project
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.mkdir()
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              version='0.1',
+              extras_require={'Hop_hOp-hoP': 'missing_pkg'},
+        )
+    """
+        )
+    )
+
+    result = script.pip(
+        "install", "--no-index", f"{pkga_path}Hop_hOp-hoP", expect_error=True
+    )
+    assert (
+        "Could not find a version that satisfies the requirement missing_pkg"
+    ) in result.stderr, str(result)
+
+
+def test_install_requirements_no_r_flag(script: PipTestEnvironment) -> None:
+    """Beginners sometimes forget the -r and this leads to confusion"""
+    result = script.pip("install", "requirements.txt", expect_error=True)
+    assert 'literally named "requirements.txt"' in result.stdout
+
+
+@pytest.mark.parametrize(
+    "extra_to_install, simple_version, fails_on_legacy",
+    
+        ("", "3.0", False),
+        ("extra1", "2.0", True),
+        ("extra2", "1.0", True),
+        ("extra1,extra2", "1.0", True),
+    ,
+)
+@pytest.mark.usefixtures("data")
+def test_install_extra_merging(
+    script: PipTestEnvironment,
+    resolver_variant: ResolverVariant,
+    extra_to_install: str,
+    simple_version: str,
+    fails_on_legacy: bool,
+) -> None:
+    # Check that extra specifications in the extras section are honoured.
+    pkga_path = script.scratch_path / "pkga"
+    pkga_path.mkdir()
+    pkga_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from setuptools import setup
+        setup(name='pkga',
+              version='0.1',
+              install_requires='simple',
+              extras_require={'extra1': 'simple<3',
+                              'extra2': 'simple==1.*'},
+        )
+    """
+        )
+    )
+
+    result = script.pip_install_local(
+        f"{pkga_path}{extra_to_install}",
+        expect_error=(fails_on_legacy and resolver_variant == "legacy"),
+    )
+
+    if not fails_on_legacy or resolver_variant == "2020-resolver":
+        expected = f"Successfully installed pkga-0.1 simple-{simple_version}"
+        assert expected in result.stdout

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_force_reinstall.py Added

@@ -0,0 +1,61 @@
+import os
+
+from tests.lib import PipTestEnvironment, assert_all_changes
+
+
+def check_installed_version(
+    script: PipTestEnvironment, package: str, expected: str
+) -> None:
+    result = script.pip("show", package)
+    lines = result.stdout.splitlines()
+    version = None
+    for line in lines:
+        if line.startswith("Version: "):
+            version = line.split()-1
+            break
+    assert version == expected, f"version {version} != {expected}"
+
+
+def check_force_reinstall(
+    script: PipTestEnvironment, specifier: str, expected: str
+) -> None:
+    """
+    Args:
+      specifier: the requirement specifier to force-reinstall.
+      expected: the expected version after force-reinstalling.
+    """
+    result = script.pip_install_local("simplewheel==1.0")
+    check_installed_version(script, "simplewheel", "1.0")
+
+    # Remove an installed file to test whether --force-reinstall fixes it.
+    to_fix = script.site_packages_path.joinpath("simplewheel", "__init__.py")
+    to_fix.unlink()
+
+    result2 = script.pip_install_local("--force-reinstall", specifier)
+    check_installed_version(script, "simplewheel", expected)
+
+    # site_packages_path is absolute, but files_created mapping uses
+    # relative paths as key.
+    fixed_key = os.path.relpath(to_fix, script.base_path)
+    result2.did_create(fixed_key, message="force-reinstall failed")
+
+    result3 = script.pip("uninstall", "simplewheel", "-y")
+    assert_all_changes(result, result3, script.venv / "build", "cache")
+
+
+def test_force_reinstall_with_no_version_specifier(script: PipTestEnvironment) -> None:
+    """
+    Check --force-reinstall when there is no version specifier and the
+    installed version is not the newest version.
+    """
+    check_force_reinstall(script, "simplewheel", "2.0")
+
+
+def test_force_reinstall_with_same_version_specifier(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Check --force-reinstall when the version specifier equals the installed
+    version and the installed version is not the newest version.
+    """
+    check_force_reinstall(script, "simplewheel==1.0", "1.0")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_index.py Added

@@ -0,0 +1,84 @@
+import shutil
+import textwrap
+
+from tests.lib import PipTestEnvironment, TestData
+
+
+def test_find_links_relative_path(script: PipTestEnvironment, data: TestData) -> None:
+    """Test find-links as a relative path."""
+    result = script.pip(
+        "install",
+        "parent==0.1",
+        "--no-index",
+        "--find-links",
+        "packages/",
+        cwd=data.root,
+    )
+    dist_info_folder = script.site_packages / "parent-0.1.dist-info"
+    initools_folder = script.site_packages / "parent"
+    result.did_create(dist_info_folder)
+    result.did_create(initools_folder)
+
+
+def test_find_links_no_doctype(script: PipTestEnvironment, data: TestData) -> None:
+    shutil.copy(data.packages / "simple-1.0.tar.gz", script.scratch_path)
+    html = script.scratch_path.joinpath("index.html")
+    html.write_text('<a href="simple-1.0.tar.gz"></a>')
+    result = script.pip(
+        "install",
+        "simple==1.0",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        expect_stderr=True,
+    )
+    assert not result.stderr
+
+
+def test_find_links_requirements_file_relative_path(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Test find-links as a relative path to a reqs file."""
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+        --no-index
+        --find-links={}
+        parent==0.1
+        """.format(
+                data.packages.as_posix()
+            )
+        )
+    )
+    result = script.pip(
+        "install",
+        "-r",
+        script.scratch_path / "test-req.txt",
+        cwd=data.root,
+    )
+    dist_info_folder = script.site_packages / "parent-0.1.dist-info"
+    initools_folder = script.site_packages / "parent"
+    result.did_create(dist_info_folder)
+    result.did_create(initools_folder)
+
+
+def test_install_from_file_index_hash_link(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test that a pkg can be installed from a file:// index using a link with a
+    hash
+    """
+    result = script.pip("install", "-i", data.index_url(), "simple==1.0")
+    dist_info_folder = script.site_packages / "simple-1.0.dist-info"
+    result.did_create(dist_info_folder)
+
+
+def test_file_index_url_quoting(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test url quoting of file index url with a space
+    """
+    index_url = data.index_url("in dex")
+    result = script.pip("install", "-vvv", "--index-url", index_url, "simple")
+    result.did_create(script.site_packages / "simple")
+    result.did_create(script.site_packages / "simple-1.0.dist-info")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_report.py Added

@@ -0,0 +1,322 @@
+import json
+import textwrap
+from pathlib import Path
+from typing import Any, Dict
+
+import pytest
+from packaging.utils import canonicalize_name
+
+from ..lib import PipTestEnvironment, TestData
+
+
+def _install_dict(report: Dictstr, Any) -> Dictstr, Any:
+    return {canonicalize_name(i"metadata""name"): i for i in report"install"}
+
+
+def test_install_report_basic(
+    script: PipTestEnvironment, shared_data: TestData, tmp_path: Path
+) -> None:
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "simplewheel",
+        "--dry-run",
+        "--no-index",
+        "--find-links",
+        str(shared_data.root / "packages/"),
+        "--report",
+        str(report_path),
+    )
+    report = json.loads(report_path.read_text())
+    assert "install" in report
+    assert len(report"install") == 1
+    simplewheel_report = _install_dict(report)"simplewheel"
+    assert simplewheel_report"metadata""name" == "simplewheel"
+    assert simplewheel_report"requested" is True
+    assert simplewheel_report"is_direct" is False
+    url = simplewheel_report"download_info""url"
+    assert url.startswith("file://")
+    assert url.endswith("/packages/simplewheel-2.0-1-py2.py3-none-any.whl")
+    assert (
+        simplewheel_report"download_info""archive_info""hash"
+        == "sha256=191d6520d0570b13580bf7642c97ddfbb46dd04da5dd2cf7bef9f32391dfe716"
+    )
+
+
+def test_install_report_dep(
+    script: PipTestEnvironment, shared_data: TestData, tmp_path: Path
+) -> None:
+    """Test dependencies are present in the install report with requested=False."""
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "require_simple",
+        "--dry-run",
+        "--no-index",
+        "--find-links",
+        str(shared_data.root / "packages/"),
+        "--report",
+        str(report_path),
+    )
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 2
+    assert _install_dict(report)"require-simple""requested" is True
+    assert _install_dict(report)"simple""requested" is False
+
+
+@pytest.mark.network
+def test_install_report_index(script: PipTestEnvironment, tmp_path: Path) -> None:
+    """Test report for sdist obtained from index."""
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "--dry-run",
+        "Pasteopenid==1.7.5.1",
+        "--report",
+        str(report_path),
+    )
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 2
+    install_dict = _install_dict(report)
+    assert install_dict"paste""requested" is True
+    assert install_dict"python-openid""requested" is False
+    paste_report = install_dict"paste"
+    assert paste_report"download_info""url".startswith(
+        "https://files.pythonhosted.org/"
+    )
+    assert paste_report"download_info""url".endswith("/Paste-1.7.5.1.tar.gz")
+    assert (
+        paste_report"download_info""archive_info""hash"
+        == "sha256=11645842ba8ec986ae8cfbe4c6cacff5c35f0f4527abf4f5581ae8b4ad49c0b6"
+    )
+    assert paste_report"requested_extras" == "openid"
+    assert "requires_dist" in paste_report"metadata"
+
+
+@pytest.mark.network
+def test_install_report_direct_archive(
+    script: PipTestEnvironment, tmp_path: Path, shared_data: TestData
+) -> None:
+    """Test report for direct URL archive."""
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        str(shared_data.root / "packages" / "simplewheel-1.0-py2.py3-none-any.whl"),
+        "--dry-run",
+        "--no-index",
+        "--report",
+        str(report_path),
+    )
+    report = json.loads(report_path.read_text())
+    assert "install" in report
+    assert len(report"install") == 1
+    simplewheel_report = _install_dict(report)"simplewheel"
+    assert simplewheel_report"metadata""name" == "simplewheel"
+    assert simplewheel_report"requested" is True
+    assert simplewheel_report"is_direct" is True
+    url = simplewheel_report"download_info""url"
+    assert url.startswith("file://")
+    assert url.endswith("/packages/simplewheel-1.0-py2.py3-none-any.whl")
+    assert (
+        simplewheel_report"download_info""archive_info""hash"
+        == "sha256=e63aa139caee941ec7f33f057a5b987708c2128238357cf905429846a2008718"
+    )
+    assert simplewheel_report"download_info""archive_info""hashes" == {
+        "sha256": "e63aa139caee941ec7f33f057a5b987708c2128238357cf905429846a2008718"
+    }
+
+
+@pytest.mark.network
+def test_install_report_vcs_and_wheel_cache(
+    script: PipTestEnvironment, tmp_path: Path
+) -> None:
+    """Test report for VCS reference, and interactions with the wheel cache."""
+    cache_dir = tmp_path / "cache"
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "git+https://github.com/pypa/pip-test-package"
+        "@5547fa909e83df8bd743d3978d6667497983a4b7",
+        "--cache-dir",
+        str(cache_dir),
+        "--report",
+        str(report_path),
+    )
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 1
+    pip_test_package_report = report"install"0
+    assert pip_test_package_report"is_direct" is True
+    assert pip_test_package_report"requested" is True
+    assert (
+        pip_test_package_report"download_info""url"
+        == "https://github.com/pypa/pip-test-package"
+    )
+    assert pip_test_package_report"download_info""vcs_info""vcs" == "git"
+    assert (
+        pip_test_package_report"download_info""vcs_info""commit_id"
+        == "5547fa909e83df8bd743d3978d6667497983a4b7"
+    )
+    # Now do it again to make sure the cache is used and that the report still contains
+    # the original VCS url.
+    report_path.unlink()
+    result = script.pip(
+        "install",
+        "pip-test-package @ git+https://github.com/pypa/pip-test-package"
+        "@5547fa909e83df8bd743d3978d6667497983a4b7",
+        "--ignore-installed",
+        "--cache-dir",
+        str(cache_dir),
+        "--report",
+        str(report_path),
+    )
+    assert "Using cached pip_test_package" in result.stdout
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 1
+    pip_test_package_report = report"install"0
+    assert pip_test_package_report"is_direct" is True
+    assert pip_test_package_report"requested" is True
+    assert (
+        pip_test_package_report"download_info""url"
+        == "https://github.com/pypa/pip-test-package"
+    )
+    assert pip_test_package_report"download_info""vcs_info""vcs" == "git"
+    assert (
+        pip_test_package_report"download_info""vcs_info""commit_id"
+        == "5547fa909e83df8bd743d3978d6667497983a4b7"
+    )
+
+
+@pytest.mark.network
+def test_install_report_vcs_editable(
+    script: PipTestEnvironment, tmp_path: Path
+) -> None:
+    """Test report remote editable."""
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "--editable",
+        "git+https://github.com/pypa/pip-test-package"
+        "@5547fa909e83df8bd743d3978d6667497983a4b7"
+        "#egg=pip-test-package",
+        "--report",
+        str(report_path),
+    )
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 1
+    pip_test_package_report = report"install"0
+    assert pip_test_package_report"is_direct" is True
+    assert pip_test_package_report"download_info""url".startswith("file://")
+    assert pip_test_package_report"download_info""url".endswith(
+        "/src/pip-test-package"
+    )
+    assert pip_test_package_report"download_info""dir_info""editable" is True
+
+
+@pytest.mark.network
+def test_install_report_local_path_with_extras(
+    script: PipTestEnvironment, tmp_path: Path, shared_data: TestData
+) -> None:
+    """Test report remote editable."""
+    project_path = tmp_path / "pkga"
+    project_path.mkdir()
+    project_path.joinpath("pyproject.toml").write_text(
+        textwrap.dedent(
+            """\
+            project
+            name = "pkga"
+            version = "1.0"
+
+            project.optional-dependencies
+            test = "simple"
+            """
+        )
+    )
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "--dry-run",
+        "--no-build-isolation",
+        "--no-index",
+        "--find-links",
+        str(shared_data.root / "packages/"),
+        "--report",
+        str(report_path),
+        str(project_path) + "test",
+    )
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 2
+    pkga_report = report"install"0
+    assert pkga_report"metadata""name" == "pkga"
+    assert pkga_report"is_direct" is True
+    assert pkga_report"requested" is True
+    assert pkga_report"requested_extras" == "test"
+    simple_report = report"install"1
+    assert simple_report"metadata""name" == "simple"
+    assert simple_report"is_direct" is False
+    assert simple_report"requested" is False
+    assert "requested_extras" not in simple_report
+
+
+@pytest.mark.network
+def test_install_report_editable_local_path_with_extras(
+    script: PipTestEnvironment, tmp_path: Path, shared_data: TestData
+) -> None:
+    """Test report remote editable."""
+    project_path = tmp_path / "pkga"
+    project_path.mkdir()
+    project_path.joinpath("pyproject.toml").write_text(
+        textwrap.dedent(
+            """\
+            project
+            name = "pkga"
+            version = "1.0"
+
+            project.optional-dependencies
+            test = "simple"
+            """
+        )
+    )
+    report_path = tmp_path / "report.json"
+    script.pip(
+        "install",
+        "--dry-run",
+        "--no-build-isolation",
+        "--no-index",
+        "--find-links",
+        str(shared_data.root / "packages/"),
+        "--report",
+        str(report_path),
+        "--editable",
+        str(project_path) + "test",
+    )
+    report = json.loads(report_path.read_text())
+    assert len(report"install") == 2
+    pkga_report = report"install"0
+    assert pkga_report"metadata""name" == "pkga"
+    assert pkga_report"is_direct" is True
+    assert pkga_report"requested" is True
+    assert pkga_report"requested_extras" == "test"
+    simple_report = report"install"1
+    assert simple_report"metadata""name" == "simple"
+    assert simple_report"is_direct" is False
+    assert simple_report"requested" is False
+    assert "requested_extras" not in simple_report
+
+
+def test_install_report_to_stdout(
+    script: PipTestEnvironment, shared_data: TestData
+) -> None:
+    result = script.pip(
+        "install",
+        "simplewheel",
+        "--quiet",
+        "--dry-run",
+        "--no-index",
+        "--find-links",
+        str(shared_data.root / "packages/"),
+        "--report",
+        "-",
+    )
+    report = json.loads(result.stdout)
+    assert "install" in report
+    assert len(report"install") == 1

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_reqs.py Added

@@ -0,0 +1,819 @@
+import json
+import os
+import textwrap
+from pathlib import Path
+from typing import TYPE_CHECKING, Any
+
+import pytest
+
+from tests.lib import (
+    PipTestEnvironment,
+    ResolverVariant,
+    TestData,
+    _create_test_package_with_subdirectory,
+    create_basic_sdist_for_package,
+    create_basic_wheel_for_package,
+    need_svn,
+    requirements_file,
+)
+from tests.lib.local_repos import local_checkout
+
+if TYPE_CHECKING:
+    from typing import Protocol
+else:
+    Protocol = object
+
+
+class ArgRecordingSdist:
+    def __init__(self, sdist_path: Path, args_path: Path) -> None:
+        self.sdist_path = sdist_path
+        self._args_path = args_path
+
+    def args(self) -> Any:
+        return json.loads(self._args_path.read_text())
+
+
+class ArgRecordingSdistMaker(Protocol):
+    def __call__(self, name: str, **kwargs: Any) -> ArgRecordingSdist:
+        ...
+
+
+@pytest.fixture()
+def arg_recording_sdist_maker(
+    script: PipTestEnvironment,
+) -> ArgRecordingSdistMaker:
+    arg_writing_setup_py_prelude = textwrap.dedent(
+        """
+        import io
+        import json
+        import os
+        import sys
+
+        args_path = os.path.join(os.environ"OUTPUT_DIR", "{name}.json")
+        with open(args_path, 'w') as f:
+            json.dump(sys.argv, f)
+        """
+    )
+    output_dir = script.scratch_path.joinpath("args_recording_sdist_maker_output")
+    output_dir.mkdir(parents=True)
+    script.environ"OUTPUT_DIR" = str(output_dir)
+
+    def _arg_recording_sdist_maker(
+        name: str,
+        **kwargs: Any,
+    ) -> ArgRecordingSdist:
+        sdist_path = create_basic_sdist_for_package(
+            script,
+            name,
+            "0.1.0",
+            setup_py_prelude=arg_writing_setup_py_prelude.format(name=name),
+            **kwargs,
+        )
+        args_path = output_dir / f"{name}.json"
+        return ArgRecordingSdist(sdist_path, args_path)
+
+    return _arg_recording_sdist_maker
+
+
+@pytest.mark.network
+def test_requirements_file(script: PipTestEnvironment) -> None:
+    """
+    Test installing from a requirements file.
+
+    """
+    other_lib_name, other_lib_version = "peppercorn", "0.6"
+    script.scratch_path.joinpath("initools-req.txt").write_text(
+        textwrap.dedent(
+            f"""\
+        INITools==0.2
+        # and something else to test out:
+        {other_lib_name}<={other_lib_version}
+        """
+        )
+    )
+    result = script.pip("install", "-r", script.scratch_path / "initools-req.txt")
+    result.did_create(script.site_packages / "INITools-0.2.dist-info")
+    result.did_create(script.site_packages / "initools")
+    assert result.files_createdscript.site_packages / other_lib_name.dir
+    fn = "{}-{}.dist-info".format(other_lib_name, other_lib_version)
+    assert result.files_createdscript.site_packages / fn.dir
+
+
+def test_schema_check_in_requirements_file(script: PipTestEnvironment) -> None:
+    """
+    Test installing from a requirements file with an invalid vcs schema..
+
+    """
+    script.scratch_path.joinpath("file-egg-req.txt").write_text(
+        "\n{}\n".format(
+            "git://github.com/alex/django-fixture-generator.git"
+            "#egg=fixture_generator"
+        )
+    )
+
+    with pytest.raises(AssertionError):
+        script.pip("install", "-vvv", "-r", script.scratch_path / "file-egg-req.txt")
+
+
+@pytest.mark.parametrize(
+    "test_type,editable",
+    
+        ("rel_path", False),
+        ("rel_path", True),
+        ("rel_url", False),
+        ("rel_url", True),
+        ("embedded_rel_path", False),
+        ("embedded_rel_path", True),
+    ,
+)
+def test_relative_requirements_file(
+    script: PipTestEnvironment, data: TestData, test_type: str, editable: bool
+) -> None:
+    """
+    Test installing from a requirements file with a relative path. For path
+    URLs, use an egg= definition.
+
+    """
+    dist_info_folder = script.site_packages / "FSPkg-0.1.dev0.dist-info"
+    egg_link_file = script.site_packages / "FSPkg.egg-link"
+    package_folder = script.site_packages / "fspkg"
+
+    # Compute relative install path to FSPkg from scratch path.
+    full_rel_path = os.path.relpath(
+        data.packages.joinpath("FSPkg"), script.scratch_path
+    )
+    full_rel_url = "file:" + full_rel_path + "#egg=FSPkg"
+    embedded_rel_path = script.scratch_path.joinpath(full_rel_path)
+
+    req_path = {
+        "rel_path": full_rel_path,
+        "rel_url": full_rel_url,
+        "embedded_rel_path": os.fspath(embedded_rel_path),
+    }test_type
+
+    req_path = req_path.replace(os.path.sep, "/")
+    # Install as either editable or not.
+    if not editable:
+        with requirements_file(req_path + "\n", script.scratch_path) as reqs_file:
+            result = script.pip(
+                "install", "-vvv", "-r", reqs_file.name, cwd=script.scratch_path
+            )
+            result.did_create(dist_info_folder)
+            result.did_create(package_folder)
+    else:
+        with requirements_file(
+            "-e " + req_path + "\n", script.scratch_path
+        ) as reqs_file:
+            result = script.pip(
+                "install", "-vvv", "-r", reqs_file.name, cwd=script.scratch_path
+            )
+            result.did_create(egg_link_file)
+
+
+@pytest.mark.xfail
+@pytest.mark.network
+@need_svn
+def test_multiple_requirements_files(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """
+    Test installing from multiple nested requirements files.
+
+    """
+    other_lib_name, other_lib_version = "six", "1.16.0"
+    script.scratch_path.joinpath("initools-req.txt").write_text(
+        textwrap.dedent(
+            """
+            -e {}@10#egg=INITools
+            -r {}-req.txt
+        """
+        ).format(
+            local_checkout("svn+http://svn.colorstudy.com/INITools", tmpdir),
+            other_lib_name,
+        ),
+    )
+    script.scratch_path.joinpath(f"{other_lib_name}-req.txt").write_text(
+        f"{other_lib_name}<={other_lib_version}"
+    )
+    result = script.pip("install", "-r", script.scratch_path / "initools-req.txt")
+    assert result.files_createdscript.site_packages / other_lib_name.dir
+    fn = f"{other_lib_name}-{other_lib_version}.dist-info"
+    assert result.files_createdscript.site_packages / fn.dir
+    result.did_create(script.venv / "src" / "initools")
+
+
+def test_package_in_constraints_and_dependencies(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        "TopoRequires2==0.0.1\nTopoRequires==0.0.1"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "TopoRequires2",
+    )
+    assert "installed TopoRequires-0.0.1" in result.stdout
+
+
+def test_multiple_constraints_files(script: PipTestEnvironment, data: TestData) -> None:
+    script.scratch_path.joinpath("outer.txt").write_text("-c inner.txt")
+    script.scratch_path.joinpath("inner.txt").write_text("Upper==1.0")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "outer.txt",
+        "Upper",
+    )
+    assert "installed Upper-1.0" in result.stdout
+
+
+# FIXME: Unclear what this guarantee is for.
+def test_respect_order_in_requirements_file(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("frameworks-req.txt").write_text(
+        textwrap.dedent(
+            """\
+        parent
+        child
+        simple
+        """
+        )
+    )
+
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-r",
+        script.scratch_path / "frameworks-req.txt",
+    )
+
+    downloaded = line for line in result.stdout.split("\n") if "Processing" in line
+
+    assert (
+        "parent" in downloaded0
+    ), 'First download should be "parent" but was "{}"'.format(downloaded0)
+    assert (
+        "child" in downloaded1
+    ), 'Second download should be "child" but was "{}"'.format(downloaded1)
+    assert (
+        "simple" in downloaded2
+    ), 'Third download should be "simple" but was "{}"'.format(downloaded2)
+
+
+def test_install_local_editable_with_extras(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    res = script.pip_install_local(
+        "-e", f"{to_install}bar", allow_stderr_warning=True
+    )
+    res.did_update(script.site_packages / "easy-install.pth")
+    res.did_create(script.site_packages / "LocalExtras.egg-link")
+    res.did_create(script.site_packages / "simple")
+
+
+def test_install_collected_dependencies_first(script: PipTestEnvironment) -> None:
+    result = script.pip_install_local(
+        "toporequires2",
+    )
+    text = line for line in result.stdout.split("\n") if "Installing" in line0
+    assert text.endswith("toporequires2")
+
+
+@pytest.mark.network
+def test_install_local_editable_with_subdirectory(script: PipTestEnvironment) -> None:
+    version_pkg_path = _create_test_package_with_subdirectory(script, "version_subdir")
+    result = script.pip(
+        "install",
+        "-e",
+        "{uri}#egg=version_subpkg&subdirectory=version_subdir".format(
+            uri=f"git+{version_pkg_path.as_uri()}",
+        ),
+    )
+
+    result.assert_installed("version-subpkg", sub_dir="version_subdir")
+
+
+@pytest.mark.network
+def test_install_local_with_subdirectory(script: PipTestEnvironment) -> None:
+    version_pkg_path = _create_test_package_with_subdirectory(script, "version_subdir")
+    result = script.pip(
+        "install",
+        "{uri}#egg=version_subpkg&subdirectory=version_subdir".format(
+            uri=f"git+{version_pkg_path.as_uri()}",
+        ),
+    )
+
+    result.assert_installed("version_subpkg.py", editable=False)
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_wheel_user_with_prefix_in_pydistutils_cfg(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    if os.name == "posix":
+        user_filename = ".pydistutils.cfg"
+    else:
+        user_filename = "pydistutils.cfg"
+    user_cfg = os.path.join(os.path.expanduser("~"), user_filename)
+    script.scratch_path.joinpath("bin").mkdir()
+    with open(user_cfg, "w") as cfg:
+        cfg.write(
+            textwrap.dedent(
+                f"""
+            install
+            prefix={script.scratch_path}"""
+            )
+        )
+
+    result = script.pip(
+        "install", "--user", "--no-index", "-f", data.find_links, "requiresupper"
+    )
+    # Check that we are really installing a wheel
+    assert "installed requiresupper" in result.stdout
+
+
+def test_constraints_not_installed_by_default(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("c.txt").write_text("requiresupper")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "c.txt",
+        "Upper",
+    )
+    assert "requiresupper" not in result.stdout
+
+
+def test_constraints_only_causes_error(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("c.txt").write_text("requiresupper")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "c.txt",
+        expect_error=True,
+    )
+    assert "installed requiresupper" not in result.stdout
+
+
+def test_constraints_local_editable_install_causes_error(
+    script: PipTestEnvironment,
+    data: TestData,
+    resolver_variant: ResolverVariant,
+) -> None:
+    script.scratch_path.joinpath("constraints.txt").write_text("singlemodule==0.0.0")
+    to_install = data.src.joinpath("singlemodule")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "-e",
+        to_install,
+        expect_error=True,
+    )
+    if resolver_variant == "legacy-resolver":
+        assert "Could not satisfy constraints" in result.stderr, str(result)
+    else:
+        # Because singlemodule only has 0.0.1 available.
+        assert "Cannot install singlemodule 0.0.1" in result.stderr, str(result)
+
+
+@pytest.mark.network
+def test_constraints_local_editable_install_pep518(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.src.joinpath("pep518-3.0")
+
+    script.pip("download", "setuptools", "wheel", "-d", data.packages)
+    script.pip("install", "--no-index", "-f", data.find_links, "-e", to_install)
+
+
+def test_constraints_local_install_causes_error(
+    script: PipTestEnvironment,
+    data: TestData,
+    resolver_variant: ResolverVariant,
+) -> None:
+    script.scratch_path.joinpath("constraints.txt").write_text("singlemodule==0.0.0")
+    to_install = data.src.joinpath("singlemodule")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        to_install,
+        expect_error=True,
+    )
+    if resolver_variant == "legacy-resolver":
+        assert "Could not satisfy constraints" in result.stderr, str(result)
+    else:
+        # Because singlemodule only has 0.0.1 available.
+        assert "Cannot install singlemodule 0.0.1" in result.stderr, str(result)
+
+
+def test_constraints_constrain_to_local_editable(
+    script: PipTestEnvironment,
+    data: TestData,
+    resolver_variant: ResolverVariant,
+) -> None:
+    to_install = data.src.joinpath("singlemodule")
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        f"-e {to_install.as_uri()}#egg=singlemodule"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "singlemodule",
+        allow_stderr_warning=True,
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        assert "Editable requirements are not allowed as constraints" in result.stderr
+    else:
+        assert "Running setup.py develop for singlemodule" in result.stdout
+
+
+def test_constraints_constrain_to_local(
+    script: PipTestEnvironment, data: TestData, resolver_variant: ResolverVariant
+) -> None:
+    to_install = data.src.joinpath("singlemodule")
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        f"{to_install.as_uri()}#egg=singlemodule"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "singlemodule",
+        allow_stderr_warning=True,
+    )
+    assert "Building wheel for singlemodule" in result.stdout
+
+
+def test_constrained_to_url_install_same_url(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.src.joinpath("singlemodule")
+    constraints = f"{to_install.as_uri()}#egg=singlemodule"
+    script.scratch_path.joinpath("constraints.txt").write_text(constraints)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        to_install,
+        allow_stderr_warning=True,
+    )
+    assert "Building wheel for singlemodule" in result.stdout, str(result)
+
+
+def test_double_install_spurious_hash_mismatch(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    """Make sure installing the same hashed sdist twice doesn't throw hash
+    mismatch errors.
+
+    Really, this is a test that we disable reads from the wheel cache in
+    hash-checking mode. Locally, implicitly built wheels of sdists obviously
+    have different hashes from the original archives. Comparing against those
+    causes spurious mismatch errors.
+
+    """
+    # Install wheel package, otherwise, it won't try to build wheels.
+    with requirements_file(
+        "simple==1.0 --hash=sha256:393043e672415891885c9a2a"
+        "0929b1af95fb866d6ca016b42d2e6ce53619b653",
+        tmpdir,
+    ) as reqs_file:
+        # Install a package (and build its wheel):
+        result = script.pip_install_local(
+            "--find-links",
+            data.find_links,
+            "-r",
+            reqs_file.resolve(),
+        )
+        assert "Successfully installed simple-1.0" in str(result)
+
+        # Uninstall it:
+        script.pip("uninstall", "-y", "simple")
+
+        # Then install it again. We should not hit a hash mismatch, and the
+        # package should install happily.
+        result = script.pip_install_local(
+            "--find-links",
+            data.find_links,
+            "-r",
+            reqs_file.resolve(),
+        )
+        assert "Successfully installed simple-1.0" in str(result)
+
+
+def test_install_with_extras_from_constraints(
+    script: PipTestEnvironment, data: TestData, resolver_variant: ResolverVariant
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        f"{to_install.as_uri()}#egg=LocalExtrasbar"
+    )
+    result = script.pip_install_local(
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "LocalExtras",
+        allow_stderr_warning=True,
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        assert "Constraints cannot have extras" in result.stderr
+    else:
+        result.did_create(script.site_packages / "simple")
+
+
+def test_install_with_extras_from_install(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        name="LocalExtras",
+        version="0.0.1",
+        extras={"bar": "simple", "baz": "singlemodule"},
+    )
+    script.scratch_path.joinpath("constraints.txt").write_text("LocalExtras")
+    result = script.pip_install_local(
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "LocalExtrasbaz",
+    )
+    result.did_create(script.site_packages / "singlemodule.py")
+
+
+def test_install_with_extras_joined(
+    script: PipTestEnvironment, data: TestData, resolver_variant: ResolverVariant
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        f"{to_install.as_uri()}#egg=LocalExtrasbar"
+    )
+    result = script.pip_install_local(
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "LocalExtrasbaz",
+        allow_stderr_warning=True,
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        assert "Constraints cannot have extras" in result.stderr
+    else:
+        result.did_create(script.site_packages / "simple")
+        result.did_create(script.site_packages / "singlemodule.py")
+
+
+def test_install_with_extras_editable_joined(
+    script: PipTestEnvironment, data: TestData, resolver_variant: ResolverVariant
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        f"-e {to_install.as_uri()}#egg=LocalExtrasbar"
+    )
+    result = script.pip_install_local(
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "LocalExtrasbaz",
+        allow_stderr_warning=True,
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        assert "Editable requirements are not allowed as constraints" in result.stderr
+    else:
+        result.did_create(script.site_packages / "simple")
+        result.did_create(script.site_packages / "singlemodule.py")
+
+
+def test_install_distribution_full_union(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    result = script.pip_install_local(
+        to_install, f"{to_install}bar", f"{to_install}baz"
+    )
+    assert "Building wheel for LocalExtras" in result.stdout
+    result.did_create(script.site_packages / "simple")
+    result.did_create(script.site_packages / "singlemodule.py")
+
+
+def test_install_distribution_duplicate_extras(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    package_name = f"{to_install}bar"
+    with pytest.raises(AssertionError):
+        result = script.pip_install_local(package_name, package_name)
+        expected = f"Double requirement given: {package_name}"
+        assert expected in result.stderr
+
+
+def test_install_distribution_union_with_constraints(
+    script: PipTestEnvironment,
+    data: TestData,
+    resolver_variant: ResolverVariant,
+) -> None:
+    to_install = data.packages.joinpath("LocalExtras")
+    script.scratch_path.joinpath("constraints.txt").write_text(f"{to_install}bar")
+    result = script.pip_install_local(
+        "-c",
+        script.scratch_path / "constraints.txt",
+        f"{to_install}baz",
+        allow_stderr_warning=True,
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        msg = "Unnamed requirements are not allowed as constraints"
+        assert msg in result.stderr
+    else:
+        assert "Building wheel for LocalExtras" in result.stdout
+        result.did_create(script.site_packages / "singlemodule.py")
+
+
+def test_install_distribution_union_with_versions(
+    script: PipTestEnvironment,
+    data: TestData,
+    resolver_variant: ResolverVariant,
+) -> None:
+    to_install_001 = data.packages.joinpath("LocalExtras")
+    to_install_002 = data.packages.joinpath("LocalExtras-0.0.2")
+    result = script.pip_install_local(
+        f"{to_install_001}bar",
+        f"{to_install_002}baz",
+        expect_error=(resolver_variant == "2020-resolver"),
+    )
+    if resolver_variant == "2020-resolver":
+        assert "Cannot install localextrasbar" in result.stderr
+        assert ("localextrasbar 0.0.1 depends on localextras 0.0.1") in result.stdout
+        assert ("localextrasbaz 0.0.2 depends on localextras 0.0.2") in result.stdout
+    else:
+        assert (
+            "Successfully installed LocalExtras-0.0.1 simple-3.0 singlemodule-0.0.1"
+        ) in result.stdout
+
+
+@pytest.mark.xfail
+def test_install_distribution_union_conflicting_extras(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    # LocalExtras requires simple==1.0, LocalExtrasbar requires simple==2.0;
+    # without a resolver, pip does not detect the conflict between simple==1.0
+    # and simple==2.0. Once a resolver is added, this conflict should be
+    # detected.
+    to_install = data.packages.joinpath("LocalExtras-0.0.2")
+    result = script.pip_install_local(
+        to_install, f"{to_install}bar", expect_error=True
+    )
+    assert "installed" not in result.stdout
+    assert "Conflict" in result.stderr
+
+
+def test_install_unsupported_wheel_link_with_marker(script: PipTestEnvironment) -> None:
+    script.scratch_path.joinpath("with-marker.txt").write_text(
+        textwrap.dedent(
+            """\
+            {url}; {req}
+        """
+        ).format(
+            url="https://github.com/a/b/c/asdf-1.5.2-cp27-none-xyz.whl",
+            req='sys_platform == "xyz"',
+        )
+    )
+    result = script.pip("install", "-r", script.scratch_path / "with-marker.txt")
+
+    assert (
+        "Ignoring asdf: markers 'sys_platform == \"xyz\"' don't match "
+        "your environment"
+    ) in result.stdout
+    assert len(result.files_created) == 0
+
+
+def test_install_unsupported_wheel_file(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    # Trying to install a local wheel with an incompatible version/type
+    # should fail.
+    path = data.packages.joinpath("simple.dist-0.1-py1-none-invalid.whl")
+    script.scratch_path.joinpath("wheel-file.txt").write_text(f"{path}\n")
+    result = script.pip(
+        "install",
+        "-r",
+        script.scratch_path / "wheel-file.txt",
+        expect_error=True,
+        expect_stderr=True,
+    )
+    assert (
+        "simple.dist-0.1-py1-none-invalid.whl is not a supported wheel on this platform"
+        in result.stderr
+    )
+    assert len(result.files_created) == 0
+
+
+def test_config_settings_local_to_package(
+    script: PipTestEnvironment,
+    common_wheels: Path,
+    arg_recording_sdist_maker: ArgRecordingSdistMaker,
+) -> None:
+    pyproject_toml = textwrap.dedent(
+        """
+        build-system
+        requires = "setuptools"
+        build-backend = "setuptools.build_meta"
+        """
+    )
+    simple0_sdist = arg_recording_sdist_maker(
+        "simple0",
+        extra_files={"pyproject.toml": pyproject_toml},
+        depends="foo",
+    )
+    foo_sdist = arg_recording_sdist_maker(
+        "foo",
+        extra_files={"pyproject.toml": pyproject_toml},
+    )
+    simple1_sdist = arg_recording_sdist_maker(
+        "simple1",
+        extra_files={"pyproject.toml": pyproject_toml},
+        depends="bar",
+    )
+    bar_sdist = arg_recording_sdist_maker(
+        "bar",
+        extra_files={"pyproject.toml": pyproject_toml},
+        depends="simple3",
+    )
+    simple3_sdist = arg_recording_sdist_maker(
+        "simple3", extra_files={"pyproject.toml": pyproject_toml}
+    )
+    simple2_sdist = arg_recording_sdist_maker(
+        "simple2",
+        extra_files={"pyproject.toml": pyproject_toml},
+    )
+
+    reqs_file = script.scratch_path.joinpath("reqs.txt")
+    reqs_file.write_text(
+        textwrap.dedent(
+            """
+            simple0 --config-settings "--build-option=--verbose"
+            foo --config-settings "--build-option=--quiet"
+            simple1 --config-settings "--build-option=--verbose"
+            simple2
+            """
+        )
+    )
+
+    script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        script.scratch_path,
+        "-f",
+        common_wheels,
+        "-r",
+        reqs_file,
+    )
+
+    simple0_args = simple0_sdist.args()
+    assert "--verbose" in simple0_args
+    foo_args = foo_sdist.args()
+    assert "--quiet" in foo_args
+    simple1_args = simple1_sdist.args()
+    assert "--verbose" in simple1_args
+    bar_args = bar_sdist.args()
+    assert "--verbose" not in bar_args
+    simple3_args = simple3_sdist.args()
+    assert "--verbose" not in simple3_args
+    simple2_args = simple2_sdist.args()
+    assert "--verbose" not in simple2_args

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_requested.py Added

@@ -0,0 +1,142 @@
+import pytest
+
+from tests.lib import PipTestEnvironment, TestData, TestPipResult
+
+
+def _assert_requested_present(
+    script: PipTestEnvironment, result: TestPipResult, name: str, version: str
+) -> None:
+    dist_info = script.site_packages / f"{name}-{version}.dist-info"
+    requested = dist_info / "REQUESTED"
+    assert dist_info in result.files_created
+    assert requested in result.files_created
+
+
+def _assert_requested_absent(
+    script: PipTestEnvironment, result: TestPipResult, name: str, version: str
+) -> None:
+    dist_info = script.site_packages / f"{name}-{version}.dist-info"
+    requested = dist_info / "REQUESTED"
+    assert dist_info in result.files_created
+    assert requested not in result.files_created
+
+
+def test_install_requested_basic(script: PipTestEnvironment, data: TestData) -> None:
+    result = script.pip(
+        "install", "--no-index", "-f", data.find_links, "require_simple"
+    )
+    _assert_requested_present(script, result, "require_simple", "1.0")
+    # dependency is not REQUESTED
+    _assert_requested_absent(script, result, "simple", "3.0")
+
+
+def test_install_requested_requirements(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("requirements.txt").write_text("require_simple\n")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-r",
+        script.scratch_path / "requirements.txt",
+    )
+    _assert_requested_present(script, result, "require_simple", "1.0")
+    _assert_requested_absent(script, result, "simple", "3.0")
+
+
+def test_install_requested_dep_in_requirements(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("requirements.txt").write_text(
+        "require_simple\nsimple<3\n"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-r",
+        script.scratch_path / "requirements.txt",
+    )
+    _assert_requested_present(script, result, "require_simple", "1.0")
+    # simple must have REQUESTED because it is in requirements.txt
+    _assert_requested_present(script, result, "simple", "2.0")
+
+
+def test_install_requested_reqs_and_constraints(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("requirements.txt").write_text("require_simple\n")
+    script.scratch_path.joinpath("constraints.txt").write_text("simple<3\n")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-r",
+        script.scratch_path / "requirements.txt",
+        "-c",
+        script.scratch_path / "constraints.txt",
+    )
+    _assert_requested_present(script, result, "require_simple", "1.0")
+    # simple must not have REQUESTED because it is merely a constraint
+    _assert_requested_absent(script, result, "simple", "2.0")
+
+
+def test_install_requested_in_reqs_and_constraints(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("requirements.txt").write_text(
+        "require_simple\nsimple\n"
+    )
+    script.scratch_path.joinpath("constraints.txt").write_text("simple<3\n")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-r",
+        script.scratch_path / "requirements.txt",
+        "-c",
+        script.scratch_path / "constraints.txt",
+    )
+    _assert_requested_present(script, result, "require_simple", "1.0")
+    # simple must have REQUESTED because it is in requirements.txt
+    _assert_requested_present(script, result, "simple", "2.0")
+
+
+def test_install_requested_from_cli_with_constraint(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("constraints.txt").write_text("simple<3\n")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "simple",
+    )
+    # simple must have REQUESTED because it was provided on the command line
+    _assert_requested_present(script, result, "simple", "2.0")
+
+
+@pytest.mark.network
+def test_install_requested_from_cli_with_url_constraint(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.scratch_path.joinpath("constraints.txt").write_text(
+        "pip-test-package @ git+https://github.com/pypa/pip-test-package@0.1.1\n"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-c",
+        script.scratch_path / "constraints.txt",
+        "pip-test-package",
+    )
+    # pip-test-package must have REQUESTED because it was provided on the command line
+    _assert_requested_present(script, result, "pip_test_package", "0.1.1")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_upgrade.py Added

@@ -0,0 +1,417 @@
+import itertools
+import os
+import sys
+import textwrap
+from pathlib import Path
+
+import pytest
+
+from tests.lib import pyversion  # noqa: F401
+from tests.lib import PipTestEnvironment, ResolverVariant, TestData, assert_all_changes
+from tests.lib.local_repos import local_checkout
+from tests.lib.wheel import make_wheel
+
+
+@pytest.mark.network
+def test_no_upgrade_unless_requested(script: PipTestEnvironment) -> None:
+    """
+    No upgrade if not specifically requested.
+
+    """
+    script.pip("install", "INITools==0.1")
+    result = script.pip("install", "INITools")
+    assert (
+        not result.files_created
+    ), "pip install INITools upgraded when it should not have"
+
+
+def test_invalid_upgrade_strategy_causes_error(script: PipTestEnvironment) -> None:
+    """
+    It errors out when the upgrade-strategy is an invalid/unrecognised one
+
+    """
+    result = script.pip_install_local(
+        "--upgrade", "--upgrade-strategy=bazinga", "simple", expect_error=True
+    )
+
+    assert result.returncode
+    assert "invalid choice" in result.stderr
+
+
+def test_only_if_needed_does_not_upgrade_deps_when_satisfied(
+    script: PipTestEnvironment, resolver_variant: ResolverVariant
+) -> None:
+    """
+    It doesn't upgrade a dependency if it already satisfies the requirements.
+
+    """
+    script.pip_install_local("simple==2.0")
+    result = script.pip_install_local(
+        "--upgrade", "--upgrade-strategy=only-if-needed", "require_simple"
+    )
+
+    assert (
+        script.site_packages / "require_simple-1.0.dist-info"
+    ) not in result.files_deleted, "should have installed require_simple==1.0"
+    assert (
+        script.site_packages / "simple-2.0.dist-info"
+    ) not in result.files_deleted, "should not have uninstalled simple==2.0"
+
+    msg = "Requirement already satisfied"
+    if resolver_variant == "legacy":
+        msg = msg + ", skipping upgrade: simple"
+    assert (
+        msg in result.stdout
+    ), "did not print correct message for not-upgraded requirement"
+
+
+def test_only_if_needed_does_upgrade_deps_when_no_longer_satisfied(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    It does upgrade a dependency if it no longer satisfies the requirements.
+
+    """
+    script.pip_install_local("simple==1.0")
+    result = script.pip_install_local(
+        "--upgrade", "--upgrade-strategy=only-if-needed", "require_simple"
+    )
+
+    assert (
+        script.site_packages / "require_simple-1.0.dist-info"
+    ) not in result.files_deleted, "should have installed require_simple==1.0"
+    expected = script.site_packages / "simple-3.0.dist-info"
+    result.did_create(expected, message="should have installed simple==3.0")
+    expected = script.site_packages / "simple-1.0.dist-info"
+    assert expected in result.files_deleted, "should have uninstalled simple==1.0"
+
+
+def test_eager_does_upgrade_dependencies_when_currently_satisfied(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    It does upgrade a dependency even if it already satisfies the requirements.
+
+    """
+    script.pip_install_local("simple==2.0")
+    result = script.pip_install_local(
+        "--upgrade", "--upgrade-strategy=eager", "require_simple"
+    )
+
+    assert (
+        script.site_packages / "require_simple-1.0.dist-info"
+    ) not in result.files_deleted, "should have installed require_simple==1.0"
+    assert (
+        script.site_packages / "simple-2.0.dist-info"
+    ) in result.files_deleted, "should have uninstalled simple==2.0"
+
+
+def test_eager_does_upgrade_dependencies_when_no_longer_satisfied(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    It does upgrade a dependency if it no longer satisfies the requirements.
+
+    """
+    script.pip_install_local("simple==1.0")
+    result = script.pip_install_local(
+        "--upgrade", "--upgrade-strategy=eager", "require_simple"
+    )
+
+    assert (
+        script.site_packages / "require_simple-1.0.dist-info"
+    ) not in result.files_deleted, "should have installed require_simple==1.0"
+    result.did_create(
+        script.site_packages / "simple-3.0.dist-info",
+        message="should have installed simple==3.0",
+    )
+    assert (
+        script.site_packages / "simple-1.0.dist-info" in result.files_deleted
+    ), "should have uninstalled simple==1.0"
+
+
+@pytest.mark.network
+def test_upgrade_to_specific_version(script: PipTestEnvironment) -> None:
+    """
+    It does upgrade to specific version requested.
+
+    """
+    script.pip("install", "INITools==0.1")
+    result = script.pip("install", "INITools==0.2")
+    assert result.files_created, "pip install with specific version did not upgrade"
+    assert script.site_packages / "INITools-0.1.dist-info" in result.files_deleted
+    result.did_create(script.site_packages / "INITools-0.2.dist-info")
+
+
+@pytest.mark.network
+def test_upgrade_if_requested(script: PipTestEnvironment) -> None:
+    """
+    And it does upgrade if requested.
+
+    """
+    script.pip("install", "INITools==0.1")
+    result = script.pip("install", "--upgrade", "INITools")
+    assert result.files_created, "pip install --upgrade did not upgrade"
+    result.did_not_create(script.site_packages / "INITools-0.1.dist-info")
+
+
+def test_upgrade_with_newest_already_installed(
+    script: PipTestEnvironment, data: TestData, resolver_variant: ResolverVariant
+) -> None:
+    """
+    If the newest version of a package is already installed, the package should
+    not be reinstalled and the user should be informed.
+    """
+    script.pip("install", "-f", data.find_links, "--no-index", "simple")
+    result = script.pip(
+        "install", "--upgrade", "-f", data.find_links, "--no-index", "simple"
+    )
+    assert not result.files_created, "simple upgraded when it should not have"
+    if resolver_variant == "2020-resolver":
+        msg = "Requirement already satisfied"
+    else:
+        msg = "already up-to-date"
+    assert msg in result.stdout, result.stdout
+
+
+@pytest.mark.network
+def test_upgrade_force_reinstall_newest(script: PipTestEnvironment) -> None:
+    """
+    Force reinstallation of a package even if it is already at its newest
+    version if --force-reinstall is supplied.
+    """
+    result = script.pip("install", "INITools")
+    result.did_create(script.site_packages / "initools")
+    result2 = script.pip("install", "--upgrade", "--force-reinstall", "INITools")
+    assert result2.files_updated, "upgrade to INITools 0.3 failed"
+    result3 = script.pip("uninstall", "initools", "-y")
+    assert_all_changes(result, result3, script.venv / "build", "cache")
+
+
+@pytest.mark.network
+def test_uninstall_before_upgrade(script: PipTestEnvironment) -> None:
+    """
+    Automatic uninstall-before-upgrade.
+
+    """
+    result = script.pip("install", "INITools==0.2")
+    result.did_create(script.site_packages / "initools")
+    result2 = script.pip("install", "INITools==0.3")
+    assert result2.files_created, "upgrade to INITools 0.3 failed"
+    result3 = script.pip("uninstall", "initools", "-y")
+    assert_all_changes(result, result3, script.venv / "build", "cache")
+
+
+@pytest.mark.network
+def test_uninstall_before_upgrade_from_url(script: PipTestEnvironment) -> None:
+    """
+    Automatic uninstall-before-upgrade from URL.
+
+    """
+    result = script.pip("install", "INITools==0.2")
+    result.did_create(script.site_packages / "initools")
+    result2 = script.pip(
+        "install",
+        "https://files.pythonhosted.org/packages/source/I/INITools/INITools-"
+        "0.3.tar.gz",
+    )
+    assert result2.files_created, "upgrade to INITools 0.3 failed"
+    result3 = script.pip("uninstall", "initools", "-y")
+    assert_all_changes(result, result3, script.venv / "build", "cache")
+
+
+@pytest.mark.network
+def test_upgrade_to_same_version_from_url(script: PipTestEnvironment) -> None:
+    """
+    When installing from a URL the same version that is already installed, no
+    need to uninstall and reinstall if --upgrade is not specified.
+
+    """
+    result = script.pip("install", "INITools==0.3")
+    result.did_create(script.site_packages / "initools")
+    result2 = script.pip(
+        "install",
+        "https://files.pythonhosted.org/packages/source/I/INITools/INITools-"
+        "0.3.tar.gz",
+    )
+    assert (
+        script.site_packages / "initools" not in result2.files_updated
+    ), "INITools 0.3 reinstalled same version"
+    result3 = script.pip("uninstall", "initools", "-y")
+    assert_all_changes(result, result3, script.venv / "build", "cache")
+
+
+@pytest.mark.network
+def test_upgrade_from_reqs_file(script: PipTestEnvironment) -> None:
+    """
+    Upgrade from a requirements file.
+
+    """
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """\
+        PyLogo<0.4
+        # and something else to test out:
+        INITools==0.3
+        """
+        )
+    )
+    install_result = script.pip("install", "-r", script.scratch_path / "test-req.txt")
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """\
+        PyLogo
+        # and something else to test out:
+        INITools
+        """
+        )
+    )
+    script.pip("install", "--upgrade", "-r", script.scratch_path / "test-req.txt")
+    uninstall_result = script.pip(
+        "uninstall", "-r", script.scratch_path / "test-req.txt", "-y"
+    )
+    assert_all_changes(
+        install_result,
+        uninstall_result,
+        script.venv / "build", "cache", script.scratch / "test-req.txt",
+    )
+
+
+def test_uninstall_rollback(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test uninstall-rollback (using test package with a setup.py
+    crafted to fail on install).
+
+    """
+    result = script.pip("install", "-f", data.find_links, "--no-index", "broken==0.1")
+    result.did_create(script.site_packages / "broken.py")
+    result2 = script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "broken===0.2broken",
+        expect_error=True,
+    )
+    assert result2.returncode == 1, str(result2)
+    assert (
+        script.run("python", "-c", "import broken; print(broken.VERSION)").stdout
+        == "0.1\n"
+    )
+    assert_all_changes(
+        result.files_after,
+        result2,
+        script.venv / "build",
+    )
+
+
+@pytest.mark.network
+def test_should_not_install_always_from_cache(script: PipTestEnvironment) -> None:
+    """
+    If there is an old cached package, pip should download the newer version
+    Related to issue #175
+    """
+    script.pip("install", "INITools==0.2")
+    script.pip("uninstall", "-y", "INITools")
+    result = script.pip("install", "INITools==0.1")
+    result.did_not_create(script.site_packages / "INITools-0.2.dist-info")
+    result.did_create(script.site_packages / "INITools-0.1.dist-info")
+
+
+@pytest.mark.network
+def test_install_with_ignoreinstalled_requested(script: PipTestEnvironment) -> None:
+    """
+    Test old conflicting package is completely ignored
+    """
+    script.pip("install", "INITools==0.1")
+    result = script.pip("install", "-I", "INITools==0.3")
+    assert result.files_created, "pip install -I did not install"
+    # both the old and new metadata should be present.
+    assert os.path.exists(script.site_packages_path / "INITools-0.1.dist-info")
+    assert os.path.exists(script.site_packages_path / "INITools-0.3.dist-info")
+
+
+@pytest.mark.network
+def test_upgrade_vcs_req_with_no_dists_found(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """It can upgrade a VCS requirement that has no distributions otherwise."""
+    req = "{checkout}#egg=pip-test-package".format(
+        checkout=local_checkout(
+            "git+https://github.com/pypa/pip-test-package.git",
+            tmpdir,
+        )
+    )
+    script.pip("install", req)
+    result = script.pip("install", "-U", req)
+    assert not result.returncode
+
+
+@pytest.mark.network
+def test_upgrade_vcs_req_with_dist_found(script: PipTestEnvironment) -> None:
+    """It can upgrade a VCS requirement that has distributions on the index."""
+    # TODO(pnasrat) Using local_checkout fails on windows - oddness with the
+    # test path urls/git.
+    req = "{url}#egg=pretend".format(
+        url=(
+            "git+https://github.com/alex/pretend@e7f26ad7dbcb4a02a4995aade4"
+            "743aad47656b27"
+        ),
+    )
+    script.pip("install", req, expect_stderr=True)
+    result = script.pip("install", "-U", req, expect_stderr=True)
+    assert "pypi.org" not in result.stdout, result.stdout
+
+
+@pytest.mark.parametrize(
+    "req1, req2",
+    list(
+        itertools.product(
+            "foo.bar", "foo_bar", "foo-bar",
+            "foo.bar", "foo_bar", "foo-bar",
+        )
+    ),
+)
+def test_install_find_existing_package_canonicalize(
+    script: PipTestEnvironment, req1: str, req2: str
+) -> None:
+    """Ensure an already-installed dist is found no matter how the dist name
+    was normalized on installation. (pypa/pip#8645)
+    """
+    # Create and install a package that's not available in the later stage.
+    req_container = script.scratch_path.joinpath("foo-bar")
+    req_container.mkdir()
+    req_path = make_wheel("foo_bar", "1.0").save_to_dir(req_container)
+    script.pip("install", "--no-index", req_path)
+
+    # Depend on the previously installed, but now unavailable package.
+    pkg_container = script.scratch_path.joinpath("pkg")
+    pkg_container.mkdir()
+    make_wheel(
+        "pkg",
+        "1.0",
+        metadata_updates={"Requires-Dist": req2},
+    ).save_to_dir(pkg_container)
+
+    # Ensure the previously installed package can be correctly used to match
+    # the dependency.
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links",
+        pkg_container,
+        "pkg",
+    )
+    satisfied_message = f"Requirement already satisfied: {req2}"
+    assert satisfied_message in result.stdout, str(result)
+
+
+@pytest.mark.network
+@pytest.mark.skipif(sys.platform != "win32", reason="Windows-only test")
+def test_modifying_pip_presents_error(script: PipTestEnvironment) -> None:
+    result = script.pip(
+        "install", "pip", "--force-reinstall", use_module=False, expect_error=True
+    )
+
+    assert "python.exe" in result.stderr or "python.EXE" in result.stderr, str(result)
+    assert " -m " in result.stderr, str(result)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_user.py Added

@@ -0,0 +1,328 @@
+"""
+tests specific to "pip install --user"
+"""
+import os
+import textwrap
+from os.path import curdir, isdir, isfile
+from pathlib import Path
+
+import pytest
+
+from tests.lib import pyversion  # noqa: F401
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    create_basic_wheel_for_package,
+    need_svn,
+)
+from tests.lib.local_repos import local_checkout
+from tests.lib.venv import VirtualEnvironment
+
+
+def _patch_dist_in_site_packages(virtualenv: VirtualEnvironment) -> None:
+    # Since the tests are run from a virtualenv, and to avoid the "Will not
+    # install to the usersite because it will lack sys.path precedence..."
+    # error: Monkey patch the Distribution class so it's possible to install a
+    # conflicting distribution in the user site.
+    virtualenv.sitecustomize = textwrap.dedent(
+        """
+        def dist_in_site_packages(dist):
+            return False
+
+        from pip._internal.metadata.base import BaseDistribution
+        BaseDistribution.in_site_packages = property(dist_in_site_packages)
+    """
+    )
+
+
+@pytest.mark.usefixtures("enable_user_site")
+class Tests_UserSite:
+    @pytest.mark.network
+    def test_reset_env_system_site_packages_usersite(
+        self, script: PipTestEnvironment
+    ) -> None:
+        """
+        Check user site works as expected.
+        """
+        script.pip("install", "--user", "INITools==0.2")
+        result = script.run(
+            "python",
+            "-c",
+            "import pkg_resources; print(pkg_resources.get_distribution"
+            "('initools').project_name)",
+        )
+        project_name = result.stdout.strip()
+        assert "INITools" == project_name, project_name
+
+    @pytest.mark.xfail
+    @pytest.mark.network
+    @need_svn
+    def test_install_subversion_usersite_editable_with_distribute(
+        self, script: PipTestEnvironment, tmpdir: Path
+    ) -> None:
+        """
+        Test installing current directory ('.') into usersite after installing
+        distribute
+        """
+        result = script.pip(
+            "install",
+            "--user",
+            "-e",
+            "{checkout}#egg=initools".format(
+                checkout=local_checkout(
+                    "svn+http://svn.colorstudy.com/INITools", tmpdir
+                )
+            ),
+        )
+        result.assert_installed("INITools", use_user_site=True)
+
+    def test_install_from_current_directory_into_usersite(
+        self, script: PipTestEnvironment, data: TestData
+    ) -> None:
+        """
+        Test installing current directory ('.') into usersite
+        """
+        run_from = data.packages.joinpath("FSPkg")
+        result = script.pip(
+            "install",
+            "-vvv",
+            "--user",
+            curdir,
+            cwd=run_from,
+        )
+
+        fspkg_folder = script.user_site / "fspkg"
+        result.did_create(fspkg_folder)
+
+        dist_info_folder = script.user_site / "FSPkg-0.1.dev0.dist-info"
+        result.did_create(dist_info_folder)
+
+    def test_install_user_venv_nositepkgs_fails(
+        self, virtualenv: VirtualEnvironment, script: PipTestEnvironment, data: TestData
+    ) -> None:
+        """
+        user install in virtualenv (with no system packages) fails with message
+        """
+        # We can't use PYTHONNOUSERSITE, as it's not
+        # honoured by virtualenv's custom site.py.
+        virtualenv.user_site_packages = False
+        run_from = data.packages.joinpath("FSPkg")
+        result = script.pip(
+            "install",
+            "--user",
+            curdir,
+            cwd=run_from,
+            expect_error=True,
+        )
+        assert (
+            "Can not perform a '--user' install. User site-packages are not "
+            "visible in this virtualenv." in result.stderr
+        )
+
+    @pytest.mark.network
+    def test_install_user_conflict_in_usersite(
+        self, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test user install with conflict in usersite updates usersite.
+        """
+
+        script.pip("install", "--user", "INITools==0.3", "--no-binary=:all:")
+
+        result2 = script.pip("install", "--user", "INITools==0.1", "--no-binary=:all:")
+
+        # usersite has 0.1
+        dist_info_folder = script.user_site / "INITools-0.1.dist-info"
+        initools_v3_file = (
+            # file only in 0.3
+            script.base_path
+            / script.user_site
+            / "initools"
+            / "configparser.py"
+        )
+        result2.did_create(dist_info_folder)
+        assert not isfile(initools_v3_file), initools_v3_file
+
+    def test_install_user_conflict_in_globalsite(
+        self, virtualenv: VirtualEnvironment, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test user install with conflict in global site ignores site and
+        installs to usersite
+        """
+        create_basic_wheel_for_package(script, "initools", "0.1")
+        create_basic_wheel_for_package(script, "initools", "0.2")
+
+        _patch_dist_in_site_packages(virtualenv)
+
+        script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "initools==0.2",
+        )
+        result2 = script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--user",
+            "initools==0.1",
+        )
+
+        # usersite has 0.1
+        dist_info_folder = script.user_site / "initools-0.1.dist-info"
+        initools_folder = script.user_site / "initools"
+        result2.did_create(dist_info_folder)
+        result2.did_create(initools_folder)
+
+        # site still has 0.2 (can't look in result1; have to check)
+        dist_info_folder = (
+            script.base_path / script.site_packages / "initools-0.2.dist-info"
+        )
+        initools_folder = script.base_path / script.site_packages / "initools"
+        assert isdir(dist_info_folder)
+        assert isdir(initools_folder)
+
+    def test_upgrade_user_conflict_in_globalsite(
+        self, virtualenv: VirtualEnvironment, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test user install/upgrade with conflict in global site ignores site and
+        installs to usersite
+        """
+        create_basic_wheel_for_package(script, "initools", "0.2")
+        create_basic_wheel_for_package(script, "initools", "0.3.1")
+
+        _patch_dist_in_site_packages(virtualenv)
+
+        script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "initools==0.2",
+        )
+        result2 = script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--user",
+            "--upgrade",
+            "initools",
+        )
+
+        # usersite has 0.3.1
+        dist_info_folder = script.user_site / "initools-0.3.1.dist-info"
+        initools_folder = script.user_site / "initools"
+        result2.did_create(dist_info_folder)
+        result2.did_create(initools_folder)
+
+        # site still has 0.2 (can't look in result1; have to check)
+        dist_info_folder = (
+            script.base_path / script.site_packages / "initools-0.2.dist-info"
+        )
+        initools_folder = script.base_path / script.site_packages / "initools"
+        assert isdir(dist_info_folder), result2.stdout
+        assert isdir(initools_folder)
+
+    def test_install_user_conflict_in_globalsite_and_usersite(
+        self, virtualenv: VirtualEnvironment, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test user install with conflict in globalsite and usersite ignores
+        global site and updates usersite.
+        """
+        initools_v3_file_name = os.path.join("initools", "configparser.py")
+        create_basic_wheel_for_package(script, "initools", "0.1")
+        create_basic_wheel_for_package(script, "initools", "0.2")
+        create_basic_wheel_for_package(
+            script,
+            "initools",
+            "0.3",
+            extra_files={initools_v3_file_name: "# Hi!"},
+        )
+
+        _patch_dist_in_site_packages(virtualenv)
+
+        script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "initools==0.2",
+        )
+        script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--user",
+            "initools==0.3",
+        )
+        result3 = script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--user",
+            "initools==0.1",
+        )
+
+        # usersite has 0.1
+        dist_info_folder = script.user_site / "initools-0.1.dist-info"
+        result3.did_create(dist_info_folder)
+        initools_v3_file = script.base_path / script.user_site / initools_v3_file_name
+        assert not isfile(initools_v3_file), initools_v3_file
+
+        # site still has 0.2 (can't just look in result1; have to check)
+        dist_info_folder = (
+            script.base_path / script.site_packages / "initools-0.2.dist-info"
+        )
+        initools_folder = script.base_path / script.site_packages / "initools"
+        assert isdir(dist_info_folder)
+        assert isdir(initools_folder)
+
+    def test_install_user_in_global_virtualenv_with_conflict_fails(
+        self, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test user install in --system-site-packages virtualenv with conflict in
+        site fails.
+        """
+        create_basic_wheel_for_package(script, "pkg", "0.1")
+        create_basic_wheel_for_package(script, "pkg", "0.2")
+
+        script.pip(
+            "install",
+            "--no-cache-dir",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "pkg==0.2",
+        )
+
+        result2 = script.pip(
+            "install",
+            "--no-cache-dir",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--user",
+            "pkg==0.1",
+            expect_error=True,
+        )
+        resultp = script.run(
+            "python",
+            "-c",
+            "from pip._internal.metadata import get_default_environment; "
+            "print(get_default_environment().get_distribution('pkg').location)",
+        )
+        dist_location = resultp.stdout.strip()
+
+        assert (
+            f"Will not install to the user site because it will lack sys.path "
+            f"precedence to pkg in {dist_location}"
+        ) in result2.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_vcs_git.py Added

@@ -0,0 +1,610 @@
+from pathlib import Path
+from typing import Optional
+
+import pytest
+
+from tests.lib import pyversion  # noqa: F401
+from tests.lib import (
+    PipTestEnvironment,
+    _change_test_package_version,
+    _create_test_package,
+)
+from tests.lib.git_submodule_helpers import (
+    _change_test_package_submodule,
+    _create_test_package_with_submodule,
+    _pull_in_submodule_changes_to_module,
+)
+from tests.lib.local_repos import local_checkout
+
+
+def _get_editable_repo_dir(script: PipTestEnvironment, package_name: str) -> Path:
+    """
+    Return the repository directory for an editable install.
+    """
+    return script.venv_path / "src" / package_name
+
+
+def _get_editable_branch(script: PipTestEnvironment, package_name: str) -> str:
+    """
+    Return the current branch of an editable install.
+    """
+    repo_dir = _get_editable_repo_dir(script, package_name)
+    result = script.run("git", "rev-parse", "--abbrev-ref", "HEAD", cwd=repo_dir)
+    return result.stdout.strip()
+
+
+def _get_branch_remote(
+    script: PipTestEnvironment, package_name: str, branch: str
+) -> str:
+    """ """
+    repo_dir = _get_editable_repo_dir(script, package_name)
+    result = script.run("git", "config", f"branch.{branch}.remote", cwd=repo_dir)
+    return result.stdout.strip()
+
+
+def _github_checkout(
+    url_path: str,
+    tmpdir: Path,
+    rev: Optionalstr = None,
+    egg: Optionalstr = None,
+    scheme: Optionalstr = None,
+) -> str:
+    """
+    Call local_checkout() with a GitHub URL, and return the resulting URL.
+
+    Args:
+      url_path: the string used to create the package URL by filling in the
+        format string "git+{scheme}://github.com/{url_path}".
+      temp_dir: the pytest tmpdir value.
+      egg: an optional project name to append to the URL as the egg fragment,
+        prior to returning.
+      scheme: the scheme without the "git+" prefix. Defaults to "https".
+    """
+    if scheme is None:
+        scheme = "https"
+    url = f"git+{scheme}://github.com/{url_path}"
+    local_url = local_checkout(url, tmpdir)
+    if rev is not None:
+        local_url += f"@{rev}"
+    if egg is not None:
+        local_url += f"#egg={egg}"
+
+    return local_url
+
+
+def _make_version_pkg_url(
+    path: Path, rev: Optionalstr = None, name: str = "version_pkg"
+) -> str:
+    """
+    Return a "git+file://" URL to the version_pkg test package.
+
+    Args:
+      path: a pathlib.Path object pointing to a Git repository
+        containing the version_pkg package.
+      rev: an optional revision to install like a branch name, tag, or SHA.
+    """
+    file_url = path.as_uri()
+    url_rev = "" if rev is None else f"@{rev}"
+    url = f"git+{file_url}{url_rev}#egg={name}"
+
+    return url
+
+
+def _install_version_pkg_only(
+    script: PipTestEnvironment,
+    path: Path,
+    rev: Optionalstr = None,
+    allow_stderr_warning: bool = False,
+) -> None:
+    """
+    Install the version_pkg package in editable mode (without returning
+    the version).
+
+    Args:
+      path: a pathlib.Path object pointing to a Git repository
+        containing the package.
+      rev: an optional revision to install like a branch name or tag.
+    """
+    version_pkg_url = _make_version_pkg_url(path, rev=rev)
+    script.pip(
+        "install", "-e", version_pkg_url, allow_stderr_warning=allow_stderr_warning
+    )
+
+
+def _install_version_pkg(
+    script: PipTestEnvironment,
+    path: Path,
+    rev: Optionalstr = None,
+    allow_stderr_warning: bool = False,
+) -> str:
+    """
+    Install the version_pkg package in editable mode, and return the version
+    installed.
+
+    Args:
+      path: a pathlib.Path object pointing to a Git repository
+        containing the package.
+      rev: an optional revision to install like a branch name or tag.
+    """
+    _install_version_pkg_only(
+        script,
+        path,
+        rev=rev,
+        allow_stderr_warning=allow_stderr_warning,
+    )
+    result = script.run("version_pkg")
+    version = result.stdout.strip()
+
+    return version
+
+
+def test_git_install_again_after_changes(script: PipTestEnvironment) -> None:
+    """
+    Test installing a repository a second time without specifying a revision,
+    and after updates to the remote repository.
+
+    This test also checks that no warning message like the following gets
+    logged on the update: "Did not find branch or tag ..., assuming ref or
+    revision."
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    version = _install_version_pkg(script, version_pkg_path)
+    assert version == "0.1"
+
+    _change_test_package_version(script, version_pkg_path)
+    version = _install_version_pkg(script, version_pkg_path)
+    assert version == "some different version"
+
+
+def test_git_install_branch_again_after_branch_changes(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test installing a branch again after the branch is updated in the remote
+    repository.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    version = _install_version_pkg(script, version_pkg_path, rev="master")
+    assert version == "0.1"
+
+    _change_test_package_version(script, version_pkg_path)
+    version = _install_version_pkg(script, version_pkg_path, rev="master")
+    assert version == "some different version"
+
+
+@pytest.mark.network
+def test_install_editable_from_git_with_https(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test cloning from Git with https.
+    """
+    url_path = "pypa/pip-test-package.git"
+    local_url = _github_checkout(url_path, tmpdir, egg="pip-test-package")
+    result = script.pip("install", "-e", local_url)
+    result.assert_installed("pip-test-package", with_files=".git")
+
+
+@pytest.mark.network
+def test_install_noneditable_git(script: PipTestEnvironment) -> None:
+    """
+    Test installing from a non-editable git URL with a given tag.
+    """
+    result = script.pip(
+        "install",
+        "git+https://github.com/pypa/pip-test-package.git"
+        "@0.1.1#egg=pip-test-package",
+    )
+    dist_info_folder = script.site_packages / "pip_test_package-0.1.1.dist-info"
+    result.assert_installed("piptestpackage", without_egg_link=True, editable=False)
+    result.did_create(dist_info_folder)
+
+
+def test_git_with_sha1_revisions(script: PipTestEnvironment) -> None:
+    """
+    Git backend should be able to install from SHA1 revisions
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    _change_test_package_version(script, version_pkg_path)
+    sha1 = script.run(
+        "git",
+        "rev-parse",
+        "HEAD~1",
+        cwd=version_pkg_path,
+    ).stdout.strip()
+    version = _install_version_pkg(script, version_pkg_path, rev=sha1)
+    assert "0.1" == version
+
+
+def test_git_with_short_sha1_revisions(script: PipTestEnvironment) -> None:
+    """
+    Git backend should be able to install from SHA1 revisions
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    _change_test_package_version(script, version_pkg_path)
+    sha1 = script.run(
+        "git",
+        "rev-parse",
+        "HEAD~1",
+        cwd=version_pkg_path,
+    ).stdout.strip():7
+    version = _install_version_pkg(
+        script,
+        version_pkg_path,
+        rev=sha1,
+        # WARNING: Did not find branch or tag ..., assuming revision or ref.
+        allow_stderr_warning=True,
+    )
+    assert "0.1" == version
+
+
+def test_git_with_branch_name_as_revision(script: PipTestEnvironment) -> None:
+    """
+    Git backend should be able to install from branch names
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    branch = "test_branch"
+    script.run("git", "checkout", "-b", branch, cwd=version_pkg_path)
+    _change_test_package_version(script, version_pkg_path)
+    version = _install_version_pkg(script, version_pkg_path, rev=branch)
+    assert "some different version" == version
+
+
+def test_git_with_tag_name_as_revision(script: PipTestEnvironment) -> None:
+    """
+    Git backend should be able to install from tag names
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    script.run("git", "tag", "test_tag", cwd=version_pkg_path)
+    _change_test_package_version(script, version_pkg_path)
+    version = _install_version_pkg(script, version_pkg_path, rev="test_tag")
+    assert "0.1" == version
+
+
+def _add_ref(script: PipTestEnvironment, path: Path, ref: str) -> None:
+    """
+    Add a new ref to a repository at the given path.
+    """
+    script.run("git", "update-ref", ref, "HEAD", cwd=path)
+
+
+def test_git_install_ref(script: PipTestEnvironment) -> None:
+    """
+    The Git backend should be able to install a ref with the first install.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    _add_ref(script, version_pkg_path, "refs/foo/bar")
+    _change_test_package_version(script, version_pkg_path)
+
+    version = _install_version_pkg(
+        script,
+        version_pkg_path,
+        rev="refs/foo/bar",
+        # WARNING: Did not find branch or tag ..., assuming revision or ref.
+        allow_stderr_warning=True,
+    )
+    assert "0.1" == version
+
+
+def test_git_install_then_install_ref(script: PipTestEnvironment) -> None:
+    """
+    The Git backend should be able to install a ref after a package has
+    already been installed.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    _add_ref(script, version_pkg_path, "refs/foo/bar")
+    _change_test_package_version(script, version_pkg_path)
+
+    version = _install_version_pkg(script, version_pkg_path)
+    assert "some different version" == version
+
+    # Now install the ref.
+    version = _install_version_pkg(
+        script,
+        version_pkg_path,
+        rev="refs/foo/bar",
+        # WARNING: Did not find branch or tag ..., assuming revision or ref.
+        allow_stderr_warning=True,
+    )
+    assert "0.1" == version
+
+
+@pytest.mark.network
+@pytest.mark.parametrize(
+    "rev, expected_sha",
+    
+        # Clone the default branch
+        ("", "5547fa909e83df8bd743d3978d6667497983a4b7"),
+        # Clone a specific tag
+        ("@0.1.1", "7d654e66c8fa7149c165ddeffa5b56bc06619458"),
+        # Clone a specific commit
+        (
+            "@65cf0a5bdd906ecf48a0ac241c17d656d2071d56",
+            "65cf0a5bdd906ecf48a0ac241c17d656d2071d56",
+        ),
+    ,
+)
+def test_install_git_logs_commit_sha(
+    script: PipTestEnvironment, rev: str, expected_sha: str, tmpdir: Path
+) -> None:
+    """
+    Test installing from a git repository logs a commit SHA.
+    """
+    url_path = "pypa/pip-test-package.git"
+    base_local_url = _github_checkout(url_path, tmpdir)
+    local_url = f"{base_local_url}{rev}#egg=pip-test-package"
+    result = script.pip("install", local_url)
+    # `4:` removes a 'git+' prefix
+    assert f"Resolved {base_local_url4:} to commit {expected_sha}" in result.stdout
+
+
+@pytest.mark.network
+def test_git_with_tag_name_and_update(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """
+    Test cloning a git repository and updating to a different version.
+    """
+    url_path = "pypa/pip-test-package.git"
+    base_local_url = _github_checkout(url_path, tmpdir)
+
+    local_url = f"{base_local_url}#egg=pip-test-package"
+    result = script.pip("install", "-e", local_url)
+    result.assert_installed("pip-test-package", with_files=".git")
+
+    new_local_url = f"{base_local_url}@0.1.2#egg=pip-test-package"
+    result = script.pip(
+        "install",
+        "--global-option=--version",
+        "-e",
+        new_local_url,
+        allow_stderr_warning=True,
+    )
+    assert "0.1.2" in result.stdout
+
+
+@pytest.mark.network
+def test_git_branch_should_not_be_changed(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Editable installations should not change branch
+    related to issue #32 and #161
+    """
+    url_path = "pypa/pip-test-package.git"
+    local_url = _github_checkout(url_path, tmpdir, egg="pip-test-package")
+    script.pip("install", "-e", local_url)
+    branch = _get_editable_branch(script, "pip-test-package")
+    assert "master" == branch
+
+
+@pytest.mark.network
+def test_git_with_non_editable_unpacking(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test cloning a git repository from a non-editable URL with a given tag.
+    """
+    url_path = "pypa/pip-test-package.git"
+    local_url = _github_checkout(
+        url_path,
+        tmpdir,
+        rev="0.1.2",
+        egg="pip-test-package",
+    )
+    result = script.pip(
+        "install",
+        "--global-option=--quiet",
+        local_url,
+        allow_stderr_warning=True,
+    )
+    assert "0.1.2" in result.stdout
+
+
+@pytest.mark.network
+def test_git_with_editable_where_egg_contains_dev_string(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test cloning a git repository from an editable url which contains "dev"
+    string
+    """
+    url_path = "dcramer/django-devserver.git"
+    local_url = _github_checkout(
+        url_path,
+        tmpdir,
+        egg="django-devserver",
+        scheme="https",
+    )
+    result = script.pip("install", "-e", local_url)
+    result.assert_installed("django-devserver", with_files=".git")
+
+
+@pytest.mark.network
+def test_git_with_non_editable_where_egg_contains_dev_string(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test cloning a git repository from a non-editable url which contains "dev"
+    string
+    """
+    url_path = "dcramer/django-devserver.git"
+    local_url = _github_checkout(
+        url_path,
+        tmpdir,
+        egg="django-devserver",
+        scheme="https",
+    )
+    result = script.pip("install", local_url)
+    devserver_folder = script.site_packages / "devserver"
+    result.did_create(devserver_folder)
+
+
+def test_git_with_ambiguous_revs(script: PipTestEnvironment) -> None:
+    """
+    Test git with two "names" (tag/branch) pointing to the same commit
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    version_pkg_url = _make_version_pkg_url(version_pkg_path, rev="0.1")
+    script.run("git", "tag", "0.1", cwd=version_pkg_path)
+    result = script.pip("install", "-e", version_pkg_url)
+    assert "Could not find a tag or branch" not in result.stdout
+    # it is 'version-pkg' instead of 'version_pkg' because
+    # egg-link name is version-pkg.egg-link because it is a single .py module
+    result.assert_installed("version-pkg", with_files=".git")
+
+
+def test_editable__no_revision(script: PipTestEnvironment) -> None:
+    """
+    Test a basic install in editable mode specifying no revision.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    _install_version_pkg_only(script, version_pkg_path)
+
+    branch = _get_editable_branch(script, "version-pkg")
+    assert branch == "master"
+
+    remote = _get_branch_remote(script, "version-pkg", "master")
+    assert remote == "origin"
+
+
+def test_editable__branch_with_sha_same_as_default(script: PipTestEnvironment) -> None:
+    """
+    Test installing in editable mode a branch whose sha matches the sha
+    of the default branch, but is different from the default branch.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    # Create a second branch with the same SHA.
+    script.run("git", "branch", "develop", cwd=version_pkg_path)
+    _install_version_pkg_only(script, version_pkg_path, rev="develop")
+
+    branch = _get_editable_branch(script, "version-pkg")
+    assert branch == "develop"
+
+    remote = _get_branch_remote(script, "version-pkg", "develop")
+    assert remote == "origin"
+
+
+def test_editable__branch_with_sha_different_from_default(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test installing in editable mode a branch whose sha is different from
+    the sha of the default branch.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    # Create a second branch.
+    script.run("git", "branch", "develop", cwd=version_pkg_path)
+    # Add another commit to the master branch to give it a different sha.
+    _change_test_package_version(script, version_pkg_path)
+
+    version = _install_version_pkg(script, version_pkg_path, rev="develop")
+    assert version == "0.1"
+
+    branch = _get_editable_branch(script, "version-pkg")
+    assert branch == "develop"
+
+    remote = _get_branch_remote(script, "version-pkg", "develop")
+    assert remote == "origin"
+
+
+def test_editable__non_master_default_branch(script: PipTestEnvironment) -> None:
+    """
+    Test the branch you get after an editable install from a remote repo
+    with a non-master default branch.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+    # Change the default branch of the remote repo to a name that is
+    # alphabetically after "master".
+    script.run("git", "checkout", "-b", "release", cwd=version_pkg_path)
+    _install_version_pkg_only(script, version_pkg_path)
+
+    branch = _get_editable_branch(script, "version-pkg")
+    assert branch == "release"
+
+
+def test_reinstalling_works_with_editable_non_master_branch(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Reinstalling an editable installation should not assume that the "master"
+    branch exists. See https://github.com/pypa/pip/issues/4448.
+    """
+    version_pkg_path = _create_test_package(script.scratch_path)
+
+    # Switch the default branch to something other than 'master'
+    script.run("git", "branch", "-m", "foobar", cwd=version_pkg_path)
+
+    version = _install_version_pkg(script, version_pkg_path)
+    assert "0.1" == version
+
+    _change_test_package_version(script, version_pkg_path)
+    version = _install_version_pkg(script, version_pkg_path)
+    assert "some different version" == version
+
+
+# TODO(pnasrat) fix all helpers to do right things with paths on windows.
+@pytest.mark.skipif("sys.platform == 'win32'")
+@pytest.mark.xfail(
+    condition=True,
+    reason="Git submodule against file: is not working; waiting for a good solution",
+    run=True,
+)
+def test_check_submodule_addition(script: PipTestEnvironment) -> None:
+    """
+    Submodules are pulled in on install and updated on upgrade.
+    """
+    module_path, submodule_path = _create_test_package_with_submodule(
+        script, rel_path="testpkg/static"
+    )
+
+    install_result = script.pip(
+        "install", "-e", f"git+{module_path.as_uri()}#egg=version_pkg"
+    )
+    install_result.did_create(script.venv / "src/version-pkg/testpkg/static/testfile")
+
+    _change_test_package_submodule(script, submodule_path)
+    _pull_in_submodule_changes_to_module(
+        script,
+        module_path,
+        rel_path="testpkg/static",
+    )
+
+    # expect error because git may write to stderr
+    update_result = script.pip(
+        "install",
+        "-e",
+        f"git+{module_path.as_uri()}#egg=version_pkg",
+        "--upgrade",
+    )
+
+    update_result.did_create(script.venv / "src/version-pkg/testpkg/static/testfile2")
+
+
+def test_install_git_branch_not_cached(script: PipTestEnvironment) -> None:
+    """
+    Installing git urls with a branch revision does not cause wheel caching.
+    """
+    PKG = "gitbranchnotcached"
+    repo_dir = _create_test_package(script.scratch_path, name=PKG)
+    url = _make_version_pkg_url(repo_dir, rev="master", name=PKG)
+    result = script.pip("install", url, "--only-binary=:all:")
+    assert f"Successfully built {PKG}" in result.stdout, result.stdout
+    script.pip("uninstall", "-y", PKG)
+    # build occurs on the second install too because it is not cached
+    result = script.pip("install", url)
+    assert f"Successfully built {PKG}" in result.stdout, result.stdout
+
+
+def test_install_git_sha_cached(script: PipTestEnvironment) -> None:
+    """
+    Installing git urls with a sha revision does cause wheel caching.
+    """
+    PKG = "gitshacached"
+    repo_dir = _create_test_package(script.scratch_path, name=PKG)
+    commit = script.run("git", "rev-parse", "HEAD", cwd=repo_dir).stdout.strip()
+    url = _make_version_pkg_url(repo_dir, rev=commit, name=PKG)
+    result = script.pip("install", url)
+    assert f"Successfully built {PKG}" in result.stdout, result.stdout
+    script.pip("uninstall", "-y", PKG)
+    # build does not occur on the second install because it is cached
+    result = script.pip("install", url)
+    assert f"Successfully built {PKG}" not in result.stdout, result.stdout

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_install_wheel.py Added

@@ -0,0 +1,802 @@
+import base64
+import csv
+import hashlib
+import os
+import shutil
+import sysconfig
+from pathlib import Path
+from typing import Any
+
+import pytest
+
+from tests.lib import PipTestEnvironment, TestData, create_basic_wheel_for_package
+from tests.lib.wheel import WheelBuilder, make_wheel
+
+
+# assert_installed expects a package subdirectory, so give it to them
+def make_wheel_with_file(name: str, version: str, **kwargs: Any) -> WheelBuilder:
+    extra_files = kwargs.setdefault("extra_files", {})
+    extra_filesf"{name}/__init__.py" = "# example"
+    return make_wheel(name=name, version=version, **kwargs)
+
+
+def test_install_from_future_wheel_version(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test installing a wheel with a WHEEL metadata version that is:
+    - a major version ahead of what we expect (not ok), and
+    - a minor version ahead of what we expect (ok)
+    """
+    from tests.lib import TestFailure
+
+    package = make_wheel_with_file(
+        name="futurewheel",
+        version="3.0",
+        wheel_metadata_updates={"Wheel-Version": "3.0"},
+    ).save_to_dir(tmpdir)
+
+    result = script.pip("install", package, "--no-index", expect_error=True)
+    with pytest.raises(TestFailure):
+        result.assert_installed("futurewheel", without_egg_link=True, editable=False)
+
+    package = make_wheel_with_file(
+        name="futurewheel",
+        version="1.9",
+        wheel_metadata_updates={"Wheel-Version": "1.9"},
+    ).save_to_dir(tmpdir)
+    result = script.pip("install", package, "--no-index", expect_stderr=True)
+    result.assert_installed("futurewheel", without_egg_link=True, editable=False)
+
+
+@pytest.mark.parametrize(
+    "wheel_name",
+    
+        "brokenwheel-1.0-py2.py3-none-any.whl",
+        "corruptwheel-1.0-py2.py3-none-any.whl",
+    ,
+)
+def test_install_from_broken_wheel(
+    script: PipTestEnvironment, data: TestData, wheel_name: str
+) -> None:
+    """
+    Test that installing a broken wheel fails properly
+    """
+    from tests.lib import TestFailure
+
+    package = data.packages.joinpath(wheel_name)
+    result = script.pip("install", package, "--no-index", expect_error=True)
+    with pytest.raises(TestFailure):
+        result.assert_installed("futurewheel", without_egg_link=True, editable=False)
+
+
+def test_basic_install_from_wheel(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing from a wheel (that has a script)
+    """
+    shutil.copy(shared_data.packages / "has.script-1.0-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "has.script==1.0",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    dist_info_folder = script.site_packages / "has.script-1.0.dist-info"
+    result.did_create(dist_info_folder)
+    script_file = script.bin / "script.py"
+    result.did_create(script_file)
+
+
+def test_basic_install_from_wheel_with_extras(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing from a wheel with extras.
+    """
+    shutil.copy(shared_data.packages / "complex_dist-0.1-py2.py3-none-any.whl", tmpdir)
+    shutil.copy(shared_data.packages / "simple.dist-0.1-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "complex-distsimple",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    dist_info_folder = script.site_packages / "complex_dist-0.1.dist-info"
+    result.did_create(dist_info_folder)
+    dist_info_folder = script.site_packages / "simple.dist-0.1.dist-info"
+    result.did_create(dist_info_folder)
+
+
+def test_basic_install_from_wheel_file(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing directly from a wheel file.
+    """
+    package = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    result = script.pip("install", package, "--no-index")
+    dist_info_folder = script.site_packages / "simple.dist-0.1.dist-info"
+    result.did_create(dist_info_folder)
+    installer = dist_info_folder / "INSTALLER"
+    result.did_create(installer)
+    with open(script.base_path / installer, "rb") as installer_file:
+        installer_details = installer_file.read()
+        assert installer_details == b"pip\n"
+    installer_temp = dist_info_folder / "INSTALLER.pip"
+    result.did_not_create(installer_temp)
+
+
+# Installation seems to work, but scripttest fails to check.
+# I really don't care now since we're desupporting it soon anyway.
+def test_basic_install_from_unicode_wheel(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test installing from a wheel (that has a script)
+    """
+    make_wheel(
+        "unicode_package",
+        "1.0",
+        extra_files={
+            "வணக்கம்/__init__.py": b"",
+            "வணக்கம்/નમસ્તે.py": b"",
+        },
+    ).save_to_dir(script.scratch_path)
+
+    result = script.pip(
+        "install",
+        "unicode_package==1.0",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+    )
+    dist_info_folder = script.site_packages / "unicode_package-1.0.dist-info"
+    result.did_create(dist_info_folder)
+
+    file1 = script.site_packages.joinpath("வணக்கம்", "__init__.py")
+    result.did_create(file1)
+
+    file2 = script.site_packages.joinpath("வணக்கம்", "નમસ્તે.py")
+    result.did_create(file2)
+
+
+def get_header_scheme_path_for_script(
+    script: PipTestEnvironment, dist_name: str
+) -> Path:
+    command = (
+        "from pip._internal.locations import get_scheme;"
+        "scheme = get_scheme({!r});"
+        "print(scheme.headers);"
+    ).format(dist_name)
+    result = script.run("python", "-c", command).stdout
+    return Path(result.strip())
+
+
+def test_install_from_wheel_with_headers(script: PipTestEnvironment) -> None:
+    """
+    Test installing from a wheel file with headers
+    """
+    header_text = "/* hello world */\n"
+    package = make_wheel(
+        "headers.dist",
+        "0.1",
+        extra_data_files={"headers/header.h": header_text},
+    ).save_to_dir(script.scratch_path)
+    result = script.pip("install", package, "--no-index")
+    dist_info_folder = script.site_packages / "headers.dist-0.1.dist-info"
+    result.did_create(dist_info_folder)
+
+    header_scheme_path = get_header_scheme_path_for_script(script, "headers.dist")
+    header_path = header_scheme_path / "header.h"
+    assert header_path.read_text() == header_text
+
+
+def test_install_wheel_with_target(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing a wheel using pip install --target
+    """
+    shutil.copy(shared_data.packages / "simple.dist-0.1-py2.py3-none-any.whl", tmpdir)
+    target_dir = script.scratch_path / "target"
+    result = script.pip(
+        "install",
+        "simple.dist==0.1",
+        "-t",
+        target_dir,
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    result.did_create(Path("scratch") / "target" / "simpledist")
+
+
+def test_install_wheel_with_target_and_data_files(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test for issue #4092. It will be checked that a data_files specification in
+    setup.py is handled correctly when a wheel is installed with the --target
+    option.
+
+    The setup() for the wheel 'prjwithdatafile-1.0-py2.py3-none-any.whl' is as
+    follows ::
+
+        setup(
+            name='prjwithdatafile',
+            version='1.0',
+            packages='prjwithdatafile',
+            data_files=
+                (r'packages1', 'prjwithdatafile/README.txt'),
+                (r'packages2', 'prjwithdatafile/README.txt')
+            
+        )
+    """
+    target_dir = script.scratch_path / "prjwithdatafile"
+    package = data.packages.joinpath("prjwithdatafile-1.0-py2.py3-none-any.whl")
+    result = script.pip("install", package, "-t", target_dir, "--no-index")
+    project_path = Path("scratch") / "prjwithdatafile"
+    result.did_create(project_path / "packages1" / "README.txt")
+    result.did_create(project_path / "packages2" / "README.txt")
+    result.did_not_create(project_path / "lib" / "python")
+
+
+def test_install_wheel_with_root(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing a wheel using pip install --root
+    """
+    root_dir = script.scratch_path / "root"
+    shutil.copy(shared_data.packages / "simple.dist-0.1-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "simple.dist==0.1",
+        "--root",
+        root_dir,
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    result.did_create(Path("scratch") / "root")
+
+
+def test_install_wheel_with_prefix(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing a wheel using pip install --prefix
+    """
+    prefix_dir = script.scratch_path / "prefix"
+    shutil.copy(shared_data.packages / "simple.dist-0.1-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "simple.dist==0.1",
+        "--prefix",
+        prefix_dir,
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    lib = sysconfig.get_path(
+        "purelib", vars={"base": os.path.join("scratch", "prefix")}
+    )
+    result.did_create(lib)
+
+
+def test_install_from_wheel_installs_deps(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test can install dependencies of wheels
+    """
+    # 'requires_source' depends on the 'source' project
+    package = data.packages.joinpath("requires_source-1.0-py2.py3-none-any.whl")
+    shutil.copy(data.packages / "source-1.0.tar.gz", tmpdir)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+        package,
+    )
+    result.assert_installed("source", editable=False)
+
+
+def test_install_from_wheel_no_deps(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test --no-deps works with wheel installs
+    """
+    # 'requires_source' depends on the 'source' project
+    package = data.packages.joinpath("requires_source-1.0-py2.py3-none-any.whl")
+    shutil.copy(data.packages / "source-1.0.tar.gz", tmpdir)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+        "--no-deps",
+        package,
+    )
+    pkg_folder = script.site_packages / "source"
+    result.did_not_create(pkg_folder)
+
+
+def test_wheel_record_lines_in_deterministic_order(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    to_install = data.packages.joinpath("simplewheel-1.0-py2.py3-none-any.whl")
+    result = script.pip("install", to_install)
+
+    dist_info_folder = script.site_packages / "simplewheel-1.0.dist-info"
+    record_path = dist_info_folder / "RECORD"
+
+    result.did_create(dist_info_folder)
+    result.did_create(record_path)
+
+    record_path = result.files_createdrecord_path.full
+    record_lines = p for p in Path(record_path).read_text().split("\n") if p
+    assert record_lines == sorted(record_lines)
+
+
+def test_wheel_record_lines_have_hash_for_data_files(
+    script: PipTestEnvironment,
+) -> None:
+    package = make_wheel(
+        "simple",
+        "0.1.0",
+        extra_data_files={
+            "purelib/info.txt": "c",
+        },
+    ).save_to_dir(script.scratch_path)
+    script.pip("install", package)
+    record_file = script.site_packages_path / "simple-0.1.0.dist-info" / "RECORD"
+    record_text = record_file.read_text()
+    record_rows = list(csv.reader(record_text.splitlines()))
+    records = {r0: r1: for r in record_rows}
+    assert records"info.txt" == 
+        "sha256=Ln0sA6lQeuJl7PW1NWiFpTOTogKdJBOUmXJloaJa78Y",
+        "1",
+    
+
+
+def test_wheel_record_lines_have_updated_hash_for_scripts(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    pip rewrites "#!python" shebang lines in scripts when it installs them;
+    make sure it updates the RECORD file correspondingly.
+    """
+    package = make_wheel(
+        "simple",
+        "0.1.0",
+        extra_data_files={
+            "scripts/dostuff": "#!python\n",
+        },
+    ).save_to_dir(script.scratch_path)
+    script.pip("install", package)
+    record_file = script.site_packages_path / "simple-0.1.0.dist-info" / "RECORD"
+    record_text = record_file.read_text()
+    record_rows = list(csv.reader(record_text.splitlines()))
+    records = {r0: r1: for r in record_rows}
+
+    script_path = script.bin_path / "dostuff"
+    script_contents = script_path.read_bytes()
+    assert not script_contents.startswith(b"#!python\n")
+
+    script_digest = hashlib.sha256(script_contents).digest()
+    script_digest_b64 = (
+        base64.urlsafe_b64encode(script_digest).decode("US-ASCII").rstrip("=")
+    )
+
+    script_record_path = os.path.relpath(
+        script_path, script.site_packages_path
+    ).replace(os.path.sep, "/")
+    assert recordsscript_record_path == 
+        f"sha256={script_digest_b64}",
+        str(len(script_contents)),
+    
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_install_user_wheel(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test user install from wheel (that has a script)
+    """
+    shutil.copy(shared_data.packages / "has.script-1.0-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "has.script==1.0",
+        "--user",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    dist_info_folder = script.user_site / "has.script-1.0.dist-info"
+    result.did_create(dist_info_folder)
+    script_file = script.user_bin / "script.py"
+    result.did_create(script_file)
+
+
+def test_install_from_wheel_gen_entrypoint(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing scripts (entry points are generated)
+    """
+    shutil.copy(
+        shared_data.packages / "script.wheel1a-0.1-py2.py3-none-any.whl",
+        tmpdir,
+    )
+    result = script.pip(
+        "install",
+        "script.wheel1a==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    if os.name == "nt":
+        wrapper_file = script.bin / "t1.exe"
+    else:
+        wrapper_file = script.bin / "t1"
+    result.did_create(wrapper_file)
+
+    if os.name != "nt":
+        assert bool(os.access(script.base_path / wrapper_file, os.X_OK))
+
+
+def test_install_from_wheel_gen_uppercase_entrypoint(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing scripts with uppercase letters in entry point names
+    """
+    shutil.copy(
+        shared_data.packages / "console_scripts_uppercase-1.0-py2.py3-none-any.whl",
+        tmpdir,
+    )
+    result = script.pip(
+        "install",
+        "console-scripts-uppercase==1.0",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    if os.name == "nt":
+        # Case probably doesn't make any difference on NT
+        wrapper_file = script.bin / "cmdName.exe"
+    else:
+        wrapper_file = script.bin / "cmdName"
+    result.did_create(wrapper_file)
+
+    if os.name != "nt":
+        assert bool(os.access(script.base_path / wrapper_file, os.X_OK))
+
+
+def test_install_from_wheel_gen_unicode_entrypoint(script: PipTestEnvironment) -> None:
+    make_wheel(
+        "script_wheel_unicode",
+        "1.0",
+        console_scripts="進入點 = 模組:函式",
+    ).save_to_dir(script.scratch_path)
+
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "script_wheel_unicode",
+    )
+    if os.name == "nt":
+        result.did_create(script.bin.joinpath("進入點.exe"))
+    else:
+        result.did_create(script.bin.joinpath("進入點"))
+
+
+def test_install_from_wheel_with_legacy(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing scripts (legacy scripts are preserved)
+    """
+    shutil.copy(
+        shared_data.packages / "script.wheel2a-0.1-py2.py3-none-any.whl",
+        tmpdir,
+    )
+    result = script.pip(
+        "install",
+        "script.wheel2a==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+
+    legacy_file1 = script.bin / "testscript1.bat"
+    legacy_file2 = script.bin / "testscript2"
+
+    result.did_create(legacy_file1)
+    result.did_create(legacy_file2)
+
+
+def test_install_from_wheel_no_setuptools_entrypoint(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test that when we generate scripts, any existing setuptools wrappers in
+    the wheel are skipped.
+    """
+    shutil.copy(shared_data.packages / "script.wheel1-0.1-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "script.wheel1==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    if os.name == "nt":
+        wrapper_file = script.bin / "t1.exe"
+    else:
+        wrapper_file = script.bin / "t1"
+    wrapper_helper = script.bin / "t1-script.py"
+
+    # The wheel has t1.exe and t1-script.py. We will be generating t1 or
+    # t1.exe depending on the platform. So we check that the correct wrapper
+    # is present and that the -script.py helper has been skipped. We can't
+    # easily test that the wrapper from the wheel has been skipped /
+    # overwritten without getting very platform-dependent, so omit that.
+    result.did_create(wrapper_file)
+    result.did_not_create(wrapper_helper)
+
+
+def test_skipping_setuptools_doesnt_skip_legacy(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing scripts (legacy scripts are preserved even when we skip
+    setuptools wrappers)
+    """
+    shutil.copy(shared_data.packages / "script.wheel2-0.1-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "script.wheel2==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+
+    legacy_file1 = script.bin / "testscript1.bat"
+    legacy_file2 = script.bin / "testscript2"
+    wrapper_helper = script.bin / "t1-script.py"
+
+    result.did_create(legacy_file1)
+    result.did_create(legacy_file2)
+    result.did_not_create(wrapper_helper)
+
+
+def test_install_from_wheel_gui_entrypoint(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing scripts (gui entry points are generated)
+    """
+    shutil.copy(shared_data.packages / "script.wheel3-0.1-py2.py3-none-any.whl", tmpdir)
+    result = script.pip(
+        "install",
+        "script.wheel3==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    if os.name == "nt":
+        wrapper_file = script.bin / "t1.exe"
+    else:
+        wrapper_file = script.bin / "t1"
+    result.did_create(wrapper_file)
+
+
+def test_wheel_compiles_pyc(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing from wheel with --compile on
+    """
+    shutil.copy(shared_data.packages / "simple.dist-0.1-py2.py3-none-any.whl", tmpdir)
+    script.pip(
+        "install",
+        "--compile",
+        "simple.dist==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    # There are many locations for the __init__.pyc file so attempt to find
+    #   any of them
+    exists = 
+        os.path.exists(script.site_packages_path / "simpledist/__init__.pyc"),
+        *script.site_packages_path.glob("simpledist/__pycache__/__init__*.pyc"),
+    
+    assert any(exists)
+
+
+def test_wheel_no_compiles_pyc(
+    script: PipTestEnvironment, shared_data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test installing from wheel with --compile on
+    """
+    shutil.copy(shared_data.packages / "simple.dist-0.1-py2.py3-none-any.whl", tmpdir)
+    script.pip(
+        "install",
+        "--no-compile",
+        "simple.dist==0.1",
+        "--no-index",
+        "--find-links",
+        tmpdir,
+    )
+    # There are many locations for the __init__.pyc file so attempt to find
+    #   any of them
+    exists = 
+        os.path.exists(script.site_packages_path / "simpledist/__init__.pyc"),
+        *script.site_packages_path.glob("simpledist/__pycache__/__init__*.pyc"),
+    
+
+    assert not any(exists)
+
+
+def test_install_from_wheel_uninstalls_old_version(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    # regression test for https://github.com/pypa/pip/issues/1825
+    package = data.packages.joinpath("simplewheel-1.0-py2.py3-none-any.whl")
+    result = script.pip("install", package, "--no-index")
+    package = data.packages.joinpath("simplewheel-2.0-py2.py3-none-any.whl")
+    result = script.pip("install", package, "--no-index")
+    dist_info_folder = script.site_packages / "simplewheel-2.0.dist-info"
+    result.did_create(dist_info_folder)
+    dist_info_folder = script.site_packages / "simplewheel-1.0.dist-info"
+    result.did_not_create(dist_info_folder)
+
+
+def test_wheel_compile_syntax_error(script: PipTestEnvironment, data: TestData) -> None:
+    package = data.packages.joinpath("compilewheel-1.0-py2.py3-none-any.whl")
+    result = script.pip("install", "--compile", package, "--no-index")
+    assert "yield from" not in result.stdout
+    assert "SyntaxError: " not in result.stdout
+
+
+def test_wheel_install_with_no_cache_dir(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Check wheel installations work, even with no cache."""
+    package = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    result = script.pip("install", "--no-cache-dir", "--no-index", package)
+    result.assert_installed("simpledist", editable=False)
+
+
+def test_wheel_install_fails_with_extra_dist_info(script: PipTestEnvironment) -> None:
+    package = create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+        extra_files={
+            "unrelated-2.0.0.dist-info/WHEEL": "Wheel-Version: 1.0",
+            "unrelated-2.0.0.dist-info/METADATA": ("Name: unrelated\nVersion: 2.0.0\n"),
+        },
+    )
+    result = script.pip(
+        "install", "--no-cache-dir", "--no-index", package, expect_error=True
+    )
+    assert "multiple .dist-info directories" in result.stderr
+
+
+def test_wheel_install_fails_with_unrelated_dist_info(
+    script: PipTestEnvironment,
+) -> None:
+    package = create_basic_wheel_for_package(script, "simple", "0.1.0")
+    new_name = "unrelated-2.0.0-py2.py3-none-any.whl"
+    new_package = os.path.join(os.path.dirname(package), new_name)
+    shutil.move(os.fspath(package), new_package)
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        new_package,
+        expect_error=True,
+    )
+
+    assert "'simple-0.1.0.dist-info' does not start with 'unrelated'" in result.stderr
+
+
+def test_wheel_installs_ok_with_nested_dist_info(script: PipTestEnvironment) -> None:
+    package = create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+        extra_files={
+            "subdir/unrelated-2.0.0.dist-info/WHEEL": "Wheel-Version: 1.0",
+            "subdir/unrelated-2.0.0.dist-info/METADATA": (
+                "Name: unrelated\nVersion: 2.0.0\n"
+            ),
+        },
+    )
+    script.pip("install", "--no-cache-dir", "--no-index", package)
+
+
+def test_wheel_installs_ok_with_badly_encoded_irrelevant_dist_info_file(
+    script: PipTestEnvironment,
+) -> None:
+    package = create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+        extra_files={"simple-0.1.0.dist-info/AUTHORS.txt": b"\xff"},
+    )
+    script.pip("install", "--no-cache-dir", "--no-index", package)
+
+
+def test_wheel_install_fails_with_badly_encoded_metadata(
+    script: PipTestEnvironment,
+) -> None:
+    package = create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+        extra_files={"simple-0.1.0.dist-info/METADATA": b"\xff"},
+    )
+    result = script.pip(
+        "install", "--no-cache-dir", "--no-index", package, expect_error=True
+    )
+    assert "Error decoding metadata for" in result.stderr
+    assert "simple-0.1.0-py2.py3-none-any.whl" in result.stderr
+    assert "METADATA" in result.stderr
+
+
+@pytest.mark.parametrize(
+    "package_name",
+    "simple-package", "simple_package",
+)
+def test_correct_package_name_while_creating_wheel_bug(
+    script: PipTestEnvironment, package_name: str
+) -> None:
+    """Check that the package name is correctly named while creating
+    a .whl file with a given format
+    """
+    package = create_basic_wheel_for_package(script, package_name, "1.0")
+    wheel_name = os.path.basename(package)
+    assert wheel_name == "simple_package-1.0-py2.py3-none-any.whl"
+
+
+@pytest.mark.parametrize("name", "purelib", "abc")
+def test_wheel_with_file_in_data_dir_has_reasonable_error(
+    script: PipTestEnvironment, tmpdir: Path, name: str
+) -> None:
+    """Normally we expect entities in the .data directory to be in a
+    subdirectory, but if they are not then we should show a reasonable error
+    message that includes the path.
+    """
+    wheel_path = make_wheel(
+        "simple", "0.1.0", extra_data_files={name: "hello world"}
+    ).save_to_dir(tmpdir)
+
+    result = script.pip("install", "--no-index", str(wheel_path), expect_error=True)
+    assert f"simple-0.1.0.data/{name}" in result.stderr
+
+
+def test_wheel_with_unknown_subdir_in_data_dir_has_reasonable_error(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    wheel_path = make_wheel(
+        "simple", "0.1.0", extra_data_files={"unknown/hello.txt": "hello world"}
+    ).save_to_dir(tmpdir)
+
+    result = script.pip("install", "--no-index", str(wheel_path), expect_error=True)
+    assert "simple-0.1.0.data/unknown/hello.txt" in result.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_list.py Added

@@ -0,0 +1,759 @@
+import json
+import os
+from pathlib import Path
+
+import pytest
+
+from pip._internal.models.direct_url import DirectUrl, DirInfo
+from tests.conftest import ScriptFactory
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    _create_test_package,
+    create_test_package_with_setup,
+    wheel,
+)
+from tests.lib.direct_url import get_created_direct_url_path
+
+
+@pytest.fixture(scope="session")
+def simple_script(
+    tmpdir_factory: pytest.TempPathFactory,
+    script_factory: ScriptFactory,
+    shared_data: TestData,
+) -> PipTestEnvironment:
+    tmpdir = tmpdir_factory.mktemp("pip_test_package")
+    script = script_factory(tmpdir.joinpath("workspace"))
+    script.pip(
+        "install",
+        "-f",
+        shared_data.find_links,
+        "--no-index",
+        "simple==1.0",
+        "simple2==3.0",
+    )
+    return script
+
+
+def test_basic_list(simple_script: PipTestEnvironment) -> None:
+    """
+    Test default behavior of list command without format specifier.
+
+    """
+    result = simple_script.pip("list")
+    assert "simple     1.0" in result.stdout, str(result)
+    assert "simple2    3.0" in result.stdout, str(result)
+
+
+def test_verbose_flag(simple_script: PipTestEnvironment) -> None:
+    """
+    Test the list command with the '-v' option
+    """
+    result = simple_script.pip("list", "-v", "--format=columns")
+    assert "Package" in result.stdout, str(result)
+    assert "Version" in result.stdout, str(result)
+    assert "Location" in result.stdout, str(result)
+    assert "Installer" in result.stdout, str(result)
+    assert "simple     1.0" in result.stdout, str(result)
+    assert "simple2    3.0" in result.stdout, str(result)
+
+
+def test_columns_flag(simple_script: PipTestEnvironment) -> None:
+    """
+    Test the list command with the '--format=columns' option
+    """
+    result = simple_script.pip("list", "--format=columns")
+    assert "Package" in result.stdout, str(result)
+    assert "Version" in result.stdout, str(result)
+    assert "simple (1.0)" not in result.stdout, str(result)
+    assert "simple     1.0" in result.stdout, str(result)
+    assert "simple2    3.0" in result.stdout, str(result)
+
+
+def test_format_priority(simple_script: PipTestEnvironment) -> None:
+    """
+    Test that latest format has priority over previous ones.
+    """
+    result = simple_script.pip(
+        "list", "--format=columns", "--format=freeze", expect_stderr=True
+    )
+    assert "simple==1.0" in result.stdout, str(result)
+    assert "simple2==3.0" in result.stdout, str(result)
+    assert "simple     1.0" not in result.stdout, str(result)
+    assert "simple2    3.0" not in result.stdout, str(result)
+
+    result = simple_script.pip("list", "--format=freeze", "--format=columns")
+    assert "Package" in result.stdout, str(result)
+    assert "Version" in result.stdout, str(result)
+    assert "simple==1.0" not in result.stdout, str(result)
+    assert "simple2==3.0" not in result.stdout, str(result)
+    assert "simple     1.0" in result.stdout, str(result)
+    assert "simple2    3.0" in result.stdout, str(result)
+
+
+def test_local_flag(simple_script: PipTestEnvironment) -> None:
+    """
+    Test the behavior of --local flag in the list command
+
+    """
+    result = simple_script.pip("list", "--local", "--format=json")
+    assert {"name": "simple", "version": "1.0"} in json.loads(result.stdout)
+
+
+def test_local_columns_flag(simple_script: PipTestEnvironment) -> None:
+    """
+    Test the behavior of --local --format=columns flags in the list command
+
+    """
+    result = simple_script.pip("list", "--local", "--format=columns")
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "simple (1.0)" not in result.stdout
+    assert "simple  1.0" in result.stdout, str(result)
+
+
+def test_multiple_exclude_and_normalization(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    req_path = wheel.make_wheel(name="Normalizable_Name", version="1.0").save_to_dir(
+        tmpdir
+    )
+    script.pip("install", "--no-index", req_path)
+    result = script.pip("list")
+    print(result.stdout)
+    assert "Normalizable_Name" in result.stdout
+    assert "pip" in result.stdout
+    result = script.pip("list", "--exclude", "normalizablE-namE", "--exclude", "pIp")
+    assert "Normalizable_Name" not in result.stdout
+    assert "pip" not in result.stdout
+
+
+@pytest.mark.network
+@pytest.mark.usefixtures("enable_user_site")
+def test_user_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test the behavior of --user flag in the list command
+
+    """
+    script.pip("download", "setuptools", "wheel", "-d", data.packages)
+    script.pip("install", "-f", data.find_links, "--no-index", "simple==1.0")
+    script.pip("install", "-f", data.find_links, "--no-index", "--user", "simple2==2.0")
+    result = script.pip("list", "--user", "--format=json")
+    assert {"name": "simple", "version": "1.0"} not in json.loads(result.stdout)
+    assert {"name": "simple2", "version": "2.0"} in json.loads(result.stdout)
+
+
+@pytest.mark.network
+@pytest.mark.usefixtures("enable_user_site")
+def test_user_columns_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test the behavior of --user --format=columns flags in the list command
+
+    """
+    script.pip("download", "setuptools", "wheel", "-d", data.packages)
+    script.pip("install", "-f", data.find_links, "--no-index", "simple==1.0")
+    script.pip("install", "-f", data.find_links, "--no-index", "--user", "simple2==2.0")
+    result = script.pip("list", "--user", "--format=columns")
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "simple2 (2.0)" not in result.stdout
+    assert "simple2 2.0" in result.stdout, str(result)
+
+
+@pytest.mark.network
+def test_uptodate_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test the behavior of --uptodate flag in the list command
+
+    """
+    script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "simple==1.0",
+        "simple2==3.0",
+    )
+    script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git#egg=pip-test-package",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--uptodate",
+        "--format=json",
+    )
+    json_output = json.loads(result.stdout)
+    for item in json_output:
+        if "editable_project_location" in item:
+            item"editable_project_location" = "<location>"
+    assert {"name": "simple", "version": "1.0"} not in json_output  # 3.0 is latest
+    assert {
+        "name": "pip-test-package",
+        "version": "0.1.1",
+        "editable_project_location": "<location>",
+    } in json_output  # editables included
+    assert {"name": "simple2", "version": "3.0"} in json_output
+
+
+@pytest.mark.network
+def test_uptodate_columns_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test the behavior of --uptodate --format=columns flag in the list command
+
+    """
+    script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "simple==1.0",
+        "simple2==3.0",
+    )
+    script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git#egg=pip-test-package",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--uptodate",
+        "--format=columns",
+    )
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "Editable project location" in result.stdout  # editables included
+    assert "pip-test-package (0.1.1," not in result.stdout
+    assert "pip-test-package 0.1.1" in result.stdout, str(result)
+    assert "simple2          3.0" in result.stdout, str(result)
+
+
+@pytest.mark.network
+def test_outdated_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test the behavior of --outdated flag in the list command
+
+    """
+    script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "simple==1.0",
+        "simple2==3.0",
+        "simplewheel==1.0",
+    )
+    script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git@0.1#egg=pip-test-package",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--outdated",
+        "--format=json",
+    )
+    json_output = json.loads(result.stdout)
+    for item in json_output:
+        if "editable_project_location" in item:
+            item"editable_project_location" = "<location>"
+    assert {
+        "name": "simple",
+        "version": "1.0",
+        "latest_version": "3.0",
+        "latest_filetype": "sdist",
+    } in json_output
+    assert (
+        dict(
+            name="simplewheel",
+            version="1.0",
+            latest_version="2.0",
+            latest_filetype="wheel",
+        )
+        in json_output
+    )
+    assert (
+        dict(
+            name="pip-test-package",
+            version="0.1",
+            latest_version="0.1.1",
+            latest_filetype="sdist",
+            editable_project_location="<location>",
+        )
+        in json_output
+    )
+    assert "simple2" not in {p"name" for p in json_output}
+
+
+@pytest.mark.network
+def test_outdated_columns_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test the behavior of --outdated --format=columns flag in the list command
+
+    """
+    script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "simple==1.0",
+        "simple2==3.0",
+        "simplewheel==1.0",
+    )
+    script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git@0.1#egg=pip-test-package",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--outdated",
+        "--format=columns",
+    )
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "Latest" in result.stdout
+    assert "Type" in result.stdout
+    assert "simple (1.0) - Latest: 3.0 sdist" not in result.stdout
+    assert "simplewheel (1.0) - Latest: 2.0 wheel" not in result.stdout
+    assert "simple           1.0     3.0    sdist" in result.stdout, str(result)
+    assert "simplewheel      1.0     2.0    wheel" in result.stdout, str(result)
+    assert "simple2" not in result.stdout, str(result)  # 3.0 is latest
+
+
+@pytest.fixture(scope="session")
+def pip_test_package_script(
+    tmpdir_factory: pytest.TempPathFactory,
+    script_factory: ScriptFactory,
+    shared_data: TestData,
+) -> PipTestEnvironment:
+    tmpdir = tmpdir_factory.mktemp("pip_test_package")
+    script = script_factory(tmpdir.joinpath("workspace"))
+    script.pip("install", "-f", shared_data.find_links, "--no-index", "simple==1.0")
+    script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git#egg=pip-test-package",
+    )
+    return script
+
+
+@pytest.mark.network
+def test_editables_flag(pip_test_package_script: PipTestEnvironment) -> None:
+    """
+    Test the behavior of --editables flag in the list command
+    """
+    result = pip_test_package_script.pip("list", "--editable", "--format=json")
+    result2 = pip_test_package_script.pip("list", "--editable")
+    assert {"name": "simple", "version": "1.0"} not in json.loads(result.stdout)
+    assert os.path.join("src", "pip-test-package") in result2.stdout
+
+
+@pytest.mark.network
+def test_exclude_editable_flag(pip_test_package_script: PipTestEnvironment) -> None:
+    """
+    Test the behavior of --editables flag in the list command
+    """
+    result = pip_test_package_script.pip("list", "--exclude-editable", "--format=json")
+    assert {"name": "simple", "version": "1.0"} in json.loads(result.stdout)
+    assert "pip-test-package" not in {p"name" for p in json.loads(result.stdout)}
+
+
+@pytest.mark.network
+def test_editables_columns_flag(pip_test_package_script: PipTestEnvironment) -> None:
+    """
+    Test the behavior of --editables flag in the list command
+    """
+    result = pip_test_package_script.pip("list", "--editable", "--format=columns")
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "Editable project location" in result.stdout
+    assert os.path.join("src", "pip-test-package") in result.stdout, str(result)
+
+
+@pytest.mark.network
+def test_uptodate_editables_flag(
+    pip_test_package_script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    test the behavior of --editable --uptodate flag in the list command
+    """
+    result = pip_test_package_script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--editable",
+        "--uptodate",
+    )
+    assert "simple" not in result.stdout
+    assert os.path.join("src", "pip-test-package") in result.stdout, str(result)
+
+
+@pytest.mark.network
+def test_uptodate_editables_columns_flag(
+    pip_test_package_script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    test the behavior of --editable --uptodate --format=columns flag in the
+    list command
+    """
+    result = pip_test_package_script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--editable",
+        "--uptodate",
+        "--format=columns",
+    )
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "Editable project location" in result.stdout
+    assert os.path.join("src", "pip-test-package") in result.stdout, str(result)
+
+
+@pytest.mark.network
+def test_outdated_editables_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    test the behavior of --editable --outdated flag in the list command
+    """
+    script.pip("install", "-f", data.find_links, "--no-index", "simple==1.0")
+    result = script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git@0.1#egg=pip-test-package",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--editable",
+        "--outdated",
+    )
+    assert "simple" not in result.stdout
+    assert os.path.join("src", "pip-test-package") in result.stdout
+
+
+@pytest.mark.network
+def test_outdated_editables_columns_flag(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    test the behavior of --editable --outdated flag in the list command
+    """
+    script.pip("install", "-f", data.find_links, "--no-index", "simple==1.0")
+    result = script.pip(
+        "install",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package.git@0.1#egg=pip-test-package",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--editable",
+        "--outdated",
+        "--format=columns",
+    )
+    assert "Package" in result.stdout
+    assert "Version" in result.stdout
+    assert "Editable project location" in result.stdout
+    assert os.path.join("src", "pip-test-package") in result.stdout, str(result)
+
+
+def test_outdated_not_required_flag(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    test the behavior of --outdated --not-required flag in the list command
+    """
+    script.pip(
+        "install",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "simple==2.0",
+        "require_simple==1.0",
+    )
+    result = script.pip(
+        "list",
+        "-f",
+        data.find_links,
+        "--no-index",
+        "--outdated",
+        "--not-required",
+        "--format=json",
+    )
+    assert  == json.loads(result.stdout)
+
+
+def test_outdated_pre(script: PipTestEnvironment, data: TestData) -> None:
+    script.pip("install", "-f", data.find_links, "--no-index", "simple==1.0")
+
+    # Let's build a fake wheelhouse
+    script.scratch_path.joinpath("wheelhouse").mkdir()
+    wheelhouse_path = script.scratch_path / "wheelhouse"
+    wheelhouse_path.joinpath("simple-1.1-py2.py3-none-any.whl").write_text("")
+    wheelhouse_path.joinpath("simple-2.0.dev0-py2.py3-none-any.whl").write_text("")
+    result = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--format=json",
+    )
+    assert {"name": "simple", "version": "1.0"} in json.loads(result.stdout)
+    result = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--outdated",
+        "--format=json",
+    )
+    assert {
+        "name": "simple",
+        "version": "1.0",
+        "latest_version": "1.1",
+        "latest_filetype": "wheel",
+    } in json.loads(result.stdout)
+    result_pre = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--outdated",
+        "--pre",
+        "--format=json",
+    )
+    assert {
+        "name": "simple",
+        "version": "1.0",
+        "latest_version": "2.0.dev0",
+        "latest_filetype": "wheel",
+    } in json.loads(result_pre.stdout)
+
+
+def test_outdated_formats(script: PipTestEnvironment, data: TestData) -> None:
+    """Test of different outdated formats"""
+    script.pip("install", "-f", data.find_links, "--no-index", "simple==1.0")
+
+    # Let's build a fake wheelhouse
+    script.scratch_path.joinpath("wheelhouse").mkdir()
+    wheelhouse_path = script.scratch_path / "wheelhouse"
+    wheelhouse_path.joinpath("simple-1.1-py2.py3-none-any.whl").write_text("")
+    result = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--format=freeze",
+    )
+    assert "simple==1.0" in result.stdout
+
+    # Check columns
+    result = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--outdated",
+        "--format=columns",
+    )
+    assert "Package Version Latest Type" in result.stdout
+    assert "simple  1.0     1.1    wheel" in result.stdout
+
+    # Check that freeze is not allowed
+    result = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--outdated",
+        "--format=freeze",
+        expect_error=True,
+    )
+    assert (
+        "List format 'freeze' can not be used with the --outdated option."
+        in result.stderr
+    )
+
+    # Check json
+    result = script.pip(
+        "list",
+        "--no-index",
+        "--find-links",
+        wheelhouse_path,
+        "--outdated",
+        "--format=json",
+    )
+    data = json.loads(result.stdout)
+    assert data == 
+        {
+            "name": "simple",
+            "version": "1.0",
+            "latest_version": "1.1",
+            "latest_filetype": "wheel",
+        }
+    
+
+
+def test_not_required_flag(script: PipTestEnvironment, data: TestData) -> None:
+    script.pip("install", "-f", data.find_links, "--no-index", "TopoRequires4")
+    result = script.pip("list", "--not-required", expect_stderr=True)
+    assert "TopoRequires4 " in result.stdout, str(result)
+    assert "TopoRequires " not in result.stdout
+    assert "TopoRequires2 " not in result.stdout
+    assert "TopoRequires3 " not in result.stdout
+
+
+def test_list_freeze(simple_script: PipTestEnvironment) -> None:
+    """
+    Test freeze formatting of list command
+
+    """
+    result = simple_script.pip("list", "--format=freeze")
+    assert "simple==1.0" in result.stdout, str(result)
+    assert "simple2==3.0" in result.stdout, str(result)
+
+
+def test_list_json(simple_script: PipTestEnvironment) -> None:
+    """
+    Test json formatting of list command
+
+    """
+    result = simple_script.pip("list", "--format=json")
+    data = json.loads(result.stdout)
+    assert {"name": "simple", "version": "1.0"} in data
+    assert {"name": "simple2", "version": "3.0"} in data
+
+
+def test_list_path(tmpdir: Path, script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test list with --path.
+    """
+    result = script.pip("list", "--path", tmpdir, "--format=json")
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "2.0"} not in json_result
+
+    script.pip_install_local("--target", tmpdir, "simple==2.0")
+    result = script.pip("list", "--path", tmpdir, "--format=json")
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "2.0"} in json_result
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_list_path_exclude_user(
+    tmpdir: Path, script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test list with --path and make sure packages from --user are not picked
+    up.
+    """
+    script.pip_install_local("--user", "simple2")
+    script.pip_install_local("--target", tmpdir, "simple==1.0")
+
+    result = script.pip("list", "--user", "--format=json")
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple2", "version": "3.0"} in json_result
+
+    result = script.pip("list", "--path", tmpdir, "--format=json")
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "1.0"} in json_result
+
+
+def test_list_path_multiple(
+    tmpdir: Path, script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test list with multiple --path arguments.
+    """
+    path1 = tmpdir / "path1"
+    os.mkdir(path1)
+    path2 = tmpdir / "path2"
+    os.mkdir(path2)
+
+    script.pip_install_local("--target", path1, "simple==2.0")
+    script.pip_install_local("--target", path2, "simple2==3.0")
+
+    result = script.pip("list", "--path", path1, "--format=json")
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "2.0"} in json_result
+
+    result = script.pip("list", "--path", path1, "--path", path2, "--format=json")
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "2.0"} in json_result
+    assert {"name": "simple2", "version": "3.0"} in json_result
+
+
+def test_list_skip_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that list should not include package in working directory
+    """
+
+    # Create a test package and create .egg-info dir
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    # List should not include package simple when run from package directory
+    result = script.pip("list", "--format=json", cwd=pkg_path)
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "1.0"} not in json_result
+
+
+def test_list_include_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that list should include package in working directory
+    if working directory is added in PYTHONPATH
+    """
+
+    # Create a test package and create .egg-info dir
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    script.environ.update({"PYTHONPATH": pkg_path})
+
+    # List should include package simple when run from package directory
+    # when the package directory is in PYTHONPATH
+    result = script.pip("list", "--format=json", cwd=pkg_path)
+    json_result = json.loads(result.stdout)
+    assert {"name": "simple", "version": "1.0"} in json_result
+
+
+def test_list_pep610_editable(script: PipTestEnvironment) -> None:
+    """
+    Test that a package installed with a direct_url.json with editable=true
+    is correctly listed as editable.
+    """
+    pkg_path = _create_test_package(script.scratch_path, name="testpkg")
+    result = script.pip("install", pkg_path)
+    direct_url_path = get_created_direct_url_path(result, "testpkg")
+    assert direct_url_path
+    # patch direct_url.json to simulate an editable install
+    with open(direct_url_path) as f:
+        direct_url = DirectUrl.from_json(f.read())
+    assert isinstance(direct_url.info, DirInfo)
+    direct_url.info.editable = True
+    with open(direct_url_path, "w") as f:
+        f.write(direct_url.to_json())
+    result = script.pip("list", "--format=json")
+    for item in json.loads(result.stdout):
+        if item"name" == "testpkg":
+            assert item"editable_project_location"
+            break
+    else:
+        assert False, "package 'testpkg' not found in pip list result"

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_new_resolver.py Added

@@ -0,0 +1,2349 @@
+import os
+import pathlib
+import sys
+import textwrap
+from typing import TYPE_CHECKING, Callable, Dict, List, Tuple
+
+import pytest
+
+from tests.lib import (
+    PipTestEnvironment,
+    create_basic_sdist_for_package,
+    create_basic_wheel_for_package,
+    create_test_package_with_setup,
+)
+from tests.lib.direct_url import get_created_direct_url
+from tests.lib.wheel import make_wheel
+
+if TYPE_CHECKING:
+    from typing import Protocol
+
+MakeFakeWheel = Callablestr, str, str, pathlib.Path
+
+
+def assert_editable(script: PipTestEnvironment, *args: str) -> None:
+    # This simply checks whether all of the listed packages have a
+    # corresponding .egg-link file installed.
+    # TODO: Implement a more rigorous way to test for editable installations.
+    egg_links = {f"{arg}.egg-link" for arg in args}
+    assert egg_links <= set(
+        os.listdir(script.site_packages_path)
+    ), f"{args!r} not all found in {script.site_packages_path!r}"
+
+
+@pytest.fixture()
+def make_fake_wheel(script: PipTestEnvironment) -> MakeFakeWheel:
+    def _make_fake_wheel(name: str, version: str, wheel_tag: str) -> pathlib.Path:
+        wheel_house = script.scratch_path.joinpath("wheelhouse")
+        wheel_house.mkdir()
+        wheel_builder = make_wheel(
+            name=name,
+            version=version,
+            wheel_metadata_updates={"Tag": },
+        )
+        wheel_path = wheel_house.joinpath(f"{name}-{version}-{wheel_tag}.whl")
+        wheel_builder.save_to(wheel_path)
+        return wheel_path
+
+    return _make_fake_wheel
+
+
+def test_new_resolver_can_install(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple",
+    )
+    script.assert_installed(simple="0.1.0")
+
+
+def test_new_resolver_can_install_with_version(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple==0.1.0",
+    )
+    script.assert_installed(simple="0.1.0")
+
+
+def test_new_resolver_picks_latest_version(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.2.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple",
+    )
+    script.assert_installed(simple="0.2.0")
+
+
+def test_new_resolver_picks_installed_version(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.2.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple==0.1.0",
+    )
+    script.assert_installed(simple="0.1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple",
+    )
+    assert "Collecting" not in result.stdout, "Should not fetch new version"
+    script.assert_installed(simple="0.1.0")
+
+
+def test_new_resolver_picks_installed_version_if_no_match_found(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.1.0",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "simple",
+        "0.2.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple==0.1.0",
+    )
+    script.assert_installed(simple="0.1.0")
+
+    result = script.pip("install", "--no-cache-dir", "--no-index", "simple")
+    assert "Collecting" not in result.stdout, "Should not fetch new version"
+    script.assert_installed(simple="0.1.0")
+
+
+def test_new_resolver_installs_dependencies(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+    script.assert_installed(base="0.1.0", dep="0.1.0")
+
+
+def test_new_resolver_ignore_dependencies(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--no-deps",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+    script.assert_installed(base="0.1.0")
+    script.assert_not_installed("dep")
+
+
+@pytest.mark.parametrize(
+    "root_dep",
+    
+        "baseadd",
+        "baseadd >= 0.1.0",
+    ,
+)
+def test_new_resolver_installs_extras(
+    tmpdir: pathlib.Path, script: PipTestEnvironment, root_dep: str
+) -> None:
+    req_file = tmpdir.joinpath("requirements.txt")
+    req_file.write_text(root_dep)
+
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        extras={"add": "dep"},
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-r",
+        req_file,
+    )
+    script.assert_installed(base="0.1.0", dep="0.1.0")
+
+
+def test_new_resolver_installs_extras_warn_missing(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        extras={"add": "dep"},
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "baseadd,missing",
+        expect_stderr=True,
+    )
+    assert "does not provide the extra" in result.stderr, str(result)
+    assert "missing" in result.stderr, str(result)
+    script.assert_installed(base="0.1.0", dep="0.1.0")
+
+
+def test_new_resolver_installed_message(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "A", "1.0")
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "A",
+        expect_stderr=False,
+    )
+    assert "Successfully installed A-1.0" in result.stdout, str(result)
+
+
+def test_new_resolver_no_dist_message(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "A", "1.0")
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "B",
+        expect_error=True,
+        expect_stderr=True,
+    )
+
+    # Full messages from old resolver:
+    # ERROR: Could not find a version that satisfies the
+    #        requirement xxx (from versions: none)
+    # ERROR: No matching distribution found for xxx
+
+    assert (
+        "Could not find a version that satisfies the requirement B" in result.stderr
+    ), str(result)
+    assert "No matching distribution found for B" in result.stderr, str(result)
+
+
+def test_new_resolver_installs_editable(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    source_dir = create_test_package_with_setup(
+        script,
+        name="dep",
+        version="0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+        "--editable",
+        source_dir,
+    )
+    script.assert_installed(base="0.1.0", dep="0.1.0")
+    assert_editable(script, "dep")
+
+
+@pytest.mark.parametrize(
+    "requires_python, ignore_requires_python, dep_version",
+    
+        # Something impossible to satisfy.
+        ("<2", False, "0.1.0"),
+        ("<2", True, "0.2.0"),
+        # Something guaranteed to satisfy.
+        (">=2", False, "0.2.0"),
+        (">=2", True, "0.2.0"),
+    ,
+)
+def test_new_resolver_requires_python(
+    script: PipTestEnvironment,
+    requires_python: str,
+    ignore_requires_python: bool,
+    dep_version: str,
+) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.2.0",
+        requires_python=requires_python,
+    )
+
+    args = 
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        os.fspath(script.scratch_path),
+    
+    if ignore_requires_python:
+        args.append("--ignore-requires-python")
+    args.append("base")
+
+    script.pip(*args)
+
+    script.assert_installed(base="0.1.0", dep=dep_version)
+
+
+def test_new_resolver_requires_python_error(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        requires_python="<2",
+    )
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+        expect_error=True,
+    )
+
+    message = (
+        "Package 'base' requires a different Python: "
+        "{}.{}.{} not in '<2'".format(*sys.version_info:3)
+    )
+    assert message in result.stderr, str(result)
+
+
+def test_new_resolver_installed(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+    assert "Requirement already satisfied" not in result.stdout, str(result)
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base~=0.1.0",
+    )
+    assert "Requirement already satisfied: base~=0.1.0" in result.stdout, str(result)
+    result.did_not_update(
+        script.site_packages / "base", message="base 0.1.0 reinstalled"
+    )
+
+
+def test_new_resolver_ignore_installed(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+    )
+    satisfied_output = "Requirement already satisfied"
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+    assert satisfied_output not in result.stdout, str(result)
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--ignore-installed",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+    assert satisfied_output not in result.stdout, str(result)
+    result.did_update(
+        script.site_packages / "base", message="base 0.1.0 not reinstalled"
+    )
+
+
+def test_new_resolver_only_builds_sdists_when_needed(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+    )
+    create_basic_sdist_for_package(
+        script,
+        "dep",
+        "0.1.0",
+        # Replace setup.py with something that fails
+        extra_files={"setup.py": "assert False"},
+    )
+    create_basic_sdist_for_package(
+        script,
+        "dep",
+        "0.2.0",
+    )
+    # We only ever need to check dep 0.2.0 as it's the latest version
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+    script.assert_installed(base="0.1.0", dep="0.2.0")
+
+    # We merge criteria here, as we have two "dep" requirements
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+        "dep",
+    )
+    script.assert_installed(base="0.1.0", dep="0.2.0")
+
+
+def test_new_resolver_install_different_version(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "base", "0.1.0")
+    create_basic_wheel_for_package(script, "base", "0.2.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==0.1.0",
+    )
+
+    # This should trigger an uninstallation of base.
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==0.2.0",
+    )
+
+    assert "Uninstalling base-0.1.0" in result.stdout, str(result)
+    assert "Successfully uninstalled base-0.1.0" in result.stdout, str(result)
+    result.did_update(script.site_packages / "base", message="base not upgraded")
+    script.assert_installed(base="0.2.0")
+
+
+def test_new_resolver_force_reinstall(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "base", "0.1.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==0.1.0",
+    )
+
+    # This should trigger an uninstallation of base due to --force-reinstall,
+    # even though the installed version matches.
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--force-reinstall",
+        "base==0.1.0",
+    )
+
+    assert "Uninstalling base-0.1.0" in result.stdout, str(result)
+    assert "Successfully uninstalled base-0.1.0" in result.stdout, str(result)
+    result.did_update(script.site_packages / "base", message="base not reinstalled")
+    script.assert_installed(base="0.1.0")
+
+
+@pytest.mark.parametrize(
+    "available_versions, pip_args, expected_version",
+    
+        # Choose the latest non-prerelease by default.
+        ("1.0", "2.0a1", "pkg", "1.0"),
+        # Choose the prerelease if the specifier spells out a prerelease.
+        ("1.0", "2.0a1", "pkg==2.0a1", "2.0a1"),
+        # Choose the prerelease if explicitly allowed by the user.
+        ("1.0", "2.0a1", "pkg", "--pre", "2.0a1"),
+        # Choose the prerelease if no stable releases are available.
+        ("2.0a1", "pkg", "2.0a1"),
+    ,
+    ids="default", "exact-pre", "explicit-pre", "no-stable",
+)
+def test_new_resolver_handles_prerelease(
+    script: PipTestEnvironment,
+    available_versions: Liststr,
+    pip_args: Liststr,
+    expected_version: str,
+) -> None:
+    for version in available_versions:
+        create_basic_wheel_for_package(script, "pkg", version)
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        *pip_args,
+    )
+    script.assert_installed(pkg=expected_version)
+
+
+@pytest.mark.parametrize(
+    "pkg_deps, root_deps",
+    
+        # This tests the marker is picked up from a transitive dependency.
+        ("dep; os_name == 'nonexist_os'", "pkg"),
+        # This tests the marker is picked up from a root dependency.
+        (, "pkg", "dep; os_name == 'nonexist_os'"),
+    ,
+)
+def test_new_resolver_skips_marker(
+    script: PipTestEnvironment, pkg_deps: Liststr, root_deps: Liststr
+) -> None:
+    create_basic_wheel_for_package(script, "pkg", "1.0", depends=pkg_deps)
+    create_basic_wheel_for_package(script, "dep", "1.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        *root_deps,
+    )
+    script.assert_installed(pkg="1.0")
+    script.assert_not_installed("dep")
+
+
+@pytest.mark.parametrize(
+    "constraints",
+    
+        "pkg<2.0", "constraint_only<1.0",
+        # This also tests the pkg constraint don't get merged with the
+        # requirement prematurely. (pypa/pip#8134)
+        "pkg<2.0",
+    ,
+)
+def test_new_resolver_constraints(
+    script: PipTestEnvironment, constraints: Liststr
+) -> None:
+    create_basic_wheel_for_package(script, "pkg", "1.0")
+    create_basic_wheel_for_package(script, "pkg", "2.0")
+    create_basic_wheel_for_package(script, "pkg", "3.0")
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("\n".join(constraints))
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "pkg",
+    )
+    script.assert_installed(pkg="1.0")
+    script.assert_not_installed("constraint_only")
+
+
+def test_new_resolver_constraint_no_specifier(script: PipTestEnvironment) -> None:
+    "It's allowed (but useless...) for a constraint to have no specifier"
+    create_basic_wheel_for_package(script, "pkg", "1.0")
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("pkg")
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "pkg",
+    )
+    script.assert_installed(pkg="1.0")
+
+
+@pytest.mark.parametrize(
+    "constraint, error",
+    
+        (
+            "dist.zip",
+            "Unnamed requirements are not allowed as constraints",
+        ),
+        (
+            "-e git+https://example.com/dist.git#egg=req",
+            "Editable requirements are not allowed as constraints",
+        ),
+        (
+            "pkgextra",
+            "Constraints cannot have extras",
+        ),
+    ,
+)
+def test_new_resolver_constraint_reject_invalid(
+    script: PipTestEnvironment, constraint: str, error: str
+) -> None:
+    create_basic_wheel_for_package(script, "pkg", "1.0")
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(constraint)
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "pkg",
+        expect_error=True,
+        expect_stderr=True,
+    )
+    assert error in result.stderr, str(result)
+
+
+def test_new_resolver_constraint_on_dependency(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "base", "1.0", depends="dep")
+    create_basic_wheel_for_package(script, "dep", "1.0")
+    create_basic_wheel_for_package(script, "dep", "2.0")
+    create_basic_wheel_for_package(script, "dep", "3.0")
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("dep==2.0")
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "base",
+    )
+    script.assert_installed(base="1.0")
+    script.assert_installed(dep="2.0")
+
+
+@pytest.mark.parametrize(
+    "constraint_version, expect_error, message",
+    
+        ("1.0", True, "Cannot install foo 2.0"),
+        ("2.0", False, "Successfully installed foo-2.0"),
+    ,
+)
+def test_new_resolver_constraint_on_path_empty(
+    script: PipTestEnvironment,
+    constraint_version: str,
+    expect_error: bool,
+    message: str,
+) -> None:
+    """A path requirement can be filtered by a constraint."""
+    setup_py = script.scratch_path / "setup.py"
+    text = "from setuptools import setup\nsetup(name='foo', version='2.0')"
+    setup_py.write_text(text)
+
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraints_txt.write_text(f"foo=={constraint_version}")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_txt,
+        str(script.scratch_path),
+        expect_error=expect_error,
+    )
+
+    if expect_error:
+        assert message in result.stderr, str(result)
+    else:
+        assert message in result.stdout, str(result)
+
+
+def test_new_resolver_constraint_only_marker_match(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "pkg", "1.0")
+    create_basic_wheel_for_package(script, "pkg", "2.0")
+    create_basic_wheel_for_package(script, "pkg", "3.0")
+
+    constraints_content = textwrap.dedent(
+        """
+        pkg==1.0; python_version == "{ver0}.{ver1}"  # Always satisfies.
+        pkg==2.0; python_version < "0"  # Never satisfies.
+        """
+    ).format(ver=sys.version_info)
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraints_txt.write_text(constraints_content)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_txt,
+        "--find-links",
+        script.scratch_path,
+        "pkg",
+    )
+    script.assert_installed(pkg="1.0")
+
+
+def test_new_resolver_upgrade_needs_option(script: PipTestEnvironment) -> None:
+    # Install pkg 1.0.0
+    create_basic_wheel_for_package(script, "pkg", "1.0.0")
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg",
+    )
+
+    # Now release a new version
+    create_basic_wheel_for_package(script, "pkg", "2.0.0")
+
+    # This should not upgrade because we don't specify --upgrade
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg",
+    )
+
+    assert "Requirement already satisfied" in result.stdout, str(result)
+    script.assert_installed(pkg="1.0.0")
+
+    # This should upgrade
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "PKG",  # Deliberately uppercase to check canonicalization
+    )
+
+    assert "Uninstalling pkg-1.0.0" in result.stdout, str(result)
+    assert "Successfully uninstalled pkg-1.0.0" in result.stdout, str(result)
+    result.did_update(script.site_packages / "pkg", message="pkg not upgraded")
+    script.assert_installed(pkg="2.0.0")
+
+
+def test_new_resolver_upgrade_strategy(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "base", "1.0.0", depends="dep")
+    create_basic_wheel_for_package(script, "dep", "1.0.0")
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base",
+    )
+
+    script.assert_installed(base="1.0.0")
+    script.assert_installed(dep="1.0.0")
+
+    # Now release new versions
+    create_basic_wheel_for_package(script, "base", "2.0.0", depends="dep")
+    create_basic_wheel_for_package(script, "dep", "2.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "base",
+    )
+
+    # With upgrade strategy "only-if-needed" (the default), dep should not
+    # be upgraded.
+    script.assert_installed(base="2.0.0")
+    script.assert_installed(dep="1.0.0")
+
+    create_basic_wheel_for_package(script, "base", "3.0.0", depends="dep")
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "--upgrade-strategy=eager",
+        "base",
+    )
+
+    # With upgrade strategy "eager", dep should be upgraded.
+    script.assert_installed(base="3.0.0")
+    script.assert_installed(dep="2.0.0")
+
+
+if TYPE_CHECKING:
+
+    class PackageBuilder(Protocol):
+        def __call__(
+            self,
+            script: PipTestEnvironment,
+            name: str,
+            version: str,
+            requires: Liststr,
+            extras: Dictstr, Liststr,
+        ) -> str:
+            ...
+
+
+def _local_with_setup(
+    script: PipTestEnvironment,
+    name: str,
+    version: str,
+    requires: Liststr,
+    extras: Dictstr, Liststr,
+) -> str:
+    """Create the package as a local source directory to install from path."""
+    path = create_test_package_with_setup(
+        script,
+        name=name,
+        version=version,
+        install_requires=requires,
+        extras_require=extras,
+    )
+    return str(path)
+
+
+def _direct_wheel(
+    script: PipTestEnvironment,
+    name: str,
+    version: str,
+    requires: Liststr,
+    extras: Dictstr, Liststr,
+) -> str:
+    """Create the package as a wheel to install from path directly."""
+    path = create_basic_wheel_for_package(
+        script,
+        name=name,
+        version=version,
+        depends=requires,
+        extras=extras,
+    )
+    return str(path)
+
+
+def _wheel_from_index(
+    script: PipTestEnvironment,
+    name: str,
+    version: str,
+    requires: Liststr,
+    extras: Dictstr, Liststr,
+) -> str:
+    """Create the package as a wheel to install from index."""
+    create_basic_wheel_for_package(
+        script,
+        name=name,
+        version=version,
+        depends=requires,
+        extras=extras,
+    )
+    return name
+
+
+class TestExtraMerge:
+    """
+    Test installing a package that depends the same package with different
+    extras, one listed as required and the other as in extra.
+    """
+
+    @pytest.mark.parametrize(
+        "pkg_builder",
+        
+            _local_with_setup,
+            _direct_wheel,
+            _wheel_from_index,
+        ,
+    )
+    def test_new_resolver_extra_merge_in_package(
+        self, script: PipTestEnvironment, pkg_builder: "PackageBuilder"
+    ) -> None:
+        create_basic_wheel_for_package(script, "depdev", "1.0.0")
+        create_basic_wheel_for_package(
+            script,
+            "dep",
+            "1.0.0",
+            extras={"dev": "depdev"},
+        )
+        requirement = pkg_builder(
+            script,
+            name="pkg",
+            version="1.0.0",
+            requires="dep",
+            extras={"dev": "depdev"},
+        )
+
+        script.pip(
+            "install",
+            "--no-cache-dir",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            requirement + "dev",
+        )
+        script.assert_installed(pkg="1.0.0", dep="1.0.0", depdev="1.0.0")
+
+
+def test_new_resolver_build_directory_error_zazo_19(script: PipTestEnvironment) -> None:
+    """https://github.com/pradyunsg/zazo/issues/19#issuecomment-631615674
+
+    This will first resolve like this:
+
+    1. Pin pkg-b==2.0.0 (since pkg-b has fewer choices)
+    2. Pin pkg-a==3.0.0 -> Conflict due to dependency pkg-b<2
+    3. Pin pkg-b==1.0.0
+
+    Since pkg-b is only available as sdist, both the first and third steps
+    would trigger building from source. This ensures the preparer can build
+    different versions of a package for the resolver.
+
+    The preparer would fail with the following message if the different
+    versions end up using the same build directory::
+
+        ERROR: pip can't proceed with requirements 'pkg-b ...' due to a
+        pre-existing build directory (...). This is likely due to a previous
+        installation that failed. pip is being responsible and not assuming it
+        can delete this. Please delete it and try again.
+    """
+    create_basic_wheel_for_package(
+        script,
+        "pkg_a",
+        "3.0.0",
+        depends="pkg-b<2",
+    )
+    create_basic_wheel_for_package(script, "pkg_a", "2.0.0")
+    create_basic_wheel_for_package(script, "pkg_a", "1.0.0")
+
+    create_basic_sdist_for_package(script, "pkg_b", "2.0.0")
+    create_basic_sdist_for_package(script, "pkg_b", "1.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg-a",
+        "pkg-b",
+    )
+    script.assert_installed(pkg_a="3.0.0", pkg_b="1.0.0")
+
+
+def test_new_resolver_upgrade_same_version(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "pkg", "2")
+    create_basic_wheel_for_package(script, "pkg", "1")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg",
+    )
+    script.assert_installed(pkg="2")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "pkg",
+    )
+    script.assert_installed(pkg="2")
+
+
+def test_new_resolver_local_and_req(script: PipTestEnvironment) -> None:
+    source_dir = create_test_package_with_setup(
+        script,
+        name="pkg",
+        version="0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        source_dir,
+        "pkg!=0.1.0",
+        expect_error=True,
+    )
+
+
+def test_new_resolver_no_deps_checks_requires_python(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(
+        script,
+        "base",
+        "0.1.0",
+        depends="dep",
+        requires_python="<2",  # Something that always fails.
+    )
+    create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.2.0",
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--no-deps",
+        "--find-links",
+        script.scratch_path,
+        "base",
+        expect_error=True,
+    )
+
+    message = (
+        "Package 'base' requires a different Python: "
+        "{}.{}.{} not in '<2'".format(*sys.version_info:3)
+    )
+    assert message in result.stderr
+
+
+def test_new_resolver_prefers_installed_in_upgrade_if_latest(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(script, "pkg", "1")
+    local_pkg = create_test_package_with_setup(script, name="pkg", version="2")
+
+    # Install the version that's not on the index.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        local_pkg,
+    )
+
+    # Now --upgrade should still pick the local version because it's "better".
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "pkg",
+    )
+    script.assert_installed(pkg="2")
+
+
+@pytest.mark.parametrize("N", 2, 10, 20)
+def test_new_resolver_presents_messages_when_backtracking_a_lot(
+    script: PipTestEnvironment, N: int
+) -> None:
+    # Generate a set of wheels that will definitely cause backtracking.
+    for index in range(1, N + 1):
+        A_version = f"{index}.0.0"
+        B_version = f"{index}.0.0"
+        C_version = "{index_minus_one}.0.0".format(index_minus_one=index - 1)
+
+        depends = "B == " + B_version
+        if index != 1:
+            depends.append("C == " + C_version)
+
+        print("A", A_version, "B", B_version, "C", C_version)
+        create_basic_wheel_for_package(script, "A", A_version, depends=depends)
+
+    for index in range(1, N + 1):
+        B_version = f"{index}.0.0"
+        C_version = f"{index}.0.0"
+        depends = "C == " + C_version
+
+        print("B", B_version, "C", C_version)
+        create_basic_wheel_for_package(script, "B", B_version, depends=depends)
+
+    for index in range(1, N + 1):
+        C_version = f"{index}.0.0"
+        print("C", C_version)
+        create_basic_wheel_for_package(script, "C", C_version)
+
+    # Install A
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "A",
+    )
+
+    script.assert_installed(A="1.0.0", B="1.0.0", C="1.0.0")
+    # These numbers are hard-coded in the code.
+    if N >= 1:
+        assert "This could take a while." in result.stdout
+    if N >= 8:
+        assert result.stdout.count("This could take a while.") >= 2
+    if N >= 13:
+        assert "press Ctrl + C" in result.stdout
+
+
+@pytest.mark.parametrize(
+    "metadata_version",
+    
+        "0.1.0+local.1",  # Normalized form.
+        "0.1.0+local_1",  # Non-normalized form containing an underscore.
+        # Non-normalized form containing a dash. This is allowed, installation
+        # works correctly, but assert_installed() fails because pkg_resources
+        # cannot handle it correctly. Nobody is complaining about it right now,
+        # we're probably dropping it for importlib.metadata soon(tm), so let's
+        # ignore it for the time being.
+        pytest.param("0.1.0+local-1", marks=pytest.mark.xfail(strict=False)),
+    ,
+    ids="meta_dot", "meta_underscore", "meta_dash",
+)
+@pytest.mark.parametrize(
+    "filename_version",
+    
+        ("0.1.0+local.1"),  # Tools are encouraged to use this.
+        ("0.1.0+local_1"),  # But this is allowed (version not normalized).
+    ,
+    ids="file_dot", "file_underscore",
+)
+def test_new_resolver_check_wheel_version_normalized(
+    script: PipTestEnvironment,
+    metadata_version: str,
+    filename_version: str,
+) -> None:
+    filename = f"simple-{filename_version}-py2.py3-none-any.whl"
+
+    wheel_builder = make_wheel(name="simple", version=metadata_version)
+    wheel_builder.save_to(script.scratch_path / filename)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple",
+    )
+    script.assert_installed(simple="0.1.0+local.1")
+
+
+def test_new_resolver_does_reinstall_local_sdists(script: PipTestEnvironment) -> None:
+    archive_path = create_basic_sdist_for_package(
+        script,
+        "pkg",
+        "1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        archive_path,
+    )
+    script.assert_installed(pkg="1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        archive_path,
+        expect_stderr=True,
+    )
+    assert "Installing collected packages: pkg" in result.stdout, str(result)
+    script.assert_installed(pkg="1.0")
+
+
+def test_new_resolver_does_reinstall_local_paths(script: PipTestEnvironment) -> None:
+    pkg = create_test_package_with_setup(script, name="pkg", version="1.0")
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        pkg,
+    )
+    script.assert_installed(pkg="1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        pkg,
+    )
+    assert "Installing collected packages: pkg" in result.stdout, str(result)
+    script.assert_installed(pkg="1.0")
+
+
+def test_new_resolver_does_not_reinstall_when_from_a_local_index(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_sdist_for_package(
+        script,
+        "simple",
+        "0.1.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple",
+    )
+    script.assert_installed(simple="0.1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "simple",
+    )
+    # Should not reinstall!
+    assert "Installing collected packages: simple" not in result.stdout, str(result)
+    assert "Requirement already satisfied: simple" in result.stdout, str(result)
+    script.assert_installed(simple="0.1.0")
+
+
+def test_new_resolver_skip_inconsistent_metadata(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "A", "1")
+
+    a_2 = create_basic_wheel_for_package(script, "A", "2")
+    a_2.rename(a_2.parent.joinpath("a-3-py2.py3-none-any.whl"))
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--verbose",
+        "A",
+        allow_stderr_warning=True,
+    )
+
+    assert (
+        " inconsistent version: expected '3', but metadata has '2'"
+    ) in result.stdout, str(result)
+    script.assert_installed(a="1")
+
+
+@pytest.mark.parametrize(
+    "upgrade",
+    True, False,
+    ids="upgrade", "no-upgrade",
+)
+def test_new_resolver_lazy_fetch_candidates(
+    script: PipTestEnvironment, upgrade: bool
+) -> None:
+    create_basic_wheel_for_package(script, "myuberpkg", "1")
+    create_basic_wheel_for_package(script, "myuberpkg", "2")
+    create_basic_wheel_for_package(script, "myuberpkg", "3")
+
+    # Install an old version first.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "myuberpkg==1",
+    )
+
+    # Now install the same package again, maybe with the upgrade flag.
+    if upgrade:
+        pip_upgrade_args = "--upgrade"
+    else:
+        pip_upgrade_args = 
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "myuberpkg",
+        *pip_upgrade_args,  # Trailing comma fails on Python 2.
+    )
+
+    # pip should install the version preferred by the strategy...
+    if upgrade:
+        script.assert_installed(myuberpkg="3")
+    else:
+        script.assert_installed(myuberpkg="1")
+
+    # But should reach there in the best route possible, without trying
+    # candidates it does not need to.
+    assert "myuberpkg-2" not in result.stdout, str(result)
+
+
+def test_new_resolver_no_fetch_no_satisfying(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "myuberpkg", "1")
+
+    # Install the package. This should emit a "Processing" message for
+    # fetching the distribution from the --find-links page.
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "myuberpkg",
+    )
+    assert "Processing " in result.stdout, str(result)
+
+    # Try to upgrade the package. This should NOT emit the "Processing"
+    # message because the currently installed version is latest.
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "myuberpkg",
+    )
+    assert "Processing " not in result.stdout, str(result)
+
+
+def test_new_resolver_does_not_install_unneeded_packages_with_url_constraint(
+    script: PipTestEnvironment,
+) -> None:
+    archive_path = create_basic_wheel_for_package(
+        script,
+        "installed",
+        "0.1.0",
+    )
+    not_installed_path = create_basic_wheel_for_package(
+        script,
+        "not_installed",
+        "0.1.0",
+    )
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"not_installed @ {not_installed_path.as_uri()}")
+
+    (script.scratch_path / "index").mkdir()
+    archive_path.rename(script.scratch_path / "index" / archive_path.name)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path / "index",
+        "-c",
+        constraints_file,
+        "installed",
+    )
+
+    script.assert_installed(installed="0.1.0")
+    script.assert_not_installed("not_installed")
+
+
+def test_new_resolver_installs_packages_with_url_constraint(
+    script: PipTestEnvironment,
+) -> None:
+    installed_path = create_basic_wheel_for_package(
+        script,
+        "installed",
+        "0.1.0",
+    )
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"installed @ {installed_path.as_uri()}")
+
+    script.pip(
+        "install", "--no-cache-dir", "--no-index", "-c", constraints_file, "installed"
+    )
+
+    script.assert_installed(installed="0.1.0")
+
+
+def test_new_resolver_reinstall_link_requirement_with_constraint(
+    script: PipTestEnvironment,
+) -> None:
+    installed_path = create_basic_wheel_for_package(
+        script,
+        "installed",
+        "0.1.0",
+    )
+
+    cr_file = script.scratch_path / "constraints.txt"
+    cr_file.write_text(f"installed @ {installed_path.as_uri()}")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-r",
+        cr_file,
+    )
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        cr_file,
+        "-r",
+        cr_file,
+    )
+    # TODO: strengthen assertion to "second invocation does no work"
+    # I don't think this is true yet, but it should be in the future.
+
+    script.assert_installed(installed="0.1.0")
+
+
+def test_new_resolver_prefers_url_constraint(script: PipTestEnvironment) -> None:
+    installed_path = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.1.0",
+    )
+    not_installed_path = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.2.0",
+    )
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"test_pkg @ {installed_path.as_uri()}")
+
+    (script.scratch_path / "index").mkdir()
+    not_installed_path.rename(script.scratch_path / "index" / not_installed_path.name)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path / "index",
+        "-c",
+        constraints_file,
+        "test_pkg",
+    )
+
+    script.assert_installed(test_pkg="0.1.0")
+
+
+def test_new_resolver_prefers_url_constraint_on_update(
+    script: PipTestEnvironment,
+) -> None:
+    installed_path = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.1.0",
+    )
+    not_installed_path = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.2.0",
+    )
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"test_pkg @ {installed_path.as_uri()}")
+
+    (script.scratch_path / "index").mkdir()
+    not_installed_path.rename(script.scratch_path / "index" / not_installed_path.name)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path / "index",
+        "test_pkg",
+    )
+
+    script.assert_installed(test_pkg="0.2.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path / "index",
+        "-c",
+        constraints_file,
+        "test_pkg",
+    )
+
+    script.assert_installed(test_pkg="0.1.0")
+
+
+@pytest.mark.parametrize("version_option", "--constraint", "--requirement")
+def test_new_resolver_fails_with_url_constraint_and_incompatible_version(
+    script: PipTestEnvironment,
+    version_option: str,
+) -> None:
+    not_installed_path = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.1.0",
+    )
+    not_installed_path = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.2.0",
+    )
+
+    url_constraint = script.scratch_path / "constraints.txt"
+    url_constraint.write_text(f"test_pkg @ {not_installed_path.as_uri()}")
+
+    version_req = script.scratch_path / "requirements.txt"
+    version_req.write_text("test_pkg<0.2.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--constraint",
+        url_constraint,
+        version_option,
+        version_req,
+        "test_pkg",
+        expect_error=True,
+    )
+
+    assert "Cannot install test_pkg" in result.stderr, str(result)
+    assert (
+        "because these package versions have conflicting dependencies."
+    ) in result.stderr, str(result)
+
+    script.assert_not_installed("test_pkg")
+
+    # Assert that pip works properly in the absence of the constraints file.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        version_option,
+        version_req,
+        "test_pkg",
+    )
+
+
+def test_new_resolver_ignores_unneeded_conflicting_constraints(
+    script: PipTestEnvironment,
+) -> None:
+    version_1 = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.1.0",
+    )
+    version_2 = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.2.0",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "installed",
+        "0.1.0",
+    )
+
+    constraints = 
+        f"test_pkg @ {version_1.as_uri()}",
+        f"test_pkg @ {version_2.as_uri()}",
+    
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("\n".join(constraints))
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "installed",
+    )
+
+    script.assert_not_installed("test_pkg")
+    script.assert_installed(installed="0.1.0")
+
+
+def test_new_resolver_fails_on_needed_conflicting_constraints(
+    script: PipTestEnvironment,
+) -> None:
+    version_1 = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.1.0",
+    )
+    version_2 = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.2.0",
+    )
+
+    constraints = 
+        f"test_pkg @ {version_1.as_uri()}",
+        f"test_pkg @ {version_2.as_uri()}",
+    
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("\n".join(constraints))
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "test_pkg",
+        expect_error=True,
+    )
+
+    assert (
+        "Cannot install test_pkg because these package versions have conflicting "
+        "dependencies."
+    ) in result.stderr, str(result)
+
+    script.assert_not_installed("test_pkg")
+
+    # Assert that pip works properly in the absence of the constraints file.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "test_pkg",
+    )
+
+
+def test_new_resolver_fails_on_conflicting_constraint_and_requirement(
+    script: PipTestEnvironment,
+) -> None:
+    version_1 = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.1.0",
+    )
+    version_2 = create_basic_wheel_for_package(
+        script,
+        "test_pkg",
+        "0.2.0",
+    )
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"test_pkg @ {version_1.as_uri()}")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        f"test_pkg @ {version_2.as_uri()}",
+        expect_error=True,
+    )
+
+    assert "Cannot install test-pkg 0.2.0" in result.stderr, str(result)
+    assert (
+        "because these package versions have conflicting dependencies."
+    ) in result.stderr, str(result)
+
+    script.assert_not_installed("test_pkg")
+
+    # Assert that pip works properly in the absence of the constraints file.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        f"test_pkg @ {version_2.as_uri()}",
+    )
+
+
+@pytest.mark.parametrize("editable", False, True)
+def test_new_resolver_succeeds_on_matching_constraint_and_requirement(
+    script: PipTestEnvironment, editable: bool
+) -> None:
+    if editable:
+        source_dir = create_test_package_with_setup(
+            script, name="test_pkg", version="0.1.0"
+        )
+    else:
+        source_dir = create_basic_wheel_for_package(
+            script,
+            "test_pkg",
+            "0.1.0",
+        )
+
+    req_line = f"test_pkg @ {source_dir.as_uri()}"
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(req_line)
+
+    last_args: Tuplestr, ...
+    if editable:
+        last_args = ("-e", os.fspath(source_dir))
+    else:
+        last_args = (req_line,)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_file,
+        *last_args,
+    )
+
+    script.assert_installed(test_pkg="0.1.0")
+    if editable:
+        assert_editable(script, "test-pkg")
+
+
+def test_new_resolver_applies_url_constraint_to_dep(script: PipTestEnvironment) -> None:
+    version_1 = create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.1.0",
+    )
+    version_2 = create_basic_wheel_for_package(
+        script,
+        "dep",
+        "0.2.0",
+    )
+
+    base = create_basic_wheel_for_package(script, "base", "0.1.0", depends="dep")
+
+    (script.scratch_path / "index").mkdir()
+    base.rename(script.scratch_path / "index" / base.name)
+    version_2.rename(script.scratch_path / "index" / version_2.name)
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"dep @ {version_1.as_uri()}")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_file,
+        "--find-links",
+        script.scratch_path / "index",
+        "base",
+    )
+
+    script.assert_installed(dep="0.1.0")
+
+
+def test_new_resolver_handles_compatible_wheel_tags_in_constraint_url(
+    script: PipTestEnvironment, make_fake_wheel: MakeFakeWheel
+) -> None:
+    initial_path = make_fake_wheel("base", "0.1.0", "fakepy1-fakeabi-fakeplat")
+
+    constrained = script.scratch_path / "constrained"
+    constrained.mkdir()
+
+    final_path = constrained / initial_path.name
+
+    initial_path.rename(final_path)
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"base @ {final_path.as_uri()}")
+
+    result = script.pip(
+        "install",
+        "--implementation",
+        "fakepy",
+        "--only-binary=:all:",
+        "--python-version",
+        "1",
+        "--abi",
+        "fakeabi",
+        "--platform",
+        "fakeplat",
+        "--target",
+        script.scratch_path / "target",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_file,
+        "base",
+    )
+
+    dist_info = pathlib.Path("scratch", "target", "base-0.1.0.dist-info")
+    result.did_create(dist_info)
+
+
+def test_new_resolver_handles_incompatible_wheel_tags_in_constraint_url(
+    script: PipTestEnvironment, make_fake_wheel: MakeFakeWheel
+) -> None:
+    initial_path = make_fake_wheel("base", "0.1.0", "fakepy1-fakeabi-fakeplat")
+
+    constrained = script.scratch_path / "constrained"
+    constrained.mkdir()
+
+    final_path = constrained / initial_path.name
+
+    initial_path.rename(final_path)
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"base @ {final_path.as_uri()}")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_file,
+        "base",
+        expect_error=True,
+    )
+
+    assert (
+        "Cannot install base because these package versions have conflicting "
+        "dependencies."
+    ) in result.stderr, str(result)
+
+    script.assert_not_installed("base")
+
+
+def test_new_resolver_avoids_incompatible_wheel_tags_in_constraint_url(
+    script: PipTestEnvironment, make_fake_wheel: MakeFakeWheel
+) -> None:
+    initial_path = make_fake_wheel("dep", "0.1.0", "fakepy1-fakeabi-fakeplat")
+
+    constrained = script.scratch_path / "constrained"
+    constrained.mkdir()
+
+    final_path = constrained / initial_path.name
+
+    initial_path.rename(final_path)
+
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text(f"dep @ {final_path.as_uri()}")
+
+    index = script.scratch_path / "index"
+    index.mkdir()
+
+    index_dep = create_basic_wheel_for_package(script, "dep", "0.2.0")
+
+    base = create_basic_wheel_for_package(script, "base", "0.1.0")
+    base_2 = create_basic_wheel_for_package(script, "base", "0.2.0", depends="dep")
+
+    index_dep.rename(index / index_dep.name)
+    base.rename(index / base.name)
+    base_2.rename(index / base_2.name)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-c",
+        constraints_file,
+        "--find-links",
+        script.scratch_path / "index",
+        "base",
+    )
+
+    script.assert_installed(base="0.1.0")
+    script.assert_not_installed("dep")
+
+
+@pytest.mark.parametrize(
+    "suffixes_equivalent, depend_suffix, request_suffix",
+    
+        pytest.param(
+            True,
+            "#egg=foo",
+            "",
+            id="drop-depend-egg",
+        ),
+        pytest.param(
+            True,
+            "",
+            "#egg=foo",
+            id="drop-request-egg",
+        ),
+        pytest.param(
+            True,
+            "#subdirectory=bar&egg=foo",
+            "#subdirectory=bar&egg=bar",
+            id="drop-egg-only",
+        ),
+        pytest.param(
+            True,
+            "#subdirectory=bar&egg=foo",
+            "#egg=foo&subdirectory=bar",
+            id="fragment-ordering",
+        ),
+        pytest.param(
+            True,
+            "?a=1&b=2",
+            "?b=2&a=1",
+            id="query-opordering",
+        ),
+        pytest.param(
+            False,
+            "#sha512=1234567890abcdef",
+            "#sha512=abcdef1234567890",
+            id="different-keys",
+        ),
+        pytest.param(
+            False,
+            "#sha512=1234567890abcdef",
+            "#md5=1234567890abcdef",
+            id="different-values",
+        ),
+        pytest.param(
+            False,
+            "#subdirectory=bar&egg=foo",
+            "#subdirectory=rex",
+            id="drop-egg-still-different",
+        ),
+    ,
+)
+def test_new_resolver_direct_url_equivalent(
+    tmp_path: pathlib.Path,
+    script: PipTestEnvironment,
+    suffixes_equivalent: bool,
+    depend_suffix: str,
+    request_suffix: str,
+) -> None:
+    pkga = create_basic_wheel_for_package(script, name="pkga", version="1")
+    pkgb = create_basic_wheel_for_package(
+        script,
+        name="pkgb",
+        version="1",
+        depends=f"pkga@{pkga.as_uri()}{depend_suffix}",
+    )
+
+    # Make pkgb visible via --find-links, but not pkga.
+    find_links = tmp_path.joinpath("find_links")
+    find_links.mkdir()
+    with open(pkgb, "rb") as f:
+        find_links.joinpath(pkgb.name).write_bytes(f.read())
+
+    # Install pkgb from --find-links, and pkga directly but from a different
+    # URL suffix as specified in pkgb. This should work!
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        str(find_links),
+        f"{pkga.as_uri()}{request_suffix}",
+        "pkgb",
+        expect_error=(not suffixes_equivalent),
+    )
+
+    if suffixes_equivalent:
+        script.assert_installed(pkga="1", pkgb="1")
+    else:
+        script.assert_not_installed("pkga", "pkgb")
+
+
+def test_new_resolver_direct_url_with_extras(
+    tmp_path: pathlib.Path, script: PipTestEnvironment
+) -> None:
+    pkg1 = create_basic_wheel_for_package(script, name="pkg1", version="1")
+    pkg2 = create_basic_wheel_for_package(
+        script,
+        name="pkg2",
+        version="1",
+        extras={"ext": "pkg1"},
+    )
+    pkg3 = create_basic_wheel_for_package(
+        script,
+        name="pkg3",
+        version="1",
+        depends="pkg2ext",
+    )
+
+    # Make pkg1 and pkg3 visible via --find-links, but not pkg2.
+    find_links = tmp_path.joinpath("find_links")
+    find_links.mkdir()
+    with open(pkg1, "rb") as f:
+        find_links.joinpath(pkg1.name).write_bytes(f.read())
+    with open(pkg3, "rb") as f:
+        find_links.joinpath(pkg3.name).write_bytes(f.read())
+
+    # Install with pkg2 only available with direct URL. The extra-ed direct
+    # URL pkg2 should be able to provide pkg2ext required by pkg3.
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        str(find_links),
+        pkg2,
+        "pkg3",
+    )
+
+    script.assert_installed(pkg1="1", pkg2="1", pkg3="1")
+    assert not get_created_direct_url(result, "pkg1")
+    assert get_created_direct_url(result, "pkg2")
+    assert not get_created_direct_url(result, "pkg3")
+
+
+def test_new_resolver_modifies_installed_incompatible(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(script, name="a", version="1")
+    create_basic_wheel_for_package(script, name="a", version="2")
+    create_basic_wheel_for_package(script, name="a", version="3")
+    create_basic_wheel_for_package(script, name="b", version="1", depends="a==1")
+    create_basic_wheel_for_package(script, name="b", version="2", depends="a==2")
+    create_basic_wheel_for_package(script, name="c", version="1", depends="a!=1")
+    create_basic_wheel_for_package(script, name="c", version="2", depends="a!=1")
+    create_basic_wheel_for_package(script, name="d", version="1", depends="b", "c")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "b==1",
+    )
+
+    # d-1 depends on b and c. b-1 is already installed and therefore first
+    # pinned, but later found to be incompatible since the "a==1" dependency
+    # makes all c versions impossible to satisfy. The resolver should be able to
+    # discard b-1 and backtrack, so b-2 is selected instead.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "d==1",
+    )
+    script.assert_installed(d="1", c="2", b="2", a="2")
+
+
+def test_new_resolver_transitively_depends_on_unnamed_local(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(script, name="certbot-docs", version="1")
+    certbot = create_test_package_with_setup(
+        script,
+        name="certbot",
+        version="99.99.0.dev0",
+        extras_require={"docs": "certbot-docs"},
+    )
+    certbot_apache = create_test_package_with_setup(
+        script,
+        name="certbot-apache",
+        version="99.99.0.dev0",
+        install_requires="certbot>=99.99.0.dev0",
+    )
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        f"{certbot}docs",
+        certbot_apache,
+    )
+    script.assert_installed(
+        certbot="99.99.0.dev0",
+        certbot_apache="99.99.0.dev0",
+        certbot_docs="1",
+    )
+
+
+def _to_localhost_uri(path: pathlib.Path) -> str:
+    # Something like file://localhost/path/to/package
+    return path.as_uri().replace("///", "//localhost/")
+
+
+@pytest.mark.parametrize(
+    "format_dep",
+    
+        pytest.param(pathlib.Path.as_uri, id="emptyhost"),
+        pytest.param(_to_localhost_uri, id="localhost"),
+    ,
+)
+@pytest.mark.parametrize(
+    "format_input",
+    
+        pytest.param(pathlib.Path, id="path"),
+        pytest.param(pathlib.Path.as_uri, id="emptyhost"),
+        pytest.param(_to_localhost_uri, id="localhost"),
+    ,
+)
+def test_new_resolver_file_url_normalize(
+    script: PipTestEnvironment,
+    format_dep: Callablepathlib.Path, str,
+    format_input: Callablepathlib.Path, str,
+) -> None:
+    lib_a = create_test_package_with_setup(
+        script,
+        name="lib_a",
+        version="1",
+    )
+    lib_b = create_test_package_with_setup(
+        script,
+        name="lib_b",
+        version="1",
+        install_requires=f"lib_a @ {format_dep(lib_a)}",
+    )
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        format_input(lib_a),
+        lib_b,
+    )
+    script.assert_installed(lib_a="1", lib_b="1")
+
+
+def test_new_resolver_dont_backtrack_on_extra_if_base_constrained(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(script, "dep", "1.0")
+    create_basic_wheel_for_package(script, "pkg", "1.0", extras={"ext": "dep"})
+    create_basic_wheel_for_package(script, "pkg", "2.0", extras={"ext": "dep"})
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("pkg==1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--constraint",
+        constraints_file,
+        "pkgext",
+    )
+    assert "pkg-2.0" not in result.stdout, "Should not try 2.0 due to constraint"
+    script.assert_installed(pkg="1.0", dep="1.0")
+
+
+def test_new_resolver_respect_user_requested_if_extra_is_installed(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(script, "pkg1", "1.0")
+    create_basic_wheel_for_package(script, "pkg2", "1.0", extras={"ext": "pkg1"})
+    create_basic_wheel_for_package(script, "pkg2", "2.0", extras={"ext": "pkg1"})
+    create_basic_wheel_for_package(script, "pkg3", "1.0", depends="pkg2ext")
+
+    # Install pkg3 with an older pkg2.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg3",
+        "pkg2==1.0",
+    )
+    script.assert_installed(pkg3="1.0", pkg2="1.0", pkg1="1.0")
+
+    # Now upgrade both pkg3 and pkg2. pkg2 should be upgraded although pkg2ext
+    # is not requested by the user.
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--upgrade",
+        "pkg3",
+        "pkg2",
+    )
+    script.assert_installed(pkg3="1.0", pkg2="2.0", pkg1="1.0")
+
+
+def test_new_resolver_do_not_backtrack_on_build_failure(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_sdist_for_package(script, "pkg1", "2.0", fails_egg_info=True)
+    create_basic_wheel_for_package(script, "pkg1", "1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg1",
+        expect_error=True,
+    )
+
+    assert "egg_info" in result.stderr
+
+
+def test_new_resolver_works_when_failing_package_builds_are_disallowed(
+    script: PipTestEnvironment,
+) -> None:
+    create_basic_wheel_for_package(script, "pkg2", "1.0", depends="pkg1")
+    create_basic_sdist_for_package(script, "pkg1", "2.0", fails_egg_info=True)
+    create_basic_wheel_for_package(script, "pkg1", "1.0")
+    constraints_file = script.scratch_path / "constraints.txt"
+    constraints_file.write_text("pkg1 != 2.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "pkg2",
+    )
+
+    script.assert_installed(pkg2="1.0", pkg1="1.0")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_new_resolver_errors.py Added

@@ -0,0 +1,132 @@
+import pathlib
+import sys
+
+from tests.lib import (
+    PipTestEnvironment,
+    create_basic_wheel_for_package,
+    create_test_package_with_setup,
+)
+
+
+def test_new_resolver_conflict_requirements_file(
+    tmpdir: pathlib.Path, script: PipTestEnvironment
+) -> None:
+    create_basic_wheel_for_package(script, "base", "1.0")
+    create_basic_wheel_for_package(script, "base", "2.0")
+    create_basic_wheel_for_package(
+        script,
+        "pkga",
+        "1.0",
+        depends="base==1.0",
+    )
+    create_basic_wheel_for_package(
+        script,
+        "pkgb",
+        "1.0",
+        depends="base==2.0",
+    )
+
+    req_file = tmpdir.joinpath("requirements.txt")
+    req_file.write_text("pkga\npkgb")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-r",
+        req_file,
+        expect_error=True,
+    )
+
+    message = "package versions have conflicting dependencies"
+    assert message in result.stderr, str(result)
+
+
+def test_new_resolver_conflict_constraints_file(
+    tmpdir: pathlib.Path, script: PipTestEnvironment
+) -> None:
+    create_basic_wheel_for_package(script, "pkg", "1.0")
+
+    constraints_file = tmpdir.joinpath("constraints.txt")
+    constraints_file.write_text("pkg!=1.0")
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "-c",
+        constraints_file,
+        "pkg==1.0",
+        expect_error=True,
+    )
+
+    assert "ResolutionImpossible" in result.stderr, str(result)
+
+    message = "The user requested (constraint) pkg!=1.0"
+    assert message in result.stdout, str(result)
+
+
+def test_new_resolver_requires_python_error(script: PipTestEnvironment) -> None:
+    compatible_python = ">={0.major}.{0.minor}".format(sys.version_info)
+    incompatible_python = "<{0.major}.{0.minor}".format(sys.version_info)
+
+    pkga = create_test_package_with_setup(
+        script,
+        name="pkga",
+        version="1.0",
+        python_requires=compatible_python,
+    )
+    pkgb = create_test_package_with_setup(
+        script,
+        name="pkgb",
+        version="1.0",
+        python_requires=incompatible_python,
+    )
+
+    # This always fails because pkgb can never be satisfied.
+    result = script.pip("install", "--no-index", pkga, pkgb, expect_error=True)
+
+    # The error message should mention the Requires-Python: value causing the
+    # conflict, not the compatible one.
+    assert incompatible_python in result.stderr, str(result)
+    assert compatible_python not in result.stderr, str(result)
+
+
+def test_new_resolver_checks_requires_python_before_dependencies(
+    script: PipTestEnvironment,
+) -> None:
+    incompatible_python = "<{0.major}.{0.minor}".format(sys.version_info)
+
+    pkg_dep = create_basic_wheel_for_package(
+        script,
+        name="pkg-dep",
+        version="1",
+    )
+    create_basic_wheel_for_package(
+        script,
+        name="pkg-root",
+        version="1",
+        # Refer the dependency by URL to prioritise it as much as possible,
+        # to test that Requires-Python is *still* inspected first.
+        depends=f"pkg-dep@{pathlib.Path(pkg_dep).as_uri()}",
+        requires_python=incompatible_python,
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "pkg-root",
+        expect_error=True,
+    )
+
+    # Resolution should fail because of pkg-a's Requires-Python.
+    # This check should be done before pkg-b, so pkg-b should never be pulled.
+    assert incompatible_python in result.stderr, str(result)
+    assert "pkg-b" not in result.stderr, str(result)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_new_resolver_hashes.py Added

@@ -0,0 +1,374 @@
+import collections
+import hashlib
+
+import pytest
+
+from tests.lib import (
+    PipTestEnvironment,
+    create_basic_sdist_for_package,
+    create_basic_wheel_for_package,
+)
+
+_FindLinks = collections.namedtuple(
+    "_FindLinks",
+    "index_html sdist_hash wheel_hash",
+)
+
+
+def _create_find_links(script: PipTestEnvironment) -> _FindLinks:
+    sdist_path = create_basic_sdist_for_package(script, "base", "0.1.0")
+    wheel_path = create_basic_wheel_for_package(script, "base", "0.1.0")
+
+    sdist_hash = hashlib.sha256(sdist_path.read_bytes()).hexdigest()
+    wheel_hash = hashlib.sha256(wheel_path.read_bytes()).hexdigest()
+
+    index_html = script.scratch_path / "index.html"
+    index_html.write_text(
+        """
+        <!DOCTYPE html>
+        <a href="{sdist_url}#sha256={sdist_hash}">{sdist_path.stem}</a>
+        <a href="{wheel_url}#sha256={wheel_hash}">{wheel_path.stem}</a>
+        """.format(
+            sdist_url=sdist_path.as_uri(),
+            sdist_hash=sdist_hash,
+            sdist_path=sdist_path,
+            wheel_url=wheel_path.as_uri(),
+            wheel_hash=wheel_hash,
+            wheel_path=wheel_path,
+        ).strip()
+    )
+
+    return _FindLinks(index_html, sdist_hash, wheel_hash)
+
+
+@pytest.mark.parametrize(
+    "requirements_template, message",
+    
+        (
+            """
+            base==0.1.0 --hash=sha256:{sdist_hash} --hash=sha256:{wheel_hash}
+            base==0.1.0 --hash=sha256:{sdist_hash} --hash=sha256:{wheel_hash}
+            """,
+            "Checked 2 links for project {name!r} against 2 hashes "
+            "(2 matches, 0 no digest): discarding no candidates",
+        ),
+        (
+            # Different hash lists are intersected.
+            """
+            base==0.1.0 --hash=sha256:{sdist_hash} --hash=sha256:{wheel_hash}
+            base==0.1.0 --hash=sha256:{sdist_hash}
+            """,
+            "Checked 2 links for project {name!r} against 1 hashes "
+            "(1 matches, 0 no digest): discarding 1 non-matches",
+        ),
+    ,
+    ids="identical", "intersect",
+)
+def test_new_resolver_hash_intersect(
+    script: PipTestEnvironment, requirements_template: str, message: str
+) -> None:
+    find_links = _create_find_links(script)
+
+    requirements_txt = script.scratch_path / "requirements.txt"
+    requirements_txt.write_text(
+        requirements_template.format(
+            sdist_hash=find_links.sdist_hash,
+            wheel_hash=find_links.wheel_hash,
+        ),
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-deps",
+        "--no-index",
+        "--find-links",
+        find_links.index_html,
+        "-vv",
+        "--requirement",
+        requirements_txt,
+    )
+
+    assert message.format(name="base") in result.stdout, str(result)
+
+
+def test_new_resolver_hash_intersect_from_constraint(
+    script: PipTestEnvironment,
+) -> None:
+    find_links = _create_find_links(script)
+
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraints_txt.write_text(
+        "base==0.1.0 --hash=sha256:{sdist_hash}".format(
+            sdist_hash=find_links.sdist_hash,
+        ),
+    )
+    requirements_txt = script.scratch_path / "requirements.txt"
+    requirements_txt.write_text(
+        """
+        base==0.1.0 --hash=sha256:{sdist_hash} --hash=sha256:{wheel_hash}
+        """.format(
+            sdist_hash=find_links.sdist_hash,
+            wheel_hash=find_links.wheel_hash,
+        ),
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-deps",
+        "--no-index",
+        "--find-links",
+        find_links.index_html,
+        "-vv",
+        "--constraint",
+        constraints_txt,
+        "--requirement",
+        requirements_txt,
+    )
+
+    message = (
+        "Checked 2 links for project {name!r} against 1 hashes "
+        "(1 matches, 0 no digest): discarding 1 non-matches"
+    ).format(name="base")
+    assert message in result.stdout, str(result)
+
+
+@pytest.mark.parametrize(
+    "requirements_template, constraints_template",
+    
+        (
+            """
+            base==0.1.0 --hash=sha256:{sdist_hash}
+            base==0.1.0 --hash=sha256:{wheel_hash}
+            """,
+            "",
+        ),
+        (
+            "base==0.1.0 --hash=sha256:{sdist_hash}",
+            "base==0.1.0 --hash=sha256:{wheel_hash}",
+        ),
+    ,
+    ids="both-requirements", "one-each",
+)
+def test_new_resolver_hash_intersect_empty(
+    script: PipTestEnvironment,
+    requirements_template: str,
+    constraints_template: str,
+) -> None:
+    find_links = _create_find_links(script)
+
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraints_txt.write_text(
+        constraints_template.format(
+            sdist_hash=find_links.sdist_hash,
+            wheel_hash=find_links.wheel_hash,
+        ),
+    )
+
+    requirements_txt = script.scratch_path / "requirements.txt"
+    requirements_txt.write_text(
+        requirements_template.format(
+            sdist_hash=find_links.sdist_hash,
+            wheel_hash=find_links.wheel_hash,
+        ),
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-deps",
+        "--no-index",
+        "--find-links",
+        find_links.index_html,
+        "--constraint",
+        constraints_txt,
+        "--requirement",
+        requirements_txt,
+        expect_error=True,
+    )
+
+    assert (
+        "THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE."
+    ) in result.stderr, str(result)
+
+
+def test_new_resolver_hash_intersect_empty_from_constraint(
+    script: PipTestEnvironment,
+) -> None:
+    find_links = _create_find_links(script)
+
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraints_txt.write_text(
+        """
+        base==0.1.0 --hash=sha256:{sdist_hash}
+        base==0.1.0 --hash=sha256:{wheel_hash}
+        """.format(
+            sdist_hash=find_links.sdist_hash,
+            wheel_hash=find_links.wheel_hash,
+        ),
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-deps",
+        "--no-index",
+        "--find-links",
+        find_links.index_html,
+        "--constraint",
+        constraints_txt,
+        "base==0.1.0",
+        expect_error=True,
+    )
+
+    message = (
+        "Hashes are required in --require-hashes mode, but they are missing "
+        "from some requirements."
+    )
+    assert message in result.stderr, str(result)
+
+
+@pytest.mark.parametrize("constrain_by_hash", False, True)
+def test_new_resolver_hash_requirement_and_url_constraint_can_succeed(
+    script: PipTestEnvironment,
+    constrain_by_hash: bool,
+) -> None:
+    wheel_path = create_basic_wheel_for_package(script, "base", "0.1.0")
+
+    wheel_hash = hashlib.sha256(wheel_path.read_bytes()).hexdigest()
+
+    requirements_txt = script.scratch_path / "requirements.txt"
+    requirements_txt.write_text(
+        """
+        base==0.1.0 --hash=sha256:{wheel_hash}
+        """.format(
+            wheel_hash=wheel_hash,
+        ),
+    )
+
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraint_text = "base @ {wheel_url}\n".format(wheel_url=wheel_path.as_uri())
+    if constrain_by_hash:
+        constraint_text += "base==0.1.0 --hash=sha256:{wheel_hash}\n".format(
+            wheel_hash=wheel_hash,
+        )
+    constraints_txt.write_text(constraint_text)
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--constraint",
+        constraints_txt,
+        "--requirement",
+        requirements_txt,
+    )
+
+    script.assert_installed(base="0.1.0")
+
+
+@pytest.mark.parametrize("constrain_by_hash", False, True)
+def test_new_resolver_hash_requirement_and_url_constraint_can_fail(
+    script: PipTestEnvironment,
+    constrain_by_hash: bool,
+) -> None:
+    wheel_path = create_basic_wheel_for_package(script, "base", "0.1.0")
+    other_path = create_basic_wheel_for_package(script, "other", "0.1.0")
+
+    other_hash = hashlib.sha256(other_path.read_bytes()).hexdigest()
+
+    requirements_txt = script.scratch_path / "requirements.txt"
+    requirements_txt.write_text(
+        """
+        base==0.1.0 --hash=sha256:{other_hash}
+        """.format(
+            other_hash=other_hash,
+        ),
+    )
+
+    constraints_txt = script.scratch_path / "constraints.txt"
+    constraint_text = "base @ {wheel_url}\n".format(wheel_url=wheel_path.as_uri())
+    if constrain_by_hash:
+        constraint_text += "base==0.1.0 --hash=sha256:{other_hash}\n".format(
+            other_hash=other_hash,
+        )
+    constraints_txt.write_text(constraint_text)
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--constraint",
+        constraints_txt,
+        "--requirement",
+        requirements_txt,
+        expect_error=True,
+    )
+
+    assert (
+        "THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE."
+    ) in result.stderr, str(result)
+
+    script.assert_not_installed("base", "other")
+
+
+def test_new_resolver_hash_with_extras(script: PipTestEnvironment) -> None:
+    parent_with_extra_path = create_basic_wheel_for_package(
+        script, "parent_with_extra", "0.1.0", depends="childextra"
+    )
+    parent_with_extra_hash = hashlib.sha256(
+        parent_with_extra_path.read_bytes()
+    ).hexdigest()
+
+    parent_without_extra_path = create_basic_wheel_for_package(
+        script, "parent_without_extra", "0.1.0", depends="child"
+    )
+    parent_without_extra_hash = hashlib.sha256(
+        parent_without_extra_path.read_bytes()
+    ).hexdigest()
+
+    child_path = create_basic_wheel_for_package(
+        script, "child", "0.1.0", extras={"extra": "extra"}
+    )
+    child_hash = hashlib.sha256(child_path.read_bytes()).hexdigest()
+
+    # Newer release
+    create_basic_wheel_for_package(
+        script, "child", "0.2.0", extras={"extra": "extra"}
+    )
+
+    extra_path = create_basic_wheel_for_package(script, "extra", "0.1.0")
+    extra_hash = hashlib.sha256(extra_path.read_bytes()).hexdigest()
+
+    requirements_txt = script.scratch_path / "requirements.txt"
+    requirements_txt.write_text(
+        """
+        childextra==0.1.0 --hash=sha256:{child_hash}
+        parent_with_extra==0.1.0 --hash=sha256:{parent_with_extra_hash}
+        parent_without_extra==0.1.0 --hash=sha256:{parent_without_extra_hash}
+        extra==0.1.0 --hash=sha256:{extra_hash}
+        """.format(
+            child_hash=child_hash,
+            parent_with_extra_hash=parent_with_extra_hash,
+            parent_without_extra_hash=parent_without_extra_hash,
+            extra_hash=extra_hash,
+        ),
+    )
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--requirement",
+        requirements_txt,
+    )
+
+    script.assert_installed(
+        parent_with_extra="0.1.0",
+        parent_without_extra="0.1.0",
+        child="0.1.0",
+        extra="0.1.0",
+    )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_new_resolver_target.py Added

@@ -0,0 +1,77 @@
+from pathlib import Path
+from typing import Callable, Optional
+
+import pytest
+
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from tests.lib import PipTestEnvironment
+from tests.lib.wheel import make_wheel
+
+MakeFakeWheel = Callablestr, str
+
+
+@pytest.fixture()
+def make_fake_wheel(script: PipTestEnvironment) -> MakeFakeWheel:
+    def _make_fake_wheel(wheel_tag: str) -> str:
+        wheel_house = script.scratch_path.joinpath("wheelhouse")
+        wheel_house.mkdir()
+        wheel_builder = make_wheel(
+            name="fake",
+            version="1.0",
+            wheel_metadata_updates={"Tag": },
+        )
+        wheel_path = wheel_house.joinpath(f"fake-1.0-{wheel_tag}.whl")
+        wheel_builder.save_to(wheel_path)
+        return str(wheel_path)
+
+    return _make_fake_wheel
+
+
+@pytest.mark.parametrize("implementation", None, "fakepy")
+@pytest.mark.parametrize("python_version", None, "1")
+@pytest.mark.parametrize("abi", None, "fakeabi")
+@pytest.mark.parametrize("platform", None, "fakeplat")
+def test_new_resolver_target_checks_compatibility_failure(
+    script: PipTestEnvironment,
+    make_fake_wheel: MakeFakeWheel,
+    implementation: Optionalstr,
+    python_version: Optionalstr,
+    abi: Optionalstr,
+    platform: Optionalstr,
+) -> None:
+    fake_wheel_tag = "fakepy1-fakeabi-fakeplat"
+    args = 
+        "install",
+        "--only-binary=:all:",
+        "--no-cache-dir",
+        "--no-index",
+        "--target",
+        str(script.scratch_path.joinpath("target")),
+        make_fake_wheel(fake_wheel_tag),
+    
+    if implementation:
+        args += "--implementation", implementation
+    if python_version:
+        args += "--python-version", python_version
+    if abi:
+        args += "--abi", abi
+    if platform:
+        args += "--platform", platform
+
+    args_tag = "{}{}-{}-{}".format(
+        implementation,
+        python_version,
+        abi,
+        platform,
+    )
+    wheel_tag_matches = args_tag == fake_wheel_tag
+
+    result = script.pip(*args, expect_error=(not wheel_tag_matches))
+
+    dist_info = Path("scratch", "target", "fake-1.0.dist-info")
+    if wheel_tag_matches:
+        assert result.returncode == SUCCESS
+        result.did_create(dist_info)
+    else:
+        assert result.returncode == ERROR
+        result.did_not_create(dist_info)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_new_resolver_user.py Added

@@ -0,0 +1,230 @@
+import os
+import textwrap
+
+import pytest
+
+from tests.lib import PipTestEnvironment, create_basic_wheel_for_package
+from tests.lib.venv import VirtualEnvironment
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_new_resolver_install_user(script: PipTestEnvironment) -> None:
+    create_basic_wheel_for_package(script, "base", "0.1.0")
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "base",
+    )
+    result.did_create(script.user_site / "base")
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_new_resolver_install_user_satisfied_by_global_site(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    An install a matching version to user site should re-use a global site
+    installation if it satisfies.
+    """
+    create_basic_wheel_for_package(script, "base", "1.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==1.0.0",
+    )
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "base==1.0.0",
+    )
+
+    result.did_not_create(script.user_site / "base")
+
+
+@pytest.mark.usefixtures("enable_user_site")
+def test_new_resolver_install_user_conflict_in_user_site(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Installing a different version in user site should uninstall an existing
+    different version in user site.
+    """
+    create_basic_wheel_for_package(script, "base", "1.0.0")
+    create_basic_wheel_for_package(script, "base", "2.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "base==2.0.0",
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "base==1.0.0",
+    )
+
+    base_1_dist_info = script.user_site / "base-1.0.0.dist-info"
+    base_2_dist_info = script.user_site / "base-2.0.0.dist-info"
+
+    result.did_create(base_1_dist_info)
+    result.did_not_create(base_2_dist_info)
+
+
+@pytest.fixture()
+def patch_dist_in_site_packages(virtualenv: VirtualEnvironment) -> None:
+    # Since the tests are run from a virtualenv, and to avoid the "Will not
+    # install to the usersite because it will lack sys.path precedence..."
+    # error: Monkey patch `pip._internal.utils.misc.dist_in_site_packages`
+    # so it's possible to install a conflicting distribution in the user site.
+    virtualenv.sitecustomize = textwrap.dedent(
+        """
+        def dist_in_site_packages(dist):
+            return False
+
+        from pip._internal.metadata.base import BaseDistribution
+        BaseDistribution.in_site_packages = property(dist_in_site_packages)
+    """
+    )
+
+
+@pytest.mark.usefixtures("enable_user_site", "patch_dist_in_site_packages")
+def test_new_resolver_install_user_reinstall_global_site(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Specifying --force-reinstall makes a different version in user site,
+    ignoring the matching installation in global site.
+    """
+    create_basic_wheel_for_package(script, "base", "1.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==1.0.0",
+    )
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "--force-reinstall",
+        "base==1.0.0",
+    )
+
+    result.did_create(script.user_site / "base")
+
+    site_packages_content = set(os.listdir(script.site_packages_path))
+    assert "base" in site_packages_content
+
+
+@pytest.mark.usefixtures("enable_user_site", "patch_dist_in_site_packages")
+def test_new_resolver_install_user_conflict_in_global_site(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Installing a different version in user site should ignore an existing
+    different version in global site, and simply add to the user site.
+    """
+    create_basic_wheel_for_package(script, "base", "1.0.0")
+    create_basic_wheel_for_package(script, "base", "2.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==1.0.0",
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "base==2.0.0",
+    )
+
+    base_2_dist_info = script.user_site / "base-2.0.0.dist-info"
+    result.did_create(base_2_dist_info)
+
+    site_packages_content = set(os.listdir(script.site_packages_path))
+    assert "base-1.0.0.dist-info" in site_packages_content
+
+
+@pytest.mark.usefixtures("enable_user_site", "patch_dist_in_site_packages")
+def test_new_resolver_install_user_conflict_in_global_and_user_sites(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Installing a different version in user site should ignore an existing
+    different version in global site, but still upgrade the user site.
+    """
+    create_basic_wheel_for_package(script, "base", "1.0.0")
+    create_basic_wheel_for_package(script, "base", "2.0.0")
+
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "base==2.0.0",
+    )
+    script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "--force-reinstall",
+        "base==2.0.0",
+    )
+
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "--find-links",
+        script.scratch_path,
+        "--user",
+        "base==1.0.0",
+    )
+
+    base_1_dist_info = script.user_site / "base-1.0.0.dist-info"
+    base_2_dist_info = script.user_site / "base-2.0.0.dist-info"
+
+    result.did_create(base_1_dist_info)
+    assert base_2_dist_info in result.files_deleted
+
+    site_packages_content = set(os.listdir(script.site_packages_path))
+    assert "base-2.0.0.dist-info" in site_packages_content

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_no_color.py Added

@@ -0,0 +1,49 @@
+"""
+Test specific for the --no-color option
+"""
+import os
+import shutil
+import subprocess
+import sys
+
+import pytest
+
+from tests.lib import PipTestEnvironment
+
+
+@pytest.mark.skipif(shutil.which("script") is None, reason="no 'script' executable")
+def test_no_color(script: PipTestEnvironment) -> None:
+    """Ensure colour output disabled when --no-color is passed."""
+    # Using 'script' in this test allows for transparently testing pip's output
+    # since pip is smart enough to disable colour output when piped, which is
+    # not the behaviour we want to be testing here.
+    #
+    # On the other hand, this test is non-portable due to the options passed to
+    # 'script' and well as the mere use of the same.
+    #
+    # This test will stay until someone has the time to rewrite it.
+    pip_command = "pip uninstall {} noSuchPackage"
+    if sys.platform == "darwin":
+        command = f"script -q /tmp/pip-test-no-color.txt {pip_command}"
+    else:
+        command = f'script -q /tmp/pip-test-no-color.txt --command "{pip_command}"'
+
+    def get_run_output(option: str = "") -> str:
+        cmd = command.format(option)
+        proc = subprocess.Popen(
+            cmd,
+            shell=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+        )
+        proc.communicate()
+
+        try:
+            with open("/tmp/pip-test-no-color.txt") as output_file:
+                retval = output_file.read()
+            return retval
+        finally:
+            os.unlink("/tmp/pip-test-no-color.txt")
+
+    assert "\x1b3" in get_run_output(""), "Expected color in output"
+    assert "\x1b3" not in get_run_output("--no-color"), "Expected no color in output"

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_pep517.py Added

@@ -0,0 +1,424 @@
+import os
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Tuple
+
+import pytest
+import tomli_w
+
+from pip._internal.build_env import BuildEnvironment
+from pip._internal.req import InstallRequirement
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    create_basic_wheel_for_package,
+    make_test_finder,
+)
+
+
+def make_project(
+    tmpdir: Path,
+    requires: OptionalListstr = None,
+    backend: Optionalstr = None,
+    backend_path: OptionalListstr = None,
+) -> Path:
+    requires = requires or 
+    project_dir = tmpdir / "project"
+    project_dir.mkdir()
+    buildsys: Dictstr, Any = {"requires": requires}
+    if backend:
+        buildsys"build-backend" = backend
+    if backend_path:
+        buildsys"backend-path" = backend_path
+    data = tomli_w.dumps({"build-system": buildsys})
+    project_dir.joinpath("pyproject.toml").write_text(data)
+    return project_dir
+
+
+def test_backend(tmpdir: Path, data: TestData) -> None:
+    """Check we can call a requirement's backend successfully"""
+    project_dir = make_project(tmpdir, backend="dummy_backend")
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(project_dir)  # make req believe it has been unpacked
+    req.load_pyproject_toml()
+    env = BuildEnvironment()
+    finder = make_test_finder(find_links=data.backends)
+    env.install_requirements(finder, "dummy_backend", "normal", kind="Installing")
+    conflicting, missing = env.check_requirements("dummy_backend")
+    assert not conflicting and not missing
+    assert hasattr(req.pep517_backend, "build_wheel")
+    with env:
+        assert req.pep517_backend is not None
+        assert req.pep517_backend.build_wheel("dir") == "Backend called"
+
+
+dummy_backend_code = """\
+def build_wheel(
+    wheel_directory,
+    config_settings=None,
+    metadata_directory=None
+):
+    return "Backend called"
+"""
+
+
+def test_backend_path(tmpdir: Path, data: TestData) -> None:
+    """Check we can call a backend inside the project"""
+    project_dir = make_project(tmpdir, backend="dummy_backend", backend_path=".")
+    (project_dir / "dummy_backend.py").write_text(dummy_backend_code)
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(project_dir)  # make req believe it has been unpacked
+    req.load_pyproject_toml()
+
+    env = BuildEnvironment()
+    assert hasattr(req.pep517_backend, "build_wheel")
+    with env:
+        assert req.pep517_backend is not None
+        assert req.pep517_backend.build_wheel("dir") == "Backend called"
+
+
+def test_backend_path_and_dep(tmpdir: Path, data: TestData) -> None:
+    """Check we can call a requirement's backend successfully"""
+    project_dir = make_project(
+        tmpdir, backend="dummy_internal_backend", backend_path="."
+    )
+    (project_dir / "dummy_internal_backend.py").write_text(
+        "from dummy_backend import build_wheel"
+    )
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(project_dir)  # make req believe it has been unpacked
+    req.load_pyproject_toml()
+    env = BuildEnvironment()
+    finder = make_test_finder(find_links=data.backends)
+    env.install_requirements(finder, "dummy_backend", "normal", kind="Installing")
+
+    assert hasattr(req.pep517_backend, "build_wheel")
+    with env:
+        assert req.pep517_backend is not None
+        assert req.pep517_backend.build_wheel("dir") == "Backend called"
+
+
+def test_pep517_install(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    """Check we can build with a custom backend"""
+    project_dir = make_project(
+        tmpdir, requires="test_backend", backend="test_backend"
+    )
+    result = script.pip("install", "--no-index", "-f", data.backends, project_dir)
+    result.assert_installed("project", editable=False)
+
+
+def test_pep517_install_with_reqs(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    """Backend generated requirements are installed in the build env"""
+    project_dir = make_project(
+        tmpdir, requires="test_backend", backend="test_backend"
+    )
+    project_dir.joinpath("backend_reqs.txt").write_text("simplewheel")
+    result = script.pip(
+        "install", "--no-index", "-f", data.backends, "-f", data.packages, project_dir
+    )
+    result.assert_installed("project", editable=False)
+
+
+def test_no_use_pep517_without_setup_py(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    """Using --no-use-pep517 requires setup.py"""
+    project_dir = make_project(
+        tmpdir, requires="test_backend", backend="test_backend"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--no-use-pep517",
+        "-f",
+        data.backends,
+        project_dir,
+        expect_error=True,
+    )
+    assert "project does not have a setup.py" in result.stderr
+
+
+def test_conflicting_pep517_backend_requirements(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    project_dir = make_project(
+        tmpdir, requires="test_backend", "simplewheel==1.0", backend="test_backend"
+    )
+    project_dir.joinpath("backend_reqs.txt").write_text("simplewheel==2.0")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.backends,
+        "-f",
+        data.packages,
+        project_dir,
+        expect_error=True,
+    )
+    msg = (
+        "Some build dependencies for {url} conflict with the backend "
+        "dependencies: simplewheel==1.0 is incompatible with "
+        "simplewheel==2.0.".format(url=project_dir.as_uri())
+    )
+    assert result.returncode != 0 and msg in result.stderr, str(result)
+
+
+def test_no_check_build_deps(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    project_dir = make_project(
+        tmpdir, requires="simplewheel==2.0", backend="test_backend"
+    )
+    script.pip(
+        "install",
+        "simplewheel==1.0",
+        "test_backend",
+        "--no-index",
+        "-f",
+        data.packages,
+        "-f",
+        data.backends,
+    )
+    result = script.pip("install", "--no-build-isolation", project_dir)
+    result.assert_installed("project", editable=False)
+
+
+def test_validate_missing_pep517_backend_requirements(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    project_dir = make_project(
+        tmpdir, requires="test_backend", "simplewheel==1.0", backend="test_backend"
+    )
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.backends,
+        "-f",
+        data.packages,
+        "--no-build-isolation",
+        "--check-build-dependencies",
+        project_dir,
+        expect_error=True,
+    )
+    msg = (
+        "Some build dependencies for {url} are missing: "
+        "'simplewheel==1.0', 'test_backend'.".format(url=project_dir.as_uri())
+    )
+    assert result.returncode != 0 and msg in result.stderr, str(result)
+
+
+def test_validate_conflicting_pep517_backend_requirements(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    project_dir = make_project(
+        tmpdir, requires="simplewheel==1.0", backend="test_backend"
+    )
+    script.pip("install", "simplewheel==2.0", "--no-index", "-f", data.packages)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.backends,
+        "-f",
+        data.packages,
+        "--no-build-isolation",
+        "--check-build-dependencies",
+        project_dir,
+        expect_error=True,
+    )
+    msg = (
+        "Some build dependencies for {url} conflict with the backend "
+        "dependencies: simplewheel==2.0 is incompatible with "
+        "simplewheel==1.0.".format(url=project_dir.as_uri())
+    )
+    assert result.returncode != 0 and msg in result.stderr, str(result)
+
+
+def test_pep517_backend_requirements_satisfied_by_prerelease(
+    script: PipTestEnvironment,
+    data: TestData,
+) -> None:
+    create_basic_wheel_for_package(script, "myreq", "1.0a1")
+    script.pip("install", "myreq==1.0a1", "--no-index", "-f", script.scratch_path)
+    script.pip("install", "test_backend", "--no-index", "-f", data.backends)
+
+    project_dir = make_project(
+        script.temp_path,
+        requires="test_backend", "myreq",
+        backend="test_backend",
+    )
+    project_dir.joinpath("backend_reqs.txt").write_text("myreq")
+
+    result = script.pip("install", "--no-index", "--no-build-isolation", project_dir)
+    assert "Installing backend dependencies:" not in result.stdout
+
+
+def test_pep517_backend_requirements_already_satisfied(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    project_dir = make_project(
+        tmpdir, requires="test_backend", "simplewheel==1.0", backend="test_backend"
+    )
+    project_dir.joinpath("backend_reqs.txt").write_text("simplewheel")
+    result = script.pip(
+        "install",
+        "--no-index",
+        "-f",
+        data.backends,
+        "-f",
+        data.packages,
+        project_dir,
+    )
+    assert "Installing backend dependencies:" not in result.stdout
+
+
+def test_pep517_install_with_no_cache_dir(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData
+) -> None:
+    """Check builds with a custom backends work, even with no cache."""
+    project_dir = make_project(
+        tmpdir, requires="test_backend", backend="test_backend"
+    )
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-f",
+        data.backends,
+        project_dir,
+    )
+    result.assert_installed("project", editable=False)
+
+
+def make_pyproject_with_setup(
+    tmpdir: Path, build_system: bool = True, set_backend: bool = True
+) -> TuplePath, str:
+    project_dir = tmpdir / "project"
+    project_dir.mkdir()
+    setup_script = "from setuptools import setup\n"
+    expect_script_dir_on_path = True
+    if build_system:
+        buildsys: Dictstr, Any = {
+            "requires": "setuptools", "wheel",
+        }
+        if set_backend:
+            buildsys"build-backend" = "setuptools.build_meta"
+            expect_script_dir_on_path = False
+        project_data = tomli_w.dumps({"build-system": buildsys})
+    else:
+        project_data = ""
+
+    if expect_script_dir_on_path:
+        setup_script += "from pep517_test import __version__\n"
+    else:
+        setup_script += (
+            "try:\n"
+            "    import pep517_test\n"
+            "except ImportError:\n"
+            "    pass\n"
+            "else:\n"
+            '    raise RuntimeError("Source dir incorrectly on sys.path")\n'
+        )
+
+    setup_script += 'setup(name="pep517_test", version="0.1", packages="pep517_test")'
+
+    project_dir.joinpath("pyproject.toml").write_text(project_data)
+    project_dir.joinpath("setup.py").write_text(setup_script)
+    package_dir = project_dir / "pep517_test"
+    package_dir.mkdir()
+    package_dir.joinpath("__init__.py").write_text('__version__ = "0.1"')
+    return project_dir, "pep517_test"
+
+
+def test_no_build_system_section(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData, common_wheels: Path
+) -> None:
+    """Check builds with setup.py, pyproject.toml, but no build-system section."""
+    project_dir, name = make_pyproject_with_setup(tmpdir, build_system=False)
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-f",
+        common_wheels,
+        project_dir,
+    )
+    result.assert_installed(name, editable=False)
+
+
+def test_no_build_backend_entry(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData, common_wheels: Path
+) -> None:
+    """Check builds with setup.py, pyproject.toml, but no build-backend entry."""
+    project_dir, name = make_pyproject_with_setup(tmpdir, set_backend=False)
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-f",
+        common_wheels,
+        project_dir,
+    )
+    result.assert_installed(name, editable=False)
+
+
+def test_explicit_setuptools_backend(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData, common_wheels: Path
+) -> None:
+    """Check builds with setup.py, pyproject.toml, and a build-backend entry."""
+    project_dir, name = make_pyproject_with_setup(tmpdir)
+    result = script.pip(
+        "install",
+        "--no-cache-dir",
+        "--no-index",
+        "-f",
+        common_wheels,
+        project_dir,
+    )
+    result.assert_installed(name, editable=False)
+
+
+@pytest.mark.network
+def test_pep517_and_build_options(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData, common_wheels: Path
+) -> None:
+    """Backend generated requirements are installed in the build env"""
+    project_dir, name = make_pyproject_with_setup(tmpdir)
+    result = script.pip(
+        "wheel",
+        "--wheel-dir",
+        tmpdir,
+        "--build-option",
+        "foo",
+        "-f",
+        common_wheels,
+        project_dir,
+        allow_stderr_warning=True,
+    )
+    assert "Ignoring --build-option when building" in result.stderr
+    assert "using PEP 517" in result.stderr
+
+
+@pytest.mark.network
+def test_pep517_and_global_options(
+    script: PipTestEnvironment, tmpdir: Path, data: TestData, common_wheels: Path
+) -> None:
+    """Backend generated requirements are installed in the build env"""
+    project_dir, name = make_pyproject_with_setup(tmpdir)
+    result = script.pip(
+        "wheel",
+        "--wheel-dir",
+        tmpdir,
+        "--global-option",
+        "foo",
+        "-f",
+        common_wheels,
+        project_dir,
+        allow_stderr_warning=True,
+    )
+    assert "Ignoring --global-option when building" in result.stderr
+    assert "using PEP 517" in result.stderr

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_pep660.py Added

@@ -0,0 +1,225 @@
+import os
+from pathlib import Path
+from typing import Any, Dict
+
+import tomli_w
+
+from tests.lib import PipTestEnvironment
+
+SETUP_PY = """
+from setuptools import setup
+
+setup()
+"""
+
+SETUP_CFG = """
+metadata
+name = project
+version = 1.0.0
+"""
+
+BACKEND_WITHOUT_PEP660 = """
+from setuptools.build_meta import (
+    build_wheel as _build_wheel,
+    prepare_metadata_for_build_wheel as _prepare_metadata_for_build_wheel,
+    get_requires_for_build_wheel as _get_requires_for_build_wheel,
+)
+
+def get_requires_for_build_wheel(config_settings=None):
+    with open("log.txt", "a") as f:
+        print(":get_requires_for_build_wheel called", file=f)
+    return _get_requires_for_build_wheel(config_settings)
+
+def prepare_metadata_for_build_wheel(metadata_directory, config_settings=None):
+    with open("log.txt", "a") as f:
+        print(":prepare_metadata_for_build_wheel called", file=f)
+    return _prepare_metadata_for_build_wheel(metadata_directory, config_settings)
+
+def build_wheel(wheel_directory, config_settings=None, metadata_directory=None):
+    with open("log.txt", "a") as f:
+        print(":build_wheel called", file=f)
+    return _build_wheel(wheel_directory, config_settings, metadata_directory)
+"""
+
+# fmt: off
+BACKEND_WITH_PEP660 = BACKEND_WITHOUT_PEP660 + """
+def get_requires_for_build_editable(config_settings=None):
+    with open("log.txt", "a") as f:
+        print(":get_requires_for_build_editable called", file=f)
+    return _get_requires_for_build_wheel(config_settings)
+
+def prepare_metadata_for_build_editable(metadata_directory, config_settings=None):
+    with open("log.txt", "a") as f:
+        print(":prepare_metadata_for_build_editable called", file=f)
+    return _prepare_metadata_for_build_wheel(metadata_directory, config_settings)
+
+def build_editable(wheel_directory, config_settings=None, metadata_directory=None):
+    with open("log.txt", "a") as f:
+        print(":build_editable called", file=f)
+    return _build_wheel(wheel_directory, config_settings, metadata_directory)
+"""
+# fmt: on
+
+
+def _make_project(
+    tmpdir: Path, backend_code: str, with_setup_py: bool, with_pyproject: bool = True
+) -> Path:
+    project_dir = tmpdir / "project"
+    project_dir.mkdir()
+    project_dir.joinpath("setup.cfg").write_text(SETUP_CFG)
+    if with_setup_py:
+        project_dir.joinpath("setup.py").write_text(SETUP_PY)
+    if backend_code:
+        assert with_pyproject
+        buildsys: Dictstr, Any = {"requires": "setuptools", "wheel"}
+        buildsys"build-backend" = "test_backend"
+        buildsys"backend-path" = "."
+        data = tomli_w.dumps({"build-system": buildsys})
+        project_dir.joinpath("pyproject.toml").write_text(data)
+        project_dir.joinpath("test_backend.py").write_text(backend_code)
+    elif with_pyproject:
+        project_dir.joinpath("pyproject.toml").touch()
+    project_dir.joinpath("log.txt").touch()
+    return project_dir
+
+
+def _assert_hook_called(project_dir: Path, hook: str) -> None:
+    log = project_dir.joinpath("log.txt").read_text()
+    assert f":{hook} called" in log, f"{hook} has not been called"
+
+
+def _assert_hook_not_called(project_dir: Path, hook: str) -> None:
+    log = project_dir.joinpath("log.txt").read_text()
+    assert f":{hook} called" not in log, f"{hook} should not have been called"
+
+
+def test_install_pep517_basic(tmpdir: Path, script: PipTestEnvironment) -> None:
+    """
+    Check that the test harness we have in this file is sane.
+    """
+    project_dir = _make_project(tmpdir, BACKEND_WITHOUT_PEP660, with_setup_py=False)
+    script.pip(
+        "install",
+        "--no-index",
+        "--no-build-isolation",
+        project_dir,
+    )
+    _assert_hook_called(project_dir, "prepare_metadata_for_build_wheel")
+    _assert_hook_called(project_dir, "build_wheel")
+
+
+def test_install_pep660_basic(tmpdir: Path, script: PipTestEnvironment) -> None:
+    """
+    Test with backend that supports build_editable.
+    """
+    project_dir = _make_project(tmpdir, BACKEND_WITH_PEP660, with_setup_py=False)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--no-build-isolation",
+        "--editable",
+        project_dir,
+    )
+    _assert_hook_called(project_dir, "prepare_metadata_for_build_editable")
+    _assert_hook_called(project_dir, "build_editable")
+    assert (
+        result.test_env.site_packages.joinpath("project.egg-link")
+        not in result.files_created
+    ), "a .egg-link file should not have been created"
+
+
+def test_install_no_pep660_setup_py_fallback(
+    tmpdir: Path, script: PipTestEnvironment
+) -> None:
+    """
+    Test that we fall back to setuptools develop when using a backend that
+    does not support build_editable. Since there is a pyproject.toml,
+    the prepare_metadata_for_build_wheel hook is called.
+    """
+    project_dir = _make_project(tmpdir, BACKEND_WITHOUT_PEP660, with_setup_py=True)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--no-build-isolation",
+        "--editable",
+        project_dir,
+        allow_stderr_warning=False,
+    )
+    _assert_hook_called(project_dir, "prepare_metadata_for_build_wheel")
+    assert (
+        result.test_env.site_packages.joinpath("project.egg-link")
+        in result.files_created
+    ), "a .egg-link file should have been created"
+
+
+def test_install_no_pep660_setup_cfg_fallback(
+    tmpdir: Path, script: PipTestEnvironment
+) -> None:
+    """
+    Test that we fall back to setuptools develop when using a backend that
+    does not support build_editable. Since there is a pyproject.toml,
+    the prepare_metadata_for_build_wheel hook is called.
+    """
+    project_dir = _make_project(tmpdir, BACKEND_WITHOUT_PEP660, with_setup_py=False)
+    result = script.pip(
+        "install",
+        "--no-index",
+        "--no-build-isolation",
+        "--editable",
+        project_dir,
+        allow_stderr_warning=False,
+    )
+    print(result.stdout, result.stderr)
+    _assert_hook_called(project_dir, "prepare_metadata_for_build_wheel")
+    assert (
+        result.test_env.site_packages.joinpath("project.egg-link")
+        in result.files_created
+    ), ".egg-link file should have been created"
+
+
+def test_wheel_editable_pep660_basic(tmpdir: Path, script: PipTestEnvironment) -> None:
+    """
+    Test 'pip wheel' of an editable pep 660 project.
+    It must *not* call prepare_metadata_for_build_editable.
+    """
+    project_dir = _make_project(tmpdir, BACKEND_WITH_PEP660, with_setup_py=False)
+    wheel_dir = tmpdir / "dist"
+    script.pip(
+        "wheel",
+        "--no-index",
+        "--no-build-isolation",
+        "--editable",
+        project_dir,
+        "-w",
+        wheel_dir,
+    )
+    _assert_hook_not_called(project_dir, "prepare_metadata_for_build_editable")
+    _assert_hook_not_called(project_dir, "build_editable")
+    _assert_hook_called(project_dir, "prepare_metadata_for_build_wheel")
+    _assert_hook_called(project_dir, "build_wheel")
+    assert len(os.listdir(str(wheel_dir))) == 1, "a wheel should have been created"
+
+
+def test_download_editable_pep660_basic(
+    tmpdir: Path, script: PipTestEnvironment
+) -> None:
+    """
+    Test 'pip download' of an editable pep 660 project.
+    It must *not* call prepare_metadata_for_build_editable.
+    """
+    project_dir = _make_project(tmpdir, BACKEND_WITH_PEP660, with_setup_py=False)
+    reqs_file = tmpdir / "requirements.txt"
+    reqs_file.write_text(f"-e {project_dir.as_uri()}\n")
+    download_dir = tmpdir / "download"
+    script.pip(
+        "download",
+        "--no-index",
+        "--no-build-isolation",
+        "-r",
+        reqs_file,
+        "-d",
+        download_dir,
+    )
+    _assert_hook_not_called(project_dir, "prepare_metadata_for_build_editable")
+    _assert_hook_called(project_dir, "prepare_metadata_for_build_wheel")
+    assert len(os.listdir(str(download_dir))) == 1, "a zip should have been created"

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_pep668.py Added

@@ -0,0 +1,97 @@
+import json
+import pathlib
+import textwrap
+from typing import List
+
+import pytest
+
+from tests.lib import PipTestEnvironment, create_basic_wheel_for_package
+from tests.lib.venv import VirtualEnvironment
+
+
+@pytest.fixture()
+def patch_check_externally_managed(virtualenv: VirtualEnvironment) -> None:
+    # Since the tests are run from a virtual environment, and we can't
+    # guarantee access to the actual stdlib location (where EXTERNALLY-MANAGED
+    # needs to go into), we patch the check to always raise a simple message.
+    virtualenv.sitecustomize = textwrap.dedent(
+        """\
+        from pip._internal.exceptions import ExternallyManagedEnvironment
+        from pip._internal.utils import misc
+
+        def check_externally_managed():
+            raise ExternallyManagedEnvironment("I am externally managed")
+
+        misc.check_externally_managed = check_externally_managed
+        """
+    )
+
+
+@pytest.mark.parametrize(
+    "arguments",
+    
+        pytest.param("install", id="install"),
+        pytest.param("install", "--user", id="install-user"),
+        pytest.param("install", "--dry-run", id="install-dry-run"),
+        pytest.param("uninstall", "-y", id="uninstall"),
+    ,
+)
+@pytest.mark.usefixtures("patch_check_externally_managed")
+def test_fails(script: PipTestEnvironment, arguments: Liststr) -> None:
+    result = script.pip(*arguments, "pip", expect_error=True)
+    assert "I am externally managed" in result.stderr
+
+
+@pytest.mark.parametrize(
+    "arguments",
+    
+        pytest.param("install", id="install"),
+        pytest.param("install", "--dry-run", id="install-dry-run"),
+        pytest.param("uninstall", "-y", id="uninstall"),
+    ,
+)
+@pytest.mark.usefixtures("patch_check_externally_managed")
+def test_succeeds_when_overridden(
+    script: PipTestEnvironment, arguments: Liststr
+) -> None:
+    result = script.pip(*arguments, "pip", "--break-system-packages")
+    assert "I am externally managed" not in result.stderr
+
+
+@pytest.mark.parametrize(
+    "arguments",
+    
+        pytest.param("install", "--root", id="install-root"),
+        pytest.param("install", "--prefix", id="install-prefix"),
+        pytest.param("install", "--target", id="install-target"),
+    ,
+)
+@pytest.mark.usefixtures("patch_check_externally_managed")
+def test_allows_if_out_of_environment(
+    script: PipTestEnvironment,
+    arguments: Liststr,
+) -> None:
+    wheel = create_basic_wheel_for_package(script, "foo", "1.0")
+    result = script.pip(*arguments, script.scratch_path, wheel.as_uri())
+    assert "Successfully installed foo-1.0" in result.stdout
+    assert "I am externally managed" not in result.stderr
+
+
+@pytest.mark.usefixtures("patch_check_externally_managed")
+def test_allows_install_dry_run(
+    script: PipTestEnvironment,
+    tmp_path: pathlib.Path,
+) -> None:
+    output = tmp_path.joinpath("out.json")
+    wheel = create_basic_wheel_for_package(script, "foo", "1.0")
+    result = script.pip(
+        "install",
+        "--dry-run",
+        f"--report={output.as_posix()}",
+        wheel.as_uri(),
+        expect_stderr=True,
+    )
+    assert "Would install foo-1.0" in result.stdout
+    assert "I am externally managed" not in result.stderr
+    with output.open(encoding="utf8") as f:
+        assert isinstance(json.load(f), dict)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_pip_runner_script.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_python_option.py Added

@@ -0,0 +1,41 @@
+import json
+import os
+from pathlib import Path
+from venv import EnvBuilder
+
+from tests.lib import PipTestEnvironment, TestData
+
+
+def test_python_interpreter(
+    script: PipTestEnvironment,
+    tmpdir: Path,
+    shared_data: TestData,
+) -> None:
+    env_path = os.fspath(tmpdir / "venv")
+    env = EnvBuilder(with_pip=False)
+    env.create(env_path)
+
+    result = script.pip("--python", env_path, "list", "--format=json")
+    before = json.loads(result.stdout)
+
+    # Ideally we would assert that before==, but there's a problem in CI
+    # that means this isn't true. See https://github.com/pypa/pip/pull/11326
+    # for details.
+
+    script.pip(
+        "--python",
+        env_path,
+        "install",
+        "-f",
+        shared_data.find_links,
+        "--no-index",
+        "simplewheel==1.0",
+    )
+
+    result = script.pip("--python", env_path, "list", "--format=json")
+    installed = json.loads(result.stdout)
+    assert {"name": "simplewheel", "version": "1.0"} in installed
+
+    script.pip("--python", env_path, "uninstall", "simplewheel", "--yes")
+    result = script.pip("--python", env_path, "list", "--format=json")
+    assert json.loads(result.stdout) == before

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_search.py Added

@@ -0,0 +1,209 @@
+import logging
+from typing import TYPE_CHECKING, Dict, List
+from unittest import mock
+
+import pytest
+
+from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS
+from pip._internal.commands import create_command
+from pip._internal.commands.search import highest_version, print_results, transform_hits
+from tests.lib import PipTestEnvironment
+
+if TYPE_CHECKING:
+    from pip._internal.commands.search import TransformedHit
+
+
+def test_version_compare() -> None:
+    """
+    Test version comparison.
+
+    """
+    assert highest_version("1.0", "2.0", "0.1") == "2.0"
+    assert highest_version("1.0a1", "1.0") == "1.0"
+
+
+def test_pypi_xml_transformation() -> None:
+    """
+    Test transformation of data structures (PyPI xmlrpc to custom list).
+
+    """
+    pypi_hits: ListDictstr, str = 
+        {
+            "name": "foo",
+            "summary": "foo summary",
+            "version": "1.0",
+        },
+        {
+            "name": "foo",
+            "summary": "foo summary v2",
+            "version": "2.0",
+        },
+        {
+            "_pypi_ordering": 50,  # type: ignoredict-item
+            "name": "bar",
+            "summary": "bar summary",
+            "version": "1.0",
+        },
+    
+    expected: List"TransformedHit" = 
+        {
+            "versions": "1.0", "2.0",
+            "name": "foo",
+            "summary": "foo summary v2",
+        },
+        {
+            "versions": "1.0",
+            "name": "bar",
+            "summary": "bar summary",
+        },
+    
+    assert transform_hits(pypi_hits) == expected
+
+
+@pytest.mark.network
+@pytest.mark.search
+def test_basic_search(script: PipTestEnvironment) -> None:
+    """
+    End to end test of search command.
+
+    """
+    output = script.pip("search", "pip")
+    assert "The PyPA recommended tool for installing Python packages." in output.stdout
+
+
+@pytest.mark.network
+@pytest.mark.skip(
+    reason=(
+        "Warehouse search behavior is different and no longer returns "
+        "multiple results. See "
+        "https://github.com/pypa/warehouse/issues/3717 for more "
+        "information."
+    ),
+)
+@pytest.mark.search
+def test_multiple_search(script: PipTestEnvironment) -> None:
+    """
+    Test searching for multiple packages at once.
+
+    """
+    output = script.pip("search", "pip", "INITools")
+    assert "The PyPA recommended tool for installing Python packages." in output.stdout
+    assert "Tools for parsing and using INI-style files" in output.stdout
+
+
+@pytest.mark.search
+def test_search_missing_argument(script: PipTestEnvironment) -> None:
+    """
+    Test missing required argument for search
+    """
+    result = script.pip("search", expect_error=True)
+    assert "ERROR: Missing required argument (search query)." in result.stderr
+
+
+@pytest.mark.network
+@pytest.mark.search
+def test_run_method_should_return_success_when_find_packages() -> None:
+    """
+    Test SearchCommand.run for found package
+    """
+    command = create_command("search")
+    cmdline = "--index=https://pypi.org/pypi pip"
+    with command.main_context():
+        options, args = command.parse_args(cmdline.split())
+        status = command.run(options, args)
+    assert status == SUCCESS
+
+
+@pytest.mark.network
+@pytest.mark.search
+def test_run_method_should_return_no_matches_found_when_does_not_find_pkgs() -> None:
+    """
+    Test SearchCommand.run for no matches
+    """
+    command = create_command("search")
+    cmdline = "--index=https://pypi.org/pypi nonexistentpackage"
+    with command.main_context():
+        options, args = command.parse_args(cmdline.split())
+        status = command.run(options, args)
+    assert status == NO_MATCHES_FOUND
+
+
+@pytest.mark.network
+@pytest.mark.search
+def test_search_should_exit_status_code_zero_when_find_packages(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test search exit status code for package found
+    """
+    result = script.pip("search", "pip")
+    assert result.returncode == SUCCESS
+
+
+@pytest.mark.network
+@pytest.mark.search
+def test_search_exit_status_code_when_finds_no_package(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test search exit status code for no matches
+    """
+    result = script.pip("search", "nonexistentpackage", expect_error=True)
+    assert result.returncode == NO_MATCHES_FOUND, result.returncode
+
+
+@pytest.mark.search
+def test_latest_prerelease_install_message(
+    caplog: pytest.LogCaptureFixture, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    """
+    Test documentation for installing pre-release packages is displayed
+    """
+    hits: List"TransformedHit" = 
+        {
+            "name": "ni",
+            "summary": "For knights who say Ni!",
+            "versions": "1.0.0", "1.0.1a",
+        }
+    
+
+    installed_package = mock.Mock(project_name="ni")
+    monkeypatch.setattr("pip._vendor.pkg_resources.working_set", installed_package)
+
+    get_dist = mock.Mock()
+    get_dist.return_value = mock.Mock(version="1.0.0")
+    monkeypatch.setattr("pip._internal.commands.search.get_distribution", get_dist)
+    with caplog.at_level(logging.INFO):
+        print_results(hits)
+
+    message = caplog.records-1.getMessage()
+    assert 'pre-release; install with "pip install --pre"' in message
+    assert get_dist.call_args_list == mock.call("ni")
+
+
+@pytest.mark.search
+def test_search_print_results_should_contain_latest_versions(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    """
+    Test that printed search results contain the latest package versions
+    """
+    hits: List"TransformedHit" = 
+        {
+            "name": "testlib1",
+            "summary": "Test library 1.",
+            "versions": "1.0.5", "1.0.3",
+        },
+        {
+            "name": "testlib2",
+            "summary": "Test library 1.",
+            "versions": "2.0.1", "2.0.3",
+        },
+    
+
+    with caplog.at_level(logging.INFO):
+        print_results(hits)
+
+    log_messages = sorted(r.getMessage() for r in caplog.records)
+    assert log_messages0.startswith("testlib1 (1.0.5)")
+    assert log_messages1.startswith("testlib2 (2.0.3)")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_show.py Added

@@ -0,0 +1,352 @@
+import os
+import pathlib
+import re
+import textwrap
+
+from pip import __version__
+from pip._internal.commands.show import search_packages_info
+from pip._internal.utils.unpacking import untar_file
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    create_test_package_with_setup,
+    pyversion,
+)
+
+
+def test_basic_show(script: PipTestEnvironment) -> None:
+    """
+    Test end to end test for show command.
+    """
+    result = script.pip("show", "pip")
+    lines = result.stdout.splitlines()
+    assert len(lines) == 11
+    assert "Name: pip" in lines
+    assert f"Version: {__version__}" in lines
+    assert any(line.startswith("Location: ") for line in lines)
+    assert "Requires: " in lines
+
+
+def test_show_with_files_not_found(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test for show command with installed files listing enabled and
+    installed-files.txt not found.
+    """
+    editable = data.packages.joinpath("SetupPyUTF8")
+    script.pip("install", "-e", editable)
+    result = script.pip("show", "-f", "SetupPyUTF8")
+    lines = result.stdout.splitlines()
+    assert len(lines) == 13
+    assert "Name: SetupPyUTF8" in lines
+    assert "Version: 0.0.0" in lines
+    assert any(line.startswith("Location: ") for line in lines)
+    assert "Requires: " in lines
+    assert "Files:" in lines
+    assert "Cannot locate RECORD or installed-files.txt" in lines
+
+
+def test_show_with_files_from_wheel(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test that a wheel's files can be listed.
+    """
+    wheel_file = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    script.pip("install", "--no-index", wheel_file)
+    result = script.pip("show", "-f", "simple.dist")
+    lines = result.stdout.splitlines()
+    assert "Name: simple.dist" in lines
+    assert "Cannot locate RECORD or installed-files.txt" not in lines6, lines6
+    assert re.search(r"Files:\n(  .+\n)+", result.stdout)
+    assert f"  simpledist{os.sep}__init__.py" in lines6:
+
+
+def test_show_with_files_from_legacy(
+    tmp_path: pathlib.Path, script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test listing files in the show command (legacy installed-files.txt).
+    """
+    # Since 'pip install' now always tries to build a wheel from sdist, it
+    # cannot properly generate a setup. The legacy code path is basically
+    # 'setup.py install' plus installed-files.txt, which we manually generate.
+    source_dir = tmp_path.joinpath("unpacked-sdist")
+    setuptools_record = tmp_path.joinpath("installed-record.txt")
+    untar_file(os.fspath(data.packages.joinpath("simple-1.0.tar.gz")), str(source_dir))
+    script.run(
+        "python",
+        "setup.py",
+        "install",
+        "--single-version-externally-managed",
+        "--record",
+        str(setuptools_record),
+        cwd=source_dir,
+    )
+    # Emulate the installed-files.txt generation which previous pip version did
+    # after running setup.py install (write_installed_files_from_setuptools_record).
+    egg_info_dir = script.site_packages_path / f"simple-1.0-py{pyversion}.egg-info"
+    egg_info_dir.joinpath("installed-files.txt").write_text(
+        textwrap.dedent(
+            """\
+                ../simple/__init__.py
+                PKG-INFO
+                SOURCES.txt
+                dependency_links.txt
+                top_level.txt
+            """
+        )
+    )
+
+    result = script.pip("show", "--files", "simple")
+    lines = result.stdout.splitlines()
+    assert "Cannot locate RECORD or installed-files.txt" not in lines6, lines6
+    assert re.search(r"Files:\n(  .+\n)+", result.stdout)
+    assert f"  simple{os.sep}__init__.py" in lines6:
+
+
+def test_missing_argument(script: PipTestEnvironment) -> None:
+    """
+    Test show command with no arguments.
+    """
+    result = script.pip("show", expect_error=True)
+    assert "ERROR: Please provide a package name or names." in result.stderr
+
+
+def test_find_package_not_found() -> None:
+    """
+    Test trying to get info about a nonexistent package.
+    """
+    result = search_packages_info("abcd3")
+    assert len(list(result)) == 0
+
+
+def test_report_single_not_found(script: PipTestEnvironment) -> None:
+    """
+    Test passing one name and that isn't found.
+    """
+    # We choose a non-canonicalized name to test that the non-canonical
+    # form is logged.
+    # Also, the following should report an error as there are no results
+    # to print. Consequently, there is no need to pass
+    # allow_stderr_warning=True since this is implied by expect_error=True.
+    result = script.pip("show", "Abcd-3", expect_error=True)
+    assert "WARNING: Package(s) not found: Abcd-3" in result.stderr
+    assert not result.stdout.splitlines()
+
+
+def test_report_mixed_not_found(script: PipTestEnvironment) -> None:
+    """
+    Test passing a mixture of found and not-found names.
+    """
+    # We test passing non-canonicalized names.
+    result = script.pip("show", "Abcd3", "A-B-C", "pip", allow_stderr_warning=True)
+    assert "WARNING: Package(s) not found: A-B-C, Abcd3" in result.stderr
+    lines = result.stdout.splitlines()
+    assert len(lines) == 11
+    assert "Name: pip" in lines
+
+
+def test_search_any_case() -> None:
+    """
+    Search for a package in any case.
+
+    """
+    result = list(search_packages_info("PIP"))
+    assert len(result) == 1
+    assert result0.name == "pip"
+
+
+def test_more_than_one_package() -> None:
+    """
+    Search for more than one package.
+
+    """
+    result = list(search_packages_info("pIp", "pytest", "Virtualenv"))
+    assert len(result) == 3
+
+
+def test_show_verbose_with_classifiers(script: PipTestEnvironment) -> None:
+    """
+    Test that classifiers can be listed
+    """
+    result = script.pip("show", "pip", "--verbose")
+    lines = result.stdout.splitlines()
+    assert "Name: pip" in lines
+    assert re.search(r"Classifiers:\n(  .+\n)+", result.stdout)
+    assert "Intended Audience :: Developers" in result.stdout
+
+
+def test_show_verbose_installer(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test that the installer is shown (this currently needs a wheel install)
+    """
+    wheel_file = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    script.pip("install", "--no-index", wheel_file)
+    result = script.pip("show", "--verbose", "simple.dist")
+    lines = result.stdout.splitlines()
+    assert "Name: simple.dist" in lines
+    assert "Installer: pip" in lines
+
+
+def test_show_verbose_project_urls(script: PipTestEnvironment) -> None:
+    """
+    Test that project urls can be listed
+    """
+    result = script.pip("show", "pip", "--verbose")
+    lines = result.stdout.splitlines()
+    assert "Name: pip" in lines
+    assert re.search(r"Project-URLs:\n(  .+\n)+", result.stdout)
+    assert "Source, https://github.com/pypa/pip" in result.stdout
+
+
+def test_show_verbose(script: PipTestEnvironment) -> None:
+    """
+    Test end to end test for verbose show command.
+    """
+    result = script.pip("show", "--verbose", "pip")
+    lines = result.stdout.splitlines()
+    assert any(line.startswith("Metadata-Version: ") for line in lines)
+    assert any(line.startswith("Installer: ") for line in lines)
+    assert "Entry-points:" in lines
+    assert "Classifiers:" in lines
+    assert "Project-URLs:" in lines
+
+
+def test_all_fields(script: PipTestEnvironment) -> None:
+    """
+    Test that all the fields are present
+    """
+    result = script.pip("show", "pip")
+    lines = result.stdout.splitlines()
+    expected = {
+        "Name",
+        "Version",
+        "Summary",
+        "Home-page",
+        "Author",
+        "Author-email",
+        "License",
+        "Location",
+        "Editable project location",
+        "Requires",
+        "Required-by",
+    }
+    actual = {re.sub(":.*$", "", line) for line in lines}
+    assert actual == expected
+
+
+def test_pip_show_is_short(script: PipTestEnvironment) -> None:
+    """
+    Test that pip show stays short
+    """
+    result = script.pip("show", "pip")
+    lines = result.stdout.splitlines()
+    assert len(lines) <= 11
+
+
+def test_pip_show_divider(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Expect a divider between packages
+    """
+    script.pip("install", "pip-test-package", "--no-index", "-f", data.packages)
+    result = script.pip("show", "pip", "pip-test-package")
+    lines = result.stdout.splitlines()
+    assert "---" in lines
+
+
+def test_package_name_is_canonicalized(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.pip("install", "pip-test-package", "--no-index", "-f", data.packages)
+
+    dash_show_result = script.pip("show", "pip-test-package")
+    underscore_upper_show_result = script.pip("show", "pip-test_Package")
+
+    assert underscore_upper_show_result.returncode == 0
+    assert underscore_upper_show_result.stdout == dash_show_result.stdout
+
+
+def test_show_required_by_packages_basic(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test that installed packages that depend on this package are shown
+    """
+    editable_path = os.path.join(data.src, "requires_simple")
+    script.pip("install", "--no-index", "-f", data.find_links, editable_path)
+
+    result = script.pip("show", "simple")
+    lines = result.stdout.splitlines()
+
+    assert "Name: simple" in lines
+    assert "Required-by: requires-simple" in lines
+
+
+def test_show_required_by_packages_capitalized(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test that the installed packages which depend on a package are shown
+    where the package has a capital letter
+    """
+    editable_path = os.path.join(data.src, "requires_capitalized")
+    script.pip("install", "--no-index", "-f", data.find_links, editable_path)
+
+    result = script.pip("show", "simple")
+    lines = result.stdout.splitlines()
+
+    assert "Name: simple" in lines
+    assert "Required-by: Requires-Capitalized" in lines
+
+
+def test_show_required_by_packages_requiring_capitalized(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test that the installed packages which depend on a package are shown
+    where the package has a name with a mix of
+    lower and upper case letters
+    """
+    required_package_path = os.path.join(data.src, "requires_capitalized")
+    script.pip("install", "--no-index", "-f", data.find_links, required_package_path)
+    editable_path = os.path.join(data.src, "requires_requires_capitalized")
+    script.pip("install", "--no-index", "-f", data.find_links, editable_path)
+
+    result = script.pip("show", "Requires_Capitalized")
+    lines = result.stdout.splitlines()
+    print(lines)
+
+    assert "Name: Requires-Capitalized" in lines
+    assert "Required-by: requires-requires-capitalized" in lines
+
+
+def test_show_skip_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that show should not include package
+    present in working directory
+    """
+
+    # Create a test package and create .egg-info dir
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    # Show should not include package simple when run from package directory
+    result = script.pip("show", "simple", expect_error=True, cwd=pkg_path)
+    assert "WARNING: Package(s) not found: simple" in result.stderr
+
+
+def test_show_include_work_dir_pkg(script: PipTestEnvironment) -> None:
+    """
+    Test that show should include package in working directory
+    if working directory is added in PYTHONPATH
+    """
+
+    # Create a test package and create .egg-info dir
+    pkg_path = create_test_package_with_setup(script, name="simple", version="1.0")
+    script.run("python", "setup.py", "egg_info", expect_stderr=True, cwd=pkg_path)
+
+    script.environ.update({"PYTHONPATH": pkg_path})
+
+    # Show should include package simple when run from package directory,
+    # when package directory is in PYTHONPATH
+    result = script.pip("show", "simple", cwd=pkg_path)
+    lines = result.stdout.splitlines()
+    assert "Name: simple" in lines

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_truststore.py Added

@@ -0,0 +1,61 @@
+import sys
+from typing import Any, Callable
+
+import pytest
+
+from tests.lib import PipTestEnvironment, TestPipResult
+
+PipRunner = Callable..., TestPipResult
+
+
+@pytest.fixture()
+def pip(script: PipTestEnvironment) -> PipRunner:
+    def pip(*args: str, **kwargs: Any) -> TestPipResult:
+        return script.pip(*args, "--use-feature=truststore", **kwargs)
+
+    return pip
+
+
+@pytest.mark.skipif(sys.version_info >= (3, 10), reason="3.10 can run truststore")
+def test_truststore_error_on_old_python(pip: PipRunner) -> None:
+    result = pip(
+        "install",
+        "--no-index",
+        "does-not-matter",
+        expect_error=True,
+    )
+    assert "The truststore feature is only available for Python 3.10+" in result.stderr
+
+
+@pytest.mark.skipif(sys.version_info < (3, 10), reason="3.10+ required for truststore")
+def test_truststore_error_without_preinstalled(pip: PipRunner) -> None:
+    result = pip(
+        "install",
+        "--no-index",
+        "does-not-matter",
+        expect_error=True,
+    )
+    assert (
+        "To use the truststore feature, 'truststore' must be installed into "
+        "pip's current environment."
+    ) in result.stderr
+
+
+@pytest.mark.skipif(sys.version_info < (3, 10), reason="3.10+ required for truststore")
+@pytest.mark.network
+@pytest.mark.parametrize(
+    "package",
+    
+        "INITools",
+        "https://github.com/pypa/pip-test-package/archive/refs/heads/master.zip",
+    ,
+    ids="PyPI", "GitHub",
+)
+def test_trustore_can_install(
+    script: PipTestEnvironment,
+    pip: PipRunner,
+    package: str,
+) -> None:
+    script.pip("install", "truststore")
+    result = pip("install", package)
+    assert "Successfully installed" in result.stdout

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_uninstall.py Added

@@ -0,0 +1,737 @@
+import logging
+import os
+import sys
+import textwrap
+from os.path import join, normpath
+from pathlib import Path
+from tempfile import mkdtemp
+from typing import Any, Iterator
+from unittest.mock import Mock
+
+import pytest
+
+from pip._internal.req.constructors import install_req_from_line
+from pip._internal.utils.misc import rmtree
+from tests.lib import (
+    PipTestEnvironment,
+    TestData,
+    assert_all_changes,
+    create_test_package_with_setup,
+    need_svn,
+)
+from tests.lib.local_repos import local_checkout, local_repo
+
+
+@pytest.mark.network
+def test_basic_uninstall(script: PipTestEnvironment) -> None:
+    """
+    Test basic install and uninstall.
+
+    """
+    result = script.pip("install", "INITools==0.2")
+    result.did_create(join(script.site_packages, "initools"))
+    # the import forces the generation of __pycache__ if the version of python
+    # supports it
+    script.run("python", "-c", "import initools")
+    result2 = script.pip("uninstall", "INITools", "-y")
+    assert_all_changes(result, result2, script.venv / "build", "cache")
+
+
+def test_basic_uninstall_distutils(script: PipTestEnvironment) -> None:
+    """
+    Test basic install and uninstall.
+
+    """
+    script.scratch_path.joinpath("distutils_install").mkdir()
+    pkg_path = script.scratch_path / "distutils_install"
+    pkg_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+        from distutils.core import setup
+        setup(
+            name='distutils-install',
+            version='0.1',
+        )
+    """
+        )
+    )
+    result = script.run("python", os.fspath(pkg_path / "setup.py"), "install")
+    result = script.pip("list", "--format=json")
+    script.assert_installed(distutils_install="0.1")
+    result = script.pip(
+        "uninstall", "distutils_install", "-y", expect_stderr=True, expect_error=True
+    )
+    assert (
+        "Cannot uninstall 'distutils-install'. It is a distutils installed "
+        "project and thus we cannot accurately determine which files belong "
+        "to it which would lead to only a partial uninstall."
+    ) in result.stderr
+
+
+@pytest.mark.network
+def test_basic_uninstall_with_scripts(script: PipTestEnvironment) -> None:
+    """
+    Uninstall an easy_installed package with scripts.
+
+    """
+    # setuptools 52 removed easy_install.
+    script.pip("install", "setuptools==51.3.3", use_module=True)
+
+    result = script.easy_install("PyLogo", expect_stderr=True)
+    easy_install_pth = script.site_packages / "easy-install.pth"
+    pylogo = sys.platform == "win32" and "pylogo" or "PyLogo"
+    assert pylogo in result.files_updatedos.fspath(easy_install_pth).bytes
+    result2 = script.pip("uninstall", "pylogo", "-y")
+    assert_all_changes(
+        result,
+        result2,
+        script.venv / "build", "cache", easy_install_pth,
+    )
+
+
+@pytest.mark.parametrize("name", "GTrolls.tar.gz", "https://guyto.com/archives/")
+def test_uninstall_invalid_parameter(
+    script: PipTestEnvironment, caplog: pytest.LogCaptureFixture, name: str
+) -> None:
+    result = script.pip("uninstall", name, "-y", expect_error=True)
+    expected_message = (
+        f"Invalid requirement: '{name}' ignored -"
+        f" the uninstall command expects named requirements."
+    )
+    assert expected_message in result.stderr
+
+
+@pytest.mark.network
+def test_uninstall_easy_install_after_import(script: PipTestEnvironment) -> None:
+    """
+    Uninstall an easy_installed package after it's been imported
+
+    """
+    # setuptools 52 removed easy_install.
+    script.pip("install", "setuptools==51.3.3", use_module=True)
+
+    result = script.easy_install("INITools==0.2", expect_stderr=True)
+    # the import forces the generation of __pycache__ if the version of python
+    # supports it
+    script.run("python", "-c", "import initools")
+    result2 = script.pip("uninstall", "INITools", "-y")
+    assert_all_changes(
+        result,
+        result2,
+        
+            script.venv / "build",
+            "cache",
+            script.site_packages / "easy-install.pth",
+        ,
+    )
+
+
+@pytest.mark.network
+def test_uninstall_trailing_newline(script: PipTestEnvironment) -> None:
+    """
+    Uninstall behaves appropriately if easy-install.pth
+    lacks a trailing newline
+
+    """
+    # setuptools 52 removed easy_install.
+    script.pip("install", "setuptools==51.3.3", use_module=True)
+
+    script.easy_install("INITools==0.2", expect_stderr=True)
+    script.easy_install("PyLogo", expect_stderr=True)
+    easy_install_pth = script.site_packages_path / "easy-install.pth"
+
+    # trim trailing newline from easy-install.pth
+    with open(easy_install_pth) as f:
+        pth_before = f.read()
+
+    with open(easy_install_pth, "w") as f:
+        f.write(pth_before.rstrip())
+
+    # uninstall initools
+    script.pip("uninstall", "INITools", "-y")
+    with open(easy_install_pth) as f:
+        pth_after = f.read()
+
+    # verify that only initools is removed
+    before_without_initools = 
+        line for line in pth_before.splitlines() if "initools" not in line.lower()
+    
+    lines_after = pth_after.splitlines()
+
+    assert lines_after == before_without_initools
+
+
+@pytest.mark.network
+def test_basic_uninstall_namespace_package(script: PipTestEnvironment) -> None:
+    """
+    Uninstall a distribution with a namespace package without clobbering
+    the namespace and everything in it.
+
+    """
+    result = script.pip("install", "pd.requires==0.0.3")
+    result.did_create(join(script.site_packages, "pd"))
+    result2 = script.pip("uninstall", "pd.find", "-y")
+    assert join(script.site_packages, "pd") not in result2.files_deleted, sorted(
+        result2.files_deleted.keys()
+    )
+    assert join(script.site_packages, "pd", "find") in result2.files_deleted, sorted(
+        result2.files_deleted.keys()
+    )
+
+
+def test_uninstall_overlapping_package(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Uninstalling a distribution that adds modules to a pre-existing package
+    should only remove those added modules, not the rest of the existing
+    package.
+
+    See: GitHub issue #355 (pip uninstall removes things it didn't install)
+    """
+    parent_pkg = data.packages.joinpath("parent-0.1.tar.gz")
+    child_pkg = data.packages.joinpath("child-0.1.tar.gz")
+
+    result1 = script.pip("install", parent_pkg)
+    result1.did_create(join(script.site_packages, "parent"))
+    result2 = script.pip("install", child_pkg)
+    result2.did_create(join(script.site_packages, "child"))
+    result2.did_create(
+        normpath(join(script.site_packages, "parent/plugins/child_plugin.py"))
+    )
+    # The import forces the generation of __pycache__ if the version of python
+    #  supports it
+    script.run("python", "-c", "import parent.plugins.child_plugin, child")
+    result3 = script.pip("uninstall", "-y", "child")
+    assert join(script.site_packages, "child") in result3.files_deleted, sorted(
+        result3.files_created.keys()
+    )
+    assert (
+        normpath(join(script.site_packages, "parent/plugins/child_plugin.py"))
+        in result3.files_deleted
+    ), sorted(result3.files_deleted.keys())
+    assert join(script.site_packages, "parent") not in result3.files_deleted, sorted(
+        result3.files_deleted.keys()
+    )
+    # Additional check: uninstalling 'child' should return things to the
+    # previous state, without unintended side effects.
+    assert_all_changes(result2, result3, )
+
+
+@pytest.mark.parametrize(
+    "console_scripts",
+    
+        "test_ = distutils_install:test",
+        pytest.param(
+            "test_:test_ = distutils_install:test_test",
+            marks=pytest.mark.xfail(
+                reason="colon not supported in wheel entry point name?"
+            ),
+        ),
+    ,
+)
+def test_uninstall_entry_point_colon_in_name(
+    script: PipTestEnvironment, console_scripts: str
+) -> None:
+    """
+    Test uninstall package with two or more entry points in the same section,
+    whose name contain a colon.
+    """
+    pkg_name = "ep_install"
+    pkg_path = create_test_package_with_setup(
+        script,
+        name=pkg_name,
+        version="0.1",
+        entry_points={
+            "console_scripts": 
+                console_scripts,
+            ,
+            "pip_test.ep": 
+                "ep:name1 = distutils_install",
+                "ep:name2 = distutils_install",
+            ,
+        },
+    )
+    script_name = script.bin_path.joinpath(console_scripts.split("=")0.strip())
+    if sys.platform == "win32":
+        script_name = script_name.with_suffix(".exe")
+    script.pip("install", pkg_path)
+    assert script_name.exists()
+    script.assert_installed(ep_install="0.1")
+
+    script.pip("uninstall", "ep_install", "-y")
+    assert not script_name.exists()
+    script.assert_not_installed("ep-install")
+
+
+def test_uninstall_gui_scripts(script: PipTestEnvironment) -> None:
+    """
+    Make sure that uninstall removes gui scripts
+    """
+    pkg_name = "gui_pkg"
+    pkg_path = create_test_package_with_setup(
+        script,
+        name=pkg_name,
+        version="0.1",
+        entry_points={
+            "gui_scripts": 
+                "test_ = distutils_install:test",
+            ,
+        },
+    )
+    script_name = script.bin_path.joinpath("test_")
+    if sys.platform == "win32":
+        script_name = script_name.with_suffix(".exe")
+    script.pip("install", pkg_path)
+    assert script_name.exists()
+    script.pip("uninstall", pkg_name, "-y")
+    assert not script_name.exists()
+
+
+def test_uninstall_console_scripts(script: PipTestEnvironment) -> None:
+    """
+    Test uninstalling a package with more files (console_script entry points,
+    extra directories).
+    """
+    pkg_path = create_test_package_with_setup(
+        script,
+        name="discover",
+        version="0.1",
+        entry_points={"console_scripts": "discover = discover:main"},
+    )
+    result = script.pip("install", pkg_path)
+    result.did_create(script.bin / f"discover{script.exe}")
+    result2 = script.pip("uninstall", "discover", "-y")
+    assert_all_changes(
+        result,
+        result2,
+        
+            os.path.join(script.venv, "build"),
+            "cache",
+            os.path.join("scratch", "discover", "discover.egg-info"),
+            os.path.join("scratch", "discover", "build"),
+        ,
+    )
+
+
+def test_uninstall_console_scripts_uppercase_name(script: PipTestEnvironment) -> None:
+    """
+    Test uninstalling console script with uppercase character.
+    """
+    pkg_path = create_test_package_with_setup(
+        script,
+        name="ep_install",
+        version="0.1",
+        entry_points={
+            "console_scripts": 
+                "Test = distutils_install:Test",
+            ,
+        },
+    )
+    script_name = script.bin_path.joinpath("Test" + script.exe)
+
+    script.pip("install", pkg_path)
+    assert script_name.exists()
+
+    script.pip("uninstall", "ep_install", "-y")
+    assert not script_name.exists()
+
+
+@pytest.mark.network
+def test_uninstall_easy_installed_console_scripts(script: PipTestEnvironment) -> None:
+    """
+    Test uninstalling package with console_scripts that is easy_installed.
+    """
+    # setuptools 52 removed easy_install and prints a warning after 42 when
+    # the command is used.
+    script.pip("install", "setuptools==51.3.3", use_module=True)
+
+    result = script.easy_install("discover", allow_stderr_warning=True)
+    result.did_create(script.bin / f"discover{script.exe}")
+    result2 = script.pip("uninstall", "discover", "-y")
+    assert_all_changes(
+        result,
+        result2,
+        
+            script.venv / "build",
+            "cache",
+            script.site_packages / "easy-install.pth",
+        ,
+    )
+
+
+@pytest.mark.xfail
+@pytest.mark.network
+@need_svn
+def test_uninstall_editable_from_svn(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """
+    Test uninstalling an editable installation from svn.
+    """
+    result = script.pip(
+        "install",
+        "-e",
+        "{checkout}#egg=initools".format(
+            checkout=local_checkout("svn+http://svn.colorstudy.com/INITools", tmpdir)
+        ),
+    )
+    result.assert_installed("INITools")
+    result2 = script.pip("uninstall", "-y", "initools")
+    assert script.venv / "src" / "initools" in result2.files_after
+    assert_all_changes(
+        result,
+        result2,
+        
+            script.venv / "src",
+            script.venv / "build",
+            script.site_packages / "easy-install.pth",
+        ,
+    )
+
+
+@pytest.mark.network
+def test_uninstall_editable_with_source_outside_venv(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test uninstalling editable install from existing source outside the venv.
+    """
+    try:
+        temp = mkdtemp()
+        temp_pkg_dir = join(temp, "pip-test-package")
+        _test_uninstall_editable_with_source_outside_venv(
+            script,
+            tmpdir,
+            temp_pkg_dir,
+        )
+    finally:
+        rmtree(temp)
+
+
+def _test_uninstall_editable_with_source_outside_venv(
+    script: PipTestEnvironment,
+    tmpdir: Path,
+    temp_pkg_dir: str,
+) -> None:
+    result = script.run(
+        "git",
+        "clone",
+        local_repo("git+https://github.com/pypa/pip-test-package", tmpdir),
+        temp_pkg_dir,
+        expect_stderr=True,
+    )
+    result2 = script.pip("install", "-e", temp_pkg_dir)
+    result2.did_create(join(script.site_packages, "pip-test-package.egg-link"))
+    result3 = script.pip("uninstall", "-y", "pip-test-package")
+    assert_all_changes(
+        result,
+        result3,
+        script.venv / "build", script.site_packages / "easy-install.pth",
+    )
+
+
+@pytest.mark.xfail
+@pytest.mark.network
+@need_svn
+def test_uninstall_from_reqs_file(script: PipTestEnvironment, tmpdir: Path) -> None:
+    """
+    Test uninstall from a requirements file.
+
+    """
+    local_svn_url = local_checkout(
+        "svn+http://svn.colorstudy.com/INITools",
+        tmpdir,
+    )
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+            -e {url}#egg=initools
+            # and something else to test out:
+            PyLogo<0.4
+        """
+        ).format(url=local_svn_url)
+    )
+    result = script.pip("install", "-r", "test-req.txt")
+    script.scratch_path.joinpath("test-req.txt").write_text(
+        textwrap.dedent(
+            """
+            # -f, -i, and --extra-index-url should all be ignored by uninstall
+            -f http://www.example.com
+            -i http://www.example.com
+            --extra-index-url http://www.example.com
+
+            -e {url}#egg=initools
+            # and something else to test out:
+            PyLogo<0.4
+        """
+        ).format(url=local_svn_url)
+    )
+    result2 = script.pip("uninstall", "-r", "test-req.txt", "-y")
+    assert_all_changes(
+        result,
+        result2,
+        
+            script.venv / "build",
+            script.venv / "src",
+            script.scratch / "test-req.txt",
+            script.site_packages / "easy-install.pth",
+        ,
+    )
+
+
+def test_uninstallpathset_no_paths(caplog: pytest.LogCaptureFixture) -> None:
+    """
+    Test UninstallPathSet logs notification when there are no paths to
+    uninstall
+    """
+    from pip._internal.metadata import get_default_environment
+    from pip._internal.req.req_uninstall import UninstallPathSet
+
+    caplog.set_level(logging.INFO)
+
+    test_dist = get_default_environment().get_distribution("pip")
+    assert test_dist is not None, "pip not installed"
+
+    uninstall_set = UninstallPathSet(test_dist)
+    uninstall_set.remove()  # with no files added to set
+
+    assert "Can't uninstall 'pip'. No files were found to uninstall." in caplog.text
+
+
+def test_uninstall_non_local_distutils(
+    caplog: pytest.LogCaptureFixture, monkeypatch: pytest.MonkeyPatch, tmpdir: Path
+) -> None:
+    einfo = tmpdir.joinpath("thing-1.0.egg-info")
+    with open(einfo, "wb"):
+        pass
+
+    get_dist = Mock()
+    get_dist.return_value = Mock(
+        key="thing",
+        project_name="thing",
+        egg_info=einfo,
+        location=einfo,
+    )
+    monkeypatch.setattr("pip._vendor.pkg_resources.get_distribution", get_dist)
+
+    req = install_req_from_line("thing")
+    req.uninstall()
+
+    assert os.path.exists(einfo)
+
+
+def test_uninstall_wheel(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test uninstalling a wheel
+    """
+    package = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    result = script.pip("install", package, "--no-index")
+    dist_info_folder = script.site_packages / "simple.dist-0.1.dist-info"
+    result.did_create(dist_info_folder)
+    result2 = script.pip("uninstall", "simple.dist", "-y")
+    assert_all_changes(result, result2, )
+
+
+@pytest.mark.parametrize(
+    "installer",
+    
+        FileNotFoundError,
+        IsADirectoryError,
+        "",
+        os.linesep,
+        b"\xc0\xff\xee",
+        "pip",
+        "MegaCorp Cloud Install-O-Matic",
+    ,
+)
+def test_uninstall_without_record_fails(
+    script: PipTestEnvironment, data: TestData, installer: Any
+) -> None:
+    """
+    Test uninstalling a package installed without RECORD
+    """
+    package = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    result = script.pip("install", package, "--no-index")
+    dist_info_folder = script.site_packages / "simple.dist-0.1.dist-info"
+    result.did_create(dist_info_folder)
+
+    # Remove RECORD
+    record_path = dist_info_folder / "RECORD"
+    (script.base_path / record_path).unlink()
+    ignore_changes = record_path
+
+    # Populate, remove or otherwise break INSTALLER
+    installer_path = dist_info_folder / "INSTALLER"
+    ignore_changes += installer_path
+    installer_path = script.base_path / installer_path
+    if installer in (FileNotFoundError, IsADirectoryError):
+        installer_path.unlink()
+        if installer is IsADirectoryError:
+            installer_path.mkdir()
+    else:
+        if isinstance(installer, bytes):
+            installer_path.write_bytes(installer)
+        else:
+            installer_path.write_text(installer + os.linesep)
+
+    result2 = script.pip("uninstall", "simple.dist", "-y", expect_error=True)
+    expected_error_message = (
+        "ERROR: Cannot uninstall simple.dist 0.1, RECORD file not found."
+    )
+    if not isinstance(installer, str) or not installer.strip() or installer == "pip":
+        expected_error_message += (
+            " You might be able to recover from this via: "
+            "'pip install --force-reinstall --no-deps "
+            "simple.dist==0.1'."
+        )
+    elif installer:
+        expected_error_message += " Hint: The package was installed by {}.".format(
+            installer
+        )
+    assert result2.stderr.rstrip() == expected_error_message
+    assert_all_changes(result.files_after, result2, ignore_changes)
+
+
+@pytest.mark.skipif("sys.platform == 'win32'")
+def test_uninstall_with_symlink(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test uninstalling a wheel, with an additional symlink
+    https://github.com/pypa/pip/issues/6892
+    """
+    package = data.packages.joinpath("simple.dist-0.1-py2.py3-none-any.whl")
+    script.pip("install", package, "--no-index")
+    symlink_target = tmpdir / "target"
+    symlink_target.mkdir()
+    symlink_source = script.site_packages / "symlink"
+    (script.base_path / symlink_source).symlink_to(symlink_target)
+    st_mode = symlink_target.stat().st_mode
+    distinfo_path = script.site_packages_path / "simple.dist-0.1.dist-info"
+    record_path = distinfo_path / "RECORD"
+    with open(record_path, "a") as f:
+        f.write("symlink,,\n")
+    uninstall_result = script.pip("uninstall", "simple.dist", "-y")
+    assert symlink_source in uninstall_result.files_deleted
+    assert symlink_target.stat().st_mode == st_mode
+
+
+def test_uninstall_setuptools_develop_install(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Try uninstall after setup.py develop followed of setup.py install"""
+    pkg_path = data.packages.joinpath("FSPkg")
+    script.run("python", "setup.py", "develop", expect_stderr=True, cwd=pkg_path)
+    script.run("python", "setup.py", "install", expect_stderr=True, cwd=pkg_path)
+    script.assert_installed(FSPkg="0.1.dev0")
+    # Uninstall both develop and install
+    uninstall = script.pip("uninstall", "FSPkg", "-y")
+    assert any(p.suffix == ".egg" for p in uninstall.files_deleted), str(uninstall)
+    uninstall2 = script.pip("uninstall", "FSPkg", "-y")
+    assert (
+        join(script.site_packages, "FSPkg.egg-link") in uninstall2.files_deleted
+    ), str(uninstall2)
+    script.assert_not_installed("FSPkg")
+
+
+def test_uninstall_editable_and_pip_install(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Try uninstall after pip install -e after pip install"""
+    # SETUPTOOLS_SYS_PATH_TECHNIQUE=raw removes the assumption that `-e`
+    # installs are always higher priority than regular installs.
+    # This becomes the default behavior in setuptools 25.
+    script.environ"SETUPTOOLS_SYS_PATH_TECHNIQUE" = "raw"
+
+    pkg_path = data.packages.joinpath("FSPkg")
+    script.pip("install", "-e", ".", expect_stderr=True, cwd=pkg_path)
+    # ensure both are installed with --ignore-installed:
+    script.pip("install", "--ignore-installed", ".", expect_stderr=True, cwd=pkg_path)
+    script.assert_installed(FSPkg="0.1.dev0")
+    # Uninstall both develop and install
+    uninstall = script.pip("uninstall", "FSPkg", "-y")
+    assert not any(p.suffix == ".egg-link" for p in uninstall.files_deleted)
+    uninstall2 = script.pip("uninstall", "FSPkg", "-y")
+    assert (
+        join(script.site_packages, "FSPkg.egg-link") in uninstall2.files_deleted
+    ), list(uninstall2.files_deleted.keys())
+    script.assert_not_installed("FSPkg")
+
+
+@pytest.fixture()
+def move_easy_install_pth(script: PipTestEnvironment) -> IteratorNone:
+    """Move easy-install.pth out of the way for testing easy_install."""
+    easy_install_pth = join(script.site_packages_path, "easy-install.pth")
+    pip_test_pth = join(script.site_packages_path, "pip-test.pth")
+    os.rename(easy_install_pth, pip_test_pth)
+    yield
+    os.rename(pip_test_pth, easy_install_pth)
+
+
+@pytest.mark.usefixtures("move_easy_install_pth")
+def test_uninstall_editable_and_pip_install_easy_install_remove(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Try uninstall after pip install -e after pip install
+    and removing easy-install.pth"""
+    # SETUPTOOLS_SYS_PATH_TECHNIQUE=raw removes the assumption that `-e`
+    # installs are always higher priority than regular installs.
+    # This becomes the default behavior in setuptools 25.
+    script.environ"SETUPTOOLS_SYS_PATH_TECHNIQUE" = "raw"
+
+    # Install FSPkg
+    pkg_path = data.packages.joinpath("FSPkg")
+    script.pip("install", "-e", ".", expect_stderr=True, cwd=pkg_path)
+
+    # Rename easy-install.pth to pip-test-fspkg.pth
+    easy_install_pth = join(script.site_packages_path, "easy-install.pth")
+    pip_test_fspkg_pth = join(script.site_packages_path, "pip-test-fspkg.pth")
+    os.rename(easy_install_pth, pip_test_fspkg_pth)
+
+    # Confirm that FSPkg is installed
+    script.assert_installed(FSPkg="0.1.dev0")
+
+    # Remove pip-test-fspkg.pth
+    os.remove(pip_test_fspkg_pth)
+
+    # Uninstall will fail with given warning
+    uninstall = script.pip("uninstall", "FSPkg", "-y", allow_stderr_warning=True)
+    assert "Cannot remove entries from nonexistent file" in uninstall.stderr
+
+    assert (
+        join(script.site_packages, "FSPkg.egg-link") in uninstall.files_deleted
+    ), list(uninstall.files_deleted.keys())
+
+    # Confirm that FSPkg is uninstalled
+    script.assert_not_installed("FSPkg")
+
+
+def test_uninstall_ignores_missing_packages(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Uninstall of a non existent package prints a warning and exits cleanly"""
+    result = script.pip(
+        "uninstall",
+        "-y",
+        "non-existent-pkg",
+        expect_stderr=True,
+    )
+
+    assert "Skipping non-existent-pkg as it is not installed." in result.stderr
+    assert result.returncode == 0, "Expected clean exit"
+
+
+def test_uninstall_ignores_missing_packages_and_uninstalls_rest(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.pip_install_local("simple")
+    result = script.pip(
+        "uninstall",
+        "-y",
+        "non-existent-pkg",
+        "simple",
+        expect_stderr=True,
+    )
+
+    assert "Skipping non-existent-pkg as it is not installed." in result.stderr
+    assert "Successfully uninstalled simple" in result.stdout
+    assert result.returncode == 0, "Expected clean exit"

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_uninstall_user.py Added

@@ -0,0 +1,102 @@
+"""
+tests specific to uninstalling --user installs
+"""
+from os.path import isdir, isfile, normcase
+
+import pytest
+
+from tests.functional.test_install_user import _patch_dist_in_site_packages
+from tests.lib import PipTestEnvironment, TestData, assert_all_changes
+from tests.lib.venv import VirtualEnvironment
+from tests.lib.wheel import make_wheel
+
+
+@pytest.mark.usefixtures("enable_user_site")
+class Tests_UninstallUserSite:
+    @pytest.mark.network
+    def test_uninstall_from_usersite(self, script: PipTestEnvironment) -> None:
+        """
+        Test uninstall from usersite
+        """
+        result1 = script.pip("install", "--user", "INITools==0.3")
+        result2 = script.pip("uninstall", "-y", "INITools")
+        assert_all_changes(result1, result2, script.venv / "build", "cache")
+
+    def test_uninstall_from_usersite_with_dist_in_global_site(
+        self, virtualenv: VirtualEnvironment, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test uninstall from usersite (with same dist in global site)
+        """
+        entry_points_txt = "console_scripts\nscript = pkg:func"
+        make_wheel(
+            "pkg",
+            "0.1",
+            extra_metadata_files={"entry_points.txt": entry_points_txt},
+        ).save_to_dir(script.scratch_path)
+        make_wheel(
+            "pkg",
+            "0.1.1",
+            extra_metadata_files={"entry_points.txt": entry_points_txt},
+        ).save_to_dir(script.scratch_path)
+
+        _patch_dist_in_site_packages(virtualenv)
+
+        script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--no-warn-script-location",
+            "pkg==0.1",
+        )
+
+        result2 = script.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            script.scratch_path,
+            "--no-warn-script-location",
+            "--user",
+            "pkg==0.1.1",
+        )
+        result3 = script.pip("uninstall", "-vy", "pkg")
+
+        # uninstall console is mentioning user scripts, but not global scripts
+        assert normcase(script.user_bin_path) in result3.stdout, str(result3)
+        assert normcase(script.bin_path) not in result3.stdout, str(result3)
+
+        # uninstall worked
+        assert_all_changes(result2, result3, script.venv / "build", "cache")
+
+        # site still has 0.2 (can't look in result1; have to check)
+        dist_info_folder = script.base_path / script.site_packages / "pkg-0.1.dist-info"
+        assert isdir(dist_info_folder)
+
+    def test_uninstall_editable_from_usersite(
+        self, script: PipTestEnvironment, data: TestData
+    ) -> None:
+        """
+        Test uninstall editable local user install
+        """
+        assert script.user_site_path.exists()
+
+        # install
+        to_install = data.packages.joinpath("FSPkg")
+        result1 = script.pip("install", "--user", "-e", to_install)
+        egg_link = script.user_site / "FSPkg.egg-link"
+        result1.did_create(egg_link)
+
+        # uninstall
+        result2 = script.pip("uninstall", "-y", "FSPkg")
+        assert not isfile(script.base_path / egg_link)
+
+        assert_all_changes(
+            result1,
+            result2,
+            
+                script.venv / "build",
+                "cache",
+                script.user_site / "easy-install.pth",
+            ,
+        )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_vcs_bazaar.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_vcs_git.py Added

@@ -0,0 +1,459 @@
+"""
+Contains functional tests of the Git class.
+"""
+import logging
+import os
+import pathlib
+from typing import List, Optional, Tuple
+from unittest.mock import Mock, patch
+
+import pytest
+
+from pip._internal.utils.misc import HiddenText
+from pip._internal.vcs import vcs
+from pip._internal.vcs.git import Git, RemoteNotFoundError
+from tests.lib import PipTestEnvironment, _create_test_package, _git_commit
+
+
+def test_get_backend_for_scheme() -> None:
+    assert vcs.get_backend_for_scheme("git+https") is vcs.get_backend("Git")
+
+
+def get_head_sha(script: PipTestEnvironment, dest: str) -> str:
+    """Return the HEAD sha."""
+    result = script.run("git", "rev-parse", "HEAD", cwd=dest)
+    sha = result.stdout.strip()
+
+    return sha
+
+
+def checkout_ref(script: PipTestEnvironment, repo_dir: str, ref: str) -> None:
+    script.run("git", "checkout", ref, cwd=repo_dir)
+
+
+def checkout_new_branch(script: PipTestEnvironment, repo_dir: str, branch: str) -> None:
+    script.run(
+        "git",
+        "checkout",
+        "-b",
+        branch,
+        cwd=repo_dir,
+    )
+
+
+def do_commit(script: PipTestEnvironment, dest: str) -> str:
+    _git_commit(script, dest, message="test commit", allow_empty=True)
+    return get_head_sha(script, dest)
+
+
+def add_commits(script: PipTestEnvironment, dest: str, count: int) -> Liststr:
+    """Return a list of the commit hashes from oldest to newest."""
+    shas = 
+    for _ in range(count):
+        sha = do_commit(script, dest)
+        shas.append(sha)
+
+    return shas
+
+
+def check_rev(repo_dir: str, rev: str, expected: TupleOptionalstr, bool) -> None:
+    assert Git.get_revision_sha(repo_dir, rev) == expected
+
+
+def test_git_dir_ignored(tmpdir: pathlib.Path) -> None:
+    """
+    Test that a GIT_DIR environment variable is ignored.
+    """
+    repo_path = tmpdir / "test-repo"
+    repo_path.mkdir()
+    repo_dir = str(repo_path)
+
+    env = {"GIT_DIR": "foo"}
+    # If GIT_DIR is not ignored, then os.listdir() will return 'foo'.
+    Git.run_command("init", repo_dir, cwd=repo_dir, extra_environ=env)
+    assert os.listdir(repo_dir) == ".git"
+
+
+def test_git_work_tree_ignored(tmpdir: pathlib.Path) -> None:
+    """
+    Test that a GIT_WORK_TREE environment variable is ignored.
+    """
+    repo_path = tmpdir / "test-repo"
+    repo_path.mkdir()
+    repo_dir = str(repo_path)
+
+    Git.run_command("init", repo_dir, cwd=repo_dir)
+    # Choose a directory relative to the cwd that does not exist.
+    # If GIT_WORK_TREE is not ignored, then the command will error out
+    # with: "fatal: This operation must be run in a work tree".
+    env = {"GIT_WORK_TREE": "foo"}
+    Git.run_command("status", repo_dir, extra_environ=env, cwd=repo_dir)
+
+
+def test_get_remote_url(script: PipTestEnvironment, tmpdir: pathlib.Path) -> None:
+    source_path = tmpdir / "source"
+    source_path.mkdir()
+    source_url = source_path.as_uri()
+
+    source_dir = str(source_path)
+    script.run("git", "init", cwd=source_dir)
+    do_commit(script, source_dir)
+
+    repo_dir = str(tmpdir / "repo")
+    script.run("git", "clone", source_url, repo_dir)
+
+    remote_url = Git.get_remote_url(repo_dir)
+    assert remote_url == source_url
+
+
+def test_get_remote_url__no_remote(
+    script: PipTestEnvironment, tmpdir: pathlib.Path
+) -> None:
+    """
+    Test a repo with no remote.
+    """
+    repo_path = tmpdir / "temp-repo"
+    repo_path.mkdir()
+    repo_dir = str(repo_path)
+
+    script.run("git", "init", cwd=repo_dir)
+
+    with pytest.raises(RemoteNotFoundError):
+        Git.get_remote_url(repo_dir)
+
+
+def test_get_current_branch(script: PipTestEnvironment) -> None:
+    repo_dir = str(script.scratch_path)
+
+    script.run("git", "init", cwd=repo_dir)
+    sha = do_commit(script, repo_dir)
+
+    assert Git.get_current_branch(repo_dir) == "master"
+
+    # Switch to a branch with the same SHA as "master" but whose name
+    # is alphabetically after.
+    checkout_new_branch(script, repo_dir, "release")
+    assert Git.get_current_branch(repo_dir) == "release"
+
+    # Also test the detached HEAD case.
+    checkout_ref(script, repo_dir, sha)
+    assert Git.get_current_branch(repo_dir) is None
+
+
+def test_get_current_branch__branch_and_tag_same_name(
+    script: PipTestEnvironment, tmpdir: pathlib.Path
+) -> None:
+    """
+    Check calling get_current_branch() from a branch or tag when the branch
+    and tag have the same name.
+    """
+    repo_dir = str(tmpdir)
+    script.run("git", "init", cwd=repo_dir)
+    do_commit(script, repo_dir)
+    checkout_new_branch(script, repo_dir, "dev")
+    # Create a tag with the same name as the branch.
+    script.run("git", "tag", "dev", cwd=repo_dir)
+
+    assert Git.get_current_branch(repo_dir) == "dev"
+
+    # Now try with the tag checked out.
+    checkout_ref(script, repo_dir, "refs/tags/dev")
+    assert Git.get_current_branch(repo_dir) is None
+
+
+def test_get_revision_sha(script: PipTestEnvironment) -> None:
+    repo_dir = str(script.scratch_path)
+
+    script.run("git", "init", cwd=repo_dir)
+    shas = add_commits(script, repo_dir, count=3)
+
+    tag_sha = shas0
+    origin_sha = shas1
+    head_sha = shas2
+    assert head_sha == shas-1
+
+    origin_ref = "refs/remotes/origin/origin-branch"
+    generic_ref = "refs/generic-ref"
+
+    script.run("git", "branch", "local-branch", head_sha, cwd=repo_dir)
+    script.run("git", "tag", "v1.0", tag_sha, cwd=repo_dir)
+    script.run("git", "update-ref", origin_ref, origin_sha, cwd=repo_dir)
+    script.run(
+        "git",
+        "update-ref",
+        "refs/remotes/upstream/upstream-branch",
+        head_sha,
+        cwd=repo_dir,
+    )
+    script.run("git", "update-ref", generic_ref, head_sha, cwd=repo_dir)
+
+    # Test two tags pointing to the same sha.
+    script.run("git", "tag", "v2.0", tag_sha, cwd=repo_dir)
+    # Test tags sharing the same suffix as another tag, both before and
+    # after the suffix alphabetically.
+    script.run("git", "tag", "aaa/v1.0", head_sha, cwd=repo_dir)
+    script.run("git", "tag", "zzz/v1.0", head_sha, cwd=repo_dir)
+
+    check_rev(repo_dir, "v1.0", (tag_sha, False))
+    check_rev(repo_dir, "v2.0", (tag_sha, False))
+    check_rev(repo_dir, "origin-branch", (origin_sha, True))
+
+    ignored_names = 
+        # Local branches should be ignored.
+        "local-branch",
+        # Non-origin remote branches should be ignored.
+        "upstream-branch",
+        # Generic refs should be ignored.
+        "generic-ref",
+        # Fully spelled-out refs should be ignored.
+        origin_ref,
+        generic_ref,
+        # Test passing a valid commit hash.
+        tag_sha,
+        # Test passing a non-existent name.
+        "does-not-exist",
+    
+    for name in ignored_names:
+        check_rev(repo_dir, name, (None, False))
+
+
+def test_is_commit_id_equal(script: PipTestEnvironment) -> None:
+    """
+    Test Git.is_commit_id_equal().
+    """
+    version_pkg_path = os.fspath(_create_test_package(script.scratch_path))
+    script.run("git", "branch", "branch0.1", cwd=version_pkg_path)
+    commit = script.run("git", "rev-parse", "HEAD", cwd=version_pkg_path).stdout.strip()
+
+    assert Git.is_commit_id_equal(version_pkg_path, commit)
+    assert not Git.is_commit_id_equal(version_pkg_path, commit:7)
+    assert not Git.is_commit_id_equal(version_pkg_path, "branch0.1")
+    assert not Git.is_commit_id_equal(version_pkg_path, "abc123")
+    # Also check passing a None value.
+    assert not Git.is_commit_id_equal(version_pkg_path, None)
+
+
+def test_is_immutable_rev_checkout(script: PipTestEnvironment) -> None:
+    version_pkg_path = os.fspath(_create_test_package(script.scratch_path))
+    commit = script.run("git", "rev-parse", "HEAD", cwd=version_pkg_path).stdout.strip()
+    assert Git().is_immutable_rev_checkout(
+        "git+https://g.c/o/r@" + commit, version_pkg_path
+    )
+    assert not Git().is_immutable_rev_checkout("git+https://g.c/o/r", version_pkg_path)
+    assert not Git().is_immutable_rev_checkout(
+        "git+https://g.c/o/r@master", version_pkg_path
+    )
+
+
+def test_get_repository_root(script: PipTestEnvironment) -> None:
+    version_pkg_path = _create_test_package(script.scratch_path)
+    tests_path = version_pkg_path.joinpath("tests")
+    tests_path.mkdir()
+
+    root1 = Git.get_repository_root(os.fspath(version_pkg_path))
+    assert root1 is not None
+    assert os.path.normcase(root1) == os.path.normcase(version_pkg_path)
+
+    root2 = Git.get_repository_root(os.fspath(tests_path))
+    assert root2 is not None
+    assert os.path.normcase(root2) == os.path.normcase(version_pkg_path)
+
+
+def test_resolve_commit_not_on_branch(
+    script: PipTestEnvironment, tmp_path: pathlib.Path
+) -> None:
+    repo_path = tmp_path / "repo"
+    repo_file = repo_path / "file.txt"
+    clone_path = repo_path / "clone"
+    repo_path.mkdir()
+    script.run("git", "init", cwd=str(repo_path))
+
+    repo_file.write_text(".")
+    script.run("git", "add", "file.txt", cwd=str(repo_path))
+    script.run("git", "commit", "-m", "initial commit", cwd=str(repo_path))
+    script.run("git", "checkout", "-b", "abranch", cwd=str(repo_path))
+
+    # create a commit
+    repo_file.write_text("..")
+    script.run("git", "commit", "-a", "-m", "commit 1", cwd=str(repo_path))
+    commit = script.run("git", "rev-parse", "HEAD", cwd=str(repo_path)).stdout.strip()
+
+    # make sure our commit is not on a branch
+    script.run("git", "checkout", "master", cwd=str(repo_path))
+    script.run("git", "branch", "-D", "abranch", cwd=str(repo_path))
+
+    # create a ref that points to our commit
+    (repo_path / ".git" / "refs" / "myrefs").mkdir(parents=True)
+    (repo_path / ".git" / "refs" / "myrefs" / "myref").write_text(commit)
+
+    # check we can fetch our commit
+    rev_options = Git.make_rev_options(commit)
+    Git().fetch_new(
+        str(clone_path),
+        HiddenText(repo_path.as_uri(), redacted="*"),
+        rev_options,
+        verbosity=0,
+    )
+
+
+def _initialize_clonetest_server(
+    repo_path: pathlib.Path, script: PipTestEnvironment, enable_partial_clone: bool
+) -> pathlib.Path:
+    repo_path.mkdir()
+    script.run("git", "init", cwd=str(repo_path))
+    repo_file = repo_path / "file.txt"
+    repo_file.write_text(".")
+    script.run("git", "add", "file.txt", cwd=str(repo_path))
+    script.run("git", "commit", "-m", "initial commit", cwd=str(repo_path))
+
+    # Enable filtering support on server
+    if enable_partial_clone:
+        script.run("git", "config", "uploadpack.allowFilter", "true", cwd=repo_path)
+        script.run(
+            "git", "config", "uploadpack.allowanysha1inwant", "true", cwd=repo_path
+        )
+
+    return repo_file
+
+
+@pytest.mark.parametrize(
+    "version_out, expected_message",
+    (
+        ("git version -2.25.1", "Can't parse git version: git version -2.25.1"),
+        ("git version 2.a.1", "Can't parse git version: git version 2.a.1"),
+        ("git ver. 2.25.1", "Can't parse git version: git ver. 2.25.1"),
+    ),
+)
+@patch("pip._internal.vcs.versioncontrol.VersionControl.run_command")
+def test_git_parse_fail_warning(
+    mock_run_command: Mock,
+    caplog: pytest.LogCaptureFixture,
+    version_out: str,
+    expected_message: str,
+) -> None:
+    """Test invalid git version logs adds an explicit warning log."""
+    mock_run_command.return_value = version_out
+
+    caplog.set_level(logging.WARNING)
+
+    git_tuple = Git().get_git_version()
+    # Returns an empty tuple if it is an invalid git version
+    assert git_tuple == ()
+
+    # Check for warning log
+    assert expected_message in caplog.text.strip()
+
+
+@pytest.mark.skipif(Git().get_git_version() < (2, 17), reason="git too old")
+def test_partial_clone(script: PipTestEnvironment, tmp_path: pathlib.Path) -> None:
+    """Test partial clone w/ a git-server that supports it"""
+    repo_path = tmp_path / "repo"
+    repo_file = _initialize_clonetest_server(
+        repo_path, script, enable_partial_clone=True
+    )
+    clone_path1 = repo_path / "clone1"
+    clone_path2 = repo_path / "clone2"
+
+    commit = script.run("git", "rev-parse", "HEAD", cwd=str(repo_path)).stdout.strip()
+
+    # Check that we can clone at HEAD
+    Git().fetch_new(
+        str(clone_path1),
+        HiddenText(repo_path.as_uri(), redacted="*"),
+        Git.make_rev_options(),
+        verbosity=0,
+    )
+    # Check that we can clone to commit
+    Git().fetch_new(
+        str(clone_path2),
+        HiddenText(repo_path.as_uri(), redacted="*"),
+        Git.make_rev_options(commit),
+        verbosity=0,
+    )
+
+    # Write some additional stuff to git pull
+    repo_file.write_text("..")
+    script.run("git", "commit", "-am", "second commit", cwd=str(repo_path))
+
+    # Make sure git pull works - with server supporting filtering
+    assert (
+        "warning: filtering not recognized by server, ignoring"
+        not in script.run("git", "pull", cwd=clone_path1).stderr
+    )
+    assert (
+        "warning: filtering not recognized by server, ignoring"
+        not in script.run("git", "pull", cwd=clone_path2).stderr
+    )
+
+
+@pytest.mark.skipif(Git().get_git_version() < (2, 17), reason="git too old")
+def test_partial_clone_without_server_support(
+    script: PipTestEnvironment, tmp_path: pathlib.Path
+) -> None:
+    """Test partial clone w/ a git-server that does not support it"""
+    repo_path = tmp_path / "repo"
+    repo_file = _initialize_clonetest_server(
+        repo_path, script, enable_partial_clone=False
+    )
+    clone_path1 = repo_path / "clone1"
+    clone_path2 = repo_path / "clone2"
+
+    commit = script.run("git", "rev-parse", "HEAD", cwd=str(repo_path)).stdout.strip()
+
+    # Check that we can clone at HEAD
+    Git().fetch_new(
+        str(clone_path1),
+        HiddenText(repo_path.as_uri(), redacted="*"),
+        Git.make_rev_options(),
+        verbosity=0,
+    )
+    # Check that we can clone to commit
+    Git().fetch_new(
+        str(clone_path2),
+        HiddenText(repo_path.as_uri(), redacted="*"),
+        Git.make_rev_options(commit),
+        verbosity=0,
+    )
+
+    # Write some additional stuff to git pull
+    repo_file.write_text("..")
+    script.run("git", "commit", "-am", "second commit", cwd=str(repo_path))
+
+    # Make sure git pull works - even though server doesn't support filtering
+    assert (
+        "warning: filtering not recognized by server, ignoring"
+        in script.run("git", "pull", cwd=clone_path1).stderr
+    )
+    assert (
+        "warning: filtering not recognized by server, ignoring"
+        in script.run("git", "pull", cwd=clone_path2).stderr
+    )
+
+
+def test_clone_without_partial_clone_support(
+    script: PipTestEnvironment, tmp_path: pathlib.Path
+) -> None:
+    """Older git clients don't support partial clone. Test the fallback path"""
+    repo_path = tmp_path / "repo"
+    repo_file = _initialize_clonetest_server(
+        repo_path, script, enable_partial_clone=True
+    )
+    clone_path = repo_path / "clone1"
+
+    # Check that we can clone w/ old version of git w/o --filter
+    with patch("pip._internal.vcs.git.Git.get_git_version", return_value=(2, 16)):
+        Git().fetch_new(
+            str(clone_path),
+            HiddenText(repo_path.as_uri(), redacted="*"),
+            Git.make_rev_options(),
+            verbosity=0,
+        )
+
+    repo_file.write_text("...")
+    script.run("git", "commit", "-am", "third commit", cwd=str(repo_path))
+
+    # Should work fine w/o attempting to use `--filter` args
+    assert (
+        "warning: filtering not recognized by server, ignoring"
+        not in script.run("git", "pull", cwd=clone_path).stderr
+    )

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_vcs_mercurial.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_vcs_subversion.py Added

@@ -0,0 +1,35 @@
+from pathlib import Path
+
+import pytest
+
+from pip._internal.vcs.subversion import Subversion
+from pip._internal.vcs.versioncontrol import RemoteNotFoundError
+from tests.lib import PipTestEnvironment, _create_svn_repo, need_svn
+
+
+@need_svn
+def test_get_remote_url__no_remote(script: PipTestEnvironment, tmpdir: Path) -> None:
+    repo_path = tmpdir / "temp-repo"
+    repo_path.mkdir()
+    repo_dir = str(repo_path)
+
+    _create_svn_repo(script.scratch_path, repo_dir)
+
+    with pytest.raises(RemoteNotFoundError):
+        Subversion().get_remote_url(repo_dir)
+
+
+@need_svn
+def test_get_remote_url__no_remote_with_setup(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    repo_path = tmpdir / "temp-repo"
+    repo_path.mkdir()
+    setup = repo_path / "setup.py"
+    setup.touch()
+    repo_dir = str(repo_path)
+
+    _create_svn_repo(script.scratch_path, repo_dir)
+
+    with pytest.raises(RemoteNotFoundError):
+        Subversion().get_remote_url(repo_dir)

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_warning.py Added

@@ -0,0 +1,69 @@
+import os
+import sys
+import textwrap
+from pathlib import Path
+
+import pytest
+
+from tests.lib import PipTestEnvironment
+
+
+@pytest.fixture
+def warnings_demo(tmpdir: Path) -> Path:
+    demo = tmpdir.joinpath("warnings_demo.py")
+    demo.write_text(
+        textwrap.dedent(
+            """
+        from logging import basicConfig
+        from pip._internal.utils import deprecation
+
+        deprecation.install_warning_logger()
+        basicConfig()
+
+        deprecation.deprecated(reason="deprecated!", replacement=None, gone_in=None)
+    """
+        )
+    )
+    return demo
+
+
+def test_deprecation_warnings_are_correct(
+    script: PipTestEnvironment, warnings_demo: Path
+) -> None:
+    result = script.run("python", os.fspath(warnings_demo), expect_stderr=True)
+    expected = "WARNING:pip._internal.deprecations:DEPRECATION: deprecated!\n"
+    assert result.stderr == expected
+
+
+def test_deprecation_warnings_can_be_silenced(
+    script: PipTestEnvironment, warnings_demo: Path
+) -> None:
+    script.environ"PYTHONWARNINGS" = "ignore"
+    result = script.run("python", os.fspath(warnings_demo))
+    assert result.stderr == ""
+
+
+DEPRECATION_TEXT = "drop support for Python 2.7"
+CPYTHON_DEPRECATION_TEXT = "January 1st, 2020"
+
+
+def test_version_warning_is_not_shown_if_python_version_is_not_2(
+    script: PipTestEnvironment,
+) -> None:
+    result = script.pip("debug", allow_stderr_warning=True)
+    assert DEPRECATION_TEXT not in result.stderr, str(result)
+    assert CPYTHON_DEPRECATION_TEXT not in result.stderr, str(result)
+
+
+def test_flag_does_nothing_if_python_version_is_not_2(
+    script: PipTestEnvironment,
+) -> None:
+    script.pip("list", "--no-python-version-warning")
+
+
+@pytest.mark.skipif(
+    sys.version_info >= (3, 10), reason="distutils is deprecated in 3.10+"
+)
+def test_pip_works_with_warnings_as_errors(script: PipTestEnvironment) -> None:
+    script.environ"PYTHONWARNINGS" = "error"
+    script.pip("--version")

_service:tar_scm:pip-23.1.2.tar.gz/tests/functional/test_wheel.py Added

@@ -0,0 +1,397 @@
+"""'pip wheel' tests"""
+import os
+import re
+import sys
+from pathlib import Path
+
+import pytest
+
+from pip._internal.cli.status_codes import ERROR
+from tests.lib import pyversion  # noqa: F401
+from tests.lib import PipTestEnvironment, TestData
+
+
+def add_files_to_dist_directory(folder: Path) -> None:
+    (folder / "dist").mkdir(parents=True)
+    (folder / "dist" / "a_name-0.0.1.tar.gz").write_text("hello")
+    # Not adding a wheel file since that confuses setuptools' backend.
+    # (folder / 'dist' / 'a_name-0.0.1-py2.py3-none-any.whl').write_text(
+    #     "hello"
+    # )
+
+
+def test_wheel_exit_status_code_when_no_requirements(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test wheel exit status code when no requirements specified
+    """
+    result = script.pip("wheel", expect_error=True)
+    assert "You must give at least one requirement to wheel" in result.stderr
+    assert result.returncode == ERROR
+
+
+def test_wheel_exit_status_code_when_blank_requirements_file(
+    script: PipTestEnvironment,
+) -> None:
+    """
+    Test wheel exit status code when blank requirements file specified
+    """
+    script.scratch_path.joinpath("blank.txt").write_text("\n")
+    script.pip("wheel", "-r", "blank.txt")
+
+
+def test_pip_wheel_success(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test 'pip wheel' success.
+    """
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "simple==3.0",
+    )
+    wheel_file_name = f"simple-3.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    assert re.search(
+        r"Created wheel for simple: "
+        r"filename={filename} size=\d+ sha256=A-Fa-f0-9{{64}}".format(
+            filename=re.escape(wheel_file_name)
+        ),
+        result.stdout,
+    )
+    assert re.search(r"^\s+Stored in directory: ", result.stdout, re.M)
+    result.did_create(wheel_file_path)
+    assert "Successfully built simple" in result.stdout, result.stdout
+
+
+def test_pip_wheel_build_cache(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test 'pip wheel' builds and caches.
+    """
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "simple==3.0",
+    )
+    wheel_file_name = f"simple-3.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+    assert "Successfully built simple" in result.stdout, result.stdout
+    # remove target file
+    (script.scratch_path / wheel_file_name).unlink()
+    # pip wheel again and test that no build occurs since
+    # we get the wheel from cache
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "simple==3.0",
+    )
+    result.did_create(wheel_file_path)
+    assert "Successfully built simple" not in result.stdout, result.stdout
+
+
+def test_basic_pip_wheel_downloads_wheels(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test 'pip wheel' downloads wheels
+    """
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "simple.dist",
+    )
+    wheel_file_name = "simple.dist-0.1-py2.py3-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+    assert "Saved" in result.stdout, result.stdout
+
+
+def test_pip_wheel_build_relative_cachedir(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test 'pip wheel' builds and caches with a non-absolute cache directory.
+    """
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "--cache-dir",
+        "./cache",
+        "simple==3.0",
+    )
+    assert result.returncode == 0
+
+
+def test_pip_wheel_builds_when_no_binary_set(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    data.packages.joinpath("simple-3.0-py2.py3-none-any.whl").touch()
+    # Check that the wheel package is ignored
+    res = script.pip(
+        "wheel",
+        "--no-index",
+        "--no-binary",
+        ":all:",
+        "-f",
+        data.find_links,
+        "simple==3.0",
+    )
+    assert "Building wheel for simple" in str(res), str(res)
+
+
+@pytest.mark.skipif("sys.platform == 'win32'")
+def test_pip_wheel_readonly_cache(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    cache_dir = tmpdir / "cache"
+    cache_dir.mkdir()
+    os.chmod(cache_dir, 0o400)  # read-only cache
+    # Check that the wheel package is ignored
+    res = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "--cache-dir",
+        cache_dir,
+        "simple==3.0",
+        allow_stderr_warning=True,
+    )
+    assert res.returncode == 0
+    assert "The cache has been disabled." in str(res), str(res)
+
+
+def test_pip_wheel_builds_editable_deps(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """
+    Test 'pip wheel' finds and builds dependencies of editables
+    """
+    editable_path = os.path.join(data.src, "requires_simple")
+    result = script.pip(
+        "wheel", "--no-index", "-f", data.find_links, "-e", editable_path
+    )
+    wheel_file_name = f"simple-1.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+
+
+def test_pip_wheel_builds_editable(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test 'pip wheel' builds an editable package
+    """
+    editable_path = os.path.join(data.src, "simplewheel-1.0")
+    result = script.pip(
+        "wheel", "--no-index", "-f", data.find_links, "-e", editable_path
+    )
+    wheel_file_name = f"simplewheel-1.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+
+
+@pytest.mark.network
+def test_pip_wheel_git_editable_keeps_clone(
+    script: PipTestEnvironment, tmpdir: Path
+) -> None:
+    """
+    Test that `pip wheel -e giturl` preserves a git clone in src.
+    """
+    script.pip(
+        "wheel",
+        "--no-deps",
+        "-e",
+        "git+https://github.com/pypa/pip-test-package#egg=pip-test-package",
+        "--src",
+        tmpdir / "src",
+        "--wheel-dir",
+        tmpdir,
+    )
+    assert (tmpdir / "src" / "pip-test-package").exists()
+    assert (tmpdir / "src" / "pip-test-package" / ".git").exists()
+
+
+def test_pip_wheel_builds_editable_does_not_create_zip(
+    script: PipTestEnvironment, data: TestData, tmpdir: Path
+) -> None:
+    """
+    Test 'pip wheel' of editables does not create zip files
+    (regression test for issue #9122)
+    """
+    wheel_dir = tmpdir / "wheel_dir"
+    wheel_dir.mkdir()
+    editable_path = os.path.join(data.src, "simplewheel-1.0")
+    script.pip("wheel", "--no-deps", "-e", editable_path, "-w", wheel_dir)
+    wheels = os.listdir(wheel_dir)
+    assert len(wheels) == 1
+    assert wheels0.endswith(".whl")
+
+
+def test_pip_wheel_fail(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test 'pip wheel' failure.
+    """
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "wheelbroken==0.1",
+        expect_error=True,
+    )
+    wheel_file_name = f"wheelbroken-0.1-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_not_create(wheel_file_path)
+    assert "FakeError" in result.stderr, result.stderr
+    assert "Failed to build wheelbroken" in result.stdout, result.stdout
+    assert result.returncode != 0
+
+
+def test_pip_wheel_source_deps(script: PipTestEnvironment, data: TestData) -> None:
+    """
+    Test 'pip wheel' finds and builds source archive dependencies
+    of wheels
+    """
+    # 'requires_source' is a wheel that depends on the 'source' project
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "requires_source",
+    )
+    wheel_file_name = f"source-1.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+    assert "Successfully built source" in result.stdout, result.stdout
+
+
+def test_wheel_package_with_latin1_setup(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Create a wheel from a package with latin-1 encoded setup.py."""
+
+    pkg_to_wheel = data.packages.joinpath("SetupPyLatin1")
+    result = script.pip("wheel", pkg_to_wheel)
+    assert "Successfully built SetupPyUTF8" in result.stdout
+
+
+def test_pip_wheel_with_pep518_build_reqs(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "-f",
+        common_wheels,
+        "pep518==3.0",
+    )
+    wheel_file_name = f"pep518-3.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+    assert "Successfully built pep518" in result.stdout, result.stdout
+    assert "Installing build dependencies" in result.stdout, result.stdout
+
+
+def test_pip_wheel_with_pep518_build_reqs_no_isolation(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    script.pip_install_local("simplewheel==2.0")
+    result = script.pip(
+        "wheel",
+        "--no-index",
+        "-f",
+        data.find_links,
+        "--no-build-isolation",
+        "pep518==3.0",
+    )
+    wheel_file_name = f"pep518-3.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+    assert "Successfully built pep518" in result.stdout, result.stdout
+    assert "Installing build dependencies" not in result.stdout, result.stdout
+
+
+def test_pip_wheel_with_user_set_in_config(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    config_file = script.scratch_path / "pip.conf"
+    script.environ"PIP_CONFIG_FILE" = str(config_file)
+    config_file.write_text("install\nuser = true")
+    result = script.pip(
+        "wheel", data.src / "withpyproject", "--no-index", "-f", common_wheels
+    )
+    assert "Successfully built withpyproject" in result.stdout, result.stdout
+
+
+@pytest.mark.skipif(
+    sys.platform.startswith("win"),
+    reason="The empty extension module does not work on Win",
+)
+@pytest.mark.xfail(
+    condition=sys.platform == "darwin" and sys.version_info < (3, 9),
+    reason=(
+        "Unexplained 'no module named platform' in "
+        "https://github.com/pypa/wheel/blob"
+        "/c87e6ed82b58b41b258a3e8c852af8bc1817bb00"
+        "/src/wheel/vendored/packaging/tags.py#L396-L411"
+    ),
+)
+def test_pip_wheel_ext_module_with_tmpdir_inside(
+    script: PipTestEnvironment, data: TestData, common_wheels: Path
+) -> None:
+    tmpdir = data.src / "extension/tmp"
+    tmpdir.mkdir()
+    script.environ"TMPDIR" = str(tmpdir)
+
+    # To avoid a test dependency on a C compiler, we set the env vars to "noop"
+    # The .c source is empty anyway
+    script.environ"CC" = script.environ"LDSHARED" = "true"
+
+    result = script.pip(
+        "wheel", data.src / "extension", "--no-index", "-f", common_wheels
+    )
+    assert "Successfully built extension" in result.stdout, result.stdout
+
+
+@pytest.mark.network
+def test_pep517_wheels_are_not_confused_with_other_files(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Check correct wheels are copied. (#6196)"""
+    pkg_to_wheel = data.src / "withpyproject"
+    add_files_to_dist_directory(pkg_to_wheel)
+
+    result = script.pip("wheel", pkg_to_wheel, "-w", script.scratch_path)
+    assert "Installing build dependencies" in result.stdout, result.stdout
+
+    wheel_file_name = f"withpyproject-0.0.1-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)
+
+
+def test_legacy_wheels_are_not_confused_with_other_files(
+    script: PipTestEnvironment, data: TestData
+) -> None:
+    """Check correct wheels are copied. (#6196)"""
+    pkg_to_wheel = data.src / "simplewheel-1.0"
+    add_files_to_dist_directory(pkg_to_wheel)
+
+    result = script.pip("wheel", pkg_to_wheel, "-w", script.scratch_path)
+    assert "Installing build dependencies" not in result.stdout, result.stdout
+
+    wheel_file_name = f"simplewheel-1.0-py{pyversion0}-none-any.whl"
+    wheel_file_path = script.scratch / wheel_file_name
+    result.did_create(wheel_file_path)

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/__init__.py Added

@@ -0,0 +1,1338 @@
+import json
+import os
+import pathlib
+import re
+import shutil
+import site
+import subprocess
+import sys
+import textwrap
+from base64 import urlsafe_b64encode
+from contextlib import contextmanager
+from hashlib import sha256
+from io import BytesIO
+from textwrap import dedent
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Union,
+    cast,
+)
+from zipfile import ZipFile
+
+import pytest
+from pip._vendor.packaging.utils import canonicalize_name
+from scripttest import FoundDir, FoundFile, ProcResult, TestFileEnvironment
+
+from pip._internal.index.collector import LinkCollector
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.locations import get_major_minor_version
+from pip._internal.models.search_scope import SearchScope
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.models.target_python import TargetPython
+from pip._internal.network.session import PipSession
+from tests.lib.venv import VirtualEnvironment
+from tests.lib.wheel import make_wheel
+
+if TYPE_CHECKING:
+    # Literal was introduced in Python 3.8.
+    from typing import Literal
+
+    ResolverVariant = Literal"resolvelib", "legacy"
+else:
+    ResolverVariant = str
+
+DATA_DIR = pathlib.Path(__file__).parent.parent.joinpath("data").resolve()
+SRC_DIR = pathlib.Path(__file__).resolve().parent.parent.parent
+
+pyversion = get_major_minor_version()
+
+CURRENT_PY_VERSION_INFO = sys.version_info:3
+
+_Test = Callable..., None
+_FilesState = Dictstr, UnionFoundDir, FoundFile
+
+
+def assert_paths_equal(actual: str, expected: str) -> None:
+    assert os.path.normpath(actual) == os.path.normpath(expected)
+
+
+def create_file(path: str, contents: Optionalstr = None) -> None:
+    """Create a file on the path, with the given contents"""
+    from pip._internal.utils.misc import ensure_dir
+
+    ensure_dir(os.path.dirname(path))
+    with open(path, "w") as f:
+        if contents is not None:
+            f.write(contents)
+        else:
+            f.write("\n")
+
+
+def make_test_search_scope(
+    find_links: OptionalListstr = None,
+    index_urls: OptionalListstr = None,
+) -> SearchScope:
+    if find_links is None:
+        find_links = 
+    if index_urls is None:
+        index_urls = 
+
+    return SearchScope.create(
+        find_links=find_links,
+        index_urls=index_urls,
+        no_index=False,
+    )
+
+
+def make_test_link_collector(
+    find_links: OptionalListstr = None,
+    index_urls: OptionalListstr = None,
+    session: OptionalPipSession = None,
+) -> LinkCollector:
+    """
+    Create a LinkCollector object for testing purposes.
+    """
+    if session is None:
+        session = PipSession()
+
+    search_scope = make_test_search_scope(
+        find_links=find_links,
+        index_urls=index_urls,
+    )
+
+    return LinkCollector(session=session, search_scope=search_scope)
+
+
+def make_test_finder(
+    find_links: OptionalListstr = None,
+    index_urls: OptionalListstr = None,
+    allow_all_prereleases: bool = False,
+    session: OptionalPipSession = None,
+    target_python: OptionalTargetPython = None,
+) -> PackageFinder:
+    """
+    Create a PackageFinder for testing purposes.
+    """
+    link_collector = make_test_link_collector(
+        find_links=find_links,
+        index_urls=index_urls,
+        session=session,
+    )
+    selection_prefs = SelectionPreferences(
+        allow_yanked=True,
+        allow_all_prereleases=allow_all_prereleases,
+    )
+
+    return PackageFinder.create(
+        link_collector=link_collector,
+        selection_prefs=selection_prefs,
+        target_python=target_python,
+    )
+
+
+class TestData:
+    """
+    Represents a bundle of pre-created test data.
+
+    This copies a pristine set of test data into a root location that is
+    designed to be test specific. The reason for this is when running the tests
+    concurrently errors can be generated because the related tooling uses
+    the directory as a work space. This leads to two concurrent processes
+    trampling over each other. This class gets around that by copying all
+    data into a directory and operating on the copied data.
+    """
+
+    __test__ = False
+
+    def __init__(
+        self,
+        root: pathlib.Path,
+        source: Optionalpathlib.Path = None,
+    ) -> None:
+        self.source = source or DATA_DIR
+        self.root = root.resolve()
+
+    @classmethod
+    def copy(cls, root: pathlib.Path) -> "TestData":
+        obj = cls(root)
+        obj.reset()
+        return obj
+
+    def reset(self) -> None:
+        # Check explicitly for the target directory to avoid overly-broad
+        # try/except.
+        if self.root.exists():
+            shutil.rmtree(self.root)
+        shutil.copytree(self.source, self.root, symlinks=True)
+
+    @property
+    def packages(self) -> pathlib.Path:
+        return self.root.joinpath("packages")
+
+    @property
+    def packages2(self) -> pathlib.Path:
+        return self.root.joinpath("packages2")
+
+    @property
+    def packages3(self) -> pathlib.Path:
+        return self.root.joinpath("packages3")
+
+    @property
+    def src(self) -> pathlib.Path:
+        return self.root.joinpath("src")
+
+    @property
+    def indexes(self) -> pathlib.Path:
+        return self.root.joinpath("indexes")
+
+    @property
+    def reqfiles(self) -> pathlib.Path:
+        return self.root.joinpath("reqfiles")
+
+    @property
+    def completion_paths(self) -> pathlib.Path:
+        return self.root.joinpath("completion_paths")
+
+    @property
+    def find_links(self) -> str:
+        return self.packages.as_uri()
+
+    @property
+    def find_links2(self) -> str:
+        return self.packages2.as_uri()
+
+    @property
+    def find_links3(self) -> str:
+        return self.packages3.as_uri()
+
+    @property
+    def backends(self) -> str:
+        return self.root.joinpath("backends").as_uri()
+
+    def index_url(self, index: str = "simple") -> str:
+        return self.root.joinpath("indexes", index).as_uri()
+
+
+class TestFailure(AssertionError):
+    """
+    An "assertion" failed during testing.
+    """
+
+
+StrPath = Unionstr, pathlib.Path
+
+
+class FoundFiles(MappingStrPath, FoundFile):
+    def __init__(self, paths: Mappingstr, FoundFile) -> None:
+        self._paths = {pathlib.Path(k): v for k, v in paths.items()}
+
+    def __contains__(self, o: object) -> bool:
+        if isinstance(o, pathlib.Path):
+            return o in self._paths
+        elif isinstance(o, str):
+            return pathlib.Path(o) in self._paths
+        return False
+
+    def __len__(self) -> int:
+        return len(self._paths)
+
+    def __getitem__(self, k: StrPath) -> FoundFile:
+        if isinstance(k, pathlib.Path):
+            return self._pathsk
+        elif isinstance(k, str):
+            return self._pathspathlib.Path(k)
+        raise KeyError(k)
+
+    def __iter__(self) -> Iteratorpathlib.Path:
+        return iter(self._paths)
+
+
+class TestPipResult:
+    __test__ = False
+
+    def __init__(self, impl: ProcResult, verbose: bool = False) -> None:
+        self._impl = impl
+
+        if verbose:
+            print(self.stdout)
+            if self.stderr:
+                print("======= stderr ========")
+                print(self.stderr)
+                print("=======================")
+
+    def __getattr__(self, attr: str) -> Any:
+        return getattr(self._impl, attr)
+
+    if sys.platform == "win32":
+
+        @property
+        def stdout(self) -> str:
+            return self._impl.stdout.replace("\r\n", "\n")
+
+        @property
+        def stderr(self) -> str:
+            return self._impl.stderr.replace("\r\n", "\n")
+
+        def __str__(self) -> str:
+            return str(self._impl).replace("\r\n", "\n")
+
+    else:
+        # Python doesn't automatically forward __str__ through __getattr__
+
+        def __str__(self) -> str:
+            return str(self._impl)
+
+    @property
+    def files_created(self) -> FoundFiles:
+        return FoundFiles(self._impl.files_created)
+
+    @property
+    def files_updated(self) -> FoundFiles:
+        return FoundFiles(self._impl.files_updated)
+
+    @property
+    def files_deleted(self) -> FoundFiles:
+        return FoundFiles(self._impl.files_deleted)
+
+    def assert_installed(
+        self,
+        pkg_name: str,
+        editable: bool = True,
+        with_files: OptionalListstr = None,
+        without_files: OptionalListstr = None,
+        without_egg_link: bool = False,
+        use_user_site: bool = False,
+        sub_dir: Optionalstr = None,
+    ) -> None:
+        with_files = with_files or 
+        without_files = without_files or 
+        e = self.test_env
+
+        if editable:
+            pkg_dir = e.venv / "src" / pkg_name.lower()
+            # If package was installed in a sub directory
+            if sub_dir:
+                pkg_dir = pkg_dir / sub_dir
+        else:
+            without_egg_link = True
+            pkg_dir = e.site_packages / pkg_name
+
+        if use_user_site:
+            egg_link_path = e.user_site / f"{pkg_name}.egg-link"
+        else:
+            egg_link_path = e.site_packages / f"{pkg_name}.egg-link"
+
+        if without_egg_link:
+            if egg_link_path in self.files_created:
+                raise TestFailure(
+                    f"unexpected egg link file created: {egg_link_path!r}\n{self}"
+                )
+        else:
+            if egg_link_path not in self.files_created:
+                raise TestFailure(
+                    f"expected egg link file missing: {egg_link_path!r}\n{self}"
+                )
+
+            egg_link_file = self.files_createdegg_link_path
+            egg_link_contents = egg_link_file.bytes.replace(os.linesep, "\n")
+
+            # FIXME: I don't understand why there's a trailing . here
+            if not (
+                egg_link_contents.endswith("\n.")
+                and egg_link_contents:-2.endswith(os.fspath(pkg_dir))
+            ):
+                expected_ending = f"{pkg_dir}\n."
+                raise TestFailure(
+                    textwrap.dedent(
+                        f"""
+                        Incorrect egg_link file {egg_link_file!r}
+                        Expected ending: {expected_ending!r}
+                        ------- Actual contents -------
+                        {egg_link_contents!r}
+                        -------------------------------
+                        """
+                    ).strip()
+                )
+
+        if use_user_site:
+            pth_file = e.user_site / "easy-install.pth"
+        else:
+            pth_file = e.site_packages / "easy-install.pth"
+
+        if (pth_file in self.files_updated) == without_egg_link:
+            maybe = "" if without_egg_link else "not "
+            raise TestFailure(f"{pth_file} unexpectedly {maybe}updated by install")
+
+        if (pkg_dir in self.files_created) == (os.curdir in without_files):
+            maybe = "not " if os.curdir in without_files else ""
+            files = sorted(p.as_posix() for p in self.files_created)
+            raise TestFailure(
+                textwrap.dedent(
+                    f"""
+                    expected package directory {pkg_dir!r} {maybe}to be created
+                    actually created:
+                    {files}
+                    """
+                )
+            )
+
+        for f in with_files:
+            normalized_path = os.path.normpath(pkg_dir / f)
+            if normalized_path not in self.files_created:
+                raise TestFailure(
+                    f"Package directory {pkg_dir!r} missing expected content {f!r}"
+                )
+
+        for f in without_files:
+            normalized_path = os.path.normpath(pkg_dir / f)
+            if normalized_path in self.files_created:
+                raise TestFailure(
+                    f"Package directory {pkg_dir!r} has unexpected content {f}"
+                )
+
+    def did_create(self, path: StrPath, message: Optionalstr = None) -> None:
+        assert path in self.files_created, _one_or_both(message, self)
+
+    def did_not_create(self, p: StrPath, message: Optionalstr = None) -> None:
+        assert p not in self.files_created, _one_or_both(message, self)
+
+    def did_update(self, path: StrPath, message: Optionalstr = None) -> None:
+        assert path in self.files_updated, _one_or_both(message, self)
+
+    def did_not_update(self, p: StrPath, message: Optionalstr = None) -> None:
+        assert p not in self.files_updated, _one_or_both(message, self)
+
+
+def _one_or_both(a: Optionalstr, b: Any) -> str:
+    """Returns f"{a}\n{b}" if a is truthy, else returns str(b)."""
+    if not a:
+        return str(b)
+
+    return f"{a}\n{b}"
+
+
+def make_check_stderr_message(stderr: str, line: str, reason: str) -> str:
+    """
+    Create an exception message to use inside check_stderr().
+    """
+    return dedent(
+        """\
+    {reason}:
+     Caused by line: {line!r}
+     Complete stderr: {stderr}
+    """
+    ).format(stderr=stderr, line=line, reason=reason)
+
+
+def _check_stderr(
+    stderr: str,
+    allow_stderr_warning: bool,
+    allow_stderr_error: bool,
+) -> None:
+    """
+    Check the given stderr for logged warnings and errors.
+
+    :param stderr: stderr output as a string.
+    :param allow_stderr_warning: whether a logged warning (or deprecation
+        message) is allowed. Must be True if allow_stderr_error is True.
+    :param allow_stderr_error: whether a logged error is allowed.
+    """
+    assert not (allow_stderr_error and not allow_stderr_warning)
+
+    lines = stderr.splitlines()
+    for line in lines:
+        line = line.lstrip()
+        # First check for logging errors, which we don't allow during
+        # tests even if allow_stderr_error=True (since a logging error
+        # would signal a bug in pip's code).
+        #    Unlike errors logged with logger.error(), these errors are
+        # sent directly to stderr and so bypass any configured log formatter.
+        # The "--- Logging error ---" string is used in Python 3.4+, and
+        # "Logged from file " is used in Python 2.
+        if line.startswith("--- Logging error ---") or line.startswith(
+            "Logged from file "
+        ):
+            reason = "stderr has a logging error, which is never allowed"
+            msg = make_check_stderr_message(stderr, line=line, reason=reason)
+            raise RuntimeError(msg)
+        if allow_stderr_error:
+            continue
+
+        if line.startswith("ERROR: "):
+            reason = (
+                "stderr has an unexpected error "
+                "(pass allow_stderr_error=True to permit this)"
+            )
+            msg = make_check_stderr_message(stderr, line=line, reason=reason)
+            raise RuntimeError(msg)
+        if allow_stderr_warning:
+            continue
+
+        if line.startswith("WARNING: "):
+            reason = (
+                "stderr has an unexpected warning "
+                "(pass allow_stderr_warning=True to permit this)"
+            )
+            msg = make_check_stderr_message(stderr, line=line, reason=reason)
+            raise RuntimeError(msg)
+
+
+class PipTestEnvironment(TestFileEnvironment):
+    """
+    A specialized TestFileEnvironment for testing pip
+    """
+
+    #
+    # Attribute naming convention
+    # ---------------------------
+    #
+    # Instances of this class have many attributes representing paths
+    # in the filesystem.  To keep things straight, absolute paths have
+    # a name of the form xxxx_path and relative paths have a name that
+    # does not end in '_path'.
+
+    exe = sys.platform == "win32" and ".exe" or ""
+    verbose = False
+
+    def __init__(
+        self,
+        base_path: pathlib.Path,
+        *args: Any,
+        virtualenv: VirtualEnvironment,
+        pip_expect_warning: bool = False,
+        zipapp: Optionalstr = None,
+        **kwargs: Any,
+    ) -> None:
+        # Store paths related to the virtual environment
+        self.venv_path = virtualenv.location
+        self.lib_path = virtualenv.lib
+        self.site_packages_path = virtualenv.site
+        self.bin_path = virtualenv.bin
+
+        assert site.USER_BASE is not None
+        assert site.USER_SITE is not None
+
+        self.user_base_path = self.venv_path.joinpath("user")
+        self.user_site_path = self.venv_path.joinpath(
+            "user",
+            site.USER_SITElen(site.USER_BASE) + 1 :,
+        )
+        if sys.platform == "win32":
+            scripts_base = self.user_site_path.joinpath("..").resolve()
+            self.user_bin_path = scripts_base.joinpath("Scripts")
+        else:
+            self.user_bin_path = self.user_base_path.joinpath(
+                os.path.relpath(self.bin_path, self.venv_path)
+            )
+
+        # Create a Directory to use as a scratch pad
+        self.scratch_path = base_path.joinpath("scratch")
+        self.scratch_path.mkdir()
+
+        # Set our default working directory
+        kwargs.setdefault("cwd", self.scratch_path)
+
+        # Setup our environment
+        environ = kwargs.setdefault("environ", os.environ.copy())
+        environ"PATH" = os.pathsep.join(
+            os.fspath(self.bin_path), environ.get("PATH", ""),
+        )
+        environ"PYTHONUSERBASE" = self.user_base_path
+        # Writing bytecode can mess up updated file detection
+        environ"PYTHONDONTWRITEBYTECODE" = "1"
+        # Make sure we get UTF-8 on output, even on Windows...
+        environ"PYTHONIOENCODING" = "UTF-8"
+
+        # Whether all pip invocations should expect stderr
+        # (useful for Python version deprecation)
+        self.pip_expect_warning = pip_expect_warning
+
+        # The name of an (optional) zipapp to use when running pip
+        self.zipapp = zipapp
+
+        # Call the TestFileEnvironment __init__
+        super().__init__(base_path, *args, **kwargs)
+
+        # Expand our absolute path directories into relative
+        for name in 
+            "base",
+            "venv",
+            "bin",
+            "lib",
+            "site_packages",
+            "user_base",
+            "user_site",
+            "user_bin",
+            "scratch",
+        :
+            real_name = f"{name}_path"
+            relative_path = pathlib.Path(
+                os.path.relpath(getattr(self, real_name), self.base_path)
+            )
+            setattr(self, name, relative_path)
+
+        # Make sure temp_path is a Path object
+        self.temp_path: pathlib.Path = pathlib.Path(self.temp_path)
+        # Ensure the tmp dir exists, things break horribly if it doesn't
+        self.temp_path.mkdir()
+
+        # create easy-install.pth in user_site, so we always have it updated
+        #   instead of created
+        self.user_site_path.mkdir(parents=True)
+        self.user_site_path.joinpath("easy-install.pth").touch()
+
+    def _ignore_file(self, fn: str) -> bool:
+        if fn.endswith("__pycache__") or fn.endswith(".pyc"):
+            result = True
+        elif self.zipapp and fn.endswith("cacert.pem"):
+            # Temporary copies of cacert.pem are extracted
+            # when running from a zipapp
+            result = True
+        else:
+            result = super()._ignore_file(fn)
+        return result
+
+    def _find_traverse(self, path: str, result: Dictstr, FoundDir) -> None:
+        # Ignore symlinked directories to avoid duplicates in `run()`
+        # results because of venv `lib64 -> lib/` symlink on Linux.
+        full = os.path.join(self.base_path, path)
+        if os.path.isdir(full) and os.path.islink(full):
+            if not self.temp_path or path != "tmp":
+                resultpath = FoundDir(self.base_path, path)
+        else:
+            super()._find_traverse(path, result)
+
+    def run(
+        self,
+        *args: str,
+        cwd: OptionalStrPath = None,
+        allow_stderr_error: Optionalbool = None,
+        allow_stderr_warning: Optionalbool = None,
+        allow_error: bool = False,
+        **kw: Any,
+    ) -> TestPipResult:
+        """
+        :param allow_stderr_error: whether a logged error is allowed in
+            stderr.  Passing True for this argument implies
+            `allow_stderr_warning` since warnings are weaker than errors.
+        :param allow_stderr_warning: whether a logged warning (or
+            deprecation message) is allowed in stderr.
+        :param allow_error: if True (default is False) does not raise
+            exception when the command exit value is non-zero.  Implies
+            expect_error, but in contrast to expect_error will not assert
+            that the exit value is zero.
+        :param expect_error: if False (the default), asserts that the command
+            exits with 0.  Otherwise, asserts that the command exits with a
+            non-zero exit code.  Passing True also implies allow_stderr_error
+            and allow_stderr_warning.
+        :param expect_stderr: whether to allow warnings in stderr (equivalent
+            to `allow_stderr_warning`).  This argument is an abbreviated
+            version of `allow_stderr_warning` and is also kept for backwards
+            compatibility.
+        """
+        if self.verbose:
+            print(f">> running {args} {kw}")
+
+        cwd = cwd or self.cwd
+        if sys.platform == "win32":
+            # Partial fix for ScriptTest.run using `shell=True` on Windows.
+            args = tuple(str(a).replace("^", "^^").replace("&", "^&") for a in args)
+
+        if allow_error:
+            kw"expect_error" = True
+
+        # Propagate default values.
+        expect_error = kw.get("expect_error")
+        if expect_error:
+            # Then default to allowing logged errors.
+            if allow_stderr_error is not None and not allow_stderr_error:
+                raise RuntimeError(
+                    "cannot pass allow_stderr_error=False with expect_error=True"
+                )
+            allow_stderr_error = True
+
+        elif kw.get("expect_stderr"):
+            # Then default to allowing logged warnings.
+            if allow_stderr_warning is not None and not allow_stderr_warning:
+                raise RuntimeError(
+                    "cannot pass allow_stderr_warning=False with expect_stderr=True"
+                )
+            allow_stderr_warning = True
+
+        if allow_stderr_error:
+            if allow_stderr_warning is not None and not allow_stderr_warning:
+                raise RuntimeError(
+                    "cannot pass allow_stderr_warning=False with "
+                    "allow_stderr_error=True"
+                )
+
+        # Default values if not set.
+        if allow_stderr_error is None:
+            allow_stderr_error = False
+        if allow_stderr_warning is None:
+            allow_stderr_warning = allow_stderr_error
+
+        # Pass expect_stderr=True to allow any stderr.  We do this because
+        # we do our checking of stderr further on in check_stderr().
+        kw"expect_stderr" = True
+        result = super().run(cwd=cwd, *args, **kw)
+
+        if expect_error and not allow_error:
+            if result.returncode == 0:
+                __tracebackhide__ = True
+                raise AssertionError(f"Script passed unexpectedly:\n{result}")
+
+        _check_stderr(
+            result.stderr,
+            allow_stderr_error=allow_stderr_error,
+            allow_stderr_warning=allow_stderr_warning,
+        )
+
+        return TestPipResult(result, verbose=self.verbose)
+
+    def pip(
+        self,
+        *args: StrPath,
+        use_module: bool = True,
+        **kwargs: Any,
+    ) -> TestPipResult:
+        __tracebackhide__ = True
+        if self.pip_expect_warning:
+            kwargs"allow_stderr_warning" = True
+        if self.zipapp:
+            exe = "python"
+            args = (self.zipapp,) + args
+        elif use_module:
+            exe = "python"
+            args = ("-m", "pip") + args
+        else:
+            exe = "pip"
+        return self.run(exe, *(os.fspath(a) for a in args), **kwargs)
+
+    def pip_install_local(
+        self,
+        *args: StrPath,
+        **kwargs: Any,
+    ) -> TestPipResult:
+        return self.pip(
+            "install",
+            "--no-index",
+            "--find-links",
+            pathlib.Path(DATA_DIR, "packages").as_uri(),
+            *args,
+            **kwargs,
+        )
+
+    def easy_install(self, *args: str, **kwargs: Any) -> TestPipResult:
+        args = ("-m", "easy_install") + args
+        return self.run("python", *args, **kwargs)
+
+    def assert_installed(self, **kwargs: str) -> None:
+        ret = self.pip("list", "--format=json")
+        installed = set(
+            (canonicalize_name(val"name"), val"version")
+            for val in json.loads(ret.stdout)
+        )
+        expected = set((canonicalize_name(k), v) for k, v in kwargs.items())
+        assert expected <= installed, "{!r} not all in {!r}".format(expected, installed)
+
+    def assert_not_installed(self, *args: str) -> None:
+        ret = self.pip("list", "--format=json")
+        installed = set(
+            canonicalize_name(val"name") for val in json.loads(ret.stdout)
+        )
+        # None of the given names should be listed as installed, i.e. their
+        # intersection should be empty.
+        expected = set(canonicalize_name(k) for k in args)
+        assert not (expected & installed), "{!r} contained in {!r}".format(
+            expected, installed
+        )
+
+
+# FIXME ScriptTest does something similar, but only within a single
+# ProcResult; this generalizes it so states can be compared across
+# multiple commands.  Maybe should be rolled into ScriptTest?
+def diff_states(
+    start: _FilesState, end: _FilesState, ignore: IterableStrPath = ()
+) -> Dictstr, _FilesState:
+    """
+    Differences two "filesystem states" as represented by dictionaries
+    of FoundFile and FoundDir objects.
+
+    Returns a dictionary with following keys:
+
+    ``deleted``
+        Dictionary of files/directories found only in the start state.
+
+    ``created``
+        Dictionary of files/directories found only in the end state.
+
+    ``updated``
+        Dictionary of files whose size has changed (FIXME not entirely
+        reliable, but comparing contents is not possible because
+        FoundFile.bytes is lazy, and comparing mtime doesn't help if
+        we want to know if a file has been returned to its earlier
+        state).
+
+    Ignores mtime and other file attributes; only presence/absence and
+    size are considered.
+
+    """
+
+    def prefix_match(path: str, prefix_path: StrPath) -> bool:
+        prefix = os.fspath(prefix_path)
+        if path == prefix:
+            return True
+        prefix = prefix.rstrip(os.path.sep) + os.path.sep
+        return path.startswith(prefix)
+
+    start_keys = {
+        k for k in start.keys() if not any(prefix_match(k, i) for i in ignore)
+    }
+    end_keys = {k for k in end.keys() if not any(prefix_match(k, i) for i in ignore)}
+    deleted = {k: startk for k in start_keys.difference(end_keys)}
+    created = {k: endk for k in end_keys.difference(start_keys)}
+    updated = {}
+    for k in start_keys.intersection(end_keys):
+        if startk.size != endk.size:
+            updatedk = endk
+    return dict(deleted=deleted, created=created, updated=updated)
+
+
+def assert_all_changes(
+    start_state: Union_FilesState, TestPipResult,
+    end_state: Union_FilesState, TestPipResult,
+    expected_changes: ListStrPath,
+) -> Dictstr, _FilesState:
+    """
+    Fails if anything changed that isn't listed in the
+    expected_changes.
+
+    start_state is either a dict mapping paths to
+    scripttest.FoundFile|FoundDir objects or a TestPipResult whose
+    files_before we'll test.  end_state is either a similar dict or a
+    TestPipResult whose files_after we'll test.
+
+    Note: listing a directory means anything below
+    that directory can be expected to have changed.
+    """
+    __tracebackhide__ = True
+
+    start_files = start_state
+    end_files = end_state
+    if isinstance(start_state, TestPipResult):
+        start_files = start_state.files_before
+    if isinstance(end_state, TestPipResult):
+        end_files = end_state.files_after
+    start_files = cast(_FilesState, start_files)
+    end_files = cast(_FilesState, end_files)
+
+    diff = diff_states(start_files, end_files, ignore=expected_changes)
+    if list(diff.values()) != {}, {}, {}:
+        raise TestFailure(
+            "Unexpected changes:\n"
+            + "\n".join(k + ": " + ", ".join(v.keys()) for k, v in diff.items())
+        )
+
+    # Don't throw away this potentially useful information
+    return diff
+
+
+def _create_main_file(
+    dir_path: pathlib.Path,
+    name: Optionalstr = None,
+    output: Optionalstr = None,
+) -> None:
+    """
+    Create a module with a main() function that prints the given output.
+    """
+    if name is None:
+        name = "version_pkg"
+    if output is None:
+        output = "0.1"
+    text = textwrap.dedent(
+        f"""
+        def main():
+            print({output!r})
+        """
+    )
+    filename = f"{name}.py"
+    dir_path.joinpath(filename).write_text(text)
+
+
+def _git_commit(
+    env_or_script: PipTestEnvironment,
+    repo_dir: StrPath,
+    message: Optionalstr = None,
+    allow_empty: bool = False,
+    stage_modified: bool = False,
+) -> None:
+    """
+    Run git-commit.
+
+    Args:
+      env_or_script: pytest's `script` or `env` argument.
+      repo_dir: a path to a Git repository.
+      message: an optional commit message.
+    """
+    if message is None:
+        message = "test commit"
+
+    args = 
+
+    if allow_empty:
+        args.append("--allow-empty")
+
+    if stage_modified:
+        args.append("--all")
+
+    new_args = 
+        "git",
+        "commit",
+        "-q",
+        "--author",
+        "pip <distutils-sig@python.org>",
+    
+    new_args.extend(args)
+    new_args.extend("-m", message)
+    env_or_script.run(*new_args, cwd=repo_dir)
+
+
+def _vcs_add(
+    location: pathlib.Path,
+    version_pkg_path: pathlib.Path,
+    vcs: str = "git",
+) -> pathlib.Path:
+    if vcs == "git":
+        subprocess.check_call("git", "init", cwd=os.fspath(version_pkg_path))
+        subprocess.check_call("git", "add", ".", cwd=os.fspath(version_pkg_path))
+        subprocess.check_call(
+            "git", "commit", "-m", "initial version", cwd=os.fspath(version_pkg_path)
+        )
+    elif vcs == "hg":
+        subprocess.check_call("hg", "init", cwd=os.fspath(version_pkg_path))
+        subprocess.check_call("hg", "add", ".", cwd=os.fspath(version_pkg_path))
+        subprocess.check_call(
+            
+                "hg",
+                "commit",
+                "-q",
+                "--user",
+                "pip <distutils-sig@python.org>",
+                "-m",
+                "initial version",
+            ,
+            cwd=os.fspath(version_pkg_path),
+        )
+    elif vcs == "svn":
+        repo_url = _create_svn_repo(location, version_pkg_path)
+        subprocess.check_call(
+            "svn", "checkout", repo_url, "pip-test-package", cwd=os.fspath(location)
+        )
+        checkout_path = location / "pip-test-package"
+
+        version_pkg_path = checkout_path
+    elif vcs == "bazaar":
+        subprocess.check_call("bzr", "init", cwd=os.fspath(version_pkg_path))
+        subprocess.check_call("bzr", "add", ".", cwd=os.fspath(version_pkg_path))
+        subprocess.check_call(
+            "bzr", "whoami", "pip <distutils-sig@python.org>",
+            cwd=os.fspath(version_pkg_path),
+        )
+        subprocess.check_call(
+            
+                "bzr",
+                "commit",
+                "-q",
+                "--author",
+                "pip <distutils-sig@python.org>",
+                "-m",
+                "initial version",
+            ,
+            cwd=os.fspath(version_pkg_path),
+        )
+    else:
+        raise ValueError(f"Unknown vcs: {vcs}")
+    return version_pkg_path
+
+
+def _create_test_package_with_subdirectory(
+    script: PipTestEnvironment, subdirectory: str
+) -> pathlib.Path:
+    script.scratch_path.joinpath("version_pkg").mkdir()
+    version_pkg_path = script.scratch_path / "version_pkg"
+    _create_main_file(version_pkg_path, name="version_pkg", output="0.1")
+    version_pkg_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+            from setuptools import setup, find_packages
+
+            setup(
+                name="version_pkg",
+                version="0.1",
+                packages=find_packages(),
+                py_modules="version_pkg",
+                entry_points=dict(console_scripts="version_pkg=version_pkg:main"),
+            )
+            """
+        )
+    )
+
+    subdirectory_path = version_pkg_path.joinpath(subdirectory)
+    subdirectory_path.mkdir()
+    _create_main_file(subdirectory_path, name="version_subpkg", output="0.1")
+
+    subdirectory_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+            from setuptools import find_packages, setup
+
+            setup(
+                name="version_subpkg",
+                version="0.1",
+                packages=find_packages(),
+                py_modules="version_subpkg",
+                entry_points=dict(console_scripts="version_pkg=version_subpkg:main"),
+            )
+            """
+        )
+    )
+
+    script.run("git", "init", cwd=version_pkg_path)
+    script.run("git", "add", ".", cwd=version_pkg_path)
+    _git_commit(script, version_pkg_path, message="initial version")
+
+    return version_pkg_path
+
+
+def _create_test_package_with_srcdir(
+    dir_path: pathlib.Path, name: str = "version_pkg", vcs: str = "git"
+) -> pathlib.Path:
+    dir_path.joinpath(name).mkdir()
+    version_pkg_path = dir_path / name
+    subdir_path = version_pkg_path.joinpath("subdir")
+    subdir_path.mkdir()
+    src_path = subdir_path.joinpath("src")
+    src_path.mkdir()
+    pkg_path = src_path.joinpath("pkg")
+    pkg_path.mkdir()
+    pkg_path.joinpath("__init__.py").write_text("")
+    subdir_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+                from setuptools import setup, find_packages
+                setup(
+                    name="{name}",
+                    version="0.1",
+                    packages=find_packages(),
+                    package_dir={{"": "src"}},
+                )
+            """.format(
+                name=name
+            )
+        )
+    )
+    return _vcs_add(dir_path, version_pkg_path, vcs)
+
+
+def _create_test_package(
+    dir_path: pathlib.Path, name: str = "version_pkg", vcs: str = "git"
+) -> pathlib.Path:
+    dir_path.joinpath(name).mkdir()
+    version_pkg_path = dir_path / name
+    _create_main_file(version_pkg_path, name=name, output="0.1")
+    version_pkg_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """
+                from setuptools import setup, find_packages
+                setup(
+                    name="{name}",
+                    version="0.1",
+                    packages=find_packages(),
+                    py_modules="{name}",
+                    entry_points=dict(console_scripts="{name}={name}:main"),
+                )
+            """.format(
+                name=name
+            )
+        )
+    )
+    return _vcs_add(dir_path, version_pkg_path, vcs)
+
+
+def _create_svn_repo(repo_path: pathlib.Path, version_pkg_path: StrPath) -> str:
+    repo_url = repo_path.joinpath("pip-test-package-repo", "trunk").as_uri()
+    subprocess.check_call(
+        "svnadmin create pip-test-package-repo".split(), cwd=repo_path
+    )
+    subprocess.check_call(
+        
+            "svn",
+            "import",
+            os.fspath(version_pkg_path),
+            repo_url,
+            "-m",
+            "Initial import of pip-test-package",
+        ,
+        cwd=os.fspath(repo_path),
+    )
+    return repo_url
+
+
+def _change_test_package_version(
+    script: PipTestEnvironment, version_pkg_path: pathlib.Path
+) -> None:
+    _create_main_file(
+        version_pkg_path, name="version_pkg", output="some different version"
+    )
+    # Pass -a to stage the change to the main file.
+    _git_commit(script, version_pkg_path, message="messed version", stage_modified=True)
+
+
+@contextmanager
+def requirements_file(contents: str, tmpdir: pathlib.Path) -> Iteratorpathlib.Path:
+    """Return a Path to a requirements file of given contents.
+
+    As long as the context manager is open, the requirements file will exist.
+
+    :param tmpdir: A Path to the folder in which to create the file
+
+    """
+    path = tmpdir / "reqs.txt"
+    path.write_text(contents)
+    yield path
+    path.unlink()
+
+
+def create_test_package_with_setup(
+    script: PipTestEnvironment, **setup_kwargs: Any
+) -> pathlib.Path:
+    assert "name" in setup_kwargs, setup_kwargs
+    pkg_path = script.scratch_path / setup_kwargs"name"
+    pkg_path.mkdir()
+    pkg_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            f"""
+                from setuptools import setup
+                kwargs = {setup_kwargs!r}
+                setup(**kwargs)
+            """
+        )
+    )
+    return pkg_path
+
+
+def urlsafe_b64encode_nopad(data: bytes) -> str:
+    return urlsafe_b64encode(data).rstrip(b"=").decode("ascii")
+
+
+def create_really_basic_wheel(name: str, version: str) -> bytes:
+    def digest(contents: bytes) -> str:
+        return "sha256={}".format(urlsafe_b64encode_nopad(sha256(contents).digest()))
+
+    def add_file(path: str, text: str) -> None:
+        contents = text.encode("utf-8")
+        z.writestr(path, contents)
+        records.append((path, digest(contents), str(len(contents))))
+
+    dist_info = f"{name}-{version}.dist-info"
+    record_path = f"{dist_info}/RECORD"
+    records = (record_path, "", "")
+    buf = BytesIO()
+    with ZipFile(buf, "w") as z:
+        add_file(f"{dist_info}/WHEEL", "Wheel-Version: 1.0")
+        add_file(
+            f"{dist_info}/METADATA",
+            dedent(
+                """\
+                Metadata-Version: 2.1
+                Name: {}
+                Version: {}
+                """.format(
+                    name, version
+                )
+            ),
+        )
+        z.writestr(record_path, "\n".join(",".join(r) for r in records))
+    buf.seek(0)
+    return buf.read()
+
+
+def create_basic_wheel_for_package(
+    script: PipTestEnvironment,
+    name: str,
+    version: str,
+    depends: OptionalListstr = None,
+    extras: OptionalDictstr, Liststr = None,
+    requires_python: Optionalstr = None,
+    extra_files: OptionalDictstr, Unionbytes, str = None,
+) -> pathlib.Path:
+    if depends is None:
+        depends = 
+    if extras is None:
+        extras = {}
+    if extra_files is None:
+        extra_files = {}
+
+    # Fix wheel distribution name by replacing runs of non-alphanumeric
+    # characters with an underscore _ as per PEP 491
+    name = re.sub(r"^\w\d.+", "_", name, re.UNICODE)
+    archive_name = f"{name}-{version}-py2.py3-none-any.whl"
+    archive_path = script.scratch_path / archive_name
+
+    package_init_py = f"{name}/__init__.py"
+    assert package_init_py not in extra_files
+    extra_filespackage_init_py = textwrap.dedent(
+        """
+        __version__ = {version!r}
+        def hello():
+            return "Hello From {name}"
+        """,
+    ).format(version=version, name=name)
+
+    requires_dist = depends + 
+        f'{package}; extra == "{extra}"'
+        for extra, packages in extras.items()
+        for package in packages
+    
+
+    metadata_updates: Dictstr, Any = {
+        "Provides-Extra": list(extras),
+        "Requires-Dist": requires_dist,
+    }
+    if requires_python is not None:
+        metadata_updates"Requires-Python" = requires_python
+
+    wheel_builder = make_wheel(
+        name=name,
+        version=version,
+        wheel_metadata_updates={"Tag": "py2-none-any", "py3-none-any"},
+        metadata_updates=metadata_updates,
+        extra_metadata_files={"top_level.txt": name},
+        extra_files=extra_files,
+        # Have an empty RECORD because we don't want to be checking hashes.
+        record="",
+    )
+    wheel_builder.save_to(archive_path)
+
+    return archive_path
+
+
+def create_basic_sdist_for_package(
+    script: PipTestEnvironment,
+    name: str,
+    version: str,
+    extra_files: OptionalDictstr, str = None,
+    *,
+    fails_egg_info: bool = False,
+    fails_bdist_wheel: bool = False,
+    depends: OptionalListstr = None,
+    setup_py_prelude: str = "",
+) -> pathlib.Path:
+    files = {
+        "setup.py": textwrap.dedent(
+            """\
+            import sys
+            from setuptools import find_packages, setup
+
+            {setup_py_prelude}
+
+            fails_bdist_wheel = {fails_bdist_wheel!r}
+            fails_egg_info = {fails_egg_info!r}
+
+            if fails_egg_info and "egg_info" in sys.argv:
+                raise Exception("Simulated failure for generating metadata.")
+
+            if fails_bdist_wheel and "bdist_wheel" in sys.argv:
+                raise Exception("Simulated failure for building a wheel.")
+
+            setup(name={name!r}, version={version!r},
+                install_requires={depends!r})
+        """
+        ).format(
+            name=name,
+            version=version,
+            depends=depends or ,
+            setup_py_prelude=setup_py_prelude,
+            fails_bdist_wheel=fails_bdist_wheel,
+            fails_egg_info=fails_egg_info,
+        ),
+    }
+
+    # Some useful shorthands
+    archive_name = f"{name}-{version}.tar.gz"
+
+    # Add new files after formatting
+    if extra_files:
+        files.update(extra_files)
+
+    for fname in files:
+        path = script.temp_path / fname
+        path.parent.mkdir(exist_ok=True, parents=True)
+        path.write_bytes(filesfname.encode("utf-8"))
+
+    retval = script.scratch_path / archive_name
+    generated = shutil.make_archive(
+        os.fspath(retval),
+        "gztar",
+        root_dir=script.temp_path,
+        base_dir=os.curdir,
+    )
+    shutil.move(generated, retval)
+
+    shutil.rmtree(script.temp_path)
+    script.temp_path.mkdir()
+
+    return retval
+
+
+def need_executable(name: str, check_cmd: Tuplestr, ...) -> Callable_Test, _Test:
+    def wrapper(fn: _Test) -> _Test:
+        try:
+            subprocess.check_output(check_cmd)
+        except (OSError, subprocess.CalledProcessError):
+            return pytest.mark.skip(reason=f"{name} is not available")(fn)
+        return fn
+
+    return wrapper
+
+
+def is_bzr_installed() -> bool:
+    try:
+        subprocess.check_output(("bzr", "version", "--short"))
+    except OSError:
+        return False
+    return True
+
+
+def is_svn_installed() -> bool:
+    try:
+        subprocess.check_output(("svn", "--version"))
+    except OSError:
+        return False
+    return True
+
+
+def need_bzr(fn: _Test) -> _Test:
+    return pytest.mark.bzr(need_executable("Bazaar", ("bzr", "version", "--short"))(fn))
+
+
+def need_svn(fn: _Test) -> _Test:
+    return pytest.mark.svn(
+        need_executable("Subversion", ("svn", "--version"))(
+            need_executable("Subversion Admin", ("svnadmin", "--version"))(fn)
+        )
+    )
+
+
+def need_mercurial(fn: _Test) -> _Test:
+    return pytest.mark.mercurial(need_executable("Mercurial", ("hg", "version"))(fn))

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/certs.py Added

@@ -0,0 +1,46 @@
+from datetime import datetime, timedelta
+from typing import Tuple
+
+from cryptography import x509
+from cryptography.hazmat.backends import default_backend
+from cryptography.hazmat.primitives import hashes, serialization
+from cryptography.hazmat.primitives.asymmetric import rsa
+from cryptography.x509.oid import NameOID
+
+
+def make_tls_cert(hostname: str) -> Tuplex509.Certificate, rsa.RSAPrivateKey:
+    key = rsa.generate_private_key(
+        public_exponent=65537, key_size=2048, backend=default_backend()
+    )
+    subject = issuer = x509.Name(
+        
+            x509.NameAttribute(NameOID.COMMON_NAME, hostname),
+        
+    )
+    cert = (
+        x509.CertificateBuilder()
+        .subject_name(subject)
+        .issuer_name(issuer)
+        .public_key(key.public_key())
+        .serial_number(x509.random_serial_number())
+        .not_valid_before(datetime.utcnow())
+        .not_valid_after(datetime.utcnow() + timedelta(days=10))
+        .add_extension(
+            x509.SubjectAlternativeName(x509.DNSName(hostname)),
+            critical=False,
+        )
+        .sign(key, hashes.SHA256(), default_backend())
+    )
+    return cert, key
+
+
+def serialize_key(key: rsa.RSAPrivateKey) -> bytes:
+    return key.private_bytes(
+        encoding=serialization.Encoding.PEM,
+        format=serialization.PrivateFormat.TraditionalOpenSSL,
+        encryption_algorithm=serialization.NoEncryption(),
+    )
+
+
+def serialize_cert(cert: x509.Certificate) -> bytes:
+    return cert.public_bytes(serialization.Encoding.PEM)

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/compat.py Added

@@ -0,0 +1,54 @@
+# mypy: no-warn-unused-ignores
+
+import contextlib
+import signal
+from typing import Iterable, Iterator
+
+
+@contextlib.contextmanager
+def nullcontext() -> IteratorNone:
+    """
+    Context manager that does no additional processing.
+
+    Used as a stand-in for a normal context manager, when a particular block of
+    code is only sometimes used with a normal context manager:
+
+        cm = optional_cm if condition else nullcontext()
+        with cm:
+            # Perform operation, using optional_cm if condition is True
+
+    TODO: Replace with contextlib.nullcontext after dropping Python 3.6
+    support.
+    """
+    yield
+
+
+# Applies on Windows.
+if not hasattr(signal, "pthread_sigmask"):
+    # We're not relying on this behavior anywhere currently, it's just best
+    # practice.
+    blocked_signals = nullcontext
+else:
+
+    @contextlib.contextmanager
+    def blocked_signals() -> IteratorNone:
+        """Block all signals for e.g. starting a worker thread."""
+        # valid_signals() was added in Python 3.8 (and not using it results
+        # in a warning on pthread_sigmask() call)
+        mask: Iterableint
+        try:
+            mask = signal.valid_signals()
+        except AttributeError:
+            mask = set(range(1, signal.NSIG))
+
+        old_mask = signal.pthread_sigmask(  # type: ignoreattr-defined
+            signal.SIG_SETMASK,  # type: ignoreattr-defined
+            mask,
+        )
+        try:
+            yield
+        finally:
+            signal.pthread_sigmask(  # type: ignoreattr-defined
+                signal.SIG_SETMASK,  # type: ignoreattr-defined
+                old_mask,
+            )

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/configuration_helpers.py Added

@@ -0,0 +1,56 @@
+"""Helpers for tests that check configuration
+"""
+
+import contextlib
+import functools
+import os
+import tempfile
+import textwrap
+from typing import Any, Dict, Iterator
+
+import pip._internal.configuration
+from pip._internal.utils.misc import ensure_dir
+
+# This is so that tests don't need to import pip._internal.configuration.
+Kind = pip._internal.configuration.Kind
+kinds = pip._internal.configuration.kinds
+
+
+class ConfigurationMixin:
+    def setup_method(self) -> None:
+        self.configuration = pip._internal.configuration.Configuration(
+            isolated=False,
+        )
+
+    def patch_configuration(self, variant: Kind, di: Dictstr, Any) -> None:
+        old = self.configuration._load_config_files
+
+        @functools.wraps(old)
+        def overridden() -> None:
+            # Manual Overload
+            self.configuration._configvariant.update(di)
+            # Configuration._parsers has type:
+            # DictKind, ListTuplestr, RawConfigParser.
+            # As a testing convenience, pass a special value.
+            self.configuration._parsersvariant.append(
+                (None, None),  # type: ignorearg-type
+            )
+            old()
+
+        # https://github.com/python/mypy/issues/2427
+        self.configuration._load_config_files = overridden  # type: ignoreassignment
+
+    @contextlib.contextmanager
+    def tmpfile(self, contents: str) -> Iteratorstr:
+        # Create a temporary file
+        fd, path = tempfile.mkstemp(prefix="pip_", suffix="_config.ini", text=True)
+        os.close(fd)
+
+        contents = textwrap.dedent(contents).lstrip()
+        ensure_dir(os.path.dirname(path))
+        with open(path, "w") as f:
+            f.write(contents)
+
+        yield path
+
+        os.remove(path)

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/direct_url.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/filesystem.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/git_submodule_helpers.py Added

@@ -0,0 +1,83 @@
+import os
+import textwrap
+from pathlib import Path
+from typing import Tuple
+
+from tests.lib import PipTestEnvironment, _create_main_file, _git_commit
+
+
+def _create_test_package_submodule(env: PipTestEnvironment) -> Path:
+    env.scratch_path.joinpath("version_pkg_submodule").mkdir()
+    submodule_path = env.scratch_path / "version_pkg_submodule"
+    env.run("touch", "testfile", cwd=submodule_path)
+    env.run("git", "init", cwd=submodule_path)
+    env.run("git", "add", ".", cwd=submodule_path)
+    _git_commit(env, submodule_path, message="initial version / submodule")
+
+    return submodule_path
+
+
+def _change_test_package_submodule(
+    env: PipTestEnvironment, submodule_path: Path
+) -> None:
+    submodule_path.joinpath("testfile").write_text("this is a changed file")
+    submodule_path.joinpath("testfile2").write_text("this is an added file")
+    env.run("git", "add", ".", cwd=submodule_path)
+    _git_commit(env, submodule_path, message="submodule change")
+
+
+def _pull_in_submodule_changes_to_module(
+    env: PipTestEnvironment, module_path: Path, rel_path: str
+) -> None:
+    """
+    Args:
+      rel_path: the location of the submodule relative to the superproject.
+    """
+    submodule_path = module_path / rel_path
+    env.run("git", "pull", "-q", "origin", "master", cwd=submodule_path)
+    # Pass -a to stage the submodule changes that were just pulled in.
+    _git_commit(env, module_path, message="submodule change", stage_modified=True)
+
+
+def _create_test_package_with_submodule(
+    env: PipTestEnvironment, rel_path: str
+) -> TuplePath, Path:
+    """
+    Args:
+      rel_path: the location of the submodule relative to the superproject.
+    """
+    env.scratch_path.joinpath("version_pkg").mkdir()
+    version_pkg_path = env.scratch_path / "version_pkg"
+    version_pkg_path.joinpath("testpkg").mkdir()
+    pkg_path = version_pkg_path / "testpkg"
+
+    pkg_path.joinpath("__init__.py").write_text("# hello there")
+    _create_main_file(pkg_path, name="version_pkg", output="0.1")
+    version_pkg_path.joinpath("setup.py").write_text(
+        textwrap.dedent(
+            """\
+                        from setuptools import setup, find_packages
+                        setup(name='version_pkg',
+                              version='0.1',
+                              packages=find_packages(),
+                             )
+                        """
+        )
+    )
+    env.run("git", "init", cwd=version_pkg_path)
+    env.run("git", "add", ".", cwd=version_pkg_path)
+    _git_commit(env, version_pkg_path, message="initial version")
+
+    submodule_path = _create_test_package_submodule(env)
+
+    env.run(
+        "git",
+        "submodule",
+        "add",
+        os.fspath(submodule_path),
+        rel_path,
+        cwd=version_pkg_path,
+    )
+    _git_commit(env, version_pkg_path, message="initial version w submodule")
+
+    return version_pkg_path, submodule_path

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/index.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/local_repos.py Added

@@ -0,0 +1,63 @@
+import os
+import subprocess
+import urllib.request
+from pathlib import Path
+
+from pip._internal.utils.misc import hide_url
+from pip._internal.vcs import vcs
+
+
+def _create_svn_initools_repo(initools_dir: str) -> None:
+    """
+    Create the SVN INITools repo.
+    """
+    directory = os.path.dirname(initools_dir)
+    subprocess.check_call("svnadmin create INITools".split(), cwd=directory)
+
+    filename, _ = urllib.request.urlretrieve(
+        "http://bitbucket.org/hltbra/pip-initools-dump/raw/8b55c908a320/"
+        "INITools_modified.dump"
+    )
+    with open(filename) as dump:
+        subprocess.check_call(
+            "svnadmin", "load", initools_dir,
+            stdin=dump,
+            stdout=subprocess.DEVNULL,
+        )
+    os.remove(filename)
+
+
+def local_checkout(
+    remote_repo: str,
+    temp_path: Path,
+) -> str:
+    """
+    :param temp_path: the return value of the tmpdir fixture, which is a
+        temp directory Path object unique to each test function invocation,
+        created as a sub directory of the base temp directory.
+    """
+    assert "+" in remote_repo
+    vcs_name = remote_repo.split("+", 1)0
+    repository_name = os.path.basename(remote_repo)
+
+    directory = temp_path.joinpath("cache")
+    repo_url_path = os.path.join(directory, repository_name)
+    assert not os.path.exists(repo_url_path)
+
+    if not os.path.exists(directory):
+        os.mkdir(directory)
+
+    if vcs_name == "svn":
+        assert repository_name == "INITools"
+        _create_svn_initools_repo(repo_url_path)
+        repo_url_path = os.path.join(repo_url_path, "trunk")
+    else:
+        vcs_backend = vcs.get_backend(vcs_name)
+        assert vcs_backend is not None
+        vcs_backend.obtain(repo_url_path, url=hide_url(remote_repo), verbosity=0)
+
+    return "{}+{}".format(vcs_name, Path(repo_url_path).as_uri())
+
+
+def local_repo(remote_repo: str, temp_path: Path) -> str:
+    return local_checkout(remote_repo, temp_path).split("+", 1)1

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/options_helpers.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/requests_mocks.py Added

@@ -0,0 +1,59 @@
+"""Helper classes as mocks for requests objects.
+"""
+
+from io import BytesIO
+from typing import Any, Callable, Dict, Iterator, List, Optional
+
+_Hook = Callable"MockResponse", None
+
+
+class FakeStream:
+    def __init__(self, contents: bytes) -> None:
+        self._io = BytesIO(contents)
+
+    def read(self, size: int, decode_content: Optionalbool = None) -> bytes:
+        return self._io.read(size)
+
+    def stream(
+        self, size: int, decode_content: Optionalbool = None
+    ) -> Iteratorbytes:
+        yield self._io.read(size)
+
+    def release_conn(self) -> None:
+        pass
+
+
+class MockResponse:
+    request: "MockRequest"
+    connection: "MockConnection"
+    url: str
+
+    def __init__(self, contents: bytes) -> None:
+        self.raw = FakeStream(contents)
+        self.content = contents
+        self.reason = "OK"
+        self.status_code = 200
+        self.headers = {"Content-Length": str(len(contents))}
+        self.history: ListMockResponse = 
+        self.from_cache = False
+
+
+class MockConnection:
+    def _send(self, req: "MockRequest", **kwargs: Any) -> MockResponse:
+        raise NotImplementedError("_send must be overridden for tests")
+
+    def send(self, req: "MockRequest", **kwargs: Any) -> MockResponse:
+        resp = self._send(req, **kwargs)
+        for cb in req.hooks.get("response", ):
+            cb(resp)
+        return resp
+
+
+class MockRequest:
+    def __init__(self, url: str) -> None:
+        self.url = url
+        self.headers: Dictstr, str = {}
+        self.hooks: Dictstr, List_Hook = {}
+
+    def register_hook(self, event_name: str, callback: _Hook) -> None:
+        self.hooks.setdefault(event_name, ).append(callback)

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/server.py Added

@@ -0,0 +1,191 @@
+import pathlib
+import ssl
+import threading
+from base64 import b64encode
+from contextlib import contextmanager
+from textwrap import dedent
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, Iterator
+from unittest.mock import Mock
+
+from werkzeug.serving import BaseWSGIServer, WSGIRequestHandler
+from werkzeug.serving import make_server as _make_server
+
+from .compat import blocked_signals
+
+if TYPE_CHECKING:
+    from _typeshed.wsgi import StartResponse, WSGIApplication, WSGIEnvironment
+
+Body = Iterablebytes
+
+
+class MockServer(BaseWSGIServer):
+    mock: Mock = Mock()
+
+
+class _RequestHandler(WSGIRequestHandler):
+    def make_environ(self) -> Dictstr, Any:
+        environ = super().make_environ()
+
+        # From pallets/werkzeug#1469, will probably be in release after
+        # 0.16.0.
+        try:
+            # binary_form=False gives nicer information, but wouldn't be
+            # compatible with what Nginx or Apache could return.
+            peer_cert = self.connection.getpeercert(binary_form=True)
+            if peer_cert is not None:
+                # Nginx and Apache use PEM format.
+                environ"SSL_CLIENT_CERT" = ssl.DER_cert_to_PEM_cert(
+                    peer_cert,
+                )
+        except ValueError:
+            # SSL handshake hasn't finished.
+            self.server.log("error", "Cannot fetch SSL peer certificate info")
+        except AttributeError:
+            # Not using TLS, the socket will not have getpeercert().
+            pass
+
+        return environ
+
+
+def _mock_wsgi_adapter(
+    mock: Callable"WSGIEnvironment", "StartResponse", "WSGIApplication"
+) -> "WSGIApplication":
+    """Uses a mock to record function arguments and provide
+    the actual function that should respond.
+    """
+
+    def adapter(environ: "WSGIEnvironment", start_response: "StartResponse") -> Body:
+        try:
+            responder = mock(environ, start_response)
+        except StopIteration:
+            raise RuntimeError("Ran out of mocked responses.")
+        return responder(environ, start_response)
+
+    return adapter
+
+
+def make_mock_server(**kwargs: Any) -> MockServer:
+    """Creates a mock HTTP(S) server listening on a random port on localhost.
+
+    The `mock` property of the returned server provides and records all WSGI
+    interactions, so one approach to testing could be
+
+        server = make_mock_server()
+        server.mock.side_effects = 
+            page1,
+            page2,
+        
+
+        with server_running(server):
+            # ... use server...
+            ...
+
+        assert server.mock.call_count > 0
+        call_args_list = server.mock.call_args_list
+
+        # `environ` is a dictionary defined as per PEP 3333 with the associated
+        # contents. Additional properties may be added by werkzeug.
+        environ, _ = call_args_list0.args
+        assert environ"PATH_INFO".startswith("/hello/simple")
+
+    Note that the server interactions take place in a different thread, so you
+    do not want to touch the server.mock within the `server_running` block.
+
+    Note also for pip interactions that "localhost" is a "secure origin", so
+    be careful using this for failure tests of `--trusted-host`.
+    """
+    kwargs.setdefault("request_handler", _RequestHandler)
+
+    mock = Mock()
+    app = _mock_wsgi_adapter(mock)
+    server = _make_server("localhost", 0, app=app, **kwargs)
+    server.mock = mock
+    return server
+
+
+@contextmanager
+def server_running(server: BaseWSGIServer) -> IteratorNone:
+    """Context manager for running the provided server in a separate thread."""
+    thread = threading.Thread(target=server.serve_forever)
+    thread.daemon = True
+    with blocked_signals():
+        thread.start()
+    try:
+        yield
+    finally:
+        server.shutdown()
+        thread.join()
+
+
+# Helper functions for making responses in a declarative way.
+
+
+def text_html_response(text: str) -> "WSGIApplication":
+    def responder(environ: "WSGIEnvironment", start_response: "StartResponse") -> Body:
+        start_response(
+            "200 OK",
+            
+                ("Content-Type", "text/html; charset=UTF-8"),
+            ,
+        )
+        return text.encode("utf-8")
+
+    return responder
+
+
+def html5_page(text: str) -> str:
+    return (
+        dedent(
+            """
+    <!DOCTYPE html>
+    <html>
+      <body>
+        {}
+      </body>
+    </html>
+    """
+        )
+        .strip()
+        .format(text)
+    )
+
+
+def package_page(spec: Dictstr, str) -> "WSGIApplication":
+    def link(name: str, value: str) -> str:
+        return '<a href="{}">{}</a>'.format(value, name)
+
+    links = "".join(link(*kv) for kv in spec.items())
+    return text_html_response(html5_page(links))
+
+
+def file_response(path: pathlib.Path) -> "WSGIApplication":
+    def responder(environ: "WSGIEnvironment", start_response: "StartResponse") -> Body:
+        start_response(
+            "200 OK",
+            
+                ("Content-Type", "application/octet-stream"),
+                ("Content-Length", str(path.stat().st_size)),
+            ,
+        )
+        return path.read_bytes()
+
+    return responder
+
+
+def authorization_response(path: pathlib.Path) -> "WSGIApplication":
+    correct_auth = "Basic " + b64encode(b"USERNAME:PASSWORD").decode("ascii")
+
+    def responder(environ: "WSGIEnvironment", start_response: "StartResponse") -> Body:
+        if environ.get("HTTP_AUTHORIZATION") != correct_auth:
+            start_response("401 Unauthorized", ("WWW-Authenticate", "Basic"))
+            return ()
+        start_response(
+            "200 OK",
+            
+                ("Content-Type", "application/octet-stream"),
+                ("Content-Length", str(path.stat().st_size)),
+            ,
+        )
+        return path.read_bytes()
+
+    return responder

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/test_lib.py Added

@@ -0,0 +1,259 @@
+"""Test the test support."""
+import filecmp
+import pathlib
+import re
+import sys
+from contextlib import contextmanager
+from os.path import isdir, join
+from typing import Any, Dict, Iterator, Type
+
+import pytest
+
+from tests.lib import SRC_DIR, PipTestEnvironment
+
+
+@contextmanager
+def assert_error_startswith(
+    exc_type: TypeException, expected_start: str
+) -> IteratorNone:
+    """
+    Assert that an exception is raised starting with a certain message.
+    """
+    with pytest.raises(exc_type) as err:
+        yield
+
+    assert str(err.value).startswith(expected_start), f"full message: {err.value}"
+
+
+def test_tmp_dir_exists_in_env(script: PipTestEnvironment) -> None:
+    """
+    Test that $TMPDIR == env.temp_path and path exists and env.assert_no_temp()
+    passes (in fast env)
+    """
+    # need these tests to ensure the assert_no_temp feature of scripttest is
+    # working
+    script.assert_no_temp()  # this fails if env.tmp_path doesn't exist
+    assert pathlib.Path(script.environ"TMPDIR") == script.temp_path
+    assert isdir(script.temp_path)
+
+
+def test_correct_pip_version(script: PipTestEnvironment) -> None:
+    """
+    Check we are running proper version of pip in run_pip.
+    """
+
+    if script.zipapp:
+        pytest.skip("Test relies on the pip under test being in the filesystem")
+
+    # output is like:
+    # pip PIPVERSION from PIPDIRECTORY (python PYVERSION)
+    result = script.pip("--version")
+
+    # compare the directory tree of the invoked pip with that of this source
+    # distribution
+    match = re.match(
+        r"pip \d+(\.\d+)+(\.?(b|rc|dev|pre|post)\d+)? from (.*) "
+        r"$python \d+(\.\d+)+$$",
+        result.stdout,
+    )
+    assert match is not None
+    pip_folder_outputed = match.group(4)
+    pip_folder = join(SRC_DIR, "src", "pip")
+
+    diffs = filecmp.dircmp(pip_folder, pip_folder_outputed)
+
+    # If any non-matching .py files exist, we have a problem: run_pip
+    # is picking up some other version!  N.B. if this project acquires
+    # primary resources other than .py files, this code will need
+    # maintenance
+    mismatch_py = 
+        x
+        for x in diffs.left_only + diffs.right_only + diffs.diff_files
+        if x.endswith(".py")
+    
+    assert not mismatch_py, (
+        f"mismatched source files in {pip_folder!r} "
+        f"and {pip_folder_outputed!r}: {mismatch_py!r}"
+    )
+
+
+def test_as_import(script: PipTestEnvironment) -> None:
+    """test that pip.__init__.py does not shadow
+    the command submodule with a dictionary
+    """
+    import pip._internal.commands.install as inst
+
+    assert inst is not None
+
+
+class TestPipTestEnvironment:
+    def run_stderr_with_prefix(
+        self, script: PipTestEnvironment, prefix: str, **kwargs: Any
+    ) -> None:
+        """
+        Call run() that prints stderr with the given prefix.
+        """
+        text = f"{prefix}: hello, world\\n"
+        command = f'import sys; sys.stderr.write("{text}")'
+        args = sys.executable, "-c", command
+        script.run(*args, **kwargs)
+
+    def run_with_log_command(
+        self, script: PipTestEnvironment, sub_string: str, **kwargs: Any
+    ) -> None:
+        """
+        Call run() on a command that logs a "%"-style format string using
+        the given substring as the string's replacement field.
+        """
+        command = (
+            "import logging; logging.basicConfig(level='INFO'); "
+            "logging.getLogger().info('sub: {}', 'foo')"
+        ).format(sub_string)
+        args = sys.executable, "-c", command
+        script.run(*args, **kwargs)
+
+    @pytest.mark.parametrize(
+        "prefix",
+        (
+            "DEBUG",
+            "INFO",
+            "FOO",
+        ),
+    )
+    def test_run__allowed_stderr(self, script: PipTestEnvironment, prefix: str) -> None:
+        """
+        Test calling run() with allowed stderr.
+        """
+        # Check that no error happens.
+        self.run_stderr_with_prefix(script, prefix)
+
+    def test_run__allow_stderr_warning(self, script: PipTestEnvironment) -> None:
+        """
+        Test passing allow_stderr_warning=True.
+        """
+        # Check that no error happens.
+        self.run_stderr_with_prefix(
+            script,
+            "WARNING",
+            allow_stderr_warning=True,
+        )
+
+        # Check that an error still happens with ERROR.
+        expected_start = "stderr has an unexpected error"
+        with assert_error_startswith(RuntimeError, expected_start):
+            self.run_stderr_with_prefix(
+                script,
+                "ERROR",
+                allow_stderr_warning=True,
+            )
+
+    @pytest.mark.parametrize(
+        "prefix",
+        (
+            "WARNING",
+            "ERROR",
+        ),
+    )
+    def test_run__allow_stderr_error(
+        self, script: PipTestEnvironment, prefix: str
+    ) -> None:
+        """
+        Test passing allow_stderr_error=True.
+        """
+        # Check that no error happens.
+        self.run_stderr_with_prefix(script, prefix, allow_stderr_error=True)
+
+    @pytest.mark.parametrize(
+        "prefix, expected_start",
+        (
+            ("WARNING", "stderr has an unexpected warning"),
+            ("ERROR", "stderr has an unexpected error"),
+        ),
+    )
+    def test_run__unexpected_stderr(
+        self, script: PipTestEnvironment, prefix: str, expected_start: str
+    ) -> None:
+        """
+        Test calling run() with unexpected stderr output.
+        """
+        with assert_error_startswith(RuntimeError, expected_start):
+            self.run_stderr_with_prefix(script, prefix)
+
+    def test_run__logging_error(self, script: PipTestEnvironment) -> None:
+        """
+        Test calling run() with an unexpected logging error.
+        """
+        # Pass a good substitution string.
+        self.run_with_log_command(script, sub_string="%r")
+
+        expected_start = "stderr has a logging error, which is never allowed"
+        with assert_error_startswith(RuntimeError, expected_start):
+            # Pass a bad substitution string.  Also, pass
+            # allow_stderr_error=True to check that the RuntimeError occurs
+            # even under the stricter test condition of when we are allowing
+            # other types of errors.
+            self.run_with_log_command(
+                script,
+                sub_string="{!r}",
+                allow_stderr_error=True,
+            )
+
+    def test_run__allow_stderr_error_false_error_with_expect_error(
+        self, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test passing allow_stderr_error=False with expect_error=True.
+        """
+        expected_start = "cannot pass allow_stderr_error=False with expect_error=True"
+        with assert_error_startswith(RuntimeError, expected_start):
+            script.run("python", allow_stderr_error=False, expect_error=True)
+
+    def test_run__allow_stderr_warning_false_error_with_expect_stderr(
+        self, script: PipTestEnvironment
+    ) -> None:
+        """
+        Test passing allow_stderr_warning=False with expect_stderr=True.
+        """
+        expected_start = (
+            "cannot pass allow_stderr_warning=False with expect_stderr=True"
+        )
+        with assert_error_startswith(RuntimeError, expected_start):
+            script.run(
+                "python",
+                allow_stderr_warning=False,
+                expect_stderr=True,
+            )
+
+    @pytest.mark.parametrize(
+        "arg_name",
+        (
+            "expect_error",
+            "allow_stderr_error",
+        ),
+    )
+    def test_run__allow_stderr_warning_false_error(
+        self, script: PipTestEnvironment, arg_name: str
+    ) -> None:
+        """
+        Test passing allow_stderr_warning=False when it is not allowed.
+        """
+        kwargs: Dictstr, Any = {"allow_stderr_warning": False, arg_name: True}
+        expected_start = (
+            "cannot pass allow_stderr_warning=False with allow_stderr_error=True"
+        )
+        with assert_error_startswith(RuntimeError, expected_start):
+            script.run("python", **kwargs)
+
+    def test_run__expect_error_fails_when_zero_returncode(
+        self, script: PipTestEnvironment
+    ) -> None:
+        expected_start = "Script passed unexpectedly"
+        with assert_error_startswith(AssertionError, expected_start):
+            script.run("python", expect_error=True)
+
+    def test_run__no_expect_error_fails_when_nonzero_returncode(
+        self, script: PipTestEnvironment
+    ) -> None:
+        expected_start = "Script returned code: 1"
+        with assert_error_startswith(AssertionError, expected_start):
+            script.run("python", "-c", "import sys; sys.exit(1)")

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/test_wheel.py Added

@@ -0,0 +1,249 @@
+"""Tests for wheel helper.
+"""
+import csv
+from email import message_from_string
+from email.message import Message
+from functools import partial
+from pathlib import Path
+from zipfile import ZipFile
+
+from tests.lib.wheel import (
+    File,
+    _default,
+    make_metadata_file,
+    make_wheel,
+    make_wheel_metadata_file,
+    message_from_dict,
+)
+
+
+def test_message_from_dict_one_value() -> None:
+    message = message_from_dict({"a": "1"})
+    assert set(message.get_all("a")) == {"1"}
+
+
+def test_message_from_dict_multiple_values() -> None:
+    message = message_from_dict({"a": "1", "2"})
+    assert set(message.get_all("a")) == {"1", "2"}
+
+
+def message_from_bytes(contents: bytes) -> Message:
+    return message_from_string(contents.decode("utf-8"))
+
+
+default_make_metadata = partial(
+    make_metadata_file,
+    name="simple",
+    value=_default,
+    version="0.1.0",
+    updates=_default,
+    body=_default,
+)
+
+
+def default_metadata_checks(f: File) -> Message:
+    assert f.name == "simple-0.1.0.dist-info/METADATA"
+    message = message_from_bytes(f.contents)
+    assert message.get_all("Metadata-Version") == "2.1"
+    assert message.get_all("Name") == "simple"
+    assert message.get_all("Version") == "0.1.0"
+    return message
+
+
+def test_make_metadata_file_defaults() -> None:
+    f = default_make_metadata()
+    assert f is not None
+    default_metadata_checks(f)
+
+
+def test_make_metadata_file_custom_value() -> None:
+    f = default_make_metadata(updates={"a": "1"})
+    assert f is not None
+    message = default_metadata_checks(f)
+    assert message.get_all("a") == "1"
+
+
+def test_make_metadata_file_custom_value_list() -> None:
+    f = default_make_metadata(updates={"a": "1", "2"})
+    assert f is not None
+    message = default_metadata_checks(f)
+    assert set(message.get_all("a")) == {"1", "2"}
+
+
+def test_make_metadata_file_custom_value_overrides() -> None:
+    f = default_make_metadata(updates={"Metadata-Version": "2.2"})
+    assert f is not None
+    message = message_from_bytes(f.contents)
+    assert message.get_all("Metadata-Version") == "2.2"
+
+
+def test_make_metadata_file_custom_contents() -> None:
+    value = b"hello"
+    f = default_make_metadata(value=value)
+    assert f is not None
+    assert f.contents == value
+
+
+tags = ("py2", "none", "any"), ("py3", "none", "any")
+default_make_wheel_metadata = partial(
+    make_wheel_metadata_file,
+    name="simple",
+    version="0.1.0",
+    value=_default,
+    tags=tags,
+    updates=_default,
+)
+
+
+def default_wheel_metadata_checks(f: File) -> Message:
+    assert f.name == "simple-0.1.0.dist-info/WHEEL"
+    message = message_from_bytes(f.contents)
+    assert message.get_all("Wheel-Version") == "1.0"
+    assert message.get_all("Generator") == "pip-test-suite"
+    assert message.get_all("Root-Is-Purelib") == "true"
+    assert set(message.get_all("Tag")) == {"py2-none-any", "py3-none-any"}
+    return message
+
+
+def test_make_wheel_metadata_file_defaults() -> None:
+    f = default_make_wheel_metadata()
+    assert f is not None
+    default_wheel_metadata_checks(f)
+
+
+def test_make_wheel_metadata_file_custom_value() -> None:
+    f = default_make_wheel_metadata(updates={"a": "1"})
+    assert f is not None
+    message = default_wheel_metadata_checks(f)
+    assert message.get_all("a") == "1"
+
+
+def test_make_wheel_metadata_file_custom_value_list() -> None:
+    f = default_make_wheel_metadata(updates={"a": "1", "2"})
+    assert f is not None
+    message = default_wheel_metadata_checks(f)
+    assert set(message.get_all("a")) == {"1", "2"}
+
+
+def test_make_wheel_metadata_file_custom_value_override() -> None:
+    f = default_make_wheel_metadata(updates={"Wheel-Version": "1.1"})
+    assert f is not None
+    message = message_from_bytes(f.contents)
+    assert message.get_all("Wheel-Version") == "1.1"
+
+
+def test_make_wheel_metadata_file_custom_contents() -> None:
+    value = b"hello"
+    f = default_make_wheel_metadata(value=value)
+    assert f is not None
+    assert f.name == "simple-0.1.0.dist-info/WHEEL"
+    assert f.contents == value
+
+
+def test_make_wheel_metadata_file_no_contents() -> None:
+    f = default_make_wheel_metadata(value=None)
+    assert f is None
+
+
+def test_make_wheel_basics(tmpdir: Path) -> None:
+    make_wheel(name="simple", version="0.1.0").save_to_dir(tmpdir)
+
+    expected_wheel_path = tmpdir / "simple-0.1.0-py2.py3-none-any.whl"
+    assert expected_wheel_path.exists()
+
+    with ZipFile(expected_wheel_path) as z:
+        names = z.namelist()
+        assert set(names) == {
+            "simple-0.1.0.dist-info/METADATA",
+            "simple-0.1.0.dist-info/RECORD",
+            "simple-0.1.0.dist-info/WHEEL",
+        }
+
+
+def test_make_wheel_default_record() -> None:
+    with make_wheel(
+        name="simple",
+        version="0.1.0",
+        extra_files={"simple/__init__.py": "a"},
+        extra_metadata_files={"LICENSE": "b"},
+        extra_data_files={"purelib/info.txt": "c"},
+    ).as_zipfile() as z:
+        record_bytes = z.read("simple-0.1.0.dist-info/RECORD")
+        record_text = record_bytes.decode()
+        record_rows = list(csv.reader(record_text.splitlines()))
+        records = {row0: row1: for row in record_rows}
+
+        expected = {
+            "simple/__init__.py": 
+                "sha256=ypeBEsobvcr6wjGzmiPcTaeG7_gUfE5yuYB3ha_uSLs",
+                "1",
+            ,
+            "simple-0.1.0.data/purelib/info.txt": 
+                "sha256=Ln0sA6lQeuJl7PW1NWiFpTOTogKdJBOUmXJloaJa78Y",
+                "1",
+            ,
+            "simple-0.1.0.dist-info/LICENSE": 
+                "sha256=PiPoFgA5WUoziU9lZOGxNIu9egCI1CxKy3PurtWcAJ0",
+                "1",
+            ,
+            "simple-0.1.0.dist-info/RECORD": "", "",
+        }
+        for name, values in expected.items():
+            assert recordsname == values, name
+
+        # WHEEL and METADATA aren't constructed in a stable way, so just spot
+        # check.
+        expected_variable = {
+            "simple-0.1.0.dist-info/METADATA": "51",
+            "simple-0.1.0.dist-info/WHEEL": "104",
+        }
+        for name, length in expected_variable.items():
+            assert recordsname0.startswith("sha256="), name
+            assert recordsname1 == length, name
+
+
+def test_make_wheel_extra_files() -> None:
+    with make_wheel(
+        name="simple",
+        version="0.1.0",
+        extra_files={"simple/__init__.py": "a"},
+        extra_metadata_files={"LICENSE": "b"},
+        extra_data_files={"info.txt": "c"},
+    ).as_zipfile() as z:
+        names = z.namelist()
+        assert set(names) == {
+            "simple/__init__.py",
+            "simple-0.1.0.data/info.txt",
+            "simple-0.1.0.dist-info/LICENSE",
+            "simple-0.1.0.dist-info/METADATA",
+            "simple-0.1.0.dist-info/RECORD",
+            "simple-0.1.0.dist-info/WHEEL",
+        }
+
+        assert z.read("simple/__init__.py") == b"a"
+        assert z.read("simple-0.1.0.dist-info/LICENSE") == b"b"
+        assert z.read("simple-0.1.0.data/info.txt") == b"c"
+
+
+def test_make_wheel_no_files() -> None:
+    with make_wheel(
+        name="simple",
+        version="0.1.0",
+        wheel_metadata=None,
+        metadata=None,
+        record=None,
+    ).as_zipfile() as z:
+        assert not z.namelist()
+
+
+def test_make_wheel_custom_files() -> None:
+    with make_wheel(
+        name="simple",
+        version="0.1.0",
+        wheel_metadata=b"a",
+        metadata=b"b",
+        record=b"c",
+    ).as_zipfile() as z:
+        assert z.read("simple-0.1.0.dist-info/WHEEL") == b"a"
+        assert z.read("simple-0.1.0.dist-info/METADATA") == b"b"
+        assert z.read("simple-0.1.0.dist-info/RECORD") == b"c"

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/venv.py Added

@@ -0,0 +1,254 @@
+import compileall
+import os
+import shutil
+import subprocess
+import sys
+import sysconfig
+import textwrap
+import venv as _venv
+from pathlib import Path
+from typing import TYPE_CHECKING, Dict, Optional, Union
+
+import virtualenv as _virtualenv
+
+if TYPE_CHECKING:
+    # Literal was introduced in Python 3.8.
+    from typing import Literal
+
+    VirtualEnvironmentType = Literal"virtualenv", "venv"
+else:
+    VirtualEnvironmentType = str
+
+
+class VirtualEnvironment:
+    """
+    An abstraction around virtual environments, currently it only uses
+    virtualenv but in the future it could use pyvenv.
+    """
+
+    def __init__(
+        self,
+        location: Path,
+        template: Optional"VirtualEnvironment" = None,
+        venv_type: OptionalVirtualEnvironmentType = None,
+    ) -> None:
+        self.location = location
+        assert template is None or venv_type is None
+        self._venv_type: VirtualEnvironmentType
+        if template is not None:
+            self._venv_type = template._venv_type
+        elif venv_type is not None:
+            self._venv_type = venv_type
+        else:
+            self._venv_type = "virtualenv"
+        self._user_site_packages = False
+        self._template = template
+        self._sitecustomize: Optionalstr = None
+        self._update_paths()
+        self._create()
+
+    @property
+    def _legacy_virtualenv(self) -> bool:
+        if self._venv_type != "virtualenv":
+            return False
+        return int(_virtualenv.__version__.split(".", 1)0) < 20
+
+    def __update_paths_legacy(self) -> None:
+        home, lib, inc, bin = _virtualenv.path_locations(self.location)
+        self.bin = Path(bin)
+        self.site = Path(lib) / "site-packages"
+        # Workaround for https://github.com/pypa/virtualenv/issues/306
+        if hasattr(sys, "pypy_version_info"):
+            version_dir = str(sys.version_info.major)
+            self.lib = Path(home, "lib-python", version_dir)
+        else:
+            self.lib = Path(lib)
+
+    def _update_paths(self) -> None:
+        if self._legacy_virtualenv:
+            self.__update_paths_legacy()
+            return
+        bases = {
+            "installed_base": self.location,
+            "installed_platbase": self.location,
+            "base": self.location,
+            "platbase": self.location,
+        }
+        paths = sysconfig.get_paths(vars=bases)
+        self.bin = Path(paths"scripts")
+        self.site = Path(paths"purelib")
+        self.lib = Path(paths"stdlib")
+
+    def __repr__(self) -> str:
+        return f"<VirtualEnvironment {self.location}>"
+
+    def _create(self, clear: bool = False) -> None:
+        if clear:
+            shutil.rmtree(self.location)
+        if self._template:
+            # On Windows, calling `_virtualenv.path_locations(target)`
+            # will have created the `target` directory...
+            if (
+                self._legacy_virtualenv
+                and sys.platform == "win32"
+                and self.location.exists()
+            ):
+                self.location.rmdir()
+            # Clone virtual environment from template.
+            shutil.copytree(self._template.location, self.location, symlinks=True)
+            self._sitecustomize = self._template.sitecustomize
+            self._user_site_packages = self._template.user_site_packages
+        else:
+            # Create a new virtual environment.
+            if self._legacy_virtualenv:
+                subprocess.check_call(
+                    
+                        sys.executable,
+                        "-m",
+                        "virtualenv",
+                        "--no-pip",
+                        "--no-wheel",
+                        "--no-setuptools",
+                        os.fspath(self.location),
+                    
+                )
+                self._fix_legacy_virtualenv_site_module()
+            elif self._venv_type == "virtualenv":
+                _virtualenv.cli_run(
+                    
+                        "--no-pip",
+                        "--no-wheel",
+                        "--no-setuptools",
+                        os.fspath(self.location),
+                    ,
+                )
+            elif self._venv_type == "venv":
+                builder = _venv.EnvBuilder()
+                context = builder.ensure_directories(self.location)
+                builder.create_configuration(context)
+                builder.setup_python(context)
+                self.site.mkdir(parents=True, exist_ok=True)
+            else:
+                raise RuntimeError(f"Unsupported venv type {self._venv_type!r}")
+            self.sitecustomize = self._sitecustomize
+            self.user_site_packages = self._user_site_packages
+
+    def _fix_legacy_virtualenv_site_module(self) -> None:
+        # Patch `site.py` so user site work as expected.
+        site_py = self.lib / "site.py"
+        with open(site_py) as fp:
+            site_contents = fp.read()
+        for pattern, replace in (
+            (
+                # Ensure enabling user site does not result in adding
+                # the real site-packages' directory to `sys.path`.
+                ("\ndef virtual_addsitepackages(known_paths):\n"),
+                (
+                    "\ndef virtual_addsitepackages(known_paths):\n"
+                    "    return known_paths\n"
+                ),
+            ),
+            (
+                # Fix sites ordering: user site must be added before system.
+                (
+                    "\n    paths_in_sys = addsitepackages(paths_in_sys)"
+                    "\n    paths_in_sys = addusersitepackages(paths_in_sys)\n"
+                ),
+                (
+                    "\n    paths_in_sys = addusersitepackages(paths_in_sys)"
+                    "\n    paths_in_sys = addsitepackages(paths_in_sys)\n"
+                ),
+            ),
+        ):
+            assert pattern in site_contents
+            site_contents = site_contents.replace(pattern, replace)
+        with open(site_py, "w") as fp:
+            fp.write(site_contents)
+        # Make sure bytecode is up-to-date too.
+        assert compileall.compile_file(str(site_py), quiet=1, force=True)
+
+    def _customize_site(self) -> None:
+        if self._legacy_virtualenv:
+            contents = ""
+        else:
+            # Enable user site (before system).
+            contents = textwrap.dedent(
+                f"""
+                import os, site, sys
+                if not os.environ.get('PYTHONNOUSERSITE', False):
+                    site.ENABLE_USER_SITE = {self._user_site_packages}
+                    # First, drop system-sites related paths.
+                    original_sys_path = sys.path:
+                    known_paths = set()
+                    for path in site.getsitepackages():
+                        site.addsitedir(path, known_paths=known_paths)
+                    system_paths = sys.pathlen(original_sys_path):
+                    for path in system_paths:
+                        if path in original_sys_path:
+                            original_sys_path.remove(path)
+                    sys.path = original_sys_path
+                    # Second, add user-site.
+                    if {self._user_site_packages}:
+                        site.addsitedir(site.getusersitepackages())
+                    # Third, add back system-sites related paths.
+                    for path in site.getsitepackages():
+                        site.addsitedir(path)
+                """
+            ).strip()
+        if self._sitecustomize is not None:
+            contents += "\n" + self._sitecustomize
+        sitecustomize = self.site / "sitecustomize.py"
+        sitecustomize.write_text(contents)
+        # Make sure bytecode is up-to-date too.
+        assert compileall.compile_file(str(sitecustomize), quiet=1, force=True)
+
+    def _rewrite_pyvenv_cfg(self, replacements: Dictstr, str) -> None:
+        pyvenv_cfg = self.location.joinpath("pyvenv.cfg")
+        lines = pyvenv_cfg.read_text(encoding="utf-8").splitlines()
+
+        def maybe_replace_line(line: str) -> str:
+            key = line.split("=", 1)0.strip()
+            try:
+                value = replacementskey
+            except KeyError:  # No need to replace.
+                return line
+            return f"{key} = {value}"
+
+        lines = maybe_replace_line(line) for line in lines
+        pyvenv_cfg.write_text("\n".join(lines), encoding="utf-8")
+
+    def clear(self) -> None:
+        self._create(clear=True)
+
+    def move(self, location: UnionPath, str) -> None:
+        shutil.move(os.fspath(self.location), location)
+        self.location = Path(location)
+        self._update_paths()
+
+    @property
+    def sitecustomize(self) -> Optionalstr:
+        return self._sitecustomize
+
+    @sitecustomize.setter
+    def sitecustomize(self, value: str) -> None:
+        self._sitecustomize = value
+        self._customize_site()
+
+    @property
+    def user_site_packages(self) -> bool:
+        return self._user_site_packages
+
+    @user_site_packages.setter
+    def user_site_packages(self, value: bool) -> None:
+        self._user_site_packages = value
+        if self._legacy_virtualenv:
+            marker = self.lib / "no-global-site-packages.txt"
+            if self._user_site_packages:
+                marker.unlink()
+            else:
+                marker.touch()
+        else:
+            self._rewrite_pyvenv_cfg(
+                {"include-system-site-packages": str(bool(value)).lower()}
+            )
+            self._customize_site()

_service:tar_scm:pip-23.1.2.tar.gz/tests/lib/wheel.py Added

@@ -0,0 +1,394 @@
+"""Helper for building wheels as would be in test cases.
+"""
+import csv
+import itertools
+from base64 import urlsafe_b64encode
+from collections import namedtuple
+from copy import deepcopy
+from email.message import Message
+from enum import Enum
+from functools import partial
+from hashlib import sha256
+from io import BytesIO, StringIO
+from pathlib import Path
+from typing import (
+    AnyStr,
+    Dict,
+    Iterable,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+)
+from zipfile import ZipFile
+
+from pip._vendor.requests.structures import CaseInsensitiveDict
+
+from pip._internal.metadata import BaseDistribution, MemoryWheel, get_wheel_distribution
+
+# As would be used in metadata
+HeaderValue = Unionstr, Liststr
+
+
+File = namedtuple("File", "name", "contents")
+Record = namedtuple("Record", "path", "digest", "size")
+
+
+class Default(Enum):
+    token = 0
+
+
+_default = Default.token
+
+T = TypeVar("T")
+
+# A type which may be defaulted.
+Defaulted = UnionDefault, T
+
+
+def ensure_binary(value: Unionbytes, str) -> bytes:
+    if isinstance(value, bytes):
+        return value
+    return value.encode()
+
+
+def message_from_dict(headers: Dictstr, HeaderValue) -> Message:
+    """Plain key-value pairs are set in the returned message.
+
+    List values are converted into repeated headers in the result.
+    """
+    message = Message()
+    for name, value in headers.items():
+        if isinstance(value, list):
+            for v in value:
+                messagename = v
+        else:
+            messagename = value
+    return message
+
+
+def dist_info_path(name: str, version: str, path: str) -> str:
+    return f"{name}-{version}.dist-info/{path}"
+
+
+def make_metadata_file(
+    name: str,
+    version: str,
+    value: DefaultedOptionalAnyStr,
+    updates: DefaultedDictstr, HeaderValue,
+    body: DefaultedAnyStr,
+) -> OptionalFile:
+    if value is None:
+        return None
+
+    path = dist_info_path(name, version, "METADATA")
+
+    if value is not _default:
+        return File(path, ensure_binary(value))
+
+    metadata = CaseInsensitiveDict(
+        {
+            "Metadata-Version": "2.1",
+            "Name": name,
+            "Version": version,
+        }
+    )
+    if updates is not _default:
+        metadata.update(updates)
+
+    message = message_from_dict(metadata)
+    if body is not _default:
+        message.set_payload(body)
+
+    return File(path, message_from_dict(metadata).as_bytes())
+
+
+def make_wheel_metadata_file(
+    name: str,
+    version: str,
+    value: DefaultedOptionalAnyStr,
+    tags: SequenceTuplestr, str, str,
+    updates: DefaultedDictstr, HeaderValue,
+) -> OptionalFile:
+    if value is None:
+        return None
+
+    path = dist_info_path(name, version, "WHEEL")
+
+    if value is not _default:
+        return File(path, ensure_binary(value))
+
+    metadata = CaseInsensitiveDict(
+        {
+            "Wheel-Version": "1.0",
+            "Generator": "pip-test-suite",
+            "Root-Is-Purelib": "true",
+            "Tag": "-".join(parts) for parts in tags,
+        }
+    )
+
+    if updates is not _default:
+        metadata.update(updates)
+
+    return File(path, message_from_dict(metadata).as_bytes())
+
+
+def make_entry_points_file(
+    name: str,
+    version: str,
+    entry_points: DefaultedDictstr, Liststr,
+    console_scripts: DefaultedListstr,
+) -> OptionalFile:
+    if entry_points is _default and console_scripts is _default:
+        return None
+
+    if entry_points is _default:
+        entry_points_data = {}
+    else:
+        entry_points_data = deepcopy(entry_points)
+
+    if console_scripts is not _default:
+        entry_points_data"console_scripts" = console_scripts
+
+    lines = 
+    for section, values in entry_points_data.items():
+        lines.append(f"{section}")
+        lines.extend(values)
+
+    return File(
+        dist_info_path(name, version, "entry_points.txt"),
+        "\n".join(lines).encode(),
+    )
+
+
+def make_files(files: Dictstr, Unionbytes, str) -> ListFile:
+    return File(name, ensure_binary(contents)) for name, contents in files.items()
+
+
+def make_metadata_files(
+    name: str, version: str, files: Dictstr, AnyStr
+) -> ListFile:
+    get_path = partial(dist_info_path, name, version)
+    return 
+        File(get_path(name), ensure_binary(contents))
+        for name, contents in files.items()
+    
+
+
+def make_data_files(name: str, version: str, files: Dictstr, AnyStr) -> ListFile:
+    data_dir = f"{name}-{version}.data"
+    return 
+        File(f"{data_dir}/{name}", ensure_binary(contents))
+        for name, contents in files.items()
+    
+
+
+def urlsafe_b64encode_nopad(data: bytes) -> str:
+    return urlsafe_b64encode(data).rstrip(b"=").decode("ascii")
+
+
+def digest(contents: bytes) -> str:
+    return "sha256={}".format(urlsafe_b64encode_nopad(sha256(contents).digest()))
+
+
+def record_file_maker_wrapper(
+    name: str,
+    version: str,
+    files: IterableFile,
+    record: DefaultedOptionalAnyStr,
+) -> IterableFile:
+    records: ListRecord = 
+    for file in files:
+        records.append(
+            Record(file.name, digest(file.contents), str(len(file.contents)))
+        )
+        yield file
+
+    if record is None:
+        return
+
+    record_path = dist_info_path(name, version, "RECORD")
+
+    if record is not _default:
+        yield File(record_path, ensure_binary(record))
+        return
+
+    records.append(Record(record_path, "", ""))
+
+    with StringIO(newline="") as buf:
+        writer = csv.writer(buf)
+        for r in records:
+            writer.writerow(r)
+        contents = buf.getvalue().encode("utf-8")
+
+    yield File(record_path, contents)
+
+
+def wheel_name(
+    name: str,
+    version: str,
+    pythons: Iterablestr,
+    abis: Iterablestr,
+    platforms: Iterablestr,
+) -> str:
+    stem = "-".join(
+        
+            name,
+            version,
+            ".".join(pythons),
+            ".".join(abis),
+            ".".join(platforms),
+        
+    )
+    return f"{stem}.whl"
+
+
+class WheelBuilder:
+    """A wheel that can be saved or converted to several formats."""
+
+    def __init__(self, name: str, files: IterableFile) -> None:
+        self._name = name
+        self._files = files
+
+    def save_to_dir(self, path: UnionPath, str) -> str:
+        """Generate wheel file with correct name and save into the provided
+        directory.
+
+        :returns the wheel file path
+        """
+        p = Path(path) / self._name
+        p.write_bytes(self.as_bytes())
+        return str(p)
+
+    def save_to(self, path: UnionPath, str) -> str:
+        """Generate wheel file, saving to the provided path. Any parent
+        directories must already exist.
+
+        :returns the wheel file path
+        """
+        path = Path(path)
+        path.write_bytes(self.as_bytes())
+        return str(path)
+
+    def as_bytes(self) -> bytes:
+        with BytesIO() as buf:
+            with ZipFile(buf, "w") as z:
+                for file in self._files:
+                    z.writestr(file.name, file.contents)
+            return buf.getvalue()
+
+    def as_zipfile(self) -> ZipFile:
+        return ZipFile(BytesIO(self.as_bytes()))
+
+    def as_distribution(self, name: str) -> BaseDistribution:
+        stream = BytesIO(self.as_bytes())
+        return get_wheel_distribution(MemoryWheel(self._name, stream), name)
+
+
+def make_wheel(
+    name: str,
+    version: str,
+    wheel_metadata: DefaultedOptionalAnyStr = _default,
+    wheel_metadata_updates: DefaultedDictstr, HeaderValue = _default,
+    metadata: DefaultedOptionalAnyStr = _default,
+    metadata_body: DefaultedAnyStr = _default,
+    metadata_updates: DefaultedDictstr, HeaderValue = _default,
+    extra_files: DefaultedDictstr, Unionbytes, str = _default,
+    extra_metadata_files: DefaultedDictstr, AnyStr = _default,
+    extra_data_files: DefaultedDictstr, AnyStr = _default,
+    console_scripts: DefaultedListstr = _default,
+    entry_points: DefaultedDictstr, Liststr = _default,
+    record: DefaultedOptionalAnyStr = _default,
+) -> WheelBuilder:
+    """
+    Helper function for generating test wheels which are compliant by default.
+
+    Examples:
+
+    ```
+    # Basic wheel, which will have valid metadata, RECORD, etc
+    make_wheel(name="foo", version="0.1.0")
+    # Wheel with custom metadata
+    make_wheel(
+        name="foo",
+        version="0.1.0",
+        metadata_updates={
+            # Overrides default
+            "Name": "hello",
+            # Expands into separate Requires-Dist entries
+            "Requires-Dist": "a == 1.0", "b == 2.0; sys_platform == 'win32'",
+        },
+    )
+    ```
+
+    After specifying the wheel, it can be consumed in several ways:
+
+    ```
+    # Normal case, valid wheel we want pip to pick up.
+    make_wheel(...).save_to_dir(tmpdir)
+    # For a test case, to check that pip validates contents against wheel name.
+    make_wheel(name="simple", ...).save_to(tmpdir / "notsimple-...")
+    # In-memory, for unit tests.
+    z = make_wheel(...).as_zipfile()
+    ```
+
+    Below, any unicode value provided for AnyStr will be encoded as utf-8.
+
+    :param name: name of the distribution, propagated to the .dist-info
+        directory, METADATA, and wheel file name
+    :param version: version of the distribution, propagated to the .dist-info
+        directory, METADATA, and wheel file name
+    :param wheel_metadata: if provided and None, then no WHEEL metadata file
+        is generated; else if a string then sets the content of the WHEEL file
+    :param wheel_metadata_updates: override the default WHEEL metadata fields,
+        ignored if wheel_metadata is provided
+    :param metadata: if provided and None, then no METADATA file is generated;
+        else if a string then sets the content of the METADATA file
+    :param metadata_body: sets the value of the body text in METADATA, ignored
+        if metadata is provided
+    :param metadata_updates: override the default METADATA fields,
+        ignored if metadata is provided
+    :param extra_files: map from path to file contents for additional files to
+        be put in the wheel
+    :param extra_metadata_files: map from path (relative to .dist-info) to file
+        contents for additional files to be put in the wheel
+    :param extra_data_files: map from path (relative to .data) to file contents
+        for additional files to be put in the wheel
+    :param console_scripts: list of console scripts text to be put into
+        entry_points.txt - overrides any value set in entry_points
+    :param entry_points:
+    :param record: if provided and None, then no RECORD file is generated;
+        else if a string then sets the content of the RECORD file
+    """
+    pythons = "py2", "py3"
+    abis = "none"
+    platforms = "any"
+    tags = list(itertools.product(pythons, abis, platforms))
+
+    possible_files = 
+        make_metadata_file(name, version, metadata, metadata_updates, metadata_body),
+        make_wheel_metadata_file(
+            name, version, wheel_metadata, tags, wheel_metadata_updates
+        ),
+        make_entry_points_file(name, version, entry_points, console_scripts),
+    
+
+    if extra_files is not _default:
+        possible_files.extend(make_files(extra_files))
+
+    if extra_metadata_files is not _default:
+        possible_files.extend(make_metadata_files(name, version, extra_metadata_files))
+
+    if extra_data_files is not _default:
+        possible_files.extend(make_data_files(name, version, extra_data_files))
+
+    actual_files = filter(None, possible_files)
+
+    files_and_record_file = record_file_maker_wrapper(
+        name, version, actual_files, record
+    )
+    wheel_file_name = wheel_name(name, version, pythons, abis, platforms)
+
+    return WheelBuilder(wheel_file_name, files_and_record_file)

_service:tar_scm:pip-23.1.2.tar.gz/tests/requirements-common_wheels.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/requirements.txt Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/metadata Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/metadata/test_metadata.py Added

@@ -0,0 +1,131 @@
+import logging
+import os
+from pathlib import Path
+from typing import cast
+from unittest import mock
+
+import pytest
+from pip._vendor.packaging.utils import NormalizedName
+
+from pip._internal.metadata import (
+    BaseDistribution,
+    get_directory_distribution,
+    get_environment,
+    get_wheel_distribution,
+)
+from pip._internal.metadata.base import FilesystemWheel
+from pip._internal.models.direct_url import DIRECT_URL_METADATA_NAME, ArchiveInfo
+from tests.lib.wheel import make_wheel
+
+
+@mock.patch.object(BaseDistribution, "read_text", side_effect=FileNotFoundError)
+def test_dist_get_direct_url_no_metadata(mock_read_text: mock.Mock) -> None:
+    class FakeDistribution(BaseDistribution):
+        pass
+
+    dist = FakeDistribution()
+    assert dist.direct_url is None
+    mock_read_text.assert_called_once_with(DIRECT_URL_METADATA_NAME)
+
+
+@mock.patch.object(BaseDistribution, "read_text", return_value="{}")
+def test_dist_get_direct_url_invalid_json(
+    mock_read_text: mock.Mock, caplog: pytest.LogCaptureFixture
+) -> None:
+    class FakeDistribution(BaseDistribution):
+        canonical_name = cast(NormalizedName, "whatever")  # Needed for error logging.
+
+    dist = FakeDistribution()
+    with caplog.at_level(logging.WARNING):
+        assert dist.direct_url is None
+
+    mock_read_text.assert_called_once_with(DIRECT_URL_METADATA_NAME)
+    assert (
+        caplog.records-1
+        .getMessage()
+        .startswith(
+            "Error parsing direct_url.json for whatever:",
+        )
+    )
+
+
+def test_metadata_reads_egg_info_requires_txt(tmp_path: Path) -> None:
+    """Check Requires-Dist is obtained from requires.txt if absent in PKG-INFO."""
+    egg_info_path = tmp_path / "whatever.egg-info"
+    egg_info_path.mkdir()
+    dist = get_directory_distribution(str(egg_info_path))
+    assert dist.installed_with_setuptools_egg_info
+    pkg_info_path = egg_info_path / "PKG-INFO"
+    pkg_info_path.write_text("Name: whatever\n")
+    egg_info_path.joinpath("requires.txt").write_text("pkga\npkgb\n")
+    assert dist.metadata.get_all("Requires-Dist") == "pkga", "pkgb"
+
+
+def test_metadata_pkg_info_requires_priority(tmp_path: Path) -> None:
+    """Check Requires-Dist in PKG-INFO has priority over requires.txt."""
+    egg_info_path = tmp_path / "whatever.egg-info"
+    egg_info_path.mkdir()
+    dist = get_directory_distribution(str(egg_info_path))
+    assert dist.installed_with_setuptools_egg_info
+    pkg_info_path = egg_info_path / "PKG-INFO"
+    pkg_info_path.write_text(
+        "Name: whatever\nRequires-Dist: pkgc\nRequires-Dist: pkgd\n"
+    )
+    egg_info_path.joinpath("requires.txt").write_text("pkga\npkgb\n")
+    assert dist.metadata.get_all("Requires-Dist") == "pkgc", "pkgd"
+
+
+@mock.patch.object(
+    BaseDistribution,
+    "read_text",
+    return_value='{"url": "https://e.c/p.tgz", "archive_info": {}}',
+)
+def test_dist_get_direct_url_valid_metadata(mock_read_text: mock.Mock) -> None:
+    class FakeDistribution(BaseDistribution):
+        pass
+
+    dist = FakeDistribution()
+    direct_url = dist.direct_url
+    assert direct_url is not None
+    mock_read_text.assert_called_once_with(DIRECT_URL_METADATA_NAME)
+    assert direct_url.url == "https://e.c/p.tgz"
+    assert isinstance(direct_url.info, ArchiveInfo)
+
+
+def test_metadata_dict(tmp_path: Path) -> None:
+    """Basic test of BaseDistribution metadata_dict.
+
+    More tests are available in the original pkg_metadata project where this
+    function comes from, and which we may vendor in the future.
+    """
+    wheel_path = make_wheel(name="pkga", version="1.0.1").save_to_dir(tmp_path)
+    wheel = FilesystemWheel(wheel_path)
+    dist = get_wheel_distribution(wheel, "pkga")
+    metadata_dict = dist.metadata_dict
+    assert metadata_dict"name" == "pkga"
+    assert metadata_dict"version" == "1.0.1"
+
+
+def test_no_dist_found_in_wheel(tmp_path: Path) -> None:
+    location = os.fspath(tmp_path.joinpath("pkg-1-py3-none-any.whl"))
+    make_wheel(name="pkg", version="1").save_to(location)
+    assert get_environment(location).get_distribution("pkg") is None
+
+
+def test_dist_found_in_directory_named_whl(tmp_path: Path) -> None:
+    dir_path = tmp_path.joinpath("pkg-1-py3-none-any.whl")
+    info_path = dir_path.joinpath("pkg-1.dist-info")
+    info_path.mkdir(parents=True)
+    info_path.joinpath("METADATA").write_text("Name: pkg")
+    location = os.fspath(dir_path)
+    dist = get_environment(location).get_distribution("pkg")
+    assert dist is not None and dist.location is not None
+    assert Path(dist.location) == Path(location)
+
+
+def test_dist_found_in_zip(tmp_path: Path) -> None:
+    location = os.fspath(tmp_path.joinpath("pkg.zip"))
+    make_wheel(name="pkg", version="1").save_to(location)
+    dist = get_environment(location).get_distribution("pkg")
+    assert dist is not None and dist.location is not None
+    assert Path(dist.location) == Path(location)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/metadata/test_metadata_pkg_resources.py Added

@@ -0,0 +1,123 @@
+import email.message
+import itertools
+from typing import List, cast
+from unittest import mock
+
+import pytest
+from pip._vendor.packaging.specifiers import SpecifierSet
+from pip._vendor.packaging.version import parse as parse_version
+
+from pip._internal.exceptions import UnsupportedWheel
+from pip._internal.metadata.pkg_resources import (
+    Distribution,
+    Environment,
+    InMemoryMetadata,
+)
+
+pkg_resources = pytest.importorskip("pip._vendor.pkg_resources")
+
+
+def _dist_is_local(dist: mock.Mock) -> bool:
+    return dist.kind != "global" and dist.kind != "user"
+
+
+def _dist_in_usersite(dist: mock.Mock) -> bool:
+    return dist.kind == "user"
+
+
+@pytest.fixture(autouse=True)
+def patch_distribution_lookups(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(Distribution, "local", property(_dist_is_local))
+    monkeypatch.setattr(Distribution, "in_usersite", property(_dist_in_usersite))
+
+
+class _MockWorkingSet(Listmock.Mock):
+    def require(self, name: str) -> None:
+        pass
+
+
+workingset = _MockWorkingSet(
+    (
+        mock.Mock(test_name="global", project_name="global"),
+        mock.Mock(test_name="editable", project_name="editable"),
+        mock.Mock(test_name="normal", project_name="normal"),
+        mock.Mock(test_name="user", project_name="user"),
+    )
+)
+
+workingset_stdlib = _MockWorkingSet(
+    (
+        mock.Mock(test_name="normal", project_name="argparse"),
+        mock.Mock(test_name="normal", project_name="wsgiref"),
+    )
+)
+
+
+@pytest.mark.parametrize(
+    "ws, req_name",
+    itertools.chain(
+        itertools.product(
+            workingset,
+            (d.project_name for d in workingset),
+        ),
+        itertools.product(
+            workingset_stdlib,
+            (d.project_name for d in workingset_stdlib),
+        ),
+    ),
+)
+def test_get_distribution(ws: _MockWorkingSet, req_name: str) -> None:
+    """Ensure get_distribution() finds all kinds of distributions."""
+    dist = Environment(ws).get_distribution(req_name)
+    assert dist is not None
+    assert cast(Distribution, dist)._dist.project_name == req_name
+
+
+def test_get_distribution_nonexist() -> None:
+    dist = Environment(workingset).get_distribution("non-exist")
+    assert dist is None
+
+
+def test_wheel_metadata_works() -> None:
+    name = "simple"
+    version = "0.1.0"
+    require_a = "a==1.0"
+    require_b = 'b==1.1; extra == "also_b"'
+    requires = require_a, require_b, 'c==1.2; extra == "also_c"'
+    extras = "also_b", "also_c"
+    requires_python = ">=3"
+
+    metadata = email.message.Message()
+    metadata"Name" = name
+    metadata"Version" = version
+    for require in requires:
+        metadata"Requires-Dist" = require
+    for extra in extras:
+        metadata"Provides-Extra" = extra
+    metadata"Requires-Python" = requires_python
+
+    dist = Distribution(
+        pkg_resources.DistInfoDistribution(
+            location="<in-memory>",
+            metadata=InMemoryMetadata({"METADATA": metadata.as_bytes()}, "<in-memory>"),
+            project_name=name,
+        ),
+    )
+
+    assert name == dist.canonical_name == dist.raw_name
+    assert parse_version(version) == dist.version
+    assert set(extras) == set(dist.iter_provided_extras())
+    assert require_a == str(r) for r in dist.iter_dependencies()
+    assert require_a, require_b == 
+        str(r) for r in dist.iter_dependencies("also_b")
+    
+    assert metadata.as_string() == dist.metadata.as_string()
+    assert SpecifierSet(requires_python) == dist.requires_python
+
+
+def test_wheel_metadata_throws_on_bad_unicode() -> None:
+    metadata = InMemoryMetadata({"METADATA": b"\xff"}, "<in-memory>")
+
+    with pytest.raises(UnsupportedWheel) as e:
+        metadata.get_metadata("METADATA")
+    assert "METADATA" in str(e.value)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/resolution_resolvelib Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/resolution_resolvelib/__init__.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/resolution_resolvelib/conftest.py Added

@@ -0,0 +1,78 @@
+from typing import Iterator
+
+import pytest
+
+from pip._internal.cli.req_command import RequirementCommand
+from pip._internal.commands.install import InstallCommand
+from pip._internal.index.collector import LinkCollector
+from pip._internal.index.package_finder import PackageFinder
+
+# from pip._internal.models.index import PyPI
+from pip._internal.models.search_scope import SearchScope
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.network.session import PipSession
+from pip._internal.operations.build.build_tracker import get_build_tracker
+from pip._internal.operations.prepare import RequirementPreparer
+from pip._internal.req.constructors import install_req_from_line
+from pip._internal.resolution.resolvelib.factory import Factory
+from pip._internal.resolution.resolvelib.provider import PipProvider
+from pip._internal.utils.temp_dir import TempDirectory, global_tempdir_manager
+from tests.lib import TestData
+
+
+@pytest.fixture
+def finder(data: TestData) -> IteratorPackageFinder:
+    session = PipSession()
+    scope = SearchScope(str(data.packages), , False)
+    collector = LinkCollector(session, scope)
+    prefs = SelectionPreferences(allow_yanked=False)
+    finder = PackageFinder.create(collector, prefs)
+    yield finder
+
+
+@pytest.fixture
+def preparer(finder: PackageFinder) -> IteratorRequirementPreparer:
+    session = PipSession()
+    rc = InstallCommand("x", "y")
+    o = rc.parse_args()
+
+    with global_tempdir_manager():
+        with TempDirectory() as tmp:
+            with get_build_tracker() as tracker:
+                preparer = RequirementCommand.make_requirement_preparer(
+                    tmp,
+                    options=o0,
+                    build_tracker=tracker,
+                    session=session,
+                    finder=finder,
+                    use_user_site=False,
+                    verbosity=0,
+                )
+
+                yield preparer
+
+
+@pytest.fixture
+def factory(finder: PackageFinder, preparer: RequirementPreparer) -> IteratorFactory:
+    yield Factory(
+        finder=finder,
+        preparer=preparer,
+        make_install_req=install_req_from_line,
+        wheel_cache=None,
+        use_user_site=False,
+        force_reinstall=False,
+        ignore_installed=False,
+        ignore_requires_python=False,
+        py_version_info=None,
+    )
+
+
+@pytest.fixture
+def provider(factory: Factory) -> IteratorPipProvider:
+    yield PipProvider(
+        factory=factory,
+        constraints={},
+        ignore_dependencies=False,
+        upgrade_strategy="to-satisfy-only",
+        user_requested={},
+    )

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/resolution_resolvelib/test_provider.py Added

@@ -0,0 +1,78 @@
+from typing import TYPE_CHECKING, List, Optional
+
+from pip._vendor.resolvelib.resolvers import RequirementInformation
+
+from pip._internal.models.candidate import InstallationCandidate
+from pip._internal.models.link import Link
+from pip._internal.req.constructors import install_req_from_req_string
+from pip._internal.resolution.resolvelib.factory import Factory
+from pip._internal.resolution.resolvelib.provider import PipProvider
+from pip._internal.resolution.resolvelib.requirements import SpecifierRequirement
+
+if TYPE_CHECKING:
+    from pip._internal.resolution.resolvelib.provider import PreferenceInformation
+
+
+def build_requirement_information(
+    name: str, parent: OptionalInstallationCandidate
+) -> List"PreferenceInformation":
+    install_requirement = install_req_from_req_string(name)
+    # RequirementInformation is typed as a tuple, but it is a namedtupled.
+    # https://github.com/sarugaku/resolvelib/blob/7bc025aa2a4e979597c438ad7b17d2e8a08a364e/src/resolvelib/resolvers.pyi#L20-L22
+    requirement_information: "PreferenceInformation" = RequirementInformation(
+        requirement=SpecifierRequirement(install_requirement),  # type: ignorecall-arg
+        parent=parent,
+    )
+    return requirement_information
+
+
+def test_provider_known_depths(factory: Factory) -> None:
+    # Root requirement is specified by the user
+    # therefore has an inferred depth of 1
+    root_requirement_name = "my-package"
+    provider = PipProvider(
+        factory=factory,
+        constraints={},
+        ignore_dependencies=False,
+        upgrade_strategy="to-satisfy-only",
+        user_requested={root_requirement_name: 0},
+    )
+
+    root_requirement_information = build_requirement_information(
+        name=root_requirement_name, parent=None
+    )
+    provider.get_preference(
+        identifier=root_requirement_name,
+        resolutions={},
+        candidates={},
+        information={root_requirement_name: root_requirement_information},
+        backtrack_causes=,
+    )
+    assert provider._known_depths == {root_requirement_name: 1.0}
+
+    # Transative requirement is a dependency of root requirement
+    # theforefore has an inferred depth of 2
+    root_package_candidate = InstallationCandidate(
+        root_requirement_name,
+        "1.0",
+        Link("https://{root_requirement_name}.com"),
+    )
+    transative_requirement_name = "my-transitive-package"
+
+    transative_package_information = build_requirement_information(
+        name=transative_requirement_name, parent=root_package_candidate
+    )
+    provider.get_preference(
+        identifier=transative_requirement_name,
+        resolutions={},
+        candidates={},
+        information={
+            root_requirement_name: root_requirement_information,
+            transative_requirement_name: transative_package_information,
+        },
+        backtrack_causes=,
+    )
+    assert provider._known_depths == {
+        transative_requirement_name: 2.0,
+        root_requirement_name: 1.0,
+    }

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/resolution_resolvelib/test_requirement.py Added

@@ -0,0 +1,111 @@
+import os
+from pathlib import Path
+from typing import Iterator, List, Tuple
+
+import pytest
+from pip._vendor.resolvelib import BaseReporter, Resolver
+
+from pip._internal.resolution.resolvelib.base import Candidate, Constraint, Requirement
+from pip._internal.resolution.resolvelib.factory import Factory
+from pip._internal.resolution.resolvelib.provider import PipProvider
+from tests.lib import TestData
+
+# NOTE: All tests are prefixed `test_rlr` (for "test resolvelib resolver").
+#       This helps select just these tests using pytest's `-k` option, and
+#       keeps test names shorter.
+
+# Basic tests:
+#   Create a requirement from a project name - "pip"
+#   Create a requirement from a name + version constraint - "pip >= 20.0"
+#   Create a requirement from a wheel filename
+#   Create a requirement from a sdist filename
+#   Create a requirement from a local directory (which has no obvious name!)
+#   Editables
+
+
+@pytest.fixture
+def test_cases(data: TestData) -> IteratorListTuplestr, str, int:
+    def _data_file(name: str) -> Path:
+        return data.packages.joinpath(name)
+
+    def data_file(name: str) -> str:
+        return os.fspath(_data_file(name))
+
+    def data_url(name: str) -> str:
+        return _data_file(name).as_uri()
+
+    test_cases = 
+        # requirement, name, matches
+        # Version specifiers
+        ("simple", "simple", 3),
+        ("simple>1.0", "simple", 2),
+        # ("simpleextra==1.0", "simpleextra", 1),
+        # Wheels
+        (data_file("simplewheel-1.0-py2.py3-none-any.whl"), "simplewheel", 1),
+        (data_url("simplewheel-1.0-py2.py3-none-any.whl"), "simplewheel", 1),
+        # Direct URLs
+        # TODO: The following test fails
+        # ("foo @ " + data_url("simple-1.0.tar.gz"), "foo", 1),
+        # SDists
+        # TODO: sdists should have a name
+        (data_file("simple-1.0.tar.gz"), "simple", 1),
+        (data_url("simple-1.0.tar.gz"), "simple", 1),
+        # TODO: directory, editables
+    
+
+    yield test_cases
+
+
+def test_new_resolver_requirement_has_name(
+    test_cases: ListTuplestr, str, int, factory: Factory
+) -> None:
+    """All requirements should have a name"""
+    for spec, name, _ in test_cases:
+        req = factory.make_requirement_from_spec(spec, comes_from=None)
+        assert req is not None
+        assert req.name == name
+
+
+def test_new_resolver_correct_number_of_matches(
+    test_cases: ListTuplestr, str, int, factory: Factory
+) -> None:
+    """Requirements should return the correct number of candidates"""
+    for spec, _, match_count in test_cases:
+        req = factory.make_requirement_from_spec(spec, comes_from=None)
+        assert req is not None
+        matches = factory.find_candidates(
+            req.name,
+            {req.name: req},
+            {},
+            Constraint.empty(),
+            prefers_installed=False,
+        )
+        assert sum(1 for _ in matches) == match_count
+
+
+def test_new_resolver_candidates_match_requirement(
+    test_cases: ListTuplestr, str, int, factory: Factory
+) -> None:
+    """Candidates returned from find_candidates should satisfy the requirement"""
+    for spec, _, _ in test_cases:
+        req = factory.make_requirement_from_spec(spec, comes_from=None)
+        assert req is not None
+        candidates = factory.find_candidates(
+            req.name,
+            {req.name: req},
+            {},
+            Constraint.empty(),
+            prefers_installed=False,
+        )
+        for c in candidates:
+            assert isinstance(c, Candidate)
+            assert req.is_satisfied_by(c)
+
+
+def test_new_resolver_full_resolve(factory: Factory, provider: PipProvider) -> None:
+    """A very basic full resolve"""
+    req = factory.make_requirement_from_spec("simplewheel", comes_from=None)
+    assert req is not None
+    r: ResolverRequirement, Candidate, str = Resolver(provider, BaseReporter())
+    result = r.resolve(req)
+    assert set(result.mapping.keys()) == {"simplewheel"}

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/resolution_resolvelib/test_resolver.py Added

@@ -0,0 +1,299 @@
+from typing import Dict, List, Optional, Set, Tuple, cast
+from unittest import mock
+
+import pytest
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.resolvelib.resolvers import Result
+from pip._vendor.resolvelib.structs import DirectedGraph
+
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.operations.prepare import RequirementPreparer
+from pip._internal.req.constructors import install_req_from_line
+from pip._internal.req.req_set import RequirementSet
+from pip._internal.resolution.resolvelib.resolver import (
+    Resolver,
+    get_topological_weights,
+)
+
+
+@pytest.fixture()
+def resolver(preparer: RequirementPreparer, finder: PackageFinder) -> Resolver:
+    resolver = Resolver(
+        preparer=preparer,
+        finder=finder,
+        wheel_cache=None,
+        make_install_req=mock.Mock(),
+        use_user_site=False,
+        ignore_dependencies=False,
+        ignore_installed=False,
+        ignore_requires_python=False,
+        force_reinstall=False,
+        upgrade_strategy="to-satisfy-only",
+    )
+    return resolver
+
+
+def _make_graph(
+    edges: ListTupleOptionalstr, Optionalstr
+) -> "DirectedGraphOptionalstr":
+    """Build graph from edge declarations."""
+
+    graph: "DirectedGraphOptionalstr" = DirectedGraph()
+    for parent, child in edges:
+        parent = cast(str, canonicalize_name(parent)) if parent else None
+        child = cast(str, canonicalize_name(child)) if child else None
+        for v in (parent, child):
+            if v not in graph:
+                graph.add(v)
+        graph.connect(parent, child)
+    return graph
+
+
+@pytest.mark.parametrize(
+    "edges, ordered_reqs",
+    
+        (
+            (None, "require-simple"), ("require-simple", "simple"),
+            "simple==3.0", "require-simple==1.0",
+        ),
+        (
+            (None, "meta"), ("meta", "simple"), ("meta", "simple2"),
+            "simple2==3.0", "simple==3.0", "meta==1.0",
+        ),
+        (
+            
+                (None, "toporequires"),
+                (None, "toporequires2"),
+                (None, "toporequires3"),
+                (None, "toporequires4"),
+                ("toporequires2", "toporequires"),
+                ("toporequires3", "toporequires"),
+                ("toporequires4", "toporequires"),
+                ("toporequires4", "toporequires2"),
+                ("toporequires4", "toporequires3"),
+            ,
+            
+                "toporequires==0.0.1",
+                "toporequires3==0.0.1",
+                "toporequires2==0.0.1",
+                "toporequires4==0.0.1",
+            ,
+        ),
+    ,
+)
+def test_new_resolver_get_installation_order(
+    resolver: Resolver,
+    edges: ListTupleOptionalstr, Optionalstr,
+    ordered_reqs: Liststr,
+) -> None:
+    graph = _make_graph(edges)
+
+    # Mapping values and criteria are not used in test, so we stub them out.
+    mapping = {vertex: None for vertex in graph if vertex is not None}
+    resolver._result = Result(mapping, graph, criteria=None)  # type: ignore
+
+    reqset = RequirementSet()
+    for r in ordered_reqs:
+        reqset.add_named_requirement(install_req_from_line(r))
+
+    ireqs = resolver.get_installation_order(reqset)
+    req_strs = str(r.req) for r in ireqs
+    assert req_strs == ordered_reqs
+
+
+@pytest.mark.parametrize(
+    "name, edges, requirement_keys, expected_weights",
+    
+        (
+            # From https://github.com/pypa/pip/pull/8127#discussion_r414564664
+            "deep second edge",
+            
+                (None, "one"),
+                (None, "two"),
+                ("one", "five"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"five": 5, "four": 4, "one": 4, "three": 2, "two": 1},
+        ),
+        (
+            "linear",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND restricted",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+            ,
+            {"one", "three", "five"},
+            {"one": 1, "three": 3, "five": 5},
+        ),
+        (
+            "linear AND root -> two",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                (None, "two"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND root -> three",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                (None, "three"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND root -> four",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                (None, "four"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND root -> five",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                (None, "five"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND one -> four",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("one", "four"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND two -> four",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("two", "four"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND four -> one (cycle)",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("four", "one"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND four -> two (cycle)",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("four", "two"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND four -> three (cycle)",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("four", "three"),
+            ,
+            {"one", "two", "three", "four", "five"},
+            {"one": 1, "two": 2, "three": 3, "four": 4, "five": 5},
+        ),
+        (
+            "linear AND four -> three (cycle) AND restricted 1-2-3",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("four", "three"),
+            ,
+            {"one", "two", "three"},
+            {"one": 1, "two": 2, "three": 3},
+        ),
+        (
+            "linear AND four -> three (cycle) AND restricted 4-5",
+            
+                (None, "one"),
+                ("one", "two"),
+                ("two", "three"),
+                ("three", "four"),
+                ("four", "five"),
+                ("four", "three"),
+            ,
+            {"four", "five"},
+            {"four": 4, "five": 5},
+        ),
+    ,
+)
+def test_new_resolver_topological_weights(
+    name: str,
+    edges: ListTupleOptionalstr, Optionalstr,
+    requirement_keys: Setstr,
+    expected_weights: DictOptionalstr, int,
+) -> None:
+    graph = _make_graph(edges)
+
+    weights = get_topological_weights(graph, requirement_keys)
+    assert weights == expected_weights

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_appdirs.py Added

@@ -0,0 +1,220 @@
+# mypy: no-warn-unused-ignores
+
+import os
+import sys
+from unittest import mock
+
+import pytest
+from pip._vendor import platformdirs
+
+from pip._internal.utils import appdirs
+
+
+class TestUserCacheDir:
+    @pytest.mark.skipif(sys.platform != "win32", reason="Windows-only test")
+    def test_user_cache_dir_win(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        _get_win_folder = mock.Mock(return_value="C:\\Users\\test\\AppData\\Local")
+
+        monkeypatch.setattr(
+            platformdirs.windows,  # type: ignore
+            "get_win_folder",
+            _get_win_folder,
+            raising=False,
+        )
+
+        assert (
+            appdirs.user_cache_dir("pip")
+            == "C:\\Users\\test\\AppData\\Local\\pip\\Cache"
+        )
+        assert _get_win_folder.call_args_list == mock.call("CSIDL_LOCAL_APPDATA")
+
+    @pytest.mark.skipif(sys.platform != "darwin", reason="MacOS-only test")
+    def test_user_cache_dir_osx(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setenv("HOME", "/home/test")
+
+        assert appdirs.user_cache_dir("pip") == "/home/test/Library/Caches/pip"
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_user_cache_dir_linux(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.delenv("XDG_CACHE_HOME", raising=False)
+        monkeypatch.setenv("HOME", "/home/test")
+
+        assert appdirs.user_cache_dir("pip") == "/home/test/.cache/pip"
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_user_cache_dir_linux_override(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("XDG_CACHE_HOME", "/home/test/.other-cache")
+        monkeypatch.setenv("HOME", "/home/test")
+
+        assert appdirs.user_cache_dir("pip") == "/home/test/.other-cache/pip"
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_user_cache_dir_linux_home_slash(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Verify that we are not affected by https://bugs.python.org/issue14768
+        monkeypatch.delenv("XDG_CACHE_HOME", raising=False)
+        monkeypatch.setenv("HOME", "/")
+
+        assert appdirs.user_cache_dir("pip") == "/.cache/pip"
+
+    def test_user_cache_dir_unicode(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        if sys.platform != "win32":
+            return
+
+        def my_get_win_folder(csidl_name: str) -> str:
+            return "\u00DF\u00E4\u03B1\u20AC"
+
+        monkeypatch.setattr(
+            platformdirs.windows,  # type: ignore
+            "get_win_folder",
+            my_get_win_folder,
+        )
+
+        # Do not use the isinstance expression directly in the
+        # assert statement, as the Unicode characters in the result
+        # cause pytest to fail with an internal error on Python 2.7
+        result_is_str = isinstance(appdirs.user_cache_dir("test"), str)
+        assert result_is_str, "user_cache_dir did not return a str"
+
+        # Test against regression #3463
+        from pip._internal.cli.main_parser import create_main_parser
+
+        create_main_parser().print_help()  # This should not crash
+
+
+class TestSiteConfigDirs:
+    @pytest.mark.skipif(sys.platform != "win32", reason="Windows-only test")
+    def test_site_config_dirs_win(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        _get_win_folder = mock.Mock(return_value="C:\\ProgramData")
+
+        monkeypatch.setattr(
+            platformdirs.windows,  # type: ignore
+            "get_win_folder",
+            _get_win_folder,
+            raising=False,
+        )
+
+        assert appdirs.site_config_dirs("pip") == "C:\\ProgramData\\pip"
+        assert _get_win_folder.call_args_list == mock.call("CSIDL_COMMON_APPDATA")
+
+    @pytest.mark.skipif(sys.platform != "darwin", reason="MacOS-only test")
+    def test_site_config_dirs_osx(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setenv("HOME", "/home/test")
+
+        assert appdirs.site_config_dirs("pip") == 
+            "/Library/Application Support/pip",
+        
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_site_config_dirs_linux(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.delenv("XDG_CONFIG_DIRS", raising=False)
+
+        assert appdirs.site_config_dirs("pip") == 
+            "/etc/xdg/pip",
+            "/etc",
+        
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_site_config_dirs_linux_override(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setattr(os, "pathsep", ":")
+        monkeypatch.setenv("XDG_CONFIG_DIRS", "/spam:/etc:/etc/xdg")
+
+        assert appdirs.site_config_dirs("pip") == 
+            "/spam/pip",
+            "/etc/pip",
+            "/etc/xdg/pip",
+            "/etc",
+        
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_site_config_dirs_linux_empty(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setattr(os, "pathsep", ":")
+        monkeypatch.setenv("XDG_CONFIG_DIRS", "")
+        assert appdirs.site_config_dirs("pip") == 
+            "/etc/xdg/pip",
+            "/etc",
+        
+
+
+class TestUserConfigDir:
+    @pytest.mark.skipif(sys.platform != "win32", reason="Windows-only test")
+    def test_user_config_dir_win_no_roaming(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        _get_win_folder = mock.Mock(return_value="C:\\Users\\test\\AppData\\Local")
+
+        monkeypatch.setattr(
+            platformdirs.windows,  # type: ignore
+            "get_win_folder",
+            _get_win_folder,
+            raising=False,
+        )
+
+        assert (
+            appdirs.user_config_dir("pip", roaming=False)
+            == "C:\\Users\\test\\AppData\\Local\\pip"
+        )
+        assert _get_win_folder.call_args_list == mock.call("CSIDL_LOCAL_APPDATA")
+
+    @pytest.mark.skipif(sys.platform != "win32", reason="Windows-only test")
+    def test_user_config_dir_win_yes_roaming(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        _get_win_folder = mock.Mock(return_value="C:\\Users\\test\\AppData\\Roaming")
+
+        monkeypatch.setattr(
+            platformdirs.windows,  # type: ignore
+            "get_win_folder",
+            _get_win_folder,
+            raising=False,
+        )
+
+        assert (
+            appdirs.user_config_dir("pip") == "C:\\Users\\test\\AppData\\Roaming\\pip"
+        )
+        assert _get_win_folder.call_args_list == mock.call("CSIDL_APPDATA")
+
+    @pytest.mark.skipif(sys.platform != "darwin", reason="MacOS-only test")
+    def test_user_config_dir_osx(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setenv("HOME", "/home/test")
+
+        if os.path.isdir("/home/test/Library/Application Support/"):
+            assert (
+                appdirs.user_config_dir("pip")
+                == "/home/test/Library/Application Support/pip"
+            )
+        else:
+            assert appdirs.user_config_dir("pip") == "/home/test/.config/pip"
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_user_config_dir_linux(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.delenv("XDG_CONFIG_HOME", raising=False)
+        monkeypatch.setenv("HOME", "/home/test")
+
+        assert appdirs.user_config_dir("pip") == "/home/test/.config/pip"
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_user_config_dir_linux_override(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("XDG_CONFIG_HOME", "/home/test/.other-config")
+        monkeypatch.setenv("HOME", "/home/test")
+
+        assert appdirs.user_config_dir("pip") == "/home/test/.other-config/pip"
+
+    @pytest.mark.skipif(sys.platform != "linux", reason="Linux-only test")
+    def test_user_config_dir_linux_home_slash(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # Verify that we are not affected by https://bugs.python.org/issue14768
+        monkeypatch.delenv("XDG_CONFIG_HOME", raising=False)
+        monkeypatch.setenv("HOME", "/")
+
+        assert appdirs.user_config_dir("pip") == "/.config/pip"

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_base_command.py Added

@@ -0,0 +1,205 @@
+import logging
+import os
+import time
+from optparse import Values
+from pathlib import Path
+from typing import Callable, Iterator, List, NoReturn, Optional
+from unittest.mock import Mock, patch
+
+import pytest
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.status_codes import SUCCESS
+from pip._internal.utils import temp_dir
+from pip._internal.utils.logging import BrokenStdoutLoggingError
+from pip._internal.utils.temp_dir import TempDirectory
+
+
+@pytest.fixture
+def fixed_time() -> IteratorNone:
+    with patch("time.time", lambda: 1547704837.040001 + time.timezone):
+        yield
+
+
+class FakeCommand(Command):
+    _name = "fake"
+
+    def __init__(
+        self, run_func: OptionalCallable, int = None, error: bool = False
+    ) -> None:
+        if error:
+
+            def run_func() -> int:
+                raise SystemExit(1)
+
+        self.run_func = run_func
+        super().__init__(self._name, self._name)
+
+    def main(self, args: Liststr) -> int:
+        args.append("--disable-pip-version-check")
+        return super().main(args)
+
+    def run(self, options: Values, args: Liststr) -> int:
+        logging.getLogger("pip.tests").info("fake")
+        # Return SUCCESS from run if run_func is not provided
+        if self.run_func:
+            return self.run_func()
+        else:
+            return SUCCESS
+
+
+class FakeCommandWithUnicode(FakeCommand):
+    _name = "fake_unicode"
+
+    def run(self, options: Values, args: Liststr) -> int:
+        logging.getLogger("pip.tests").info(b"bytes here \xE9")
+        logging.getLogger("pip.tests").info(b"unicode here \xC3\xA9".decode("utf-8"))
+        return SUCCESS
+
+
+class TestCommand:
+    def call_main(self, capsys: pytest.CaptureFixturestr, args: Liststr) -> str:
+        """
+        Call command.main(), and return the command's stderr.
+        """
+
+        def raise_broken_stdout() -> NoReturn:
+            raise BrokenStdoutLoggingError()
+
+        cmd = FakeCommand(run_func=raise_broken_stdout)
+        status = cmd.main(args)
+        assert status == 1
+        stderr = capsys.readouterr().err
+
+        return stderr
+
+    def test_raise_broken_stdout(self, capsys: pytest.CaptureFixturestr) -> None:
+        """
+        Test raising BrokenStdoutLoggingError.
+        """
+        stderr = self.call_main(capsys, )
+
+        assert stderr.rstrip() == "ERROR: Pipe to stdout was broken"
+
+    def test_raise_broken_stdout__debug_logging(
+        self, capsys: pytest.CaptureFixturestr
+    ) -> None:
+        """
+        Test raising BrokenStdoutLoggingError with debug logging enabled.
+        """
+        stderr = self.call_main(capsys, "-vv")
+
+        assert "ERROR: Pipe to stdout was broken" in stderr
+        assert "Traceback (most recent call last):" in stderr
+
+
+@patch("pip._internal.cli.req_command.Command.handle_pip_version_check")
+def test_handle_pip_version_check_called(mock_handle_version_check: Mock) -> None:
+    """
+    Check that Command.handle_pip_version_check() is called.
+    """
+    cmd = FakeCommand()
+    cmd.main()
+    mock_handle_version_check.assert_called_once()
+
+
+def test_log_command_success(fixed_time: None, tmpdir: Path) -> None:
+    """Test the --log option logs when command succeeds."""
+    cmd = FakeCommand()
+    log_path = os.path.join(tmpdir, "log")
+    cmd.main("fake", "--log", log_path)
+    with open(log_path) as f:
+        assert f.read().rstrip() == "2019-01-17T06:00:37,040 fake"
+
+
+def test_log_command_error(fixed_time: None, tmpdir: Path) -> None:
+    """Test the --log option logs when command fails."""
+    cmd = FakeCommand(error=True)
+    log_path = os.path.join(tmpdir, "log")
+    cmd.main("fake", "--log", log_path)
+    with open(log_path) as f:
+        assert f.read().startswith("2019-01-17T06:00:37,040 fake")
+
+
+def test_log_file_command_error(fixed_time: None, tmpdir: Path) -> None:
+    """Test the --log-file option logs (when there's an error)."""
+    cmd = FakeCommand(error=True)
+    log_file_path = os.path.join(tmpdir, "log_file")
+    cmd.main("fake", "--log-file", log_file_path)
+    with open(log_file_path) as f:
+        assert f.read().startswith("2019-01-17T06:00:37,040 fake")
+
+
+def test_log_unicode_messages(fixed_time: None, tmpdir: Path) -> None:
+    """Tests that logging bytestrings and unicode objects
+    don't break logging.
+    """
+    cmd = FakeCommandWithUnicode()
+    log_path = os.path.join(tmpdir, "log")
+    cmd.main("fake_unicode", "--log", log_path)
+
+
+@pytest.mark.no_auto_tempdir_manager
+def test_base_command_provides_tempdir_helpers() -> None:
+    assert temp_dir._tempdir_manager is None
+    assert temp_dir._tempdir_registry is None
+
+    def assert_helpers_set(options: Values, args: Liststr) -> int:
+        assert temp_dir._tempdir_manager is not None
+        assert temp_dir._tempdir_registry is not None
+        return SUCCESS
+
+    c = Command("fake", "fake")
+    # https://github.com/python/mypy/issues/2427
+    c.run = Mock(side_effect=assert_helpers_set)  # type: ignoreassignment
+    assert c.main("fake") == SUCCESS
+    c.run.assert_called_once()
+
+
+not_deleted = "not_deleted"
+
+
+@pytest.mark.parametrize("kind,exists", (not_deleted, True), ("deleted", False))
+@pytest.mark.no_auto_tempdir_manager
+def test_base_command_global_tempdir_cleanup(kind: str, exists: bool) -> None:
+    assert temp_dir._tempdir_manager is None
+    assert temp_dir._tempdir_registry is None
+
+    class Holder:
+        value: str
+
+    def create_temp_dirs(options: Values, args: Liststr) -> int:
+        assert c.tempdir_registry is not None
+        c.tempdir_registry.set_delete(not_deleted, False)
+        Holder.value = TempDirectory(kind=kind, globally_managed=True).path
+        return SUCCESS
+
+    c = Command("fake", "fake")
+    # https://github.com/python/mypy/issues/2427
+    c.run = Mock(side_effect=create_temp_dirs)  # type: ignoreassignment
+    assert c.main("fake") == SUCCESS
+    c.run.assert_called_once()
+    assert os.path.exists(Holder.value) == exists
+
+
+@pytest.mark.parametrize("kind,exists", (not_deleted, True), ("deleted", False))
+@pytest.mark.no_auto_tempdir_manager
+def test_base_command_local_tempdir_cleanup(kind: str, exists: bool) -> None:
+    assert temp_dir._tempdir_manager is None
+    assert temp_dir._tempdir_registry is None
+
+    def create_temp_dirs(options: Values, args: Liststr) -> int:
+        assert c.tempdir_registry is not None
+        c.tempdir_registry.set_delete(not_deleted, False)
+
+        with TempDirectory(kind=kind) as d:
+            path = d.path
+            assert os.path.exists(path)
+        assert os.path.exists(path) == exists
+        return SUCCESS
+
+    c = Command("fake", "fake")
+    # https://github.com/python/mypy/issues/2427
+    c.run = Mock(side_effect=create_temp_dirs)  # type: ignoreassignment
+    assert c.main("fake") == SUCCESS
+    c.run.assert_called_once()

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_cache.py Added

@@ -0,0 +1,118 @@
+import os
+from pathlib import Path
+
+from pip._vendor.packaging.tags import Tag, interpreter_name, interpreter_version
+
+from pip._internal.cache import WheelCache, _hash_dict
+from pip._internal.models.link import Link
+from pip._internal.utils.misc import ensure_dir
+
+
+def test_falsey_path_none() -> None:
+    wc = WheelCache("")
+    assert wc.cache_dir is None
+
+
+def test_subdirectory_fragment() -> None:
+    """
+    Test the subdirectory URL fragment is part of the cache key.
+    """
+    wc = WheelCache("/tmp/.foo/")
+    link1 = Link("git+https://g.c/o/r#subdirectory=d1")
+    link2 = Link("git+https://g.c/o/r#subdirectory=d2")
+    assert wc.get_path_for_link(link1) != wc.get_path_for_link(link2)
+
+
+def test_wheel_name_filter(tmpdir: Path) -> None:
+    """
+    Test the wheel cache filters on wheel name when several wheels
+    for different package are stored under the same cache directory.
+    """
+    wc = WheelCache(os.fspath(tmpdir))
+    link = Link("https://g.c/package.tar.gz")
+    cache_path = wc.get_path_for_link(link)
+    ensure_dir(cache_path)
+    with open(os.path.join(cache_path, "package-1.0-py3-none-any.whl"), "w"):
+        pass
+    # package matches wheel name
+    cached_link = wc.get(link, "package", Tag("py3", "none", "any"))
+    assert cached_link is not link
+    assert os.path.exists(cached_link.file_path)
+    # package2 does not match wheel name
+    assert wc.get(link, "package2", Tag("py3", "none", "any")) is link
+
+
+def test_cache_hash() -> None:
+    h = _hash_dict({"url": "https://g.c/o/r"})
+    assert h == "72aa79d3315c181d2cc23239d7109a782de663b6f89982624d8c1e86"
+    h = _hash_dict({"url": "https://g.c/o/r", "subdirectory": "sd"})
+    assert h == "8b13391b6791bf7f3edeabb41ea4698d21bcbdbba7f9c7dc9339750d"
+    h = _hash_dict({"subdirectory": "/\xe9e"})
+    assert h == "f83b32dfa27a426dec08c21bf006065dd003d0aac78e7fc493d9014d"
+
+
+def test_link_to_cache(tmpdir: Path) -> None:
+    """
+    Test that Link.from_json() produces Links with consistent cache
+    locations
+    """
+    wc = WheelCache(os.fspath(tmpdir))
+    # Define our expectations for stable cache path.
+    i_name = interpreter_name()
+    i_version = interpreter_version()
+    key_parts = {
+        "url": "https://files.pythonhosted.org/packages/a6/91/"
+        "86a6eac449ddfae239e93ffc1918cf33fd9bab35c04d1e963b311e347a73/"
+        "netifaces-0.11.0.tar.gz",
+        "sha256": "043a79146eb2907edf439899f262b3dfe41717d34124298ed281139a8b93ca32",
+        "interpreter_name": i_name,
+        "interpreter_version": i_version,
+    }
+    expected_hash = _hash_dict(key_parts)
+    parts = 
+        expected_hash:2,
+        expected_hash2:4,
+        expected_hash4:6,
+        expected_hash6:,
+    
+    pathed_hash = os.path.join(*parts)
+    # Check working from a Link produces the same result.
+    file_data = {
+        "filename": "netifaces-0.11.0.tar.gz",
+        "hashes": {
+            "sha256": key_parts"sha256",
+        },
+        "requires-python": "",
+        "url": key_parts"url",
+        "yanked": False,
+    }
+    page_url = "https://pypi.org/simple/netifaces/"
+    link = Link.from_json(file_data=file_data, page_url=page_url)
+    assert link
+    path = wc.get_path_for_link(link)
+    assert pathed_hash in path
+
+
+def test_get_cache_entry(tmpdir: Path) -> None:
+    wc = WheelCache(os.fspath(tmpdir))
+    persi_link = Link("https://g.c/o/r/persi")
+    persi_path = wc.get_path_for_link(persi_link)
+    ensure_dir(persi_path)
+    with open(os.path.join(persi_path, "persi-1.0.0-py3-none-any.whl"), "w"):
+        pass
+    ephem_link = Link("https://g.c/o/r/ephem")
+    ephem_path = wc.get_ephem_path_for_link(ephem_link)
+    ensure_dir(ephem_path)
+    with open(os.path.join(ephem_path, "ephem-1.0.0-py3-none-any.whl"), "w"):
+        pass
+    other_link = Link("https://g.c/o/r/other")
+    supported_tags = Tag("py3", "none", "any")
+    entry = wc.get_cache_entry(persi_link, "persi", supported_tags)
+    assert entry is not None
+    assert entry.persistent
+
+    entry = wc.get_cache_entry(ephem_link, "ephem", supported_tags)
+    assert entry is not None
+    assert not entry.persistent
+
+    assert wc.get_cache_entry(other_link, "other", supported_tags) is None

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_cmdoptions.py Added

@@ -0,0 +1,52 @@
+import os
+from pathlib import Path
+from typing import Optional, Tuple
+from venv import EnvBuilder
+
+import pytest
+
+from pip._internal.cli.cmdoptions import _convert_python_version
+from pip._internal.cli.main_parser import identify_python_interpreter
+
+
+@pytest.mark.parametrize(
+    "value, expected",
+    
+        ("", (None, None)),
+        ("2", ((2,), None)),
+        ("3", ((3,), None)),
+        ("3.7", ((3, 7), None)),
+        ("3.7.3", ((3, 7, 3), None)),
+        # Test strings without dots of length bigger than 1.
+        ("34", ((3, 4), None)),
+        # Test a 2-digit minor version.
+        ("310", ((3, 10), None)),
+        # Test some values that fail to parse.
+        ("ab", ((), "each version part must be an integer")),
+        ("3a", ((), "each version part must be an integer")),
+        ("3.7.a", ((), "each version part must be an integer")),
+        ("3.7.3.1", ((), "at most three version parts are allowed")),
+    ,
+)
+def test_convert_python_version(
+    value: str, expected: TupleOptionalTupleint, ..., Optionalstr
+) -> None:
+    actual = _convert_python_version(value)
+    assert actual == expected, f"actual: {actual!r}"
+
+
+def test_identify_python_interpreter_venv(tmpdir: Path) -> None:
+    env_path = tmpdir / "venv"
+    env = EnvBuilder(with_pip=False)
+    env.create(env_path)
+
+    # Passing a virtual environment returns the Python executable
+    interp = identify_python_interpreter(os.fspath(env_path))
+    assert interp is not None
+    assert Path(interp).exists()
+
+    # Passing an executable returns it
+    assert identify_python_interpreter(interp) == interp
+
+    # Passing a non-existent file returns None
+    assert identify_python_interpreter(str(tmpdir / "nonexistent")) is None

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_collector.py Added

@@ -0,0 +1,1096 @@
+import itertools
+import json
+import logging
+import os
+import re
+import uuid
+from pathlib import Path
+from textwrap import dedent
+from typing import Dict, List, Optional, Tuple
+from unittest import mock
+
+import pytest
+from pip._vendor import requests
+from pip._vendor.packaging.requirements import Requirement
+
+from pip._internal.exceptions import NetworkConnectionError
+from pip._internal.index.collector import (
+    IndexContent,
+    LinkCollector,
+    _get_index_content,
+    _get_simple_response,
+    _make_index_content,
+    _NotAPIContent,
+    _NotHTTP,
+    parse_links,
+)
+from pip._internal.index.sources import _FlatDirectorySource, _IndexDirectorySource
+from pip._internal.models.candidate import InstallationCandidate
+from pip._internal.models.index import PyPI
+from pip._internal.models.link import (
+    Link,
+    LinkHash,
+    _clean_url_path,
+    _ensure_quoted_url,
+)
+from pip._internal.network.session import PipSession
+from tests.lib import TestData, make_test_link_collector
+
+ACCEPT = ", ".join(
+    
+        "application/vnd.pypi.simple.v1+json",
+        "application/vnd.pypi.simple.v1+html; q=0.1",
+        "text/html; q=0.01",
+    
+)
+
+
+@pytest.mark.parametrize(
+    "url",
+    
+        "ftp://python.org/python-3.7.1.zip",
+        "file:///opt/data/pip-18.0.tar.gz",
+    ,
+)
+def test_get_simple_response_archive_to_naive_scheme(url: str) -> None:
+    """
+    `_get_simple_response()` should error on an archive-like URL if the scheme
+    does not allow "poking" without getting data.
+    """
+    with pytest.raises(_NotHTTP):
+        _get_simple_response(url, session=mock.Mock(PipSession))
+
+
+@pytest.mark.parametrize(
+    "url, content_type",
+    
+        ("http://python.org/python-3.7.1.zip", "application/zip"),
+        ("https://pypi.org/pip-18.0.tar.gz", "application/gzip"),
+    ,
+)
+@mock.patch("pip._internal.index.collector.raise_for_status")
+def test_get_simple_response_archive_to_http_scheme(
+    mock_raise_for_status: mock.Mock, url: str, content_type: str
+) -> None:
+    """
+    `_get_simple_response()` should send a HEAD request on an archive-like URL
+    if the scheme supports it, and raise `_NotAPIContent` if the response isn't HTML.
+    """
+    session = mock.Mock(PipSession)
+    session.head.return_value = mock.Mock(
+        **{
+            "request.method": "HEAD",
+            "headers": {"Content-Type": content_type},
+        }
+    )
+
+    with pytest.raises(_NotAPIContent) as ctx:
+        _get_simple_response(url, session=session)
+
+    session.assert_has_calls(
+        
+            mock.call.head(url, allow_redirects=True),
+        
+    )
+    mock_raise_for_status.assert_called_once_with(session.head.return_value)
+    assert ctx.value.args == (content_type, "HEAD")
+
+
+@pytest.mark.parametrize(
+    "url",
+    
+        ("ftp://python.org/python-3.7.1.zip"),
+        ("file:///opt/data/pip-18.0.tar.gz"),
+    ,
+)
+def test_get_index_content_invalid_content_type_archive(
+    caplog: pytest.LogCaptureFixture, url: str
+) -> None:
+    """`_get_index_content()` should warn if an archive URL is not HTML
+    and therefore cannot be used for a HEAD request.
+    """
+    caplog.set_level(logging.WARNING)
+    link = Link(url)
+
+    session = mock.Mock(PipSession)
+
+    assert _get_index_content(link, session=session) is None
+    assert (
+        "pip._internal.index.collector",
+        logging.WARNING,
+        "Skipping page {} because it looks like an archive, and cannot "
+        "be checked by a HTTP HEAD request.".format(url),
+    ) in caplog.record_tuples
+
+
+@pytest.mark.parametrize(
+    "url",
+    
+        "http://python.org/python-3.7.1.zip",
+        "https://pypi.org/pip-18.0.tar.gz",
+    ,
+)
+@mock.patch("pip._internal.index.collector.raise_for_status")
+def test_get_simple_response_archive_to_http_scheme_is_html(
+    mock_raise_for_status: mock.Mock, url: str
+) -> None:
+    """
+    `_get_simple_response()` should work with archive-like URLs if the HEAD
+    request is responded with text/html.
+    """
+    session = mock.Mock(PipSession)
+    session.head.return_value = mock.Mock(
+        **{
+            "request.method": "HEAD",
+            "headers": {"Content-Type": "text/html"},
+        }
+    )
+    session.get.return_value = mock.Mock(headers={"Content-Type": "text/html"})
+
+    resp = _get_simple_response(url, session=session)
+
+    assert resp is not None
+    assert session.mock_calls == 
+        mock.call.head(url, allow_redirects=True),
+        mock.call.get(
+            url,
+            headers={
+                "Accept": ACCEPT,
+                "Cache-Control": "max-age=0",
+            },
+        ),
+    
+    assert mock_raise_for_status.mock_calls == 
+        mock.call(session.head.return_value),
+        mock.call(resp),
+    
+
+
+@pytest.mark.parametrize(
+    "url",
+    
+        "https://pypi.org/simple/pip",
+        "https://pypi.org/simple/pip/",
+        "https://python.org/sitemap.xml",
+    ,
+)
+@mock.patch("pip._internal.index.collector.raise_for_status")
+def test_get_simple_response_no_head(
+    mock_raise_for_status: mock.Mock, url: str
+) -> None:
+    """
+    `_get_simple_response()` shouldn't send a HEAD request if the URL does not
+    look like an archive, only the GET request that retrieves data.
+    """
+    session = mock.Mock(PipSession)
+
+    # Mock the headers dict to ensure it is accessed.
+    session.get.return_value = mock.Mock(
+        headers=mock.Mock(
+            **{
+                "get.return_value": "text/html",
+            }
+        )
+    )
+
+    resp = _get_simple_response(url, session=session)
+
+    assert resp is not None
+    assert session.head.call_count == 0
+    assert session.get.mock_calls == 
+        mock.call(
+            url,
+            headers={
+                "Accept": ACCEPT,
+                "Cache-Control": "max-age=0",
+            },
+        ),
+        mock.call().headers.get("Content-Type", "Unknown"),
+        mock.call().headers.get("Content-Type", "Unknown"),
+    
+    mock_raise_for_status.assert_called_once_with(resp)
+
+
+@mock.patch("pip._internal.index.collector.raise_for_status")
+def test_get_simple_response_dont_log_clear_text_password(
+    mock_raise_for_status: mock.Mock, caplog: pytest.LogCaptureFixture
+) -> None:
+    """
+    `_get_simple_response()` should redact the password from the index URL
+    in its DEBUG log message.
+    """
+    session = mock.Mock(PipSession)
+
+    # Mock the headers dict to ensure it is accessed.
+    session.get.return_value = mock.Mock(
+        headers=mock.Mock(
+            **{
+                "get.return_value": "text/html",
+            }
+        )
+    )
+
+    caplog.set_level(logging.DEBUG)
+
+    resp = _get_simple_response(
+        "https://user:my_password@example.com/simple/", session=session
+    )
+
+    assert resp is not None
+    mock_raise_for_status.assert_called_once_with(resp)
+
+    assert len(caplog.records) == 2
+    record = caplog.records0
+    assert record.levelname == "DEBUG"
+    assert record.message.splitlines() == 
+        "Getting page https://user:****@example.com/simple/",
+    
+    record = caplog.records1
+    assert record.levelname == "DEBUG"
+    assert record.message.splitlines() == 
+        "Fetched page https://user:****@example.com/simple/ as text/html",
+    
+
+
+@pytest.mark.parametrize(
+    ("path", "expected"),
+    
+        # Test a character that needs quoting.
+        ("a b", "a%20b"),
+        # Test an unquoted "@".
+        ("a @ b", "a%20@%20b"),
+        # Test multiple unquoted "@".
+        ("a @ @ b", "a%20@%20@%20b"),
+        # Test a quoted "@".
+        ("a %40 b", "a%20%40%20b"),
+        # Test a quoted "@" before an unquoted "@".
+        ("a %40b@ c", "a%20%40b@%20c"),
+        # Test a quoted "@" after an unquoted "@".
+        ("a @b%40 c", "a%20@b%40%20c"),
+        # Test alternating quoted and unquoted "@".
+        ("a %40@b %40@c %40", "a%20%40@b%20%40@c%20%40"),
+        # Test an unquoted "/".
+        ("a / b", "a%20/%20b"),
+        # Test multiple unquoted "/".
+        ("a / / b", "a%20/%20/%20b"),
+        # Test a quoted "/".
+        ("a %2F b", "a%20%2F%20b"),
+        # Test a quoted "/" before an unquoted "/".
+        ("a %2Fb/ c", "a%20%2Fb/%20c"),
+        # Test a quoted "/" after an unquoted "/".
+        ("a /b%2F c", "a%20/b%2F%20c"),
+        # Test alternating quoted and unquoted "/".
+        ("a %2F/b %2F/c %2F", "a%20%2F/b%20%2F/c%20%2F"),
+        # Test normalizing non-reserved quoted characters "" and ""
+        ("a %5b %5d b", "a%20%5B%20%5D%20b"),
+        # Test normalizing a reserved quoted "/"
+        ("a %2f b", "a%20%2F%20b"),
+    ,
+)
+@pytest.mark.parametrize("is_local_path", True, False)
+def test_clean_url_path(path: str, expected: str, is_local_path: bool) -> None:
+    assert _clean_url_path(path, is_local_path=is_local_path) == expected
+
+
+@pytest.mark.parametrize(
+    ("path", "expected"),
+    
+        # Test a VCS path with a Windows drive letter and revision.
+        pytest.param(
+            "/T:/with space/repo.git@1.0",
+            "///T:/with%20space/repo.git@1.0",
+            marks=pytest.mark.skipif("sys.platform != 'win32'"),
+        ),
+        # Test a VCS path with a Windows drive letter and revision,
+        # running on non-windows platform.
+        pytest.param(
+            "/T:/with space/repo.git@1.0",
+            "/T%3A/with%20space/repo.git@1.0",
+            marks=pytest.mark.skipif("sys.platform == 'win32'"),
+        ),
+    ,
+)
+def test_clean_url_path_with_local_path(path: str, expected: str) -> None:
+    actual = _clean_url_path(path, is_local_path=True)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    ("url", "clean_url"),
+    
+        # URL with hostname and port. Port separator should not be quoted.
+        (
+            "https://localhost.localdomain:8181/path/with space/",
+            "https://localhost.localdomain:8181/path/with%20space/",
+        ),
+        # URL that is already properly quoted. The quoting `%`
+        # characters should not be quoted again.
+        (
+            "https://localhost.localdomain:8181/path/with%20quoted%20space/",
+            "https://localhost.localdomain:8181/path/with%20quoted%20space/",
+        ),
+        # URL with IPv4 address and port.
+        (
+            "https://127.0.0.1:8181/path/with space/",
+            "https://127.0.0.1:8181/path/with%20space/",
+        ),
+        # URL with IPv6 address and port. The `` brackets around the
+        # IPv6 address should not be quoted.
+        (
+            "https://fd00:0:0:236::100:8181/path/with space/",
+            "https://fd00:0:0:236::100:8181/path/with%20space/",
+        ),
+        # URL with query. The leading `?` should not be quoted.
+        (
+            "https://localhost.localdomain:8181/path/with/query?request=test",
+            "https://localhost.localdomain:8181/path/with/query?request=test",
+        ),
+        # URL with colon in the path portion.
+        (
+            "https://localhost.localdomain:8181/path:/with:/colon",
+            "https://localhost.localdomain:8181/path%3A/with%3A/colon",
+        ),
+        # URL with something that looks like a drive letter, but is
+        # not. The `:` should be quoted.
+        (
+            "https://localhost.localdomain/T:/path/",
+            "https://localhost.localdomain/T%3A/path/",
+        ),
+        # URL with a quoted "/" in the path portion.
+        (
+            "https://example.com/access%2Ftoken/path/",
+            "https://example.com/access%2Ftoken/path/",
+        ),
+        # VCS URL containing revision string.
+        (
+            "git+ssh://example.com/path to/repo.git@1.0#egg=my-package-1.0",
+            "git+ssh://example.com/path%20to/repo.git@1.0#egg=my-package-1.0",
+        ),
+        # VCS URL with a quoted "#" in the revision string.
+        (
+            "git+https://example.com/repo.git@hash%23symbol#egg=my-package-1.0",
+            "git+https://example.com/repo.git@hash%23symbol#egg=my-package-1.0",
+        ),
+        # VCS URL with a quoted "@" in the revision string.
+        (
+            "git+https://example.com/repo.git@at%40 space#egg=my-package-1.0",
+            "git+https://example.com/repo.git@at%40%20space#egg=my-package-1.0",
+        ),
+        # URL with Windows drive letter. The `:` after the drive
+        # letter should not be quoted. The trailing `/` should be
+        # removed.
+        pytest.param(
+            "file:///T:/path/with spaces/",
+            "file:///T:/path/with%20spaces",
+            marks=pytest.mark.skipif("sys.platform != 'win32'"),
+        ),
+        # URL with Windows drive letter, running on non-windows
+        # platform. The `:` after the drive should be quoted.
+        pytest.param(
+            "file:///T:/path/with spaces/",
+            "file:///T%3A/path/with%20spaces/",
+            marks=pytest.mark.skipif("sys.platform == 'win32'"),
+        ),
+        # Test a VCS URL with a Windows drive letter and revision.
+        pytest.param(
+            "git+file:///T:/with space/repo.git@1.0#egg=my-package-1.0",
+            "git+file:///T:/with%20space/repo.git@1.0#egg=my-package-1.0",
+            marks=pytest.mark.skipif("sys.platform != 'win32'"),
+        ),
+        # Test a VCS URL with a Windows drive letter and revision,
+        # running on non-windows platform.
+        pytest.param(
+            "git+file:///T:/with space/repo.git@1.0#egg=my-package-1.0",
+            "git+file:/T%3A/with%20space/repo.git@1.0#egg=my-package-1.0",
+            marks=pytest.mark.skipif("sys.platform == 'win32'"),
+        ),
+    ,
+)
+def test_ensure_quoted_url(url: str, clean_url: str) -> None:
+    assert _ensure_quoted_url(url) == clean_url
+
+
+def _test_parse_links_data_attribute(
+    anchor_html: str, attr: str, expected: Optionalstr
+) -> Link:
+    html = (
+        "<!DOCTYPE html>"
+        '<html><head><meta charset="utf-8"><head>'
+        "<body>{}</body></html>"
+    ).format(anchor_html)
+    html_bytes = html.encode("utf-8")
+    page = IndexContent(
+        html_bytes,
+        "text/html",
+        encoding=None,
+        # parse_links() is cached by url, so we inject a random uuid to ensure
+        # the page content isn't cached.
+        url=f"https://example.com/simple-{uuid.uuid4()}/",
+    )
+    links = list(parse_links(page))
+    (link,) = links
+    actual = getattr(link, attr)
+    assert actual == expected
+    return link
+
+
+@pytest.mark.parametrize(
+    "anchor_html, expected",
+    
+        # Test not present.
+        ('<a href="/pkg-1.0.tar.gz"></a>', None),
+        # Test present with no value.
+        ('<a href="/pkg-1.0.tar.gz" data-requires-python></a>', None),
+        # Test a value with an escaped character.
+        (
+            '<a href="/pkg-1.0.tar.gz" data-requires-python="&gt;=3.6"></a>',
+            ">=3.6",
+        ),
+        # Test requires python is unescaped once.
+        (
+            '<a href="/pkg-1.0.tar.gz" data-requires-python="&amp;gt;=3.6"></a>',
+            "&gt;=3.6",
+        ),
+    ,
+)
+def test_parse_links__requires_python(
+    anchor_html: str, expected: Optionalstr
+) -> None:
+    _test_parse_links_data_attribute(anchor_html, "requires_python", expected)
+
+
+# TODO: this test generates its own examples to validate the json client implementation
+# instead of sharing those examples with the html client testing. We expect this won't
+# hide any bugs because operations like resolving PEP 658 metadata should use the same
+# code for both types of indices, but it might be nice to explicitly have all our tests
+# in test_download.py execute over both html and json indices with
+# a pytest.mark.parameterize decorator to ensure nothing slips through the cracks.
+def test_parse_links_json() -> None:
+    json_bytes = json.dumps(
+        {
+            "meta": {"api-version": "1.0"},
+            "name": "holygrail",
+            "files": 
+                {
+                    "filename": "holygrail-1.0.tar.gz",
+                    "url": "https://example.com/files/holygrail-1.0.tar.gz",
+                    "hashes": {"sha256": "sha256 hash", "blake2b": "blake2b hash"},
+                    "requires-python": ">=3.7",
+                    "yanked": "Had a vulnerability",
+                },
+                {
+                    "filename": "holygrail-1.0-py3-none-any.whl",
+                    "url": "/files/holygrail-1.0-py3-none-any.whl",
+                    "hashes": {"sha256": "sha256 hash", "blake2b": "blake2b hash"},
+                    "requires-python": ">=3.7",
+                    "dist-info-metadata": False,
+                },
+                # Same as above, but parsing dist-info-metadata.
+                {
+                    "filename": "holygrail-1.0-py3-none-any.whl",
+                    "url": "/files/holygrail-1.0-py3-none-any.whl",
+                    "hashes": {"sha256": "sha256 hash", "blake2b": "blake2b hash"},
+                    "requires-python": ">=3.7",
+                    "dist-info-metadata": "sha512=aabdd41",
+                },
+            ,
+        }
+    ).encode("utf8")
+    page = IndexContent(
+        json_bytes,
+        "application/vnd.pypi.simple.v1+json",
+        encoding=None,
+        # parse_links() is cached by url, so we inject a random uuid to ensure
+        # the page content isn't cached.
+        url=f"https://example.com/simple-{uuid.uuid4()}/",
+    )
+    links = list(parse_links(page))
+
+    assert links == 
+        Link(
+            "https://example.com/files/holygrail-1.0.tar.gz",
+            comes_from=page.url,
+            requires_python=">=3.7",
+            yanked_reason="Had a vulnerability",
+            hashes={"sha256": "sha256 hash", "blake2b": "blake2b hash"},
+        ),
+        Link(
+            "https://example.com/files/holygrail-1.0-py3-none-any.whl",
+            comes_from=page.url,
+            requires_python=">=3.7",
+            yanked_reason=None,
+            hashes={"sha256": "sha256 hash", "blake2b": "blake2b hash"},
+        ),
+        Link(
+            "https://example.com/files/holygrail-1.0-py3-none-any.whl",
+            comes_from=page.url,
+            requires_python=">=3.7",
+            yanked_reason=None,
+            hashes={"sha256": "sha256 hash", "blake2b": "blake2b hash"},
+            dist_info_metadata="sha512=aabdd41",
+        ),
+    
+
+    # Ensure the metadata info can be parsed into the correct link.
+    metadata_link = links2.metadata_link()
+    assert metadata_link is not None
+    assert (
+        metadata_link.url
+        == "https://example.com/files/holygrail-1.0-py3-none-any.whl.metadata"
+    )
+    assert metadata_link._hashes == {"sha512": "aabdd41"}
+
+
+@pytest.mark.parametrize(
+    "anchor_html, expected",
+    
+        # Test not present.
+        ('<a href="/pkg1-1.0.tar.gz"></a>', None),
+        # Test present with no value.
+        ('<a href="/pkg2-1.0.tar.gz" data-yanked></a>', None),
+        # Test the empty string.
+        ('<a href="/pkg3-1.0.tar.gz" data-yanked=""></a>', ""),
+        # Test a non-empty string.
+        ('<a href="/pkg4-1.0.tar.gz" data-yanked="error"></a>', "error"),
+        # Test a value with an escaped character.
+        ('<a href="/pkg4-1.0.tar.gz" data-yanked="version &lt 1"></a>', "version < 1"),
+        # Test a yanked reason with a non-ascii character.
+        (
+            '<a href="/pkg-1.0.tar.gz" data-yanked="curlyquote \u2018"></a>',
+            "curlyquote \u2018",
+        ),
+        # Test yanked reason is unescaped once.
+        (
+            '<a href="/pkg-1.0.tar.gz" data-yanked="version &amp;lt; 1"></a>',
+            "version &lt; 1",
+        ),
+    ,
+)
+def test_parse_links__yanked_reason(anchor_html: str, expected: Optionalstr) -> None:
+    _test_parse_links_data_attribute(anchor_html, "yanked_reason", expected)
+
+
+# Requirement objects do not == each other unless they point to the same instance!
+_pkg1_requirement = Requirement("pkg1==1.0")
+
+
+@pytest.mark.parametrize(
+    "anchor_html, expected, hashes",
+    
+        # Test not present.
+        (
+            '<a href="/pkg1-1.0.tar.gz"></a>',
+            None,
+            {},
+        ),
+        # Test with value "true".
+        (
+            '<a href="/pkg1-1.0.tar.gz" data-dist-info-metadata="true"></a>',
+            "true",
+            {},
+        ),
+        # Test with a provided hash value.
+        (
+            '<a href="/pkg1-1.0.tar.gz" data-dist-info-metadata="sha256=aa113592bbe"></a>',  # noqa: E501
+            "sha256=aa113592bbe",
+            {},
+        ),
+        # Test with a provided hash value for both the requirement as well as metadata.
+        (
+            '<a href="/pkg1-1.0.tar.gz#sha512=abc132409cb" data-dist-info-metadata="sha256=aa113592bbe"></a>',  # noqa: E501
+            "sha256=aa113592bbe",
+            {"sha512": "abc132409cb"},
+        ),
+    ,
+)
+def test_parse_links__dist_info_metadata(
+    anchor_html: str,
+    expected: Optionalstr,
+    hashes: Dictstr, str,
+) -> None:
+    link = _test_parse_links_data_attribute(anchor_html, "dist_info_metadata", expected)
+    assert link._hashes == hashes
+
+
+def test_parse_links_caches_same_page_by_url() -> None:
+    html = (
+        "<!DOCTYPE html>"
+        '<html><head><meta charset="utf-8"><head>'
+        '<body><a href="/pkg1-1.0.tar.gz"></a></body></html>'
+    )
+    html_bytes = html.encode("utf-8")
+
+    url = "https://example.com/simple/"
+
+    page_1 = IndexContent(
+        html_bytes,
+        "text/html",
+        encoding=None,
+        url=url,
+    )
+    # Make a second page with zero content, to ensure that it's not accessed,
+    # because the page was cached by url.
+    page_2 = IndexContent(
+        b"",
+        "text/html",
+        encoding=None,
+        url=url,
+    )
+    # Make a third page which represents an index url, which should not be
+    # cached, even for the same url. We modify the page content slightly to
+    # verify that the result is not cached.
+    page_3 = IndexContent(
+        re.sub(b"pkg1", b"pkg2", html_bytes),
+        "text/html",
+        encoding=None,
+        url=url,
+        cache_link_parsing=False,
+    )
+
+    parsed_links_1 = list(parse_links(page_1))
+    assert len(parsed_links_1) == 1
+    assert "pkg1" in parsed_links_10.url
+
+    parsed_links_2 = list(parse_links(page_2))
+    assert parsed_links_2 == parsed_links_1
+
+    parsed_links_3 = list(parse_links(page_3))
+    assert len(parsed_links_3) == 1
+    assert parsed_links_3 != parsed_links_1
+    assert "pkg2" in parsed_links_30.url
+
+
+@mock.patch("pip._internal.index.collector.raise_for_status")
+def test_request_http_error(
+    mock_raise_for_status: mock.Mock, caplog: pytest.LogCaptureFixture
+) -> None:
+    caplog.set_level(logging.DEBUG)
+    link = Link("http://localhost")
+    session = mock.Mock(PipSession)
+    session.get.return_value = mock.Mock()
+    mock_raise_for_status.side_effect = NetworkConnectionError("Http error")
+    assert _get_index_content(link, session=session) is None
+    assert "Could not fetch URL http://localhost: Http error - skipping" in caplog.text
+
+
+def test_request_retries(caplog: pytest.LogCaptureFixture) -> None:
+    caplog.set_level(logging.DEBUG)
+    link = Link("http://localhost")
+    session = mock.Mock(PipSession)
+    session.get.side_effect = requests.exceptions.RetryError("Retry error")
+    assert _get_index_content(link, session=session) is None
+    assert "Could not fetch URL http://localhost: Retry error - skipping" in caplog.text
+
+
+def test_make_index_content() -> None:
+    headers = {"Content-Type": "text/html; charset=UTF-8"}
+    response = mock.Mock(
+        content=b"<content>",
+        url="https://example.com/index.html",
+        headers=headers,
+    )
+
+    actual = _make_index_content(response)
+    assert actual.content == b"<content>"
+    assert actual.encoding == "UTF-8"
+    assert actual.url == "https://example.com/index.html"
+
+
+@pytest.mark.parametrize(
+    "url, vcs_scheme",
+    
+        ("svn+http://pypi.org/something", "svn"),
+        ("git+https://github.com/pypa/pip.git", "git"),
+    ,
+)
+def test_get_index_content_invalid_scheme(
+    caplog: pytest.LogCaptureFixture, url: str, vcs_scheme: str
+) -> None:
+    """`_get_index_content()` should error if an invalid scheme is given.
+
+    Only file:, http:, https:, and ftp: are allowed.
+    """
+    with caplog.at_level(logging.WARNING):
+        page = _get_index_content(Link(url), session=mock.Mock(PipSession))
+
+    assert page is None
+    assert caplog.record_tuples == 
+        (
+            "pip._internal.index.collector",
+            logging.WARNING,
+            "Cannot look at {} URL {} because it does not support "
+            "lookup as web pages.".format(vcs_scheme, url),
+        ),
+    
+
+
+@pytest.mark.parametrize(
+    "content_type",
+    
+        "application/xhtml+xml",
+        "application/json",
+    ,
+)
+@mock.patch("pip._internal.index.collector.raise_for_status")
+def test_get_index_content_invalid_content_type(
+    mock_raise_for_status: mock.Mock,
+    caplog: pytest.LogCaptureFixture,
+    content_type: str,
+) -> None:
+    """`_get_index_content()` should warn if an invalid content-type is given.
+    Only text/html is allowed.
+    """
+    caplog.set_level(logging.DEBUG)
+    url = "https://pypi.org/simple/pip"
+    link = Link(url)
+
+    session = mock.Mock(PipSession)
+    session.get.return_value = mock.Mock(
+        **{
+            "request.method": "GET",
+            "headers": {"Content-Type": content_type},
+        }
+    )
+    assert _get_index_content(link, session=session) is None
+    mock_raise_for_status.assert_called_once_with(session.get.return_value)
+    assert (
+        "pip._internal.index.collector",
+        logging.WARNING,
+        "Skipping page {} because the GET request got Content-Type: {}. "
+        "The only supported Content-Types are application/vnd.pypi.simple.v1+json, "
+        "application/vnd.pypi.simple.v1+html, and text/html".format(url, content_type),
+    ) in caplog.record_tuples
+
+
+def make_fake_html_response(url: str) -> mock.Mock:
+    """
+    Create a fake requests.Response object.
+    """
+    html = dedent(
+        """\
+    <html><head><meta name="api-version" value="2" /></head>
+    <body>
+    <a href="/abc-1.0.tar.gz#md5=000000000">abc-1.0.tar.gz</a>
+    </body></html>
+    """
+    )
+    content = html.encode("utf-8")
+    return mock.Mock(content=content, url=url, headers={"Content-Type": "text/html"})
+
+
+def test_get_index_content_directory_append_index(tmpdir: Path) -> None:
+    """`_get_index_content()` should append "index.html" to a directory URL."""
+    dirpath = tmpdir / "something"
+    dirpath.mkdir()
+    dir_url = dirpath.as_uri()
+    expected_url = "{}/index.html".format(dir_url.rstrip("/"))
+
+    session = mock.Mock(PipSession)
+    fake_response = make_fake_html_response(expected_url)
+    mock_func = mock.patch("pip._internal.index.collector._get_simple_response")
+    with mock_func as mock_func:
+        mock_func.return_value = fake_response
+        actual = _get_index_content(Link(dir_url), session=session)
+        assert mock_func.mock_calls == 
+            mock.call(expected_url, session=session),
+        , f"actual calls: {mock_func.mock_calls}"
+
+        assert actual is not None
+        assert actual.content == fake_response.content
+        assert actual.encoding is None
+        assert actual.url == expected_url
+
+
+def test_collect_sources__file_expand_dir(data: TestData) -> None:
+    """
+    Test that a file:// dir from --find-links becomes _FlatDirectorySource
+    """
+    collector = LinkCollector.create(
+        session=mock.Mock(is_secure_origin=None),  # Shouldn't be used.
+        options=mock.Mock(
+            index_url="ignored-by-no-index",
+            extra_index_urls=,
+            no_index=True,
+            find_links=data.find_links,
+        ),
+    )
+    sources = collector.collect_sources(
+        # Shouldn't be used.
+        project_name=None,  # type: ignorearg-type
+        candidates_from_page=None,  # type: ignorearg-type
+    )
+    assert (
+        not sources.index_urls
+        and len(sources.find_links) == 1
+        and isinstance(sources.find_links0, _FlatDirectorySource)
+    ), (
+        "Directory source should have been found "
+        f"at find-links url: {data.find_links}"
+    )
+
+
+def test_collect_sources__file_not_find_link(data: TestData) -> None:
+    """
+    Test that a file:// dir from --index-url doesn't become _FlatDirectorySource
+    run
+    """
+    collector = LinkCollector.create(
+        session=mock.Mock(is_secure_origin=None),  # Shouldn't be used.
+        options=mock.Mock(
+            index_url=data.index_url("empty_with_pkg"),
+            extra_index_urls=,
+            no_index=False,
+            find_links=,
+        ),
+    )
+    sources = collector.collect_sources(
+        project_name="",
+        # Shouldn't be used.
+        candidates_from_page=None,  # type: ignorearg-type
+    )
+    assert (
+        not sources.find_links
+        and len(sources.index_urls) == 1
+        and isinstance(sources.index_urls0, _IndexDirectorySource)
+    ), "Directory specified as index should be treated as a page"
+
+
+def test_collect_sources__non_existing_path() -> None:
+    """
+    Test that a non-existing path is ignored.
+    """
+    collector = LinkCollector.create(
+        session=mock.Mock(is_secure_origin=None),  # Shouldn't be used.
+        options=mock.Mock(
+            index_url="ignored-by-no-index",
+            extra_index_urls=,
+            no_index=True,
+            find_links=os.path.join("this", "doesnt", "exist"),
+        ),
+    )
+    sources = collector.collect_sources(
+        # Shouldn't be used.
+        project_name=None,  # type: ignorearg-type
+        candidates_from_page=None,  # type: ignorearg-type
+    )
+    assert not sources.index_urls and sources.find_links == 
+        None
+    , "Nothing should have been found"
+
+
+def check_links_include(links: ListLink, names: Liststr) -> None:
+    """
+    Assert that the given list of Link objects includes, for each of the
+    given names, a link whose URL has a base name matching that name.
+    """
+    for name in names:
+        assert any(
+            link.url.endswith(name) for link in links
+        ), f"name {name!r} not among links: {links}"
+
+
+class TestLinkCollector:
+    @mock.patch("pip._internal.index.collector._get_simple_response")
+    def test_fetch_response(self, mock_get_simple_response: mock.Mock) -> None:
+        url = "https://pypi.org/simple/twine/"
+
+        fake_response = make_fake_html_response(url)
+        mock_get_simple_response.return_value = fake_response
+
+        location = Link(url, cache_link_parsing=False)
+        link_collector = make_test_link_collector()
+        actual = link_collector.fetch_response(location)
+
+        assert actual is not None
+        assert actual.content == fake_response.content
+        assert actual.encoding is None
+        assert actual.url == url
+        assert actual.cache_link_parsing == location.cache_link_parsing
+
+        # Also check that the right session object was passed to
+        # _get_simple_response().
+        mock_get_simple_response.assert_called_once_with(
+            url,
+            session=link_collector.session,
+        )
+
+    def test_collect_sources(
+        self, caplog: pytest.LogCaptureFixture, data: TestData
+    ) -> None:
+        caplog.set_level(logging.DEBUG)
+
+        link_collector = make_test_link_collector(
+            find_links=data.find_links,
+            # Include two copies of the URL to check that the second one
+            # is skipped.
+            index_urls=PyPI.simple_url, PyPI.simple_url,
+        )
+        collected_sources = link_collector.collect_sources(
+            "twine",
+            candidates_from_page=lambda link: 
+                InstallationCandidate("twine", "1.0", link)
+            ,
+        )
+
+        files_it = itertools.chain.from_iterable(
+            source.file_links()
+            for sources in collected_sources
+            for source in sources
+            if source is not None
+        )
+        pages_it = itertools.chain.from_iterable(
+            source.page_candidates()
+            for sources in collected_sources
+            for source in sources
+            if source is not None
+        )
+        files = list(files_it)
+        pages = list(pages_it)
+
+        # Spot-check the returned sources.
+        assert len(files) > 20
+        check_links_include(files, names="simple-1.0.tar.gz")
+
+        assert page.link for page in pages == Link("https://pypi.org/simple/twine/")
+        # Check that index URLs are marked as *un*cacheable.
+        assert not pages0.link.cache_link_parsing
+
+        expected_message = dedent(
+            """\
+        1 location(s) to search for versions of twine:
+        * https://pypi.org/simple/twine/"""
+        )
+        assert caplog.record_tuples == 
+            ("pip._internal.index.collector", logging.DEBUG, expected_message),
+        
+
+
+@pytest.mark.parametrize(
+    "find_links, no_index, suppress_no_index, expected",
+    
+        ("link1", False, False, ("link1", "default_url", "url1", "url2")),
+        ("link1", False, True, ("link1", "default_url", "url1", "url2")),
+        ("link1", True, False, ("link1", )),
+        # Passing suppress_no_index=True suppresses no_index=True.
+        ("link1", True, True, ("link1", "default_url", "url1", "url2")),
+        # Test options.find_links=False.
+        (False, False, False, (, "default_url", "url1", "url2")),
+    ,
+)
+def test_link_collector_create(
+    find_links: Liststr,
+    no_index: bool,
+    suppress_no_index: bool,
+    expected: TupleListstr, Liststr,
+) -> None:
+    """
+    :param expected: the expected (find_links, index_urls) values.
+    """
+    expected_find_links, expected_index_urls = expected
+    session = PipSession()
+    options = mock.Mock(
+        find_links=find_links,
+        index_url="default_url",
+        extra_index_urls="url1", "url2",
+        no_index=no_index,
+    )
+    link_collector = LinkCollector.create(
+        session,
+        options=options,
+        suppress_no_index=suppress_no_index,
+    )
+
+    assert link_collector.session is session
+
+    search_scope = link_collector.search_scope
+    assert search_scope.find_links == expected_find_links
+    assert search_scope.index_urls == expected_index_urls
+
+
+@mock.patch("os.path.expanduser")
+def test_link_collector_create_find_links_expansion(
+    mock_expanduser: mock.Mock, tmpdir: Path
+) -> None:
+    """
+    Test "~" expansion in --find-links paths.
+    """
+
+    # This is a mock version of expanduser() that expands "~" to the tmpdir.
+    def expand_path(path: str) -> str:
+        if path.startswith("~/"):
+            path = os.path.join(tmpdir, path2:)
+        return path
+
+    mock_expanduser.side_effect = expand_path
+
+    session = PipSession()
+    options = mock.Mock(
+        find_links="~/temp1", "~/temp2",
+        index_url="default_url",
+        extra_index_urls=,
+        no_index=False,
+    )
+    # Only create temp2 and not temp1 to test that "~" expansion only occurs
+    # when the directory exists.
+    temp2_dir = os.path.join(tmpdir, "temp2")
+    os.mkdir(temp2_dir)
+
+    link_collector = LinkCollector.create(session, options=options)
+
+    search_scope = link_collector.search_scope
+    # Only ~/temp2 gets expanded. Also, the path is normalized when expanded.
+    expected_temp2_dir = os.path.normcase(temp2_dir)
+    assert search_scope.find_links == "~/temp1", expected_temp2_dir
+    assert search_scope.index_urls == "default_url"
+
+
+@pytest.mark.parametrize(
+    "url, result",
+    
+        (
+            "https://pypi.org/pip-18.0.tar.gz#sha256=aa113592bbe",
+            LinkHash("sha256", "aa113592bbe"),
+        ),
+        (
+            "https://pypi.org/pip-18.0.tar.gz#sha256=aa113592bbe&subdirectory=setup",
+            LinkHash("sha256", "aa113592bbe"),
+        ),
+        (
+            "https://pypi.org/pip-18.0.tar.gz#subdirectory=setup&sha256=aa113592bbe",
+            LinkHash("sha256", "aa113592bbe"),
+        ),
+        # "xsha256" is not a valid algorithm, so we discard it.
+        ("https://pypi.org/pip-18.0.tar.gz#xsha256=aa113592bbe", None),
+        # Empty hash.
+        (
+            "https://pypi.org/pip-18.0.tar.gz#sha256=",
+            LinkHash("sha256", ""),
+        ),
+        (
+            "https://pypi.org/pip-18.0.tar.gz#md5=aa113592bbe",
+            LinkHash("md5", "aa113592bbe"),
+        ),
+        ("https://pypi.org/pip-18.0.tar.gz", None),
+        # We don't recognize the "sha500" algorithm, so we discard it.
+        ("https://pypi.org/pip-18.0.tar.gz#sha500=aa113592bbe", None),
+    ,
+)
+def test_link_hash_parsing(url: str, result: OptionalLinkHash) -> None:
+    assert LinkHash.find_hash_url_fragment(url) == result
+
+
+@pytest.mark.parametrize(
+    "dist_info_metadata, result",
+    
+        ("sha256=aa113592bbe", LinkHash("sha256", "aa113592bbe")),
+        ("sha256=", LinkHash("sha256", "")),
+        ("sha500=aa113592bbe", None),
+        ("true", None),
+        ("", None),
+        ("aa113592bbe", None),
+    ,
+)
+def test_pep658_hash_parsing(
+    dist_info_metadata: str, result: OptionalLinkHash
+) -> None:
+    assert LinkHash.parse_pep658_hash(dist_info_metadata) == result

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_command_install.py Added

@@ -0,0 +1,122 @@
+import errno
+from unittest import mock
+
+import pytest
+
+from pip._internal.commands import install
+from pip._internal.commands.install import create_os_error_message, decide_user_install
+
+
+class TestDecideUserInstall:
+    @mock.patch("site.ENABLE_USER_SITE", True)
+    @mock.patch("pip._internal.commands.install.site_packages_writable")
+    def test_prefix_and_target(self, sp_writable: mock.Mock) -> None:
+        sp_writable.return_value = False
+
+        assert decide_user_install(use_user_site=None, prefix_path="foo") is False
+
+        assert decide_user_install(use_user_site=None, target_dir="bar") is False
+
+    @pytest.mark.parametrize(
+        "enable_user_site,site_packages_writable,result",
+        
+            (True, True, False),
+            (True, False, True),
+            (False, True, False),
+            (False, False, False),
+        ,
+    )
+    def test_most_cases(
+        self,
+        enable_user_site: bool,
+        site_packages_writable: bool,
+        result: bool,
+        monkeypatch: pytest.MonkeyPatch,
+    ) -> None:
+        monkeypatch.setattr("site.ENABLE_USER_SITE", enable_user_site)
+        monkeypatch.setattr(
+            "pip._internal.commands.install.site_packages_writable",
+            lambda **kw: site_packages_writable,
+        )
+        assert decide_user_install(use_user_site=None) is result
+
+
+@pytest.mark.parametrize(
+    "error, show_traceback, using_user_site, expected",
+    
+        # show_traceback = True, using_user_site = True
+        (
+            OSError("Illegal byte sequence"),
+            True,
+            True,
+            "Could not install packages due to an OSError.\n",
+        ),
+        (
+            OSError(errno.EACCES, "No file permission"),
+            True,
+            True,
+            "Could"
+            " not install packages due to an OSError.\nCheck the"
+            " permissions.\n",
+        ),
+        # show_traceback = True, using_user_site = False
+        (
+            OSError("Illegal byte sequence"),
+            True,
+            False,
+            "Could not install packages due to an OSError.\n",
+        ),
+        (
+            OSError(errno.EACCES, "No file permission"),
+            True,
+            False,
+            "Could"
+            " not install packages due to an OSError.\nConsider using the"
+            " `--user` option or check the permissions.\n",
+        ),
+        # show_traceback = False, using_user_site = True
+        (
+            OSError("Illegal byte sequence"),
+            False,
+            True,
+            "Could not"
+            " install packages due to an OSError: Illegal byte"
+            " sequence\n",
+        ),
+        (
+            OSError(errno.EACCES, "No file permission"),
+            False,
+            True,
+            "Could"
+            " not install packages due to an OSError: Errno 13 No file"
+            " permission\nCheck the permissions.\n",
+        ),
+        # show_traceback = False, using_user_site = False
+        (
+            OSError("Illegal byte sequence"),
+            False,
+            False,
+            "Could not"
+            " install packages due to an OSError: Illegal byte sequence"
+            "\n",
+        ),
+        (
+            OSError(errno.EACCES, "No file permission"),
+            False,
+            False,
+            "Could not install packages due to an OSError: Errno 13 No"
+            " file permission\nConsider using the `--user` option or check the"
+            " permissions.\n",
+        ),
+    ,
+)
+def test_create_os_error_message(
+    monkeypatch: pytest.MonkeyPatch,
+    error: OSError,
+    show_traceback: bool,
+    using_user_site: bool,
+    expected: str,
+) -> None:
+    monkeypatch.setattr(install, "running_under_virtualenv", lambda: False)
+    msg = create_os_error_message(error, show_traceback, using_user_site)
+    assert msg == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_commands.py Added

@@ -0,0 +1,122 @@
+from typing import Callable, List
+from unittest import mock
+
+import pytest
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.req_command import (
+    IndexGroupCommand,
+    RequirementCommand,
+    SessionCommandMixin,
+)
+from pip._internal.commands import commands_dict, create_command
+
+# These are the expected names of the commands whose classes inherit from
+# IndexGroupCommand.
+EXPECTED_INDEX_GROUP_COMMANDS = "download", "index", "install", "list", "wheel"
+
+
+def check_commands(pred: CallableCommand, bool, expected: Liststr) -> None:
+    """
+    Check the commands satisfying a predicate.
+    """
+    commands = create_command(name) for name in sorted(commands_dict)
+    actual = command.name for command in commands if pred(command)
+    assert actual == expected, f"actual: {actual}"
+
+
+def test_commands_dict__order() -> None:
+    """
+    Check the ordering of commands_dict.
+    """
+    names = list(commands_dict)
+    # A spot-check is sufficient to check that commands_dict encodes an
+    # ordering.
+    assert names0 == "install"
+    assert names-1 == "help"
+
+
+@pytest.mark.parametrize("name", list(commands_dict))
+def test_create_command(name: str) -> None:
+    """Test creating an instance of each available command."""
+    command = create_command(name)
+    assert command.name == name
+    assert command.summary == commands_dictname.summary
+
+
+def test_session_commands() -> None:
+    """
+    Test which commands inherit from SessionCommandMixin.
+    """
+
+    def is_session_command(command: Command) -> bool:
+        return isinstance(command, SessionCommandMixin)
+
+    expected = "download", "index", "install", "list", "search", "uninstall", "wheel"
+    check_commands(is_session_command, expected)
+
+
+def test_index_group_commands() -> None:
+    """
+    Test the commands inheriting from IndexGroupCommand.
+    """
+
+    def is_index_group_command(command: Command) -> bool:
+        return isinstance(command, IndexGroupCommand)
+
+    check_commands(is_index_group_command, EXPECTED_INDEX_GROUP_COMMANDS)
+
+    # Also check that the commands inheriting from IndexGroupCommand are
+    # exactly the commands with the --no-index option.
+    def has_option_no_index(command: Command) -> bool:
+        return command.parser.has_option("--no-index")
+
+    check_commands(has_option_no_index, EXPECTED_INDEX_GROUP_COMMANDS)
+
+
+@pytest.mark.parametrize("command_name", EXPECTED_INDEX_GROUP_COMMANDS)
+@pytest.mark.parametrize(
+    "disable_pip_version_check, no_index, expected_called",
+    
+        # pip_self_version_check() is only called when both
+        # disable_pip_version_check and no_index are False.
+        (False, False, True),
+        (False, True, False),
+        (True, False, False),
+        (True, True, False),
+    ,
+)
+@mock.patch("pip._internal.cli.req_command.pip_self_version_check")
+def test_index_group_handle_pip_version_check(
+    mock_version_check: mock.Mock,
+    command_name: str,
+    disable_pip_version_check: bool,
+    no_index: bool,
+    expected_called: bool,
+) -> None:
+    """
+    Test whether pip_self_version_check() is called when
+    handle_pip_version_check() is called, for each of the
+    IndexGroupCommand classes.
+    """
+    command = create_command(command_name)
+    options = command.parser.get_default_values()
+    options.disable_pip_version_check = disable_pip_version_check
+    options.no_index = no_index
+
+    command.handle_pip_version_check(options)
+    if expected_called:
+        mock_version_check.assert_called_once()
+    else:
+        mock_version_check.assert_not_called()
+
+
+def test_requirement_commands() -> None:
+    """
+    Test which commands inherit from RequirementCommand.
+    """
+
+    def is_requirement_command(command: Command) -> bool:
+        return isinstance(command, RequirementCommand)
+
+    check_commands(is_requirement_command, "download", "install", "wheel")

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_compat.py Added

@@ -0,0 +1,46 @@
+import os
+from pathlib import Path
+
+import pytest
+
+from pip._internal.utils.compat import get_path_uid
+
+
+def test_get_path_uid() -> None:
+    path = os.getcwd()
+    assert get_path_uid(path) == os.stat(path).st_uid
+
+
+@pytest.mark.skipif("not hasattr(os, 'O_NOFOLLOW')")
+def test_get_path_uid_without_NOFOLLOW(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.delattr("os.O_NOFOLLOW")
+    path = os.getcwd()
+    assert get_path_uid(path) == os.stat(path).st_uid
+
+
+# Skip unconditionally on Windows, as symlinks need admin privs there
+@pytest.mark.skipif("sys.platform == 'win32'")
+@pytest.mark.skipif("not hasattr(os, 'symlink')")
+def test_get_path_uid_symlink(tmpdir: Path) -> None:
+    f = tmpdir / "symlink" / "somefile"
+    f.parent.mkdir()
+    f.write_text("content")
+    fs = f"{f}_link"
+    os.symlink(f, fs)
+    with pytest.raises(OSError):
+        get_path_uid(fs)
+
+
+@pytest.mark.skipif("not hasattr(os, 'O_NOFOLLOW')")
+@pytest.mark.skipif("not hasattr(os, 'symlink')")
+def test_get_path_uid_symlink_without_NOFOLLOW(
+    tmpdir: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    monkeypatch.delattr("os.O_NOFOLLOW")
+    f = tmpdir / "symlink" / "somefile"
+    f.parent.mkdir()
+    f.write_text("content")
+    fs = f"{f}_link"
+    os.symlink(f, fs)
+    with pytest.raises(OSError):
+        get_path_uid(fs)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_configuration.py Added

@@ -0,0 +1,272 @@
+"""Tests for all things related to the configuration
+"""
+
+import re
+from unittest.mock import MagicMock
+
+import pytest
+
+from pip._internal.configuration import get_configuration_files, kinds
+from pip._internal.exceptions import ConfigurationError
+from tests.lib.configuration_helpers import ConfigurationMixin
+
+
+class TestConfigurationLoading(ConfigurationMixin):
+    def test_global_loading(self) -> None:
+        self.patch_configuration(kinds.GLOBAL, {"test.hello": "1"})
+
+        self.configuration.load()
+        assert self.configuration.get_value("test.hello") == "1"
+
+    def test_user_loading(self) -> None:
+        self.patch_configuration(kinds.USER, {"test.hello": "2"})
+
+        self.configuration.load()
+        assert self.configuration.get_value("test.hello") == "2"
+
+    def test_site_loading(self) -> None:
+        self.patch_configuration(kinds.SITE, {"test.hello": "3"})
+
+        self.configuration.load()
+        assert self.configuration.get_value("test.hello") == "3"
+
+    def test_environment_config_loading(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        contents = """
+            test
+            hello = 4
+        """
+
+        with self.tmpfile(contents) as config_file:
+            monkeypatch.setenv("PIP_CONFIG_FILE", config_file)
+
+            self.configuration.load()
+            assert (
+                self.configuration.get_value("test.hello") == "4"
+            ), self.configuration._config
+
+    def test_environment_var_loading(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setenv("PIP_HELLO", "5")
+
+        self.configuration.load()
+        assert self.configuration.get_value(":env:.hello") == "5"
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_environment_var_does_not_load_lowercase(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("pip_hello", "5")
+
+        self.configuration.load()
+        with pytest.raises(ConfigurationError):
+            self.configuration.get_value(":env:.hello")
+
+    def test_environment_var_does_not_load_version(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("PIP_VERSION", "True")
+
+        self.configuration.load()
+
+        with pytest.raises(ConfigurationError):
+            self.configuration.get_value(":env:.version")
+
+    def test_environment_config_errors_if_malformed(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        contents = """
+            test
+            hello = 4
+        """
+        with self.tmpfile(contents) as config_file:
+            monkeypatch.setenv("PIP_CONFIG_FILE", config_file)
+            with pytest.raises(ConfigurationError) as err:
+                self.configuration.load()
+
+        assert "section header" in str(err.value)  # error kind
+        assert "1" in str(err.value)  # line number
+        assert config_file in str(err.value) or repr(config_file) in str(  # file name
+            err.value
+        )
+
+    def test_no_such_key_error_message_no_command(self) -> None:
+        self.configuration.load_only = kinds.GLOBAL
+        self.configuration.load()
+        expected_msg = (
+            "Key does not contain dot separated section and key. "
+            "Perhaps you wanted to use 'global.index-url' instead?"
+        )
+        pat = f"^{re.escape(expected_msg)}$"
+        with pytest.raises(ConfigurationError, match=pat):
+            self.configuration.get_value("index-url")
+
+    def test_no_such_key_error_message_missing_option(self) -> None:
+        self.configuration.load_only = kinds.GLOBAL
+        self.configuration.load()
+        expected_msg = "No such key - global.index-url"
+        pat = f"^{re.escape(expected_msg)}$"
+        with pytest.raises(ConfigurationError, match=pat):
+            self.configuration.get_value("global.index-url")
+
+
+class TestConfigurationPrecedence(ConfigurationMixin):
+    # Tests for methods to that determine the order of precedence of
+    # configuration options
+
+    def test_env_overides_site(self) -> None:
+        self.patch_configuration(kinds.SITE, {"test.hello": "1"})
+        self.patch_configuration(kinds.ENV, {"test.hello": "0"})
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "0"
+
+    def test_env_overides_user(self) -> None:
+        self.patch_configuration(kinds.USER, {"test.hello": "2"})
+        self.patch_configuration(kinds.ENV, {"test.hello": "0"})
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "0"
+
+    def test_env_overides_global(self) -> None:
+        self.patch_configuration(kinds.GLOBAL, {"test.hello": "3"})
+        self.patch_configuration(kinds.ENV, {"test.hello": "0"})
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "0"
+
+    def test_site_overides_user(self) -> None:
+        self.patch_configuration(kinds.USER, {"test.hello": "2"})
+        self.patch_configuration(kinds.SITE, {"test.hello": "1"})
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "1"
+
+    def test_site_overides_global(self) -> None:
+        self.patch_configuration(kinds.GLOBAL, {"test.hello": "3"})
+        self.patch_configuration(kinds.SITE, {"test.hello": "1"})
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "1"
+
+    def test_user_overides_global(self) -> None:
+        self.patch_configuration(kinds.GLOBAL, {"test.hello": "3"})
+        self.patch_configuration(kinds.USER, {"test.hello": "2"})
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "2"
+
+    def test_env_not_overriden_by_environment_var(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        self.patch_configuration(kinds.ENV, {"test.hello": "1"})
+        monkeypatch.setenv("PIP_HELLO", "5")
+
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "1"
+        assert self.configuration.get_value(":env:.hello") == "5"
+
+    def test_site_not_overriden_by_environment_var(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        self.patch_configuration(kinds.SITE, {"test.hello": "2"})
+        monkeypatch.setenv("PIP_HELLO", "5")
+
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "2"
+        assert self.configuration.get_value(":env:.hello") == "5"
+
+    def test_user_not_overriden_by_environment_var(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        self.patch_configuration(kinds.USER, {"test.hello": "3"})
+        monkeypatch.setenv("PIP_HELLO", "5")
+
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "3"
+        assert self.configuration.get_value(":env:.hello") == "5"
+
+    def test_global_not_overriden_by_environment_var(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        self.patch_configuration(kinds.GLOBAL, {"test.hello": "4"})
+        monkeypatch.setenv("PIP_HELLO", "5")
+
+        self.configuration.load()
+
+        assert self.configuration.get_value("test.hello") == "4"
+        assert self.configuration.get_value(":env:.hello") == "5"
+
+
+class TestConfigurationModification(ConfigurationMixin):
+    # Tests for methods to that modify the state of a Configuration
+
+    def test_no_specific_given_modification(self) -> None:
+        self.configuration.load()
+
+        with pytest.raises(ConfigurationError):
+            self.configuration.set_value("test.hello", "10")
+
+    def test_site_modification(self) -> None:
+        self.configuration.load_only = kinds.SITE
+        self.configuration.load()
+
+        # Mock out the method
+        mymock = MagicMock(spec=self.configuration._mark_as_modified)
+        # https://github.com/python/mypy/issues/2427
+        self.configuration._mark_as_modified = mymock  # type: ignoreassignment
+
+        self.configuration.set_value("test.hello", "10")
+
+        # get the path to site config file
+        assert mymock.call_count == 1
+        assert mymock.call_args00 == (get_configuration_files()kinds.SITE0)
+
+    def test_user_modification(self) -> None:
+        # get the path to local config file
+        self.configuration.load_only = kinds.USER
+        self.configuration.load()
+
+        # Mock out the method
+        mymock = MagicMock(spec=self.configuration._mark_as_modified)
+        # https://github.com/python/mypy/issues/2427
+        self.configuration._mark_as_modified = mymock  # type: ignoreassignment
+
+        self.configuration.set_value("test.hello", "10")
+
+        # get the path to user config file
+        assert mymock.call_count == 1
+        assert mymock.call_args00 == (
+            # Use new config file
+            get_configuration_files()kinds.USER1
+        )
+
+    def test_global_modification(self) -> None:
+        # get the path to local config file
+        self.configuration.load_only = kinds.GLOBAL
+        self.configuration.load()
+
+        # Mock out the method
+        mymock = MagicMock(spec=self.configuration._mark_as_modified)
+        # https://github.com/python/mypy/issues/2427
+        self.configuration._mark_as_modified = mymock  # type: ignoreassignment
+
+        self.configuration.set_value("test.hello", "10")
+
+        # get the path to user config file
+        assert mymock.call_count == 1
+        assert mymock.call_args00 == (get_configuration_files()kinds.GLOBAL-1)
+
+    def test_normalization(self) -> None:
+        # underscores and dashes can be used interchangeably.
+        # internally, underscores get converted into dashes before reading/writing file
+        self.configuration.load_only = kinds.GLOBAL
+        self.configuration.load()
+        self.configuration.set_value("global.index_url", "example.org")
+        assert self.configuration.get_value("global.index_url") == "example.org"
+        assert self.configuration.get_value("global.index-url") == "example.org"
+        self.configuration.unset_value("global.index-url")
+        pat = r"^No such key - global\.index-url$"
+        with pytest.raises(ConfigurationError, match=pat):
+            self.configuration.get_value("global.index-url")

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_direct_url.py Added

@@ -0,0 +1,172 @@
+import pytest
+
+from pip._internal.models.direct_url import (
+    ArchiveInfo,
+    DirectUrl,
+    DirectUrlValidationError,
+    DirInfo,
+    VcsInfo,
+)
+
+
+def test_from_json() -> None:
+    json = '{"url": "file:///home/user/project", "dir_info": {}}'
+    direct_url = DirectUrl.from_json(json)
+    assert direct_url.url == "file:///home/user/project"
+    assert isinstance(direct_url.info, DirInfo)
+    assert direct_url.info.editable is False
+
+
+def test_to_json() -> None:
+    direct_url = DirectUrl(
+        url="file:///home/user/archive.tgz",
+        info=ArchiveInfo(),
+    )
+    direct_url.validate()
+    assert direct_url.to_json() == (
+        '{"archive_info": {}, "url": "file:///home/user/archive.tgz"}'
+    )
+
+
+def test_archive_info() -> None:
+    direct_url_dict = {
+        "url": "file:///home/user/archive.tgz",
+        "archive_info": {"hash": "sha1=1b8c5bc61a86f377fea47b4276c8c8a5842d2220"},
+    }
+    direct_url = DirectUrl.from_dict(direct_url_dict)
+    assert isinstance(direct_url.info, ArchiveInfo)
+    assert direct_url.url == direct_url_dict"url"
+    assert (
+        direct_url.info.hash == direct_url_dict"archive_info""hash"  # type: ignore
+    )
+    # test we add the hashes key automatically
+    direct_url_dict"archive_info""hashes" = {  # type: ignore
+        "sha1": "1b8c5bc61a86f377fea47b4276c8c8a5842d2220"
+    }
+    assert direct_url.to_dict() == direct_url_dict
+
+
+def test_dir_info() -> None:
+    direct_url_dict = {
+        "url": "file:///home/user/project",
+        "dir_info": {"editable": True},
+    }
+    direct_url = DirectUrl.from_dict(direct_url_dict)
+    assert isinstance(direct_url.info, DirInfo)
+    assert direct_url.url == direct_url_dict"url"
+    assert direct_url.info.editable is True
+    assert direct_url.to_dict() == direct_url_dict
+    # test editable default to False
+    direct_url_dict = {"url": "file:///home/user/project", "dir_info": {}}
+    direct_url = DirectUrl.from_dict(direct_url_dict)
+    assert isinstance(direct_url.info, DirInfo)
+    assert direct_url.info.editable is False
+
+
+def test_vcs_info() -> None:
+    direct_url_dict = {
+        "url": "https:///g.c/u/p.git",
+        "vcs_info": {
+            "vcs": "git",
+            "requested_revision": "master",
+            "commit_id": "1b8c5bc61a86f377fea47b4276c8c8a5842d2220",
+        },
+    }
+    direct_url = DirectUrl.from_dict(direct_url_dict)
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.url == direct_url_dict"url"
+    assert direct_url.info.vcs == "git"
+    assert direct_url.info.requested_revision == "master"
+    assert direct_url.info.commit_id == "1b8c5bc61a86f377fea47b4276c8c8a5842d2220"
+    assert direct_url.to_dict() == direct_url_dict
+
+
+def test_parsing_validation() -> None:
+    with pytest.raises(DirectUrlValidationError, match="url must have a value"):
+        DirectUrl.from_dict({"dir_info": {}})
+    with pytest.raises(
+        DirectUrlValidationError,
+        match="missing one of archive_info, dir_info, vcs_info",
+    ):
+        DirectUrl.from_dict({"url": "http://..."})
+    with pytest.raises(DirectUrlValidationError, match="unexpected type for editable"):
+        DirectUrl.from_dict({"url": "http://...", "dir_info": {"editable": "false"}})
+    with pytest.raises(DirectUrlValidationError, match="unexpected type for hash"):
+        DirectUrl.from_dict({"url": "http://...", "archive_info": {"hash": 1}})
+    with pytest.raises(DirectUrlValidationError, match="unexpected type for vcs"):
+        DirectUrl.from_dict({"url": "http://...", "vcs_info": {"vcs": None}})
+    with pytest.raises(DirectUrlValidationError, match="commit_id must have a value"):
+        DirectUrl.from_dict({"url": "http://...", "vcs_info": {"vcs": "git"}})
+    with pytest.raises(
+        DirectUrlValidationError,
+        match="more than one of archive_info, dir_info, vcs_info",
+    ):
+        DirectUrl.from_dict({"url": "http://...", "dir_info": {}, "archive_info": {}})
+    with pytest.raises(
+        DirectUrlValidationError,
+        match="invalid archive_info.hash format",
+    ):
+        DirectUrl.from_dict(
+            {"url": "http://...", "archive_info": {"hash": "sha256:aaa"}}
+        )
+
+
+def test_redact_url() -> None:
+    def _redact_git(url: str) -> str:
+        direct_url = DirectUrl(
+            url=url,
+            info=VcsInfo(vcs="git", commit_id="1"),
+        )
+        return direct_url.redacted_url
+
+    def _redact_archive(url: str) -> str:
+        direct_url = DirectUrl(
+            url=url,
+            info=ArchiveInfo(),
+        )
+        return direct_url.redacted_url
+
+    assert (
+        _redact_git("https://user:password@g.c/u/p.git@branch#egg=pkg")
+        == "https://g.c/u/p.git@branch#egg=pkg"
+    )
+    assert _redact_git("https://${USER}:password@g.c/u/p.git") == "https://g.c/u/p.git"
+    assert (
+        _redact_archive("file://${U}:${PIP_PASSWORD}@g.c/u/p.tgz")
+        == "file://${U}:${PIP_PASSWORD}@g.c/u/p.tgz"
+    )
+    assert (
+        _redact_git("https://${PIP_TOKEN}@g.c/u/p.git")
+        == "https://${PIP_TOKEN}@g.c/u/p.git"
+    )
+    assert _redact_git("ssh://git@g.c/u/p.git") == "ssh://git@g.c/u/p.git"
+
+
+def test_hash_to_hashes() -> None:
+    direct_url = DirectUrl(url="https://e.c/archive.tar.gz", info=ArchiveInfo())
+    assert isinstance(direct_url.info, ArchiveInfo)
+    direct_url.info.hash = "sha256=abcdef"
+    assert direct_url.info.hashes == {"sha256": "abcdef"}
+
+
+def test_hash_to_hashes_constructor() -> None:
+    direct_url = DirectUrl(
+        url="https://e.c/archive.tar.gz", info=ArchiveInfo(hash="sha256=abcdef")
+    )
+    assert isinstance(direct_url.info, ArchiveInfo)
+    assert direct_url.info.hashes == {"sha256": "abcdef"}
+    direct_url = DirectUrl(
+        url="https://e.c/archive.tar.gz",
+        info=ArchiveInfo(hash="sha256=abcdef", hashes={"sha512": "123456"}),
+    )
+    assert isinstance(direct_url.info, ArchiveInfo)
+    assert direct_url.info.hashes == {"sha256": "abcdef", "sha512": "123456"}
+    # In case of conflict between hash and hashes, hashes wins.
+    direct_url = DirectUrl(
+        url="https://e.c/archive.tar.gz",
+        info=ArchiveInfo(
+            hash="sha256=abcdef", hashes={"sha256": "012345", "sha512": "123456"}
+        ),
+    )
+    assert isinstance(direct_url.info, ArchiveInfo)
+    assert direct_url.info.hashes == {"sha256": "012345", "sha512": "123456"}

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_direct_url_helpers.py Added

@@ -0,0 +1,174 @@
+import os
+from functools import partial
+from pathlib import Path
+from unittest import mock
+
+from pip._internal.models.direct_url import ArchiveInfo, DirectUrl, DirInfo, VcsInfo
+from pip._internal.models.link import Link
+from pip._internal.utils.direct_url_helpers import (
+    direct_url_as_pep440_direct_reference,
+    direct_url_from_link,
+)
+from pip._internal.vcs.git import Git
+
+
+def test_as_pep440_requirement_archive() -> None:
+    direct_url = DirectUrl(
+        url="file:///home/user/archive.tgz",
+        info=ArchiveInfo(),
+    )
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ file:///home/user/archive.tgz"
+    )
+    direct_url.subdirectory = "subdir"
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ file:///home/user/archive.tgz#subdirectory=subdir"
+    )
+    assert isinstance(direct_url.info, ArchiveInfo)
+    direct_url.info.hash = "sha1=1b8c5bc61a86f377fea47b4276c8c8a5842d2220"
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ file:///home/user/archive.tgz"
+        "#sha1=1b8c5bc61a86f377fea47b4276c8c8a5842d2220&subdirectory=subdir"
+    )
+
+
+def test_as_pep440_requirement_dir() -> None:
+    direct_url = DirectUrl(
+        url="file:///home/user/project",
+        info=DirInfo(editable=False),
+    )
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ file:///home/user/project"
+    )
+
+
+def test_as_pep440_requirement_editable_dir() -> None:
+    # direct_url_as_pep440_direct_reference behaves the same
+    # irrespective of the editable flag. It's the responsibility of
+    # callers to render it as editable
+    direct_url = DirectUrl(
+        url="file:///home/user/project",
+        info=DirInfo(editable=True),
+    )
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ file:///home/user/project"
+    )
+
+
+def test_as_pep440_requirement_vcs() -> None:
+    direct_url = DirectUrl(
+        url="https:///g.c/u/p.git",
+        info=VcsInfo(vcs="git", commit_id="1b8c5bc61a86f377fea47b4276c8c8a5842d2220"),
+    )
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ git+https:///g.c/u/p.git"
+        "@1b8c5bc61a86f377fea47b4276c8c8a5842d2220"
+    )
+    direct_url.subdirectory = "subdir"
+    direct_url.validate()
+    assert (
+        direct_url_as_pep440_direct_reference(direct_url, "pkg")
+        == "pkg @ git+https:///g.c/u/p.git"
+        "@1b8c5bc61a86f377fea47b4276c8c8a5842d2220#subdirectory=subdir"
+    )
+
+
+@mock.patch("pip._internal.vcs.git.Git.get_revision")
+def test_from_link_vcs(mock_get_backend_for_scheme: mock.Mock) -> None:
+    _direct_url_from_link = partial(direct_url_from_link, source_dir="...")
+    direct_url = _direct_url_from_link(Link("git+https://g.c/u/p.git"))
+    assert direct_url.url == "https://g.c/u/p.git"
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.info.vcs == "git"
+    direct_url = _direct_url_from_link(Link("git+https://g.c/u/p.git#egg=pkg"))
+    assert direct_url.url == "https://g.c/u/p.git"
+    direct_url = _direct_url_from_link(
+        Link("git+https://g.c/u/p.git#egg=pkg&subdirectory=subdir")
+    )
+    assert direct_url.url == "https://g.c/u/p.git"
+    assert direct_url.subdirectory == "subdir"
+    direct_url = _direct_url_from_link(Link("git+https://g.c/u/p.git@branch"))
+    assert direct_url.url == "https://g.c/u/p.git"
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.info.requested_revision == "branch"
+    direct_url = _direct_url_from_link(Link("git+https://g.c/u/p.git@branch#egg=pkg"))
+    assert direct_url.url == "https://g.c/u/p.git"
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.info.requested_revision == "branch"
+    direct_url = _direct_url_from_link(Link("git+https://token@g.c/u/p.git"))
+    assert direct_url.to_dict()"url" == "https://g.c/u/p.git"
+
+
+def test_from_link_vcs_with_source_dir_obtains_commit_id(tmpdir: Path) -> None:
+    repo_path = tmpdir / "test-repo"
+    repo_path.mkdir()
+    repo_dir = os.fspath(repo_path)
+    Git.run_command("init", cwd=repo_dir)
+    (repo_path / "somefile").touch()
+    Git.run_command("add", ".", cwd=repo_dir)
+    Git.run_command("commit", "-m", "commit msg", cwd=repo_dir)
+    commit_id = Git.get_revision(repo_dir)
+    direct_url = direct_url_from_link(
+        Link("git+https://g.c/u/p.git"), source_dir=repo_dir
+    )
+    assert direct_url.url == "https://g.c/u/p.git"
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.info.commit_id == commit_id
+
+
+def test_from_link_vcs_without_source_dir() -> None:
+    direct_url = direct_url_from_link(
+        Link("git+https://g.c/u/p.git@1"), link_is_in_wheel_cache=True
+    )
+    assert direct_url.url == "https://g.c/u/p.git"
+    assert isinstance(direct_url.info, VcsInfo)
+    assert direct_url.info.commit_id == "1"
+
+
+def test_from_link_archive() -> None:
+    direct_url = direct_url_from_link(Link("https://g.c/archive.tgz"))
+    assert direct_url.url == "https://g.c/archive.tgz"
+    assert isinstance(direct_url.info, ArchiveInfo)
+    direct_url = direct_url_from_link(
+        Link("https://g.c/archive.tgz#sha1=1b8c5bc61a86f377fea47b4276c8c8a5842d2220")
+    )
+    assert isinstance(direct_url.info, ArchiveInfo)
+    assert direct_url.info.hash == "sha1=1b8c5bc61a86f377fea47b4276c8c8a5842d2220"
+    # Test the hashes key has been automatically populated.
+    assert direct_url.info.hashes == {
+        "sha1": "1b8c5bc61a86f377fea47b4276c8c8a5842d2220"
+    }
+
+
+def test_from_link_dir(tmpdir: Path) -> None:
+    dir_url = tmpdir.as_uri()
+    direct_url = direct_url_from_link(Link(dir_url))
+    assert direct_url.url == dir_url
+    assert isinstance(direct_url.info, DirInfo)
+
+
+def test_from_link_hide_user_password() -> None:
+    # Basic test only here, other variants are covered by
+    # direct_url.redact_url tests.
+    direct_url = direct_url_from_link(
+        Link("git+https://user:password@g.c/u/p.git@branch#egg=pkg"),
+        link_is_in_wheel_cache=True,
+    )
+    assert direct_url.to_dict()"url" == "https://g.c/u/p.git"
+    direct_url = direct_url_from_link(
+        Link("git+ssh://git@g.c/u/p.git@branch#egg=pkg"),
+        link_is_in_wheel_cache=True,
+    )
+    assert direct_url.to_dict()"url" == "ssh://git@g.c/u/p.git"

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_exceptions.py Added

@@ -0,0 +1,654 @@
+"""Tests the presentation style of exceptions."""
+
+import io
+import locale
+import logging
+import pathlib
+import sys
+import textwrap
+from typing import Optional, Tuple
+
+import pytest
+from pip._vendor import rich
+
+from pip._internal.exceptions import DiagnosticPipError, ExternallyManagedEnvironment
+
+
+class TestDiagnosticPipErrorCreation:
+    def test_fails_without_reference(self) -> None:
+        class DerivedError(DiagnosticPipError):
+            pass
+
+        with pytest.raises(AssertionError) as exc_info:
+            DerivedError(message="", context=None, hint_stmt=None)
+
+        assert str(exc_info.value) == "error reference not provided!"
+
+    def test_can_fetch_reference_from_subclass(self) -> None:
+        class DerivedError(DiagnosticPipError):
+            reference = "subclass-reference"
+
+        obj = DerivedError(message="", context=None, hint_stmt=None)
+        assert obj.reference == "subclass-reference"
+
+    def test_can_fetch_reference_from_arguments(self) -> None:
+        class DerivedError(DiagnosticPipError):
+            pass
+
+        obj = DerivedError(
+            message="", context=None, hint_stmt=None, reference="subclass-reference"
+        )
+        assert obj.reference == "subclass-reference"
+
+    @pytest.mark.parametrize(
+        "name",
+        
+            "BADNAME",
+            "BadName",
+            "bad_name",
+            "BAD_NAME",
+            "_bad",
+            "bad-name-",
+            "bad--name",
+            "-bad-name",
+            "bad-name-due-to-1-number",
+        ,
+    )
+    def test_rejects_non_kebab_case_names(self, name: str) -> None:
+        class DerivedError(DiagnosticPipError):
+            reference = name
+
+        with pytest.raises(AssertionError) as exc_info:
+            DerivedError(message="", context=None, hint_stmt=None)
+
+        assert str(exc_info.value) == "error reference must be kebab-case!"
+
+
+def rendered_in_ascii(error: DiagnosticPipError, *, color: bool = False) -> str:
+    with io.BytesIO() as stream:
+        console = rich.console.Console(
+            force_terminal=False,
+            file=io.TextIOWrapper(stream, encoding="ascii", newline=""),
+            color_system="truecolor" if color else None,
+        )
+        console.print(error)
+        return stream.getvalue().decode("ascii")
+
+
+class TestDiagnosticPipErrorPresentation_ASCII:
+    def test_complete(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            Something went wrong
+            very wrong.
+
+            note: You did something wrong, which is what caused this error.
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_complete_color(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke.",
+            context="Something went wrong\nvery wrong.",
+            note_stmt="You did something wrong.",
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        def esc(code: str = "0") -> str:
+            return f"\x1b{code}m"
+
+        assert rendered_in_ascii(err, color=True) == textwrap.dedent(
+            f"""\
+            {esc("1;31")}error{esc("0")}: {esc("1")}test-diagnostic{esc("0")}
+
+            Oh no!
+            It broke.
+
+            Something went wrong
+            very wrong.
+
+            {esc("1;35")}note{esc("0")}: You did something wrong.
+            {esc("1;36")}hint{esc("0")}: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_context(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            note: You did something wrong, which is what caused this error.
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_note(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt=None,
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            Something went wrong
+            very wrong.
+
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_hint(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt=None,
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            Something went wrong
+            very wrong.
+
+            note: You did something wrong, which is what caused this error.
+            """
+        )
+
+    def test_no_context_no_hint(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt=None,
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            note: You did something wrong, which is what caused this error.
+            """
+        )
+
+    def test_no_context_no_note(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            note_stmt=None,
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_hint_no_note(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt=None,
+            hint_stmt=None,
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+
+            Something went wrong
+            very wrong.
+            """
+        )
+
+    def test_no_hint_no_note_no_context(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            hint_stmt=None,
+            note_stmt=None,
+        )
+
+        assert rendered_in_ascii(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            Oh no!
+            It broke. :(
+            """
+        )
+
+
+def rendered(error: DiagnosticPipError, *, color: bool = False) -> str:
+    with io.StringIO() as stream:
+        console = rich.console.Console(
+            force_terminal=False,
+            file=stream,
+            color_system="truecolor" if color else None,
+        )
+        console.print(error)
+        return stream.getvalue()
+
+
+class TestDiagnosticPipErrorPresentation_Unicode:
+    def test_complete(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+            │ It broke. :(
+            ╰─> Something went wrong
+                very wrong.
+
+            note: You did something wrong, which is what caused this error.
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_complete_color(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke.",
+            context="Something went wrong\nvery wrong.",
+            note_stmt="You did something wrong.",
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        def esc(code: str = "0") -> str:
+            return f"\x1b{code}m"
+
+        assert rendered(err, color=True) == textwrap.dedent(
+            f"""\
+            {esc("1;31")}error{esc("0")}: {esc("1")}test-diagnostic{esc("0")}
+
+            {esc("31")}×{esc("0")} Oh no!
+            {esc("31")}│{esc("0")} It broke.
+            {esc("31")}╰─>{esc("0")} Something went wrong
+            {esc("31")}   {esc("0")} very wrong.
+
+            {esc("1;35")}note{esc("0")}: You did something wrong.
+            {esc("1;36")}hint{esc("0")}: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_context(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+              It broke. :(
+
+            note: You did something wrong, which is what caused this error.
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_note(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt=None,
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+            │ It broke. :(
+            ╰─> Something went wrong
+                very wrong.
+
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_hint(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt=None,
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+            │ It broke. :(
+            ╰─> Something went wrong
+                very wrong.
+
+            note: You did something wrong, which is what caused this error.
+            """
+        )
+
+    def test_no_context_no_hint(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            note_stmt="You did something wrong, which is what caused this error.",
+            hint_stmt=None,
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+              It broke. :(
+
+            note: You did something wrong, which is what caused this error.
+            """
+        )
+
+    def test_no_context_no_note(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            note_stmt=None,
+            hint_stmt="Do it better next time, by trying harder.",
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+              It broke. :(
+
+            hint: Do it better next time, by trying harder.
+            """
+        )
+
+    def test_no_hint_no_note(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context="Something went wrong\nvery wrong.",
+            note_stmt=None,
+            hint_stmt=None,
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+            │ It broke. :(
+            ╰─> Something went wrong
+                very wrong.
+            """
+        )
+
+    def test_no_hint_no_note_no_context(self) -> None:
+        err = DiagnosticPipError(
+            reference="test-diagnostic",
+            message="Oh no!\nIt broke. :(",
+            context=None,
+            hint_stmt=None,
+            note_stmt=None,
+        )
+
+        assert rendered(err) == textwrap.dedent(
+            """\
+            error: test-diagnostic
+
+            × Oh no!
+              It broke. :(
+            """
+        )
+
+
+class TestExternallyManagedEnvironment:
+    default_text = (
+        f"The Python environment under {sys.prefix} is managed externally, "
+        f"and may not be\nmanipulated by the user. Please use specific "
+        f"tooling from the distributor of\nthe Python installation to "
+        f"interact with this environment instead.\n"
+    )
+
+    @pytest.fixture(autouse=True)
+    def patch_locale(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        orig_getlocal = locale.getlocale
+
+        def fake_getlocale(category: int) -> TupleOptionalstr, Optionalstr:
+            """Fake getlocale() that always reports zh_Hant for LC_MESSASGES."""
+            result = orig_getlocal(category)
+            if category == getattr(locale, "LC_MESSAGES", None):
+                return "zh_Hant", result1
+            return result
+
+        monkeypatch.setattr(locale, "getlocale", fake_getlocale)
+
+    @pytest.fixture()
+    def marker(self, tmp_path: pathlib.Path) -> pathlib.Path:
+        marker = tmp_path.joinpath("EXTERNALLY-MANAGED")
+        marker.touch()
+        return marker
+
+    def test_invalid_config_format(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        marker: pathlib.Path,
+    ) -> None:
+        marker.write_text("invalid", encoding="utf8")
+
+        with caplog.at_level(logging.WARNING, "pip._internal.exceptions"):
+            exc = ExternallyManagedEnvironment.from_config(marker)
+        assert len(caplog.records) == 1
+        assert caplog.records-1.getMessage() == f"Failed to read {marker}"
+
+        assert str(exc.context) == self.default_text
+
+    @pytest.mark.parametrize(
+        "config",
+        
+            pytest.param("", id="empty"),
+            pytest.param("foo\nblah = blah", id="no-section"),
+            pytest.param("externally-managed\nblah = blah", id="no-key"),
+        ,
+    )
+    def test_config_without_key(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        marker: pathlib.Path,
+        config: str,
+    ) -> None:
+        marker.write_text(config, encoding="utf8")
+
+        with caplog.at_level(logging.WARNING, "pip._internal.exceptions"):
+            exc = ExternallyManagedEnvironment.from_config(marker)
+        assert not caplog.records
+        assert str(exc.context) == self.default_text
+
+    @pytest.mark.skipif(
+        sys.platform == "win32",
+        reason="Localization disabled on Windows",
+    )
+    @pytest.mark.parametrize(
+        "config, expected",
+        
+            pytest.param(
+                """\
+                externally-managed
+                Error = 最後
+                Error-en = English
+                Error-zh = 中文
+                Error-zh_Hant = 繁體
+                Error-zh_Hans = 简体
+                """,
+                "繁體",
+                id="full",
+            ),
+            pytest.param(
+                """\
+                externally-managed
+                Error = 最後
+                Error-en = English
+                Error-zh = 中文
+                Error-zh_Hans = 简体
+                """,
+                "中文",
+                id="no-variant",
+            ),
+            pytest.param(
+                """\
+                externally-managed
+                Error = 最後
+                Error-en = English
+                """,
+                "最後",
+                id="fallback",
+            ),
+        ,
+    )
+    def test_config_canonical(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        marker: pathlib.Path,
+        config: str,
+        expected: str,
+    ) -> None:
+        marker.write_text(
+            textwrap.dedent(config),
+            encoding="utf8",
+        )
+
+        with caplog.at_level(logging.WARNING, "pip._internal.exceptions"):
+            exc = ExternallyManagedEnvironment.from_config(marker)
+        assert not caplog.records
+        assert str(exc.context) == expected
+
+    @pytest.mark.skipif(
+        sys.platform != "win32",
+        reason="Non-Windows should implement localization",
+    )
+    @pytest.mark.parametrize(
+        "config",
+        
+            pytest.param(
+                """\
+                externally-managed
+                Error = 最後
+                Error-en = English
+                Error-zh = 中文
+                Error-zh_Hant = 繁體
+                Error-zh_Hans = 简体
+                """,
+                id="full",
+            ),
+            pytest.param(
+                """\
+                externally-managed
+                Error = 最後
+                Error-en = English
+                Error-zh = 中文
+                Error-zh_Hans = 简体
+                """,
+                id="no-variant",
+            ),
+            pytest.param(
+                """\
+                externally-managed
+                Error = 最後
+                Error-en = English
+                """,
+                id="fallback",
+            ),
+        ,
+    )
+    def test_config_canonical_no_localization(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        marker: pathlib.Path,
+        config: str,
+    ) -> None:
+        marker.write_text(
+            textwrap.dedent(config),
+            encoding="utf8",
+        )
+
+        with caplog.at_level(logging.WARNING, "pip._internal.exceptions"):
+            exc = ExternallyManagedEnvironment.from_config(marker)
+        assert not caplog.records
+        assert str(exc.context) == "最後"

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_finder.py Added

@@ -0,0 +1,568 @@
+import logging
+from typing import Iterable
+from unittest.mock import Mock, patch
+
+import pytest
+from pip._vendor.packaging.specifiers import SpecifierSet
+from pip._vendor.packaging.tags import Tag
+from pip._vendor.packaging.version import parse as parse_version
+
+import pip._internal.utils.compatibility_tags
+from pip._internal.exceptions import BestVersionAlreadyInstalled, DistributionNotFound
+from pip._internal.index.package_finder import (
+    CandidateEvaluator,
+    InstallationCandidate,
+    Link,
+    LinkEvaluator,
+    LinkType,
+)
+from pip._internal.models.target_python import TargetPython
+from pip._internal.req.constructors import install_req_from_line
+from tests.lib import TestData, make_test_finder
+
+
+def test_no_mpkg(data: TestData) -> None:
+    """Finder skips zipfiles with "macosx10" in the name."""
+    finder = make_test_finder(find_links=data.find_links)
+    req = install_req_from_line("pkgwithmpkg")
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("pkgwithmpkg-1.0.tar.gz"), found
+
+
+def test_no_partial_name_match(data: TestData) -> None:
+    """Finder requires the full project name to match, not just beginning."""
+    finder = make_test_finder(find_links=data.find_links)
+    req = install_req_from_line("gmpy")
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("gmpy-1.15.tar.gz"), found
+
+
+def test_tilde() -> None:
+    """Finder can accept a path with ~ in it and will normalize it."""
+    patched_exists = patch(
+        "pip._internal.index.collector.os.path.exists", return_value=True
+    )
+    with patched_exists:
+        finder = make_test_finder(find_links="~/python-pkgs")
+    req = install_req_from_line("gmpy")
+    with pytest.raises(DistributionNotFound):
+        finder.find_requirement(req, False)
+
+
+def test_duplicates_sort_ok(data: TestData) -> None:
+    """Finder successfully finds one of a set of duplicates in different
+    locations"""
+    finder = make_test_finder(find_links=data.find_links, data.find_links2)
+    req = install_req_from_line("duplicate")
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("duplicate-1.0.tar.gz"), found
+
+
+def test_finder_detects_latest_find_links(data: TestData) -> None:
+    """Test PackageFinder detects latest using find-links"""
+    req = install_req_from_line("simple")
+    finder = make_test_finder(find_links=data.find_links)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("simple-3.0.tar.gz")
+
+
+def test_incorrect_case_file_index(data: TestData) -> None:
+    """Test PackageFinder detects latest using wrong case"""
+    req = install_req_from_line("dinner")
+    finder = make_test_finder(index_urls=data.find_links3)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("Dinner-2.0.tar.gz")
+
+
+@pytest.mark.network
+def test_finder_detects_latest_already_satisfied_find_links(data: TestData) -> None:
+    """Test PackageFinder detects latest already satisfied using find-links"""
+    req = install_req_from_line("simple")
+    # the latest simple in local pkgs is 3.0
+    latest_version = "3.0"
+    satisfied_by = Mock(
+        location="/path",
+        version=parse_version(latest_version),
+    )
+    req.satisfied_by = satisfied_by
+    finder = make_test_finder(find_links=data.find_links)
+
+    with pytest.raises(BestVersionAlreadyInstalled):
+        finder.find_requirement(req, True)
+
+
+@pytest.mark.network
+def test_finder_detects_latest_already_satisfied_pypi_links() -> None:
+    """Test PackageFinder detects latest already satisfied using pypi links"""
+    req = install_req_from_line("initools")
+    # the latest initools on PyPI is 0.3.1
+    latest_version = "0.3.1"
+    satisfied_by = Mock(
+        location="/path",
+        version=parse_version(latest_version),
+    )
+    req.satisfied_by = satisfied_by
+    finder = make_test_finder(index_urls="http://pypi.org/simple/")
+
+    with pytest.raises(BestVersionAlreadyInstalled):
+        finder.find_requirement(req, True)
+
+
+class TestWheel:
+    def test_skip_invalid_wheel_link(
+        self, caplog: pytest.LogCaptureFixture, data: TestData
+    ) -> None:
+        """
+        Test if PackageFinder skips invalid wheel filenames
+        """
+        caplog.set_level(logging.DEBUG)
+
+        req = install_req_from_line("invalid")
+        # data.find_links contains "invalid.whl", which is an invalid wheel
+        finder = make_test_finder(find_links=data.find_links)
+        with pytest.raises(DistributionNotFound):
+            finder.find_requirement(req, True)
+
+        assert "Skipping link: invalid wheel filename:" in caplog.text
+
+    def test_not_find_wheel_not_supported(self, data: TestData) -> None:
+        """
+        Test not finding an unsupported wheel.
+        """
+        req = install_req_from_line("simple.dist")
+        target_python = TargetPython()
+        # Make sure no tags will match.
+        target_python._valid_tags = 
+        finder = make_test_finder(
+            find_links=data.find_links,
+            target_python=target_python,
+        )
+
+        with pytest.raises(DistributionNotFound):
+            finder.find_requirement(req, True)
+
+    def test_find_wheel_supported(
+        self, data: TestData, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test finding supported wheel.
+        """
+        monkeypatch.setattr(
+            pip._internal.utils.compatibility_tags,
+            "get_supported",
+            lambda **kw: ("py2", "none", "any"),
+        )
+
+        req = install_req_from_line("simple.dist")
+        finder = make_test_finder(find_links=data.find_links)
+        found = finder.find_requirement(req, True)
+        assert found is not None
+        assert found.link.url.endswith("simple.dist-0.1-py2.py3-none-any.whl"), found
+
+    def test_wheel_over_sdist_priority(self, data: TestData) -> None:
+        """
+        Test wheels have priority over sdists.
+        `test_link_sorting` also covers this at lower level
+        """
+        req = install_req_from_line("priority")
+        finder = make_test_finder(find_links=data.find_links)
+        found = finder.find_requirement(req, True)
+        assert found is not None
+        assert found.link.url.endswith("priority-1.0-py2.py3-none-any.whl"), found
+
+    def test_existing_over_wheel_priority(self, data: TestData) -> None:
+        """
+        Test existing install has priority over wheels.
+        `test_link_sorting` also covers this at a lower level
+        """
+        req = install_req_from_line("priority")
+        latest_version = "1.0"
+        satisfied_by = Mock(
+            location="/path",
+            version=parse_version(latest_version),
+        )
+        req.satisfied_by = satisfied_by
+        finder = make_test_finder(find_links=data.find_links)
+
+        with pytest.raises(BestVersionAlreadyInstalled):
+            finder.find_requirement(req, True)
+
+
+class TestCandidateEvaluator:
+    def test_link_sorting(self) -> None:
+        """
+        Test link sorting
+        """
+        links = 
+            InstallationCandidate("simple", "2.0", Link("simple-2.0.tar.gz")),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0-pyT-none-TEST.whl"),
+            ),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0-pyT-TEST-any.whl"),
+            ),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0-pyT-none-any.whl"),
+            ),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0.tar.gz"),
+            ),
+        
+        valid_tags = 
+            Tag("pyT", "none", "TEST"),
+            Tag("pyT", "TEST", "any"),
+            Tag("pyT", "none", "any"),
+        
+        specifier = SpecifierSet()
+        evaluator = CandidateEvaluator(
+            "my-project",
+            supported_tags=valid_tags,
+            specifier=specifier,
+        )
+        sort_key = evaluator._sort_key
+        results = sorted(links, key=sort_key, reverse=True)
+        results2 = sorted(reversed(links), key=sort_key, reverse=True)
+
+        assert links == results, results
+        assert links == results2, results2
+
+    def test_link_sorting_wheels_with_build_tags(self) -> None:
+        """Verify build tags affect sorting."""
+        links = 
+            InstallationCandidate(
+                "simplewheel",
+                "2.0",
+                Link("simplewheel-2.0-1-py2.py3-none-any.whl"),
+            ),
+            InstallationCandidate(
+                "simplewheel",
+                "2.0",
+                Link("simplewheel-2.0-py2.py3-none-any.whl"),
+            ),
+            InstallationCandidate(
+                "simplewheel",
+                "1.0",
+                Link("simplewheel-1.0-py2.py3-none-any.whl"),
+            ),
+        
+        candidate_evaluator = CandidateEvaluator.create("my-project")
+        sort_key = candidate_evaluator._sort_key
+        results = sorted(links, key=sort_key, reverse=True)
+        results2 = sorted(reversed(links), key=sort_key, reverse=True)
+
+        assert links == results, results
+        assert links == results2, results2
+
+    def test_build_tag_is_less_important_than_other_tags(self) -> None:
+        links = 
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0-1-py3-abi3-linux_x86_64.whl"),
+            ),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0-2-py3-abi3-linux_i386.whl"),
+            ),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0-2-py3-any-none.whl"),
+            ),
+            InstallationCandidate(
+                "simple",
+                "1.0",
+                Link("simple-1.0.tar.gz"),
+            ),
+        
+        valid_tags = 
+            Tag("py3", "abi3", "linux_x86_64"),
+            Tag("py3", "abi3", "linux_i386"),
+            Tag("py3", "any", "none"),
+        
+        evaluator = CandidateEvaluator(
+            "my-project",
+            supported_tags=valid_tags,
+            specifier=SpecifierSet(),
+        )
+        sort_key = evaluator._sort_key
+        results = sorted(links, key=sort_key, reverse=True)
+        results2 = sorted(reversed(links), key=sort_key, reverse=True)
+
+        assert links == results, results
+        assert links == results2, results2
+
+
+def test_finder_priority_file_over_page(data: TestData) -> None:
+    """Test PackageFinder prefers file links over equivalent page links"""
+    req = install_req_from_line("gmpy==1.15")
+    finder = make_test_finder(
+        find_links=data.find_links,
+        index_urls="http://pypi.org/simple/",
+    )
+    all_versions = finder.find_all_candidates(req.name)
+    # 1 file InstallationCandidate followed by all https ones
+    assert all_versions0.link.scheme == "file"
+    assert all(
+        version.link.scheme == "https" for version in all_versions1:
+    ), all_versions
+
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.startswith("file://")
+
+
+def test_finder_priority_nonegg_over_eggfragments() -> None:
+    """Test PackageFinder prefers non-egg links over "#egg=" links"""
+    req = install_req_from_line("bar==1.0")
+    links = "http://foo/bar.py#egg=bar-1.0", "http://foo/bar-1.0.tar.gz"
+
+    finder = make_test_finder(links)
+    all_versions = finder.find_all_candidates(req.name)
+    assert all_versions0.link.url.endswith("tar.gz")
+    assert all_versions1.link.url.endswith("#egg=bar-1.0")
+
+    found = finder.find_requirement(req, False)
+
+    assert found is not None
+    assert found.link.url.endswith("tar.gz")
+
+    links.reverse()
+
+    finder = make_test_finder(links)
+    all_versions = finder.find_all_candidates(req.name)
+    assert all_versions0.link.url.endswith("tar.gz")
+    assert all_versions1.link.url.endswith("#egg=bar-1.0")
+    found = finder.find_requirement(req, False)
+
+    assert found is not None
+    assert found.link.url.endswith("tar.gz")
+
+
+def test_finder_only_installs_stable_releases(data: TestData) -> None:
+    """
+    Test PackageFinder only accepts stable versioned releases by default.
+    """
+
+    req = install_req_from_line("bar")
+
+    # using a local index (that has pre & dev releases)
+    finder = make_test_finder(index_urls=data.index_url("pre"))
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("bar-1.0.tar.gz"), found.link.url
+
+    # using find-links
+    links = "https://foo/bar-1.0.tar.gz", "https://foo/bar-2.0b1.tar.gz"
+
+    finder = make_test_finder(links)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url == "https://foo/bar-1.0.tar.gz"
+
+    links.reverse()
+
+    finder = make_test_finder(links)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url == "https://foo/bar-1.0.tar.gz"
+
+
+def test_finder_only_installs_data_require(data: TestData) -> None:
+    """
+    Test whether the PackageFinder understand data-python-requires
+
+    This can optionally be exposed by a simple-repository to tell which
+    distribution are compatible with which version of Python by adding a
+    data-python-require to the anchor links.
+
+    See pep 503 for more information.
+    """
+
+    # using a local index (that has pre & dev releases)
+    finder = make_test_finder(index_urls=data.index_url("datarequire"))
+    links = finder.find_all_candidates("fakepackage")
+    assert {str(v.version) for v in links} == {"1.0.0", "3.3.0", "9.9.9"}
+
+
+def test_finder_installs_pre_releases(data: TestData) -> None:
+    """
+    Test PackageFinder finds pre-releases if asked to.
+    """
+
+    req = install_req_from_line("bar")
+
+    # using a local index (that has pre & dev releases)
+    finder = make_test_finder(
+        index_urls=data.index_url("pre"),
+        allow_all_prereleases=True,
+    )
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("bar-2.0b1.tar.gz"), found.link.url
+
+    # using find-links
+    links = "https://foo/bar-1.0.tar.gz", "https://foo/bar-2.0b1.tar.gz"
+
+    finder = make_test_finder(links, allow_all_prereleases=True)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url == "https://foo/bar-2.0b1.tar.gz"
+
+    links.reverse()
+
+    finder = make_test_finder(links, allow_all_prereleases=True)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url == "https://foo/bar-2.0b1.tar.gz"
+
+
+def test_finder_installs_dev_releases(data: TestData) -> None:
+    """
+    Test PackageFinder finds dev releases if asked to.
+    """
+
+    req = install_req_from_line("bar")
+
+    # using a local index (that has dev releases)
+    finder = make_test_finder(
+        index_urls=data.index_url("dev"),
+        allow_all_prereleases=True,
+    )
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url.endswith("bar-2.0.dev1.tar.gz"), found.link.url
+
+
+def test_finder_installs_pre_releases_with_version_spec() -> None:
+    """
+    Test PackageFinder only accepts stable versioned releases by default.
+    """
+    req = install_req_from_line("bar>=0.0.dev0")
+    links = "https://foo/bar-1.0.tar.gz", "https://foo/bar-2.0b1.tar.gz"
+
+    finder = make_test_finder(links)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url == "https://foo/bar-2.0b1.tar.gz"
+
+    links.reverse()
+
+    finder = make_test_finder(links)
+    found = finder.find_requirement(req, False)
+    assert found is not None
+    assert found.link.url == "https://foo/bar-2.0b1.tar.gz"
+
+
+class TestLinkEvaluator:
+    def make_test_link_evaluator(self, formats: Iterablestr) -> LinkEvaluator:
+        target_python = TargetPython()
+        return LinkEvaluator(
+            project_name="pytest",
+            canonical_name="pytest",
+            formats=frozenset(formats),
+            target_python=target_python,
+            allow_yanked=True,
+        )
+
+    @pytest.mark.parametrize(
+        "url, expected_version",
+        
+            ("http:/yo/pytest-1.0.tar.gz", "1.0"),
+            ("http:/yo/pytest-1.0-py2.py3-none-any.whl", "1.0"),
+        ,
+    )
+    def test_evaluate_link__match(self, url: str, expected_version: str) -> None:
+        """Test that 'pytest' archives match for 'pytest'"""
+        link = Link(url)
+        evaluator = self.make_test_link_evaluator(formats="source", "binary")
+        actual = evaluator.evaluate_link(link)
+        assert actual == (LinkType.candidate, expected_version)
+
+    @pytest.mark.parametrize(
+        "url, link_type, fail_reason",
+        
+            # TODO: Uncomment this test case when #1217 is fixed.
+            # 'http:/yo/pytest-xdist-1.0.tar.gz',
+            (
+                "http:/yo/pytest2-1.0.tar.gz",
+                LinkType.format_invalid,
+                "Missing project version for pytest",
+            ),
+            (
+                "http:/yo/pytest_xdist-1.0-py2.py3-none-any.whl",
+                LinkType.different_project,
+                "wrong project name (not pytest)",
+            ),
+        ,
+    )
+    def test_evaluate_link__substring_fails(
+        self,
+        url: str,
+        link_type: LinkType,
+        fail_reason: str,
+    ) -> None:
+        """Test that 'pytest<something> archives won't match for 'pytest'."""
+        link = Link(url)
+        evaluator = self.make_test_link_evaluator(formats="source", "binary")
+        actual = evaluator.evaluate_link(link)
+        assert actual == (link_type, fail_reason)
+
+
+def test_process_project_url(data: TestData) -> None:
+    project_name = "simple"
+    index_url = data.index_url("simple")
+    project_url = Link(f"{index_url}/{project_name}")
+    finder = make_test_finder(index_urls=index_url)
+    link_evaluator = finder.make_link_evaluator(project_name)
+    actual = finder.process_project_url(
+        project_url,
+        link_evaluator=link_evaluator,
+    )
+
+    assert len(actual) == 1
+    package_link = actual0
+    assert package_link.name == "simple"
+    assert str(package_link.version) == "1.0"
+
+
+def test_find_all_candidates_nothing() -> None:
+    """Find nothing without anything"""
+    finder = make_test_finder()
+    assert not finder.find_all_candidates("pip")
+
+
+def test_find_all_candidates_find_links(data: TestData) -> None:
+    finder = make_test_finder(find_links=data.find_links)
+    versions = finder.find_all_candidates("simple")
+    assert str(v.version) for v in versions == "3.0", "2.0", "1.0"
+
+
+def test_find_all_candidates_index(data: TestData) -> None:
+    finder = make_test_finder(index_urls=data.index_url("simple"))
+    versions = finder.find_all_candidates("simple")
+    assert str(v.version) for v in versions == "1.0"
+
+
+def test_find_all_candidates_find_links_and_index(data: TestData) -> None:
+    finder = make_test_finder(
+        find_links=data.find_links,
+        index_urls=data.index_url("simple"),
+    )
+    versions = finder.find_all_candidates("simple")
+    # first the find-links versions then the page versions
+    assert str(v.version) for v in versions == "3.0", "2.0", "1.0", "1.0"

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_format_control.py Added

@@ -0,0 +1,73 @@
+from optparse import Values
+from typing import FrozenSet, List, Set
+
+import pytest
+
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.status_codes import SUCCESS
+from pip._internal.models.format_control import FormatControl
+
+
+class SimpleCommand(Command):
+    def __init__(self) -> None:
+        super().__init__("fake", "fake summary")
+
+    def add_options(self) -> None:
+        self.cmd_opts.add_option(cmdoptions.no_binary())
+        self.cmd_opts.add_option(cmdoptions.only_binary())
+
+    def run(self, options: Values, args: Liststr) -> int:
+        self.options = options
+        return SUCCESS
+
+
+def test_no_binary_overrides() -> None:
+    cmd = SimpleCommand()
+    cmd.main("fake", "--only-binary=:all:", "--no-binary=fred")
+    format_control = FormatControl({"fred"}, {":all:"})
+    assert cmd.options.format_control == format_control
+
+
+def test_only_binary_overrides() -> None:
+    cmd = SimpleCommand()
+    cmd.main("fake", "--no-binary=:all:", "--only-binary=fred")
+    format_control = FormatControl({":all:"}, {"fred"})
+    assert cmd.options.format_control == format_control
+
+
+def test_none_resets() -> None:
+    cmd = SimpleCommand()
+    cmd.main("fake", "--no-binary=:all:", "--no-binary=:none:")
+    format_control = FormatControl(set(), set())
+    assert cmd.options.format_control == format_control
+
+
+def test_none_preserves_other_side() -> None:
+    cmd = SimpleCommand()
+    cmd.main("fake", "--no-binary=:all:", "--only-binary=fred", "--no-binary=:none:")
+    format_control = FormatControl(set(), {"fred"})
+    assert cmd.options.format_control == format_control
+
+
+def test_comma_separated_values() -> None:
+    cmd = SimpleCommand()
+    cmd.main("fake", "--no-binary=1,2,3")
+    format_control = FormatControl({"1", "2", "3"}, set())
+    assert cmd.options.format_control == format_control
+
+
+@pytest.mark.parametrize(
+    "no_binary,only_binary,argument,expected",
+    
+        ({"fred"}, set(), "fred", frozenset("source")),
+        ({"fred"}, {":all:"}, "fred", frozenset("source")),
+        (set(), {"fred"}, "fred", frozenset("binary")),
+        ({":all:"}, {"fred"}, "fred", frozenset("binary")),
+    ,
+)
+def test_fmt_ctl_matches(
+    no_binary: Setstr, only_binary: Setstr, argument: str, expected: FrozenSetstr
+) -> None:
+    fmt = FormatControl(no_binary, only_binary)
+    assert fmt.get_allowed_formats(argument) == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_index.py Added

@@ -0,0 +1,903 @@
+import logging
+from typing import FrozenSet, List, Optional, Set, Tuple
+
+import pytest
+from pip._vendor.packaging.specifiers import SpecifierSet
+from pip._vendor.packaging.tags import Tag
+
+from pip._internal.index.collector import LinkCollector
+from pip._internal.index.package_finder import (
+    CandidateEvaluator,
+    CandidatePreferences,
+    FormatControl,
+    LinkEvaluator,
+    LinkType,
+    PackageFinder,
+    _check_link_requires_python,
+    _extract_version_from_fragment,
+    _find_name_version_sep,
+    filter_unallowed_hashes,
+)
+from pip._internal.models.link import Link
+from pip._internal.models.search_scope import SearchScope
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.models.target_python import TargetPython
+from pip._internal.network.session import PipSession
+from pip._internal.utils.compatibility_tags import get_supported
+from pip._internal.utils.hashes import Hashes
+from tests.lib import CURRENT_PY_VERSION_INFO
+from tests.lib.index import make_mock_candidate
+
+
+@pytest.mark.parametrize(
+    "requires_python, expected",
+    
+        ("== 3.6.4", False),
+        ("== 3.6.5", True),
+        # Test an invalid Requires-Python value.
+        ("invalid", True),
+    ,
+)
+def test_check_link_requires_python(requires_python: str, expected: bool) -> None:
+    version_info = (3, 6, 5)
+    link = Link("https://example.com", requires_python=requires_python)
+    actual = _check_link_requires_python(link, version_info)
+    assert actual == expected
+
+
+def check_caplog(
+    caplog: pytest.LogCaptureFixture, expected_level: str, expected_message: str
+) -> None:
+    assert len(caplog.records) == 1
+    record = caplog.records0
+    assert record.levelname == expected_level
+    assert record.message == expected_message
+
+
+@pytest.mark.parametrize(
+    "ignore_requires_python, expected",
+    
+        (
+            False,
+            (
+                False,
+                "VERBOSE",
+                "Link requires a different Python (3.6.5 not in: '== 3.6.4'): "
+                "https://example.com",
+            ),
+        ),
+        (
+            True,
+            (
+                True,
+                "DEBUG",
+                "Ignoring failed Requires-Python check (3.6.5 not in: '== 3.6.4') "
+                "for link: https://example.com",
+            ),
+        ),
+    ,
+)
+def test_check_link_requires_python__incompatible_python(
+    caplog: pytest.LogCaptureFixture,
+    ignore_requires_python: bool,
+    expected: Tuplebool, str, str,
+) -> None:
+    """
+    Test an incompatible Python.
+    """
+    expected_return, expected_level, expected_message = expected
+    link = Link("https://example.com", requires_python="== 3.6.4")
+    caplog.set_level(logging.DEBUG)
+    actual = _check_link_requires_python(
+        link,
+        version_info=(3, 6, 5),
+        ignore_requires_python=ignore_requires_python,
+    )
+    assert actual == expected_return
+
+    check_caplog(caplog, expected_level, expected_message)
+
+
+def test_check_link_requires_python__invalid_requires(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    """
+    Test the log message for an invalid Requires-Python.
+    """
+    link = Link("https://example.com", requires_python="invalid")
+    caplog.set_level(logging.DEBUG)
+    actual = _check_link_requires_python(link, version_info=(3, 6, 5))
+    assert actual
+
+    expected_message = (
+        "Ignoring invalid Requires-Python ('invalid') for link: https://example.com"
+    )
+    check_caplog(caplog, "DEBUG", expected_message)
+
+
+class TestLinkEvaluator:
+    @pytest.mark.parametrize(
+        "py_version_info, ignore_requires_python, expected",
+        
+            pytest.param(
+                (3, 6, 5),
+                False,
+                (LinkType.candidate, "1.12"),
+                id="compatible",
+            ),
+            pytest.param(
+                (3, 6, 4),
+                False,
+                (
+                    LinkType.requires_python_mismatch,
+                    "1.12 Requires-Python == 3.6.5",
+                ),
+                id="requires-python-mismatch",
+            ),
+            pytest.param(
+                (3, 6, 4),
+                True,
+                (LinkType.candidate, "1.12"),
+                id="requires-python-mismatch-ignored",
+            ),
+        ,
+    )
+    def test_evaluate_link(
+        self,
+        py_version_info: Tupleint, int, int,
+        ignore_requires_python: bool,
+        expected: TupleLinkType, str,
+    ) -> None:
+        target_python = TargetPython(py_version_info=py_version_info)
+        evaluator = LinkEvaluator(
+            project_name="twine",
+            canonical_name="twine",
+            formats=frozenset("source"),
+            target_python=target_python,
+            allow_yanked=True,
+            ignore_requires_python=ignore_requires_python,
+        )
+        link = Link(
+            "https://example.com/#egg=twine-1.12",
+            requires_python="== 3.6.5",
+        )
+        actual = evaluator.evaluate_link(link)
+        assert actual == expected
+
+    @pytest.mark.parametrize(
+        "yanked_reason, allow_yanked, expected",
+        
+            (None, True, (LinkType.candidate, "1.12")),
+            (None, False, (LinkType.candidate, "1.12")),
+            ("", True, (LinkType.candidate, "1.12")),
+            (
+                "",
+                False,
+                (LinkType.yanked, "yanked for reason: <none given>"),
+            ),
+            ("bad metadata", True, (LinkType.candidate, "1.12")),
+            (
+                "bad metadata",
+                False,
+                (LinkType.yanked, "yanked for reason: bad metadata"),
+            ),
+            # Test a unicode string with a non-ascii character.
+            ("curly quote: \u2018", True, (LinkType.candidate, "1.12")),
+            (
+                "curly quote: \u2018",
+                False,
+                (
+                    LinkType.yanked,
+                    "yanked for reason: curly quote: \u2018",
+                ),
+            ),
+        ,
+    )
+    def test_evaluate_link__allow_yanked(
+        self,
+        yanked_reason: str,
+        allow_yanked: bool,
+        expected: TupleLinkType, str,
+    ) -> None:
+        target_python = TargetPython(py_version_info=(3, 6, 4))
+        evaluator = LinkEvaluator(
+            project_name="twine",
+            canonical_name="twine",
+            formats=frozenset("source"),
+            target_python=target_python,
+            allow_yanked=allow_yanked,
+        )
+        link = Link(
+            "https://example.com/#egg=twine-1.12",
+            yanked_reason=yanked_reason,
+        )
+        actual = evaluator.evaluate_link(link)
+        assert actual == expected
+
+    def test_evaluate_link__incompatible_wheel(self) -> None:
+        """
+        Test an incompatible wheel.
+        """
+        target_python = TargetPython(py_version_info=(3, 6, 4))
+        # Set the valid tags to an empty list to make sure nothing matches.
+        target_python._valid_tags = 
+        evaluator = LinkEvaluator(
+            project_name="sample",
+            canonical_name="sample",
+            formats=frozenset("binary"),
+            target_python=target_python,
+            allow_yanked=True,
+        )
+        link = Link("https://example.com/sample-1.0-py2.py3-none-any.whl")
+        actual = evaluator.evaluate_link(link)
+        expected = (
+            LinkType.platform_mismatch,
+            "none of the wheel's tags (py2-none-any, py3-none-any) are compatible "
+            "(run pip debug --verbose to show compatible tags)",
+        )
+        assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "hex_digest, expected_versions",
+    
+        (64 * "a", "1.0", "1.1"),
+        (64 * "b", "1.0", "1.2"),
+        (64 * "c", "1.0", "1.1", "1.2"),
+    ,
+)
+def test_filter_unallowed_hashes(hex_digest: str, expected_versions: Liststr) -> None:
+    candidates = 
+        make_mock_candidate("1.0"),
+        make_mock_candidate("1.1", hex_digest=(64 * "a")),
+        make_mock_candidate("1.2", hex_digest=(64 * "b")),
+    
+    hashes_data = {
+        "sha256": hex_digest,
+    }
+    hashes = Hashes(hashes_data)
+    actual = filter_unallowed_hashes(
+        candidates,
+        hashes=hashes,
+        project_name="my-project",
+    )
+
+    actual_versions = str(candidate.version) for candidate in actual
+    assert actual_versions == expected_versions
+    # Check that the return value is always different from the given value.
+    assert actual is not candidates
+
+
+def test_filter_unallowed_hashes__no_hashes(caplog: pytest.LogCaptureFixture) -> None:
+    caplog.set_level(logging.DEBUG)
+
+    candidates = 
+        make_mock_candidate("1.0"),
+        make_mock_candidate("1.1"),
+    
+    actual = filter_unallowed_hashes(
+        candidates,
+        hashes=Hashes(),
+        project_name="my-project",
+    )
+
+    # Check that the return value is a copy.
+    assert actual == candidates
+    assert actual is not candidates
+
+    expected_message = (
+        "Given no hashes to check 2 links for project 'my-project': "
+        "discarding no candidates"
+    )
+    check_caplog(caplog, "DEBUG", expected_message)
+
+
+def test_filter_unallowed_hashes__log_message_with_match(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    caplog.set_level(logging.DEBUG)
+
+    # Test 1 match, 2 non-matches, 3 no hashes so all 3 values will be
+    # different.
+    candidates = 
+        make_mock_candidate("1.0"),
+        make_mock_candidate(
+            "1.1",
+        ),
+        make_mock_candidate(
+            "1.2",
+        ),
+        make_mock_candidate("1.3", hex_digest=(64 * "a")),
+        make_mock_candidate("1.4", hex_digest=(64 * "b")),
+        make_mock_candidate("1.5", hex_digest=(64 * "c")),
+    
+    hashes_data = {
+        "sha256": 64 * "a", 64 * "d",
+    }
+    hashes = Hashes(hashes_data)
+    actual = filter_unallowed_hashes(
+        candidates,
+        hashes=hashes,
+        project_name="my-project",
+    )
+    assert len(actual) == 4
+
+    expected_message = (
+        "Checked 6 links for project 'my-project' against 2 hashes "
+        "(1 matches, 3 no digest): discarding 2 non-matches:\n"
+        "  https://example.com/pkg-1.4.tar.gz#sha256="
+        "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\n"
+        "  https://example.com/pkg-1.5.tar.gz#sha256="
+        "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+    )
+    check_caplog(caplog, "DEBUG", expected_message)
+
+
+def test_filter_unallowed_hashes__log_message_with_no_match(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    caplog.set_level(logging.DEBUG)
+
+    candidates = 
+        make_mock_candidate("1.0"),
+        make_mock_candidate("1.1", hex_digest=(64 * "b")),
+        make_mock_candidate("1.2", hex_digest=(64 * "c")),
+    
+    hashes_data = {
+        "sha256": 64 * "a", 64 * "d",
+    }
+    hashes = Hashes(hashes_data)
+    actual = filter_unallowed_hashes(
+        candidates,
+        hashes=hashes,
+        project_name="my-project",
+    )
+    assert len(actual) == 3
+
+    expected_message = (
+        "Checked 3 links for project 'my-project' against 2 hashes "
+        "(0 matches, 1 no digest): discarding no candidates"
+    )
+    check_caplog(caplog, "DEBUG", expected_message)
+
+
+class TestCandidateEvaluator:
+    @pytest.mark.parametrize(
+        "allow_all_prereleases, prefer_binary",
+        
+            (False, False),
+            (False, True),
+            (True, False),
+            (True, True),
+        ,
+    )
+    def test_create(self, allow_all_prereleases: bool, prefer_binary: bool) -> None:
+        target_python = TargetPython()
+        target_python._valid_tags = Tag("py36", "none", "any")
+        specifier = SpecifierSet()
+        evaluator = CandidateEvaluator.create(
+            project_name="my-project",
+            target_python=target_python,
+            allow_all_prereleases=allow_all_prereleases,
+            prefer_binary=prefer_binary,
+            specifier=specifier,
+        )
+        assert evaluator._allow_all_prereleases == allow_all_prereleases
+        assert evaluator._prefer_binary == prefer_binary
+        assert evaluator._specifier is specifier
+        assert evaluator._supported_tags == Tag("py36", "none", "any")
+
+    def test_create__target_python_none(self) -> None:
+        """
+        Test passing target_python=None.
+        """
+        evaluator = CandidateEvaluator.create("my-project")
+        expected_tags = get_supported()
+        assert evaluator._supported_tags == expected_tags
+
+    def test_create__specifier_none(self) -> None:
+        """
+        Test passing specifier=None.
+        """
+        evaluator = CandidateEvaluator.create("my-project")
+        expected_specifier = SpecifierSet()
+        assert evaluator._specifier == expected_specifier
+
+    def test_get_applicable_candidates(self) -> None:
+        specifier = SpecifierSet("<= 1.11")
+        versions = "1.10", "1.11", "1.12"
+        candidates = make_mock_candidate(version) for version in versions
+        evaluator = CandidateEvaluator.create(
+            "my-project",
+            specifier=specifier,
+        )
+        actual = evaluator.get_applicable_candidates(candidates)
+        expected_applicable = candidates:2
+        assert str(c.version) for c in expected_applicable == 
+            "1.10",
+            "1.11",
+        
+        assert actual == expected_applicable
+
+    @pytest.mark.parametrize(
+        "specifier, expected_versions",
+        
+            # Test no version constraint.
+            (SpecifierSet(), "1.0", "1.2"),
+            # Test a version constraint that excludes the candidate whose
+            # hash matches.  Then the non-allowed hash is a candidate.
+            (SpecifierSet("<= 1.1"), "1.0", "1.1"),
+        ,
+    )
+    def test_get_applicable_candidates__hashes(
+        self,
+        specifier: SpecifierSet,
+        expected_versions: Liststr,
+    ) -> None:
+        """
+        Test a non-None hashes value.
+        """
+        candidates = 
+            make_mock_candidate("1.0"),
+            make_mock_candidate("1.1", hex_digest=(64 * "a")),
+            make_mock_candidate("1.2", hex_digest=(64 * "b")),
+        
+        hashes_data = {
+            "sha256": 64 * "b",
+        }
+        hashes = Hashes(hashes_data)
+        evaluator = CandidateEvaluator.create(
+            "my-project",
+            specifier=specifier,
+            hashes=hashes,
+        )
+        actual = evaluator.get_applicable_candidates(candidates)
+        actual_versions = str(c.version) for c in actual
+        assert actual_versions == expected_versions
+
+    def test_compute_best_candidate(self) -> None:
+        specifier = SpecifierSet("<= 1.11")
+        versions = "1.10", "1.11", "1.12"
+        candidates = make_mock_candidate(version) for version in versions
+        evaluator = CandidateEvaluator.create(
+            "my-project",
+            specifier=specifier,
+        )
+        result = evaluator.compute_best_candidate(candidates)
+
+        assert result._candidates == candidates
+        expected_applicable = candidates:2
+        assert str(c.version) for c in expected_applicable == 
+            "1.10",
+            "1.11",
+        
+        assert result._applicable_candidates == expected_applicable
+
+        assert result.best_candidate is expected_applicable1
+
+    def test_compute_best_candidate__none_best(self) -> None:
+        """
+        Test returning a None best candidate.
+        """
+        specifier = SpecifierSet("<= 1.10")
+        versions = "1.11", "1.12"
+        candidates = make_mock_candidate(version) for version in versions
+        evaluator = CandidateEvaluator.create(
+            "my-project",
+            specifier=specifier,
+        )
+        result = evaluator.compute_best_candidate(candidates)
+
+        assert result._candidates == candidates
+        assert result._applicable_candidates == 
+        assert result.best_candidate is None
+
+    @pytest.mark.parametrize(
+        "hex_digest, expected",
+        
+            # Test a link with no hash.
+            (None, 0),
+            # Test a link with an allowed hash.
+            (64 * "a", 1),
+            # Test a link with a hash that isn't allowed.
+            (64 * "b", 0),
+        ,
+    )
+    def test_sort_key__hash(self, hex_digest: Optionalstr, expected: int) -> None:
+        """
+        Test the effect of the link's hash on _sort_key()'s return value.
+        """
+        candidate = make_mock_candidate("1.0", hex_digest=hex_digest)
+        hashes_data = {
+            "sha256": 64 * "a",
+        }
+        hashes = Hashes(hashes_data)
+        evaluator = CandidateEvaluator.create("my-project", hashes=hashes)
+        sort_value = evaluator._sort_key(candidate)
+        # The hash is reflected in the first element of the tuple.
+        actual = sort_value0
+        assert actual == expected
+
+    @pytest.mark.parametrize(
+        "yanked_reason, expected",
+        
+            # Test a non-yanked file.
+            (None, 0),
+            # Test a yanked file (has a lower value than non-yanked).
+            ("bad metadata", -1),
+        ,
+    )
+    def test_sort_key__is_yanked(
+        self, yanked_reason: Optionalstr, expected: int
+    ) -> None:
+        """
+        Test the effect of is_yanked on _sort_key()'s return value.
+        """
+        candidate = make_mock_candidate("1.0", yanked_reason=yanked_reason)
+        evaluator = CandidateEvaluator.create("my-project")
+        sort_value = evaluator._sort_key(candidate)
+        # Yanked / non-yanked is reflected in the second element of the tuple.
+        actual = sort_value1
+        assert actual == expected
+
+    def test_sort_best_candidate__no_candidates(self) -> None:
+        """
+        Test passing an empty list.
+        """
+        evaluator = CandidateEvaluator.create("my-project")
+        actual = evaluator.sort_best_candidate()
+        assert actual is None
+
+    def test_sort_best_candidate__best_yanked_but_not_all(
+        self,
+        caplog: pytest.LogCaptureFixture,
+    ) -> None:
+        """
+        Test the best candidates being yanked, but not all.
+        """
+        caplog.set_level(logging.INFO)
+        candidates = 
+            make_mock_candidate("4.0", yanked_reason="bad metadata #4"),
+            # Put the best candidate in the middle, to test sorting.
+            make_mock_candidate("2.0"),
+            make_mock_candidate("3.0", yanked_reason="bad metadata #3"),
+            make_mock_candidate("1.0"),
+        
+        expected_best = candidates1
+        evaluator = CandidateEvaluator.create("my-project")
+        actual = evaluator.sort_best_candidate(candidates)
+        assert actual is expected_best
+        assert str(actual.version) == "2.0"
+
+        # Check the log messages.
+        assert len(caplog.records) == 0
+
+
+class TestPackageFinder:
+    @pytest.mark.parametrize(
+        "allow_all_prereleases, prefer_binary",
+        
+            (False, False),
+            (False, True),
+            (True, False),
+            (True, True),
+        ,
+    )
+    def test_create__candidate_prefs(
+        self,
+        allow_all_prereleases: bool,
+        prefer_binary: bool,
+    ) -> None:
+        """
+        Test that the _candidate_prefs attribute is set correctly.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        selection_prefs = SelectionPreferences(
+            allow_yanked=True,
+            allow_all_prereleases=allow_all_prereleases,
+            prefer_binary=prefer_binary,
+        )
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=selection_prefs,
+        )
+        candidate_prefs = finder._candidate_prefs
+        assert candidate_prefs.allow_all_prereleases == allow_all_prereleases
+        assert candidate_prefs.prefer_binary == prefer_binary
+
+    def test_create__link_collector(self) -> None:
+        """
+        Test that the _link_collector attribute is set correctly.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=SelectionPreferences(allow_yanked=True),
+        )
+
+        assert finder._link_collector is link_collector
+
+    def test_create__target_python(self) -> None:
+        """
+        Test that the _target_python attribute is set correctly.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        target_python = TargetPython(py_version_info=(3, 7, 3))
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=SelectionPreferences(allow_yanked=True),
+            target_python=target_python,
+        )
+        actual_target_python = finder._target_python
+        # The target_python attribute should be set as is.
+        assert actual_target_python is target_python
+        # Check that the attributes weren't reset.
+        assert actual_target_python.py_version_info == (3, 7, 3)
+
+    def test_create__target_python_none(self) -> None:
+        """
+        Test passing target_python=None.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=SelectionPreferences(allow_yanked=True),
+            target_python=None,
+        )
+        # Spot-check the default TargetPython object.
+        actual_target_python = finder._target_python
+        assert actual_target_python._given_py_version_info is None
+        assert actual_target_python.py_version_info == CURRENT_PY_VERSION_INFO
+
+    @pytest.mark.parametrize("allow_yanked", False, True)
+    def test_create__allow_yanked(self, allow_yanked: bool) -> None:
+        """
+        Test that the _allow_yanked attribute is set correctly.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        selection_prefs = SelectionPreferences(allow_yanked=allow_yanked)
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=selection_prefs,
+        )
+        assert finder._allow_yanked == allow_yanked
+
+    @pytest.mark.parametrize("ignore_requires_python", False, True)
+    def test_create__ignore_requires_python(self, ignore_requires_python: bool) -> None:
+        """
+        Test that the _ignore_requires_python attribute is set correctly.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        selection_prefs = SelectionPreferences(
+            allow_yanked=True,
+            ignore_requires_python=ignore_requires_python,
+        )
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=selection_prefs,
+        )
+        assert finder._ignore_requires_python == ignore_requires_python
+
+    def test_create__format_control(self) -> None:
+        """
+        Test that the format_control attribute is set correctly.
+        """
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        format_control = FormatControl(set(), {":all:"})
+        selection_prefs = SelectionPreferences(
+            allow_yanked=True,
+            format_control=format_control,
+        )
+        finder = PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=selection_prefs,
+        )
+        actual_format_control = finder.format_control
+        assert actual_format_control is format_control
+        # Check that the attributes weren't reset.
+        assert actual_format_control.only_binary == {":all:"}
+
+    @pytest.mark.parametrize(
+        "allow_yanked, ignore_requires_python, only_binary, expected_formats",
+        
+            (False, False, {}, frozenset({"binary", "source"})),
+            # Test allow_yanked=True.
+            (True, False, {}, frozenset({"binary", "source"})),
+            # Test ignore_requires_python=True.
+            (False, True, {}, frozenset({"binary", "source"})),
+            # Test a non-trivial only_binary.
+            (False, False, {"twine"}, frozenset({"binary"})),
+        ,
+    )
+    def test_make_link_evaluator(
+        self,
+        allow_yanked: bool,
+        ignore_requires_python: bool,
+        only_binary: Setstr,
+        expected_formats: FrozenSetstr,
+    ) -> None:
+        # Create a test TargetPython that we can check for.
+        target_python = TargetPython(py_version_info=(3, 7))
+        format_control = FormatControl(set(), only_binary)
+
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+
+        finder = PackageFinder(
+            link_collector=link_collector,
+            target_python=target_python,
+            allow_yanked=allow_yanked,
+            format_control=format_control,
+            ignore_requires_python=ignore_requires_python,
+        )
+
+        # Pass a project_name that will be different from canonical_name.
+        link_evaluator = finder.make_link_evaluator("Twine")
+
+        assert link_evaluator.project_name == "Twine"
+        assert link_evaluator._canonical_name == "twine"
+        assert link_evaluator._allow_yanked == allow_yanked
+        assert link_evaluator._ignore_requires_python == ignore_requires_python
+        assert link_evaluator._formats == expected_formats
+
+        # Test the _target_python attribute.
+        actual_target_python = link_evaluator._target_python
+        # The target_python attribute should be set as is.
+        assert actual_target_python is target_python
+        # For good measure, check that the attributes weren't reset.
+        assert actual_target_python._given_py_version_info == (3, 7)
+        assert actual_target_python.py_version_info == (3, 7, 0)
+
+    @pytest.mark.parametrize(
+        "allow_all_prereleases, prefer_binary",
+        
+            (False, False),
+            (False, True),
+            (True, False),
+            (True, True),
+        ,
+    )
+    def test_make_candidate_evaluator(
+        self,
+        allow_all_prereleases: bool,
+        prefer_binary: bool,
+    ) -> None:
+        target_python = TargetPython()
+        target_python._valid_tags = Tag("py36", "none", "any")
+        candidate_prefs = CandidatePreferences(
+            prefer_binary=prefer_binary,
+            allow_all_prereleases=allow_all_prereleases,
+        )
+        link_collector = LinkCollector(
+            session=PipSession(),
+            search_scope=SearchScope(, , False),
+        )
+        finder = PackageFinder(
+            link_collector=link_collector,
+            target_python=target_python,
+            allow_yanked=True,
+            candidate_prefs=candidate_prefs,
+        )
+
+        specifier = SpecifierSet()
+        # Pass hashes to check that _hashes is set.
+        hashes = Hashes({"sha256": 64 * "a"})
+        evaluator = finder.make_candidate_evaluator(
+            "my-project",
+            specifier=specifier,
+            hashes=hashes,
+        )
+        assert evaluator._allow_all_prereleases == allow_all_prereleases
+        assert evaluator._hashes == hashes
+        assert evaluator._prefer_binary == prefer_binary
+        assert evaluator._project_name == "my-project"
+        assert evaluator._specifier is specifier
+        assert evaluator._supported_tags == Tag("py36", "none", "any")
+
+
+@pytest.mark.parametrize(
+    ("fragment", "canonical_name", "expected"),
+    
+        # Trivial.
+        ("pip-18.0", "pip", 3),
+        ("zope-interface-4.5.0", "zope-interface", 14),
+        # Canonicalized name match non-canonicalized egg info. (pypa/pip#5870)
+        ("Jinja2-2.10", "jinja2", 6),
+        ("zope.interface-4.5.0", "zope-interface", 14),
+        ("zope_interface-4.5.0", "zope-interface", 14),
+        # Should be smart enough to parse ambiguous names from the provided
+        # package name.
+        ("foo-2-2", "foo", 3),
+        ("foo-2-2", "foo-2", 5),
+        # Should be able to detect collapsed characters in the egg info.
+        ("foo--bar-1.0", "foo-bar", 8),
+        ("foo-_bar-1.0", "foo-bar", 8),
+        # The package name must not ends with a dash (PEP 508), so the first
+        # dash would be the separator, not the second.
+        ("zope.interface--4.5.0", "zope-interface", 14),
+        ("zope.interface--", "zope-interface", 14),
+        # The version part is missing, but the split function does not care.
+        ("zope.interface-", "zope-interface", 14),
+    ,
+)
+def test_find_name_version_sep(
+    fragment: str, canonical_name: str, expected: int
+) -> None:
+    index = _find_name_version_sep(fragment, canonical_name)
+    assert index == expected
+
+
+@pytest.mark.parametrize(
+    ("fragment", "canonical_name"),
+    
+        # A dash must follow the package name.
+        ("zope.interface4.5.0", "zope-interface"),
+        ("zope.interface.4.5.0", "zope-interface"),
+        ("zope.interface.-4.5.0", "zope-interface"),
+        ("zope.interface", "zope-interface"),
+    ,
+)
+def test_find_name_version_sep_failure(fragment: str, canonical_name: str) -> None:
+    with pytest.raises(ValueError) as ctx:
+        _find_name_version_sep(fragment, canonical_name)
+    message = f"{fragment} does not match {canonical_name}"
+    assert str(ctx.value) == message
+
+
+@pytest.mark.parametrize(
+    ("fragment", "canonical_name", "expected"),
+    
+        # Trivial.
+        ("pip-18.0", "pip", "18.0"),
+        ("zope-interface-4.5.0", "zope-interface", "4.5.0"),
+        # Canonicalized name match non-canonicalized egg info. (pypa/pip#5870)
+        ("Jinja2-2.10", "jinja2", "2.10"),
+        ("zope.interface-4.5.0", "zope-interface", "4.5.0"),
+        ("zope_interface-4.5.0", "zope-interface", "4.5.0"),
+        # Should be smart enough to parse ambiguous names from the provided
+        # package name.
+        ("foo-2-2", "foo", "2-2"),
+        ("foo-2-2", "foo-2", "2"),
+        ("zope.interface--4.5.0", "zope-interface", "-4.5.0"),
+        ("zope.interface--", "zope-interface", "-"),
+        # Should be able to detect collapsed characters in the egg info.
+        ("foo--bar-1.0", "foo-bar", "1.0"),
+        ("foo-_bar-1.0", "foo-bar", "1.0"),
+        # Invalid.
+        ("the-package-name-8.19", "does-not-match", None),
+        ("zope.interface.-4.5.0", "zope.interface", None),
+        ("zope.interface-", "zope-interface", None),
+        ("zope.interface4.5.0", "zope-interface", None),
+        ("zope.interface.4.5.0", "zope-interface", None),
+        ("zope.interface.-4.5.0", "zope-interface", None),
+        ("zope.interface", "zope-interface", None),
+    ,
+)
+def test_extract_version_from_fragment(
+    fragment: str, canonical_name: str, expected: Optionalstr
+) -> None:
+    version = _extract_version_from_fragment(fragment, canonical_name)
+    assert version == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_link.py Added

@@ -0,0 +1,245 @@
+from typing import Optional
+
+import pytest
+
+from pip._internal.models.link import Link, links_equivalent
+from pip._internal.utils.hashes import Hashes
+
+
+class TestLink:
+    @pytest.mark.parametrize(
+        "url, expected",
+        
+            (
+                "https://user:password@example.com/path/page.html",
+                "<Link https://user:****@example.com/path/page.html>",
+            ),
+        ,
+    )
+    def test_repr(self, url: str, expected: str) -> None:
+        link = Link(url)
+        assert repr(link) == expected
+
+    @pytest.mark.parametrize(
+        "url, expected",
+        
+            ("http://yo/wheel.whl", "wheel.whl"),
+            ("http://yo/wheel", "wheel"),
+            ("https://example.com/path/page.html", "page.html"),
+            # Test a quoted character.
+            ("https://example.com/path/page%231.html", "page#1.html"),
+            (
+                "http://yo/myproject-1.0%2Bfoobar.0-py2.py3-none-any.whl",
+                "myproject-1.0+foobar.0-py2.py3-none-any.whl",
+            ),
+            # Test a path that ends in a slash.
+            ("https://example.com/path/", "path"),
+            ("https://example.com/path//", "path"),
+            # Test a url with no filename.
+            ("https://example.com/", "example.com"),
+            # Test a url with no filename and with auth information.
+            (
+                "https://user:password@example.com/",
+                "example.com",
+            ),
+        ,
+    )
+    def test_filename(self, url: str, expected: str) -> None:
+        link = Link(url)
+        assert link.filename == expected
+
+    def test_splitext(self) -> None:
+        assert ("wheel", ".whl") == Link("http://yo/wheel.whl").splitext()
+
+    def test_no_ext(self) -> None:
+        assert "" == Link("http://yo/wheel").ext
+
+    def test_ext(self) -> None:
+        assert ".whl" == Link("http://yo/wheel.whl").ext
+
+    def test_ext_fragment(self) -> None:
+        assert ".whl" == Link("http://yo/wheel.whl#frag").ext
+
+    def test_ext_query(self) -> None:
+        assert ".whl" == Link("http://yo/wheel.whl?a=b").ext
+
+    def test_is_wheel(self) -> None:
+        assert Link("http://yo/wheel.whl").is_wheel
+
+    def test_is_wheel_false(self) -> None:
+        assert not Link("http://yo/not_a_wheel").is_wheel
+
+    def test_fragments(self) -> None:
+        url = "git+https://example.com/package#egg=eggname"
+        assert "eggname" == Link(url).egg_fragment
+        assert None is Link(url).subdirectory_fragment
+        url = "git+https://example.com/package#egg=eggname&subdirectory=subdir"
+        assert "eggname" == Link(url).egg_fragment
+        assert "subdir" == Link(url).subdirectory_fragment
+        url = "git+https://example.com/package#subdirectory=subdir&egg=eggname"
+        assert "eggname" == Link(url).egg_fragment
+        assert "subdir" == Link(url).subdirectory_fragment
+
+        # Extras are supported and preserved in the egg fragment,
+        # even the empty extras specifier.
+        # This behavior is deprecated and will change in pip 25.
+        url = "git+https://example.com/package#egg=eggnameextra"
+        assert "eggnameextra" == Link(url).egg_fragment
+        assert None is Link(url).subdirectory_fragment
+        url = "git+https://example.com/package#egg=eggnameextra1,extra2"
+        assert "eggnameextra1,extra2" == Link(url).egg_fragment
+        assert None is Link(url).subdirectory_fragment
+        url = "git+https://example.com/package#egg=eggname"
+        assert "eggname" == Link(url).egg_fragment
+        assert None is Link(url).subdirectory_fragment
+
+    @pytest.mark.xfail(reason="Behavior change scheduled for 25.0", strict=True)
+    @pytest.mark.parametrize(
+        "fragment",
+        
+            # Package names in egg fragments must be in PEP 508 form.
+            "~invalid~package~name~",
+            # Version specifiers are not valid in egg fragments.
+            "eggname==1.2.3",
+            "eggname>=1.2.3",
+            # The extras specifier must be in PEP 508 form.
+            "eggname!",
+        ,
+    )
+    def test_invalid_egg_fragments(self, fragment: str) -> None:
+        url = f"git+https://example.com/package#egg={fragment}"
+        with pytest.raises(ValueError):
+            Link(url)
+
+    @pytest.mark.parametrize(
+        "yanked_reason, expected",
+        
+            (None, False),
+            ("", True),
+            ("there was a mistake", True),
+        ,
+    )
+    def test_is_yanked(self, yanked_reason: Optionalstr, expected: bool) -> None:
+        link = Link(
+            "https://example.com/wheel.whl",
+            yanked_reason=yanked_reason,
+        )
+        assert link.is_yanked == expected
+
+    @pytest.mark.parametrize(
+        "hash_name, hex_digest, expected",
+        
+            # Test a value that matches but with the wrong hash_name.
+            ("sha384", 128 * "a", False),
+            # Test matching values, including values other than the first.
+            ("sha512", 128 * "a", True),
+            ("sha512", 128 * "b", True),
+            # Test a matching hash_name with a value that doesn't match.
+            ("sha512", 128 * "c", False),
+            # Test a link without a hash value.
+            ("sha512", "", False),
+        ,
+    )
+    def test_is_hash_allowed(
+        self, hash_name: str, hex_digest: str, expected: bool
+    ) -> None:
+        url = "https://example.com/wheel.whl#{hash_name}={hex_digest}".format(
+            hash_name=hash_name,
+            hex_digest=hex_digest,
+        )
+        link = Link(url)
+        hashes_data = {
+            "sha512": 128 * "a", 128 * "b",
+        }
+        hashes = Hashes(hashes_data)
+        assert link.is_hash_allowed(hashes) == expected
+
+    def test_is_hash_allowed__no_hash(self) -> None:
+        link = Link("https://example.com/wheel.whl")
+        hashes_data = {
+            "sha512": 128 * "a",
+        }
+        hashes = Hashes(hashes_data)
+        assert not link.is_hash_allowed(hashes)
+
+    @pytest.mark.parametrize(
+        "hashes, expected",
+        
+            (None, False),
+            # Also test a success case to show the test is correct.
+            (Hashes({"sha512": 128 * "a"}), True),
+        ,
+    )
+    def test_is_hash_allowed__none_hashes(
+        self, hashes: OptionalHashes, expected: bool
+    ) -> None:
+        url = "https://example.com/wheel.whl#sha512={}".format(128 * "a")
+        link = Link(url)
+        assert link.is_hash_allowed(hashes) == expected
+
+    @pytest.mark.parametrize(
+        "url, expected",
+        
+            ("git+https://github.com/org/repo", True),
+            ("bzr+http://bzr.myproject.org/MyProject/trunk/#egg=MyProject", True),
+            ("hg+file://hg.company.com/repo", True),
+            ("https://example.com/some.whl", False),
+            ("file://home/foo/some.whl", False),
+        ,
+    )
+    def test_is_vcs(self, url: str, expected: bool) -> None:
+        link = Link(url)
+        assert link.is_vcs is expected
+
+
+@pytest.mark.parametrize(
+    "url1, url2",
+    
+        pytest.param(
+            "https://example.com/foo#egg=foo",
+            "https://example.com/foo",
+            id="drop-egg",
+        ),
+        pytest.param(
+            "https://example.com/foo#subdirectory=bar&egg=foo",
+            "https://example.com/foo#subdirectory=bar&egg=bar",
+            id="drop-egg-only",
+        ),
+        pytest.param(
+            "https://example.com/foo#subdirectory=bar&egg=foo",
+            "https://example.com/foo#egg=foo&subdirectory=bar",
+            id="fragment-ordering",
+        ),
+        pytest.param(
+            "https://example.com/foo?a=1&b=2",
+            "https://example.com/foo?b=2&a=1",
+            id="query-opordering",
+        ),
+    ,
+)
+def test_links_equivalent(url1: str, url2: str) -> None:
+    assert links_equivalent(Link(url1), Link(url2))
+
+
+@pytest.mark.parametrize(
+    "url1, url2",
+    
+        pytest.param(
+            "https://example.com/foo#sha512=1234567890abcdef",
+            "https://example.com/foo#sha512=abcdef1234567890",
+            id="different-keys",
+        ),
+        pytest.param(
+            "https://example.com/foo#sha512=1234567890abcdef",
+            "https://example.com/foo#md5=1234567890abcdef",
+            id="different-values",
+        ),
+        pytest.param(
+            "https://example.com/foo#subdirectory=bar&egg=foo",
+            "https://example.com/foo#subdirectory=rex",
+            id="drop-egg-still-different",
+        ),
+    ,
+)
+def test_links_equivalent_false(url1: str, url2: str) -> None:
+    assert not links_equivalent(Link(url1), Link(url2))

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_locations.py Added

@@ -0,0 +1,180 @@
+"""
+locations.py tests
+
+"""
+import getpass
+import os
+import shutil
+import sys
+import sysconfig
+import tempfile
+from pathlib import Path
+from typing import Any, Dict
+from unittest.mock import Mock
+
+import pytest
+
+from pip._internal.locations import SCHEME_KEYS, _should_use_sysconfig, get_scheme
+
+if sys.platform == "win32":
+    pwd = Mock()
+else:
+    import pwd
+
+
+def _get_scheme_dict(*args: Any, **kwargs: Any) -> Dictstr, str:
+    scheme = get_scheme(*args, **kwargs)
+    return {k: getattr(scheme, k) for k in SCHEME_KEYS}
+
+
+class TestLocations:
+    def setup_method(self) -> None:
+        self.tempdir = tempfile.mkdtemp()
+        self.st_uid = 9999
+        self.username = "example"
+        self.patch()
+
+    def teardown_method(self) -> None:
+        self.revert_patch()
+        shutil.rmtree(self.tempdir, ignore_errors=True)
+
+    def patch(self) -> None:
+        """first store and then patch python methods pythons"""
+        self.tempfile_gettempdir = tempfile.gettempdir
+        self.old_os_fstat = os.fstat
+        if sys.platform != "win32":
+            # os.geteuid and pwd.getpwuid are not implemented on windows
+            self.old_os_geteuid = os.geteuid
+            self.old_pwd_getpwuid = pwd.getpwuid
+        self.old_getpass_getuser = getpass.getuser
+
+        # now patch
+        tempfile.gettempdir = lambda: self.tempdir
+        getpass.getuser = lambda: self.username
+        os.fstat = lambda fd: self.get_mock_fstat(fd)
+        if sys.platform != "win32":
+            os.geteuid = lambda: self.st_uid
+            pwd.getpwuid = self.get_mock_getpwuid
+
+    def revert_patch(self) -> None:
+        """revert the patches to python methods"""
+        tempfile.gettempdir = self.tempfile_gettempdir
+        getpass.getuser = self.old_getpass_getuser
+        if sys.platform != "win32":
+            # os.geteuid and pwd.getpwuid are not implemented on windows
+            os.geteuid = self.old_os_geteuid
+            pwd.getpwuid = self.old_pwd_getpwuid
+        os.fstat = self.old_os_fstat
+
+    def get_mock_fstat(self, fd: int) -> os.stat_result:
+        """returns a basic mock fstat call result.
+        Currently only the st_uid attribute has been set.
+        """
+        result = Mock()
+        result.st_uid = self.st_uid
+        return result
+
+    def get_mock_getpwuid(self, uid: int) -> Any:
+        """returns a basic mock pwd.getpwuid call result.
+        Currently only the pw_name attribute has been set.
+        """
+        result = Mock()
+        result.pw_name = self.username
+        return result
+
+    def test_default_should_use_sysconfig(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.delattr(sysconfig, "_PIP_USE_SYSCONFIG", raising=False)
+        if sys.version_info:2 >= (3, 10):
+            assert _should_use_sysconfig() is True
+        else:
+            assert _should_use_sysconfig() is False
+
+    @pytest.mark.parametrize("vendor_value", True, False, None, "", 0, 1)
+    def test_vendor_overriden_should_use_sysconfig(
+        self, monkeypatch: pytest.MonkeyPatch, vendor_value: Any
+    ) -> None:
+        monkeypatch.setattr(
+            sysconfig, "_PIP_USE_SYSCONFIG", vendor_value, raising=False
+        )
+        assert _should_use_sysconfig() is bool(vendor_value)
+
+
+class TestDistutilsScheme:
+    def test_root_modifies_appropriately(self) -> None:
+        # This deals with nt/posix path differences
+        # root is c:\somewhere\else or /somewhere/else
+        root = os.path.normcase(
+            os.path.abspath(os.path.join(os.path.sep, "somewhere", "else"))
+        )
+        norm_scheme = _get_scheme_dict("example")
+        root_scheme = _get_scheme_dict("example", root=root)
+
+        for key, value in norm_scheme.items():
+            drive, path = os.path.splitdrive(os.path.abspath(value))
+            expected = os.path.join(root, path1:)
+            assert os.path.abspath(root_schemekey) == expected
+
+    @pytest.mark.incompatible_with_sysconfig
+    @pytest.mark.incompatible_with_venv
+    def test_distutils_config_file_read(
+        self, tmpdir: Path, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # This deals with nt/posix path differences
+        install_scripts = os.path.normcase(
+            os.path.abspath(os.path.join(os.path.sep, "somewhere", "else"))
+        )
+        f = tmpdir / "config" / "setup.cfg"
+        f.parent.mkdir()
+        f.write_text("install\ninstall-scripts=" + install_scripts)
+        from distutils.dist import Distribution
+
+        # patch the function that returns what config files are present
+        monkeypatch.setattr(
+            Distribution,
+            "find_config_files",
+            lambda self: f,
+        )
+        scheme = _get_scheme_dict("example")
+        assert scheme"scripts" == install_scripts
+
+    @pytest.mark.incompatible_with_sysconfig
+    @pytest.mark.incompatible_with_venv
+    # when we request install-lib, we should install everything (.py &
+    # .so) into that path; i.e. ensure platlib & purelib are set to
+    # this path. sysconfig does not support this.
+    def test_install_lib_takes_precedence(
+        self, tmpdir: Path, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # This deals with nt/posix path differences
+        install_lib = os.path.normcase(
+            os.path.abspath(os.path.join(os.path.sep, "somewhere", "else"))
+        )
+        f = tmpdir / "config" / "setup.cfg"
+        f.parent.mkdir()
+        f.write_text("install\ninstall-lib=" + install_lib)
+        from distutils.dist import Distribution
+
+        # patch the function that returns what config files are present
+        monkeypatch.setattr(
+            Distribution,
+            "find_config_files",
+            lambda self: f,
+        )
+        scheme = _get_scheme_dict("example")
+        assert scheme"platlib" == install_lib + os.path.sep
+        assert scheme"purelib" == install_lib + os.path.sep
+
+    def test_prefix_modifies_appropriately(self) -> None:
+        prefix = os.path.abspath(os.path.join("somewhere", "else"))
+
+        normal_scheme = _get_scheme_dict("example")
+        prefix_scheme = _get_scheme_dict("example", prefix=prefix)
+
+        def _calculate_expected(value: str) -> str:
+            path = os.path.join(prefix, os.path.relpath(value, sys.prefix))
+            return os.path.normpath(path)
+
+        expected = {k: _calculate_expected(v) for k, v in normal_scheme.items()}
+        assert prefix_scheme == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_logging.py Added

@@ -0,0 +1,192 @@
+import logging
+import time
+from threading import Thread
+from unittest.mock import patch
+
+import pytest
+
+from pip._internal.utils.logging import (
+    BrokenStdoutLoggingError,
+    IndentingFormatter,
+    RichPipStreamHandler,
+    indent_log,
+)
+from pip._internal.utils.misc import captured_stderr, captured_stdout
+
+logger = logging.getLogger(__name__)
+
+
+class TestIndentingFormatter:
+    """Test ``pip._internal.utils.logging.IndentingFormatter``."""
+
+    def make_record(self, msg: str, level_name: str) -> logging.LogRecord:
+        level_number = getattr(logging, level_name)
+        attrs = dict(
+            msg=msg,
+            created=1547704837.040001 + time.timezone,
+            msecs=40,
+            levelname=level_name,
+            levelno=level_number,
+        )
+        record = logging.makeLogRecord(attrs)
+
+        return record
+
+    @pytest.mark.parametrize(
+        "level_name, expected",
+        
+            ("DEBUG", "hello\nworld"),
+            ("INFO", "hello\nworld"),
+            ("WARNING", "WARNING: hello\nworld"),
+            ("ERROR", "ERROR: hello\nworld"),
+            ("CRITICAL", "ERROR: hello\nworld"),
+        ,
+    )
+    def test_format(self, level_name: str, expected: str) -> None:
+        """
+        Args:
+          level_name: a logging level name (e.g. "WARNING").
+        """
+        record = self.make_record("hello\nworld", level_name=level_name)
+        f = IndentingFormatter(fmt="%(message)s")
+        assert f.format(record) == expected
+
+    @pytest.mark.parametrize(
+        "level_name, expected",
+        
+            ("INFO", "2019-01-17T06:00:37,040 hello\n2019-01-17T06:00:37,040 world"),
+            (
+                "WARNING",
+                "2019-01-17T06:00:37,040 WARNING: hello\n"
+                "2019-01-17T06:00:37,040 world",
+            ),
+        ,
+    )
+    def test_format_with_timestamp(self, level_name: str, expected: str) -> None:
+        record = self.make_record("hello\nworld", level_name=level_name)
+        f = IndentingFormatter(fmt="%(message)s", add_timestamp=True)
+        assert f.format(record) == expected
+
+    @pytest.mark.parametrize(
+        "level_name, expected",
+        
+            ("WARNING", "DEPRECATION: hello\nworld"),
+            ("ERROR", "DEPRECATION: hello\nworld"),
+            ("CRITICAL", "DEPRECATION: hello\nworld"),
+        ,
+    )
+    def test_format_deprecated(self, level_name: str, expected: str) -> None:
+        """
+        Test that logged deprecation warnings coming from deprecated()
+        don't get another prefix.
+        """
+        record = self.make_record(
+            "DEPRECATION: hello\nworld",
+            level_name=level_name,
+        )
+        f = IndentingFormatter(fmt="%(message)s")
+        assert f.format(record) == expected
+
+    def test_thread_safety_base(self) -> None:
+        record = self.make_record(
+            "DEPRECATION: hello\nworld",
+            level_name="WARNING",
+        )
+        f = IndentingFormatter(fmt="%(message)s")
+        results = 
+
+        def thread_function() -> None:
+            results.append(f.format(record))
+
+        thread_function()
+        thread = Thread(target=thread_function)
+        thread.start()
+        thread.join()
+        assert results0 == results1
+
+    def test_thread_safety_indent_log(self) -> None:
+        record = self.make_record(
+            "DEPRECATION: hello\nworld",
+            level_name="WARNING",
+        )
+        f = IndentingFormatter(fmt="%(message)s")
+        results = 
+
+        def thread_function() -> None:
+            with indent_log():
+                results.append(f.format(record))
+
+        thread_function()
+        thread = Thread(target=thread_function)
+        thread.start()
+        thread.join()
+        assert results0 == results1
+
+
+class TestColorizedStreamHandler:
+    def _make_log_record(self) -> logging.LogRecord:
+        attrs = {
+            "msg": "my error",
+        }
+        record = logging.makeLogRecord(attrs)
+
+        return record
+
+    def test_broken_pipe_in_stderr_flush(self) -> None:
+        """
+        Test sys.stderr.flush() raising BrokenPipeError.
+
+        This error should _not_ trigger an error in the logging framework.
+        """
+        record = self._make_log_record()
+
+        with captured_stderr() as stderr:
+            handler = RichPipStreamHandler(stream=stderr, no_color=True)
+            with patch("sys.stderr.flush") as mock_flush:
+                mock_flush.side_effect = BrokenPipeError()
+                # The emit() call raises no exception.
+                handler.emit(record)
+
+            err_text = stderr.getvalue()
+
+        assert err_text.startswith("my error")
+        # Check that the logging framework tried to log the exception.
+        assert "Logging error" in err_text
+        assert "BrokenPipeError" in err_text
+        assert "Message: 'my error'" in err_text
+
+    def test_broken_pipe_in_stdout_write(self) -> None:
+        """
+        Test sys.stdout.write() raising BrokenPipeError.
+
+        This error _should_ trigger an error in the logging framework.
+        """
+        record = self._make_log_record()
+
+        with captured_stdout() as stdout:
+            handler = RichPipStreamHandler(stream=stdout, no_color=True)
+            with patch("sys.stdout.write") as mock_write:
+                mock_write.side_effect = BrokenPipeError()
+                with pytest.raises(BrokenStdoutLoggingError):
+                    handler.emit(record)
+
+    def test_broken_pipe_in_stdout_flush(self) -> None:
+        """
+        Test sys.stdout.flush() raising BrokenPipeError.
+
+        This error _should_ trigger an error in the logging framework.
+        """
+        record = self._make_log_record()
+
+        with captured_stdout() as stdout:
+            handler = RichPipStreamHandler(stream=stdout, no_color=True)
+            with patch("sys.stdout.flush") as mock_flush:
+                mock_flush.side_effect = BrokenPipeError()
+                with pytest.raises(BrokenStdoutLoggingError):
+                    handler.emit(record)
+
+            output = stdout.getvalue()
+
+        # Sanity check that the log record was written, since flush() happens
+        # after write().
+        assert output.startswith("my error")

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_models.py Added

@@ -0,0 +1,59 @@
+"""Tests for various classes in pip._internal.models
+"""
+
+from pip._vendor.packaging.version import parse as parse_version
+
+from pip._internal.models import candidate, index
+from pip._internal.models.link import Link
+
+
+class TestPackageIndex:
+    """Tests for pip._internal.models.index.PackageIndex"""
+
+    def test_gives_right_urls(self) -> None:
+        url = "https://mypypi.internal/path/"
+        file_storage_domain = "files.mypypi.internal"
+        pack_index = index.PackageIndex(url, file_storage_domain)
+
+        assert pack_index.url == url
+        assert pack_index.file_storage_domain == file_storage_domain
+
+        assert pack_index.netloc == "mypypi.internal"
+        assert pack_index.simple_url == url + "simple"
+        assert pack_index.pypi_url == url + "pypi"
+
+    def test_PyPI_urls_are_correct(self) -> None:
+        pack_index = index.PyPI
+
+        assert pack_index.netloc == "pypi.org"
+        assert pack_index.url == "https://pypi.org/"
+        assert pack_index.simple_url == "https://pypi.org/simple"
+        assert pack_index.pypi_url == "https://pypi.org/pypi"
+        assert pack_index.file_storage_domain == "files.pythonhosted.org"
+
+    def test_TestPyPI_urls_are_correct(self) -> None:
+        pack_index = index.TestPyPI
+
+        assert pack_index.netloc == "test.pypi.org"
+        assert pack_index.url == "https://test.pypi.org/"
+        assert pack_index.simple_url == "https://test.pypi.org/simple"
+        assert pack_index.pypi_url == "https://test.pypi.org/pypi"
+        assert pack_index.file_storage_domain == "test-files.pythonhosted.org"
+
+
+class TestInstallationCandidate:
+    def test_sets_correct_variables(self) -> None:
+        obj = candidate.InstallationCandidate(
+            "A", "1.0.0", Link("https://somewhere.com/path/A-1.0.0.tar.gz")
+        )
+        assert obj.name == "A"
+        assert obj.version == parse_version("1.0.0")
+        assert obj.link.url == "https://somewhere.com/path/A-1.0.0.tar.gz"
+
+    # NOTE: This isn't checking the ordering logic; only the data provided to
+    #       it is correct.
+    def test_sets_the_right_key(self) -> None:
+        obj = candidate.InstallationCandidate(
+            "A", "1.0.0", Link("https://somewhere.com/path/A-1.0.0.tar.gz")
+        )
+        assert obj._compare_key == (obj.name, obj.version, obj.link)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_models_wheel.py Added

@@ -0,0 +1,179 @@
+import pytest
+from pip._vendor.packaging.tags import Tag
+
+from pip._internal.exceptions import InvalidWheelFilename
+from pip._internal.models.wheel import Wheel
+from pip._internal.utils import compatibility_tags
+
+
+class TestWheelFile:
+    def test_std_wheel_pattern(self) -> None:
+        w = Wheel("simple-1.1.1-py2-none-any.whl")
+        assert w.name == "simple"
+        assert w.version == "1.1.1"
+        assert w.pyversions == "py2"
+        assert w.abis == "none"
+        assert w.plats == "any"
+
+    def test_wheel_pattern_multi_values(self) -> None:
+        w = Wheel("simple-1.1-py2.py3-abi1.abi2-any.whl")
+        assert w.name == "simple"
+        assert w.version == "1.1"
+        assert w.pyversions == "py2", "py3"
+        assert w.abis == "abi1", "abi2"
+        assert w.plats == "any"
+
+    def test_wheel_with_build_tag(self) -> None:
+        # pip doesn't do anything with build tags, but theoretically, we might
+        # see one, in this case the build tag = '4'
+        w = Wheel("simple-1.1-4-py2-none-any.whl")
+        assert w.name == "simple"
+        assert w.version == "1.1"
+        assert w.pyversions == "py2"
+        assert w.abis == "none"
+        assert w.plats == "any"
+
+    def test_single_digit_version(self) -> None:
+        w = Wheel("simple-1-py2-none-any.whl")
+        assert w.version == "1"
+
+    def test_non_pep440_version(self) -> None:
+        w = Wheel("simple-_invalid_-py2-none-any.whl")
+        assert w.version == "-invalid-"
+
+    def test_missing_version_raises(self) -> None:
+        with pytest.raises(InvalidWheelFilename):
+            Wheel("Cython-cp27-none-linux_x86_64.whl")
+
+    def test_invalid_filename_raises(self) -> None:
+        with pytest.raises(InvalidWheelFilename):
+            Wheel("invalid.whl")
+
+    def test_supported_single_version(self) -> None:
+        """
+        Test single-version wheel is known to be supported
+        """
+        w = Wheel("simple-0.1-py2-none-any.whl")
+        assert w.supported(tags=Tag("py2", "none", "any"))
+
+    def test_supported_multi_version(self) -> None:
+        """
+        Test multi-version wheel is known to be supported
+        """
+        w = Wheel("simple-0.1-py2.py3-none-any.whl")
+        assert w.supported(tags=Tag("py3", "none", "any"))
+
+    def test_not_supported_version(self) -> None:
+        """
+        Test unsupported wheel is known to be unsupported
+        """
+        w = Wheel("simple-0.1-py2-none-any.whl")
+        assert not w.supported(tags=Tag("py1", "none", "any"))
+
+    def test_supported_osx_version(self) -> None:
+        """
+        Wheels built for macOS 10.6 are supported on 10.9
+        """
+        tags = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_9_intel", impl="cp"
+        )
+        w = Wheel("simple-0.1-cp27-none-macosx_10_6_intel.whl")
+        assert w.supported(tags=tags)
+        w = Wheel("simple-0.1-cp27-none-macosx_10_9_intel.whl")
+        assert w.supported(tags=tags)
+
+    def test_not_supported_osx_version(self) -> None:
+        """
+        Wheels built for macOS 10.9 are not supported on 10.6
+        """
+        tags = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_6_intel", impl="cp"
+        )
+        w = Wheel("simple-0.1-cp27-none-macosx_10_9_intel.whl")
+        assert not w.supported(tags=tags)
+
+    def test_supported_multiarch_darwin(self) -> None:
+        """
+        Multi-arch wheels (intel) are supported on components (i386, x86_64)
+        """
+        universal = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_universal", impl="cp"
+        )
+        intel = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_intel", impl="cp"
+        )
+        x64 = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_x86_64", impl="cp"
+        )
+        i386 = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_i386", impl="cp"
+        )
+        ppc = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_ppc", impl="cp"
+        )
+        ppc64 = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_ppc64", impl="cp"
+        )
+
+        w = Wheel("simple-0.1-cp27-none-macosx_10_5_intel.whl")
+        assert w.supported(tags=intel)
+        assert w.supported(tags=x64)
+        assert w.supported(tags=i386)
+        assert not w.supported(tags=universal)
+        assert not w.supported(tags=ppc)
+        assert not w.supported(tags=ppc64)
+        w = Wheel("simple-0.1-cp27-none-macosx_10_5_universal.whl")
+        assert w.supported(tags=universal)
+        assert w.supported(tags=intel)
+        assert w.supported(tags=x64)
+        assert w.supported(tags=i386)
+        assert w.supported(tags=ppc)
+        assert w.supported(tags=ppc64)
+
+    def test_not_supported_multiarch_darwin(self) -> None:
+        """
+        Single-arch wheels (x86_64) are not supported on multi-arch (intel)
+        """
+        universal = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_universal", impl="cp"
+        )
+        intel = compatibility_tags.get_supported(
+            "27", platforms="macosx_10_5_intel", impl="cp"
+        )
+
+        w = Wheel("simple-0.1-cp27-none-macosx_10_5_i386.whl")
+        assert not w.supported(tags=intel)
+        assert not w.supported(tags=universal)
+        w = Wheel("simple-0.1-cp27-none-macosx_10_5_x86_64.whl")
+        assert not w.supported(tags=intel)
+        assert not w.supported(tags=universal)
+
+    def test_support_index_min(self) -> None:
+        """
+        Test results from `support_index_min`
+        """
+        tags = 
+            Tag("py2", "none", "TEST"),
+            Tag("py2", "TEST", "any"),
+            Tag("py2", "none", "any"),
+        
+        w = Wheel("simple-0.1-py2-none-any.whl")
+        assert w.support_index_min(tags=tags) == 2
+        w = Wheel("simple-0.1-py2-none-TEST.whl")
+        assert w.support_index_min(tags=tags) == 0
+
+    def test_support_index_min__none_supported(self) -> None:
+        """
+        Test a wheel not supported by the given tags.
+        """
+        w = Wheel("simple-0.1-py2-none-any.whl")
+        with pytest.raises(ValueError):
+            w.support_index_min(tags=)
+
+    def test_version_underscore_conversion(self) -> None:
+        """
+        Test that we convert '_' to '-' for versions parsed out of wheel
+        filenames
+        """
+        w = Wheel("simple-0.1_1-py2-none-any.whl")
+        assert w.version == "0.1-1"

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_network_auth.py Added

@@ -0,0 +1,540 @@
+import functools
+import os
+import subprocess
+import sys
+from typing import Any, Dict, Iterable, List, Optional, Tuple
+
+import pytest
+
+import pip._internal.network.auth
+from pip._internal.network.auth import MultiDomainBasicAuth
+from tests.lib.requests_mocks import MockConnection, MockRequest, MockResponse
+
+
+@pytest.fixture(scope="function", autouse=True)
+def reset_keyring() -> IterableNone:
+    yield None
+    # Reset the state of the module between tests
+    pip._internal.network.auth.KEYRING_DISABLED = False
+    pip._internal.network.auth.get_keyring_provider.cache_clear()
+
+
+@pytest.mark.parametrize(
+    "input_url", "url", "username", "password",
+    
+        (
+            "http://user%40email.com:password@example.com/path",
+            "http://example.com/path",
+            "user@email.com",
+            "password",
+        ),
+        (
+            "http://username:password@example.com/path",
+            "http://example.com/path",
+            "username",
+            "password",
+        ),
+        (
+            "http://token@example.com/path",
+            "http://example.com/path",
+            "token",
+            "",
+        ),
+        (
+            "http://example.com/path",
+            "http://example.com/path",
+            None,
+            None,
+        ),
+    ,
+)
+def test_get_credentials_parses_correctly(
+    input_url: str, url: str, username: Optionalstr, password: Optionalstr
+) -> None:
+    auth = MultiDomainBasicAuth()
+    get = auth._get_url_and_credentials
+
+    # Check URL parsing
+    assert get(input_url) == (url, username, password)
+    assert (
+        # There are no credentials in the URL
+        (username is None and password is None)
+        or
+        # Credentials were found and "cached" appropriately
+        auth.passwords"example.com" == (username, password)
+    )
+
+
+def test_get_credentials_not_to_uses_cached_credentials() -> None:
+    auth = MultiDomainBasicAuth()
+    auth.passwords"example.com" = ("user", "pass")
+
+    got = auth._get_url_and_credentials("http://foo:bar@example.com/path")
+    expected = ("http://example.com/path", "foo", "bar")
+    assert got == expected
+
+
+def test_get_credentials_not_to_uses_cached_credentials_only_username() -> None:
+    auth = MultiDomainBasicAuth()
+    auth.passwords"example.com" = ("user", "pass")
+
+    got = auth._get_url_and_credentials("http://foo@example.com/path")
+    expected = ("http://example.com/path", "foo", "")
+    assert got == expected
+
+
+def test_get_credentials_uses_cached_credentials() -> None:
+    auth = MultiDomainBasicAuth()
+    auth.passwords"example.com" = ("user", "pass")
+
+    got = auth._get_url_and_credentials("http://example.com/path")
+    expected = ("http://example.com/path", "user", "pass")
+    assert got == expected
+
+
+def test_get_credentials_uses_cached_credentials_only_username() -> None:
+    auth = MultiDomainBasicAuth()
+    auth.passwords"example.com" = ("user", "pass")
+
+    got = auth._get_url_and_credentials("http://user@example.com/path")
+    expected = ("http://example.com/path", "user", "pass")
+    assert got == expected
+
+
+def test_get_index_url_credentials() -> None:
+    auth = MultiDomainBasicAuth(
+        index_urls=
+            "http://example.com/",
+            "http://foo:bar@example.com/path",
+        
+    )
+    get = functools.partial(
+        auth._get_new_credentials, allow_netrc=False, allow_keyring=False
+    )
+
+    # Check resolution of indexes
+    assert get("http://example.com/path/path2") == ("foo", "bar")
+    assert get("http://example.com/path3/path2") == (None, None)
+
+
+def test_prioritize_longest_path_prefix_match_organization() -> None:
+    auth = MultiDomainBasicAuth(
+        index_urls=
+            "http://foo:bar@example.com/org-name-alpha/repo-alias/simple",
+            "http://bar:foo@example.com/org-name-beta/repo-alias/simple",
+        
+    )
+    get = functools.partial(
+        auth._get_new_credentials, allow_netrc=False, allow_keyring=False
+    )
+
+    # Inspired by Azure DevOps URL structure, GitLab should look similar
+    assert get("http://example.com/org-name-alpha/repo-guid/dowbload/") == (
+        "foo",
+        "bar",
+    )
+    assert get("http://example.com/org-name-beta/repo-guid/dowbload/") == ("bar", "foo")
+
+
+def test_prioritize_longest_path_prefix_match_project() -> None:
+    auth = MultiDomainBasicAuth(
+        index_urls=
+            "http://foo:bar@example.com/org-alpha/project-name-alpha/repo-alias/simple",
+            "http://bar:foo@example.com/org-alpha/project-name-beta/repo-alias/simple",
+        
+    )
+    get = functools.partial(
+        auth._get_new_credentials, allow_netrc=False, allow_keyring=False
+    )
+
+    # Inspired by Azure DevOps URL structure, GitLab should look similar
+    assert get(
+        "http://example.com/org-alpha/project-name-alpha/repo-guid/dowbload/"
+    ) == ("foo", "bar")
+    assert get(
+        "http://example.com/org-alpha/project-name-beta/repo-guid/dowbload/"
+    ) == ("bar", "foo")
+
+
+class KeyringModuleV1:
+    """Represents the supported API of keyring before get_credential
+    was added.
+    """
+
+    def __init__(self) -> None:
+        self.saved_passwords: ListTuplestr, str, str = 
+
+    def get_password(self, system: str, username: str) -> Optionalstr:
+        if system == "example.com" and username:
+            return username + "!netloc"
+        if system == "http://example.com/path2/" and username:
+            return username + "!url"
+        return None
+
+    def set_password(self, system: str, username: str, password: str) -> None:
+        self.saved_passwords.append((system, username, password))
+
+
+@pytest.mark.parametrize(
+    "url, expect",
+    (
+        ("http://example.com/path1", (None, None)),
+        # path1 URLs will be resolved by netloc
+        ("http://user@example.com/path3", ("user", "user!netloc")),
+        ("http://user2@example.com/path3", ("user2", "user2!netloc")),
+        # path2 URLs will be resolved by index URL
+        ("http://example.com/path2/path3", (None, None)),
+        ("http://foo@example.com/path2/path3", ("foo", "foo!url")),
+    ),
+)
+def test_keyring_get_password(
+    monkeypatch: pytest.MonkeyPatch,
+    url: str,
+    expect: TupleOptionalstr, Optionalstr,
+) -> None:
+    keyring = KeyringModuleV1()
+    monkeypatch.setitem(sys.modules, "keyring", keyring)  # type: ignoremisc
+    auth = MultiDomainBasicAuth(
+        index_urls="http://example.com/path2", "http://example.com/path3",
+        keyring_provider="import",
+    )
+
+    actual = auth._get_new_credentials(url, allow_netrc=False, allow_keyring=True)
+    assert actual == expect
+
+
+def test_keyring_get_password_after_prompt(monkeypatch: pytest.MonkeyPatch) -> None:
+    keyring = KeyringModuleV1()
+    monkeypatch.setitem(sys.modules, "keyring", keyring)  # type: ignoremisc
+    auth = MultiDomainBasicAuth(keyring_provider="import")
+
+    def ask_input(prompt: str) -> str:
+        assert prompt == "User for example.com: "
+        return "user"
+
+    monkeypatch.setattr("pip._internal.network.auth.ask_input", ask_input)
+    actual = auth._prompt_for_password("example.com")
+    assert actual == ("user", "user!netloc", False)
+
+
+def test_keyring_get_password_after_prompt_when_none(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    keyring = KeyringModuleV1()
+    monkeypatch.setitem(sys.modules, "keyring", keyring)  # type: ignoremisc
+    auth = MultiDomainBasicAuth(keyring_provider="import")
+
+    def ask_input(prompt: str) -> str:
+        assert prompt == "User for unknown.com: "
+        return "user"
+
+    def ask_password(prompt: str) -> str:
+        assert prompt == "Password: "
+        return "fake_password"
+
+    monkeypatch.setattr("pip._internal.network.auth.ask_input", ask_input)
+    monkeypatch.setattr("pip._internal.network.auth.ask_password", ask_password)
+    actual = auth._prompt_for_password("unknown.com")
+    assert actual == ("user", "fake_password", True)
+
+
+def test_keyring_get_password_username_in_index(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    keyring = KeyringModuleV1()
+    monkeypatch.setitem(sys.modules, "keyring", keyring)  # type: ignoremisc
+    auth = MultiDomainBasicAuth(
+        index_urls="http://user@example.com/path2", "http://example.com/path4",
+        keyring_provider="import",
+    )
+    get = functools.partial(
+        auth._get_new_credentials, allow_netrc=False, allow_keyring=True
+    )
+
+    assert get("http://example.com/path2/path3") == ("user", "user!url")
+    assert get("http://example.com/path4/path1") == (None, None)
+
+
+@pytest.mark.parametrize(
+    "response_status, creds, expect_save",
+    (
+        (403, ("user", "pass", True), False),
+        (
+            200,
+            ("user", "pass", True),
+            True,
+        ),
+        (
+            200,
+            ("user", "pass", False),
+            False,
+        ),
+    ),
+)
+def test_keyring_set_password(
+    monkeypatch: pytest.MonkeyPatch,
+    response_status: int,
+    creds: Tuplestr, str, bool,
+    expect_save: bool,
+) -> None:
+    keyring = KeyringModuleV1()
+    monkeypatch.setitem(sys.modules, "keyring", keyring)  # type: ignoremisc
+    auth = MultiDomainBasicAuth(prompting=True, keyring_provider="import")
+    monkeypatch.setattr(auth, "_get_url_and_credentials", lambda u: (u, None, None))
+    monkeypatch.setattr(auth, "_prompt_for_password", lambda *a: creds)
+    if creds2:
+        # when _prompt_for_password indicates to save, we should save
+        def should_save_password_to_keyring(*a: Any) -> bool:
+            return True
+
+    else:
+        # when _prompt_for_password indicates not to save, we should
+        # never call this function
+        def should_save_password_to_keyring(*a: Any) -> bool:
+            assert False, "_should_save_password_to_keyring should not be called"
+
+    monkeypatch.setattr(
+        auth, "_should_save_password_to_keyring", should_save_password_to_keyring
+    )
+
+    req = MockRequest("https://example.com")
+    resp = MockResponse(b"")
+    resp.url = req.url
+    connection = MockConnection()
+
+    def _send(sent_req: MockRequest, **kwargs: Any) -> MockResponse:
+        assert sent_req is req
+        assert "Authorization" in sent_req.headers
+        r = MockResponse(b"")
+        r.status_code = response_status
+        return r
+
+    # https://github.com/python/mypy/issues/2427
+    connection._send = _send  # type: ignoreassignment
+
+    resp.request = req
+    resp.status_code = 401
+    resp.connection = connection
+
+    auth.handle_401(resp)
+
+    if expect_save:
+        assert keyring.saved_passwords == ("example.com", creds0, creds1)
+    else:
+        assert keyring.saved_passwords == 
+
+
+class KeyringModuleV2:
+    """Represents the current supported API of keyring"""
+
+    class Credential:
+        def __init__(self, username: str, password: str) -> None:
+            self.username = username
+            self.password = password
+
+    def get_password(self, system: str, username: str) -> None:
+        assert False, "get_password should not ever be called"
+
+    def get_credential(self, system: str, username: str) -> OptionalCredential:
+        if system == "http://example.com/path2/":
+            return self.Credential("username", "url")
+        if system == "example.com":
+            return self.Credential("username", "netloc")
+        return None
+
+
+@pytest.mark.parametrize(
+    "url, expect",
+    (
+        ("http://example.com/path1", ("username", "netloc")),
+        ("http://example.com/path2/path3", ("username", "url")),
+        ("http://user2@example.com/path2/path3", ("username", "url")),
+    ),
+)
+def test_keyring_get_credential(
+    monkeypatch: pytest.MonkeyPatch, url: str, expect: str
+) -> None:
+    monkeypatch.setitem(sys.modules, "keyring", KeyringModuleV2())  # type: ignoremisc
+    auth = MultiDomainBasicAuth(
+        index_urls="http://example.com/path1", "http://example.com/path2",
+        keyring_provider="import",
+    )
+
+    assert (
+        auth._get_new_credentials(url, allow_netrc=False, allow_keyring=True) == expect
+    )
+
+
+class KeyringModuleBroken:
+    """Represents the current supported API of keyring, but broken"""
+
+    def __init__(self) -> None:
+        self._call_count = 0
+
+    def get_credential(self, system: str, username: str) -> None:
+        self._call_count += 1
+        raise Exception("This keyring is broken!")
+
+
+def test_broken_keyring_disables_keyring(monkeypatch: pytest.MonkeyPatch) -> None:
+    keyring_broken = KeyringModuleBroken()
+    monkeypatch.setitem(sys.modules, "keyring", keyring_broken)  # type: ignoremisc
+
+    auth = MultiDomainBasicAuth(
+        index_urls="http://example.com/", keyring_provider="import"
+    )
+
+    assert keyring_broken._call_count == 0
+    for i in range(5):
+        url = "http://example.com/path" + str(i)
+        assert auth._get_new_credentials(
+            url, allow_netrc=False, allow_keyring=True
+        ) == (None, None)
+        assert keyring_broken._call_count == 1
+
+
+class KeyringSubprocessResult(KeyringModuleV1):
+    """Represents the subprocess call to keyring"""
+
+    returncode = 0  # Default to zero retcode
+
+    def __call__(
+        self,
+        cmd: Liststr,
+        *,
+        env: Dictstr, str,
+        stdin: OptionalAny = None,
+        stdout: OptionalAny = None,
+        input: Optionalbytes = None,
+        check: Optionalbool = None
+    ) -> Any:
+        if cmd1 == "get":
+            assert stdin == -3  # subprocess.DEVNULL
+            assert stdout == subprocess.PIPE
+            assert env"PYTHONIOENCODING" == "utf-8"
+            assert check is None
+
+            password = self.get_password(*cmd2:)
+            if password is None:
+                # Expect non-zero returncode if no password present
+                self.returncode = 1
+            else:
+                # Passwords are returned encoded with a newline appended
+                self.returncode = 0
+                self.stdout = (password + os.linesep).encode("utf-8")
+
+        if cmd1 == "set":
+            assert stdin is None
+            assert stdout is None
+            assert env"PYTHONIOENCODING" == "utf-8"
+            assert input is not None
+            assert check
+
+            # Input from stdin is encoded
+            self.set_password(cmd2, cmd3, input.decode("utf-8").strip(os.linesep))
+
+        return self
+
+    def check_returncode(self) -> None:
+        if self.returncode:
+            raise Exception()
+
+
+@pytest.mark.parametrize(
+    "url, expect",
+    (
+        ("http://example.com/path1", (None, None)),
+        # path1 URLs will be resolved by netloc
+        ("http://user@example.com/path3", ("user", "user!netloc")),
+        ("http://user2@example.com/path3", ("user2", "user2!netloc")),
+        # path2 URLs will be resolved by index URL
+        ("http://example.com/path2/path3", (None, None)),
+        ("http://foo@example.com/path2/path3", ("foo", "foo!url")),
+    ),
+)
+def test_keyring_cli_get_password(
+    monkeypatch: pytest.MonkeyPatch,
+    url: str,
+    expect: TupleOptionalstr, Optionalstr,
+) -> None:
+    monkeypatch.setattr(pip._internal.network.auth.shutil, "which", lambda x: "keyring")
+    monkeypatch.setattr(
+        pip._internal.network.auth.subprocess, "run", KeyringSubprocessResult()
+    )
+    auth = MultiDomainBasicAuth(
+        index_urls="http://example.com/path2", "http://example.com/path3",
+        keyring_provider="subprocess",
+    )
+
+    actual = auth._get_new_credentials(url, allow_netrc=False, allow_keyring=True)
+    assert actual == expect
+
+
+@pytest.mark.parametrize(
+    "response_status, creds, expect_save",
+    (
+        (403, ("user", "pass", True), False),
+        (
+            200,
+            ("user", "pass", True),
+            True,
+        ),
+        (
+            200,
+            ("user", "pass", False),
+            False,
+        ),
+    ),
+)
+def test_keyring_cli_set_password(
+    monkeypatch: pytest.MonkeyPatch,
+    response_status: int,
+    creds: Tuplestr, str, bool,
+    expect_save: bool,
+) -> None:
+    monkeypatch.setattr(pip._internal.network.auth.shutil, "which", lambda x: "keyring")
+    keyring = KeyringSubprocessResult()
+    monkeypatch.setattr(pip._internal.network.auth.subprocess, "run", keyring)
+    auth = MultiDomainBasicAuth(prompting=True, keyring_provider="subprocess")
+    monkeypatch.setattr(auth, "_get_url_and_credentials", lambda u: (u, None, None))
+    monkeypatch.setattr(auth, "_prompt_for_password", lambda *a: creds)
+    if creds2:
+        # when _prompt_for_password indicates to save, we should save
+        def should_save_password_to_keyring(*a: Any) -> bool:
+            return True
+
+    else:
+        # when _prompt_for_password indicates not to save, we should
+        # never call this function
+        def should_save_password_to_keyring(*a: Any) -> bool:
+            assert False, "_should_save_password_to_keyring should not be called"
+
+    monkeypatch.setattr(
+        auth, "_should_save_password_to_keyring", should_save_password_to_keyring
+    )
+
+    req = MockRequest("https://example.com")
+    resp = MockResponse(b"")
+    resp.url = req.url
+    connection = MockConnection()
+
+    def _send(sent_req: MockRequest, **kwargs: Any) -> MockResponse:
+        assert sent_req is req
+        assert "Authorization" in sent_req.headers
+        r = MockResponse(b"")
+        r.status_code = response_status
+        return r
+
+    # https://github.com/python/mypy/issues/2427
+    connection._send = _send  # type: ignoreassignment
+
+    resp.request = req
+    resp.status_code = 401
+    resp.connection = connection
+
+    auth.handle_401(resp)
+
+    if expect_save:
+        assert keyring.saved_passwords == ("example.com", creds0, creds1)
+    else:
+        assert keyring.saved_passwords ==

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_network_cache.py Added

@@ -0,0 +1,63 @@
+import os
+from pathlib import Path
+from typing import Iterator
+from unittest.mock import Mock
+
+import pytest
+from pip._vendor.cachecontrol.caches import FileCache
+
+from pip._internal.network.cache import SafeFileCache
+
+
+@pytest.fixture(scope="function")
+def cache_tmpdir(tmpdir: Path) -> IteratorPath:
+    cache_dir = tmpdir.joinpath("cache")
+    cache_dir.mkdir(parents=True)
+    yield cache_dir
+
+
+class TestSafeFileCache:
+    """
+    The no_perms test are useless on Windows since SafeFileCache uses
+    pip._internal.utils.filesystem.check_path_owner which is based on
+    os.geteuid which is absent on Windows.
+    """
+
+    def test_cache_roundtrip(self, cache_tmpdir: Path) -> None:
+        cache = SafeFileCache(os.fspath(cache_tmpdir))
+        assert cache.get("test key") is None
+        cache.set("test key", b"a test string")
+        assert cache.get("test key") == b"a test string"
+        cache.delete("test key")
+        assert cache.get("test key") is None
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_safe_get_no_perms(
+        self, cache_tmpdir: Path, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        os.chmod(cache_tmpdir, 000)
+
+        monkeypatch.setattr(os.path, "exists", lambda x: True)
+
+        cache = SafeFileCache(os.fspath(cache_tmpdir))
+        cache.get("foo")
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_safe_set_no_perms(self, cache_tmpdir: Path) -> None:
+        os.chmod(cache_tmpdir, 000)
+
+        cache = SafeFileCache(os.fspath(cache_tmpdir))
+        cache.set("foo", b"bar")
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_safe_delete_no_perms(self, cache_tmpdir: Path) -> None:
+        os.chmod(cache_tmpdir, 000)
+
+        cache = SafeFileCache(os.fspath(cache_tmpdir))
+        cache.delete("foo")
+
+    def test_cache_hashes_are_same(self, cache_tmpdir: Path) -> None:
+        cache = SafeFileCache(os.fspath(cache_tmpdir))
+        key = "test key"
+        fake_cache = Mock(FileCache, directory=cache.directory, encode=FileCache.encode)
+        assert cache._get_cache_path(key) == FileCache._fn(fake_cache, key)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_network_download.py Added

@@ -0,0 +1,126 @@
+import logging
+import sys
+from typing import Dict
+
+import pytest
+
+from pip._internal.models.link import Link
+from pip._internal.network.download import (
+    _prepare_download,
+    parse_content_disposition,
+    sanitize_content_filename,
+)
+from tests.lib.requests_mocks import MockResponse
+
+
+@pytest.mark.parametrize(
+    "url, headers, from_cache, expected",
+    
+        (
+            "http://example.com/foo.tgz",
+            {},
+            False,
+            "Downloading http://example.com/foo.tgz",
+        ),
+        (
+            "http://example.com/foo.tgz",
+            {"content-length": "2"},
+            False,
+            "Downloading http://example.com/foo.tgz (2 bytes)",
+        ),
+        (
+            "http://example.com/foo.tgz",
+            {"content-length": "2"},
+            True,
+            "Using cached http://example.com/foo.tgz (2 bytes)",
+        ),
+        ("https://files.pythonhosted.org/foo.tgz", {}, False, "Downloading foo.tgz"),
+        (
+            "https://files.pythonhosted.org/foo.tgz",
+            {"content-length": "2"},
+            False,
+            "Downloading foo.tgz (2 bytes)",
+        ),
+        (
+            "https://files.pythonhosted.org/foo.tgz",
+            {"content-length": "2"},
+            True,
+            "Using cached foo.tgz",
+        ),
+    ,
+)
+def test_prepare_download__log(
+    caplog: pytest.LogCaptureFixture,
+    url: str,
+    headers: Dictstr, str,
+    from_cache: bool,
+    expected: str,
+) -> None:
+    caplog.set_level(logging.INFO)
+    resp = MockResponse(b"")
+    resp.url = url
+    resp.headers = headers
+    if from_cache:
+        resp.from_cache = from_cache
+    link = Link(url)
+    _prepare_download(resp, link, progress_bar="on")
+
+    assert len(caplog.records) == 1
+    record = caplog.records0
+    assert record.levelname == "INFO"
+    assert expected in record.message
+
+
+@pytest.mark.parametrize(
+    "filename, expected",
+    
+        ("dir/file", "file"),
+        ("../file", "file"),
+        ("../../file", "file"),
+        ("../", ""),
+        ("../..", ".."),
+        ("/", ""),
+    ,
+)
+def test_sanitize_content_filename(filename: str, expected: str) -> None:
+    """
+    Test inputs where the result is the same for Windows and non-Windows.
+    """
+    assert sanitize_content_filename(filename) == expected
+
+
+@pytest.mark.parametrize(
+    "filename, win_expected, non_win_expected",
+    
+        ("dir\\file", "file", "dir\\file"),
+        ("..\\file", "file", "..\\file"),
+        ("..\\..\\file", "file", "..\\..\\file"),
+        ("..\\", "", "..\\"),
+        ("..\\..", "..", "..\\.."),
+        ("\\", "", "\\"),
+    ,
+)
+def test_sanitize_content_filename__platform_dependent(
+    filename: str, win_expected: str, non_win_expected: str
+) -> None:
+    """
+    Test inputs where the result is different for Windows and non-Windows.
+    """
+    if sys.platform == "win32":
+        expected = win_expected
+    else:
+        expected = non_win_expected
+    assert sanitize_content_filename(filename) == expected
+
+
+@pytest.mark.parametrize(
+    "content_disposition, default_filename, expected",
+    
+        ('attachment;filename="../file"', "df", "file"),
+    ,
+)
+def test_parse_content_disposition(
+    content_disposition: str, default_filename: str, expected: str
+) -> None:
+    actual = parse_content_disposition(content_disposition, default_filename)
+    assert actual == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_network_lazy_wheel.py Added

@@ -0,0 +1,66 @@
+from typing import Iterator
+
+from pip._vendor.packaging.version import Version
+from pytest import fixture, mark, raises
+
+from pip._internal.exceptions import InvalidWheel
+from pip._internal.network.lazy_wheel import (
+    HTTPRangeRequestUnsupported,
+    dist_from_wheel_url,
+)
+from pip._internal.network.session import PipSession
+from tests.lib import TestData
+from tests.lib.server import MockServer, file_response
+
+MYPY_0_782_WHL = (
+    "https://files.pythonhosted.org/packages/9d/65/"
+    "b96e844150ce18b9892b155b780248955ded13a2581d31872e7daa90a503/"
+    "mypy-0.782-py3-none-any.whl"
+)
+MYPY_0_782_REQS = {
+    "typed-ast<1.5.0,>=1.4.0",
+    "typing-extensions>=3.7.4",
+    "mypy-extensions<0.5.0,>=0.4.3",
+    'psutil>=4.0; extra == "dmypy"',
+}
+
+
+@fixture
+def session() -> PipSession:
+    return PipSession()
+
+
+@fixture
+def mypy_whl_no_range(mock_server: MockServer, shared_data: TestData) -> Iteratorstr:
+    mypy_whl = shared_data.packages / "mypy-0.782-py3-none-any.whl"
+    mock_server.set_responses(file_response(mypy_whl))
+    mock_server.start()
+    base_address = f"http://{mock_server.host}:{mock_server.port}"
+    yield "{}/{}".format(base_address, "mypy-0.782-py3-none-any.whl")
+    mock_server.stop()
+
+
+@mark.network
+def test_dist_from_wheel_url(session: PipSession) -> None:
+    """Test if the acquired distribution contain correct information."""
+    dist = dist_from_wheel_url("mypy", MYPY_0_782_WHL, session)
+    assert dist.canonical_name == "mypy"
+    assert dist.version == Version("0.782")
+    extras = list(dist.iter_provided_extras())
+    assert extras == "dmypy"
+    assert {str(d) for d in dist.iter_dependencies(extras)} == MYPY_0_782_REQS
+
+
+def test_dist_from_wheel_url_no_range(
+    session: PipSession, mypy_whl_no_range: str
+) -> None:
+    """Test handling when HTTP range requests are not supported."""
+    with raises(HTTPRangeRequestUnsupported):
+        dist_from_wheel_url("mypy", mypy_whl_no_range, session)
+
+
+@mark.network
+def test_dist_from_wheel_url_not_zip(session: PipSession) -> None:
+    """Test handling with the given URL does not point to a ZIP."""
+    with raises(InvalidWheel):
+        dist_from_wheel_url("python", "https://www.python.org/", session)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_network_session.py Added

@@ -0,0 +1,276 @@
+import logging
+import os
+from pathlib import Path
+from typing import Any, List, Optional
+from urllib.parse import urlparse
+from urllib.request import getproxies
+
+import pytest
+from pip._vendor import requests
+
+from pip import __version__
+from pip._internal.models.link import Link
+from pip._internal.network.session import CI_ENVIRONMENT_VARIABLES, PipSession
+
+
+def get_user_agent() -> str:
+    return PipSession().headers"User-Agent"
+
+
+def test_user_agent() -> None:
+    user_agent = get_user_agent()
+
+    assert user_agent.startswith(f"pip/{__version__}")
+
+
+@pytest.mark.parametrize(
+    "name, expected_like_ci",
+    
+        ("BUILD_BUILDID", True),
+        ("BUILD_ID", True),
+        ("CI", True),
+        ("PIP_IS_CI", True),
+        # Test a prefix substring of one of the variable names we use.
+        ("BUILD", False),
+    ,
+)
+def test_user_agent__ci(
+    monkeypatch: pytest.MonkeyPatch, name: str, expected_like_ci: bool
+) -> None:
+    # Delete the variable names we use to check for CI to prevent the
+    # detection from always returning True in case the tests are being run
+    # under actual CI.  It is okay to depend on CI_ENVIRONMENT_VARIABLES
+    # here (part of the code under test) because this setup step can only
+    # prevent false test failures.  It can't cause a false test passage.
+    for ci_name in CI_ENVIRONMENT_VARIABLES:
+        monkeypatch.delenv(ci_name, raising=False)
+
+    # Confirm the baseline before setting the environment variable.
+    user_agent = get_user_agent()
+    assert '"ci":null' in user_agent
+    assert '"ci":true' not in user_agent
+
+    monkeypatch.setenv(name, "true")
+    user_agent = get_user_agent()
+    assert ('"ci":true' in user_agent) == expected_like_ci
+    assert ('"ci":null' in user_agent) == (not expected_like_ci)
+
+
+def test_user_agent_user_data(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setenv("PIP_USER_AGENT_USER_DATA", "some_string")
+    assert "some_string" in PipSession().headers"User-Agent"
+
+
+class TestPipSession:
+    def test_cache_defaults_off(self) -> None:
+        session = PipSession()
+
+        assert not hasattr(session.adapters"http://", "cache")
+        assert not hasattr(session.adapters"https://", "cache")
+
+    def test_cache_is_enabled(self, tmpdir: Path) -> None:
+        cache_directory = os.fspath(tmpdir.joinpath("test-cache"))
+        session = PipSession(cache=cache_directory)
+
+        assert hasattr(session.adapters"https://", "cache")
+
+        assert session.adapters"https://".cache.directory == cache_directory
+
+    def test_http_cache_is_not_enabled(self, tmpdir: Path) -> None:
+        session = PipSession(cache=os.fspath(tmpdir.joinpath("test-cache")))
+
+        assert not hasattr(session.adapters"http://", "cache")
+
+    def test_trusted_hosts_adapter(self, tmpdir: Path) -> None:
+        session = PipSession(
+            cache=os.fspath(tmpdir.joinpath("test-cache")),
+            trusted_hosts="example.com",
+        )
+
+        assert "https://example.com/" in session.adapters
+        # Check that the "port wildcard" is present.
+        assert "https://example.com:" in session.adapters
+        # Check that the cache is enabled.
+        assert hasattr(session.adapters"http://example.com/", "cache")
+        assert hasattr(session.adapters"https://example.com/", "cache")
+
+    def test_add_trusted_host(self) -> None:
+        # Leave a gap to test how the ordering is affected.
+        trusted_hosts = "host1", "host3"
+        session = PipSession(trusted_hosts=trusted_hosts)
+        trusted_host_adapter = session._trusted_host_adapter
+        prefix2 = "https://host2/"
+        prefix3 = "https://host3/"
+        prefix3_wildcard = "https://host3:"
+
+        prefix2_http = "http://host2/"
+        prefix3_http = "http://host3/"
+        prefix3_wildcard_http = "http://host3:"
+
+        # Confirm some initial conditions as a baseline.
+        assert session.pip_trusted_origins == ("host1", None), ("host3", None)
+        assert session.adaptersprefix3 is trusted_host_adapter
+        assert session.adaptersprefix3_wildcard is trusted_host_adapter
+
+        assert session.adaptersprefix3_http is trusted_host_adapter
+        assert session.adaptersprefix3_wildcard_http is trusted_host_adapter
+
+        assert prefix2 not in session.adapters
+        assert prefix2_http not in session.adapters
+
+        # Test adding a new host.
+        session.add_trusted_host("host2")
+        assert session.pip_trusted_origins == 
+            ("host1", None),
+            ("host3", None),
+            ("host2", None),
+        
+        # Check that prefix3 is still present.
+        assert session.adaptersprefix3 is trusted_host_adapter
+        assert session.adaptersprefix2 is trusted_host_adapter
+        assert session.adaptersprefix2_http is trusted_host_adapter
+
+        # Test that adding the same host doesn't create a duplicate.
+        session.add_trusted_host("host3")
+        assert session.pip_trusted_origins == 
+            ("host1", None),
+            ("host3", None),
+            ("host2", None),
+        , f"actual: {session.pip_trusted_origins}"
+
+        session.add_trusted_host("host4:8080")
+        prefix4 = "https://host4:8080/"
+        prefix4_http = "http://host4:8080/"
+        assert session.pip_trusted_origins == 
+            ("host1", None),
+            ("host3", None),
+            ("host2", None),
+            ("host4", 8080),
+        
+        assert session.adaptersprefix4 is trusted_host_adapter
+        assert session.adaptersprefix4_http is trusted_host_adapter
+
+    def test_add_trusted_host__logging(self, caplog: pytest.LogCaptureFixture) -> None:
+        """
+        Test logging when add_trusted_host() is called.
+        """
+        trusted_hosts = "host0", "host1"
+        session = PipSession(trusted_hosts=trusted_hosts)
+        with caplog.at_level(logging.INFO):
+            # Test adding an existing host.
+            session.add_trusted_host("host1", source="somewhere")
+            session.add_trusted_host("host2")
+            # Test calling add_trusted_host() on the same host twice.
+            session.add_trusted_host("host2")
+
+        actual = (r.levelname, r.message) for r in caplog.records
+        # Observe that "host0" isn't included in the logs.
+        expected = 
+            ("INFO", "adding trusted host: 'host1' (from somewhere)"),
+            ("INFO", "adding trusted host: 'host2'"),
+            ("INFO", "adding trusted host: 'host2'"),
+        
+        assert actual == expected
+
+    def test_iter_secure_origins(self) -> None:
+        trusted_hosts = "host1", "host2", "host3:8080"
+        session = PipSession(trusted_hosts=trusted_hosts)
+
+        actual = list(session.iter_secure_origins())
+        assert len(actual) == 9
+        # Spot-check that SECURE_ORIGINS is included.
+        assert actual0 == ("https", "*", "*")
+        assert actual-3: == 
+            ("*", "host1", "*"),
+            ("*", "host2", "*"),
+            ("*", "host3", 8080),
+        
+
+    def test_iter_secure_origins__trusted_hosts_empty(self) -> None:
+        """
+        Test iter_secure_origins() after passing trusted_hosts=.
+        """
+        session = PipSession(trusted_hosts=)
+
+        actual = list(session.iter_secure_origins())
+        assert len(actual) == 6
+        # Spot-check that SECURE_ORIGINS is included.
+        assert actual0 == ("https", "*", "*")
+
+    @pytest.mark.parametrize(
+        "location, trusted, expected",
+        
+            ("http://pypi.org/something", , False),
+            ("https://pypi.org/something", , True),
+            ("git+http://pypi.org/something", , False),
+            ("git+https://pypi.org/something", , True),
+            ("git+ssh://git@pypi.org/something", , True),
+            ("http://localhost", , True),
+            ("http://127.0.0.1", , True),
+            ("http://example.com/something/", , False),
+            ("http://example.com/something/", "example.com", True),
+            # Try changing the case.
+            ("http://eXample.com/something/", "example.cOm", True),
+            # Test hosts with port.
+            ("http://example.com:8080/something/", "example.com", True),
+            # Test a trusted_host with a port.
+            ("http://example.com:8080/something/", "example.com:8080", True),
+            ("http://example.com/something/", "example.com:8080", False),
+            ("http://example.com:8888/something/", "example.com:8080", False),
+        ,
+    )
+    def test_is_secure_origin(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        location: str,
+        trusted: Liststr,
+        expected: bool,
+    ) -> None:
+        class MockLogger:
+            def __init__(self) -> None:
+                self.called = False
+
+            def warning(self, *args: Any, **kwargs: Any) -> None:
+                self.called = True
+
+        session = PipSession(trusted_hosts=trusted)
+        actual = session.is_secure_origin(Link(location))
+        assert actual == expected
+
+        log_records = (r.levelname, r.message) for r in caplog.records
+        if expected:
+            assert not log_records
+            return
+
+        assert len(log_records) == 1
+        actual_level, actual_message = log_records0
+        assert actual_level == "WARNING"
+        assert "is not a trusted or secure host" in actual_message
+
+    @pytest.mark.network
+    def test_proxy(self, proxy: Optionalstr) -> None:
+        session = PipSession(trusted_hosts=)
+
+        if not proxy:
+            # if user didn't pass --proxy then try to get it from the system.
+            env_proxy = getproxies().get("http", None)
+            proxy = urlparse(env_proxy).netloc if env_proxy else None
+
+        if proxy:
+            # set proxy scheme to session.proxies
+            session.proxies = {
+                "http": f"{proxy}",
+                "https": f"{proxy}",
+                "ftp": f"{proxy}",
+            }
+
+        connection_error = None
+        try:
+            session.request("GET", "https://pypi.org", timeout=1)
+        except requests.exceptions.ConnectionError as e:
+            connection_error = e
+
+        assert connection_error is None, (
+            f"Invalid proxy {proxy} or session.proxies: "
+            f"{session.proxies} is not correctly passed to session.request."
+        )

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_network_utils.py Added

@@ -0,0 +1,35 @@
+import pytest
+
+from pip._internal.exceptions import NetworkConnectionError
+from pip._internal.network.utils import raise_for_status
+from tests.lib.requests_mocks import MockResponse
+
+
+@pytest.mark.parametrize(
+    ("status_code", "error_type"),
+    
+        (401, "Client Error"),
+        (501, "Server Error"),
+    ,
+)
+def test_raise_for_status_raises_exception(status_code: int, error_type: str) -> None:
+    contents = b"downloaded"
+    resp = MockResponse(contents)
+    resp.status_code = status_code
+    resp.url = "http://www.example.com/whatever.tgz"
+    resp.reason = "Network Error"
+    with pytest.raises(NetworkConnectionError) as excinfo:
+        raise_for_status(resp)
+    assert str(excinfo.value) == (
+        "{} {}: Network Error for url:"
+        " http://www.example.com/whatever.tgz".format(status_code, error_type)
+    )
+
+
+def test_raise_for_status_does_not_raises_exception() -> None:
+    contents = b"downloaded"
+    resp = MockResponse(contents)
+    resp.status_code = 201
+    resp.url = "http://www.example.com/whatever.tgz"
+    resp.reason = "No error"
+    raise_for_status(resp)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_operations_prepare.py Added

@@ -0,0 +1,134 @@
+import os
+import shutil
+from pathlib import Path
+from shutil import rmtree
+from tempfile import mkdtemp
+from typing import Any, Dict
+from unittest.mock import Mock, patch
+
+import pytest
+
+from pip._internal.exceptions import HashMismatch
+from pip._internal.models.link import Link
+from pip._internal.network.download import Downloader
+from pip._internal.network.session import PipSession
+from pip._internal.operations.prepare import unpack_url
+from pip._internal.utils.hashes import Hashes
+from tests.lib import TestData
+from tests.lib.requests_mocks import MockResponse
+
+
+def test_unpack_url_with_urllib_response_without_content_type(data: TestData) -> None:
+    """
+    It should download and unpack files even if no Content-Type header exists
+    """
+    _real_session = PipSession()
+
+    def _fake_session_get(*args: Any, **kwargs: Any) -> Dictstr, str:
+        resp = _real_session.get(*args, **kwargs)
+        del resp.headers"Content-Type"
+        return resp
+
+    session = Mock()
+    session.get = _fake_session_get
+    download = Downloader(session, progress_bar="on")
+
+    uri = data.packages.joinpath("simple-1.0.tar.gz").as_uri()
+    link = Link(uri)
+    temp_dir = mkdtemp()
+    try:
+        unpack_url(
+            link,
+            temp_dir,
+            download=download,
+            download_dir=None,
+            verbosity=0,
+        )
+        assert set(os.listdir(temp_dir)) == {
+            "PKG-INFO",
+            "setup.cfg",
+            "setup.py",
+            "simple",
+            "simple.egg-info",
+        }
+    finally:
+        rmtree(temp_dir)
+
+
+@patch("pip._internal.network.download.raise_for_status")
+def test_download_http_url__no_directory_traversal(
+    mock_raise_for_status: Mock, tmpdir: Path
+) -> None:
+    """
+    Test that directory traversal doesn't happen on download when the
+    Content-Disposition header contains a filename with a ".." path part.
+    """
+    mock_url = "http://www.example.com/whatever.tgz"
+    contents = b"downloaded"
+    link = Link(mock_url)
+
+    session = Mock()
+    resp = MockResponse(contents)
+    resp.url = mock_url
+    resp.headers = {
+        # Set the content-type to a random value to prevent
+        # mimetypes.guess_extension from guessing the extension.
+        "content-type": "random",
+        "content-disposition": 'attachment;filename="../out_dir_file"',
+    }
+    session.get.return_value = resp
+    download = Downloader(session, progress_bar="on")
+
+    download_dir = os.fspath(tmpdir.joinpath("download"))
+    os.mkdir(download_dir)
+    file_path, content_type = download(link, download_dir)
+    # The file should be downloaded to download_dir.
+    actual = os.listdir(download_dir)
+    assert actual == "out_dir_file"
+    mock_raise_for_status.assert_called_once_with(resp)
+
+
+@pytest.fixture
+def clean_project(tmpdir_factory: pytest.TempPathFactory, data: TestData) -> Path:
+    tmpdir = tmpdir_factory.mktemp("clean_project")
+    new_project_dir = tmpdir.joinpath("FSPkg")
+    path = data.packages.joinpath("FSPkg")
+    shutil.copytree(path, new_project_dir)
+    return new_project_dir
+
+
+class Test_unpack_url:
+    def prep(self, tmpdir: Path, data: TestData) -> None:
+        self.build_dir = os.fspath(tmpdir.joinpath("build"))
+        self.download_dir = tmpdir.joinpath("download")
+        os.mkdir(self.build_dir)
+        os.mkdir(self.download_dir)
+        self.dist_file = "simple-1.0.tar.gz"
+        self.dist_file2 = "simple-2.0.tar.gz"
+        self.dist_path = data.packages.joinpath(self.dist_file)
+        self.dist_path2 = data.packages.joinpath(self.dist_file2)
+        self.dist_url = Link(self.dist_path.as_uri())
+        self.dist_url2 = Link(self.dist_path2.as_uri())
+        self.no_download = Mock(side_effect=AssertionError)
+
+    def test_unpack_url_no_download(self, tmpdir: Path, data: TestData) -> None:
+        self.prep(tmpdir, data)
+        unpack_url(self.dist_url, self.build_dir, self.no_download, verbosity=0)
+        assert os.path.isdir(os.path.join(self.build_dir, "simple"))
+        assert not os.path.isfile(os.path.join(self.download_dir, self.dist_file))
+
+    def test_unpack_url_bad_hash(self, tmpdir: Path, data: TestData) -> None:
+        """
+        Test when the file url hash fragment is wrong
+        """
+        self.prep(tmpdir, data)
+        url = f"{self.dist_url.url}#md5=bogus"
+        dist_url = Link(url)
+        with pytest.raises(HashMismatch):
+            unpack_url(
+                dist_url,
+                self.build_dir,
+                download=self.no_download,
+                hashes=Hashes({"md5": "bogus"}),
+                verbosity=0,
+            )

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_options.py Added

@@ -0,0 +1,656 @@
+import os
+from contextlib import contextmanager
+from optparse import Values
+from tempfile import NamedTemporaryFile
+from typing import Any, Dict, Iterator, List, Tuple, Union, cast
+
+import pytest
+
+import pip._internal.configuration
+from pip._internal.cli.main import main
+from pip._internal.commands import create_command
+from pip._internal.commands.configuration import ConfigurationCommand
+from pip._internal.exceptions import PipError
+from tests.lib.options_helpers import AddFakeCommandMixin
+
+
+@contextmanager
+def assert_option_error(
+    capsys: pytest.CaptureFixturestr, expected: str
+) -> IteratorNone:
+    """
+    Assert that a SystemExit occurred because of a parsing error.
+
+    Args:
+      expected: an expected substring of stderr.
+    """
+    with pytest.raises(SystemExit) as excinfo:
+        yield
+
+    assert excinfo.value.code == 2
+    stderr = capsys.readouterr().err
+    assert expected in stderr
+
+
+def assert_is_default_cache_dir(value: str) -> None:
+    # This path looks different on different platforms, but the path always
+    # has the substring "pip".
+    assert "pip" in value
+
+
+class TestOptionPrecedence(AddFakeCommandMixin):
+    """
+    Tests for confirming our option precedence:
+        cli -> environment -> subcommand config -> global config -> option
+        defaults
+    """
+
+    def get_config_section(self, section: str) -> ListTuplestr, str:
+        config = {
+            "global": ("timeout", "-3"),
+            "fake": ("timeout", "-2"),
+        }
+        return configsection
+
+    def get_config_section_global(self, section: str) -> ListTuplestr, str:
+        config: Dictstr, ListTuplestr, str = {
+            "global": ("timeout", "-3"),
+            "fake": ,
+        }
+        return configsection
+
+    def test_env_override_default_int(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        """
+        Test that environment variable overrides an int option default.
+        """
+        monkeypatch.setenv("PIP_TIMEOUT", "-1")
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert options.timeout == -1
+
+    @pytest.mark.parametrize("values", ("F1", "F1", "F2"))
+    def test_env_override_default_append(
+        self, values: Liststr, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test that environment variable overrides an append option default.
+        """
+        monkeypatch.setenv("PIP_FIND_LINKS", " ".join(values))
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert options.find_links == values
+
+    @pytest.mark.parametrize("choices", ("w", "s", "w"))
+    def test_env_override_default_choice(
+        self, choices: Liststr, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test that environment variable overrides a choice option default.
+        """
+        monkeypatch.setenv("PIP_EXISTS_ACTION", " ".join(choices))
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert options.exists_action == choices
+
+    @pytest.mark.parametrize("name", ("PIP_LOG_FILE", "PIP_LOCAL_LOG"))
+    def test_env_alias_override_default(
+        self, name: str, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        When an option has multiple long forms, test that the technique of
+        using the env variable, "PIP_<long form>" works for all cases.
+        (e.g. PIP_LOG_FILE and PIP_LOCAL_LOG should all work)
+        """
+        monkeypatch.setenv(name, "override.log")
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert options.log == "override.log"
+
+    def test_cli_override_environment(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        """
+        Test the cli overrides and environment variable
+        """
+        monkeypatch.setenv("PIP_TIMEOUT", "-1")
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("fake", "--timeout", "-2")
+        )
+        assert options.timeout == -2
+
+    @pytest.mark.parametrize(
+        "pip_no_cache_dir",
+        
+            # Enabling --no-cache-dir means no cache directory.
+            "1",
+            "true",
+            "on",
+            "yes",
+            # For historical / backwards compatibility reasons, we also disable
+            # the cache directory if provided a value that translates to 0.
+            "0",
+            "false",
+            "off",
+            "no",
+        ,
+    )
+    def test_cache_dir__PIP_NO_CACHE_DIR(
+        self, pip_no_cache_dir: str, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test setting the PIP_NO_CACHE_DIR environment variable without
+        passing any command-line flags.
+        """
+        monkeypatch.setenv("PIP_NO_CACHE_DIR", pip_no_cache_dir)
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert options.cache_dir is False
+
+    @pytest.mark.parametrize("pip_no_cache_dir", "yes", "no")
+    def test_cache_dir__PIP_NO_CACHE_DIR__with_cache_dir(
+        self,
+        pip_no_cache_dir: str,
+        monkeypatch: pytest.MonkeyPatch,
+    ) -> None:
+        """
+        Test setting PIP_NO_CACHE_DIR while also passing an explicit
+        --cache-dir value.
+        """
+        monkeypatch.setenv("PIP_NO_CACHE_DIR", pip_no_cache_dir)
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--cache-dir", "/cache/dir", "fake")
+        )
+        # The command-line flag takes precedence.
+        assert options.cache_dir == "/cache/dir"
+
+    @pytest.mark.parametrize("pip_no_cache_dir", "yes", "no")
+    def test_cache_dir__PIP_NO_CACHE_DIR__with_no_cache_dir(
+        self,
+        pip_no_cache_dir: str,
+        monkeypatch: pytest.MonkeyPatch,
+    ) -> None:
+        """
+        Test setting PIP_NO_CACHE_DIR while also passing --no-cache-dir.
+        """
+        monkeypatch.setenv("PIP_NO_CACHE_DIR", pip_no_cache_dir)
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("--no-cache-dir", "fake"))
+        # The command-line flag should take precedence (which has the same
+        # value in this case).
+        assert options.cache_dir is False
+
+    def test_cache_dir__PIP_NO_CACHE_DIR_invalid__with_no_cache_dir(
+        self,
+        monkeypatch: pytest.MonkeyPatch,
+        capsys: pytest.CaptureFixturestr,
+    ) -> None:
+        """
+        Test setting PIP_NO_CACHE_DIR to an invalid value while also passing
+        --no-cache-dir.
+        """
+        monkeypatch.setenv("PIP_NO_CACHE_DIR", "maybe")
+        expected_err = "--no-cache-dir error: invalid truth value 'maybe'"
+        with assert_option_error(capsys, expected=expected_err):
+            main("--no-cache-dir", "fake")
+
+
+class TestUsePEP517Options:
+
+    """
+    Test options related to using --use-pep517.
+    """
+
+    def parse_args(self, args: Liststr) -> Values:
+        # We use DownloadCommand since that is one of the few Command
+        # classes with the use_pep517 options.
+        command = create_command("download")
+        options, args = command.parse_args(args)
+
+        return options
+
+    def test_no_option(self) -> None:
+        """
+        Test passing no option.
+        """
+        options = self.parse_args()
+        assert options.use_pep517 is None
+
+    def test_use_pep517(self) -> None:
+        """
+        Test passing --use-pep517.
+        """
+        options = self.parse_args("--use-pep517")
+        assert options.use_pep517 is True
+
+    def test_no_use_pep517(self) -> None:
+        """
+        Test passing --no-use-pep517.
+        """
+        options = self.parse_args("--no-use-pep517")
+        assert options.use_pep517 is False
+
+    def test_PIP_USE_PEP517_true(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        """
+        Test setting PIP_USE_PEP517 to "true".
+        """
+        monkeypatch.setenv("PIP_USE_PEP517", "true")
+        options = self.parse_args()
+        # This is an int rather than a boolean because strtobool() in pip's
+        # configuration code returns an int.
+        assert options.use_pep517 == 1
+
+    def test_PIP_USE_PEP517_false(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        """
+        Test setting PIP_USE_PEP517 to "false".
+        """
+        monkeypatch.setenv("PIP_USE_PEP517", "false")
+        options = self.parse_args()
+        # This is an int rather than a boolean because strtobool() in pip's
+        # configuration code returns an int.
+        assert options.use_pep517 == 0
+
+    def test_use_pep517_and_PIP_USE_PEP517_false(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test passing --use-pep517 and setting PIP_USE_PEP517 to "false".
+        """
+        monkeypatch.setenv("PIP_USE_PEP517", "false")
+        options = self.parse_args("--use-pep517")
+        assert options.use_pep517 is True
+
+    def test_no_use_pep517_and_PIP_USE_PEP517_true(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test passing --no-use-pep517 and setting PIP_USE_PEP517 to "true".
+        """
+        monkeypatch.setenv("PIP_USE_PEP517", "true")
+        options = self.parse_args("--no-use-pep517")
+        assert options.use_pep517 is False
+
+    def test_PIP_NO_USE_PEP517(
+        self, monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixturestr
+    ) -> None:
+        """
+        Test setting PIP_NO_USE_PEP517, which isn't allowed.
+        """
+        monkeypatch.setenv("PIP_NO_USE_PEP517", "true")
+        with assert_option_error(capsys, expected="--no-use-pep517 error"):
+            self.parse_args()
+
+
+class TestOptionsInterspersed(AddFakeCommandMixin):
+    def test_general_option_after_subcommand(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("fake", "--timeout", "-1")
+        )
+        assert options.timeout == -1
+
+    def test_option_after_subcommand_arg(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("fake", "arg", "--timeout", "-1")
+        )
+        assert options.timeout == -1
+
+    def test_additive_before_after_subcommand(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("-v", "fake", "-v"))
+        assert options.verbose == 2
+
+    def test_subcommand_option_before_subcommand_fails(self) -> None:
+        with pytest.raises(SystemExit):
+            main("--find-links", "F1", "fake")
+
+
+@contextmanager
+def tmpconfig(option: str, value: Any, section: str = "global") -> Iteratorstr:
+    with NamedTemporaryFile(mode="w", delete=False) as f:
+        f.write(f"{section}\n{option}={value}\n")
+        name = f.name
+    try:
+        yield name
+    finally:
+        os.unlink(name)
+
+
+class TestCountOptions(AddFakeCommandMixin):
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", range(4))
+    def test_cli_long(self, option: str, value: int) -> None:
+        flags = f"--{option}" * value
+        # FakeCommand intentionally returns the wrong type.
+        opt1, args1 = cast(TupleValues, Liststr, main(flags + "fake"))
+        opt2, args2 = cast(TupleValues, Liststr, main("fake" + flags))
+        assert getattr(opt1, option) == getattr(opt2, option) == value
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", range(1, 4))
+    def test_cli_short(self, option: str, value: int) -> None:
+        flag = "-" + option0 * value
+        # FakeCommand intentionally returns the wrong type.
+        opt1, args1 = cast(TupleValues, Liststr, main(flag, "fake"))
+        opt2, args2 = cast(TupleValues, Liststr, main("fake", flag))
+        assert getattr(opt1, option) == getattr(opt2, option) == value
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", range(4))
+    def test_env_var(
+        self, option: str, value: int, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("PIP_" + option.upper(), str(value))
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert getattr(options, option) == value
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", range(3))
+    def test_env_var_integrate_cli(
+        self, option: str, value: int, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("PIP_" + option.upper(), str(value))
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake", "--" + option))
+        assert getattr(options, option) == value + 1
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", (-1, "foobar"))
+    def test_env_var_invalid(
+        self,
+        option: str,
+        value: Any,
+        monkeypatch: pytest.MonkeyPatch,
+        capsys: pytest.CaptureFixturestr,
+    ) -> None:
+        monkeypatch.setenv("PIP_" + option.upper(), str(value))
+        with assert_option_error(capsys, expected="a non-negative integer"):
+            main("fake")
+
+    # Undocumented, support for backward compatibility
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", ("no", "false"))
+    def test_env_var_false(
+        self, option: str, value: str, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("PIP_" + option.upper(), str(value))
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert getattr(options, option) == 0
+
+    # Undocumented, support for backward compatibility
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", ("yes", "true"))
+    def test_env_var_true(
+        self, option: str, value: str, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setenv("PIP_" + option.upper(), str(value))
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        assert getattr(options, option) == 1
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", range(4))
+    def test_config_file(
+        self, option: str, value: int, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        with tmpconfig(option, value) as name:
+            monkeypatch.setenv("PIP_CONFIG_FILE", name)
+            # FakeCommand intentionally returns the wrong type.
+            options, args = cast(TupleValues, Liststr, main("fake"))
+            assert getattr(options, option) == value
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", range(3))
+    def test_config_file_integrate_cli(
+        self, option: str, value: int, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        with tmpconfig(option, value) as name:
+            monkeypatch.setenv("PIP_CONFIG_FILE", name)
+            # FakeCommand intentionally returns the wrong type.
+            options, args = cast(
+                TupleValues, Liststr, main("fake", "--" + option)
+            )
+            assert getattr(options, option) == value + 1
+
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", (-1, "foobar"))
+    def test_config_file_invalid(
+        self,
+        option: str,
+        value: Any,
+        monkeypatch: pytest.MonkeyPatch,
+        capsys: pytest.CaptureFixturestr,
+    ) -> None:
+        with tmpconfig(option, value) as name:
+            monkeypatch.setenv("PIP_CONFIG_FILE", name)
+            with assert_option_error(capsys, expected="non-negative integer"):
+                main("fake")
+
+    # Undocumented, support for backward compatibility
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", ("no", "false"))
+    def test_config_file_false(
+        self, option: str, value: str, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        with tmpconfig(option, value) as name:
+            monkeypatch.setenv("PIP_CONFIG_FILE", name)
+            # FakeCommand intentionally returns the wrong type.
+            options, args = cast(TupleValues, Liststr, main("fake"))
+            assert getattr(options, option) == 0
+
+    # Undocumented, support for backward compatibility
+    @pytest.mark.parametrize("option", ("verbose", "quiet"))
+    @pytest.mark.parametrize("value", ("yes", "true"))
+    def test_config_file_true(
+        self, option: str, value: str, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        with tmpconfig(option, value) as name:
+            monkeypatch.setenv("PIP_CONFIG_FILE", name)
+            # FakeCommand intentionally returns the wrong type.
+            options, args = cast(TupleValues, Liststr, main("fake"))
+            assert getattr(options, option) == 1
+
+
+class TestGeneralOptions(AddFakeCommandMixin):
+    # the reason to specifically test general options is due to the
+    # extra processing they receive, and the number of bugs we've had
+
+    def test_cache_dir__default(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("fake"))
+        # With no options the default cache dir should be used.
+        assert_is_default_cache_dir(options.cache_dir)
+
+    def test_cache_dir__provided(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--cache-dir", "/cache/dir", "fake")
+        )
+        assert options.cache_dir == "/cache/dir"
+
+    def test_no_cache_dir__provided(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(TupleValues, Liststr, main("--no-cache-dir", "fake"))
+        assert options.cache_dir is False
+
+    def test_require_virtualenv(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--require-virtualenv", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--require-virtualenv")
+        )
+        assert options1.require_venv
+        assert options2.require_venv
+
+    def test_log(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--log", "path", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--log", "path")
+        )
+        assert options1.log == options2.log == "path"
+
+    def test_local_log(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--local-log", "path", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--local-log", "path")
+        )
+        assert options1.log == options2.log == "path"
+
+    def test_no_input(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(TupleValues, Liststr, main("--no-input", "fake"))
+        options2, args2 = cast(TupleValues, Liststr, main("fake", "--no-input"))
+        assert options1.no_input
+        assert options2.no_input
+
+    def test_proxy(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--proxy", "path", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--proxy", "path")
+        )
+        assert options1.proxy == options2.proxy == "path"
+
+    def test_retries(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--retries", "-1", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--retries", "-1")
+        )
+        assert options1.retries == options2.retries == -1
+
+    def test_timeout(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--timeout", "-1", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--timeout", "-1")
+        )
+        assert options1.timeout == options2.timeout == -1
+
+    def test_exists_action(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--exists-action", "w", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--exists-action", "w")
+        )
+        assert options1.exists_action == options2.exists_action == "w"
+
+    def test_cert(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--cert", "path", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--cert", "path")
+        )
+        assert options1.cert == options2.cert == "path"
+
+    def test_client_cert(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options1, args1 = cast(
+            TupleValues, Liststr, main("--client-cert", "path", "fake")
+        )
+        options2, args2 = cast(
+            TupleValues, Liststr, main("fake", "--client-cert", "path")
+        )
+        assert options1.client_cert == options2.client_cert == "path"
+
+
+class TestOptionsConfigFiles:
+    def test_venv_config_file_found(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        # strict limit on the global config files list
+        monkeypatch.setattr(
+            pip._internal.utils.appdirs, "site_config_dirs", lambda _: "/a/place"
+        )
+
+        cp = pip._internal.configuration.Configuration(isolated=False)
+
+        files = 
+        for _, val in cp.iter_config_files():
+            files.extend(val)
+
+        assert len(files) == 4
+
+    @pytest.mark.parametrize(
+        "args, expect",
+        (
+            (, None),
+            ("--global", "global"),
+            ("--site", "site"),
+            ("--user", "user"),
+            ("--global", "--user", PipError),
+            ("--global", "--site", PipError),
+            ("--global", "--site", "--user", PipError),
+        ),
+    )
+    def test_config_file_options(
+        self,
+        monkeypatch: pytest.MonkeyPatch,
+        args: Liststr,
+        expect: UnionNone, str, PipError,
+    ) -> None:
+        cmd = cast(ConfigurationCommand, create_command("config"))
+        # Replace a handler with a no-op to avoid side effects
+        monkeypatch.setattr(cmd, "get_name", lambda *a: None)
+
+        options, args = cmd.parser.parse_args(args + "get", "name")
+        if expect is PipError:
+            with pytest.raises(PipError):
+                cmd._determine_file(options, need_value=False)
+        else:
+            assert expect == cmd._determine_file(options, need_value=False)
+
+
+class TestOptionsExpandUser(AddFakeCommandMixin):
+    def test_cache_dir(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--cache-dir", "~/cache/dir", "fake")
+        )
+        assert options.cache_dir == os.path.expanduser("~/cache/dir")
+
+    def test_log(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--log", "~/path", "fake")
+        )
+        assert options.log == os.path.expanduser("~/path")
+
+    def test_local_log(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--local-log", "~/path", "fake")
+        )
+        assert options.log == os.path.expanduser("~/path")
+
+    def test_cert(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--cert", "~/path", "fake")
+        )
+        assert options.cert == os.path.expanduser("~/path")
+
+    def test_client_cert(self) -> None:
+        # FakeCommand intentionally returns the wrong type.
+        options, args = cast(
+            TupleValues, Liststr, main("--client-cert", "~/path", "fake")
+        )
+        assert options.client_cert == os.path.expanduser("~/path")

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_packaging.py Added

@@ -0,0 +1,44 @@
+from typing import Optional, Tuple
+
+import pytest
+from pip._vendor.packaging import specifiers
+from pip._vendor.packaging.requirements import Requirement
+
+from pip._internal.utils.packaging import check_requires_python, get_requirement
+
+
+@pytest.mark.parametrize(
+    "version_info, requires_python, expected",
+    
+        ((3, 6, 5), "== 3.6.4", False),
+        ((3, 6, 5), "== 3.6.5", True),
+        ((3, 6, 5), None, True),
+    ,
+)
+def test_check_requires_python(
+    version_info: Tupleint, int, int, requires_python: Optionalstr, expected: bool
+) -> None:
+    actual = check_requires_python(requires_python, version_info)
+    assert actual == expected
+
+
+def test_check_requires_python__invalid() -> None:
+    """
+    Test an invalid Requires-Python value.
+    """
+    with pytest.raises(specifiers.InvalidSpecifier):
+        check_requires_python("invalid", (3, 6, 5))
+
+
+def test_get_or_create_caching() -> None:
+    """test caching of get_or_create requirement"""
+    teststr = "affinegap==1.10"
+    from_helper = get_requirement(teststr)
+    freshly_made = Requirement(teststr)
+
+    # Requirement doesn't have an equality operator (yet) so test
+    # equality of attribute for list of attributes
+    for iattr in "name", "url", "extras", "specifier", "marker":
+        assert getattr(from_helper, iattr) == getattr(freshly_made, iattr)
+    assert get_requirement(teststr) is not Requirement(teststr)
+    assert get_requirement(teststr) is get_requirement(teststr)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_pep517.py Added

@@ -0,0 +1,99 @@
+import os
+from pathlib import Path
+from textwrap import dedent
+
+import pytest
+
+from pip._internal.exceptions import InstallationError, InvalidPyProjectBuildRequires
+from pip._internal.req import InstallRequirement
+from tests.lib import TestData
+
+
+@pytest.mark.parametrize(
+    ("source", "expected"),
+    
+        ("pep517_setup_and_pyproject", True),
+        ("pep517_setup_only", False),
+        ("pep517_pyproject_only", True),
+    ,
+)
+def test_use_pep517(shared_data: TestData, source: str, expected: bool) -> None:
+    """
+    Test that we choose correctly between PEP 517 and legacy code paths
+    """
+    src = shared_data.src.joinpath(source)
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(src)  # make req believe it has been unpacked
+    req.load_pyproject_toml()
+    assert req.use_pep517 is expected
+
+
+def test_use_pep517_rejects_setup_cfg_only(shared_data: TestData) -> None:
+    """
+    Test that projects with setup.cfg but no pyproject.toml are rejected.
+    """
+    src = shared_data.src.joinpath("pep517_setup_cfg_only")
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(src)  # make req believe it has been unpacked
+    with pytest.raises(InstallationError) as e:
+        req.load_pyproject_toml()
+    err_msg = e.value.args0
+    assert (
+        "does not appear to be a Python project: "
+        "neither 'setup.py' nor 'pyproject.toml' found" in err_msg
+    )
+
+
+@pytest.mark.parametrize(
+    ("source", "msg"),
+    
+        ("pep517_setup_and_pyproject", "specifies a build backend"),
+        ("pep517_pyproject_only", "does not have a setup.py"),
+    ,
+)
+def test_disabling_pep517_invalid(shared_data: TestData, source: str, msg: str) -> None:
+    """
+    Test that we fail if we try to disable PEP 517 when it's not acceptable
+    """
+    src = shared_data.src.joinpath(source)
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(src)  # make req believe it has been unpacked
+
+    # Simulate --no-use-pep517
+    req.use_pep517 = False
+
+    with pytest.raises(InstallationError) as e:
+        req.load_pyproject_toml()
+
+    err_msg = e.value.args0
+    assert "Disabling PEP 517 processing is invalid" in err_msg
+    assert msg in err_msg
+
+
+@pytest.mark.parametrize(
+    ("spec",), ("./foo",), ("git+https://example.com/pkg@dev#egg=myproj",)
+)
+def test_pep517_parsing_checks_requirements(tmpdir: Path, spec: str) -> None:
+    tmpdir.joinpath("pyproject.toml").write_text(
+        dedent(
+            f"""
+            build-system
+            requires = {spec!r}
+            build-backend = "foo"
+            """
+        )
+    )
+    req = InstallRequirement(None, None)
+    req.source_dir = os.fspath(tmpdir)  # make req believe it has been unpacked
+
+    with pytest.raises(InvalidPyProjectBuildRequires) as e:
+        req.load_pyproject_toml()
+
+    error = e.value
+
+    assert str(req) in error.message
+    assert error.context
+    assert "build-system.requires" in error.context
+    assert "contains an invalid requirement" in error.context
+    assert error.hint_stmt
+    assert "PEP 518" in error.hint_stmt

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_pyproject_config.py Added

@@ -0,0 +1,53 @@
+from typing import Dict, List
+
+import pytest
+
+from pip._internal.commands import create_command
+
+
+@pytest.mark.parametrize(
+    ("command", "expected"),
+    
+        ("install", True),
+        ("wheel", True),
+        ("freeze", False),
+    ,
+)
+def test_supports_config(command: str, expected: bool) -> None:
+    c = create_command(command)
+    options, _ = c.parse_args()
+    assert hasattr(options, "config_settings") == expected
+
+
+def test_set_config_value_true() -> None:
+    i = create_command("install")
+    # Invalid argument exits with an error
+    with pytest.raises(SystemExit):
+        options, _ = i.parse_args("xxx", "--config-settings", "x")
+
+
+def test_set_config_value() -> None:
+    i = create_command("install")
+    options, _ = i.parse_args("xxx", "--config-settings", "x=hello")
+    assert options.config_settings == {"x": "hello"}
+
+
+def test_set_config_empty_value() -> None:
+    i = create_command("install")
+    options, _ = i.parse_args("xxx", "--config-settings", "x=")
+    assert options.config_settings == {"x": ""}
+
+
+@pytest.mark.parametrize(
+    ("passed", "expected"),
+    
+        ("x=hello", "x=world", {"x": "hello", "world"}),
+        ("x=hello", "x=world", "x=other", {"x": "hello", "world", "other"}),
+    ,
+)
+def test_multiple_config_values(passed: Liststr, expected: Dictstr, str) -> None:
+    i = create_command("install")
+    options, _ = i.parse_args(
+        "xxx", *(f"--config-settings={option}" for option in passed)
+    )
+    assert options.config_settings == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_req.py Added

@@ -0,0 +1,938 @@
+import contextlib
+import email.message
+import os
+import shutil
+import sys
+import tempfile
+from functools import partial
+from pathlib import Path
+from typing import Iterator, Optional, Tuple, cast
+from unittest import mock
+
+import pytest
+from pip._vendor.packaging.markers import Marker
+from pip._vendor.packaging.requirements import Requirement
+
+from pip._internal.cache import WheelCache
+from pip._internal.commands import create_command
+from pip._internal.commands.install import InstallCommand
+from pip._internal.exceptions import (
+    HashErrors,
+    InstallationError,
+    InvalidWheelFilename,
+    PreviousBuildDirError,
+)
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.metadata import select_backend
+from pip._internal.models.direct_url import ArchiveInfo, DirectUrl, DirInfo, VcsInfo
+from pip._internal.models.link import Link
+from pip._internal.network.session import PipSession
+from pip._internal.operations.build.build_tracker import get_build_tracker
+from pip._internal.operations.prepare import RequirementPreparer
+from pip._internal.req import InstallRequirement, RequirementSet
+from pip._internal.req.constructors import (
+    _get_url_from_path,
+    _looks_like_path,
+    install_req_from_editable,
+    install_req_from_line,
+    install_req_from_parsed_requirement,
+    install_req_from_req_string,
+    parse_editable,
+)
+from pip._internal.req.req_file import (
+    ParsedLine,
+    get_line_parser,
+    handle_requirement_line,
+)
+from pip._internal.resolution.legacy.resolver import Resolver
+from tests.lib import TestData, make_test_finder, requirements_file, wheel
+
+
+def get_processed_req_from_line(
+    line: str, fname: str = "file", lineno: int = 1
+) -> InstallRequirement:
+    line_parser = get_line_parser(None)
+    args_str, opts = line_parser(line)
+    parsed_line = ParsedLine(
+        fname,
+        lineno,
+        args_str,
+        opts,
+        False,
+    )
+    parsed_req = handle_requirement_line(parsed_line)
+    assert parsed_req is not None
+    req = install_req_from_parsed_requirement(parsed_req)
+    req.user_supplied = True
+    return req
+
+
+class TestRequirementSet:
+    """RequirementSet tests"""
+
+    def setup_method(self) -> None:
+        self.tempdir = tempfile.mkdtemp()
+
+    def teardown_method(self) -> None:
+        shutil.rmtree(self.tempdir, ignore_errors=True)
+
+    @contextlib.contextmanager
+    def _basic_resolver(
+        self,
+        finder: PackageFinder,
+        require_hashes: bool = False,
+        wheel_cache: OptionalWheelCache = None,
+    ) -> IteratorResolver:
+        make_install_req = partial(
+            install_req_from_req_string,
+            isolated=False,
+            use_pep517=None,
+        )
+        session = PipSession()
+
+        with get_build_tracker() as tracker:
+            preparer = RequirementPreparer(
+                build_dir=os.path.join(self.tempdir, "build"),
+                src_dir=os.path.join(self.tempdir, "src"),
+                download_dir=None,
+                build_isolation=True,
+                check_build_deps=False,
+                build_tracker=tracker,
+                session=session,
+                progress_bar="on",
+                finder=finder,
+                require_hashes=require_hashes,
+                use_user_site=False,
+                lazy_wheel=False,
+                verbosity=0,
+            )
+            yield Resolver(
+                preparer=preparer,
+                make_install_req=make_install_req,
+                finder=finder,
+                wheel_cache=wheel_cache,
+                use_user_site=False,
+                upgrade_strategy="to-satisfy-only",
+                ignore_dependencies=False,
+                ignore_installed=False,
+                ignore_requires_python=False,
+                force_reinstall=False,
+            )
+
+    def test_no_reuse_existing_build_dir(self, data: TestData) -> None:
+        """Test prepare_files raise exception with previous build dir"""
+
+        build_dir = os.path.join(self.tempdir, "build", "simple")
+        os.makedirs(build_dir)
+        with open(os.path.join(build_dir, "setup.py"), "w"):
+            pass
+        reqset = RequirementSet()
+        req = install_req_from_line("simple")
+        req.user_supplied = True
+        reqset.add_named_requirement(req)
+        finder = make_test_finder(find_links=data.find_links)
+        with self._basic_resolver(finder) as resolver:
+            with pytest.raises(
+                PreviousBuildDirError,
+                match=(
+                    r"pip can't proceed with \s\S*{req}\s\S*{build_dir_esc}".format(
+                        build_dir_esc=build_dir.replace("\\", "\\\\"), req=req
+                    )
+                ),
+            ):
+                resolver.resolve(reqset.all_requirements, True)
+
+    def test_environment_marker_extras(self, data: TestData) -> None:
+        """
+        Test that the environment marker extras are used with
+        non-wheel installs.
+        """
+        reqset = RequirementSet()
+        req = install_req_from_editable(
+            os.fspath(data.packages.joinpath("LocalEnvironMarker")),
+        )
+        req.user_supplied = True
+        reqset.add_unnamed_requirement(req)
+        finder = make_test_finder(find_links=data.find_links)
+        with self._basic_resolver(finder) as resolver:
+            reqset = resolver.resolve(reqset.all_requirements, True)
+        assert not reqset.has_requirement("simple")
+
+    def test_missing_hash_with_require_hashes(self, data: TestData) -> None:
+        """Setting --require-hashes explicitly should raise errors if hashes
+        are missing.
+        """
+        reqset = RequirementSet()
+        reqset.add_named_requirement(
+            get_processed_req_from_line("simple==1.0", lineno=1)
+        )
+
+        finder = make_test_finder(find_links=data.find_links)
+
+        with self._basic_resolver(finder, require_hashes=True) as resolver:
+            with pytest.raises(
+                HashErrors,
+                match=(
+                    r"Hashes are required in --require-hashes mode, but they are "
+                    r"missing .*\n"
+                    r"    simple==1.0 --hash=sha256:393043e672415891885c9a2a0929b1"
+                    r"af95fb866d6ca016b42d2e6ce53619b653$"
+                ),
+            ):
+                resolver.resolve(reqset.all_requirements, True)
+
+    def test_missing_hash_with_require_hashes_in_reqs_file(
+        self, data: TestData, tmpdir: Path
+    ) -> None:
+        """--require-hashes in a requirements file should make its way to the
+        RequirementSet.
+        """
+        finder = make_test_finder(find_links=data.find_links)
+        session = finder._link_collector.session
+        command = cast(InstallCommand, create_command("install"))
+        with requirements_file("--require-hashes", tmpdir) as reqs_file:
+            options, args = command.parse_args("-r", os.fspath(reqs_file))
+            command.get_requirements(args, options, finder, session)
+        assert options.require_hashes
+
+    def test_unsupported_hashes(self, data: TestData) -> None:
+        """VCS and dir links should raise errors when --require-hashes is
+        on.
+
+        In addition, complaints about the type of requirement (VCS or dir)
+        should trump the presence or absence of a hash.
+
+        """
+        reqset = RequirementSet()
+        reqset.add_unnamed_requirement(
+            get_processed_req_from_line(
+                "git+git://github.com/pypa/pip-test-package --hash=sha256:123",
+                lineno=1,
+            )
+        )
+        dir_path = data.packages.joinpath("FSPkg")
+        reqset.add_unnamed_requirement(
+            get_processed_req_from_line(
+                f"file://{dir_path}",
+                lineno=2,
+            )
+        )
+        finder = make_test_finder(find_links=data.find_links)
+
+        sep = os.path.sep
+        if sep == "\\":
+            sep = "\\\\"  # This needs to be escaped for the regex
+
+        with self._basic_resolver(finder, require_hashes=True) as resolver:
+            with pytest.raises(
+                HashErrors,
+                match=(
+                    r"Can't verify hashes for these requirements because we don't "
+                    r"have a way to hash version control repositories:\n"
+                    r"    git\+git://github\.com/pypa/pip-test-package $from -r "
+                    r"file \(line 1$\)\n"
+                    r"Can't verify hashes for these file:// requirements because "
+                    r"they point to directories:\n"
+                    r"    file://.*{sep}data{sep}packages{sep}FSPkg "
+                    r"$from -r file \(line 2$\)".format(sep=sep)
+                ),
+            ):
+                resolver.resolve(reqset.all_requirements, True)
+
+    def test_unpinned_hash_checking(self, data: TestData) -> None:
+        """Make sure prepare_files() raises an error when a requirement is not
+        version-pinned in hash-checking mode.
+        """
+        reqset = RequirementSet()
+        # Test that there must be exactly 1 specifier:
+        reqset.add_named_requirement(
+            get_processed_req_from_line(
+                "simple --hash=sha256:a90427ae31f5d1d0d7ec06ee97d9fcf2d0fc9a786985"
+                "250c1c83fd68df5911dd",
+                lineno=1,
+            )
+        )
+        # Test that the operator must be ==:
+        reqset.add_named_requirement(
+            get_processed_req_from_line(
+                "simple2>1.0 --hash=sha256:3ad45e1e9aa48b4462af0"
+                "123f6a7e44a9115db1ef945d4d92c123dfe21815a06",
+                lineno=2,
+            )
+        )
+        finder = make_test_finder(find_links=data.find_links)
+        with self._basic_resolver(finder, require_hashes=True) as resolver:
+            with pytest.raises(
+                HashErrors,
+                # Make sure all failing requirements are listed:
+                match=(
+                    r"versions pinned with ==. These do not:\n"
+                    r"    simple .* $from -r file \(line 1$\)\n"
+                    r"    simple2>1.0 .* $from -r file \(line 2$\)"
+                ),
+            ):
+                resolver.resolve(reqset.all_requirements, True)
+
+    def test_hash_mismatch(self, data: TestData) -> None:
+        """A hash mismatch should raise an error."""
+        file_url = data.packages.joinpath("simple-1.0.tar.gz").resolve().as_uri()
+        reqset = RequirementSet()
+        reqset.add_unnamed_requirement(
+            get_processed_req_from_line(
+                f"{file_url} --hash=sha256:badbad",
+                lineno=1,
+            )
+        )
+        finder = make_test_finder(find_links=data.find_links)
+        with self._basic_resolver(finder, require_hashes=True) as resolver:
+            with pytest.raises(
+                HashErrors,
+                match=(
+                    r"THESE PACKAGES DO NOT MATCH THE HASHES.*\n"
+                    r"    file:///.*/data/packages/simple-1\.0\.tar\.gz .*:\n"
+                    r"        Expected sha256 badbad\n"
+                    r"             Got        393043e672415891885c9a2a0929b1af95fb"
+                    r"866d6ca016b42d2e6ce53619b653$"
+                ),
+            ):
+                resolver.resolve(reqset.all_requirements, True)
+
+    def test_unhashed_deps_on_require_hashes(self, data: TestData) -> None:
+        """Make sure unhashed, unpinned, or otherwise unrepeatable
+        dependencies get complained about when --require-hashes is on."""
+        reqset = RequirementSet()
+        finder = make_test_finder(find_links=data.find_links)
+        reqset.add_named_requirement(
+            get_processed_req_from_line(
+                "TopoRequires2==0.0.1 "  # requires TopoRequires
+                "--hash=sha256:eaf9a01242c9f2f42cf2bd82a6a848cd"
+                "e3591d14f7896bdbefcf48543720c970",
+                lineno=1,
+            )
+        )
+
+        with self._basic_resolver(finder, require_hashes=True) as resolver:
+            with pytest.raises(
+                HashErrors,
+                match=(
+                    r"In --require-hashes mode, all requirements must have their "
+                    r"versions pinned.*\n"
+                    r"    TopoRequires from .*$"
+                ),
+            ):
+                resolver.resolve(reqset.all_requirements, True)
+
+    def test_hashed_deps_on_require_hashes(self) -> None:
+        """Make sure hashed dependencies get installed when --require-hashes
+        is on.
+
+        (We actually just check that no "not all dependencies are hashed!"
+        error gets raised while preparing; there is no reason to expect
+        installation to then fail, as the code paths are the same as ever.)
+
+        """
+        reqset = RequirementSet()
+        reqset.add_named_requirement(
+            get_processed_req_from_line(
+                "TopoRequires2==0.0.1 "  # requires TopoRequires
+                "--hash=sha256:eaf9a01242c9f2f42cf2bd82a6a848cd"
+                "e3591d14f7896bdbefcf48543720c970",
+                lineno=1,
+            )
+        )
+        reqset.add_named_requirement(
+            get_processed_req_from_line(
+                "TopoRequires==0.0.1 "
+                "--hash=sha256:d6dd1e22e60df512fdcf3640ced3039b3b02a56ab2cee81ebcb"
+                "3d0a6d4e8bfa6",
+                lineno=2,
+            )
+        )
+
+    def test_download_info_find_links(self, data: TestData) -> None:
+        """Test that download_info is set for requirements via find_links."""
+        finder = make_test_finder(find_links=data.find_links)
+        with self._basic_resolver(finder) as resolver:
+            ireq = get_processed_req_from_line("simple")
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert isinstance(req.download_info.info, ArchiveInfo)
+            assert req.download_info.info.hash
+
+    @pytest.mark.network
+    def test_download_info_index_url(self) -> None:
+        """Test that download_info is set for requirements via index."""
+        finder = make_test_finder(index_urls="https://pypi.org/simple")
+        with self._basic_resolver(finder) as resolver:
+            ireq = get_processed_req_from_line("initools")
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert isinstance(req.download_info.info, ArchiveInfo)
+
+    @pytest.mark.network
+    def test_download_info_web_archive(self) -> None:
+        """Test that download_info is set for requirements from a web archive."""
+        finder = make_test_finder()
+        with self._basic_resolver(finder) as resolver:
+            ireq = get_processed_req_from_line(
+                "pip-test-package @ "
+                "https://github.com/pypa/pip-test-package/tarball/0.1.1"
+            )
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert (
+                req.download_info.url
+                == "https://github.com/pypa/pip-test-package/tarball/0.1.1"
+            )
+            assert isinstance(req.download_info.info, ArchiveInfo)
+            assert (
+                req.download_info.info.hash == "sha256="
+                "ad977496000576e1b6c41f6449a9897087ce9da6db4f15b603fe8372af4bf3c6"
+            )
+
+    def test_download_info_archive_legacy_cache(
+        self, tmp_path: Path, shared_data: TestData
+    ) -> None:
+        """Test download_info hash is not set for an archive with legacy cache entry."""
+        url = shared_data.packages.joinpath("simple-1.0.tar.gz").as_uri()
+        finder = make_test_finder()
+        wheel_cache = WheelCache(str(tmp_path / "cache"))
+        cache_entry_dir = wheel_cache.get_path_for_link(Link(url))
+        Path(cache_entry_dir).mkdir(parents=True)
+        wheel.make_wheel(name="simple", version="1.0").save_to_dir(cache_entry_dir)
+        with self._basic_resolver(finder, wheel_cache=wheel_cache) as resolver:
+            ireq = get_processed_req_from_line(f"simple @ {url}")
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.is_wheel_from_cache
+            assert req.cached_wheel_source_link
+            assert req.download_info
+            assert req.download_info.url == url
+            assert isinstance(req.download_info.info, ArchiveInfo)
+            assert not req.download_info.info.hash
+
+    def test_download_info_archive_cache_with_origin(
+        self, tmp_path: Path, shared_data: TestData
+    ) -> None:
+        """Test download_info hash is set for a web archive with cache entry
+        that has origin.json."""
+        url = shared_data.packages.joinpath("simple-1.0.tar.gz").as_uri()
+        hash = "sha256=ad977496000576e1b6c41f6449a9897087ce9da6db4f15b603fe8372af4bf3c6"
+        finder = make_test_finder()
+        wheel_cache = WheelCache(str(tmp_path / "cache"))
+        cache_entry_dir = wheel_cache.get_path_for_link(Link(url))
+        Path(cache_entry_dir).mkdir(parents=True)
+        Path(cache_entry_dir).joinpath("origin.json").write_text(
+            DirectUrl(url, ArchiveInfo(hash=hash)).to_json()
+        )
+        wheel.make_wheel(name="simple", version="1.0").save_to_dir(cache_entry_dir)
+        with self._basic_resolver(finder, wheel_cache=wheel_cache) as resolver:
+            ireq = get_processed_req_from_line(f"simple @ {url}")
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.is_wheel_from_cache
+            assert req.cached_wheel_source_link
+            assert req.download_info
+            assert req.download_info.url == url
+            assert isinstance(req.download_info.info, ArchiveInfo)
+            assert req.download_info.info.hash == hash
+
+    def test_download_info_local_wheel(self, data: TestData) -> None:
+        """Test that download_info is set for requirements from a local wheel."""
+        finder = make_test_finder()
+        with self._basic_resolver(finder) as resolver:
+            ireq = get_processed_req_from_line(
+                f"{data.packages}/simplewheel-1.0-py2.py3-none-any.whl"
+            )
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert req.download_info.url.startswith("file://")
+            assert isinstance(req.download_info.info, ArchiveInfo)
+            assert (
+                req.download_info.info.hash == "sha256="
+                "e63aa139caee941ec7f33f057a5b987708c2128238357cf905429846a2008718"
+            )
+
+    def test_download_info_local_dir(self, data: TestData) -> None:
+        """Test that download_info is set for requirements from a local dir."""
+        finder = make_test_finder()
+        with self._basic_resolver(finder) as resolver:
+            ireq_url = data.packages.joinpath("FSPkg").as_uri()
+            ireq = get_processed_req_from_line(f"FSPkg @ {ireq_url}")
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert req.download_info.url.startswith("file://")
+            assert isinstance(req.download_info.info, DirInfo)
+
+    def test_download_info_local_editable_dir(self, data: TestData) -> None:
+        """Test that download_info is set for requirements from a local editable dir."""
+        finder = make_test_finder()
+        with self._basic_resolver(finder) as resolver:
+            ireq_url = data.packages.joinpath("FSPkg").as_uri()
+            ireq = get_processed_req_from_line(f"-e {ireq_url}#egg=FSPkg")
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert req.download_info.url.startswith("file://")
+            assert isinstance(req.download_info.info, DirInfo)
+            assert req.download_info.info.editable
+
+    @pytest.mark.network
+    def test_download_info_vcs(self) -> None:
+        """Test that download_info is set for requirements from git."""
+        finder = make_test_finder()
+        with self._basic_resolver(finder) as resolver:
+            ireq = get_processed_req_from_line(
+                "pip-test-package @ git+https://github.com/pypa/pip-test-package"
+            )
+            reqset = resolver.resolve(ireq, True)
+            assert len(reqset.all_requirements) == 1
+            req = reqset.all_requirements0
+            assert req.download_info
+            assert isinstance(req.download_info.info, VcsInfo)
+            assert req.download_info.url == "https://github.com/pypa/pip-test-package"
+            assert req.download_info.info.vcs == "git"
+
+
+class TestInstallRequirement:
+    def setup_method(self) -> None:
+        self.tempdir = tempfile.mkdtemp()
+
+    def teardown_method(self) -> None:
+        shutil.rmtree(self.tempdir, ignore_errors=True)
+
+    def test_url_with_query(self) -> None:
+        """InstallRequirement should strip the fragment, but not the query."""
+        url = "http://foo.com/?p=bar.git;a=snapshot;h=v0.1;sf=tgz"
+        fragment = "#egg=bar"
+        req = install_req_from_line(url + fragment)
+        assert req.link is not None
+        assert req.link.url == url + fragment, req.link
+
+    def test_pep440_wheel_link_requirement(self) -> None:
+        url = "https://whatever.com/test-0.4-py2.py3-bogus-any.whl"
+        line = "test @ https://whatever.com/test-0.4-py2.py3-bogus-any.whl"
+        req = install_req_from_line(line)
+        parts = str(req.req).split("@", 1)
+        assert len(parts) == 2
+        assert parts0.strip() == "test"
+        assert parts1.strip() == url
+
+    def test_pep440_url_link_requirement(self) -> None:
+        url = "git+http://foo.com@ref#egg=foo"
+        line = "foo @ git+http://foo.com@ref#egg=foo"
+        req = install_req_from_line(line)
+        parts = str(req.req).split("@", 1)
+        assert len(parts) == 2
+        assert parts0.strip() == "foo"
+        assert parts1.strip() == url
+
+    def test_url_with_authentication_link_requirement(self) -> None:
+        url = "https://what@whatever.com/test-0.4-py2.py3-bogus-any.whl"
+        line = "https://what@whatever.com/test-0.4-py2.py3-bogus-any.whl"
+        req = install_req_from_line(line)
+        assert req.link is not None
+        assert req.link.is_wheel
+        assert req.link.scheme == "https"
+        assert req.link.url == url
+
+    def test_str(self) -> None:
+        req = install_req_from_line("simple==0.1")
+        assert str(req) == "simple==0.1"
+
+    def test_repr(self) -> None:
+        req = install_req_from_line("simple==0.1")
+        assert repr(req) == ("<InstallRequirement object: simple==0.1 editable=False>")
+
+    def test_invalid_wheel_requirement_raises(self) -> None:
+        with pytest.raises(InvalidWheelFilename):
+            install_req_from_line("invalid.whl")
+
+    def test_wheel_requirement_sets_req_attribute(self) -> None:
+        req = install_req_from_line("simple-0.1-py2.py3-none-any.whl")
+        assert isinstance(req.req, Requirement)
+        assert str(req.req) == "simple==0.1"
+
+    def test_url_preserved_line_req(self) -> None:
+        """Confirm the url is preserved in a non-editable requirement"""
+        url = "git+http://foo.com@ref#egg=foo"
+        req = install_req_from_line(url)
+        assert req.link is not None
+        assert req.link.url == url
+
+    def test_url_preserved_editable_req(self) -> None:
+        """Confirm the url is preserved in a editable requirement"""
+        url = "git+http://foo.com@ref#egg=foo"
+        req = install_req_from_editable(url)
+        assert req.link is not None
+        assert req.link.url == url
+
+    @pytest.mark.parametrize(
+        "path",
+        (
+            "/path/to/foo.egg-info".replace("/", os.path.sep),
+            # Tests issue fixed by https://github.com/pypa/pip/pull/2530
+            "/path/to/foo.egg-info/".replace("/", os.path.sep),
+        ),
+    )
+    def test_get_dist(self, path: str) -> None:
+        req = install_req_from_line("foo")
+        req.metadata_directory = path
+        dist = req.get_dist()
+        assert isinstance(dist, select_backend().Distribution)
+        assert dist.raw_name == dist.canonical_name == "foo"
+        assert dist.location == "/path/to".replace("/", os.path.sep)
+
+    def test_markers(self) -> None:
+        for line in (
+            # recommended syntax
+            'mock3; python_version >= "3"',
+            # with more spaces
+            'mock3 ; python_version >= "3" ',
+            # without spaces
+            'mock3;python_version >= "3"',
+        ):
+            req = install_req_from_line(line)
+            assert req.req is not None
+            assert req.req.name == "mock3"
+            assert str(req.req.specifier) == ""
+            assert str(req.markers) == 'python_version >= "3"'
+
+    def test_markers_semicolon(self) -> None:
+        # check that the markers can contain a semicolon
+        req = install_req_from_line('semicolon; os_name == "a; b"')
+        assert req.req is not None
+        assert req.req.name == "semicolon"
+        assert str(req.req.specifier) == ""
+        assert str(req.markers) == 'os_name == "a; b"'
+
+    def test_markers_url(self) -> None:
+        # test "URL; markers" syntax
+        url = "http://foo.com/?p=bar.git;a=snapshot;h=v0.1;sf=tgz"
+        line = f'{url}; python_version >= "3"'
+        req = install_req_from_line(line)
+        assert req.link is not None
+        assert req.link.url == url, req.link.url
+        assert str(req.markers) == 'python_version >= "3"'
+
+        # without space, markers are part of the URL
+        url = "http://foo.com/?p=bar.git;a=snapshot;h=v0.1;sf=tgz"
+        line = f'{url};python_version >= "3"'
+        req = install_req_from_line(line)
+        assert req.link is not None
+        assert req.link.url == line, req.link.url
+        assert req.markers is None
+
+    def test_markers_match_from_line(self) -> None:
+        # match
+        for markers in (
+            'python_version >= "1.0"',
+            f"sys_platform == {sys.platform!r}",
+        ):
+            line = "name; " + markers
+            req = install_req_from_line(line)
+            assert str(req.markers) == str(Marker(markers))
+            assert req.match_markers()
+
+        # don't match
+        for markers in (
+            'python_version >= "5.0"',
+            f"sys_platform != {sys.platform!r}",
+        ):
+            line = "name; " + markers
+            req = install_req_from_line(line)
+            assert str(req.markers) == str(Marker(markers))
+            assert not req.match_markers()
+
+    def test_markers_match(self) -> None:
+        # match
+        for markers in (
+            'python_version >= "1.0"',
+            f"sys_platform == {sys.platform!r}",
+        ):
+            line = "name; " + markers
+            req = install_req_from_line(line, comes_from="")
+            assert str(req.markers) == str(Marker(markers))
+            assert req.match_markers()
+
+        # don't match
+        for markers in (
+            'python_version >= "5.0"',
+            f"sys_platform != {sys.platform!r}",
+        ):
+            line = "name; " + markers
+            req = install_req_from_line(line, comes_from="")
+            assert str(req.markers) == str(Marker(markers))
+            assert not req.match_markers()
+
+    def test_extras_for_line_path_requirement(self) -> None:
+        line = "SomeProjectex1,ex2"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_line(line, comes_from=comes_from)
+        assert len(req.extras) == 2
+        assert req.extras == {"ex1", "ex2"}
+
+    def test_extras_for_line_url_requirement(self) -> None:
+        line = "git+https://url#egg=SomeProjectex1,ex2"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_line(line, comes_from=comes_from)
+        assert len(req.extras) == 2
+        assert req.extras == {"ex1", "ex2"}
+
+    def test_extras_for_editable_path_requirement(self) -> None:
+        url = ".ex1,ex2"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_editable(url, comes_from=comes_from)
+        assert len(req.extras) == 2
+        assert req.extras == {"ex1", "ex2"}
+
+    def test_extras_for_editable_url_requirement(self) -> None:
+        url = "git+https://url#egg=SomeProjectex1,ex2"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_editable(url, comes_from=comes_from)
+        assert len(req.extras) == 2
+        assert req.extras == {"ex1", "ex2"}
+
+    def test_unexisting_path(self) -> None:
+        with pytest.raises(InstallationError) as e:
+            install_req_from_line(os.path.join("this", "path", "does", "not", "exist"))
+        err_msg = e.value.args0
+        assert "Invalid requirement" in err_msg
+        assert "It looks like a path." in err_msg
+
+    def test_single_equal_sign(self) -> None:
+        with pytest.raises(InstallationError) as e:
+            install_req_from_line("toto=42")
+        err_msg = e.value.args0
+        assert "Invalid requirement" in err_msg
+        assert "= is not a valid operator. Did you mean == ?" in err_msg
+
+    def test_unidentifiable_name(self) -> None:
+        test_name = "-"
+        with pytest.raises(InstallationError) as e:
+            install_req_from_line(test_name)
+        err_msg = e.value.args0
+        assert f"Invalid requirement: '{test_name}'" == err_msg
+
+    def test_requirement_file(self) -> None:
+        req_file_path = os.path.join(self.tempdir, "test.txt")
+        with open(req_file_path, "w") as req_file:
+            req_file.write("pip\nsetuptools")
+        with pytest.raises(InstallationError) as e:
+            install_req_from_line(req_file_path)
+        err_msg = e.value.args0
+        assert "Invalid requirement" in err_msg
+        assert "It looks like a path. The path does exist." in err_msg
+        assert "appears to be a requirements file." in err_msg
+        assert "If that is the case, use the '-r' flag to install" in err_msg
+
+
+@mock.patch("pip._internal.req.req_install.os.path.abspath")
+@mock.patch("pip._internal.req.req_install.os.path.exists")
+@mock.patch("pip._internal.req.req_install.os.path.isdir")
+def test_parse_editable_local(
+    isdir_mock: mock.Mock, exists_mock: mock.Mock, abspath_mock: mock.Mock
+) -> None:
+    exists_mock.return_value = isdir_mock.return_value = True
+    # mocks needed to support path operations on windows tests
+    abspath_mock.return_value = "/some/path"
+    assert parse_editable(".") == (None, "file:///some/path", set())
+    abspath_mock.return_value = "/some/path/foo"
+    assert parse_editable("foo") == (
+        None,
+        "file:///some/path/foo",
+        set(),
+    )
+
+
+def test_parse_editable_explicit_vcs() -> None:
+    assert parse_editable("svn+https://foo#egg=foo") == (
+        "foo",
+        "svn+https://foo#egg=foo",
+        set(),
+    )
+
+
+def test_parse_editable_vcs_extras() -> None:
+    assert parse_editable("svn+https://foo#egg=fooextras") == (
+        "fooextras",
+        "svn+https://foo#egg=fooextras",
+        set(),
+    )
+
+
+@mock.patch("pip._internal.req.req_install.os.path.abspath")
+@mock.patch("pip._internal.req.req_install.os.path.exists")
+@mock.patch("pip._internal.req.req_install.os.path.isdir")
+def test_parse_editable_local_extras(
+    isdir_mock: mock.Mock, exists_mock: mock.Mock, abspath_mock: mock.Mock
+) -> None:
+    exists_mock.return_value = isdir_mock.return_value = True
+    abspath_mock.return_value = "/some/path"
+    assert parse_editable(".extras") == (
+        None,
+        "file:///some/path",
+        {"extras"},
+    )
+    abspath_mock.return_value = "/some/path/foo"
+    assert parse_editable("foobar,baz") == (
+        None,
+        "file:///some/path/foo",
+        {"bar", "baz"},
+    )
+
+
+def test_mismatched_versions(caplog: pytest.LogCaptureFixture) -> None:
+    req = InstallRequirement(
+        req=Requirement("simplewheel==2.0"),
+        comes_from=None,
+    )
+    req.source_dir = "/tmp/somewhere"  # make req believe it has been unpacked
+    # Monkeypatch!
+    metadata = email.message.Message()
+    metadata"name" = "simplewheel"
+    metadata"version" = "1.0"
+    req._metadata = metadata
+
+    req.assert_source_matches_version()
+    assert caplog.records-1.message == (
+        "Requested simplewheel==2.0, but installing version 1.0"
+    )
+
+
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        # Test UNIX-like paths
+        (("/path/to/installable"), True),
+        # Test relative paths
+        (("./path/to/installable"), True),
+        # Test current path
+        (("."), True),
+        # Test url paths
+        (("https://whatever.com/test-0.4-py2.py3-bogus-any.whl"), True),
+        # Test pep440 paths
+        (("test @ https://whatever.com/test-0.4-py2.py3-bogus-any.whl"), True),
+        # Test wheel
+        (("simple-0.1-py2.py3-none-any.whl"), False),
+    ,
+)
+def test_looks_like_path(args: str, expected: bool) -> None:
+    assert _looks_like_path(args) == expected
+
+
+@pytest.mark.skipif(
+    not sys.platform.startswith("win"), reason="Test only available on Windows"
+)
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        # Test relative paths
+        ((".\\path\\to\\installable"), True),
+        (("relative\\path"), True),
+        # Test absolute paths
+        (("C:\\absolute\\path"), True),
+    ,
+)
+def test_looks_like_path_win(args: str, expected: bool) -> None:
+    assert _looks_like_path(args) == expected
+
+
+@pytest.mark.parametrize(
+    "args, mock_returns, expected",
+    
+        # Test pep440 urls
+        (
+            (
+                "/path/to/foo @ git+http://foo.com@ref#egg=foo",
+                "foo @ git+http://foo.com@ref#egg=foo",
+            ),
+            (False, False),
+            None,
+        ),
+        # Test pep440 urls without spaces
+        (
+            (
+                "/path/to/foo@git+http://foo.com@ref#egg=foo",
+                "foo @ git+http://foo.com@ref#egg=foo",
+            ),
+            (False, False),
+            None,
+        ),
+        # Test pep440 wheel
+        (
+            (
+                "/path/to/test @ https://whatever.com/test-0.4-py2.py3-bogus-any.whl",
+                "test @ https://whatever.com/test-0.4-py2.py3-bogus-any.whl",
+            ),
+            (False, False),
+            None,
+        ),
+        # Test name is not a file
+        (("/path/to/simple==0.1", "simple==0.1"), (False, False), None),
+    ,
+)
+@mock.patch("pip._internal.req.req_install.os.path.isdir")
+@mock.patch("pip._internal.req.req_install.os.path.isfile")
+def test_get_url_from_path(
+    isdir_mock: mock.Mock,
+    isfile_mock: mock.Mock,
+    args: Tuplestr, str,
+    mock_returns: Tuplebool, bool,
+    expected: None,
+) -> None:
+    isdir_mock.return_value = mock_returns0
+    isfile_mock.return_value = mock_returns1
+    assert _get_url_from_path(*args) is expected
+
+
+@mock.patch("pip._internal.req.req_install.os.path.isdir")
+@mock.patch("pip._internal.req.req_install.os.path.isfile")
+def test_get_url_from_path__archive_file(
+    isdir_mock: mock.Mock, isfile_mock: mock.Mock
+) -> None:
+    isdir_mock.return_value = False
+    isfile_mock.return_value = True
+    name = "simple-0.1-py2.py3-none-any.whl"
+    url = Path(f"/path/to/{name}").resolve(strict=False).as_uri()
+    assert _get_url_from_path(f"/path/to/{name}", name) == url
+
+
+@mock.patch("pip._internal.req.req_install.os.path.isdir")
+@mock.patch("pip._internal.req.req_install.os.path.isfile")
+def test_get_url_from_path__installable_dir(
+    isdir_mock: mock.Mock, isfile_mock: mock.Mock
+) -> None:
+    isdir_mock.return_value = True
+    isfile_mock.return_value = True
+    name = "some/setuptools/project"
+    url = Path(f"/path/to/{name}").resolve(strict=False).as_uri()
+    assert _get_url_from_path(f"/path/to/{name}", name) == url
+
+
+@mock.patch("pip._internal.req.req_install.os.path.isdir")
+def test_get_url_from_path__installable_error(isdir_mock: mock.Mock) -> None:
+    isdir_mock.return_value = True
+    name = "some/setuptools/project"
+    path = os.path.join("/path/to/" + name)
+    with pytest.raises(InstallationError) as e:
+        _get_url_from_path(path, name)
+    err_msg = e.value.args0
+    assert "Neither 'setup.py' nor 'pyproject.toml' found" in err_msg

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_req_file.py Added

@@ -0,0 +1,892 @@
+import collections
+import logging
+import os
+import textwrap
+from optparse import Values
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Iterator, List, Optional, Tuple, Union
+from unittest import mock
+
+import pytest
+
+import pip._internal.req.req_file  # this will be monkeypatched
+from pip._internal.exceptions import InstallationError, RequirementsFileParseError
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.models.format_control import FormatControl
+from pip._internal.network.session import PipSession
+from pip._internal.req.constructors import (
+    install_req_from_editable,
+    install_req_from_line,
+    install_req_from_parsed_requirement,
+)
+from pip._internal.req.req_file import (
+    break_args_options,
+    ignore_comments,
+    join_lines,
+    parse_requirements,
+    preprocess,
+)
+from pip._internal.req.req_install import InstallRequirement
+from tests.lib import TestData, make_test_finder, requirements_file
+
+if TYPE_CHECKING:
+    from typing import Protocol
+else:
+    # Protocol was introduced in Python 3.8.
+    Protocol = object
+
+
+@pytest.fixture
+def session() -> PipSession:
+    return PipSession()
+
+
+@pytest.fixture
+def finder(session: PipSession) -> PackageFinder:
+    return make_test_finder(session=session)
+
+
+@pytest.fixture
+def options(session: PipSession) -> mock.Mock:
+    return mock.Mock(
+        isolated_mode=False,
+        index_url="default_url",
+        format_control=FormatControl(set(), set()),
+        features_enabled=,
+    )
+
+
+def parse_reqfile(
+    filename: UnionPath, str,
+    session: PipSession,
+    finder: OptionalPackageFinder = None,
+    options: OptionalValues = None,
+    constraint: bool = False,
+    isolated: bool = False,
+) -> IteratorInstallRequirement:
+    # Wrap parse_requirements/install_req_from_parsed_requirement to
+    # avoid having to write the same chunk of code in lots of tests.
+    for parsed_req in parse_requirements(
+        os.fspath(filename),
+        session,
+        finder=finder,
+        options=options,
+        constraint=constraint,
+    ):
+        yield install_req_from_parsed_requirement(
+            parsed_req,
+            isolated=isolated,
+            config_settings=parsed_req.options.get("config_settings")
+            if parsed_req.options
+            else None,
+        )
+
+
+def test_read_file_url(tmp_path: Path, session: PipSession) -> None:
+    reqs = tmp_path.joinpath("requirements.txt")
+    reqs.write_text("foo")
+    result = list(parse_requirements(reqs.as_posix(), session))
+
+    assert len(result) == 1, result
+    assert result0.requirement == "foo"
+
+    # The comes_from value has three parts: -r or -c flag, path, and line.
+    # The path value in the middle needs some special logic due to our path
+    # normalization logic.
+    assert result0.comes_from:3 == "-r "
+    assert result0.comes_from-9: == " (line 1)"
+    assert os.path.samefile(result0.comes_from3:-9, str(reqs))
+
+
+class TestPreprocess:
+    """tests for `preprocess`"""
+
+    def test_comments_and_joins_case1(self) -> None:
+        content = textwrap.dedent(
+            """\
+          req1 \\
+          # comment \\
+          req2
+        """
+        )
+        result = preprocess(content)
+        assert list(result) == (1, "req1"), (3, "req2")
+
+    def test_comments_and_joins_case2(self) -> None:
+        content = textwrap.dedent(
+            """\
+          req1\\
+          # comment
+        """
+        )
+        result = preprocess(content)
+        assert list(result) == (1, "req1")
+
+    def test_comments_and_joins_case3(self) -> None:
+        content = textwrap.dedent(
+            """\
+          req1 \\
+          # comment
+          req2
+        """
+        )
+        result = preprocess(content)
+        assert list(result) == (1, "req1"), (3, "req2")
+
+
+class TestIgnoreComments:
+    """tests for `ignore_comment`"""
+
+    def test_ignore_line(self) -> None:
+        lines = (1, ""), (2, "req1"), (3, "req2")
+        result = ignore_comments(lines)
+        assert list(result) == (2, "req1"), (3, "req2")
+
+    def test_ignore_comment(self) -> None:
+        lines = (1, "req1"), (2, "# comment"), (3, "req2")
+        result = ignore_comments(lines)
+        assert list(result) == (1, "req1"), (3, "req2")
+
+    def test_strip_comment(self) -> None:
+        lines = (1, "req1"), (2, "req # comment"), (3, "req2")
+        result = ignore_comments(lines)
+        assert list(result) == (1, "req1"), (2, "req"), (3, "req2")
+
+
+class TestJoinLines:
+    """tests for `join_lines`"""
+
+    def test_join_lines(self) -> None:
+        lines = enumerate(
+            
+                "line 1",
+                "line 2:1 \\",
+                "line 2:2",
+                "line 3:1 \\",
+                "line 3:2 \\",
+                "line 3:3",
+                "line 4",
+            ,
+            start=1,
+        )
+        expect = 
+            (1, "line 1"),
+            (2, "line 2:1 line 2:2"),
+            (4, "line 3:1 line 3:2 line 3:3"),
+            (7, "line 4"),
+        
+        assert expect == list(join_lines(lines))
+
+    def test_last_line_with_escape(self) -> None:
+        lines = enumerate(
+            
+                "line 1",
+                "line 2 \\",
+            ,
+            start=1,
+        )
+        expect = 
+            (1, "line 1"),
+            (2, "line 2 "),
+        
+        assert expect == list(join_lines(lines))
+
+
+class LineProcessor(Protocol):
+    def __call__(
+        self,
+        line: str,
+        filename: str,
+        line_number: int,
+        finder: OptionalPackageFinder = None,
+        options: OptionalValues = None,
+        session: OptionalPipSession = None,
+        constraint: bool = False,
+    ) -> ListInstallRequirement:
+        ...
+
+
+@pytest.fixture
+def line_processor(monkeypatch: pytest.MonkeyPatch, tmpdir: Path) -> LineProcessor:
+    def process_line(
+        line: str,
+        filename: str,
+        line_number: int,
+        finder: OptionalPackageFinder = None,
+        options: OptionalValues = None,
+        session: OptionalPipSession = None,
+        constraint: bool = False,
+    ) -> ListInstallRequirement:
+        if session is None:
+            session = PipSession()
+
+        prefix = "\n" * (line_number - 1)
+        path = tmpdir.joinpath(filename)
+        path.parent.mkdir(exist_ok=True)
+        path.write_text(prefix + line)
+        monkeypatch.chdir(str(tmpdir))
+        return list(
+            parse_reqfile(
+                filename,
+                finder=finder,
+                options=options,
+                session=session,
+                constraint=constraint,
+                isolated=options.isolated_mode if options else False,
+            )
+        )
+
+    return process_line
+
+
+class TestProcessLine:
+    """tests for `process_line`"""
+
+    def test_parser_error(self, line_processor: LineProcessor) -> None:
+        with pytest.raises(RequirementsFileParseError):
+            line_processor("--bogus", "file", 1)
+
+    def test_parser_offending_line(self, line_processor: LineProcessor) -> None:
+        line = "pkg==1.0.0 --hash=somehash"
+        with pytest.raises(RequirementsFileParseError) as err:
+            line_processor(line, "file", 1)
+        assert line in str(err.value)
+
+    def test_parser_non_offending_line(self, line_processor: LineProcessor) -> None:
+        try:
+            line_processor("pkg==1.0.0 --hash=sha256:somehash", "file", 1)
+        except RequirementsFileParseError:
+            pytest.fail("Reported offending line where it should not.")
+
+    def test_only_one_req_per_line(self, line_processor: LineProcessor) -> None:
+        # pkg_resources raises the ValueError
+        with pytest.raises(InstallationError):
+            line_processor("req1 req2", "file", 1)
+
+    def test_error_message(self, line_processor: LineProcessor) -> None:
+        """
+        Test the error message if a parsing error occurs (all of path,
+        line number, and hint).
+        """
+        with pytest.raises(InstallationError) as exc:
+            line_processor(
+                "my-package=1.0", filename="path/requirements.txt", line_number=3
+            )
+
+        expected = (
+            "Invalid requirement: 'my-package=1.0' "
+            "(from line 3 of path/requirements.txt)\n"
+            "Hint: = is not a valid operator. Did you mean == ?"
+        )
+        assert str(exc.value) == expected
+
+    def test_yield_line_requirement(self, line_processor: LineProcessor) -> None:
+        line = "SomeProject"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_line(line, comes_from=comes_from)
+        assert repr(line_processor(line, filename, 1)0) == repr(req)
+
+    def test_yield_pep440_line_requirement(self, line_processor: LineProcessor) -> None:
+        line = "SomeProject @ https://url/SomeProject-py2-py3-none-any.whl"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_line(line, comes_from=comes_from)
+        assert repr(line_processor(line, filename, 1)0) == repr(req)
+
+    def test_yield_line_constraint(self, line_processor: LineProcessor) -> None:
+        line = "SomeProject"
+        filename = "filename"
+        comes_from = "-c {} (line {})".format(filename, 1)
+        req = install_req_from_line(line, comes_from=comes_from, constraint=True)
+        found_req = line_processor(line, filename, 1, constraint=True)0
+        assert repr(found_req) == repr(req)
+        assert found_req.constraint is True
+
+    def test_yield_line_requirement_with_spaces_in_specifier(
+        self, line_processor: LineProcessor
+    ) -> None:
+        line = "SomeProject >= 2"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_line(line, comes_from=comes_from)
+        assert repr(line_processor(line, filename, 1)0) == repr(req)
+        assert req.req is not None
+        assert str(req.req.specifier) == ">=2"
+
+    def test_yield_editable_requirement(self, line_processor: LineProcessor) -> None:
+        url = "git+https://url#egg=SomeProject"
+        line = f"-e {url}"
+        filename = "filename"
+        comes_from = f"-r {filename} (line 1)"
+        req = install_req_from_editable(url, comes_from=comes_from)
+        assert repr(line_processor(line, filename, 1)0) == repr(req)
+
+    def test_yield_editable_constraint(self, line_processor: LineProcessor) -> None:
+        url = "git+https://url#egg=SomeProject"
+        line = f"-e {url}"
+        filename = "filename"
+        comes_from = "-c {} (line {})".format(filename, 1)
+        req = install_req_from_editable(url, comes_from=comes_from, constraint=True)
+        found_req = line_processor(line, filename, 1, constraint=True)0
+        assert repr(found_req) == repr(req)
+        assert found_req.constraint is True
+
+    def test_nested_constraints_file(
+        self, monkeypatch: pytest.MonkeyPatch, tmpdir: Path, session: PipSession
+    ) -> None:
+        req_name = "hello"
+        req_file = tmpdir / "parent" / "req_file.txt"
+        req_file.parent.mkdir()
+        req_file.write_text("-c reqs.txt")
+        req_file.parent.joinpath("reqs.txt").write_text(req_name)
+
+        monkeypatch.chdir(str(tmpdir))
+
+        reqs = list(parse_reqfile("./parent/req_file.txt", session=session))
+        assert len(reqs) == 1
+        assert reqs0.name == req_name
+        assert reqs0.constraint
+
+    def test_options_on_a_requirement_line(self, line_processor: LineProcessor) -> None:
+        line = (
+            'SomeProject --global-option="yo3" --global-option "yo4" '
+            '--config-settings="yo3=yo4" --config-settings "yo1=yo2"'
+        )
+        filename = "filename"
+        req = line_processor(line, filename, 1)0
+        assert req.global_options == "yo3", "yo4"
+        assert req.config_settings == {"yo3": "yo4", "yo1": "yo2"}
+
+    def test_hash_options(self, line_processor: LineProcessor) -> None:
+        """Test the --hash option: mostly its value storage.
+
+        Make sure it reads and preserve multiple hashes.
+
+        """
+        line = (
+            "SomeProject --hash=sha256:2cf24dba5fb0a30e26e83b2ac5b9e29e1b1"
+            "61e5c1fa7425e73043362938b9824 "
+            "--hash=sha384:59e1748777448c69de6b800d7a33bbfb9ff1b463e44354c"
+            "3553bcdb9c666fa90125a3c79f90397bdf5f6a13de828684f "
+            "--hash=sha256:486ea46224d1bb4fb680f34f7c9ad96a8f24ec88be73ea8"
+            "e5a6c65260e9cb8a7"
+        )
+        filename = "filename"
+        req = line_processor(line, filename, 1)0
+        assert req.hash_options == {
+            "sha256": 
+                "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
+                "486ea46224d1bb4fb680f34f7c9ad96a8f24ec88be73ea8e5a6c65260e9cb8a7",
+            ,
+            "sha384": 
+                "59e1748777448c69de6b800d7a33bbfb9ff1b463e44354c3553bcd"
+                "b9c666fa90125a3c79f90397bdf5f6a13de828684f"
+            ,
+        }
+
+    def test_set_isolated(
+        self, line_processor: LineProcessor, options: mock.Mock
+    ) -> None:
+        line = "SomeProject"
+        filename = "filename"
+        options.isolated_mode = True
+        result = line_processor(line, filename, 1, options=options)
+        assert result0.isolated
+
+    def test_set_finder_no_index(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--no-index", "file", 1, finder=finder)
+        assert finder.index_urls == 
+
+    def test_set_finder_no_index_is_remembered_for_later_invocations(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--no-index", "file", 1, finder=finder)
+        line_processor("--index-url=url", "file", 1, finder=finder)
+        assert finder.index_urls == 
+
+    def test_set_finder_index_url(
+        self, line_processor: LineProcessor, finder: PackageFinder, session: PipSession
+    ) -> None:
+        line_processor("--index-url=url", "file", 1, finder=finder, session=session)
+        assert finder.index_urls == "url"
+        assert session.auth.index_urls == "url"
+
+    def test_set_finder_find_links(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--find-links=url", "file", 1, finder=finder)
+        assert finder.find_links == "url"
+
+    def test_set_finder_extra_index_urls(
+        self, line_processor: LineProcessor, finder: PackageFinder, session: PipSession
+    ) -> None:
+        line_processor(
+            "--extra-index-url=url", "file", 1, finder=finder, session=session
+        )
+        assert finder.index_urls == "url"
+        assert session.auth.index_urls == "url"
+
+    def test_set_finder_trusted_host(
+        self,
+        line_processor: LineProcessor,
+        caplog: pytest.LogCaptureFixture,
+        session: PipSession,
+        finder: PackageFinder,
+    ) -> None:
+        with caplog.at_level(logging.INFO):
+            line_processor(
+                "--trusted-host=host1 --trusted-host=host2:8080",
+                "file.txt",
+                1,
+                finder=finder,
+                session=session,
+            )
+        assert list(finder.trusted_hosts) == "host1", "host2:8080"
+        session = finder._link_collector.session
+        assert session.adapters"https://host1/" is session._trusted_host_adapter
+        assert session.adapters"https://host2:8080/" is session._trusted_host_adapter
+
+        # Test the log message.
+        actual = (r.levelname, r.message) for r in caplog.records
+        expected = ("INFO", "adding trusted host: 'host1' (from line 1 of file.txt)")
+        assert expected in actual
+
+    def test_set_finder_allow_all_prereleases(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--pre", "file", 1, finder=finder)
+        assert finder.allow_all_prereleases
+
+    def test_use_feature(
+        self, line_processor: LineProcessor, options: mock.Mock
+    ) -> None:
+        """--use-feature can be set in requirements files."""
+        line_processor("--use-feature=fast-deps", "filename", 1, options=options)
+
+    def test_use_feature_with_error(
+        self, line_processor: LineProcessor, options: mock.Mock
+    ) -> None:
+        """--use-feature triggers error when parsing requirements files."""
+        with pytest.raises(RequirementsFileParseError):
+            line_processor(
+                "--use-feature=2020-resolver", "filename", 1, options=options
+            )
+
+    def test_relative_local_find_links(
+        self,
+        line_processor: LineProcessor,
+        finder: PackageFinder,
+        monkeypatch: pytest.MonkeyPatch,
+        tmpdir: Path,
+    ) -> None:
+        """
+        Test a relative find_links path is joined with the req file directory
+        """
+        base_path = tmpdir / "path"
+
+        def normalize(path: Path) -> str:
+            return os.path.normcase(os.path.abspath(os.path.normpath(str(path))))
+
+        # Make sure the test also passes on windows
+        req_file = normalize(base_path / "req_file.txt")
+        nested_link = normalize(base_path / "rel_path")
+        exists_ = os.path.exists
+
+        def exists(path: str) -> bool:
+            if path == nested_link:
+                return True
+            else:
+                return exists_(path)
+
+        monkeypatch.setattr(os.path, "exists", exists)
+        line_processor("--find-links=rel_path", req_file, 1, finder=finder)
+        assert finder.find_links == nested_link
+
+    def test_relative_http_nested_req_files(
+        self,
+        finder: PackageFinder,
+        session: PipSession,
+        monkeypatch: pytest.MonkeyPatch,
+    ) -> None:
+        """
+        Test a relative nested req file path is joined with the req file url
+        """
+        req_name = "hello"
+        req_file = "http://me.com/me/req_file.txt"
+
+        def get_file_content(
+            filename: str, *args: Any, **kwargs: Any
+        ) -> TupleNone, str:
+            if filename == req_file:
+                return None, "-r reqs.txt"
+            elif filename == "http://me.com/me/reqs.txt":
+                return None, req_name
+            assert False, f"Unexpected file requested {filename}"
+
+        monkeypatch.setattr(
+            pip._internal.req.req_file, "get_file_content", get_file_content
+        )
+
+        result = list(parse_reqfile(req_file, session=session))
+        assert len(result) == 1
+        assert result0.name == req_name
+        assert not result0.constraint
+
+    def test_relative_local_nested_req_files(
+        self, session: PipSession, monkeypatch: pytest.MonkeyPatch, tmpdir: Path
+    ) -> None:
+        """
+        Test a relative nested req file path is joined with the req file dir
+        """
+        req_name = "hello"
+        req_file = tmpdir / "parent" / "req_file.txt"
+        req_file.parent.mkdir()
+        req_file.write_text("-r reqs.txt")
+        req_file.parent.joinpath("reqs.txt").write_text(req_name)
+
+        monkeypatch.chdir(str(tmpdir))
+
+        reqs = list(parse_reqfile("./parent/req_file.txt", session=session))
+        assert len(reqs) == 1
+        assert reqs0.name == req_name
+        assert not reqs0.constraint
+
+    def test_absolute_local_nested_req_files(
+        self, session: PipSession, tmpdir: Path
+    ) -> None:
+        """
+        Test an absolute nested req file path
+        """
+        req_name = "hello"
+        req_file = tmpdir / "parent" / "req_file.txt"
+        req_file.parent.mkdir()
+        other_req_file = tmpdir / "other" / "reqs.txt"
+        other_req_file.parent.mkdir()
+        # POSIX-ify the path, since Windows backslashes aren't supported.
+        other_req_file_str = str(other_req_file).replace("\\", "/")
+
+        req_file.write_text(f"-r {other_req_file_str}")
+        other_req_file.write_text(req_name)
+
+        reqs = list(parse_reqfile(str(req_file), session=session))
+        assert len(reqs) == 1
+        assert reqs0.name == req_name
+        assert not reqs0.constraint
+
+    def test_absolute_http_nested_req_file_in_local(
+        self, session: PipSession, monkeypatch: pytest.MonkeyPatch, tmpdir: Path
+    ) -> None:
+        """
+        Test a nested req file url in a local req file
+        """
+        req_name = "hello"
+        req_file = tmpdir / "req_file.txt"
+        nested_req_file = "http://me.com/me/req_file.txt"
+
+        def get_file_content(
+            filename: str, *args: Any, **kwargs: Any
+        ) -> TupleNone, str:
+            if filename == str(req_file):
+                return None, f"-r {nested_req_file}"
+            elif filename == nested_req_file:
+                return None, req_name
+            assert False, f"Unexpected file requested {filename}"
+
+        monkeypatch.setattr(
+            pip._internal.req.req_file, "get_file_content", get_file_content
+        )
+
+        result = list(parse_reqfile(req_file, session=session))
+        assert len(result) == 1
+        assert result0.name == req_name
+        assert not result0.constraint
+
+
+class TestBreakOptionsArgs:
+    def test_no_args(self) -> None:
+        assert ("", "--option") == break_args_options("--option")
+
+    def test_no_options(self) -> None:
+        assert ("arg arg", "") == break_args_options("arg arg")
+
+    def test_args_short_options(self) -> None:
+        result = break_args_options("arg arg -s")
+        assert ("arg arg", "-s") == result
+
+    def test_args_long_options(self) -> None:
+        result = break_args_options("arg arg --long")
+        assert ("arg arg", "--long") == result
+
+
+class TestOptionVariants:
+    # this suite is really just testing optparse, but added it anyway
+
+    def test_variant1(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("-i url", "file", 1, finder=finder)
+        assert finder.index_urls == "url"
+
+    def test_variant2(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("-i 'url'", "file", 1, finder=finder)
+        assert finder.index_urls == "url"
+
+    def test_variant3(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--index-url=url", "file", 1, finder=finder)
+        assert finder.index_urls == "url"
+
+    def test_variant4(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--index-url url", "file", 1, finder=finder)
+        assert finder.index_urls == "url"
+
+    def test_variant5(
+        self, line_processor: LineProcessor, finder: PackageFinder
+    ) -> None:
+        line_processor("--index-url='url'", "file", 1, finder=finder)
+        assert finder.index_urls == "url"
+
+
+class TestParseRequirements:
+    """tests for `parse_reqfile`"""
+
+    @pytest.mark.network
+    def test_remote_reqs_parse(self) -> None:
+        """
+        Test parsing a simple remote requirements file
+        """
+        # this requirements file just contains a comment previously this has
+        # failed in py3: https://github.com/pypa/pip/issues/760
+        for _ in parse_reqfile(
+            "https://raw.githubusercontent.com/pypa/"
+            "pip-test-package/master/"
+            "tests/req_just_comment.txt",
+            session=PipSession(),
+        ):
+            pass
+
+    def test_multiple_appending_options(
+        self, tmpdir: Path, finder: PackageFinder, options: mock.Mock
+    ) -> None:
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write("--extra-index-url url1 \n")
+            fp.write("--extra-index-url url2 ")
+
+        list(
+            parse_reqfile(
+                tmpdir.joinpath("req1.txt"),
+                finder=finder,
+                session=PipSession(),
+                options=options,
+            )
+        )
+
+        assert finder.index_urls == "url1", "url2"
+
+    def test_expand_existing_env_variables(
+        self, tmpdir: Path, finder: PackageFinder
+    ) -> None:
+        template = "https://{}:x-oauth-basic@github.com/user/{}/archive/master.zip"
+
+        def make_var(name: str) -> str:
+            return f"${{{name}}}"
+
+        env_vars = collections.OrderedDict(
+            
+                ("GITHUB_TOKEN", "notarealtoken"),
+                ("DO_12_FACTOR", "awwyeah"),
+            
+        )
+
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write(template.format(*map(make_var, env_vars)))
+
+        # Construct the session outside the monkey-patch, since it access the
+        # env
+        session = PipSession()
+        with mock.patch("pip._internal.req.req_file.os.getenv") as getenv:
+            getenv.side_effect = lambda n: env_varsn
+
+            reqs = list(
+                parse_reqfile(
+                    tmpdir.joinpath("req1.txt"), finder=finder, session=session
+                )
+            )
+
+        assert len(reqs) == 1, "parsing requirement file with env variable failed"
+
+        expected_url = template.format(*env_vars.values())
+        assert reqs0.link is not None
+        assert reqs0.link.url == expected_url, "variable expansion in req file failed"
+
+    def test_expand_missing_env_variables(
+        self, tmpdir: Path, finder: PackageFinder
+    ) -> None:
+        req_url = (
+            "https://${NON_EXISTENT_VARIABLE}:$WRONG_FORMAT@"
+            "%WINDOWS_FORMAT%github.com/user/repo/archive/master.zip"
+        )
+
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write(req_url)
+
+        # Construct the session outside the monkey-patch, since it access the
+        # env
+        session = PipSession()
+        with mock.patch("pip._internal.req.req_file.os.getenv") as getenv:
+            getenv.return_value = ""
+
+            reqs = list(
+                parse_reqfile(
+                    tmpdir.joinpath("req1.txt"), finder=finder, session=session
+                )
+            )
+
+            assert len(reqs) == 1, "parsing requirement file with env variable failed"
+            assert reqs0.link is not None
+            assert (
+                reqs0.link.url == req_url
+            ), "ignoring invalid env variable in req file failed"
+
+    def test_join_lines(self, tmpdir: Path, finder: PackageFinder) -> None:
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write("--extra-index-url url1 \\\n--extra-index-url url2")
+
+        list(
+            parse_reqfile(
+                tmpdir.joinpath("req1.txt"), finder=finder, session=PipSession()
+            )
+        )
+
+        assert finder.index_urls == "url1", "url2"
+
+    def test_req_file_parse_no_only_binary(
+        self, data: TestData, finder: PackageFinder
+    ) -> None:
+        list(
+            parse_reqfile(
+                data.reqfiles.joinpath("supported_options2.txt"),
+                finder=finder,
+                session=PipSession(),
+            )
+        )
+        expected = FormatControl({"fred"}, {"wilma"})
+        assert finder.format_control == expected
+
+    def test_req_file_parse_comment_start_of_line(
+        self, tmpdir: Path, finder: PackageFinder
+    ) -> None:
+        """
+        Test parsing comments in a requirements file
+        """
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write("# Comment ")
+
+        reqs = list(
+            parse_reqfile(
+                tmpdir.joinpath("req1.txt"), finder=finder, session=PipSession()
+            )
+        )
+
+        assert not reqs
+
+    def test_invalid_options(self, tmpdir: Path, finder: PackageFinder) -> None:
+        """
+        Test parsing invalid options such as missing closing quotation
+        """
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write("--'data\n")
+
+        with pytest.raises(RequirementsFileParseError):
+            list(
+                parse_reqfile(
+                    tmpdir.joinpath("req1.txt"), finder=finder, session=PipSession()
+                )
+            )
+
+    def test_req_file_parse_comment_end_of_line_with_url(
+        self, tmpdir: Path, finder: PackageFinder
+    ) -> None:
+        """
+        Test parsing comments in a requirements file
+        """
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write("https://example.com/foo.tar.gz # Comment ")
+
+        reqs = list(
+            parse_reqfile(
+                tmpdir.joinpath("req1.txt"), finder=finder, session=PipSession()
+            )
+        )
+
+        assert len(reqs) == 1
+        assert reqs0.link is not None
+        assert reqs0.link.url == "https://example.com/foo.tar.gz"
+
+    def test_req_file_parse_egginfo_end_of_line_with_url(
+        self, tmpdir: Path, finder: PackageFinder
+    ) -> None:
+        """
+        Test parsing comments in a requirements file
+        """
+        with open(tmpdir.joinpath("req1.txt"), "w") as fp:
+            fp.write("https://example.com/foo.tar.gz#egg=wat")
+
+        reqs = list(
+            parse_reqfile(
+                tmpdir.joinpath("req1.txt"), finder=finder, session=PipSession()
+            )
+        )
+
+        assert len(reqs) == 1
+        assert reqs0.name == "wat"
+
+    def test_req_file_no_finder(self, tmpdir: Path) -> None:
+        """
+        Test parsing a requirements file without a finder
+        """
+        with open(tmpdir.joinpath("req.txt"), "w") as fp:
+            fp.write(
+                """
+    --find-links https://example.com/
+    --index-url https://example.com/
+    --extra-index-url https://two.example.com/
+    --no-use-wheel
+    --no-index
+            """
+            )
+
+        parse_reqfile(tmpdir.joinpath("req.txt"), session=PipSession())
+
+    def test_install_requirements_with_options(
+        self,
+        tmpdir: Path,
+        finder: PackageFinder,
+        session: PipSession,
+        options: mock.Mock,
+    ) -> None:
+        global_option = "--dry-run"
+
+        content = """
+        --only-binary :all:
+        INITools==2.0 --global-option="{global_option}"
+        """.format(
+            global_option=global_option
+        )
+
+        with requirements_file(content, tmpdir) as reqs_file:
+            req = next(
+                parse_reqfile(
+                    reqs_file.resolve(), finder=finder, options=options, session=session
+                )
+            )
+
+        assert req.global_options == global_option

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_req_install.py Added

@@ -0,0 +1,112 @@
+import os
+import tempfile
+from pathlib import Path
+
+import pytest
+from pip._vendor.packaging.requirements import Requirement
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.req.constructors import (
+    install_req_from_line,
+    install_req_from_req_string,
+)
+from pip._internal.req.req_install import InstallRequirement
+
+
+class TestInstallRequirementBuildDirectory:
+    # no need to test symlinks on Windows
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_tmp_build_directory(self) -> None:
+        # when req is None, we can produce a temporary directory
+        # Make sure we're handling it correctly with real path.
+        requirement = InstallRequirement(None, None)
+        tmp_dir = tempfile.mkdtemp("-build", "pip-")
+        tmp_build_dir = requirement.ensure_build_location(
+            tmp_dir,
+            autodelete=False,
+            parallel_builds=False,
+        )
+        assert os.path.dirname(tmp_build_dir) == os.path.realpath(
+            os.path.dirname(tmp_dir)
+        )
+        # are we on a system where /tmp is a symlink
+        if os.path.realpath(tmp_dir) != os.path.abspath(tmp_dir):
+            assert os.path.dirname(tmp_build_dir) != os.path.dirname(tmp_dir)
+        else:
+            assert os.path.dirname(tmp_build_dir) == os.path.dirname(tmp_dir)
+        os.rmdir(tmp_dir)
+        assert not os.path.exists(tmp_dir)
+
+    def test_forward_slash_results_in_a_link(self, tmpdir: Path) -> None:
+        install_dir = tmpdir / "foo" / "bar"
+
+        # Just create a file for letting the logic work
+        setup_py_path = install_dir / "setup.py"
+        os.makedirs(str(install_dir))
+        with open(setup_py_path, "w") as f:
+            f.write("")
+
+        requirement = install_req_from_line(install_dir.as_posix())
+
+        assert requirement.link is not None
+
+
+class TestInstallRequirementFrom:
+    def test_install_req_from_string_invalid_requirement(self) -> None:
+        """
+        Requirement strings that cannot be parsed by
+        packaging.requirements.Requirement raise an InstallationError.
+        """
+        with pytest.raises(InstallationError) as excinfo:
+            install_req_from_req_string("http:/this/is/invalid")
+
+        assert str(excinfo.value) == ("Invalid requirement: 'http:/this/is/invalid'")
+
+    def test_install_req_from_string_without_comes_from(self) -> None:
+        """
+        Test to make sure that install_req_from_string succeeds
+        when called with URL (PEP 508) but without comes_from.
+        """
+        # Test with a PEP 508 url install string:
+        wheel_url = (
+            "https://download.pytorch.org/whl/cu90/"
+            "torch-1.0.0-cp36-cp36m-win_amd64.whl"
+        )
+        install_str = "torch@ " + wheel_url
+        install_req = install_req_from_req_string(install_str)
+
+        assert isinstance(install_req, InstallRequirement)
+        assert install_req.link is not None
+        assert install_req.link.url == wheel_url
+        assert install_req.req is not None
+        assert install_req.req.url == wheel_url
+        assert install_req.comes_from is None
+        assert install_req.is_wheel
+
+    def test_install_req_from_string_with_comes_from_without_link(self) -> None:
+        """
+        Test to make sure that install_req_from_string succeeds
+        when called with URL (PEP 508) and comes_from
+        does not have a link.
+        """
+        # Test with a PEP 508 url install string:
+        wheel_url = (
+            "https://download.pytorch.org/whl/cu90/"
+            "torch-1.0.0-cp36-cp36m-win_amd64.whl"
+        )
+        install_str = "torch@ " + wheel_url
+
+        # Dummy numpy "comes_from" requirement without link:
+        comes_from = InstallRequirement(Requirement("numpy>=1.15.0"), comes_from=None)
+
+        # Attempt install from install string comes:
+        install_req = install_req_from_req_string(install_str, comes_from=comes_from)
+
+        assert isinstance(install_req, InstallRequirement)
+        assert isinstance(install_req.comes_from, InstallRequirement)
+        assert install_req.comes_from.link is None
+        assert install_req.link is not None
+        assert install_req.link.url == wheel_url
+        assert install_req.req is not None
+        assert install_req.req.url == wheel_url
+        assert install_req.is_wheel

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_req_uninstall.py Added

@@ -0,0 +1,424 @@
+import os
+import sys
+from pathlib import Path
+from typing import Iterator, List, Optional, Tuple
+from unittest.mock import Mock
+
+import pytest
+
+import pip._internal.req.req_uninstall
+from pip._internal.req.req_uninstall import (
+    StashedUninstallPathSet,
+    UninstallPathSet,
+    UninstallPthEntries,
+    compact,
+    compress_for_output_listing,
+    compress_for_rename,
+    uninstallation_paths,
+)
+from tests.lib import create_file
+
+
+# Pretend all files are local, so UninstallPathSet accepts files in the tmpdir,
+# outside the virtualenv
+def mock_permitted(ups: UninstallPathSet, path: str) -> bool:
+    return True
+
+
+def test_uninstallation_paths() -> None:
+    class dist:
+        def iter_declared_entries(self) -> OptionalIteratorstr:
+            yield "file.py"
+            yield "file.pyc"
+            yield "file.so"
+            yield "nopyc.py"
+
+        location = ""
+
+    d = dist()
+
+    paths = list(uninstallation_paths(d))
+
+    expected = 
+        "file.py",
+        "file.pyc",
+        "file.pyo",
+        "file.so",
+        "nopyc.py",
+        "nopyc.pyc",
+        "nopyc.pyo",
+    
+
+    assert paths == expected
+
+    # Avoid an easy 'unique generator' bug
+    paths2 = list(uninstallation_paths(d))
+
+    assert paths2 == paths
+
+
+def test_compressed_listing(tmpdir: Path) -> None:
+    def in_tmpdir(paths: Liststr) -> Liststr:
+        li = 
+        for path in paths:
+            li.append(str(os.path.join(tmpdir, path.replace("/", os.path.sep))))
+        return li
+
+    sample = in_tmpdir(
+        
+            "lib/mypkg.dist-info/METADATA",
+            "lib/mypkg.dist-info/PKG-INFO",
+            "lib/mypkg/would_be_removed.txt",
+            "lib/mypkg/would_be_skipped.skip.txt",
+            "lib/mypkg/__init__.py",
+            "lib/mypkg/my_awesome_code.py",
+            "lib/mypkg/__pycache__/my_awesome_code-magic.pyc",
+            "lib/mypkg/support/support_file.py",
+            "lib/mypkg/support/more_support.py",
+            "lib/mypkg/support/would_be_skipped.skip.py",
+            "lib/mypkg/support/__pycache__/support_file-magic.pyc",
+            "lib/random_other_place/file_without_a_dot_pyc",
+            "bin/mybin",
+        
+    )
+
+    # Create the required files
+    for fname in sample:
+        create_file(fname, "random blub")
+
+    # Remove the files to be skipped from the paths
+    sample = path for path in sample if ".skip." not in path
+
+    expected_remove = in_tmpdir(
+        
+            "bin/mybin",
+            "lib/mypkg.dist-info/*",
+            "lib/mypkg/*",
+            "lib/random_other_place/file_without_a_dot_pyc",
+        
+    )
+
+    expected_skip = in_tmpdir(
+        
+            "lib/mypkg/would_be_skipped.skip.txt",
+            "lib/mypkg/support/would_be_skipped.skip.py",
+        
+    )
+
+    expected_rename = in_tmpdir(
+        
+            "bin/",
+            "lib/mypkg.dist-info/",
+            "lib/mypkg/would_be_removed.txt",
+            "lib/mypkg/__init__.py",
+            "lib/mypkg/my_awesome_code.py",
+            "lib/mypkg/__pycache__/",
+            "lib/mypkg/support/support_file.py",
+            "lib/mypkg/support/more_support.py",
+            "lib/mypkg/support/__pycache__/",
+            "lib/random_other_place/",
+        
+    )
+
+    will_remove, will_skip = compress_for_output_listing(sample)
+    will_rename = compress_for_rename(sample)
+    assert sorted(expected_skip) == sorted(compact(will_skip))
+    assert sorted(expected_remove) == sorted(compact(will_remove))
+    assert sorted(expected_rename) == sorted(compact(will_rename))
+
+
+class TestUninstallPathSet:
+    def test_add(self, tmpdir: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(
+            pip._internal.req.req_uninstall.UninstallPathSet,
+            "_permitted",
+            mock_permitted,
+        )
+        # Fix case for windows tests
+        file_extant = os.path.normcase(os.path.join(tmpdir, "foo"))
+        file_nonexistent = os.path.normcase(os.path.join(tmpdir, "nonexistent"))
+        with open(file_extant, "w"):
+            pass
+
+        ups = UninstallPathSet(dist=Mock())
+        assert ups._paths == set()
+        ups.add(file_extant)
+        assert ups._paths == {file_extant}
+
+        ups.add(file_nonexistent)
+        assert ups._paths == {file_extant}
+
+    def test_add_pth(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(
+            pip._internal.req.req_uninstall.UninstallPathSet,
+            "_permitted",
+            mock_permitted,
+        )
+        # Fix case for windows tests
+        tmpdir = os.path.normcase(tmp_path)
+        on_windows = sys.platform == "win32"
+        pth_file = os.path.join(tmpdir, "foo.pth")
+        relative = "../../example"
+        if on_windows:
+            share = "\\\\example\\share\\"
+            share_com = "\\\\example.com\\share\\"
+        # Create a .pth file for testing
+        with open(pth_file, "w") as f:
+            f.writelines(tmpdir, "\n", relative, "\n")
+            if on_windows:
+                f.writelines(share, "\n", share_com, "\n")
+        # Add paths to be removed
+        pth = UninstallPthEntries(pth_file)
+        pth.add(tmpdir)
+        pth.add(relative)
+        if on_windows:
+            pth.add(share)
+            pth.add(share_com)
+        # Check that the paths were added to entries
+        if on_windows:
+            check = {tmpdir, relative, share, share_com}
+        else:
+            check = {tmpdir, relative}
+        assert pth.entries == check
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_add_symlink(self, tmpdir: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(
+            pip._internal.req.req_uninstall.UninstallPathSet,
+            "_permitted",
+            mock_permitted,
+        )
+        f = os.path.join(tmpdir, "foo")
+        with open(f, "w"):
+            pass
+        foo_link = os.path.join(tmpdir, "foo_link")
+        os.symlink(f, foo_link)
+
+        ups = UninstallPathSet(dist=Mock())
+        ups.add(foo_link)
+        assert ups._paths == {foo_link}
+
+    def test_compact_shorter_path(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(
+            pip._internal.req.req_uninstall.UninstallPathSet,
+            "_permitted",
+            mock_permitted,
+        )
+        monkeypatch.setattr("os.path.exists", lambda p: True)
+        # This deals with nt/posix path differences
+        short_path = os.path.normcase(
+            os.path.abspath(os.path.join(os.path.sep, "path"))
+        )
+        ups = UninstallPathSet(dist=Mock())
+        ups.add(short_path)
+        ups.add(os.path.join(short_path, "longer"))
+        assert compact(ups._paths) == {short_path}
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_detect_symlink_dirs(
+        self, monkeypatch: pytest.MonkeyPatch, tmpdir: Path
+    ) -> None:
+        monkeypatch.setattr(
+            pip._internal.req.req_uninstall.UninstallPathSet,
+            "_permitted",
+            mock_permitted,
+        )
+
+        # construct 2 paths:
+        #  tmpdir/dir/file
+        #  tmpdir/dirlink/file (where dirlink is a link to dir)
+        d = tmpdir.joinpath("dir")
+        d.mkdir()
+        dlink = tmpdir.joinpath("dirlink")
+        os.symlink(d, dlink)
+        d.joinpath("file").touch()
+        path1 = str(d.joinpath("file"))
+        path2 = str(dlink.joinpath("file"))
+
+        ups = UninstallPathSet(dist=Mock())
+        ups.add(path1)
+        ups.add(path2)
+        assert ups._paths == {path1}
+
+
+class TestStashedUninstallPathSet:
+    WALK_RESULT: ListTuplestr, Liststr, Liststr = 
+        ("A", "B", "C", "a.py"),
+        ("A/B", "D", "b.py"),
+        ("A/B/D", , "c.py"),
+        ("A/C", , "d.py", "e.py"),
+        ("A/E", "F", "f.py"),
+        ("A/E/F", , ),
+        ("A/G", "H", "g.py"),
+        ("A/G/H", , "h.py"),
+    
+
+    @classmethod
+    def mock_walk(cls, root: str) -> IteratorTuplestr, Liststr, Liststr:
+        for dirname, subdirs, files in cls.WALK_RESULT:
+            dirname = os.path.sep.join(dirname.split("/"))
+            if dirname.startswith(root):
+                yield dirnamelen(root) + 1 :, subdirs, files
+
+    def test_compress_for_rename(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        paths = 
+            os.path.sep.join(p.split("/"))
+            for p in 
+                "A/B/b.py",
+                "A/B/D/c.py",
+                "A/C/d.py",
+                "A/E/f.py",
+                "A/G/g.py",
+            
+        
+
+        expected_paths = 
+            os.path.sep.join(p.split("/"))
+            for p in 
+                "A/B/",  # selected everything below A/B
+                "A/C/d.py",  # did not select everything below A/C
+                "A/E/",  # only empty folders remain under A/E
+                "A/G/g.py",  # non-empty folder remains under A/G
+            
+        
+
+        monkeypatch.setattr("os.walk", self.mock_walk)
+
+        actual_paths = compress_for_rename(paths)
+        assert set(expected_paths) == set(actual_paths)
+
+    @classmethod
+    def make_stash(
+        cls, tmpdir: Path, paths: Liststr
+    ) -> TupleStashedUninstallPathSet, ListTuplestr, str:
+        for dirname, subdirs, files in cls.WALK_RESULT:
+            root = os.path.join(tmpdir, *dirname.split("/"))
+            if not os.path.exists(root):
+                os.mkdir(root)
+            for d in subdirs:
+                os.mkdir(os.path.join(root, d))
+            for f in files:
+                with open(os.path.join(root, f), "wb"):
+                    pass
+
+        pathset = StashedUninstallPathSet()
+
+        paths = os.path.join(tmpdir, *p.split("/")) for p in paths
+        stashed_paths = (p, pathset.stash(p)) for p in paths
+
+        return pathset, stashed_paths
+
+    def test_stash(self, tmpdir: Path) -> None:
+        pathset, stashed_paths = self.make_stash(
+            tmpdir,
+            
+                "A/B/",
+                "A/C/d.py",
+                "A/E/",
+                "A/G/g.py",
+            ,
+        )
+
+        for old_path, new_path in stashed_paths:
+            assert not os.path.exists(old_path)
+            assert os.path.exists(new_path)
+
+        assert stashed_paths == pathset._moves
+
+    def test_commit(self, tmpdir: Path) -> None:
+        pathset, stashed_paths = self.make_stash(
+            tmpdir,
+            
+                "A/B/",
+                "A/C/d.py",
+                "A/E/",
+                "A/G/g.py",
+            ,
+        )
+
+        pathset.commit()
+
+        for old_path, new_path in stashed_paths:
+            assert not os.path.exists(old_path)
+            assert not os.path.exists(new_path)
+
+    def test_rollback(self, tmpdir: Path) -> None:
+        pathset, stashed_paths = self.make_stash(
+            tmpdir,
+            
+                "A/B/",
+                "A/C/d.py",
+                "A/E/",
+                "A/G/g.py",
+            ,
+        )
+
+        pathset.rollback()
+
+        for old_path, new_path in stashed_paths:
+            assert os.path.exists(old_path)
+            assert not os.path.exists(new_path)
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_commit_symlinks(self, tmpdir: Path) -> None:
+        adir = tmpdir / "dir"
+        adir.mkdir()
+        dirlink = tmpdir / "dirlink"
+        dirlink.symlink_to(adir)
+        afile = tmpdir / "file"
+        afile.write_text("...")
+        filelink = tmpdir / "filelink"
+        filelink.symlink_to(afile)
+
+        pathset = StashedUninstallPathSet()
+        stashed_paths = 
+        stashed_paths.append(pathset.stash(os.fspath(dirlink)))
+        stashed_paths.append(pathset.stash(os.fspath(filelink)))
+        for stashed_path in stashed_paths:
+            assert os.path.lexists(stashed_path)
+        assert not os.path.exists(dirlink)
+        assert not os.path.exists(filelink)
+
+        pathset.commit()
+
+        # stash removed, links removed
+        for stashed_path in stashed_paths:
+            assert not os.path.lexists(stashed_path)
+        assert not os.path.lexists(dirlink) and not os.path.isdir(dirlink)
+        assert not os.path.lexists(filelink) and not os.path.isfile(filelink)
+
+        # link targets untouched
+        assert os.path.isdir(adir)
+        assert os.path.isfile(afile)
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_rollback_symlinks(self, tmpdir: Path) -> None:
+        adir = tmpdir / "dir"
+        adir.mkdir()
+        dirlink = tmpdir / "dirlink"
+        dirlink.symlink_to(adir)
+        afile = tmpdir / "file"
+        afile.write_text("...")
+        filelink = tmpdir / "filelink"
+        filelink.symlink_to(afile)
+
+        pathset = StashedUninstallPathSet()
+        stashed_paths = 
+        stashed_paths.append(pathset.stash(os.fspath(dirlink)))
+        stashed_paths.append(pathset.stash(os.fspath(filelink)))
+        for stashed_path in stashed_paths:
+            assert os.path.lexists(stashed_path)
+        assert not os.path.lexists(dirlink)
+        assert not os.path.lexists(filelink)
+
+        pathset.rollback()
+
+        # stash removed, links restored
+        for stashed_path in stashed_paths:
+            assert not os.path.lexists(stashed_path)
+        assert os.path.lexists(dirlink) and os.path.isdir(dirlink)
+        assert os.path.lexists(filelink) and os.path.isfile(filelink)
+
+        # link targets untouched
+        assert os.path.isdir(adir)
+        assert os.path.isfile(afile)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_resolution_legacy_resolver.py Added

@@ -0,0 +1,372 @@
+import email.message
+import logging
+import os
+from typing import List, Optional, Type, TypeVar, cast
+from unittest import mock
+
+import pytest
+from pip._vendor.packaging.specifiers import SpecifierSet
+from pip._vendor.packaging.utils import NormalizedName
+
+from pip._internal.exceptions import (
+    InstallationError,
+    NoneMetadataError,
+    UnsupportedPythonVersion,
+)
+from pip._internal.metadata import BaseDistribution
+from pip._internal.models.candidate import InstallationCandidate
+from pip._internal.req.constructors import install_req_from_line
+from pip._internal.req.req_set import RequirementSet
+from pip._internal.resolution.legacy.resolver import (
+    Resolver,
+    _check_dist_requires_python,
+)
+from tests.lib import TestData, make_test_finder
+from tests.lib.index import make_mock_candidate
+
+T = TypeVar("T")
+
+
+class FakeDist(BaseDistribution):
+    def __init__(self, metadata: email.message.Message) -> None:
+        self._canonical_name = cast(NormalizedName, "my-project")
+        self._metadata = metadata
+
+    def __str__(self) -> str:
+        return f"<distribution {self.canonical_name!r}>"
+
+    @property
+    def canonical_name(self) -> NormalizedName:
+        return self._canonical_name
+
+    @property
+    def metadata(self) -> email.message.Message:
+        return self._metadata
+
+
+def make_fake_dist(
+    *, klass: TypeBaseDistribution = FakeDist, requires_python: Optionalstr = None
+) -> BaseDistribution:
+    metadata = email.message.Message()
+    metadata"Name" = "my-project"
+    if requires_python is not None:
+        metadata"Requires-Python" = requires_python
+
+    # Too many arguments for "BaseDistribution"
+    return klass(metadata)  # type: ignorecall-arg
+
+
+def make_test_resolver(
+    monkeypatch: pytest.MonkeyPatch,
+    mock_candidates: ListInstallationCandidate,
+) -> Resolver:
+    def _find_candidates(project_name: str) -> ListInstallationCandidate:
+        return mock_candidates
+
+    finder = make_test_finder()
+    monkeypatch.setattr(finder, "find_all_candidates", _find_candidates)
+
+    return Resolver(
+        finder=finder,
+        preparer=mock.Mock(),  # Not used.
+        make_install_req=install_req_from_line,
+        wheel_cache=None,
+        use_user_site=False,
+        force_reinstall=False,
+        ignore_dependencies=False,
+        ignore_installed=False,
+        ignore_requires_python=False,
+        upgrade_strategy="to-satisfy-only",
+    )
+
+
+class TestAddRequirement:
+    """
+    Test _add_requirement_to_set().
+    """
+
+    def test_unsupported_wheel_link_requirement_raises(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # GIVEN
+        resolver = make_test_resolver(monkeypatch, )
+        requirement_set = RequirementSet(check_supported_wheels=True)
+
+        install_req = install_req_from_line(
+            "https://whatever.com/peppercorn-0.4-py2.py3-bogus-any.whl",
+        )
+        assert install_req.link is not None
+        assert install_req.link.is_wheel
+        assert install_req.link.scheme == "https"
+
+        # WHEN / THEN
+        with pytest.raises(InstallationError):
+            resolver._add_requirement_to_set(requirement_set, install_req)
+
+    def test_unsupported_wheel_local_file_requirement_raises(
+        self, data: TestData, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        # GIVEN
+        resolver = make_test_resolver(monkeypatch, )
+        requirement_set = RequirementSet(check_supported_wheels=True)
+
+        install_req = install_req_from_line(
+            os.fspath(data.packages.joinpath("simple.dist-0.1-py1-none-invalid.whl")),
+        )
+        assert install_req.link is not None
+        assert install_req.link.is_wheel
+        assert install_req.link.scheme == "file"
+
+        # WHEN / THEN
+        with pytest.raises(InstallationError):
+            resolver._add_requirement_to_set(requirement_set, install_req)
+
+    def test_exclusive_environment_markers(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """Make sure excluding environment markers are handled correctly."""
+        # GIVEN
+        resolver = make_test_resolver(monkeypatch, )
+        requirement_set = RequirementSet(check_supported_wheels=True)
+
+        eq36 = install_req_from_line("Django>=1.6.10,<1.7 ; python_version == '3.6'")
+        eq36.user_supplied = True
+        ne36 = install_req_from_line("Django>=1.6.10,<1.8 ; python_version != '3.6'")
+        ne36.user_supplied = True
+
+        # WHEN
+        resolver._add_requirement_to_set(requirement_set, eq36)
+        resolver._add_requirement_to_set(requirement_set, ne36)
+
+        # THEN
+        assert requirement_set.has_requirement("Django")
+        assert len(requirement_set.all_requirements) == 1
+
+
+class TestCheckDistRequiresPython:
+    """
+    Test _check_dist_requires_python().
+    """
+
+    def test_compatible(self, caplog: pytest.LogCaptureFixture) -> None:
+        """
+        Test a Python version compatible with the dist's Requires-Python.
+        """
+        caplog.set_level(logging.DEBUG)
+        dist = make_fake_dist(requires_python="== 3.6.5")
+
+        _check_dist_requires_python(
+            dist,
+            version_info=(3, 6, 5),
+            ignore_requires_python=False,
+        )
+        assert not len(caplog.records)
+
+    def test_incompatible(self) -> None:
+        """
+        Test a Python version incompatible with the dist's Requires-Python.
+        """
+        dist = make_fake_dist(requires_python="== 3.6.4")
+        with pytest.raises(UnsupportedPythonVersion) as exc:
+            _check_dist_requires_python(
+                dist,
+                version_info=(3, 6, 5),
+                ignore_requires_python=False,
+            )
+        assert str(exc.value) == (
+            "Package 'my-project' requires a different Python: "
+            "3.6.5 not in '==3.6.4'"
+        )
+
+    def test_incompatible_with_ignore_requires(
+        self, caplog: pytest.LogCaptureFixture
+    ) -> None:
+        """
+        Test a Python version incompatible with the dist's Requires-Python
+        while passing ignore_requires_python=True.
+        """
+        caplog.set_level(logging.DEBUG)
+        dist = make_fake_dist(requires_python="== 3.6.4")
+        _check_dist_requires_python(
+            dist,
+            version_info=(3, 6, 5),
+            ignore_requires_python=True,
+        )
+        assert len(caplog.records) == 1
+        record = caplog.records0
+        assert record.levelname == "DEBUG"
+        assert record.message == (
+            "Ignoring failed Requires-Python check for package 'my-project': "
+            "3.6.5 not in '==3.6.4'"
+        )
+
+    def test_none_requires_python(self, caplog: pytest.LogCaptureFixture) -> None:
+        """
+        Test a dist with Requires-Python None.
+        """
+        caplog.set_level(logging.DEBUG)
+        dist = make_fake_dist()
+        # Make sure our test setup is correct.
+        assert dist.requires_python == SpecifierSet()
+        assert len(caplog.records) == 0
+
+        # Then there is no exception and no log message.
+        _check_dist_requires_python(
+            dist,
+            version_info=(3, 6, 5),
+            ignore_requires_python=False,
+        )
+        assert len(caplog.records) == 0
+
+    def test_invalid_requires_python(self, caplog: pytest.LogCaptureFixture) -> None:
+        """
+        Test a dist with an invalid Requires-Python.
+        """
+        caplog.set_level(logging.DEBUG)
+        dist = make_fake_dist(requires_python="invalid")
+        _check_dist_requires_python(
+            dist,
+            version_info=(3, 6, 5),
+            ignore_requires_python=False,
+        )
+        assert len(caplog.records) == 1
+        record = caplog.records0
+        assert record.levelname == "WARNING"
+        assert record.message == (
+            "Package 'my-project' has an invalid Requires-Python: "
+            "Invalid specifier: 'invalid'"
+        )
+
+    @pytest.mark.parametrize(
+        "metadata_name",
+        
+            "METADATA",
+            "PKG-INFO",
+        ,
+    )
+    def test_empty_metadata_error(self, metadata_name: str) -> None:
+        """Test dist.metadata raises FileNotFoundError."""
+
+        class NotWorkingFakeDist(FakeDist):
+            @property
+            def metadata(self) -> email.message.Message:
+                raise FileNotFoundError(metadata_name)
+
+        dist = make_fake_dist(klass=NotWorkingFakeDist)
+
+        with pytest.raises(NoneMetadataError) as exc:
+            _check_dist_requires_python(
+                dist,
+                version_info=(3, 6, 5),
+                ignore_requires_python=False,
+            )
+        assert str(exc.value) == (
+            "None {} metadata found for distribution: "
+            "<distribution 'my-project'>".format(metadata_name)
+        )
+
+
+class TestYankedWarning:
+    """
+    Test _populate_link() emits warning if one or more candidates are yanked.
+    """
+
+    def test_sort_best_candidate__has_non_yanked(
+        self, caplog: pytest.LogCaptureFixture, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test unyanked candidate preferred over yanked.
+        """
+        # Ignore spurious DEBUG level messages
+        # TODO: Probably better to work out why they are occurring, but IMO the
+        #       tests are at fault here for being to dependent on exact output.
+        caplog.set_level(logging.WARNING)
+        candidates = 
+            make_mock_candidate("1.0"),
+            make_mock_candidate("2.0", yanked_reason="bad metadata #2"),
+        
+        ireq = install_req_from_line("pkg")
+
+        resolver = make_test_resolver(monkeypatch, candidates)
+        resolver._populate_link(ireq)
+
+        assert ireq.link == candidates0.link
+        assert len(caplog.records) == 0
+
+    def test_sort_best_candidate__all_yanked(
+        self, caplog: pytest.LogCaptureFixture, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        """
+        Test all candidates yanked.
+        """
+        # Ignore spurious DEBUG level messages
+        # TODO: Probably better to work out why they are occurring, but IMO the
+        #       tests are at fault here for being to dependent on exact output.
+        caplog.set_level(logging.WARNING)
+        candidates = 
+            make_mock_candidate("1.0", yanked_reason="bad metadata #1"),
+            # Put the best candidate in the middle, to test sorting.
+            make_mock_candidate("3.0", yanked_reason="bad metadata #3"),
+            make_mock_candidate("2.0", yanked_reason="bad metadata #2"),
+        
+        ireq = install_req_from_line("pkg")
+
+        resolver = make_test_resolver(monkeypatch, candidates)
+        resolver._populate_link(ireq)
+
+        assert ireq.link == candidates1.link
+
+        # Check the log messages.
+        assert len(caplog.records) == 1
+        record = caplog.records0
+        assert record.levelname == "WARNING"
+        assert record.message == (
+            "The candidate selected for download or install is a yanked "
+            "version: 'mypackage' candidate "
+            "(version 3.0 at https://example.com/pkg-3.0.tar.gz)\n"
+            "Reason for being yanked: bad metadata #3"
+        )
+
+    @pytest.mark.parametrize(
+        "yanked_reason, expected_reason",
+        
+            # Test no reason given.
+            ("", "<none given>"),
+            # Test a unicode string with a non-ascii character.
+            ("curly quote: \u2018", "curly quote: \u2018"),
+        ,
+    )
+    def test_sort_best_candidate__yanked_reason(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        monkeypatch: pytest.MonkeyPatch,
+        yanked_reason: str,
+        expected_reason: str,
+    ) -> None:
+        """
+        Test the log message with various reason strings.
+        """
+        # Ignore spurious DEBUG level messages
+        # TODO: Probably better to work out why they are occurring, but IMO the
+        #       tests are at fault here for being to dependent on exact output.
+        caplog.set_level(logging.WARNING)
+        candidates = 
+            make_mock_candidate("1.0", yanked_reason=yanked_reason),
+        
+        ireq = install_req_from_line("pkg")
+
+        resolver = make_test_resolver(monkeypatch, candidates)
+        resolver._populate_link(ireq)
+
+        assert ireq.link == candidates0.link
+
+        assert len(caplog.records) == 1
+        record = caplog.records0
+        assert record.levelname == "WARNING"
+        expected_message = (
+            "The candidate selected for download or install is a yanked "
+            "version: 'mypackage' candidate "
+            "(version 1.0 at https://example.com/pkg-1.0.tar.gz)\n"
+            "Reason for being yanked: "
+        ) + expected_reason
+        assert record.message == expected_message

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_search_scope.py Added

@@ -0,0 +1,41 @@
+from pip._internal.models.search_scope import SearchScope
+from pip._internal.req.constructors import install_req_from_line
+
+
+class TestSearchScope:
+    def test_get_formatted_locations_basic_auth(self) -> None:
+        """
+        Test that basic authentication credentials defined in URL
+        is not included in formatted output.
+        """
+        index_urls = 
+            "https://pypi.org/simple",
+            "https://repo-user:repo-pass@repo.domain.com",
+        
+        find_links = "https://links-user:links-pass@page.domain.com"
+        search_scope = SearchScope(
+            find_links=find_links,
+            index_urls=index_urls,
+            no_index=False,
+        )
+
+        result = search_scope.get_formatted_locations()
+        assert "repo-user:****@repo.domain.com" in result
+        assert "repo-pass" not in result
+        assert "links-user:****@page.domain.com" in result
+        assert "links-pass" not in result
+
+    def test_get_index_urls_locations(self) -> None:
+        """Check that the canonical name is on all indexes"""
+        search_scope = SearchScope(
+            find_links=,
+            index_urls="file://index1/", "file://index2",
+            no_index=False,
+        )
+        req = install_req_from_line("Complex_Name")
+        assert req.name is not None
+        actual = search_scope.get_index_urls_locations(req.name)
+        assert actual == 
+            "file://index1/complex-name/",
+            "file://index2/complex-name/",
+

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_self_check_outdated.py Added

@@ -0,0 +1,180 @@
+import datetime
+import json
+import logging
+import os
+import sys
+from optparse import Values
+from pathlib import Path
+from typing import Optional
+from unittest.mock import ANY, Mock, patch
+
+import pytest
+from freezegun import freeze_time
+from pip._vendor.packaging.version import Version
+
+from pip._internal import self_outdated_check
+
+
+@pytest.mark.parametrize(
+    "key", "expected",
+    
+        (
+            "/hello/world/venv",
+            "fcd2d5175dd33d5df759ee7b045264230205ef837bf9f582f7c3ada7",
+        ),
+        (
+            "C:\\Users\\User\\Desktop\\venv",
+            "902cecc0745b8ecf2509ba473f3556f0ba222fedc6df433acda24aa5",
+        ),
+    ,
+)
+def test_get_statefile_name_known_values(key: str, expected: str) -> None:
+    assert expected == self_outdated_check._get_statefile_name(key)
+
+
+@freeze_time("1970-01-02T11:00:00Z")
+@patch("pip._internal.self_outdated_check._self_version_check_logic")
+@patch("pip._internal.self_outdated_check.SelfCheckState")
+def test_pip_self_version_check_calls_underlying_implementation(
+    mocked_state: Mock, mocked_function: Mock, tmpdir: Path
+) -> None:
+    # GIVEN
+    mock_session = Mock()
+    fake_options = Values(dict(cache_dir=str(tmpdir)))
+
+    # WHEN
+    self_outdated_check.pip_self_version_check(mock_session, fake_options)
+
+    # THEN
+    mocked_state.assert_called_once_with(cache_dir=str(tmpdir))
+    mocked_function.assert_called_once_with(
+        state=mocked_state(cache_dir=str(tmpdir)),
+        current_time=datetime.datetime(1970, 1, 2, 11, 0, 0),
+        local_version=ANY,
+        get_remote_version=ANY,
+    )
+
+
+@pytest.mark.parametrize(
+    
+        "installed_version",
+        "remote_version",
+        "stored_version",
+        "installed_by_pip",
+        "should_show_prompt",
+    ,
+    
+        # A newer version available!
+        ("1.0", "2.0", None, True, True),
+        # A newer version available, and cached value is new too!
+        ("1.0", "2.0", "2.0", True, True),
+        # A newer version available, but was not installed by pip.
+        ("1.0", "2.0", None, False, False),
+        # On the latest version already.
+        ("2.0", "2.0", None, True, False),
+        # On the latest version already, and cached value matches.
+        ("2.0", "2.0", "2.0", True, False),
+        # A newer version available, but cached value is older.
+        ("1.0", "2.0", "1.0", True, False),
+    ,
+)
+def test_core_logic(
+    installed_version: str,
+    remote_version: str,
+    stored_version: Optionalstr,
+    installed_by_pip: bool,
+    should_show_prompt: bool,
+    caplog: pytest.LogCaptureFixture,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    # GIVEN
+    monkeypatch.setattr(
+        self_outdated_check, "was_installed_by_pip", lambda _: installed_by_pip
+    )
+    mock_state = Mock()
+    mock_state.get.return_value = stored_version
+    fake_time = datetime.datetime(2000, 1, 1, 0, 0, 0)
+    version_that_should_be_checked = stored_version or remote_version
+
+    # WHEN
+    with caplog.at_level(logging.DEBUG):
+        return_value = self_outdated_check._self_version_check_logic(
+            state=mock_state,
+            current_time=fake_time,
+            local_version=Version(installed_version),
+            get_remote_version=lambda: remote_version,
+        )
+
+    # THEN
+    mock_state.get.assert_called_once_with(fake_time)
+    assert caplog.messages == 
+        f"Remote version of pip: {version_that_should_be_checked}",
+        f"Local version of pip:  {installed_version}",
+        f"Was pip installed by pip? {installed_by_pip}",
+    
+
+    if stored_version:
+        mock_state.set.assert_not_called()
+    else:
+        mock_state.set.assert_called_once_with(
+            version_that_should_be_checked, fake_time
+        )
+
+    if not should_show_prompt:
+        assert return_value is None
+        return  # the remaining assertions are for the other case.
+
+    assert return_value is not None
+    assert return_value.old == installed_version
+    assert return_value.new == remote_version
+
+
+class TestSelfCheckState:
+    def test_no_cache(self) -> None:
+        # GIVEN / WHEN
+        state = self_outdated_check.SelfCheckState(cache_dir="")
+        assert state._statefile_path is None
+
+    def test_reads_expected_statefile(self, tmpdir: Path) -> None:
+        # GIVEN
+        cache_dir = tmpdir / "cache_dir"
+        expected_path = (
+            cache_dir
+            / "selfcheck"
+            / self_outdated_check._get_statefile_name(sys.prefix)
+        )
+
+        cache_dir.mkdir()
+        (cache_dir / "selfcheck").mkdir()
+        expected_path.write_text('{"foo": "bar"}')
+
+        # WHEN
+        state = self_outdated_check.SelfCheckState(cache_dir=str(cache_dir))
+
+        # THEN
+        assert state._statefile_path == os.fspath(expected_path)
+        assert state._state == {"foo": "bar"}
+
+    def test_writes_expected_statefile(self, tmpdir: Path) -> None:
+        # GIVEN
+        cache_dir = tmpdir / "cache_dir"
+        cache_dir.mkdir()
+        expected_path = (
+            cache_dir
+            / "selfcheck"
+            / self_outdated_check._get_statefile_name(sys.prefix)
+        )
+
+        # WHEN
+        state = self_outdated_check.SelfCheckState(cache_dir=str(cache_dir))
+        state.set("1.0.0", datetime.datetime(2000, 1, 1, 0, 0, 0))
+
+        # THEN
+        assert state._statefile_path == os.fspath(expected_path)
+
+        contents = expected_path.read_text()
+        assert json.loads(contents) == {
+            "key": sys.prefix,
+            "last_check": "2000-01-01T00:00:00Z",
+            "pypi_version": "1.0.0",
+        }

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_target_python.py Added

@@ -0,0 +1,124 @@
+from typing import Any, Dict, Optional, Tuple
+from unittest import mock
+
+import pytest
+from pip._vendor.packaging.tags import Tag
+
+from pip._internal.models.target_python import TargetPython
+from tests.lib import CURRENT_PY_VERSION_INFO, pyversion
+
+
+class TestTargetPython:
+    @pytest.mark.parametrize(
+        "py_version_info, expected",
+        
+            ((), ((0, 0, 0), "0.0")),
+            ((2,), ((2, 0, 0), "2.0")),
+            ((3,), ((3, 0, 0), "3.0")),
+            ((3, 7), ((3, 7, 0), "3.7")),
+            ((3, 7, 3), ((3, 7, 3), "3.7")),
+            # Check a minor version with two digits.
+            ((3, 10, 1), ((3, 10, 1), "3.10")),
+        ,
+    )
+    def test_init__py_version_info(
+        self,
+        py_version_info: Tupleint, ...,
+        expected: TupleTupleint, int, int, str,
+    ) -> None:
+        """
+        Test passing the py_version_info argument.
+        """
+        expected_py_version_info, expected_py_version = expected
+
+        target_python = TargetPython(py_version_info=py_version_info)
+
+        # The _given_py_version_info attribute should be set as is.
+        assert target_python._given_py_version_info == py_version_info
+
+        assert target_python.py_version_info == expected_py_version_info
+        assert target_python.py_version == expected_py_version
+
+    def test_init__py_version_info_none(self) -> None:
+        """
+        Test passing py_version_info=None.
+        """
+        target_python = TargetPython(py_version_info=None)
+
+        assert target_python._given_py_version_info is None
+
+        assert target_python.py_version_info == CURRENT_PY_VERSION_INFO
+        assert target_python.py_version == pyversion
+
+    @pytest.mark.parametrize(
+        "kwargs, expected",
+        
+            ({}, ""),
+            (dict(py_version_info=(3, 6)), "version_info='3.6'"),
+            (
+                dict(platforms="darwin", py_version_info=(3, 6)),
+                "platforms='darwin' version_info='3.6'",
+            ),
+            (
+                dict(
+                    platforms="darwin",
+                    py_version_info=(3, 6),
+                    abis="cp36m",
+                    implementation="cp",
+                ),
+                (
+                    "platforms='darwin' version_info='3.6' abis='cp36m' "
+                    "implementation='cp'"
+                ),
+            ),
+        ,
+    )
+    def test_format_given(self, kwargs: Dictstr, Any, expected: str) -> None:
+        target_python = TargetPython(**kwargs)
+        actual = target_python.format_given()
+        assert actual == expected
+
+    @pytest.mark.parametrize(
+        "py_version_info, expected_version",
+        
+            ((), ""),
+            ((2,), "2"),
+            ((3,), "3"),
+            ((3, 7), "37"),
+            ((3, 7, 3), "37"),
+            # Check a minor version with two digits.
+            ((3, 10, 1), "310"),
+            # Check that versions=None is passed to get_tags().
+            (None, None),
+        ,
+    )
+    @mock.patch("pip._internal.models.target_python.get_supported")
+    def test_get_tags(
+        self,
+        mock_get_supported: mock.Mock,
+        py_version_info: OptionalTupleint, ...,
+        expected_version: Optionalstr,
+    ) -> None:
+        mock_get_supported.return_value = "tag-1", "tag-2"
+
+        target_python = TargetPython(py_version_info=py_version_info)
+        actual = target_python.get_tags()
+        assert actual == "tag-1", "tag-2"
+
+        actual = mock_get_supported.call_args1"version"
+        assert actual == expected_version
+
+        # Check that the value was cached.
+        assert target_python._valid_tags == "tag-1", "tag-2"
+
+    def test_get_tags__uses_cached_value(self) -> None:
+        """
+        Test that get_tags() uses the cached value.
+        """
+        target_python = TargetPython(py_version_info=None)
+        target_python._valid_tags = 
+            Tag("py2", "none", "any"),
+            Tag("py3", "none", "any"),
+        
+        actual = target_python.get_tags()
+        assert actual == Tag("py2", "none", "any"), Tag("py3", "none", "any")

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_urls.py Added

@@ -0,0 +1,72 @@
+import os
+import sys
+import urllib.request
+from typing import Optional
+
+import pytest
+
+from pip._internal.utils.urls import get_url_scheme, path_to_url, url_to_path
+
+
+@pytest.mark.parametrize(
+    "url,expected",
+    
+        ("http://localhost:8080/", "http"),
+        ("file:c:/path/to/file", "file"),
+        ("file:/dev/null", "file"),
+        ("", None),
+    ,
+)
+def test_get_url_scheme(url: str, expected: Optionalstr) -> None:
+    assert get_url_scheme(url) == expected
+
+
+@pytest.mark.skipif("sys.platform == 'win32'")
+def test_path_to_url_unix() -> None:
+    assert path_to_url("/tmp/file") == "file:///tmp/file"
+    path = os.path.join(os.getcwd(), "file")
+    assert path_to_url("file") == "file://" + urllib.request.pathname2url(path)
+
+
+@pytest.mark.skipif("sys.platform != 'win32'")
+def test_path_to_url_win() -> None:
+    assert path_to_url("c:/tmp/file") == "file:///C:/tmp/file"
+    assert path_to_url("c:\\tmp\\file") == "file:///C:/tmp/file"
+    assert path_to_url(r"\\unc\as\path") == "file://unc/as/path"
+    path = os.path.join(os.getcwd(), "file")
+    assert path_to_url("file") == "file:" + urllib.request.pathname2url(path)
+
+
+@pytest.mark.parametrize(
+    "url,win_expected,non_win_expected",
+    
+        ("file:tmp", "tmp", "tmp"),
+        ("file:c:/path/to/file", r"C:\path\to\file", "c:/path/to/file"),
+        ("file:/path/to/file", r"\path\to\file", "/path/to/file"),
+        ("file://localhost/tmp/file", r"\tmp\file", "/tmp/file"),
+        ("file://localhost/c:/tmp/file", r"C:\tmp\file", "/c:/tmp/file"),
+        ("file://somehost/tmp/file", r"\\somehost\tmp\file", None),
+        ("file:///tmp/file", r"\tmp\file", "/tmp/file"),
+        ("file:///c:/tmp/file", r"C:\tmp\file", "/c:/tmp/file"),
+    ,
+)
+def test_url_to_path(url: str, win_expected: str, non_win_expected: str) -> None:
+    if sys.platform == "win32":
+        expected_path = win_expected
+    else:
+        expected_path = non_win_expected
+
+    if expected_path is None:
+        with pytest.raises(ValueError):
+            url_to_path(url)
+    else:
+        assert url_to_path(url) == expected_path
+
+
+@pytest.mark.skipif("sys.platform != 'win32'")
+def test_url_to_path_path_to_url_symmetry_win() -> None:
+    path = r"C:\tmp\file"
+    assert url_to_path(path_to_url(path)) == path
+
+    unc_path = r"\\unc\share\path"
+    assert url_to_path(path_to_url(unc_path)) == unc_path

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils.py Added

@@ -0,0 +1,1054 @@
+"""
+util tests
+
+"""
+import codecs
+import os
+import shutil
+import stat
+import sys
+import time
+from io import BytesIO
+from pathlib import Path
+from typing import Any, Callable, Iterator, List, NoReturn, Optional, Tuple, Type
+from unittest.mock import Mock, patch
+
+import pytest
+
+from pip._internal.exceptions import HashMismatch, HashMissing, InstallationError
+from pip._internal.utils.deprecation import PipDeprecationWarning, deprecated
+from pip._internal.utils.egg_link import egg_link_path_from_location
+from pip._internal.utils.encoding import BOMS, auto_decode
+from pip._internal.utils.glibc import (
+    glibc_version_string,
+    glibc_version_string_confstr,
+    glibc_version_string_ctypes,
+)
+from pip._internal.utils.hashes import Hashes, MissingHashes
+from pip._internal.utils.misc import (
+    HiddenText,
+    build_netloc,
+    build_url_from_netloc,
+    format_size,
+    get_prog,
+    hide_url,
+    hide_value,
+    is_console_interactive,
+    normalize_path,
+    normalize_version_info,
+    parse_netloc,
+    redact_auth_from_url,
+    redact_netloc,
+    remove_auth_from_url,
+    rmtree,
+    rmtree_errorhandler,
+    split_auth_from_netloc,
+    split_auth_netloc_from_url,
+    tabulate,
+)
+from pip._internal.utils.setuptools_build import make_setuptools_shim_args
+
+
+class Tests_EgglinkPath:
+    "util.egg_link_path_from_location() tests"
+
+    def setup_method(self) -> None:
+        project = "foo"
+
+        self.mock_dist = Mock(project_name=project)
+        self.site_packages = "SITE_PACKAGES"
+        self.user_site = "USER_SITE"
+        self.user_site_egglink = os.path.join(self.user_site, f"{project}.egg-link")
+        self.site_packages_egglink = os.path.join(
+            self.site_packages,
+            f"{project}.egg-link",
+        )
+
+        # patches
+        from pip._internal.utils import egg_link as utils
+
+        self.old_site_packages = utils.site_packages
+        self.mock_site_packages = utils.site_packages = "SITE_PACKAGES"
+        self.old_running_under_virtualenv = utils.running_under_virtualenv
+        self.mock_running_under_virtualenv = utils.running_under_virtualenv = Mock()
+        self.old_virtualenv_no_global = utils.virtualenv_no_global
+        self.mock_virtualenv_no_global = utils.virtualenv_no_global = Mock()
+        self.old_user_site = utils.user_site
+        self.mock_user_site = utils.user_site = self.user_site
+        from os import path
+
+        self.old_isfile = path.isfile
+        self.mock_isfile = path.isfile = Mock()
+
+    def teardown_method(self) -> None:
+        from pip._internal.utils import egg_link as utils
+
+        utils.site_packages = self.old_site_packages
+        utils.running_under_virtualenv = self.old_running_under_virtualenv
+        utils.virtualenv_no_global = self.old_virtualenv_no_global
+        utils.user_site = self.old_user_site
+        from os import path
+
+        path.isfile = self.old_isfile
+
+    def eggLinkInUserSite(self, egglink: str) -> bool:
+        return egglink == self.user_site_egglink
+
+    def eggLinkInSitePackages(self, egglink: str) -> bool:
+        return egglink == self.site_packages_egglink
+
+    # ####################### #
+    # # egglink in usersite # #
+    # ####################### #
+    def test_egglink_in_usersite_notvenv(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = False
+        self.mock_isfile.side_effect = self.eggLinkInUserSite
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.user_site_egglink
+        )
+
+    def test_egglink_in_usersite_venv_noglobal(self) -> None:
+        self.mock_virtualenv_no_global.return_value = True
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.side_effect = self.eggLinkInUserSite
+        assert egg_link_path_from_location(self.mock_dist.project_name) is None
+
+    def test_egglink_in_usersite_venv_global(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.side_effect = self.eggLinkInUserSite
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.user_site_egglink
+        )
+
+    # ####################### #
+    # # egglink in sitepkgs # #
+    # ####################### #
+    def test_egglink_in_sitepkgs_notvenv(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = False
+        self.mock_isfile.side_effect = self.eggLinkInSitePackages
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.site_packages_egglink
+        )
+
+    def test_egglink_in_sitepkgs_venv_noglobal(self) -> None:
+        self.mock_virtualenv_no_global.return_value = True
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.side_effect = self.eggLinkInSitePackages
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.site_packages_egglink
+        )
+
+    def test_egglink_in_sitepkgs_venv_global(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.side_effect = self.eggLinkInSitePackages
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.site_packages_egglink
+        )
+
+    # ################################## #
+    # # egglink in usersite & sitepkgs # #
+    # ################################## #
+    def test_egglink_in_both_notvenv(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = False
+        self.mock_isfile.return_value = True
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.user_site_egglink
+        )
+
+    def test_egglink_in_both_venv_noglobal(self) -> None:
+        self.mock_virtualenv_no_global.return_value = True
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.return_value = True
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.site_packages_egglink
+        )
+
+    def test_egglink_in_both_venv_global(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.return_value = True
+        assert (
+            egg_link_path_from_location(self.mock_dist.project_name)
+            == self.site_packages_egglink
+        )
+
+    # ############## #
+    # # no egglink # #
+    # ############## #
+    def test_noegglink_in_sitepkgs_notvenv(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = False
+        self.mock_isfile.return_value = False
+        assert egg_link_path_from_location(self.mock_dist.project_name) is None
+
+    def test_noegglink_in_sitepkgs_venv_noglobal(self) -> None:
+        self.mock_virtualenv_no_global.return_value = True
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.return_value = False
+        assert egg_link_path_from_location(self.mock_dist.project_name) is None
+
+    def test_noegglink_in_sitepkgs_venv_global(self) -> None:
+        self.mock_virtualenv_no_global.return_value = False
+        self.mock_running_under_virtualenv.return_value = True
+        self.mock_isfile.return_value = False
+        assert egg_link_path_from_location(self.mock_dist.project_name) is None
+
+
+def test_rmtree_errorhandler_nonexistent_directory(tmpdir: Path) -> None:
+    """
+    Test rmtree_errorhandler ignores the given non-existing directory.
+    """
+    nonexistent_path = str(tmpdir / "foo")
+    mock_func = Mock()
+    # Argument 3 to "rmtree_errorhandler" has incompatible type "None"; expected
+    # "TupleTypeBaseException, BaseException, TracebackType"
+    rmtree_errorhandler(mock_func, nonexistent_path, None)  # type: ignorearg-type
+    mock_func.assert_not_called()
+
+
+def test_rmtree_errorhandler_readonly_directory(tmpdir: Path) -> None:
+    """
+    Test rmtree_errorhandler makes the given read-only directory writable.
+    """
+    # Create read only directory
+    subdir_path = tmpdir / "subdir"
+    subdir_path.mkdir()
+    path = str(subdir_path)
+    os.chmod(path, stat.S_IREAD)
+
+    # Make sure mock_func is called with the given path
+    mock_func = Mock()
+    # Argument 3 to "rmtree_errorhandler" has incompatible type "None"; expected
+    # "TupleTypeBaseException, BaseException, TracebackType"
+    rmtree_errorhandler(mock_func, path, None)  # type: ignorearg-type
+    mock_func.assert_called_with(path)
+
+    # Make sure the path is now writable
+    assert os.stat(path).st_mode & stat.S_IWRITE
+
+
+def test_rmtree_errorhandler_reraises_error(tmpdir: Path) -> None:
+    """
+    Test rmtree_errorhandler reraises an exception
+    by the given unreadable directory.
+    """
+    # Create directory without read permission
+    subdir_path = tmpdir / "subdir"
+    subdir_path.mkdir()
+    path = str(subdir_path)
+    os.chmod(path, stat.S_IWRITE)
+
+    mock_func = Mock()
+
+    try:
+        raise RuntimeError("test message")
+    except RuntimeError:
+        # Make sure the handler reraises an exception
+        with pytest.raises(RuntimeError, match="test message"):
+            # Argument 3 to "rmtree_errorhandler" has incompatible type "None"; expected
+            # "TupleTypeBaseException, BaseException, TracebackType"
+            rmtree_errorhandler(mock_func, path, None)  # type: ignorearg-type
+
+    mock_func.assert_not_called()
+
+
+def test_rmtree_skips_nonexistent_directory() -> None:
+    """
+    Test wrapped rmtree doesn't raise an error
+    by the given nonexistent directory.
+    """
+    rmtree.__wrapped__("nonexistent-subdir")  # type: ignoreattr-defined
+
+
+class Failer:
+    def __init__(self, duration: int = 1) -> None:
+        self.succeed_after = time.time() + duration
+
+    def call(self, *args: Any, **kw: Any) -> None:
+        """Fail with OSError self.max_fails times"""
+        if time.time() < self.succeed_after:
+            raise OSError("Failed")
+
+
+def test_rmtree_retries(monkeypatch: pytest.MonkeyPatch) -> None:
+    """
+    Test pip._internal.utils.rmtree will retry failures
+    """
+    monkeypatch.setattr(shutil, "rmtree", Failer(duration=1).call)
+    rmtree("foo")
+
+
+def test_rmtree_retries_for_3sec(monkeypatch: pytest.MonkeyPatch) -> None:
+    """
+    Test pip._internal.utils.rmtree will retry failures for no more than 3 sec
+    """
+    monkeypatch.setattr(shutil, "rmtree", Failer(duration=5).call)
+    with pytest.raises(OSError):
+        rmtree("foo")
+
+
+if sys.byteorder == "little":
+    expected_byte_string = (
+        "b'\\xff\\xfe/\\x00p\\x00a\\x00t\\x00h\\x00/\\x00d\\x00\\xe9\\x00f\\x00'"
+    )
+elif sys.byteorder == "big":
+    expected_byte_string = (
+        "b'\\xfe\\xff\\x00/\\x00p\\x00a\\x00t\\x00h\\x00/\\x00d\\x00\\xe9\\x00f'"
+    )
+
+
+class Test_normalize_path:
+    # Technically, symlinks are possible on Windows, but you need a special
+    # permission bit to create them, and Python 2 doesn't support it anyway, so
+    # it's easiest just to skip this test on Windows altogether.
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_resolve_symlinks(self, tmpdir: Path) -> None:
+        print(type(tmpdir))
+        print(dir(tmpdir))
+        orig_working_dir = os.getcwd()
+        os.chdir(tmpdir)
+        try:
+            d = os.path.join("foo", "bar")
+            f = os.path.join(d, "file1")
+            os.makedirs(d)
+            with open(f, "w"):  # Create the file
+                pass
+
+            os.symlink(d, "dir_link")
+            os.symlink(f, "file_link")
+
+            assert normalize_path(
+                "dir_link/file1", resolve_symlinks=True
+            ) == os.path.join(tmpdir, f)
+            assert normalize_path(
+                "dir_link/file1", resolve_symlinks=False
+            ) == os.path.join(tmpdir, "dir_link", "file1")
+
+            assert normalize_path("file_link", resolve_symlinks=True) == os.path.join(
+                tmpdir, f
+            )
+            assert normalize_path("file_link", resolve_symlinks=False) == os.path.join(
+                tmpdir, "file_link"
+            )
+        finally:
+            os.chdir(orig_working_dir)
+
+
+class TestHashes:
+    """Tests for pip._internal.utils.hashes"""
+
+    @pytest.mark.parametrize(
+        "hash_name, hex_digest, expected",
+        
+            # Test a value that matches but with the wrong hash_name.
+            ("sha384", 128 * "a", False),
+            # Test matching values, including values other than the first.
+            ("sha512", 128 * "a", True),
+            ("sha512", 128 * "b", True),
+            # Test a matching hash_name with a value that doesn't match.
+            ("sha512", 128 * "c", False),
+        ,
+    )
+    def test_is_hash_allowed(
+        self, hash_name: str, hex_digest: str, expected: bool
+    ) -> None:
+        hashes_data = {
+            "sha512": 128 * "a", 128 * "b",
+        }
+        hashes = Hashes(hashes_data)
+        assert hashes.is_hash_allowed(hash_name, hex_digest) == expected
+
+    def test_success(self, tmpdir: Path) -> None:
+        """Make sure no error is raised when at least one hash matches.
+
+        Test check_against_path because it calls everything else.
+
+        """
+        file = tmpdir / "to_hash"
+        file.write_text("hello")
+        hashes = Hashes(
+            {
+                "sha256": 
+                    "2cf24dba5fb0a30e26e83b2ac5b9e29e"
+                    "1b161e5c1fa7425e73043362938b9824"
+                ,
+                "sha224": "wrongwrong",
+                "md5": "5d41402abc4b2a76b9719d911017c592",
+            }
+        )
+        hashes.check_against_path(os.fspath(file))
+
+    def test_failure(self) -> None:
+        """Hashes should raise HashMismatch when no hashes match."""
+        hashes = Hashes({"sha256": "wrongwrong"})
+        with pytest.raises(HashMismatch):
+            hashes.check_against_file(BytesIO(b"hello"))
+
+    def test_missing_hashes(self) -> None:
+        """MissingHashes should raise HashMissing when any check is done."""
+        with pytest.raises(HashMissing):
+            MissingHashes().check_against_file(BytesIO(b"hello"))
+
+    def test_unknown_hash(self) -> None:
+        """Hashes should raise InstallationError when it encounters an unknown
+        hash."""
+        hashes = Hashes({"badbad": "dummy"})
+        with pytest.raises(InstallationError):
+            hashes.check_against_file(BytesIO(b"hello"))
+
+    def test_non_zero(self) -> None:
+        """Test that truthiness tests tell whether any known-good hashes
+        exist."""
+        assert Hashes({"sha256": "dummy"})
+        assert not Hashes()
+        assert not Hashes({})
+
+    def test_equality(self) -> None:
+        assert Hashes() == Hashes()
+        assert Hashes({"sha256": "abcd"}) == Hashes({"sha256": "abcd"})
+        assert Hashes({"sha256": "ab", "cd"}) == Hashes({"sha256": "cd", "ab"})
+
+    def test_hash(self) -> None:
+        cache = {}
+        cacheHashes({"sha256": "ab", "cd"}) = 42
+        assert cacheHashes({"sha256": "ab", "cd"}) == 42
+
+    def test_has_one_of(self) -> None:
+        hashes = Hashes({"sha256": "abcd", "efgh", "sha384": "ijkl"})
+        assert hashes.has_one_of({"sha256": "abcd"})
+        assert hashes.has_one_of({"sha256": "efgh"})
+        assert not hashes.has_one_of({"sha256": "xyzt"})
+        empty_hashes = Hashes()
+        assert not empty_hashes.has_one_of({"sha256": "xyzt"})
+
+
+class TestEncoding:
+    """Tests for pip._internal.utils.encoding"""
+
+    def test_auto_decode_utf_16_le(self) -> None:
+        data = (
+            b"\xff\xfeD\x00j\x00a\x00n\x00g\x00o\x00=\x00"
+            b"=\x001\x00.\x004\x00.\x002\x00"
+        )
+        assert data.startswith(codecs.BOM_UTF16_LE)
+        assert auto_decode(data) == "Django==1.4.2"
+
+    def test_auto_decode_utf_16_be(self) -> None:
+        data = (
+            b"\xfe\xff\x00D\x00j\x00a\x00n\x00g\x00o\x00="
+            b"\x00=\x001\x00.\x004\x00.\x002"
+        )
+        assert data.startswith(codecs.BOM_UTF16_BE)
+        assert auto_decode(data) == "Django==1.4.2"
+
+    def test_auto_decode_no_bom(self) -> None:
+        assert auto_decode(b"foobar") == "foobar"
+
+    def test_auto_decode_pep263_headers(self) -> None:
+        latin1_req = "# coding=latin1\n# Pas trop de café"
+        assert auto_decode(latin1_req.encode("latin1")) == latin1_req
+
+    def test_auto_decode_no_preferred_encoding(self) -> None:
+        om, em = Mock(), Mock()
+        om.return_value = "ascii"
+        em.return_value = None
+        data = "data"
+        with patch("sys.getdefaultencoding", om):
+            with patch("locale.getpreferredencoding", em):
+                ret = auto_decode(data.encode(sys.getdefaultencoding()))
+        assert ret == data
+
+    @pytest.mark.parametrize("encoding", encoding for bom, encoding in BOMS)
+    def test_all_encodings_are_valid(self, encoding: str) -> None:
+        # we really only care that there is no LookupError
+        assert "".encode(encoding).decode(encoding) == ""
+
+
+def raises(error: TypeException) -> NoReturn:
+    raise error
+
+
+class TestGlibc:
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_glibc_version_string(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(
+            os,
+            "confstr",
+            lambda x: "glibc 2.20",
+            raising=False,
+        )
+        assert glibc_version_string() == "2.20"
+
+    @pytest.mark.skipif("sys.platform == 'win32'")
+    def test_glibc_version_string_confstr(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setattr(
+            os,
+            "confstr",
+            lambda x: "glibc 2.20",
+            raising=False,
+        )
+        assert glibc_version_string_confstr() == "2.20"
+
+    @pytest.mark.parametrize(
+        "failure",
+        
+            lambda x: raises(ValueError),
+            lambda x: raises(OSError),
+            lambda x: "XXX",
+        ,
+    )
+    def test_glibc_version_string_confstr_fail(
+        self, monkeypatch: pytest.MonkeyPatch, failure: CallableAny, Any
+    ) -> None:
+        monkeypatch.setattr(os, "confstr", failure, raising=False)
+        assert glibc_version_string_confstr() is None
+
+    def test_glibc_version_string_confstr_missing(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.delattr(os, "confstr", raising=False)
+        assert glibc_version_string_confstr() is None
+
+    def test_glibc_version_string_ctypes_missing(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        monkeypatch.setitem(sys.modules, "ctypes", None)
+        assert glibc_version_string_ctypes() is None
+
+
+@pytest.mark.parametrize(
+    "version_info, expected",
+    
+        ((), (0, 0, 0)),
+        ((3,), (3, 0, 0)),
+        ((3, 6), (3, 6, 0)),
+        ((3, 6, 2), (3, 6, 2)),
+        ((3, 6, 2, 4), (3, 6, 2)),
+    ,
+)
+def test_normalize_version_info(
+    version_info: Tupleint, ..., expected: Tupleint, int, int
+) -> None:
+    actual = normalize_version_info(version_info)
+    assert actual == expected
+
+
+class TestGetProg:
+    @pytest.mark.parametrize(
+        ("argv", "executable", "expected"),
+        
+            ("/usr/bin/pip", "", "pip"),
+            ("-c", "/usr/bin/python", "/usr/bin/python -m pip"),
+            ("__main__.py", "/usr/bin/python", "/usr/bin/python -m pip"),
+            ("/usr/bin/pip3", "", "pip3"),
+        ,
+    )
+    def test_get_prog(
+        self, monkeypatch: pytest.MonkeyPatch, argv: str, executable: str, expected: str
+    ) -> None:
+        monkeypatch.setattr("pip._internal.utils.misc.sys.argv", argv)
+        monkeypatch.setattr("pip._internal.utils.misc.sys.executable", executable)
+        assert get_prog() == expected
+
+
+@pytest.mark.parametrize(
+    "host_port, expected_netloc",
+    
+        # Test domain name.
+        (("example.com", None), "example.com"),
+        (("example.com", 5000), "example.com:5000"),
+        # Test IPv4 address.
+        (("127.0.0.1", None), "127.0.0.1"),
+        (("127.0.0.1", 5000), "127.0.0.1:5000"),
+        # Test bare IPv6 address.
+        (("2001:db6::1", None), "2001:db6::1"),
+        # Test IPv6 with port.
+        (("2001:db6::1", 5000), "2001:db6::1:5000"),
+    ,
+)
+def test_build_netloc(
+    host_port: Tuplestr, Optionalint, expected_netloc: str
+) -> None:
+    assert build_netloc(*host_port) == expected_netloc
+
+
+@pytest.mark.parametrize(
+    "netloc, expected_url, expected_host_port",
+    
+        # Test domain name.
+        ("example.com", "https://example.com", ("example.com", None)),
+        ("example.com:5000", "https://example.com:5000", ("example.com", 5000)),
+        # Test IPv4 address.
+        ("127.0.0.1", "https://127.0.0.1", ("127.0.0.1", None)),
+        ("127.0.0.1:5000", "https://127.0.0.1:5000", ("127.0.0.1", 5000)),
+        # Test bare IPv6 address.
+        ("2001:db6::1", "https://2001:db6::1", ("2001:db6::1", None)),
+        # Test IPv6 with port.
+        ("2001:db6::1:5000", "https://2001:db6::1:5000", ("2001:db6::1", 5000)),
+        # Test netloc with auth.
+        (
+            "user:password@localhost:5000",
+            "https://user:password@localhost:5000",
+            ("localhost", 5000),
+        ),
+    ,
+)
+def test_build_url_from_netloc_and_parse_netloc(
+    netloc: str,
+    expected_url: str,
+    expected_host_port: Tuplestr, Optionalint,
+) -> None:
+    assert build_url_from_netloc(netloc) == expected_url
+    assert parse_netloc(netloc) == expected_host_port
+
+
+@pytest.mark.parametrize(
+    "netloc, expected",
+    
+        # Test a basic case.
+        ("example.com", ("example.com", (None, None))),
+        # Test with username and no password.
+        ("user@example.com", ("example.com", ("user", None))),
+        # Test with username and password.
+        ("user:pass@example.com", ("example.com", ("user", "pass"))),
+        # Test with username and empty password.
+        ("user:@example.com", ("example.com", ("user", ""))),
+        # Test the password containing an @ symbol.
+        ("user:pass@word@example.com", ("example.com", ("user", "pass@word"))),
+        # Test the password containing a : symbol.
+        ("user:pass:word@example.com", ("example.com", ("user", "pass:word"))),
+        # Test URL-encoded reserved characters.
+        ("user%3Aname:%23%40%5E@example.com", ("example.com", ("user:name", "#@^"))),
+    ,
+)
+def test_split_auth_from_netloc(
+    netloc: str, expected: Tuplestr, TupleOptionalstr, Optionalstr
+) -> None:
+    actual = split_auth_from_netloc(netloc)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "url, expected",
+    
+        # Test a basic case.
+        (
+            "http://example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", (None, None)),
+        ),
+        # Test with username and no password.
+        (
+            "http://user@example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", ("user", None)),
+        ),
+        # Test with username and password.
+        (
+            "http://user:pass@example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", ("user", "pass")),
+        ),
+        # Test with username and empty password.
+        (
+            "http://user:@example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", ("user", "")),
+        ),
+        # Test the password containing an @ symbol.
+        (
+            "http://user:pass@word@example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", ("user", "pass@word")),
+        ),
+        # Test the password containing a : symbol.
+        (
+            "http://user:pass:word@example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", ("user", "pass:word")),
+        ),
+        # Test URL-encoded reserved characters.
+        (
+            "http://user%3Aname:%23%40%5E@example.com/path#anchor",
+            ("http://example.com/path#anchor", "example.com", ("user:name", "#@^")),
+        ),
+    ,
+)
+def test_split_auth_netloc_from_url(
+    url: str, expected: Tuplestr, str, TupleOptionalstr, Optionalstr
+) -> None:
+    actual = split_auth_netloc_from_url(url)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "netloc, expected",
+    
+        # Test a basic case.
+        ("example.com", "example.com"),
+        # Test with username and no password.
+        ("accesstoken@example.com", "****@example.com"),
+        # Test with username and password.
+        ("user:pass@example.com", "user:****@example.com"),
+        # Test with username and empty password.
+        ("user:@example.com", "user:****@example.com"),
+        # Test the password containing an @ symbol.
+        ("user:pass@word@example.com", "user:****@example.com"),
+        # Test the password containing a : symbol.
+        ("user:pass:word@example.com", "user:****@example.com"),
+        # Test URL-encoded reserved characters.
+        ("user%3Aname:%23%40%5E@example.com", "user%3Aname:****@example.com"),
+    ,
+)
+def test_redact_netloc(netloc: str, expected: str) -> None:
+    actual = redact_netloc(netloc)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "auth_url, expected_url",
+    
+        (
+            "https://user:pass@domain.tld/project/tags/v0.2",
+            "https://domain.tld/project/tags/v0.2",
+        ),
+        (
+            "https://domain.tld/project/tags/v0.2",
+            "https://domain.tld/project/tags/v0.2",
+        ),
+        (
+            "https://user:pass@domain.tld/svn/project/trunk@8181",
+            "https://domain.tld/svn/project/trunk@8181",
+        ),
+        (
+            "https://domain.tld/project/trunk@8181",
+            "https://domain.tld/project/trunk@8181",
+        ),
+        ("git+https://pypi.org/something", "git+https://pypi.org/something"),
+        ("git+https://user:pass@pypi.org/something", "git+https://pypi.org/something"),
+        ("git+ssh://git@pypi.org/something", "git+ssh://pypi.org/something"),
+    ,
+)
+def test_remove_auth_from_url(auth_url: str, expected_url: str) -> None:
+    url = remove_auth_from_url(auth_url)
+    assert url == expected_url
+
+
+@pytest.mark.parametrize(
+    "auth_url, expected_url",
+    
+        ("https://accesstoken@example.com/abc", "https://****@example.com/abc"),
+        ("https://user:password@example.com", "https://user:****@example.com"),
+        ("https://user:@example.com", "https://user:****@example.com"),
+        ("https://example.com", "https://example.com"),
+        # Test URL-encoded reserved characters.
+        (
+            "https://user%3Aname:%23%40%5E@example.com",
+            "https://user%3Aname:****@example.com",
+        ),
+    ,
+)
+def test_redact_auth_from_url(auth_url: str, expected_url: str) -> None:
+    url = redact_auth_from_url(auth_url)
+    assert url == expected_url
+
+
+class TestHiddenText:
+    def test_basic(self) -> None:
+        """
+        Test str(), repr(), and attribute access.
+        """
+        hidden = HiddenText("my-secret", redacted="######")
+        assert repr(hidden) == "<HiddenText '######'>"
+        assert str(hidden) == "######"
+        assert hidden.redacted == "######"
+        assert hidden.secret == "my-secret"
+
+    def test_equality_with_str(self) -> None:
+        """
+        Test equality (and inequality) with str objects.
+        """
+        hidden = HiddenText("secret", redacted="****")
+
+        # Test that the object doesn't compare equal to either its original
+        # or redacted forms.
+        assert hidden != hidden.secret
+        assert hidden.secret != hidden
+
+        assert hidden != hidden.redacted
+        assert hidden.redacted != hidden
+
+    def test_equality_same_secret(self) -> None:
+        """
+        Test equality with an object having the same secret.
+        """
+        # Choose different redactions for the two objects.
+        hidden1 = HiddenText("secret", redacted="****")
+        hidden2 = HiddenText("secret", redacted="####")
+
+        assert hidden1 == hidden2
+        # Also test __ne__.
+        assert not hidden1 != hidden2
+
+    def test_equality_different_secret(self) -> None:
+        """
+        Test equality with an object having a different secret.
+        """
+        hidden1 = HiddenText("secret-1", redacted="****")
+        hidden2 = HiddenText("secret-2", redacted="****")
+
+        assert hidden1 != hidden2
+        # Also test __eq__.
+        assert not hidden1 == hidden2
+
+
+def test_hide_value() -> None:
+    hidden = hide_value("my-secret")
+    assert repr(hidden) == "<HiddenText '****'>"
+    assert str(hidden) == "****"
+    assert hidden.redacted == "****"
+    assert hidden.secret == "my-secret"
+
+
+def test_hide_url() -> None:
+    hidden_url = hide_url("https://user:password@example.com")
+    assert repr(hidden_url) == "<HiddenText 'https://user:****@example.com'>"
+    assert str(hidden_url) == "https://user:****@example.com"
+    assert hidden_url.redacted == "https://user:****@example.com"
+    assert hidden_url.secret == "https://user:password@example.com"
+
+
+@pytest.fixture()
+def patch_deprecation_check_version() -> IteratorNone:
+    # We do this, so that the deprecation tests are easier to write.
+    import pip._internal.utils.deprecation as d
+
+    old_version = d.current_version
+    d.current_version = "1.0"
+    yield
+    d.current_version = old_version
+
+
+@pytest.mark.usefixtures("patch_deprecation_check_version")
+@pytest.mark.parametrize("replacement", None, "a magic 8 ball")
+@pytest.mark.parametrize("gone_in", None, "2.0")
+@pytest.mark.parametrize("issue", None, 988)
+@pytest.mark.parametrize("feature_flag", None, "magic-8-ball")
+def test_deprecated_message_contains_information(
+    gone_in: Optionalstr,
+    replacement: Optionalstr,
+    issue: Optionalint,
+    feature_flag: Optionalstr,
+) -> None:
+    with pytest.warns(PipDeprecationWarning) as record:
+        deprecated(
+            reason="Stop doing this!",
+            replacement=replacement,
+            gone_in=gone_in,
+            feature_flag=feature_flag,
+            issue=issue,
+        )
+
+    assert len(record) == 1
+    assert isinstance(record0.message, PipDeprecationWarning)
+    message = record0.message.args0
+
+    assert "DEPRECATION: Stop doing this!" in message
+    # Ensure non-None values are mentioned.
+    for item in gone_in, replacement, issue, feature_flag:
+        if item is not None:
+            assert str(item) in message
+
+
+@pytest.mark.usefixtures("patch_deprecation_check_version")
+@pytest.mark.parametrize("replacement", None, "a magic 8 ball")
+@pytest.mark.parametrize("issue", None, 988)
+@pytest.mark.parametrize("feature_flag", None, "magic-8-ball")
+def test_deprecated_raises_error_if_too_old(
+    replacement: Optionalstr, issue: Optionalint, feature_flag: Optionalstr
+) -> None:
+    with pytest.raises(PipDeprecationWarning) as exception:
+        deprecated(
+            reason="Stop doing this!",
+            gone_in="1.0",  # this matches the patched version.
+            replacement=replacement,
+            feature_flag=feature_flag,
+            issue=issue,
+        )
+
+    message = exception.value.args0
+
+    assert "DEPRECATION: Stop doing this!" in message
+    assert "1.0" in message
+    assert str(feature_flag) not in message
+    # Ensure non-None values are mentioned.
+    for item in replacement, issue:
+        if item is not None:
+            assert str(item) in message
+
+
+@pytest.mark.usefixtures("patch_deprecation_check_version")
+def test_deprecated_message_reads_well_past() -> None:
+    with pytest.raises(PipDeprecationWarning) as exception:
+        deprecated(
+            reason="Stop doing this!",
+            gone_in="1.0",  # this matches the patched version.
+            replacement="to be nicer",
+            feature_flag="magic-8-ball",
+            issue=100000,
+        )
+
+    message = exception.value.args0
+
+    assert message == (
+        "DEPRECATION: Stop doing this! "
+        "Since pip 1.0, this is no longer supported. "
+        "A possible replacement is to be nicer. "
+        "Discussion can be found at https://github.com/pypa/pip/issues/100000"
+    )
+
+
+@pytest.mark.usefixtures("patch_deprecation_check_version")
+def test_deprecated_message_reads_well_future() -> None:
+    with pytest.warns(PipDeprecationWarning) as record:
+        deprecated(
+            reason="Stop doing this!",
+            gone_in="2.0",  # this is greater than the patched version.
+            replacement="to be nicer",
+            feature_flag="crisis",
+            issue=100000,
+        )
+
+    assert len(record) == 1
+    assert isinstance(record0.message, PipDeprecationWarning)
+    message = record0.message.args0
+
+    assert message == (
+        "DEPRECATION: Stop doing this! "
+        "pip 2.0 will enforce this behaviour change. "
+        "A possible replacement is to be nicer. "
+        "You can use the flag --use-feature=crisis to test the upcoming behaviour. "
+        "Discussion can be found at https://github.com/pypa/pip/issues/100000"
+    )
+
+
+def test_make_setuptools_shim_args() -> None:
+    # Test all arguments at once, including the overall ordering.
+    args = make_setuptools_shim_args(
+        "/dir/path/setup.py",
+        global_options="--some", "--option",
+        no_user_config=True,
+        unbuffered_output=True,
+    )
+
+    assert args1:3 == "-u", "-c"
+    assert args4: == "--some", "--option", "--no-user-cfg"
+
+    shim = args3
+    # Spot-check key aspects of the command string.
+    assert "import setuptools" in shim
+    assert "'/dir/path/setup.py'" in args3
+    assert "sys.argv0 = __file__" in args3
+
+
+@pytest.mark.parametrize("global_options", None, , "--some", "--option")
+def test_make_setuptools_shim_args__global_options(
+    global_options: OptionalListstr,
+) -> None:
+    args = make_setuptools_shim_args(
+        "/dir/path/setup.py",
+        global_options=global_options,
+    )
+
+    if global_options:
+        assert len(args) == 5
+        for option in global_options:
+            assert option in args
+    else:
+        assert len(args) == 3
+
+
+@pytest.mark.parametrize("no_user_config", False, True)
+def test_make_setuptools_shim_args__no_user_config(no_user_config: bool) -> None:
+    args = make_setuptools_shim_args(
+        "/dir/path/setup.py",
+        no_user_config=no_user_config,
+    )
+    assert ("--no-user-cfg" in args) == no_user_config
+
+
+@pytest.mark.parametrize("unbuffered_output", False, True)
+def test_make_setuptools_shim_args__unbuffered_output(unbuffered_output: bool) -> None:
+    args = make_setuptools_shim_args(
+        "/dir/path/setup.py", unbuffered_output=unbuffered_output
+    )
+    assert ("-u" in args) == unbuffered_output
+
+
+@pytest.mark.parametrize(
+    "isatty,no_stdin,expected",
+    
+        (True, False, True),
+        (False, False, False),
+        (True, True, False),
+        (False, True, False),
+    ,
+)
+def test_is_console_interactive(
+    monkeypatch: pytest.MonkeyPatch, isatty: bool, no_stdin: bool, expected: bool
+) -> None:
+    monkeypatch.setattr(sys.stdin, "isatty", Mock(return_value=isatty))
+
+    if no_stdin:
+        monkeypatch.setattr(sys, "stdin", None)
+
+    assert is_console_interactive() is expected
+
+
+@pytest.mark.parametrize(
+    "size,expected",
+    
+        (123, "123 bytes"),
+        (1234, "1.2 kB"),
+        (123456, "123 kB"),
+        (1234567890, "1234.6 MB"),
+    ,
+)
+def test_format_size(size: int, expected: str) -> None:
+    assert format_size(size) == expected
+
+
+@pytest.mark.parametrize(
+    ("rows", "table", "sizes"),
+    
+        (, , ),
+        (
+            
+                ("I?", "version", "sdist", "wheel"),
+                ("", "1.18.2", "zip", "cp38-cp38m-win_amd64"),
+                ("v", 1.18, "zip"),
+            ,
+            
+                "I? version sdist wheel",
+                "   1.18.2  zip   cp38-cp38m-win_amd64",
+                "v  1.18    zip",
+            ,
+            2, 7, 5, 20,
+        ),
+        (
+            ("I?", "version", "sdist", "wheel"), (), ("v", "1.18.1", "zip"),
+            "I? version sdist wheel", "", "v  1.18.1  zip",
+            2, 7, 5, 5,
+        ),
+    ,
+)
+def test_tabulate(rows: ListTuplestr, table: Liststr, sizes: Listint) -> None:
+    assert tabulate(rows) == (table, sizes)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_compatibility_tags.py Added

@@ -0,0 +1,108 @@
+import sysconfig
+from typing import Any, Callable, Dict, List, Tuple
+from unittest.mock import patch
+
+import pytest
+
+from pip._internal.utils import compatibility_tags
+
+
+@pytest.mark.parametrize(
+    "version_info, expected",
+    
+        ((2,), "2"),
+        ((2, 8), "28"),
+        ((3,), "3"),
+        ((3, 6), "36"),
+        # Test a tuple of length 3.
+        ((3, 6, 5), "36"),
+        # Test a 2-digit minor version.
+        ((3, 10), "310"),
+    ,
+)
+def test_version_info_to_nodot(version_info: Tupleint, expected: str) -> None:
+    actual = compatibility_tags.version_info_to_nodot(version_info)
+    assert actual == expected
+
+
+class Testcompatibility_tags:
+    def mock_get_config_var(self, **kwd: str) -> Callablestr, Any:
+        """
+        Patch sysconfig.get_config_var for arbitrary keys.
+        """
+        get_config_var = sysconfig.get_config_var
+
+        def _mock_get_config_var(var: str) -> Any:
+            if var in kwd:
+                return kwdvar
+            return get_config_var(var)
+
+        return _mock_get_config_var
+
+    def test_no_hyphen_tag(self) -> None:
+        """
+        Test that no tag contains a hyphen.
+        """
+        import pip._internal.utils.compatibility_tags
+
+        mock_gcf = self.mock_get_config_var(SOABI="cpython-35m-darwin")
+
+        with patch("sysconfig.get_config_var", mock_gcf):
+            supported = pip._internal.utils.compatibility_tags.get_supported()
+
+        for tag in supported:
+            assert "-" not in tag.interpreter
+            assert "-" not in tag.abi
+            assert "-" not in tag.platform
+
+
+class TestManylinux2010Tags:
+    @pytest.mark.parametrize(
+        "manylinux2010,manylinux1",
+        
+            ("manylinux2010_x86_64", "manylinux1_x86_64"),
+            ("manylinux2010_i686", "manylinux1_i686"),
+        ,
+    )
+    def test_manylinux2010_implies_manylinux1(
+        self, manylinux2010: str, manylinux1: str
+    ) -> None:
+        """
+        Specifying manylinux2010 implies manylinux1.
+        """
+        groups: DictTuplestr, str, Liststr = {}
+        supported = compatibility_tags.get_supported(platforms=manylinux2010)
+        for tag in supported:
+            groups.setdefault((tag.interpreter, tag.abi), ).append(tag.platform)
+
+        for arches in groups.values():
+            if arches == "any":
+                continue
+            assert arches:2 == manylinux2010, manylinux1
+
+
+class TestManylinux2014Tags:
+    @pytest.mark.parametrize(
+        "manylinuxA,manylinuxB",
+        
+            ("manylinux2014_x86_64", "manylinux2010_x86_64", "manylinux1_x86_64"),
+            ("manylinux2014_i686", "manylinux2010_i686", "manylinux1_i686"),
+        ,
+    )
+    def test_manylinuxA_implies_manylinuxB(
+        self, manylinuxA: str, manylinuxB: Liststr
+    ) -> None:
+        """
+        Specifying manylinux2014 implies manylinux2010/manylinux1.
+        """
+        groups: DictTuplestr, str, Liststr = {}
+        supported = compatibility_tags.get_supported(platforms=manylinuxA)
+        for tag in supported:
+            groups.setdefault((tag.interpreter, tag.abi), ).append(tag.platform)
+
+        expected_arches = manylinuxA
+        expected_arches.extend(manylinuxB)
+        for arches in groups.values():
+            if arches == "any":
+                continue
+            assert arches:3 == expected_arches

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_filesystem.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_subprocess.py Added

@@ -0,0 +1,398 @@
+import locale
+import sys
+from logging import DEBUG, ERROR, INFO, WARNING
+from typing import List, Optional, Tuple, Type
+
+import pytest
+
+from pip._internal.cli.spinners import SpinnerInterface
+from pip._internal.exceptions import InstallationSubprocessError
+from pip._internal.utils.logging import VERBOSE
+from pip._internal.utils.misc import hide_value
+from pip._internal.utils.subprocess import (
+    CommandArgs,
+    call_subprocess,
+    format_command_args,
+    make_command,
+    subprocess_logger,
+)
+
+
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        ("pip", "list", "pip list"),
+        (
+            "foo", "space space", "new\nline", 'double"quote', "single'quote",
+            """foo 'space space' 'new\nline' 'double"quote' 'single'"'"'quote'""",
+        ),
+        # Test HiddenText arguments.
+        (
+            make_command(hide_value("secret1"), "foo", hide_value("secret2")),
+            "'****' foo '****'",
+        ),
+    ,
+)
+def test_format_command_args(args: CommandArgs, expected: str) -> None:
+    actual = format_command_args(args)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    ("stdout_only", "expected"),
+    
+        (True, ("out\n", "out\r\n")),
+        (False, ("out\nerr\n", "out\r\nerr\r\n", "err\nout\n", "err\r\nout\r\n")),
+    ,
+)
+def test_call_subprocess_stdout_only(
+    capfd: pytest.CaptureFixturestr,
+    monkeypatch: pytest.MonkeyPatch,
+    stdout_only: bool,
+    expected: Tuplestr, ...,
+) -> None:
+    log = 
+    monkeypatch.setattr(
+        subprocess_logger,
+        "log",
+        lambda level, *args: log.append(args0),
+    )
+    out = call_subprocess(
+        
+            sys.executable,
+            "-c",
+            "import sys; sys.stdout.write('out\\n'); sys.stderr.write('err\\n')",
+        ,
+        command_desc="test stdout_only",
+        stdout_only=stdout_only,
+    )
+    assert out in expected
+    captured = capfd.readouterr()
+    assert captured.err == ""
+    assert log == "Running command %s", "out", "err" or log == 
+        "Running command %s",
+        "err",
+        "out",
+    
+
+
+class FakeSpinner(SpinnerInterface):
+    def __init__(self) -> None:
+        self.spin_count = 0
+        self.final_status: Optionalstr = None
+
+    def spin(self) -> None:
+        self.spin_count += 1
+
+    def finish(self, final_status: str) -> None:
+        self.final_status = final_status
+
+
+class TestCallSubprocess:
+
+    """
+    Test call_subprocess().
+    """
+
+    def check_result(
+        self,
+        capfd: pytest.CaptureFixturestr,
+        caplog: pytest.LogCaptureFixture,
+        log_level: int,
+        spinner: FakeSpinner,
+        result: Optionalstr,
+        expected: TupleOptionalListstr, ListTuplestr, int, str,
+        expected_spinner: Tupleint, Optionalstr,
+    ) -> None:
+        """
+        Check the result of calling call_subprocess().
+
+        :param log_level: the logging level that caplog was set to.
+        :param spinner: the FakeSpinner object passed to call_subprocess()
+            to be checked.
+        :param result: the call_subprocess() return value to be checked.
+        :param expected: a pair (expected_proc, expected_records), where
+            1) `expected_proc` is the expected return value of
+              call_subprocess() as a list of lines, or None if the return
+              value is expected to be None;
+            2) `expected_records` is the expected value of
+              caplog.record_tuples.
+        :param expected_spinner: a 2-tuple of the spinner's expected
+            (spin_count, final_status).
+        """
+        expected_proc, expected_records = expected
+
+        if expected_proc is None:
+            assert result is None
+        else:
+            assert result is not None
+            assert result.splitlines() == expected_proc
+
+        # Confirm that stdout and stderr haven't been written to.
+        captured = capfd.readouterr()
+        assert (captured.out, captured.err) == ("", "")
+
+        records = caplog.record_tuples
+        if len(records) != len(expected_records):
+            raise RuntimeError(f"{records} != {expected_records}")
+
+        for record, expected_record in zip(records, expected_records):
+            # Check the logger_name and log level parts exactly.
+            assert record:2 == expected_record:2
+            # For the message portion, check only a substring.  Also, we
+            # can't use startswith() since the order of stdout and stderr
+            # isn't guaranteed in cases where stderr is also present.
+            # For example, we observed the stderr lines coming before stdout
+            # in CI for PyPy 2.7 even though stdout happens first
+            # chronologically.
+            assert expected_record2 in record2
+
+        assert (spinner.spin_count, spinner.final_status) == expected_spinner
+
+    def prepare_call(
+        self,
+        caplog: pytest.LogCaptureFixture,
+        log_level: int,
+        command: Optionalstr = None,
+    ) -> TupleListstr, FakeSpinner:
+        if command is None:
+            command = 'print("Hello"); print("world")'
+
+        caplog.set_level(log_level)
+        spinner = FakeSpinner()
+        args = sys.executable, "-c", command
+
+        return (args, spinner)
+
+    def test_debug_logging(
+        self, capfd: pytest.CaptureFixturestr, caplog: pytest.LogCaptureFixture
+    ) -> None:
+        """
+        Test DEBUG logging (and without passing show_stdout=True).
+        """
+        log_level = DEBUG
+        args, spinner = self.prepare_call(caplog, log_level)
+        result = call_subprocess(
+            args,
+            command_desc="test debug logging",
+            spinner=spinner,
+        )
+
+        expected = (
+            "Hello", "world",
+            
+                ("pip.subprocessor", VERBOSE, "Running "),
+                ("pip.subprocessor", VERBOSE, "Hello"),
+                ("pip.subprocessor", VERBOSE, "world"),
+            ,
+        )
+        # The spinner shouldn't spin in this case since the subprocess
+        # output is already being logged to the console.
+        self.check_result(
+            capfd,
+            caplog,
+            log_level,
+            spinner,
+            result,
+            expected,
+            expected_spinner=(0, None),
+        )
+
+    def test_info_logging(
+        self, capfd: pytest.CaptureFixturestr, caplog: pytest.LogCaptureFixture
+    ) -> None:
+        """
+        Test INFO logging (and without passing show_stdout=True).
+        """
+        log_level = INFO
+        args, spinner = self.prepare_call(caplog, log_level)
+        result = call_subprocess(
+            args,
+            command_desc="test info logging",
+            spinner=spinner,
+        )
+
+        expected: TupleListstr, ListTuplestr, int, str = (
+            "Hello", "world",
+            ,
+        )
+        # The spinner should spin twice in this case since the subprocess
+        # output isn't being written to the console.
+        self.check_result(
+            capfd,
+            caplog,
+            log_level,
+            spinner,
+            result,
+            expected,
+            expected_spinner=(2, "done"),
+        )
+
+    def test_info_logging__subprocess_error(
+        self, capfd: pytest.CaptureFixturestr, caplog: pytest.LogCaptureFixture
+    ) -> None:
+        """
+        Test INFO logging of a subprocess with an error (and without passing
+        show_stdout=True).
+        """
+        log_level = INFO
+        command = 'print("Hello"); print("world"); exit("fail")'
+        args, spinner = self.prepare_call(caplog, log_level, command=command)
+
+        with pytest.raises(InstallationSubprocessError) as exc:
+            call_subprocess(
+                args,
+                command_desc="test info logging with subprocess error",
+                spinner=spinner,
+            )
+        result = None
+        exception = exc.value
+        assert exception.reference == "subprocess-exited-with-error"
+        assert "exit code: 1" in exception.message
+        assert exception.note_stmt
+        assert "not a problem with pip" in exception.note_stmt
+        # Check that the process output is captured, and would be shown.
+        assert exception.context
+        assert "Hello\n" in exception.context
+        assert "fail\n" in exception.context
+        assert "world\n" in exception.context
+
+        expected = (
+            None,
+            
+                # pytest's caplog overrides th formatter, which means that we
+                # won't see the message formatted through our formatters.
+                ("pip.subprocessor", ERROR, "present-rich"),
+            ,
+        )
+        # The spinner should spin three times in this case since the
+        # subprocess output isn't being written to the console.
+        self.check_result(
+            capfd,
+            caplog,
+            log_level,
+            spinner,
+            result,
+            expected,
+            expected_spinner=(3, "error"),
+        )
+
+    def test_info_logging_with_show_stdout_true(
+        self, capfd: pytest.CaptureFixturestr, caplog: pytest.LogCaptureFixture
+    ) -> None:
+        """
+        Test INFO logging with show_stdout=True.
+        """
+        log_level = INFO
+        args, spinner = self.prepare_call(caplog, log_level)
+        result = call_subprocess(
+            args,
+            command_desc="test info logging with show_stdout",
+            spinner=spinner,
+            show_stdout=True,
+        )
+
+        expected = (
+            "Hello", "world",
+            
+                ("pip.subprocessor", INFO, "Running "),
+                ("pip.subprocessor", INFO, "Hello"),
+                ("pip.subprocessor", INFO, "world"),
+            ,
+        )
+        # The spinner shouldn't spin in this case since the subprocess
+        # output is already being written to the console.
+        self.check_result(
+            capfd,
+            caplog,
+            log_level,
+            spinner,
+            result,
+            expected,
+            expected_spinner=(0, None),
+        )
+
+    @pytest.mark.parametrize(
+        ("exit_status", "show_stdout", "extra_ok_returncodes", "log_level", "expected"),
+        
+            # The spinner should show here because show_stdout=False means
+            # the subprocess should get logged at DEBUG level, but the passed
+            # log level is only INFO.
+            (0, False, None, INFO, (None, "done", 2)),
+            # Test some cases where the spinner should not be shown.
+            (0, False, None, DEBUG, (None, None, 0)),
+            # Test show_stdout=True.
+            (0, True, None, DEBUG, (None, None, 0)),
+            (0, True, None, INFO, (None, None, 0)),
+            # The spinner should show here because show_stdout=True means
+            # the subprocess should get logged at INFO level, but the passed
+            # log level is only WARNING.
+            (0, True, None, WARNING, (None, "done", 2)),
+            # Test a non-zero exit status.
+            (3, False, None, INFO, (InstallationSubprocessError, "error", 2)),
+            # Test a non-zero exit status also in extra_ok_returncodes.
+            (3, False, (3,), INFO, (None, "done", 2)),
+        ,
+    )
+    def test_spinner_finish(
+        self,
+        exit_status: int,
+        show_stdout: bool,
+        extra_ok_returncodes: OptionalTupleint, ...,
+        log_level: int,
+        caplog: pytest.LogCaptureFixture,
+        expected: TupleOptionalTypeException, Optionalstr, int,
+    ) -> None:
+        """
+        Test that the spinner finishes correctly.
+        """
+        expected_exc_type = expected0
+        expected_final_status = expected1
+        expected_spin_count = expected2
+
+        command = f'print("Hello"); print("world"); exit({exit_status})'
+        args, spinner = self.prepare_call(caplog, log_level, command=command)
+        exc_type: OptionalTypeException
+        try:
+            call_subprocess(
+                args,
+                command_desc="spinner go spinny",
+                show_stdout=show_stdout,
+                extra_ok_returncodes=extra_ok_returncodes,
+                spinner=spinner,
+            )
+        except Exception as exc:
+            exc_type = type(exc)
+        else:
+            exc_type = None
+
+        assert exc_type == expected_exc_type
+        assert spinner.final_status == expected_final_status
+        assert spinner.spin_count == expected_spin_count
+
+    def test_closes_stdin(self) -> None:
+        with pytest.raises(InstallationSubprocessError):
+            call_subprocess(
+                sys.executable, "-c", "input()",
+                show_stdout=True,
+                command_desc="stdin reader",
+            )
+
+
+def test_unicode_decode_error(caplog: pytest.LogCaptureFixture) -> None:
+    if locale.getpreferredencoding() != "UTF-8":
+        pytest.skip("locale.getpreferredencoding() is not UTF-8")
+    caplog.set_level(INFO)
+    call_subprocess(
+        
+            sys.executable,
+            "-c",
+            "import sys; sys.stdout.buffer.write(b'\\xff')",
+        ,
+        command_desc="invalid decode output",
+        show_stdout=True,
+    )
+
+    assert len(caplog.records) == 2
+    # First log record is "Running ..."
+    assert caplog.record_tuples1 == ("pip.subprocessor", INFO, "\\xff")

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_temp_dir.py Added

@@ -0,0 +1,276 @@
+import itertools
+import os
+import stat
+import tempfile
+from pathlib import Path
+from typing import Any, Iterator, Optional, Union
+
+import pytest
+
+from pip._internal.utils import temp_dir
+from pip._internal.utils.misc import ensure_dir
+from pip._internal.utils.temp_dir import (
+    AdjacentTempDirectory,
+    TempDirectory,
+    _Default,
+    _default,
+    global_tempdir_manager,
+    tempdir_registry,
+)
+
+
+# No need to test symlinked directories on Windows
+@pytest.mark.skipif("sys.platform == 'win32'")
+def test_symlinked_path() -> None:
+    with TempDirectory() as tmp_dir:
+        assert os.path.exists(tmp_dir.path)
+
+        alt_tmp_dir = tempfile.mkdtemp(prefix="pip-test-")
+        assert os.path.dirname(tmp_dir.path) == os.path.dirname(
+            os.path.realpath(alt_tmp_dir)
+        )
+        # are we on a system where /tmp is a symlink
+        if os.path.realpath(alt_tmp_dir) != os.path.abspath(alt_tmp_dir):
+            assert os.path.dirname(tmp_dir.path) != os.path.dirname(alt_tmp_dir)
+        else:
+            assert os.path.dirname(tmp_dir.path) == os.path.dirname(alt_tmp_dir)
+        os.rmdir(tmp_dir.path)
+        assert not os.path.exists(tmp_dir.path)
+
+
+def test_deletes_readonly_files() -> None:
+    def create_file(*args: str) -> None:
+        fpath = os.path.join(*args)
+        ensure_dir(os.path.dirname(fpath))
+        with open(fpath, "w") as f:
+            f.write("Holla!")
+
+    def readonly_file(*args: str) -> None:
+        fpath = os.path.join(*args)
+        os.chmod(fpath, stat.S_IREAD)
+
+    with TempDirectory() as tmp_dir:
+        create_file(tmp_dir.path, "normal-file")
+        create_file(tmp_dir.path, "readonly-file")
+        readonly_file(tmp_dir.path, "readonly-file")
+
+        create_file(tmp_dir.path, "subfolder", "normal-file")
+        create_file(tmp_dir.path, "subfolder", "readonly-file")
+        readonly_file(tmp_dir.path, "subfolder", "readonly-file")
+
+
+def test_path_access_after_context_raises() -> None:
+    with TempDirectory() as tmp_dir:
+        path = tmp_dir.path
+
+    with pytest.raises(AssertionError) as e:
+        _ = tmp_dir.path
+
+    assert path in str(e.value)
+
+
+def test_path_access_after_clean_raises() -> None:
+    tmp_dir = TempDirectory()
+    path = tmp_dir.path
+    tmp_dir.cleanup()
+
+    with pytest.raises(AssertionError) as e:
+        _ = tmp_dir.path
+
+    assert path in str(e.value)
+
+
+def test_create_and_cleanup_work() -> None:
+    tmp_dir = TempDirectory()
+    created_path = tmp_dir.path
+
+    assert tmp_dir.path is not None
+    assert os.path.exists(created_path)
+
+    tmp_dir.cleanup()
+    assert not os.path.exists(created_path)
+
+
+@pytest.mark.parametrize(
+    "name",
+    
+        "ABC",
+        "ABC.dist-info",
+        "_+-",
+        "_package",
+        "A......B",
+        "AB",
+        "A",
+        "2",
+    ,
+)
+def test_adjacent_directory_names(name: str) -> None:
+    def names() -> Iteratorstr:
+        return AdjacentTempDirectory._generate_names(name)
+
+    chars = AdjacentTempDirectory.LEADING_CHARS
+
+    # Ensure many names are unique
+    # (For long *name*, this sequence can be extremely long.
+    # However, since we're only ever going to take the first
+    # result that works, provided there are many of those
+    # and that shorter names result in totally unique sets,
+    # it's okay to skip part of the test.)
+    some_names = list(itertools.islice(names(), 1000))
+    # We should always get at least 1000 names
+    assert len(some_names) == 1000
+
+    # Ensure original name does not appear early in the set
+    assert name not in some_names
+
+    if len(name) > 2:
+        # Names should be at least 90% unique (given the infinite
+        # range of inputs, and the possibility that generated names
+        # may already exist on disk anyway, this is a much cheaper
+        # criteria to enforce than complete uniqueness).
+        assert len(some_names) > 0.9 * len(set(some_names))
+
+        # Ensure the first few names are the same length as the original
+        same_len = list(itertools.takewhile(lambda x: len(x) == len(name), some_names))
+        assert len(same_len) > 10
+
+        # Check the first group are correct
+        expected_names = "~" + name1:
+        expected_names.extend("~" + c + name2: for c in chars)
+        for x, y in zip(some_names, expected_names):
+            assert x == y
+
+    else:
+        # All names are going to be longer than our original
+        assert min(len(x) for x in some_names) > 1
+
+        # All names are going to be unique
+        assert len(some_names) == len(set(some_names))
+
+        if len(name) == 2:
+            # All but the first name are going to end with our original
+            assert all(x.endswith(name) for x in some_names1:)
+        else:
+            # All names are going to end with our original
+            assert all(x.endswith(name) for x in some_names)
+
+
+@pytest.mark.parametrize(
+    "name",
+    
+        "A",
+        "ABC",
+        "ABC.dist-info",
+        "_+-",
+        "_package",
+    ,
+)
+def test_adjacent_directory_exists(name: str, tmpdir: Path) -> None:
+    block_name, expect_name = itertools.islice(
+        AdjacentTempDirectory._generate_names(name), 2
+    )
+
+    original = os.path.join(tmpdir, name)
+    blocker = os.path.join(tmpdir, block_name)
+
+    ensure_dir(original)
+    ensure_dir(blocker)
+
+    with AdjacentTempDirectory(original) as atmp_dir:
+        assert expect_name == os.path.split(atmp_dir.path)1
+
+
+def test_adjacent_directory_permission_error(monkeypatch: pytest.MonkeyPatch) -> None:
+    name = "ABC"
+
+    def raising_mkdir(*args: Any, **kwargs: Any) -> None:
+        raise OSError("Unknown OSError")
+
+    with TempDirectory() as tmp_dir:
+        original = os.path.join(tmp_dir.path, name)
+
+        ensure_dir(original)
+        monkeypatch.setattr("os.mkdir", raising_mkdir)
+
+        with pytest.raises(OSError):
+            with AdjacentTempDirectory(original):
+                pass
+
+
+def test_global_tempdir_manager() -> None:
+    with global_tempdir_manager():
+        d = TempDirectory(globally_managed=True)
+        path = d.path
+        assert os.path.exists(path)
+    assert not os.path.exists(path)
+
+
+def test_tempdirectory_asserts_global_tempdir(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(temp_dir, "_tempdir_manager", None)
+    with pytest.raises(AssertionError):
+        TempDirectory(globally_managed=True)
+
+
+deleted_kind = "deleted"
+not_deleted_kind = "not-deleted"
+
+
+@pytest.mark.parametrize(
+    "delete,kind,exists",
+    
+        (None, deleted_kind, False),
+        (_default, deleted_kind, False),
+        (True, deleted_kind, False),
+        (False, deleted_kind, True),
+        (None, not_deleted_kind, True),
+        (_default, not_deleted_kind, True),
+        (True, not_deleted_kind, False),
+        (False, not_deleted_kind, True),
+        (None, "unspecified", False),
+        (_default, "unspecified", False),
+        (True, "unspecified", False),
+        (False, "unspecified", True),
+    ,
+)
+def test_tempdir_registry(
+    delete: Unionbool, _Default, kind: str, exists: bool
+) -> None:
+    with tempdir_registry() as registry:
+        registry.set_delete(deleted_kind, True)
+        registry.set_delete(not_deleted_kind, False)
+
+        with TempDirectory(delete=delete, kind=kind) as d:
+            path = d.path
+            assert os.path.exists(path)
+        assert os.path.exists(path) == exists
+
+
+@pytest.mark.parametrize("delete,exists", (_default, True), (None, False))
+def test_temp_dir_does_not_delete_explicit_paths_by_default(
+    tmpdir: Path, delete: Optional_Default, exists: bool
+) -> None:
+    p = tmpdir / "example"
+    p.mkdir()
+    path = os.fspath(p)
+
+    with tempdir_registry() as registry:
+        registry.set_delete(deleted_kind, True)
+
+        with TempDirectory(path=path, delete=delete, kind=deleted_kind) as d:
+            assert str(d.path) == path
+            assert os.path.exists(path)
+        assert os.path.exists(path) == exists
+
+
+@pytest.mark.parametrize("should_delete", True, False)
+def test_tempdir_registry_lazy(should_delete: bool) -> None:
+    """
+    Test the registry entry can be updated after a temp dir is created,
+    to change whether a kind should be deleted or not.
+    """
+    with tempdir_registry() as registry:
+        with TempDirectory(delete=None, kind="test-for-lazy") as d:
+            path = d.path
+            registry.set_delete("test-for-lazy", should_delete)
+            assert os.path.exists(path)
+        assert os.path.exists(path) == (not should_delete)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_unpacking.py Added

@@ -0,0 +1,209 @@
+import io
+import os
+import shutil
+import stat
+import sys
+import tarfile
+import tempfile
+import time
+import zipfile
+from pathlib import Path
+from typing import List, Tuple
+
+import pytest
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.utils.unpacking import is_within_directory, untar_file, unzip_file
+from tests.lib import TestData
+
+
+class TestUnpackArchives:
+    """
+    test_tar.tgz/test_tar.zip have content as follows engineered to confirm 3
+    things:
+     1) confirm that reg files, dirs, and symlinks get unpacked
+     2) permissions are not preserved (and go by the 022 umask)
+     3) reg files with *any* execute perms, get chmod +x
+
+       file.txt         600 regular file
+       symlink.txt      777 symlink to file.txt
+       script_owner.sh  700 script where owner can execute
+       script_group.sh  610 script where group can execute
+       script_world.sh  601 script where world can execute
+       dir              744 directory
+       dir/dirfile      622 regular file
+     4) the file contents are extracted correctly (though the content of
+        each file isn't currently unique)
+
+    """
+
+    def setup_method(self) -> None:
+        self.tempdir = tempfile.mkdtemp()
+        self.old_mask = os.umask(0o022)
+        self.symlink_expected_mode = None
+
+    def teardown_method(self) -> None:
+        os.umask(self.old_mask)
+        shutil.rmtree(self.tempdir, ignore_errors=True)
+
+    def mode(self, path: str) -> int:
+        return stat.S_IMODE(os.stat(path).st_mode)
+
+    def confirm_files(self) -> None:
+        # expectations based on 022 umask set above and the unpack logic that
+        # sets execute permissions, not preservation
+        for fname, expected_mode, test, expected_contents in 
+            ("file.txt", 0o644, os.path.isfile, b"file\n"),
+            # We don't test the "symlink.txt" contents for now.
+            ("symlink.txt", 0o644, os.path.isfile, None),
+            ("script_owner.sh", 0o755, os.path.isfile, b"file\n"),
+            ("script_group.sh", 0o755, os.path.isfile, b"file\n"),
+            ("script_world.sh", 0o755, os.path.isfile, b"file\n"),
+            ("dir", 0o755, os.path.isdir, None),
+            (os.path.join("dir", "dirfile"), 0o644, os.path.isfile, b""),
+        :
+            path = os.path.join(self.tempdir, fname)
+            if path.endswith("symlink.txt") and sys.platform == "win32":
+                # no symlinks created on windows
+                continue
+            assert test(path), path
+            if expected_contents is not None:
+                with open(path, mode="rb") as f:
+                    contents = f.read()
+                assert contents == expected_contents, f"fname: {fname}"
+            if sys.platform == "win32":
+                # the permissions tests below don't apply in windows
+                # due to os.chmod being a noop
+                continue
+            mode = self.mode(path)
+            assert (
+                mode == expected_mode
+            ), f"mode: {mode}, expected mode: {expected_mode}"
+
+    def make_zip_file(self, filename: str, file_list: Liststr) -> str:
+        """
+        Create a zip file for test case
+        """
+        test_zip = os.path.join(self.tempdir, filename)
+        with zipfile.ZipFile(test_zip, "w") as myzip:
+            for item in file_list:
+                myzip.writestr(item, "file content")
+        return test_zip
+
+    def make_tar_file(self, filename: str, file_list: Liststr) -> str:
+        """
+        Create a tar file for test case
+        """
+        test_tar = os.path.join(self.tempdir, filename)
+        with tarfile.open(test_tar, "w") as mytar:
+            for item in file_list:
+                file_tarinfo = tarfile.TarInfo(item)
+                mytar.addfile(file_tarinfo, io.BytesIO(b"file content"))
+        return test_tar
+
+    def test_unpack_tgz(self, data: TestData) -> None:
+        """
+        Test unpacking a *.tgz, and setting execute permissions
+        """
+        test_file = data.packages.joinpath("test_tar.tgz")
+        untar_file(os.fspath(test_file), self.tempdir)
+        self.confirm_files()
+        # Check the timestamp of an extracted file
+        file_txt_path = os.path.join(self.tempdir, "file.txt")
+        mtime = time.gmtime(os.stat(file_txt_path).st_mtime)
+        assert mtime0:6 == (2013, 8, 16, 5, 13, 37), mtime
+
+    def test_unpack_zip(self, data: TestData) -> None:
+        """
+        Test unpacking a *.zip, and setting execute permissions
+        """
+        test_file = data.packages.joinpath("test_zip.zip")
+        unzip_file(os.fspath(test_file), self.tempdir)
+        self.confirm_files()
+
+    def test_unpack_zip_failure(self) -> None:
+        """
+        Test unpacking a *.zip with file containing .. path
+        and expect exception
+        """
+        files = "regular_file.txt", os.path.join("..", "outside_file.txt")
+        test_zip = self.make_zip_file("test_zip.zip", files)
+        with pytest.raises(InstallationError) as e:
+            unzip_file(test_zip, self.tempdir)
+        assert "trying to install outside target directory" in str(e.value)
+
+    def test_unpack_zip_success(self) -> None:
+        """
+        Test unpacking a *.zip with regular files,
+        no file will be installed outside target directory after unpack
+        so no exception raised
+        """
+        files = 
+            "regular_file1.txt",
+            os.path.join("dir", "dir_file1.txt"),
+            os.path.join("dir", "..", "dir_file2.txt"),
+        
+        test_zip = self.make_zip_file("test_zip.zip", files)
+        unzip_file(test_zip, self.tempdir)
+
+    def test_unpack_tar_failure(self) -> None:
+        """
+        Test unpacking a *.tar with file containing .. path
+        and expect exception
+        """
+        files = "regular_file.txt", os.path.join("..", "outside_file.txt")
+        test_tar = self.make_tar_file("test_tar.tar", files)
+        with pytest.raises(InstallationError) as e:
+            untar_file(test_tar, self.tempdir)
+        assert "trying to install outside target directory" in str(e.value)
+
+    def test_unpack_tar_success(self) -> None:
+        """
+        Test unpacking a *.tar with regular files,
+        no file will be installed outside target directory after unpack
+        so no exception raised
+        """
+        files = 
+            "regular_file1.txt",
+            os.path.join("dir", "dir_file1.txt"),
+            os.path.join("dir", "..", "dir_file2.txt"),
+        
+        test_tar = self.make_tar_file("test_tar.tar", files)
+        untar_file(test_tar, self.tempdir)
+
+
+def test_unpack_tar_unicode(tmpdir: Path) -> None:
+    test_tar = tmpdir / "test.tar"
+    # tarfile tries to decode incoming
+    with tarfile.open(test_tar, "w", format=tarfile.PAX_FORMAT, encoding="utf-8") as f:
+        metadata = tarfile.TarInfo("dir/åäö_日本語.py")
+        f.addfile(metadata, io.BytesIO(b"hello world"))
+
+    output_dir = tmpdir / "output"
+    output_dir.mkdir()
+
+    untar_file(os.fspath(test_tar), str(output_dir))
+
+    output_dir_name = str(output_dir)
+    contents = os.listdir(output_dir_name)
+    assert "åäö_日本語.py" in contents
+
+
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        # Test the second containing the first.
+        (("parent/sub", "parent/"), False),
+        # Test the first not ending in a trailing slash.
+        (("parent", "parent/foo"), True),
+        # Test target containing `..` but still inside the parent.
+        (("parent/", "parent/foo/../bar"), True),
+        # Test target within the parent
+        (("parent/", "parent/sub"), True),
+        # Test target outside parent
+        (("parent/", "parent/../sub"), False),
+    ,
+)
+def test_is_within_directory(args: Tuplestr, str, expected: bool) -> None:
+    result = is_within_directory(*args)
+    assert result == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_virtualenv.py Added

@@ -0,0 +1,145 @@
+import logging
+import os
+import site
+import sys
+from pathlib import Path
+from typing import List, Optional
+
+import pytest
+
+from pip._internal.utils import virtualenv
+
+
+@pytest.mark.parametrize(
+    "real_prefix, base_prefix, expected",
+    
+        (None, None, False),  # Python 2 base interpreter
+        (None, sys.prefix, False),  # Python 3 base interpreter
+        (None, "not_sys_prefix", True),  # PEP405 venv
+        (sys.prefix, None, True),  # Unknown case
+        (sys.prefix, sys.prefix, True),  # Unknown case
+        (sys.prefix, "not_sys_prefix", True),  # Unknown case
+        ("not_sys_prefix", None, True),  # Python 2 virtualenv
+        ("not_sys_prefix", sys.prefix, True),  # Python 3 virtualenv
+        ("not_sys_prefix", "not_sys_prefix", True),  # Unknown case
+    ,
+)
+def test_running_under_virtualenv(
+    monkeypatch: pytest.MonkeyPatch,
+    real_prefix: Optionalstr,
+    base_prefix: Optionalstr,
+    expected: bool,
+) -> None:
+    # Use raising=False to prevent AttributeError on missing attribute
+    if real_prefix is None:
+        monkeypatch.delattr(sys, "real_prefix", raising=False)
+    else:
+        monkeypatch.setattr(sys, "real_prefix", real_prefix, raising=False)
+    if base_prefix is None:
+        monkeypatch.delattr(sys, "base_prefix", raising=False)
+    else:
+        monkeypatch.setattr(sys, "base_prefix", base_prefix, raising=False)
+    assert virtualenv.running_under_virtualenv() == expected
+
+
+@pytest.mark.parametrize(
+    "under_virtualenv, no_global_file, expected",
+    
+        (False, False, False),
+        (False, True, False),
+        (True, False, False),
+        (True, True, True),
+    ,
+)
+def test_virtualenv_no_global_with_regular_virtualenv(
+    monkeypatch: pytest.MonkeyPatch,
+    tmpdir: Path,
+    under_virtualenv: bool,
+    no_global_file: bool,
+    expected: bool,
+) -> None:
+    monkeypatch.setattr(virtualenv, "_running_under_venv", lambda: False)
+
+    monkeypatch.setattr(site, "__file__", os.fspath(tmpdir / "site.py"))
+    monkeypatch.setattr(
+        virtualenv,
+        "_running_under_legacy_virtualenv",
+        lambda: under_virtualenv,
+    )
+    if no_global_file:
+        (tmpdir / "no-global-site-packages.txt").touch()
+
+    assert virtualenv.virtualenv_no_global() == expected
+
+
+@pytest.mark.parametrize(
+    "pyvenv_cfg_lines, under_venv, expect_no_global, expect_warning",
+    
+        (None, False, False, False),
+        (None, True, True, True),  # this has a warning.
+        (
+            
+                "home = <we do not care>",
+                "include-system-site-packages = true",
+                "version = <we do not care>",
+            ,
+            True,
+            False,
+            False,
+        ),
+        (
+            
+                "home = <we do not care>",
+                "include-system-site-packages = false",
+                "version = <we do not care>",
+            ,
+            True,
+            True,
+            False,
+        ),
+    ,
+)
+def test_virtualenv_no_global_with_pep_405_virtual_environment(
+    monkeypatch: pytest.MonkeyPatch,
+    caplog: pytest.LogCaptureFixture,
+    pyvenv_cfg_lines: OptionalListstr,
+    under_venv: bool,
+    expect_no_global: bool,
+    expect_warning: bool,
+) -> None:
+    monkeypatch.setattr(virtualenv, "_running_under_legacy_virtualenv", lambda: False)
+    monkeypatch.setattr(virtualenv, "_get_pyvenv_cfg_lines", lambda: pyvenv_cfg_lines)
+    monkeypatch.setattr(virtualenv, "_running_under_venv", lambda: under_venv)
+
+    with caplog.at_level(logging.WARNING):
+        assert virtualenv.virtualenv_no_global() == expect_no_global
+
+    if expect_warning:
+        assert caplog.records
+
+        # Check for basic information
+        message = caplog.records-1.getMessage().lower()
+        assert "could not access 'pyvenv.cfg'" in message
+        assert "assuming global site-packages is not accessible" in message
+
+
+@pytest.mark.parametrize(
+    "contents, expected",
+    
+        (None, None),
+        ("", ),
+        ("a = b\nc = d\n", "a = b", "c = d"),
+        ("a = b\nc = d", "a = b", "c = d"),  # no trailing newlines
+    ,
+)
+def test_get_pyvenv_cfg_lines_for_pep_405_virtual_environment(
+    monkeypatch: pytest.MonkeyPatch,
+    tmpdir: Path,
+    contents: Optionalstr,
+    expected: OptionalListstr,
+) -> None:
+    monkeypatch.setattr(sys, "prefix", str(tmpdir))
+    if contents is not None:
+        tmpdir.joinpath("pyvenv.cfg").write_text(contents)
+
+    assert virtualenv._get_pyvenv_cfg_lines() == expected

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_utils_wheel.py Added

@@ -0,0 +1,140 @@
+import os
+from contextlib import ExitStack
+from email import message_from_string
+from io import BytesIO
+from pathlib import Path
+from typing import Callable, Iterator
+from zipfile import ZipFile
+
+import pytest
+
+from pip._internal.exceptions import UnsupportedWheel
+from pip._internal.utils import wheel
+from tests.lib import TestData
+
+_ZipDir = CallablePath, ZipFile
+
+
+@pytest.fixture
+def zip_dir() -> Iterator_ZipDir:
+    def make_zip(path: Path) -> ZipFile:
+        buf = BytesIO()
+        with ZipFile(buf, "w", allowZip64=True) as z:
+            for dirpath, _, filenames in os.walk(path):
+                for filename in filenames:
+                    file_path = os.path.join(path, dirpath, filename)
+                    # Zip files must always have / as path separator
+                    archive_path = os.path.relpath(file_path, path).replace(
+                        os.pathsep, "/"
+                    )
+                    z.write(file_path, archive_path)
+
+        return stack.enter_context(ZipFile(buf, "r", allowZip64=True))
+
+    stack = ExitStack()
+    with stack:
+        yield make_zip
+
+
+def test_wheel_dist_info_dir_found(tmpdir: Path, zip_dir: _ZipDir) -> None:
+    expected = "simple-0.1.dist-info"
+    dist_info_dir = tmpdir / expected
+    dist_info_dir.mkdir()
+    dist_info_dir.joinpath("WHEEL").touch()
+    assert wheel.wheel_dist_info_dir(zip_dir(tmpdir), "simple") == expected
+
+
+def test_wheel_dist_info_dir_multiple(tmpdir: Path, zip_dir: _ZipDir) -> None:
+    dist_info_dir_1 = tmpdir / "simple-0.1.dist-info"
+    dist_info_dir_1.mkdir()
+    dist_info_dir_1.joinpath("WHEEL").touch()
+    dist_info_dir_2 = tmpdir / "unrelated-0.1.dist-info"
+    dist_info_dir_2.mkdir()
+    dist_info_dir_2.joinpath("WHEEL").touch()
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_dist_info_dir(zip_dir(tmpdir), "simple")
+    assert "multiple .dist-info directories found" in str(e.value)
+
+
+def test_wheel_dist_info_dir_none(tmpdir: Path, zip_dir: _ZipDir) -> None:
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_dist_info_dir(zip_dir(tmpdir), "simple")
+    assert "directory not found" in str(e.value)
+
+
+def test_wheel_dist_info_dir_wrong_name(tmpdir: Path, zip_dir: _ZipDir) -> None:
+    dist_info_dir = tmpdir / "unrelated-0.1.dist-info"
+    dist_info_dir.mkdir()
+    dist_info_dir.joinpath("WHEEL").touch()
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_dist_info_dir(zip_dir(tmpdir), "simple")
+    assert "does not start with 'simple'" in str(e.value)
+
+
+def test_wheel_version_ok(data: TestData) -> None:
+    assert wheel.wheel_version(message_from_string("Wheel-Version: 1.9")) == (1, 9)
+
+
+def test_wheel_metadata_fails_missing_wheel(tmpdir: Path, zip_dir: _ZipDir) -> None:
+    dist_info_dir = tmpdir / "simple-0.1.0.dist-info"
+    dist_info_dir.mkdir()
+    dist_info_dir.joinpath("METADATA").touch()
+
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_metadata(zip_dir(tmpdir), dist_info_dir.name)
+    assert "could not read" in str(e.value)
+
+
+def test_wheel_metadata_fails_on_bad_encoding(tmpdir: Path, zip_dir: _ZipDir) -> None:
+    dist_info_dir = tmpdir / "simple-0.1.0.dist-info"
+    dist_info_dir.mkdir()
+    dist_info_dir.joinpath("METADATA").touch()
+    dist_info_dir.joinpath("WHEEL").write_bytes(b"\xff")
+
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_metadata(zip_dir(tmpdir), dist_info_dir.name)
+    assert "error decoding" in str(e.value)
+
+
+def test_wheel_version_fails_on_no_wheel_version() -> None:
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_version(message_from_string(""))
+    assert "missing Wheel-Version" in str(e.value)
+
+
+@pytest.mark.parametrize(
+    "version",
+    
+        ("",),
+        ("1.b",),
+        ("1.",),
+    ,
+)
+def test_wheel_version_fails_on_bad_wheel_version(version: str) -> None:
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.wheel_version(message_from_string(f"Wheel-Version: {version}"))
+    assert "invalid Wheel-Version" in str(e.value)
+
+
+def test_check_compatibility() -> None:
+    name = "test"
+    vc = wheel.VERSION_COMPATIBLE
+
+    # Major version is higher - should be incompatible
+    higher_v = (vc0 + 1, vc1)
+
+    # test raises with correct error
+    with pytest.raises(UnsupportedWheel) as e:
+        wheel.check_compatibility(higher_v, name)
+    assert "is not compatible" in str(e)
+
+    # Should only log.warning - minor version is greater
+    higher_v = (vc0, vc1 + 1)
+    wheel.check_compatibility(higher_v, name)
+
+    # These should work fine
+    wheel.check_compatibility(wheel.VERSION_COMPATIBLE, name)
+
+    # E.g if wheel to install is 1.0 and we support up to 1.2
+    lower_v = (vc0, max(0, vc1 - 1))
+    wheel.check_compatibility(lower_v, name)

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_vcs.py Added

@@ -0,0 +1,832 @@
+import os
+import pathlib
+from typing import Any, Dict, List, Optional, Tuple, Type
+from unittest import TestCase, mock
+
+import pytest
+
+from pip._internal.exceptions import BadCommand, InstallationError
+from pip._internal.utils.misc import HiddenText, hide_url, hide_value
+from pip._internal.utils.subprocess import CommandArgs
+from pip._internal.vcs import make_vcs_requirement_url
+from pip._internal.vcs.bazaar import Bazaar
+from pip._internal.vcs.git import Git, RemoteNotValidError, looks_like_hash
+from pip._internal.vcs.mercurial import Mercurial
+from pip._internal.vcs.subversion import Subversion
+from pip._internal.vcs.versioncontrol import RevOptions, VersionControl
+from tests.lib import is_svn_installed, need_svn
+
+
+@pytest.mark.skipif(
+    "CI" not in os.environ, reason="Subversion is only required under CI"
+)
+def test_ensure_svn_available() -> None:
+    """Make sure that svn is available when running in CI."""
+    assert is_svn_installed()
+
+
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        # Test without subdir.
+        (
+            ("git+https://example.com/pkg", "dev", "myproj"),
+            "git+https://example.com/pkg@dev#egg=myproj",
+        ),
+        # Test with subdir.
+        (
+            ("git+https://example.com/pkg", "dev", "myproj", "sub/dir"),
+            "git+https://example.com/pkg@dev#egg=myproj&subdirectory=sub/dir",
+        ),
+        # Test with None subdir.
+        (
+            ("git+https://example.com/pkg", "dev", "myproj", None),
+            "git+https://example.com/pkg@dev#egg=myproj",
+        ),
+        # Test an unescaped project name.
+        (
+            ("git+https://example.com/pkg", "dev", "zope-interface"),
+            "git+https://example.com/pkg@dev#egg=zope_interface",
+        ),
+    ,
+)
+def test_make_vcs_requirement_url(args: TupleAny, ..., expected: str) -> None:
+    actual = make_vcs_requirement_url(*args)
+    assert actual == expected
+
+
+def test_rev_options_repr() -> None:
+    rev_options = RevOptions(Git, "develop")
+    assert repr(rev_options) == "<RevOptions git: rev='develop'>"
+
+
+@pytest.mark.parametrize(
+    ("vc_class", "expected1", "expected2", "kwargs"),
+    
+        # First check VCS-specific RevOptions behavior.
+        (Bazaar, , "-r", "123", {}),
+        (Git, "HEAD", "123", {}),
+        (Mercurial, , "123", {}),
+        (Subversion, , "-r", "123", {}),
+        # Test extra_args.  For this, test using a single VersionControl class.
+        (
+            Git,
+            "HEAD", "opt1", "opt2",
+            "123", "opt1", "opt2",
+            dict(extra_args="opt1", "opt2"),
+        ),
+    ,
+)
+def test_rev_options_to_args(
+    vc_class: TypeVersionControl,
+    expected1: Liststr,
+    expected2: Liststr,
+    kwargs: Dictstr, Any,
+) -> None:
+    """
+    Test RevOptions.to_args().
+    """
+    assert RevOptions(vc_class, **kwargs).to_args() == expected1
+    assert RevOptions(vc_class, "123", **kwargs).to_args() == expected2
+
+
+def test_rev_options_to_display() -> None:
+    """
+    Test RevOptions.to_display().
+    """
+    # The choice of VersionControl class doesn't matter here since
+    # the implementation is the same for all of them.
+    rev_options = RevOptions(Git)
+    assert rev_options.to_display() == ""
+
+    rev_options = RevOptions(Git, "master")
+    assert rev_options.to_display() == " (to revision master)"
+
+
+def test_rev_options_make_new() -> None:
+    """
+    Test RevOptions.make_new().
+    """
+    # The choice of VersionControl class doesn't matter here since
+    # the implementation is the same for all of them.
+    rev_options = RevOptions(Git, "master", extra_args="foo", "bar")
+    new_options = rev_options.make_new("develop")
+
+    assert new_options is not rev_options
+    assert new_options.extra_args == "foo", "bar"
+    assert new_options.rev == "develop"
+    assert new_options.vc_class is Git
+
+
+@pytest.mark.parametrize(
+    "sha, expected",
+    
+        ((40 * "a"), True),
+        ((40 * "A"), True),
+        # Test a string containing all valid characters.
+        ((18 * "a" + "0123456789abcdefABCDEF"), True),
+        ((40 * "g"), False),
+        ((39 * "a"), False),
+        ((41 * "a"), False),
+    ,
+)
+def test_looks_like_hash(sha: str, expected: bool) -> None:
+    assert looks_like_hash(sha) == expected
+
+
+@pytest.mark.parametrize(
+    "vcs_cls, remote_url, expected",
+    
+        # Mercurial is one of the subclasses using the base class implementation.
+        # `hg://` isn't a real prefix but it tests the default behaviour.
+        (Mercurial, "hg://user@example.com/MyProject", False),
+        (Mercurial, "http://example.com/MyProject", True),
+        # The Git subclasses should return true in all cases.
+        (Git, "git://example.com/MyProject", True),
+        (Git, "http://example.com/MyProject", True),
+        # Subversion also overrides the base class implementation.
+        (Subversion, "svn://example.com/MyProject", True),
+    ,
+)
+def test_should_add_vcs_url_prefix(
+    vcs_cls: TypeVersionControl, remote_url: str, expected: bool
+) -> None:
+    actual = vcs_cls.should_add_vcs_url_prefix(remote_url)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "url, target",
+    
+        # A fully qualified remote url. No changes needed.
+        ("ssh://bob@server/foo/bar.git", "ssh://bob@server/foo/bar.git"),
+        ("git://bob@server/foo/bar.git", "git://bob@server/foo/bar.git"),
+        # User is optional and does not need a default.
+        ("ssh://server/foo/bar.git", "ssh://server/foo/bar.git"),
+        # The common scp shorthand for ssh remotes. Pip won't recognise these as
+        # git remotes until they have a 'ssh://' prefix and the ':' in the middle
+        # is gone.
+        ("git@example.com:foo/bar.git", "ssh://git@example.com/foo/bar.git"),
+        ("example.com:foo.git", "ssh://example.com/foo.git"),
+        # Http(s) remote names are already complete and should remain unchanged.
+        ("https://example.com/foo", "https://example.com/foo"),
+        ("http://example.com/foo/bar.git", "http://example.com/foo/bar.git"),
+        ("https://bob@example.com/foo", "https://bob@example.com/foo"),
+    ,
+)
+def test_git_remote_url_to_pip(url: str, target: str) -> None:
+    assert Git._git_remote_to_pip_url(url) == target
+
+
+@pytest.mark.parametrize(
+    "url, platform",
+    
+        # Windows paths with the ':' drive prefix look dangerously close to SCP.
+        ("c:/piffle/wiffle/waffle/poffle.git", "nt"),
+        (r"c:\faffle\waffle\woffle\piffle.git", "nt"),
+        # Unix paths less so but test them anyway.
+        ("/muffle/fuffle/pufffle/fluffle.git", "posix"),
+    ,
+)
+def test_paths_are_not_mistaken_for_scp_shorthand(url: str, platform: str) -> None:
+    # File paths should not be mistaken for SCP shorthand. If they do then
+    # 'c:/piffle/wiffle' would end up as 'ssh://c/piffle/wiffle'.
+    from pip._internal.vcs.git import SCP_REGEX
+
+    assert not SCP_REGEX.match(url)
+
+    if platform == os.name:
+        with pytest.raises(RemoteNotValidError):
+            Git._git_remote_to_pip_url(url)
+
+
+def test_git_remote_local_path(tmpdir: pathlib.Path) -> None:
+    path = pathlib.Path(tmpdir, "project.git")
+    path.mkdir()
+    # Path must exist to be recognised as a local git remote.
+    assert Git._git_remote_to_pip_url(str(path)) == path.as_uri()
+
+
+@mock.patch("pip._internal.vcs.git.Git.get_remote_url")
+@mock.patch("pip._internal.vcs.git.Git.get_revision")
+@mock.patch("pip._internal.vcs.git.Git.get_subdirectory")
+@pytest.mark.parametrize(
+    "git_url, target_url_prefix",
+    
+        (
+            "https://github.com/pypa/pip-test-package",
+            "git+https://github.com/pypa/pip-test-package",
+        ),
+        (
+            "git@github.com:pypa/pip-test-package",
+            "git+ssh://git@github.com/pypa/pip-test-package",
+        ),
+    ,
+    ids="https", "ssh",
+)
+@pytest.mark.network
+def test_git_get_src_requirements(
+    mock_get_subdirectory: mock.Mock,
+    mock_get_revision: mock.Mock,
+    mock_get_remote_url: mock.Mock,
+    git_url: str,
+    target_url_prefix: str,
+) -> None:
+    sha = "5547fa909e83df8bd743d3978d6667497983a4b7"
+
+    mock_get_remote_url.return_value = Git._git_remote_to_pip_url(git_url)
+    mock_get_revision.return_value = sha
+    mock_get_subdirectory.return_value = None
+
+    ret = Git.get_src_requirement(".", "pip-test-package")
+
+    target = f"{target_url_prefix}@{sha}#egg=pip_test_package"
+    assert ret == target
+
+
+@mock.patch("pip._internal.vcs.git.Git.get_revision_sha")
+def test_git_resolve_revision_rev_exists(get_sha_mock: mock.Mock) -> None:
+    get_sha_mock.return_value = ("123456", False)
+    url = HiddenText("git+https://git.example.com", redacted="*")
+    rev_options = Git.make_rev_options("develop")
+
+    new_options = Git.resolve_revision(".", url, rev_options)
+    assert new_options.rev == "123456"
+
+
+@mock.patch("pip._internal.vcs.git.Git.get_revision_sha")
+def test_git_resolve_revision_rev_not_found(get_sha_mock: mock.Mock) -> None:
+    get_sha_mock.return_value = (None, False)
+    url = HiddenText("git+https://git.example.com", redacted="*")
+    rev_options = Git.make_rev_options("develop")
+
+    new_options = Git.resolve_revision(".", url, rev_options)
+    assert new_options.rev == "develop"
+
+
+@mock.patch("pip._internal.vcs.git.Git.get_revision_sha")
+def test_git_resolve_revision_not_found_warning(
+    get_sha_mock: mock.Mock, caplog: pytest.LogCaptureFixture
+) -> None:
+    get_sha_mock.return_value = (None, False)
+    url = HiddenText("git+https://git.example.com", redacted="*")
+    sha = 40 * "a"
+    rev_options = Git.make_rev_options(sha)
+
+    # resolve_revision with a full sha would fail here because
+    # it attempts a git fetch. This case is now covered by
+    # test_resolve_commit_not_on_branch.
+
+    rev_options = Git.make_rev_options(sha:6)
+    new_options = Git.resolve_revision(".", url, rev_options)
+    assert new_options.rev == "aaaaaa"
+
+    # Check that a warning got logged only for the abbreviated hash.
+    messages = r.getMessage() for r in caplog.records
+    messages = msg for msg in messages if msg.startswith("Did not find ")
+    assert messages == 
+        "Did not find branch or tag 'aaaaaa', assuming revision or ref."
+    
+
+
+@pytest.mark.parametrize(
+    "rev_name,result",
+    (
+        ("5547fa909e83df8bd743d3978d6667497983a4b7", True),
+        ("5547fa909", False),
+        ("5678", False),
+        ("abc123", False),
+        ("foo", False),
+        (None, False),
+    ),
+)
+@mock.patch("pip._internal.vcs.git.Git.get_revision")
+def test_git_is_commit_id_equal(
+    mock_get_revision: mock.Mock, rev_name: Optionalstr, result: bool
+) -> None:
+    """
+    Test Git.is_commit_id_equal().
+    """
+    mock_get_revision.return_value = "5547fa909e83df8bd743d3978d6667497983a4b7"
+    assert Git.is_commit_id_equal("/path", rev_name) is result
+
+
+# The non-SVN backends all use the same get_netloc_and_auth(), so only test
+# Git as a representative.
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        # Test a basic case.
+        (("example.com", "https"), ("example.com", (None, None))),
+        # Test with username and password.
+        (("user:pass@example.com", "https"), ("user:pass@example.com", (None, None))),
+    ,
+)
+def test_git__get_netloc_and_auth(
+    args: Tuplestr, str, expected: Tuplestr, TupleNone, None
+) -> None:
+    """
+    Test VersionControl.get_netloc_and_auth().
+    """
+    netloc, scheme = args
+    actual = Git.get_netloc_and_auth(netloc, scheme)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "args, expected",
+    
+        # Test https.
+        (("example.com", "https"), ("example.com", (None, None))),
+        # Test https with username and no password.
+        (("user@example.com", "https"), ("example.com", ("user", None))),
+        # Test https with username and password.
+        (("user:pass@example.com", "https"), ("example.com", ("user", "pass"))),
+        # Test https with URL-encoded reserved characters.
+        (
+            ("user%3Aname:%23%40%5E@example.com", "https"),
+            ("example.com", ("user:name", "#@^")),
+        ),
+        # Test ssh with username and password.
+        (("user:pass@example.com", "ssh"), ("user:pass@example.com", (None, None))),
+    ,
+)
+def test_subversion__get_netloc_and_auth(
+    args: Tuplestr, str, expected: Tuplestr, TupleOptionalstr, Optionalstr
+) -> None:
+    """
+    Test Subversion.get_netloc_and_auth().
+    """
+    netloc, scheme = args
+    actual = Subversion.get_netloc_and_auth(netloc, scheme)
+    assert actual == expected
+
+
+def test_git__get_url_rev__idempotent() -> None:
+    """
+    Check that Git.get_url_rev_and_auth() is idempotent for what the code calls
+    "stub URLs" (i.e. URLs that don't contain "://").
+
+    Also check that it doesn't change self.url.
+    """
+    url = "git+git@git.example.com:MyProject#egg=MyProject"
+    result1 = Git.get_url_rev_and_auth(url)
+    result2 = Git.get_url_rev_and_auth(url)
+    expected = ("git@git.example.com:MyProject", None, (None, None))
+    assert result1 == expected
+    assert result2 == expected
+
+
+@pytest.mark.parametrize(
+    "url, expected",
+    
+        (
+            "svn+https://svn.example.com/MyProject",
+            ("https://svn.example.com/MyProject", None, (None, None)),
+        ),
+        # Test a "+" in the path portion.
+        (
+            "svn+https://svn.example.com/My+Project",
+            ("https://svn.example.com/My+Project", None, (None, None)),
+        ),
+    ,
+)
+def test_version_control__get_url_rev_and_auth(
+    url: str, expected: Tuplestr, None, TupleNone, None
+) -> None:
+    """
+    Test the basic case of VersionControl.get_url_rev_and_auth().
+    """
+    actual = VersionControl.get_url_rev_and_auth(url)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "url",
+    
+        "https://svn.example.com/MyProject",
+        # Test a URL containing a "+" (but not in the scheme).
+        "https://svn.example.com/My+Project",
+    ,
+)
+def test_version_control__get_url_rev_and_auth__missing_plus(url: str) -> None:
+    """
+    Test passing a URL to VersionControl.get_url_rev_and_auth() with a "+"
+    missing from the scheme.
+    """
+    with pytest.raises(ValueError) as excinfo:
+        VersionControl.get_url_rev_and_auth(url)
+
+    assert "malformed VCS url" in str(excinfo.value)
+
+
+@pytest.mark.parametrize(
+    "url",
+    
+        # Test a URL with revision part as empty.
+        "git+https://github.com/MyUser/myProject.git@#egg=py_pkg",
+    ,
+)
+def test_version_control__get_url_rev_and_auth__no_revision(url: str) -> None:
+    """
+    Test passing a URL to VersionControl.get_url_rev_and_auth() with
+    empty revision
+    """
+    with pytest.raises(InstallationError) as excinfo:
+        VersionControl.get_url_rev_and_auth(url)
+
+    assert "an empty revision (after @)" in str(excinfo.value)
+
+
+@pytest.mark.parametrize("vcs_cls", Bazaar, Git, Mercurial, Subversion)
+@pytest.mark.parametrize(
+    "exc_cls, msg_re",
+    
+        (FileNotFoundError, r"Cannot find command '{name}'"),
+        (PermissionError, r"No permission to execute '{name}'"),
+    ,
+    ids="FileNotFoundError", "PermissionError",
+)
+def test_version_control__run_command__fails(
+    vcs_cls: TypeVersionControl, exc_cls: TypeException, msg_re: str
+) -> None:
+    """
+    Test that ``VersionControl.run_command()`` raises ``BadCommand``
+    when the command is not found or when the user have no permission
+    to execute it. The error message must contains the command name.
+    """
+    with mock.patch("pip._internal.vcs.versioncontrol.call_subprocess") as call:
+        call.side_effect = exc_cls
+        with pytest.raises(BadCommand, match=msg_re.format(name=vcs_cls.name)):
+            # https://github.com/python/mypy/issues/3283
+            vcs_cls.run_command()  # type: ignorearg-type
+
+
+@pytest.mark.parametrize(
+    "url, expected",
+    
+        # Test http.
+        (
+            "bzr+http://bzr.myproject.org/MyProject/trunk/#egg=MyProject",
+            "http://bzr.myproject.org/MyProject/trunk/",
+        ),
+        # Test https.
+        (
+            "bzr+https://bzr.myproject.org/MyProject/trunk/#egg=MyProject",
+            "https://bzr.myproject.org/MyProject/trunk/",
+        ),
+        # Test ftp.
+        (
+            "bzr+ftp://bzr.myproject.org/MyProject/trunk/#egg=MyProject",
+            "ftp://bzr.myproject.org/MyProject/trunk/",
+        ),
+        # Test sftp.
+        (
+            "bzr+sftp://bzr.myproject.org/MyProject/trunk/#egg=MyProject",
+            "sftp://bzr.myproject.org/MyProject/trunk/",
+        ),
+        # Test launchpad.
+        ("bzr+lp:MyLaunchpadProject#egg=MyLaunchpadProject", "lp:MyLaunchpadProject"),
+        # Test ssh (special handling).
+        (
+            "bzr+ssh://bzr.myproject.org/MyProject/trunk/#egg=MyProject",
+            "bzr+ssh://bzr.myproject.org/MyProject/trunk/",
+        ),
+    ,
+)
+def test_bazaar__get_url_rev_and_auth(url: str, expected: str) -> None:
+    """
+    Test Bazaar.get_url_rev_and_auth().
+    """
+    actual = Bazaar.get_url_rev_and_auth(url)
+    assert actual == (expected, None, (None, None))
+
+
+@pytest.mark.parametrize(
+    "url, expected",
+    
+        # Test an https URL.
+        (
+            "svn+https://svn.example.com/MyProject#egg=MyProject",
+            ("https://svn.example.com/MyProject", None, (None, None)),
+        ),
+        # Test an https URL with a username and password.
+        (
+            "svn+https://user:pass@svn.example.com/MyProject#egg=MyProject",
+            ("https://svn.example.com/MyProject", None, ("user", "pass")),
+        ),
+        # Test an ssh URL.
+        (
+            "svn+ssh://svn.example.com/MyProject#egg=MyProject",
+            ("svn+ssh://svn.example.com/MyProject", None, (None, None)),
+        ),
+        # Test an ssh URL with a username.
+        (
+            "svn+ssh://user@svn.example.com/MyProject#egg=MyProject",
+            ("svn+ssh://user@svn.example.com/MyProject", None, (None, None)),
+        ),
+    ,
+)
+def test_subversion__get_url_rev_and_auth(
+    url: str, expected: Tuplestr, None, TupleOptionalstr, Optionalstr
+) -> None:
+    """
+    Test Subversion.get_url_rev_and_auth().
+    """
+    actual = Subversion.get_url_rev_and_auth(url)
+    assert actual == expected
+
+
+# The non-SVN backends all use the same make_rev_args(), so only test
+# Git as a representative.
+@pytest.mark.parametrize(
+    "username, password, expected",
+    
+        (None, None, ),
+        ("user", None, ),
+        ("user", hide_value("pass"), ),
+    ,
+)
+def test_git__make_rev_args(
+    username: Optionalstr, password: OptionalHiddenText, expected: CommandArgs
+) -> None:
+    """
+    Test VersionControl.make_rev_args().
+    """
+    actual = Git.make_rev_args(username, password)
+    assert actual == expected
+
+
+@pytest.mark.parametrize(
+    "username, password, expected",
+    
+        (None, None, ),
+        ("user", None, "--username", "user"),
+        (
+            "user",
+            hide_value("pass"),
+            "--username", "user", "--password", hide_value("pass"),
+        ),
+    ,
+)
+def test_subversion__make_rev_args(
+    username: Optionalstr, password: OptionalHiddenText, expected: CommandArgs
+) -> None:
+    """
+    Test Subversion.make_rev_args().
+    """
+    actual = Subversion.make_rev_args(username, password)
+    assert actual == expected
+
+
+def test_subversion__get_url_rev_options() -> None:
+    """
+    Test Subversion.get_url_rev_options().
+    """
+    secret_url = "svn+https://user:pass@svn.example.com/MyProject@v1.0#egg=MyProject"
+    hidden_url = hide_url(secret_url)
+    url, rev_options = Subversion().get_url_rev_options(hidden_url)
+    assert url == hide_url("https://svn.example.com/MyProject")
+    assert rev_options.rev == "v1.0"
+    assert rev_options.extra_args == (
+        "--username", "user", "--password", hide_value("pass")
+    )
+
+
+def test_get_git_version() -> None:
+    git_version = Git().get_git_version()
+    assert git_version >= (1, 0, 0)
+
+
+@pytest.mark.parametrize(
+    "use_interactive,is_atty,expected",
+    
+        (None, False, False),
+        (None, True, True),
+        (False, False, False),
+        (False, True, False),
+        (True, False, True),
+        (True, True, True),
+    ,
+)
+@mock.patch("sys.stdin.isatty")
+def test_subversion__init_use_interactive(
+    mock_isatty: mock.Mock, use_interactive: bool, is_atty: bool, expected: bool
+) -> None:
+    """
+    Test Subversion.__init__() with mocked sys.stdin.isatty() output.
+    """
+    mock_isatty.return_value = is_atty
+    svn = Subversion(use_interactive=use_interactive)
+    assert svn.use_interactive == expected
+
+
+@need_svn
+def test_subversion__call_vcs_version() -> None:
+    """
+    Test Subversion.call_vcs_version() against local ``svn``.
+    """
+    version = Subversion().call_vcs_version()
+    # All Subversion releases since 1.0.0 have used three parts.
+    assert len(version) == 3
+    for part in version:
+        assert isinstance(part, int)
+    assert version0 >= 1
+
+
+@pytest.mark.parametrize(
+    "svn_output, expected_version",
+    
+        (
+            "svn, version 1.10.3 (r1842928)\n"
+            "   compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0",
+            (1, 10, 3),
+        ),
+        (
+            "svn, version 1.12.0-SlikSvn (SlikSvn/1.12.0)\n"
+            "   compiled May 28 2019, 13:44:56 on x86_64-microsoft-windows6.2",
+            (1, 12, 0),
+        ),
+        ("svn, version 1.9.7 (r1800392)", (1, 9, 7)),
+        ("svn, version 1.9.7a1 (r1800392)", ()),
+        ("svn, version 1.9 (r1800392)", (1, 9)),
+        ("svn, version .9.7 (r1800392)", ()),
+        ("svn version 1.9.7 (r1800392)", ()),
+        ("svn 1.9.7", ()),
+        ("svn, version . .", ()),
+        ("", ()),
+    ,
+)
+@mock.patch("pip._internal.vcs.subversion.Subversion.run_command")
+def test_subversion__call_vcs_version_patched(
+    mock_run_command: mock.Mock, svn_output: str, expected_version: Tupleint, ...
+) -> None:
+    """
+    Test Subversion.call_vcs_version() against patched output.
+    """
+    mock_run_command.return_value = svn_output
+    version = Subversion().call_vcs_version()
+    assert version == expected_version
+
+
+@mock.patch("pip._internal.vcs.subversion.Subversion.run_command")
+def test_subversion__call_vcs_version_svn_not_installed(
+    mock_run_command: mock.Mock,
+) -> None:
+    """
+    Test Subversion.call_vcs_version() when svn is not installed.
+    """
+    mock_run_command.side_effect = BadCommand
+    with pytest.raises(BadCommand):
+        Subversion().call_vcs_version()
+
+
+@pytest.mark.parametrize(
+    "version",
+    
+        (),
+        (1,),
+        (1, 8),
+        (1, 8, 0),
+    ,
+)
+def test_subversion__get_vcs_version_cached(version: Tupleint, ...) -> None:
+    """
+    Test Subversion.get_vcs_version() with previously cached result.
+    """
+    svn = Subversion()
+    svn._vcs_version = version
+    assert svn.get_vcs_version() == version
+
+
+@pytest.mark.parametrize(
+    "vcs_version",
+    
+        (),
+        (1, 7),
+        (1, 8, 0),
+    ,
+)
+@mock.patch("pip._internal.vcs.subversion.Subversion.call_vcs_version")
+def test_subversion__get_vcs_version_call_vcs(
+    mock_call_vcs: mock.Mock, vcs_version: Tupleint, ...
+) -> None:
+    """
+    Test Subversion.get_vcs_version() with mocked output from
+    call_vcs_version().
+    """
+    mock_call_vcs.return_value = vcs_version
+    svn = Subversion()
+    assert svn.get_vcs_version() == vcs_version
+
+    # Check that the version information is cached.
+    assert svn._vcs_version == vcs_version
+
+
+@pytest.mark.parametrize(
+    "use_interactive,vcs_version,expected_options",
+    
+        (False, (), "--non-interactive"),
+        (False, (1, 7, 0), "--non-interactive"),
+        (False, (1, 8, 0), "--non-interactive"),
+        (True, (), ),
+        (True, (1, 7, 0), ),
+        (True, (1, 8, 0), "--force-interactive"),
+    ,
+)
+def test_subversion__get_remote_call_options(
+    use_interactive: bool, vcs_version: Tupleint, ..., expected_options: Liststr
+) -> None:
+    """
+    Test Subversion.get_remote_call_options().
+    """
+    svn = Subversion(use_interactive=use_interactive)
+    svn._vcs_version = vcs_version
+    assert svn.get_remote_call_options() == expected_options
+
+
+class TestSubversionArgs(TestCase):
+    def setUp(self) -> None:
+        patcher = mock.patch("pip._internal.vcs.versioncontrol.call_subprocess")
+        self.addCleanup(patcher.stop)
+        self.call_subprocess_mock = patcher.start()
+
+        # Test Data.
+        self.url = "svn+http://username:password@svn.example.com/"
+        # use_interactive is set to False to test that remote call options are
+        # properly added.
+        self.svn = Subversion(use_interactive=False)
+        self.rev_options = RevOptions(Subversion)
+        self.dest = "/tmp/test"
+
+    def assert_call_args(self, args: CommandArgs) -> None:
+        assert self.call_subprocess_mock.call_args00 == args
+
+    def test_obtain(self) -> None:
+        self.svn.obtain(self.dest, hide_url(self.url), verbosity=0)
+        self.assert_call_args(
+            
+                "svn",
+                "checkout",
+                "--quiet",
+                "--non-interactive",
+                "--username",
+                "username",
+                "--password",
+                hide_value("password"),
+                hide_url("http://svn.example.com/"),
+                "/tmp/test",
+            
+        )
+
+    def test_fetch_new(self) -> None:
+        self.svn.fetch_new(self.dest, hide_url(self.url), self.rev_options, verbosity=0)
+        self.assert_call_args(
+            
+                "svn",
+                "checkout",
+                "--quiet",
+                "--non-interactive",
+                hide_url("svn+http://username:password@svn.example.com/"),
+                "/tmp/test",
+            
+        )
+
+    def test_fetch_new_revision(self) -> None:
+        rev_options = RevOptions(Subversion, "123")
+        self.svn.fetch_new(self.dest, hide_url(self.url), rev_options, verbosity=0)
+        self.assert_call_args(
+            
+                "svn",
+                "checkout",
+                "--quiet",
+                "--non-interactive",
+                "-r",
+                "123",
+                hide_url("svn+http://username:password@svn.example.com/"),
+                "/tmp/test",
+            
+        )
+
+    def test_switch(self) -> None:
+        self.svn.switch(self.dest, hide_url(self.url), self.rev_options)
+        self.assert_call_args(
+            
+                "svn",
+                "switch",
+                "--non-interactive",
+                hide_url("svn+http://username:password@svn.example.com/"),
+                "/tmp/test",
+            
+        )
+
+    def test_update(self) -> None:
+        self.svn.update(self.dest, hide_url(self.url), self.rev_options)
+        self.assert_call_args(
+            
+                "svn",
+                "update",
+                "--non-interactive",
+                "/tmp/test",
+            
+        )

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_vcs_mercurial.py Added

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_wheel.py Added

@@ -0,0 +1,721 @@
+"""Tests for wheel binary packages and .dist-info."""
+import csv
+import logging
+import os
+import pathlib
+import sys
+import textwrap
+from email import message_from_string
+from pathlib import Path
+from typing import Dict, List, Optional, Tuple, cast
+from unittest.mock import patch
+
+import pytest
+from pip._vendor.packaging.requirements import Requirement
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.locations import get_scheme
+from pip._internal.models.direct_url import (
+    DIRECT_URL_METADATA_NAME,
+    ArchiveInfo,
+    DirectUrl,
+)
+from pip._internal.models.scheme import Scheme
+from pip._internal.operations.build.wheel_legacy import get_legacy_build_wheel_path
+from pip._internal.operations.install import wheel
+from pip._internal.operations.install.wheel import (
+    InstalledCSVRow,
+    RecordPath,
+    get_console_script_specs,
+)
+from pip._internal.utils.compat import WINDOWS
+from pip._internal.utils.misc import hash_file
+from pip._internal.utils.unpacking import unpack_file
+from tests.lib import DATA_DIR, TestData, assert_paths_equal
+from tests.lib.wheel import make_wheel
+
+
+def call_get_legacy_build_wheel_path(
+    caplog: pytest.LogCaptureFixture, names: Liststr
+) -> Optionalstr:
+    wheel_path = get_legacy_build_wheel_path(
+        names=names,
+        temp_dir="/tmp/abcd",
+        name="pendulum",
+        command_args="arg1", "arg2",
+        command_output="output line 1\noutput line 2\n",
+    )
+    return wheel_path
+
+
+def test_get_legacy_build_wheel_path(caplog: pytest.LogCaptureFixture) -> None:
+    actual = call_get_legacy_build_wheel_path(caplog, names="name")
+    assert actual is not None
+    assert_paths_equal(actual, "/tmp/abcd/name")
+    assert not caplog.records
+
+
+def test_get_legacy_build_wheel_path__no_names(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    caplog.set_level(logging.INFO)
+    actual = call_get_legacy_build_wheel_path(caplog, names=)
+    assert actual is None
+    assert len(caplog.records) == 1
+    record = caplog.records0
+    assert record.levelname == "WARNING"
+    assert record.message.splitlines() == 
+        "Legacy build of wheel for 'pendulum' created no files.",
+        "Command arguments: arg1 arg2",
+        "Command output: use --verbose to show",
+    
+
+
+def test_get_legacy_build_wheel_path__multiple_names(
+    caplog: pytest.LogCaptureFixture,
+) -> None:
+    caplog.set_level(logging.INFO)
+    # Deliberately pass the names in non-sorted order.
+    actual = call_get_legacy_build_wheel_path(
+        caplog,
+        names="name2", "name1",
+    )
+    assert actual is not None
+    assert_paths_equal(actual, "/tmp/abcd/name1")
+    assert len(caplog.records) == 1
+    record = caplog.records0
+    assert record.levelname == "WARNING"
+    assert record.message.splitlines() == 
+        "Legacy build of wheel for 'pendulum' created more than one file.",
+        "Filenames (choosing first): 'name1', 'name2'",
+        "Command arguments: arg1 arg2",
+        "Command output: use --verbose to show",
+    
+
+
+@pytest.mark.parametrize(
+    "console_scripts",
+    
+        "pip = pip._internal.main:pip",
+        "pip:pip = pip._internal.main:pip",
+        "進入點 = 套件.模組:函式",
+    ,
+)
+def test_get_entrypoints(tmp_path: pathlib.Path, console_scripts: str) -> None:
+    entry_points_text = """
+        console_scripts
+        {}
+        section
+        common:one = module:func
+        common:two = module:other_func
+    """.format(
+        console_scripts
+    )
+
+    distribution = make_wheel(
+        "simple",
+        "0.1.0",
+        extra_metadata_files={
+            "entry_points.txt": entry_points_text,
+        },
+    ).as_distribution("simple")
+
+    entry_point, entry_point_value = console_scripts.split(" = ")
+    assert wheel.get_entrypoints(distribution) == ({entry_point: entry_point_value}, {})
+
+
+def test_get_entrypoints_no_entrypoints(tmp_path: pathlib.Path) -> None:
+    distribution = make_wheel("simple", "0.1.0").as_distribution("simple")
+
+    console, gui = wheel.get_entrypoints(distribution)
+    assert console == {}
+    assert gui == {}
+
+
+@pytest.mark.parametrize(
+    "outrows, expected",
+    
+        (
+            
+                ("", "", "a"),
+                ("", "", ""),
+            ,
+            
+                ("", "", ""),
+                ("", "", "a"),
+            ,
+        ),
+        (
+            
+                # Include an int to check avoiding the following error:
+                # > TypeError: '<' not supported between instances of 'str' and 'int'
+                ("", "", 1),
+                ("", "", ""),
+            ,
+            
+                ("", "", ""),
+                ("", "", "1"),
+            ,
+        ),
+        (
+            
+                # Test the normalization correctly encode everything for csv.writer().
+                ("😉", "", 1),
+                ("", "", ""),
+            ,
+            
+                ("", "", ""),
+                ("😉", "", "1"),
+            ,
+        ),
+    ,
+)
+def test_normalized_outrows(
+    outrows: ListTupleRecordPath, str, str, expected: ListTuplestr, str, str
+) -> None:
+    actual = wheel._normalized_outrows(outrows)
+    assert actual == expected
+
+
+def call_get_csv_rows_for_installed(tmpdir: Path, text: str) -> ListInstalledCSVRow:
+    path = tmpdir.joinpath("temp.txt")
+    path.write_text(text)
+
+    # Test that an installed file appearing in RECORD has its filename
+    # updated in the new RECORD file.
+    installed = cast(DictRecordPath, RecordPath, {"a": "z"})
+    lib_dir = "/lib/dir"
+
+    with open(path, **wheel.csv_io_kwargs("r")) as f:
+        record_rows = list(csv.reader(f))
+    outrows = wheel.get_csv_rows_for_installed(
+        record_rows,
+        installed=installed,
+        changed=set(),
+        generated=,
+        lib_dir=lib_dir,
+    )
+    return outrows
+
+
+def test_get_csv_rows_for_installed(
+    tmpdir: Path, caplog: pytest.LogCaptureFixture
+) -> None:
+    text = textwrap.dedent(
+        """\
+    a,b,c
+    d,e,f
+    """
+    )
+    outrows = call_get_csv_rows_for_installed(tmpdir, text)
+
+    expected = 
+        ("z", "b", "c"),
+        ("d", "e", "f"),
+    
+    assert outrows == expected
+    # Check there were no warnings.
+    assert len(caplog.records) == 0
+
+
+def test_get_csv_rows_for_installed__long_lines(
+    tmpdir: Path, caplog: pytest.LogCaptureFixture
+) -> None:
+    text = textwrap.dedent(
+        """\
+    a,b,c,d
+    e,f,g
+    h,i,j,k
+    """
+    )
+    outrows = call_get_csv_rows_for_installed(tmpdir, text)
+    assert outrows == 
+        ("z", "b", "c"),
+        ("e", "f", "g"),
+        ("h", "i", "j"),
+    
+
+    messages = rec.message for rec in caplog.records
+    assert messages == 
+        "RECORD line has more than three elements: 'a', 'b', 'c', 'd'",
+        "RECORD line has more than three elements: 'h', 'i', 'j', 'k'",
+    
+
+
+@pytest.mark.parametrize(
+    "text,expected",
+    
+        ("Root-Is-Purelib: true", True),
+        ("Root-Is-Purelib: false", False),
+        ("Root-Is-Purelib: hello", False),
+        ("", False),
+        ("root-is-purelib: true", True),
+        ("root-is-purelib: True", True),
+    ,
+)
+def test_wheel_root_is_purelib(text: str, expected: bool) -> None:
+    assert wheel.wheel_root_is_purelib(message_from_string(text)) == expected
+
+
+def test_dist_from_broken_wheel_fails(data: TestData) -> None:
+    from pip._internal.exceptions import InvalidWheel
+    from pip._internal.metadata import FilesystemWheel, get_wheel_distribution
+
+    package = data.packages.joinpath("corruptwheel-1.0-py2.py3-none-any.whl")
+    with pytest.raises(InvalidWheel):
+        get_wheel_distribution(FilesystemWheel(os.fspath(package)), "brokenwheel")
+
+
+class TestWheelFile:
+    def test_unpack_wheel_no_flatten(self, tmpdir: Path) -> None:
+        filepath = os.path.join(DATA_DIR, "packages", "meta-1.0-py2.py3-none-any.whl")
+        unpack_file(filepath, os.fspath(tmpdir))
+        assert os.path.isdir(os.path.join(tmpdir, "meta-1.0.dist-info"))
+
+
+class TestInstallUnpackedWheel:
+    """
+    Tests for moving files from wheel src to scheme paths
+    """
+
+    def prep(self, data: TestData, tmp_path: Path) -> None:
+        # Since Path implements __add__, os.path.join returns a Path object.
+        # Passing Path objects to interfaces expecting str (like
+        # `compileall.compile_file`) can cause failures, so we normalize it
+        # to a string here.
+        tmpdir = str(tmp_path)
+        self.name = "sample"
+        self.wheelpath = make_wheel(
+            "sample",
+            "1.2.0",
+            metadata_body=textwrap.dedent(
+                """
+                A sample Python project
+                =======================
+
+                ...
+                """
+            ),
+            metadata_updates={
+                "Requires-Dist": "peppercorn",
+            },
+            extra_files={
+                "sample/__init__.py": textwrap.dedent(
+                    '''
+                    __version__ = '1.2.0'
+
+                    def main():
+                        """Entry point for the application script"""
+                        print("Call your main application code here")
+                    '''
+                ),
+                "sample/package_data.dat": "some data",
+            },
+            extra_metadata_files={
+                "DESCRIPTION.rst": textwrap.dedent(
+                    """
+                    A sample Python project
+                    =======================
+
+                    ...
+                    """
+                ),
+                "top_level.txt": "sample\n",
+                "empty_dir/empty_dir/": "",
+            },
+            extra_data_files={
+                "data/my_data/data_file": "some data",
+            },
+            entry_points={
+                "console_scripts": "sample = sample:main",
+                "gui_scripts": "sample2 = sample:main",
+            },
+        ).save_to_dir(tmpdir)
+        self.req = Requirement("sample")
+        self.src = os.path.join(tmpdir, "src")
+        self.dest = os.path.join(tmpdir, "dest")
+        self.scheme = Scheme(
+            purelib=os.path.join(self.dest, "lib"),
+            platlib=os.path.join(self.dest, "lib"),
+            headers=os.path.join(self.dest, "headers"),
+            scripts=os.path.join(self.dest, "bin"),
+            data=os.path.join(self.dest, "data"),
+        )
+        self.src_dist_info = os.path.join(self.src, "sample-1.2.0.dist-info")
+        self.dest_dist_info = os.path.join(
+            self.scheme.purelib, "sample-1.2.0.dist-info"
+        )
+
+    def assert_permission(self, path: str, mode: int) -> None:
+        target_mode = os.stat(path).st_mode & 0o777
+        assert (target_mode & mode) == mode, oct(target_mode)
+
+    def assert_installed(self, expected_permission: int) -> None:
+        # lib
+        assert os.path.isdir(os.path.join(self.scheme.purelib, "sample"))
+        # dist-info
+        metadata = os.path.join(self.dest_dist_info, "METADATA")
+        self.assert_permission(metadata, expected_permission)
+        record = os.path.join(self.dest_dist_info, "RECORD")
+        self.assert_permission(record, expected_permission)
+        # data files
+        data_file = os.path.join(self.scheme.data, "my_data", "data_file")
+        assert os.path.isfile(data_file)
+        # package data
+        pkg_data = os.path.join(self.scheme.purelib, "sample", "package_data.dat")
+        assert os.path.isfile(pkg_data)
+
+    def test_std_install(self, data: TestData, tmpdir: Path) -> None:
+        self.prep(data, tmpdir)
+        wheel.install_wheel(
+            self.name,
+            self.wheelpath,
+            scheme=self.scheme,
+            req_description=str(self.req),
+        )
+        self.assert_installed(0o644)
+
+    @pytest.mark.parametrize("user_mask, expected_permission", (0o27, 0o640))
+    def test_std_install_with_custom_umask(
+        self, data: TestData, tmpdir: Path, user_mask: int, expected_permission: int
+    ) -> None:
+        """Test that the files created after install honor the permissions
+        set when the user sets a custom umask"""
+
+        prev_umask = os.umask(user_mask)
+        try:
+            self.prep(data, tmpdir)
+            wheel.install_wheel(
+                self.name,
+                self.wheelpath,
+                scheme=self.scheme,
+                req_description=str(self.req),
+            )
+            self.assert_installed(expected_permission)
+        finally:
+            os.umask(prev_umask)
+
+    def test_std_install_requested(self, data: TestData, tmpdir: Path) -> None:
+        self.prep(data, tmpdir)
+        wheel.install_wheel(
+            self.name,
+            self.wheelpath,
+            scheme=self.scheme,
+            req_description=str(self.req),
+            requested=True,
+        )
+        self.assert_installed(0o644)
+        requested_path = os.path.join(self.dest_dist_info, "REQUESTED")
+        assert os.path.isfile(requested_path)
+
+    def test_std_install_with_direct_url(self, data: TestData, tmpdir: Path) -> None:
+        """Test that install_wheel creates direct_url.json metadata when
+        provided with a direct_url argument. Also test that the RECORDS
+        file contains an entry for direct_url.json in that case.
+        Note direct_url.url is intentionally different from wheelpath,
+        because wheelpath is typically the result of a local build.
+        """
+        self.prep(data, tmpdir)
+        direct_url = DirectUrl(
+            url="file:///home/user/archive.tgz",
+            info=ArchiveInfo(),
+        )
+        wheel.install_wheel(
+            self.name,
+            self.wheelpath,
+            scheme=self.scheme,
+            req_description=str(self.req),
+            direct_url=direct_url,
+        )
+        direct_url_path = os.path.join(self.dest_dist_info, DIRECT_URL_METADATA_NAME)
+        self.assert_permission(direct_url_path, 0o644)
+        with open(direct_url_path, "rb") as f1:
+            expected_direct_url_json = direct_url.to_json()
+            direct_url_json = f1.read().decode("utf-8")
+            assert direct_url_json == expected_direct_url_json
+        # check that the direc_url file is part of RECORDS
+        with open(os.path.join(self.dest_dist_info, "RECORD")) as f2:
+            assert DIRECT_URL_METADATA_NAME in f2.read()
+
+    def test_install_prefix(self, data: TestData, tmpdir: Path) -> None:
+        prefix = os.path.join(os.path.sep, "some", "path")
+        self.prep(data, tmpdir)
+        scheme = get_scheme(
+            self.name,
+            user=False,
+            home=None,
+            root=str(tmpdir),  # Casting needed for CPython 3.10+. See GH-10358.
+            isolated=False,
+            prefix=prefix,
+        )
+        wheel.install_wheel(
+            self.name,
+            self.wheelpath,
+            scheme=scheme,
+            req_description=str(self.req),
+        )
+
+        bin_dir = "Scripts" if WINDOWS else "bin"
+        assert os.path.exists(os.path.join(tmpdir, "some", "path", bin_dir))
+        assert os.path.exists(os.path.join(tmpdir, "some", "path", "my_data"))
+
+    def test_dist_info_contains_empty_dir(self, data: TestData, tmpdir: Path) -> None:
+        """
+        Test that empty dirs are not installed
+        """
+        # e.g. https://github.com/pypa/pip/issues/1632#issuecomment-38027275
+        self.prep(data, tmpdir)
+        wheel.install_wheel(
+            self.name,
+            self.wheelpath,
+            scheme=self.scheme,
+            req_description=str(self.req),
+        )
+        self.assert_installed(0o644)
+        assert not os.path.isdir(os.path.join(self.dest_dist_info, "empty_dir"))
+
+    @pytest.mark.parametrize("path", "/tmp/example", "../example", "./../example")
+    def test_wheel_install_rejects_bad_paths(
+        self, data: TestData, tmpdir: Path, path: str
+    ) -> None:
+        self.prep(data, tmpdir)
+        wheel_path = make_wheel(
+            "simple", "0.1.0", extra_files={path: "example contents\n"}
+        ).save_to_dir(tmpdir)
+        with pytest.raises(InstallationError) as e:
+            wheel.install_wheel(
+                "simple",
+                str(wheel_path),
+                scheme=self.scheme,
+                req_description="simple",
+            )
+
+        exc_text = str(e.value)
+        assert os.path.basename(wheel_path) in exc_text
+        assert "example" in exc_text
+
+    @pytest.mark.xfail(strict=True)
+    @pytest.mark.parametrize("entrypoint", "hello = hello", "hello = hello:")
+    @pytest.mark.parametrize("entrypoint_type", "console_scripts", "gui_scripts")
+    def test_invalid_entrypoints_fail(
+        self, data: TestData, tmpdir: Path, entrypoint: str, entrypoint_type: str
+    ) -> None:
+        self.prep(data, tmpdir)
+        wheel_path = make_wheel(
+            "simple", "0.1.0", entry_points={entrypoint_type: entrypoint}
+        ).save_to_dir(tmpdir)
+        with pytest.raises(InstallationError) as e:
+            wheel.install_wheel(
+                "simple",
+                str(wheel_path),
+                scheme=self.scheme,
+                req_description="simple",
+            )
+
+        exc_text = str(e.value)
+        assert os.path.basename(wheel_path) in exc_text
+        assert entrypoint in exc_text
+
+
+class TestMessageAboutScriptsNotOnPATH:
+    tilde_warning_msg = (
+        "NOTE: The current PATH contains path(s) starting with `~`, "
+        "which may not be expanded by all applications."
+    )
+
+    def _template(self, paths: Liststr, scripts: Liststr) -> Optionalstr:
+        with patch.dict("os.environ", {"PATH": os.pathsep.join(paths)}):
+            return wheel.message_about_scripts_not_on_PATH(scripts)
+
+    def test_no_script(self) -> None:
+        retval = self._template(paths="/a/b", "/c/d/bin", scripts=)
+        assert retval is None
+
+    def test_single_script__single_dir_not_on_PATH(self) -> None:
+        retval = self._template(paths="/a/b", "/c/d/bin", scripts="/c/d/foo")
+        assert retval is not None
+        assert "--no-warn-script-location" in retval
+        assert "foo is installed in '/c/d'" in retval
+        assert self.tilde_warning_msg not in retval
+
+    def test_two_script__single_dir_not_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin", scripts="/c/d/foo", "/c/d/baz"
+        )
+        assert retval is not None
+        assert "--no-warn-script-location" in retval
+        assert "baz and foo are installed in '/c/d'" in retval
+        assert self.tilde_warning_msg not in retval
+
+    def test_multi_script__multi_dir_not_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin",
+            scripts="/c/d/foo", "/c/d/bar", "/c/d/baz", "/a/b/c/spam",
+        )
+        assert retval is not None
+        assert "--no-warn-script-location" in retval
+        assert "bar, baz and foo are installed in '/c/d'" in retval
+        assert "spam is installed in '/a/b/c'" in retval
+        assert self.tilde_warning_msg not in retval
+
+    def test_multi_script_all__multi_dir_not_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin",
+            scripts="/c/d/foo", "/c/d/bar", "/c/d/baz", "/a/b/c/spam", "/a/b/c/eggs",
+        )
+        assert retval is not None
+        assert "--no-warn-script-location" in retval
+        assert "bar, baz and foo are installed in '/c/d'" in retval
+        assert "eggs and spam are installed in '/a/b/c'" in retval
+        assert self.tilde_warning_msg not in retval
+
+    def test_two_script__single_dir_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin", scripts="/a/b/foo", "/a/b/baz"
+        )
+        assert retval is None
+
+    def test_multi_script__multi_dir_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin",
+            scripts="/a/b/foo", "/a/b/bar", "/a/b/baz", "/c/d/bin/spam",
+        )
+        assert retval is None
+
+    def test_multi_script__single_dir_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin", scripts="/a/b/foo", "/a/b/bar", "/a/b/baz"
+        )
+        assert retval is None
+
+    def test_PATH_check_path_normalization(self) -> None:
+        retval = self._template(
+            paths="/a/./b/../b//c/", "/d/e/bin", scripts="/a/b/c/foo"
+        )
+        assert retval is None
+
+    def test_single_script__single_dir_on_PATH(self) -> None:
+        retval = self._template(paths="/a/b", "/c/d/bin", scripts="/a/b/foo")
+        assert retval is None
+
+    def test_PATH_check_case_insensitive_on_windows(self) -> None:
+        retval = self._template(paths="C:\\A\\b", scripts="c:\\a\\b\\c", "C:/A/b/d")
+        if WINDOWS:
+            assert retval is None
+        else:
+            assert retval is not None
+            assert self.tilde_warning_msg not in retval
+
+    def test_trailing_ossep_removal(self) -> None:
+        retval = self._template(
+            paths=os.path.join("a", "b", ""), scripts=os.path.join("a", "b", "c")
+        )
+        assert retval is None
+
+    def test_missing_PATH_env_treated_as_empty_PATH_env(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
+        scripts = "a/b/foo"
+
+        monkeypatch.delenv("PATH")
+        retval_missing = wheel.message_about_scripts_not_on_PATH(scripts)
+
+        monkeypatch.setenv("PATH", "")
+        retval_empty = wheel.message_about_scripts_not_on_PATH(scripts)
+
+        assert retval_missing == retval_empty
+
+    def test_no_script_tilde_in_path(self) -> None:
+        retval = self._template(paths="/a/b", "/c/d/bin", "~/e", "/f/g~g", scripts=)
+        assert retval is None
+
+    def test_multi_script_all_tilde__multi_dir_not_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/a/b", "/c/d/bin", "~e/f",
+            scripts=
+                "/c/d/foo",
+                "/c/d/bar",
+                "/c/d/baz",
+                "/a/b/c/spam",
+                "/a/b/c/eggs",
+                "/e/f/tilde",
+            ,
+        )
+        assert retval is not None
+        assert "--no-warn-script-location" in retval
+        assert "bar, baz and foo are installed in '/c/d'" in retval
+        assert "eggs and spam are installed in '/a/b/c'" in retval
+        assert "tilde is installed in '/e/f'" in retval
+        assert self.tilde_warning_msg in retval
+
+    def test_multi_script_all_tilde_not_at_start__multi_dir_not_on_PATH(self) -> None:
+        retval = self._template(
+            paths="/e/f~f", "/c/d/bin",
+            scripts=
+                "/c/d/foo",
+                "/c/d/bar",
+                "/c/d/baz",
+                "/e/f~f/c/spam",
+                "/e/f~f/c/eggs",
+            ,
+        )
+        assert retval is not None
+        assert "--no-warn-script-location" in retval
+        assert "bar, baz and foo are installed in '/c/d'" in retval
+        assert "eggs and spam are installed in '/e/f~f/c'" in retval
+        assert self.tilde_warning_msg not in retval
+
+
+class TestWheelHashCalculators:
+    def prep(self, tmpdir: Path) -> None:
+        self.test_file = tmpdir.joinpath("hash.file")
+        # Want this big enough to trigger the internal read loops.
+        self.test_file_len = 2 * 1024 * 1024
+        with open(str(self.test_file), "w") as fp:
+            fp.truncate(self.test_file_len)
+        self.test_file_hash = (
+            "5647f05ec18958947d32874eeb788fa396a05d0bab7c1b71f112ceb7e9b31eee"
+        )
+        self.test_file_hash_encoded = (
+            "sha256=VkfwXsGJWJR9ModO63iPo5agXQurfBtx8RLOt-mzHu4"
+        )
+
+    def test_hash_file(self, tmpdir: Path) -> None:
+        self.prep(tmpdir)
+        h, length = hash_file(os.fspath(self.test_file))
+        assert length == self.test_file_len
+        assert h.hexdigest() == self.test_file_hash
+
+    def test_rehash(self, tmpdir: Path) -> None:
+        self.prep(tmpdir)
+        h, length = wheel.rehash(os.fspath(self.test_file))
+        assert length == str(self.test_file_len)
+        assert h == self.test_file_hash_encoded
+
+
+def test_get_console_script_specs_replaces_python_version(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    # Fake Python version.
+    monkeypatch.setattr(sys, "version_info", (10, 11))
+
+    entry_points = {
+        "pip": "real_pip",
+        "pip99": "whatever",
+        "pip99.88": "whatever",
+        "easy_install": "real_easy_install",
+        "easy_install-99.88": "whatever",
+        # The following shouldn't be replaced.
+        "not_pip_or_easy_install-99": "whatever",
+        "not_pip_or_easy_install-99.88": "whatever",
+    }
+    specs = get_console_script_specs(entry_points)
+    assert specs == 
+        "pip = real_pip",
+        "pip10 = real_pip",
+        "pip10.11 = real_pip",
+        "easy_install = real_easy_install",
+        "easy_install-10.11 = real_easy_install",
+        "not_pip_or_easy_install-99 = whatever",
+        "not_pip_or_easy_install-99.88 = whatever",
+

_service:tar_scm:pip-23.1.2.tar.gz/tests/unit/test_wheel_builder.py Added

@@ -0,0 +1,199 @@
+import logging
+import os
+from pathlib import Path
+from typing import Optional, cast
+
+import pytest
+
+from pip._internal import wheel_builder
+from pip._internal.models.link import Link
+from pip._internal.operations.build.wheel_legacy import format_command_result
+from pip._internal.req.req_install import InstallRequirement
+from pip._internal.vcs.git import Git
+from tests.lib import _create_test_package
+
+
+@pytest.mark.parametrize(
+    "s, expected",
+    
+        # Trivial.
+        ("pip-18.0", True),
+        # Ambiguous.
+        ("foo-2-2", True),
+        ("im-valid", True),
+        # Invalid.
+        ("invalid", False),
+        ("im_invalid", False),
+    ,
+)
+def test_contains_egg_info(s: str, expected: bool) -> None:
+    result = wheel_builder._contains_egg_info(s)
+    assert result == expected
+
+
+class ReqMock:
+    def __init__(
+        self,
+        name: str = "pendulum",
+        is_wheel: bool = False,
+        editable: bool = False,
+        link: OptionalLink = None,
+        constraint: bool = False,
+        source_dir: Optionalstr = "/tmp/pip-install-123/pendulum",
+        use_pep517: bool = True,
+        supports_pyproject_editable: bool = False,
+    ) -> None:
+        self.name = name
+        self.is_wheel = is_wheel
+        self.editable = editable
+        self.link = link
+        self.constraint = constraint
+        self.source_dir = source_dir
+        self.use_pep517 = use_pep517
+        self._supports_pyproject_editable = supports_pyproject_editable
+
+    def supports_pyproject_editable(self) -> bool:
+        return self._supports_pyproject_editable
+
+
+@pytest.mark.parametrize(
+    "req, expected",
+    
+        # We build, whether pep 517 is enabled or not.
+        (ReqMock(use_pep517=True), True),
+        (ReqMock(use_pep517=False), True),
+        # We don't build constraints.
+        (ReqMock(constraint=True), False),
+        # We don't build reqs that are already wheels.
+        (ReqMock(is_wheel=True), False),
+        # We build editables if the backend supports PEP 660.
+        (ReqMock(editable=True, use_pep517=False), False),
+        (
+            ReqMock(editable=True, use_pep517=True, supports_pyproject_editable=True),
+            True,
+        ),
+        (
+            ReqMock(editable=True, use_pep517=True, supports_pyproject_editable=False),
+            False,
+        ),
+        # We don't build if there is no source dir (whatever that means!).
+        (ReqMock(source_dir=None), False),
+        # By default (i.e. when binaries are allowed), VCS requirements
+        # should be built in install mode.
+        (
+            ReqMock(link=Link("git+https://g.c/org/repo"), use_pep517=True),
+            True,
+        ),
+        (
+            ReqMock(link=Link("git+https://g.c/org/repo"), use_pep517=False),
+            True,
+        ),
+    ,
+)
+def test_should_build_for_install_command(req: ReqMock, expected: bool) -> None:
+    should_build = wheel_builder.should_build_for_install_command(
+        cast(InstallRequirement, req),
+    )
+    assert should_build is expected
+
+
+@pytest.mark.parametrize(
+    "req, expected",
+    
+        (ReqMock(), True),
+        (ReqMock(constraint=True), False),
+        (ReqMock(is_wheel=True), False),
+        (ReqMock(editable=True, use_pep517=False), True),
+        (ReqMock(editable=True, use_pep517=True), True),
+        (ReqMock(source_dir=None), True),
+        (ReqMock(link=Link("git+https://g.c/org/repo")), True),
+    ,
+)
+def test_should_build_for_wheel_command(req: ReqMock, expected: bool) -> None:
+    should_build = wheel_builder.should_build_for_wheel_command(
+        cast(InstallRequirement, req)
+    )
+    assert should_build is expected
+
+
+@pytest.mark.parametrize(
+    "req, expected",
+    
+        (ReqMock(editable=True, use_pep517=False), False),
+        (ReqMock(editable=True, use_pep517=True), False),
+        (ReqMock(source_dir=None), False),
+        (ReqMock(link=Link("git+https://g.c/org/repo")), False),
+        (ReqMock(link=Link("https://g.c/dist.tgz")), False),
+        (ReqMock(link=Link("https://g.c/dist-2.0.4.tgz")), True),
+    ,
+)
+def test_should_cache(req: ReqMock, expected: bool) -> None:
+    assert wheel_builder._should_cache(cast(InstallRequirement, req)) is expected
+
+
+def test_should_cache_git_sha(tmpdir: Path) -> None:
+    repo_path = os.fspath(_create_test_package(tmpdir, name="mypkg"))
+    commit = Git.get_revision(repo_path)
+
+    # a link referencing a sha should be cached
+    url = "git+https://g.c/o/r@" + commit + "#egg=mypkg"
+    req = ReqMock(link=Link(url), source_dir=repo_path)
+    assert wheel_builder._should_cache(cast(InstallRequirement, req))
+
+    # a link not referencing a sha should not be cached
+    url = "git+https://g.c/o/r@master#egg=mypkg"
+    req = ReqMock(link=Link(url), source_dir=repo_path)
+    assert not wheel_builder._should_cache(cast(InstallRequirement, req))
+
+
+def test_format_command_result__INFO(caplog: pytest.LogCaptureFixture) -> None:
+    caplog.set_level(logging.INFO)
+    actual = format_command_result(
+        # Include an argument with a space to test argument quoting.
+        command_args="arg1", "second arg",
+        command_output="output line 1\noutput line 2\n",
+    )
+    assert actual.splitlines() == 
+        "Command arguments: arg1 'second arg'",
+        "Command output: use --verbose to show",
+    
+
+
+@pytest.mark.parametrize(
+    "command_output",
+    
+        # Test trailing newline.
+        "output line 1\noutput line 2\n",
+        # Test no trailing newline.
+        "output line 1\noutput line 2",
+    ,
+)
+def test_format_command_result__DEBUG(
+    caplog: pytest.LogCaptureFixture, command_output: str
+) -> None:
+    caplog.set_level(logging.DEBUG)
+    actual = format_command_result(
+        command_args="arg1", "arg2",
+        command_output=command_output,
+    )
+    assert actual.splitlines() == 
+        "Command arguments: arg1 arg2",
+        "Command output:",
+        "output line 1",
+        "output line 2",
+    
+
+
+@pytest.mark.parametrize("log_level", "DEBUG", "INFO")
+def test_format_command_result__empty_output(
+    caplog: pytest.LogCaptureFixture, log_level: str
+) -> None:
+    caplog.set_level(log_level)
+    actual = format_command_result(
+        command_args="arg1", "arg2",
+        command_output="",
+    )
+    assert actual.splitlines() == 
+        "Command arguments: arg1 arg2",
+        "Command output: None",
+

_service:tar_scm:pip-23.1.2.tar.gz/tools Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/ci Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/ci/New-RAMDisk.ps1 Added

@@ -0,0 +1,74 @@
+CmdletBinding()
+param(
+    Parameter(Mandatory=$true,
+    HelpMessage="Drive letter to use for the RAMDisk")
+    String$drive,
+    Parameter(HelpMessage="Size to allocate to the RAMDisk")
+    UInt64$size=1GB
+)
+
+$ErrorActionPreference = "Stop"
+Set-StrictMode -Version Latest
+
+Write-Output "Installing FS-iSCSITarget-Server"
+Install-WindowsFeature -Name FS-iSCSITarget-Server
+
+Write-Output "Starting MSiSCSI"
+Start-Service MSiSCSI
+$retry = 10
+do {
+    $service = Get-Service MSiSCSI
+    if ($service.Status -eq "Running") {
+        break;
+    }
+    $retry--
+    Start-Sleep -Milliseconds 500
+} until ($retry -eq 0)
+
+$service = Get-Service MSiSCSI
+if ($service.Status -ne "Running") {
+    throw "MSiSCSI is not running"
+}
+
+Write-Output "Configuring Firewall"
+Get-NetFirewallServiceFilter -Service MSiSCSI | Enable-NetFirewallRule
+
+Write-Output "Configuring RAMDisk"
+# Must use external-facing IP address, otherwise New-IscsiTargetPortal is
+# unable to connect.
+$ip = (
+    Get-NetIPAddress -AddressFamily IPv4 |
+    Where-Object {$_.IPAddress -ne "127.0.0.1"}
+)0.IPAddress
+if (
+    -not (Get-IscsiServerTarget -ComputerName localhost | Where-Object {$_.TargetName -eq "ramdisks"})
+) {
+    New-IscsiServerTarget `
+        -ComputerName localhost `
+        -TargetName ramdisks `
+        -InitiatorId IPAddress:$ip
+}
+
+$newVirtualDisk = New-IscsiVirtualDisk `
+    -ComputerName localhost `
+    -Path ramdisk:local$drive.vhdx `
+    -Size $size
+Add-IscsiVirtualDiskTargetMapping `
+    -ComputerName localhost `
+    -TargetName ramdisks `
+    -Path ramdisk:local$drive.vhdx
+
+Write-Output "Connecting to iSCSI"
+New-IscsiTargetPortal -TargetPortalAddress $ip
+Get-IscsiTarget | Where-Object {!$_.IsConnected} | Connect-IscsiTarget
+
+Write-Output "Configuring disk"
+$newDisk = Get-IscsiConnection |
+    Get-Disk |
+    Where-Object {$_.SerialNumber -eq $newVirtualDisk.SerialNumber}
+
+Set-Disk -InputObject $newDisk -IsOffline $false
+Initialize-Disk -InputObject $newDisk -PartitionStyle MBR
+New-Partition -InputObject $newDisk -UseMaximumSize -DriveLetter $drive
+
+Format-Volume -DriveLetter $drive -NewFileSystemLabel Temp -FileSystem NTFS

_service:tar_scm:pip-23.1.2.tar.gz/tools/news Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/news/template.rst Added

@@ -0,0 +1,45 @@
+{# This is a heavily customised version of towncrier's default template. #}
+
+{#-
+  Only render if there's any changes to show.
+
+  This serves as a compatibility "hack" since we render unreleased news entries
+  in our changelog with ``sphinxcontrib.towncrier``; which triggers a render even
+  when there's no entries to be rendered.
+#}
+{% if sections'' %}
+
+{#- Heading for individual version #}
+{{ versiondata.version }} ({{ versiondata.date }})
+{{ top_underline * ((versiondata.version + versiondata.date)|length + 3) }}
+{#
+
+  The following loop will run exactly once, with ``section_name == ""``.
+
+  This is due to the undocumented "sections" feature in towncrier.
+  See https://github.com/twisted/towncrier/issues/61.
+
+  We don't use this feature, and this template doesn't render the section
+  heading for that reason.
+#}
+{% for section_name, entries_by_type in sections.items() -%}
+{# Only show types with entries and ``showcontent = true``, using the order from pyproject.toml #}
+{% for type_ in definitions if (sectionssection_nametype_ and definitionstype_'showcontent') %}
+
+{# Heading for individual types #}
+{{ definitionstype_'name' }}
+{{ underlines0 * definitionstype_'name'|length }}
+{# This is the loop that generates individual entries #}
+{% for message, issue_reference in sectionssection_nametype_|dictsort(by='value') %}
+
+- {{ message }}
+  {%- if type_ not in "vendor", "process" %} ({{ issue_reference|sort|join(', ') }}){% endif %}
+{% endfor %}
+
+{% else %}
+{# We only have entries where the type has ``showcontent = true``. #}
+No significant changes.
+
+{% endfor -%}
+{% endfor -%}
+{% endif -%}

_service:tar_scm:pip-23.1.2.tar.gz/tools/protected_pip.py Added

@@ -0,0 +1,38 @@
+import os
+import pathlib
+import shutil
+import subprocess
+import sys
+from glob import glob
+from typing import Iterable, Union
+
+VIRTUAL_ENV = os.environ"VIRTUAL_ENV"
+TOX_PIP_DIR = os.path.join(VIRTUAL_ENV, "pip")
+
+
+def pip(args: IterableUnionstr, pathlib.Path) -> None:
+    # First things first, get a recent (stable) version of pip.
+    if not os.path.exists(TOX_PIP_DIR):
+        subprocess.check_call(
+            
+                sys.executable,
+                "-m",
+                "pip",
+                "--disable-pip-version-check",
+                "install",
+                "-t",
+                TOX_PIP_DIR,
+                "pip",
+            
+        )
+        shutil.rmtree(glob(os.path.join(TOX_PIP_DIR, "pip-*.dist-info"))0)
+    # And use that version.
+    pypath_env = os.environ.get("PYTHONPATH")
+    pypath = pypath_env.split(os.pathsep) if pypath_env is not None else 
+    pypath.insert(0, TOX_PIP_DIR)
+    os.environ"PYTHONPATH" = os.pathsep.join(pypath)
+    subprocess.check_call(sys.executable, "-m", "pip", *(os.fspath(a) for a in args))
+
+
+if __name__ == "__main__":
+    pip(sys.argv1:)

_service:tar_scm:pip-23.1.2.tar.gz/tools/release Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/release/__init__.py Added

@@ -0,0 +1,205 @@
+"""Helpers for release automation.
+
+These are written according to the order they are called in.
+"""
+
+import contextlib
+import os
+import pathlib
+import subprocess
+import tempfile
+from typing import Iterator, List, Optional, Set
+
+from nox.sessions import Session
+
+
+def get_version_from_arguments(session: Session) -> Optionalstr:
+    """Checks the arguments passed to `nox -s release`.
+
+    If there is only 1 argument that looks like a pip version, returns that.
+    Otherwise, returns None.
+    """
+    if len(session.posargs) != 1:
+        return None
+    version = session.posargs0
+
+    # We delegate to a script here, so that it can depend on packaging.
+    session.install("packaging")
+    cmd = 
+        os.path.join(session.bin, "python"),
+        "tools/release/check_version.py",
+        version,
+    
+    not_ok = subprocess.run(cmd).returncode
+    if not_ok:
+        return None
+
+    # All is good.
+    return version
+
+
+def modified_files_in_git(*args: str) -> int:
+    return subprocess.run(
+        "git", "diff", "--no-patch", "--exit-code", *args,
+        capture_output=True,
+    ).returncode
+
+
+def get_author_list() -> Liststr:
+    """Get the list of authors from Git commits."""
+    # subprocess because session.run doesn't give us stdout
+    # only use names in list of Authors
+    result = subprocess.run(
+        "git", "log", "--use-mailmap", "--format=%aN",
+        capture_output=True,
+        encoding="utf-8",
+    )
+
+    # Create a unique list.
+    authors = 
+    seen_authors: Setstr = set()
+    for author in result.stdout.splitlines():
+        author = author.strip()
+        if author.lower() not in seen_authors:
+            seen_authors.add(author.lower())
+            authors.append(author)
+
+    # Sort our list of Authors by their case insensitive name
+    return sorted(authors, key=lambda x: x.lower())
+
+
+def generate_authors(filename: str) -> None:
+    # Get our list of authors
+    authors = get_author_list()
+
+    # Write our authors to the AUTHORS file
+    with open(filename, "w", encoding="utf-8") as fp:
+        fp.write("\n".join(authors))
+        fp.write("\n")
+
+
+def commit_file(session: Session, filename: str, *, message: str) -> None:
+    session.run("git", "add", filename, external=True, silent=True)
+    session.run("git", "commit", "-m", message, external=True, silent=True)
+
+
+def generate_news(session: Session, version: str) -> None:
+    session.install("towncrier")
+    session.run("towncrier", "build", "--yes", "--version", version, silent=True)
+
+
+def update_version_file(version: str, filepath: str) -> None:
+    with open(filepath, encoding="utf-8") as f:
+        content = list(f)
+
+    file_modified = False
+    with open(filepath, "w", encoding="utf-8") as f:
+        for line in content:
+            if line.startswith("__version__ ="):
+                f.write(f'__version__ = "{version}"\n')
+                file_modified = True
+            else:
+                f.write(line)
+
+    assert file_modified, f"Version file {filepath} did not get modified"
+
+
+def create_git_tag(session: Session, tag_name: str, *, message: str) -> None:
+    session.run(
+        # fmt: off
+        "git", "tag", "-m", message, tag_name,
+        # fmt: on
+        external=True,
+        silent=True,
+    )
+
+
+def get_next_development_version(version: str) -> str:
+    is_beta = "b" in version.lower()
+
+    parts = version.split(".")
+    s_major, s_minor, *_ = parts
+
+    # We only permit betas.
+    if is_beta:
+        s_minor, _, s_dev_number = s_minor.partition("b")
+    else:
+        s_dev_number = "0"
+
+    major, minor = map(int, s_major, s_minor)
+
+    # Increase minor version number if we're not releasing a beta.
+    if not is_beta:
+        # We have at most 4 releases, starting with 0. Once we reach 3, we'd
+        # want to roll-over to the next year's release numbers.
+        if minor == 3:
+            major += 1
+            minor = 0
+        else:
+            minor += 1
+
+    return f"{major}.{minor}.dev" + s_dev_number
+
+
+def have_files_in_folder(folder_name: str) -> bool:
+    if not os.path.exists(folder_name):
+        return False
+    return bool(os.listdir(folder_name))
+
+
+@contextlib.contextmanager
+def workdir(
+    nox_session: Session,
+    dir_path: pathlib.Path,
+) -> Iteratorpathlib.Path:
+    """Temporarily chdir when entering CM and chdir back on exit."""
+    orig_dir = pathlib.Path.cwd()
+
+    nox_session.chdir(dir_path)
+    try:
+        yield dir_path
+    finally:
+        nox_session.chdir(orig_dir)
+
+
+@contextlib.contextmanager
+def isolated_temporary_checkout(
+    nox_session: Session,
+    target_ref: str,
+) -> Iteratorpathlib.Path:
+    """Make a clean checkout of a given version in tmp dir."""
+    with tempfile.TemporaryDirectory() as tmp_dir_path:
+        tmp_dir = pathlib.Path(tmp_dir_path)
+        git_checkout_dir = tmp_dir / f"pip-build-{target_ref}"
+        nox_session.run(
+            # fmt: off
+            "git", "clone",
+            "--depth", "1",
+            "--config", "core.autocrlf=false",
+            "--branch", str(target_ref),
+            "--",
+            ".", str(git_checkout_dir),
+            # fmt: on
+            external=True,
+            silent=True,
+        )
+
+        yield git_checkout_dir
+
+
+def get_git_untracked_files() -> Iteratorstr:
+    """List all local file paths that aren't tracked by Git."""
+    git_ls_files_cmd = (
+        # fmt: off
+        "git", "ls-files",
+        "--ignored", "--exclude-standard",
+        "--others", "--", ".",
+        # fmt: on
+    )
+    # session.run doesn't seem to return any output:
+    ls_files_out = subprocess.check_output(git_ls_files_cmd, text=True)
+    for file_name in ls_files_out.splitlines():
+        if file_name.strip():  # it's useless if empty
+            continue
+
+        yield file_name

_service:tar_scm:pip-23.1.2.tar.gz/tools/release/check_version.py Added

@@ -0,0 +1,43 @@
+"""Checks if the version is acceptable, as per this project's release process.
+"""
+
+import sys
+from datetime import datetime
+from typing import Optional
+
+from packaging.version import InvalidVersion, Version
+
+
+def is_this_a_good_version_number(string: str) -> Optionalstr:
+    try:
+        v = Version(string)
+    except InvalidVersion as e:
+        return str(e)
+
+    if v.local:
+        return "Nope. PyPI refuses local release versions."
+
+    if v.dev:
+        return "No development releases on PyPI. What are you even thinking?"
+
+    if v.pre and v.pre0 != "b":
+        return "Only beta releases are allowed. No alphas."
+
+    release = v.release
+    expected_major = datetime.now().year % 100
+
+    if len(release) not in 2, 3:
+        return "Not of the form: {0}.N or {0}.N.P".format(expected_major)
+
+    return None
+
+
+def main() -> None:
+    problem = is_this_a_good_version_number(sys.argv1)
+    if problem is not None:
+        print("ERROR:", problem)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

_service:tar_scm:pip-23.1.2.tar.gz/tools/update-rtd-redirects.py Added

@@ -0,0 +1,155 @@
+"""Update the 'exact' redirects on Read the Docs to match an in-tree file's contents.
+
+Relevant API reference: https://docs.readthedocs.io/en/stable/api/v3.html#redirects
+"""
+import operator
+import os
+import sys
+from pathlib import Path
+
+import httpx
+import rich
+import yaml
+
+try:
+    _TOKEN = os.environ"RTD_API_TOKEN"
+except KeyError:
+    rich.print(
+        "bolderror/: redNo API token provided. Please set `RTD_API_TOKEN`./",
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+RTD_API_HEADERS = {"Authorization": f"token {_TOKEN}"}
+RTD_API_BASE_URL = "https://readthedocs.org/api/v3/projects/pip/"
+REPO_ROOT = Path(__file__).resolve().parent.parent
+
+
+# --------------------------------------------------------------------------------------
+# Helpers
+# --------------------------------------------------------------------------------------
+def next_step(msg: str) -> None:
+    rich.print(f"> blue{msg}/")
+
+
+def log_response(response: httpx.Response) -> None:
+    request = response.request
+    rich.print(f"bold magenta{request.method}/ {request.url} -> {response}")
+
+
+def get_rtd_api() -> httpx.Client:
+    return httpx.Client(
+        headers=RTD_API_HEADERS,
+        base_url=RTD_API_BASE_URL,
+        event_hooks={"response": log_response},
+    )
+
+
+# --------------------------------------------------------------------------------------
+# Actual logic
+# --------------------------------------------------------------------------------------
+next_step("Loading local redirects from the yaml file.")
+
+with open(REPO_ROOT / ".readthedocs-custom-redirects.yml") as f:
+    local_redirects = yaml.safe_load(f)
+
+rich.print("Loaded local redirects!")
+for src, dst in sorted(local_redirects.items()):
+    rich.print(f"  yellow{src}/ --> {dst}")
+rich.print(f"{len(local_redirects)} entries.")
+
+
+next_step("Fetch redirects configured on RTD.")
+
+with get_rtd_api() as rtd_api:
+    response = rtd_api.get("redirects/")
+    response.raise_for_status()
+
+    rtd_redirects = response.json()
+
+for redirect in sorted(
+    rtd_redirects"results", key=operator.itemgetter("type", "from_url", "to_url")
+):
+    if redirect"type" != "exact":
+        rich.print(f"  magenta{redirect'type'}/")
+        continue
+
+    pk = redirect"pk"
+    src = redirect"from_url"
+    dst = redirect"to_url"
+    rich.print(f"  yellow{src}/ -({pk:^5})-> {dst}")
+
+rich.print(f"{rtd_redirects'count'} entries.")
+
+
+next_step("Compare and determine modifications.")
+
+redirects_to_remove: listint = 
+redirects_to_add: dictstr, str = {}
+
+for redirect in rtd_redirects"results":
+    if redirect"type" != "exact":
+        continue
+
+    rtd_src = redirect"from_url"
+    rtd_dst = redirect"to_url"
+    redirect_id = redirect"pk"
+
+    if rtd_src not in local_redirects:
+        redirects_to_remove.append(redirect_id)
+        continue
+
+    local_dst = local_redirectsrtd_src
+    if local_dst != rtd_dst:
+        redirects_to_remove.append(redirect_id)
+        redirects_to_addrtd_src = local_dst
+
+    del local_redirectsrtd_src
+
+for src, dst in sorted(local_redirects.items()):
+    redirects_to_addsrc = dst
+    del local_redirectssrc
+
+assert not local_redirects
+
+if not redirects_to_remove:
+    rich.print("Nothing to remove.")
+else:
+    rich.print(f"To remove: ({len(redirects_to_remove)} entries)")
+    for redirect_id in redirects_to_remove:
+        rich.print(" ", redirect_id)
+
+if not redirects_to_add:
+    rich.print("Nothing to add.")
+else:
+    rich.print(f"To add: ({len(redirects_to_add)} entries)")
+    for src, dst in redirects_to_add.items():
+        rich.print(f"  {src} --> {dst}")
+
+
+next_step("Update the RTD redirects.")
+
+if not (redirects_to_add or redirects_to_remove):
+    rich.print("greenNothing to do!/")
+    sys.exit(0)
+
+exit_code = 0
+with get_rtd_api() as rtd_api:
+    for redirect_id in redirects_to_remove:
+        response = rtd_api.delete(f"redirects/{redirect_id}/")
+        response.raise_for_status()
+        if response.status_code != 204:
+            rich.print("redThis might not have been removed correctly./")
+            exit_code = 1
+
+    for src, dst in redirects_to_add.items():
+        response = rtd_api.post(
+            "redirects/",
+            json={"from_url": src, "to_url": dst, "type": "exact"},
+        )
+        response.raise_for_status()
+        if response.status_code != 201:
+            rich.print("redThis might not have been added correctly./")
+            exit_code = 1
+
+sys.exit(exit_code)

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/certifi.patch Added

@@ -0,0 +1,42 @@
+diff --git a/src/pip/_vendor/certifi/core.py b/src/pip/_vendor/certifi/core.py
+index de028981b..c3e546604 100644
+--- a/src/pip/_vendor/certifi/core.py
++++ b/src/pip/_vendor/certifi/core.py
+@@ -33,13 +33,13 @@ def where() -> str:
+             # We also have to hold onto the actual context manager, because
+             # it will do the cleanup whenever it gets garbage collected, so
+             # we will also store that at the global level as well.
+-            _CACERT_CTX = as_file(files("certifi").joinpath("cacert.pem"))
++            _CACERT_CTX = as_file(files("pip._vendor.certifi").joinpath("cacert.pem"))
+             _CACERT_PATH = str(_CACERT_CTX.__enter__())
+ 
+         return _CACERT_PATH
+ 
+     def contents() -> str:
+-        return files("certifi").joinpath("cacert.pem").read_text(encoding="ascii")
++        return files("pip._vendor.certifi").joinpath("cacert.pem").read_text(encoding="ascii")
+ 
+ elif sys.version_info >= (3, 7):
+ 
+@@ -68,13 +68,13 @@ def where() -> str:
+             # We also have to hold onto the actual context manager, because
+             # it will do the cleanup whenever it gets garbage collected, so
+             # we will also store that at the global level as well.
+-            _CACERT_CTX = get_path("certifi", "cacert.pem")
++            _CACERT_CTX = get_path("pip._vendor.certifi", "cacert.pem")
+             _CACERT_PATH = str(_CACERT_CTX.__enter__())
+ 
+         return _CACERT_PATH
+ 
+     def contents() -> str:
+-        return read_text("certifi", "cacert.pem", encoding="ascii")
++        return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii")
+ 
+ else:
+     import os
+@@ -105,4 +105,4 @@ def where() -> str:
+         return os.path.join(f, "cacert.pem")
+ 
+     def contents() -> str:
+-        return read_text("certifi", "cacert.pem", encoding="ascii")
++        return read_text("pip._vendor.certifi", "cacert.pem", encoding="ascii")

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/pkg_resources.patch Added

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/pygments.patch Added

@@ -0,0 +1,59 @@
+This patch mainly handles tweaking imports into a form that can be transformed
+to import from the vendored namespace.
+
+diff --git a/src/pip/_vendor/pygments/cmdline.py b/src/pip/_vendor/pygments/cmdline.py
+index d9a0fdc8b..db6de0cd3 100644
+--- a/src/pip/_vendor/pygments/cmdline.py
++++ b/src/pip/_vendor/pygments/cmdline.py
+@@ -410,11 +410,11 @@ def is_only_option(opt):
+         outfile = UnclosingTextIOWrapper(outfile, encoding=fmter.encoding)
+         fmter.encoding = None
+         try:
+-            import colorama.initialise
++            import colorama.initialise as colorama_initialise
+         except ImportError:
+             pass
+         else:
+-            outfile = colorama.initialise.wrap_stream(
++            outfile = colorama_initialise.wrap_stream(
+                 outfile, convert=None, strip=None, autoreset=False, wrap=True)
+
+     # When using the LaTeX formatter and the option `escapeinside` is
+diff --git a/src/pip/_vendor/pygments/__main__.py b/src/pip/_vendor/pygments/__main__.py
+index c6e2517df..76255b525 100644
+--- a/src/pip/_vendor/pygments/__main__.py
++++ b/src/pip/_vendor/pygments/__main__.py
+@@ -9,9 +9,9 @@
+ """
+
+ import sys
+-import pygments.cmdline
++from pygments.cmdline import main
+
+ try:
+-    sys.exit(pygments.cmdline.main(sys.argv))
++    sys.exit(main(sys.argv))
+ except KeyboardInterrupt:
+     sys.exit(1)
+diff --git a/src/pip/_vendor/pygments/sphinxext.py b/src/pip/_vendor/pygments/sphinxext.py
+index 3ea2e36e1..23c19504c 100644
+--- a/src/pip/_vendor/pygments/sphinxext.py
++++ b/src/pip/_vendor/pygments/sphinxext.py
+@@ -91,7 +91,7 @@ class PygmentsDoc(Directive):
+         The columns are the lexer name, the extensions handled by this lexer
+         (or "None"), the aliases and a link to the lexer class."""
+         from pygments.lexers._mapping import LEXERS
+-        import pygments.lexers
++        from pygments.lexers import find_lexer_class
+         out = 
+ 
+         table = 
+@@ -102,7 +102,7 @@ class PygmentsDoc(Directive):
+             return name
+ 
+         for classname, data in sorted(LEXERS.items(), key=lambda x: x11.lower()):
+-            lexer_cls = pygments.lexers.find_lexer_class(data1)
++            lexer_cls = find_lexer_class(data1)
+             extensions = lexer_cls.filenames + lexer_cls.alias_filenames
+ 
+             table.append({

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/requests.patch Added

@@ -0,0 +1,145 @@
+diff --git a/src/pip/_vendor/requests/packages.py b/src/pip/_vendor/requests/packages.py
+index 77c45c9e..9582fa73 100644
+--- a/src/pip/_vendor/requests/packages.py
++++ b/src/pip/_vendor/requests/packages.py
+@@ -1,28 +1,16 @@
+ import sys
+ 
+-try:
+-    import chardet
+-except ImportError:
+-    import warnings
+-
+-    import charset_normalizer as chardet
+-
+-    warnings.filterwarnings("ignore", "Trying to detect", module="charset_normalizer")
+-
+ # This code exists for backwards compatibility reasons.
+ # I don't like it either. Just look the other way. :)
+ 
+-for package in ("urllib3", "idna"):
+-    locals()package = __import__(package)
++for package in ('urllib3', 'idna', 'chardet'):
++    vendored_package = "pip._vendor." + package
++    locals()package = __import__(vendored_package)
+     # This traversal is apparently necessary such that the identities are
+     # preserved (requests.packages.urllib3.* is urllib3.*)
+     for mod in list(sys.modules):
+-        if mod == package or mod.startswith(f"{package}."):
+-            sys.modulesf"requests.packages.{mod}" = sys.modulesmod
++        if mod == vendored_package or mod.startswith(vendored_package + '.'):
++            unprefixed_mod = modlen("pip._vendor."):
++            sys.modules'pip._vendor.requests.packages.' + unprefixed_mod = sys.modulesmod
+ 
+-target = chardet.__name__
+-for mod in list(sys.modules):
+-    if mod == target or mod.startswith(f"{target}."):
+-        target = target.replace(target, "chardet")
+-        sys.modulesf"requests.packages.{target}" = sys.modulesmod
+ # Kinda cool, though, right?
+
+diff --git a/src/pip/_vendor/requests/__init__.py b/src/pip/_vendor/requests/__init__.py
+index 7ac8e297..1e21e7e4 100644
+--- a/src/pip/_vendor/requests/__init__.py
++++ b/src/pip/_vendor/requests/__init__.py
+@@ -44,10 +44,7 @@ import urllib3
+ 
+ from .exceptions import RequestsDependencyWarning
+ 
+-try:
+-    from charset_normalizer import __version__ as charset_normalizer_version
+-except ImportError:
+-    charset_normalizer_version = None
++charset_normalizer_version = None
+ 
+ try:
+     from chardet import __version__ as chardet_version
+@@ -118,6 +115,11 @@ except (AssertionError, ValueError):
+ # if the standard library doesn't support SNI or the
+ # 'ssl' library isn't available.
+ try:
++    # Note: This logic prevents upgrading cryptography on Windows, if imported
++    #       as part of pip.
++    from pip._internal.utils.compat import WINDOWS
++    if not WINDOWS:
++        raise ImportError("pip internals: don't import cryptography on Windows")
+     try:
+         import ssl
+     except ImportError:
+
+diff --git a/src/pip/_vendor/requests/compat.py b/src/pip/_vendor/requests/compat.py
+index 6776163c..8ff49e46 100644
+--- a/src/pip/_vendor/requests/compat.py
++++ b/src/pip/_vendor/requests/compat.py
+@@ -7,10 +7,7 @@ between Python 2 and Python 3. It remains for backwards
+ compatibility until the next major version.
+ """
+ 
+-try:
+-    import chardet
+-except ImportError:
+-    import charset_normalizer as chardet
++import chardet
+ 
+ import sys
+ 
+@@ -27,19 +24,10 @@ is_py2 = _ver0 == 2
+ #: Python 3.x?
+ is_py3 = _ver0 == 3
+ 
+-# json/simplejson module import resolution
+-has_simplejson = False
+-try:
+-    import simplejson as json
+-
+-    has_simplejson = True
+-except ImportError:
+-    import json
+-
+-if has_simplejson:
+-    from simplejson import JSONDecodeError
+-else:
+-    from json import JSONDecodeError
++# Note: We've patched out simplejson support in pip because it prevents
++#       upgrading simplejson on Windows.
++import json
++from json import JSONDecodeError
+ 
+ # Keep OrderedDict for backwards compatibility.
+ from collections import OrderedDict
+diff --git a/src/pip/_vendor/requests/help.py b/src/pip/_vendor/requests/help.py
+index 8fbcd656..c5e9c19e 100644
+--- a/src/pip/_vendor/requests/help.py
++++ b/src/pip/_vendor/requests/help.py
+@@ -10,10 +10,7 @@ import urllib3
+ 
+ from . import __version__ as requests_version
+ 
+-try:
+-    import charset_normalizer
+-except ImportError:
+-    charset_normalizer = None
++charset_normalizer = None
+ 
+ try:
+     import chardet
+diff --git a/src/pip/_vendor/requests/certs.py b/src/pip/_vendor/requests/certs.py
+index 2743144b9..38696a1fb 100644
+--- a/src/pip/_vendor/requests/certs.py
++++ b/src/pip/_vendor/requests/certs.py
+@@ -11,7 +11,14 @@
+ environment, you can change the definition of where() to return a separately
+ packaged CA bundle.
+ """
+-from certifi import where
++
++import os
++
++if "_PIP_STANDALONE_CERT" not in os.environ:
++    from certifi import where
++else:
++    def where():
++        return os.environ"_PIP_STANDALONE_CERT"
+
+ if __name__ == "__main__":
+     print(where())

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/tenacity.patch Added

@@ -0,0 +1,34 @@
+diff --git a/src/pip/_vendor/tenacity/__init__.py b/src/pip/_vendor/tenacity/__init__.py
+index 88c28d2d6..086ad46e1 100644
+--- a/src/pip/_vendor/tenacity/__init__.py
++++ b/src/pip/_vendor/tenacity/__init__.py
+@@ -82,10 +82,12 @@ from .after import after_nothing  # noqa
+ from .before_sleep import before_sleep_log  # noqa
+ from .before_sleep import before_sleep_nothing  # noqa
+
+-try:
+-    import tornado
+-except ImportError:
+-    tornado = None
++# Replace a conditional import with a hard-coded None so that pip does
++# not attempt to use tornado even if it is present in the environment.
++# If tornado is non-None, tenacity will attempt to execute some code
++# that is sensitive to the version of tornado, which could break pip
++# if an old version is found.
++tornado = None  # type: ignore
+
+ if t.TYPE_CHECKING:
+     import types
+
+--- a/src/pip/_vendor/tenacity/__init__.py
++++ b/src/pip/_vendor/tenacity/__init__.py
+@@ -153,7 +153,7 @@ class RetryError(Exception):
+         self.last_attempt = last_attempt
+         super().__init__(last_attempt)
+ 
+-    def reraise(self) -> t.NoReturn:
++    def reraise(self) -> "t.NoReturn":
+         if self.last_attempt.failed:
+             raise self.last_attempt.result()
+         raise self
+

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/urllib3-disable-brotli.patch Added

@@ -0,0 +1,39 @@
+diff --git a/src/pip/_vendor/urllib3/response.py b/src/pip/_vendor/urllib3/response.py
+index 01f08eee8..4969b70e3 100644
+--- a/src/pip/_vendor/urllib3/response.py
++++ b/src/pip/_vendor/urllib3/response.py
+@@ -8,13 +8,7 @@
+ from socket import error as SocketError
+ from socket import timeout as SocketTimeout
+ 
+-try:
+-    try:
+-        import brotlicffi as brotli
+-    except ImportError:
+-        import brotli
+-except ImportError:
+-    brotli = None
++brotli = None
+ 
+ from . import util
+ from ._collections import HTTPHeaderDict
+diff --git a/src/pip/_vendor/urllib3/util/request.py b/src/pip/_vendor/urllib3/util/request.py
+index b574b081e..330766ef4 100644
+--- a/src/pip/_vendor/urllib3/util/request.py
++++ b/src/pip/_vendor/urllib3/util/request.py
+@@ -13,15 +13,6 @@
+ SKIPPABLE_HEADERS = frozenset("accept-encoding", "host", "user-agent")
+ 
+ ACCEPT_ENCODING = "gzip,deflate"
+-try:
+-    try:
+-        import brotlicffi as _unused_module_brotli  # noqa: F401
+-    except ImportError:
+-        import brotli as _unused_module_brotli  # noqa: F401
+-except ImportError:
+-    pass
+-else:
+-    ACCEPT_ENCODING += ",br"
+ 
+ _FAILEDTELL = object()
+

_service:tar_scm:pip-23.1.2.tar.gz/tools/vendoring/patches/urllib3.patch Added

@@ -0,0 +1,29 @@
+diff --git a/src/pip/_vendor/urllib3/contrib/securetransport.py b/src/pip/_vendor/urllib3/contrib/securetransport.py
+index b97555454..189132baa 100644
+--- a/src/pip/_vendor/urllib3/contrib/securetransport.py
++++ b/src/pip/_vendor/urllib3/contrib/securetransport.py
+@@ -19,8 +19,8 @@
+
+ To use this module, simply import and inject it::
+
+-    import urllib3.contrib.securetransport
+-    urllib3.contrib.securetransport.inject_into_urllib3()
++    import urllib3.contrib.securetransport as securetransport
++    securetransport.inject_into_urllib3()
+
+ Happy TLSing!
+
+diff --git a/src/pip/_vendor/urllib3/contrib/pyopenssl.py b/src/pip/_vendor/urllib3/contrib/pyopenssl.py
+index c43146279..4cded53f6 100644
+--- a/src/pip/_vendor/urllib3/contrib/pyopenssl.py
++++ b/src/pip/_vendor/urllib3/contrib/pyopenssl.py
+@@ -28,7 +28,7 @@
+ .. code-block:: python
+
+     try:
+-        import urllib3.contrib.pyopenssl
+-        urllib3.contrib.pyopenssl.inject_into_urllib3()
++        import urllib3.contrib.pyopenssl as pyopenssl
++        pyopenssl.inject_into_urllib3()
+     except ImportError:
+         pass