__init__.py

importos
importos.path
importpkgutil
importsys
importrunpy
importtempfile


__all__= ["version", "bootstrap"]
_PACKAGE_NAMES= ('setuptools', 'pip')
_SETUPTOOLS_VERSION="47.1.0"
_PIP_VERSION="22.0.4"
_PROJECTS= [
 ("setuptools", _SETUPTOOLS_VERSION, "py3"),
 ("pip", _PIP_VERSION, "py3"),
]


def_run_pip(args, additional_paths=None):
# Add our bundled software to the sys.path so we can import it
ifadditional_pathsisnotNone:
sys.path=additional_paths+sys.path

# Invoke pip as if it's the main module, and catch the exit.
backup_argv=sys.argv[:]
sys.argv[1:] =args
try:
# run_module() alters sys.modules and sys.argv, but restores them at exit
runpy.run_module("pip", run_name="__main__", alter_sys=True)
exceptSystemExitasexc:
returnexc.code
finally:
sys.argv[:] =backup_argv

raiseSystemError("pip did not exit, this should never happen")


defversion():
"""
 Returns a string specifying the bundled version of pip.
 """
return_PIP_VERSION

def_disable_pip_configuration_settings():
# We deliberately ignore all pip environment variables
# when invoking pip
# See http://bugs.python.org/issue19734 for details
keys_to_remove= [kforkinos.environifk.startswith("PIP_")]
forkinkeys_to_remove:
delos.environ[k]
# We also ignore the settings in the default pip configuration file
# See http://bugs.python.org/issue20053 for details
os.environ['PIP_CONFIG_FILE'] =os.devnull


defbootstrap(*, root=None, upgrade=False, user=False,
altinstall=False, default_pip=False,
verbosity=0):
"""
 Bootstrap pip into the current Python installation (or the given root
 directory).

 Note that calling this function will alter both sys.path and os.environ.
 """
# Discard the return value
_bootstrap(root=root, upgrade=upgrade, user=user,
altinstall=altinstall, default_pip=default_pip,
verbosity=verbosity)


def_bootstrap(*, root=None, upgrade=False, user=False,
altinstall=False, default_pip=False,
verbosity=0):
"""
 Bootstrap pip into the current Python installation (or the given root
 directory). Returns pip command status code.

 Note that calling this function will alter both sys.path and os.environ.
 """
ifaltinstallanddefault_pip:
raiseValueError("Cannot use altinstall and default_pip together")

_disable_pip_configuration_settings()

# By default, installing pip and setuptools installs all of the
# following scripts (X.Y == running Python version):
#
# pip, pipX, pipX.Y, easy_install, easy_install-X.Y
#
# pip 1.5+ allows ensurepip to request that some of those be left out
ifaltinstall:
# omit pip, pipX and easy_install
os.environ["ENSUREPIP_OPTIONS"] ="altinstall"
elifnotdefault_pip:
# omit pip and easy_install
os.environ["ENSUREPIP_OPTIONS"] ="install"

withtempfile.TemporaryDirectory() astmpdir:
# Put our bundled wheels into a temporary directory and construct the
# additional paths that need added to sys.path
additional_paths= []
forproject, version, py_tagin_PROJECTS:
wheel_name="{}-{}-{}-none-any.whl".format(project, version, py_tag)
whl=pkgutil.get_data(
"ensurepip",
"_bundled/{}".format(wheel_name),
 )
withopen(os.path.join(tmpdir, wheel_name), "wb") asfp:
fp.write(whl)

additional_paths.append(os.path.join(tmpdir, wheel_name))

# Construct the arguments to be passed to the pip command
args= ["install", "--no-cache-dir", "--no-index", "--find-links", tmpdir]
ifroot:
args+= ["--root", root]
ifupgrade:
args+= ["--upgrade"]
ifuser:
args+= ["--user"]
ifverbosity:
args+= ["-"+"v"*verbosity]

return_run_pip(args+ [p[0] forpin_PROJECTS], additional_paths)

def_uninstall_helper(*, verbosity=0):
"""Helper to support a clean default uninstall process on Windows

 Note that calling this function may alter os.environ.
 """
# Nothing to do if pip was never installed, or has been removed
try:
importpip
exceptImportError:
return

# If the pip version doesn't match the bundled one, leave it alone
ifpip.__version__!=_PIP_VERSION:
msg= ("ensurepip will only uninstall a matching version "
"({!r} installed, {!r} bundled)")
print(msg.format(pip.__version__, _PIP_VERSION), file=sys.stderr)
return

_disable_pip_configuration_settings()

# Construct the arguments to be passed to the pip command
args= ["uninstall", "-y", "--disable-pip-version-check"]
ifverbosity:
args+= ["-"+"v"*verbosity]

return_run_pip(args+ [p[0] forpinreversed(_PROJECTS)])


def_main(argv=None):
importargparse
parser=argparse.ArgumentParser(prog="python -m ensurepip")
parser.add_argument(
"--version",
action="version",
version="pip {}".format(version()),
help="Show the version of pip that is bundled with this Python.",
 )
parser.add_argument(
"-v", "--verbose",
action="count",
default=0,
dest="verbosity",
help=("Give more output. Option is additive, and can be used up to 3 "
"times."),
 )
parser.add_argument(
"-U", "--upgrade",
action="store_true",
default=False,
help="Upgrade pip and dependencies, even if already installed.",
 )
parser.add_argument(
"--user",
action="store_true",
default=False,
help="Install using the user scheme.",
 )
parser.add_argument(
"--root",
default=None,
help="Install everything relative to this alternate root directory.",
 )
parser.add_argument(
"--altinstall",
action="store_true",
default=False,
help=("Make an alternate install, installing only the X.Y versioned "
"scripts (Default: pipX, pipX.Y, easy_install-X.Y)."),
 )
parser.add_argument(
"--default-pip",
action="store_true",
default=False,
help=("Make a default pip install, installing the unqualified pip "
"and easy_install in addition to the versioned scripts."),
 )

args=parser.parse_args(argv)

return_bootstrap(
root=args.root,
upgrade=args.upgrade,
user=args.user,
verbosity=args.verbosity,
altinstall=args.altinstall,
default_pip=args.default_pip,
 )