| from __future__ import absolute_import |
| |
| import logging |
| import os |
| |
| from pip._internal.cli import cmdoptions |
| from pip._internal.cli.cmdoptions import make_target_python |
| from pip._internal.cli.req_command import RequirementCommand, with_cleanup |
| from pip._internal.cli.status_codes import SUCCESS |
| from pip._internal.req.req_tracker import get_requirement_tracker |
| from pip._internal.utils.misc import ensure_dir, normalize_path, write_output |
| from pip._internal.utils.temp_dir import TempDirectory |
| from pip._internal.utils.typing import MYPY_CHECK_RUNNING |
| |
| if MYPY_CHECK_RUNNING: |
| from optparse import Values |
| from typing import List |
| |
| logger = logging.getLogger(__name__) |
| |
| |
| class DownloadCommand(RequirementCommand): |
| """ |
| Download packages from: |
| |
| - PyPI (and other indexes) using requirement specifiers. |
| - VCS project urls. |
| - Local project directories. |
| - Local or remote source archives. |
| |
| pip also supports downloading from "requirements files", which provide |
| an easy way to specify a whole environment to be downloaded. |
| """ |
| |
| usage = """ |
| %prog [options] <requirement specifier> [package-index-options] ... |
| %prog [options] -r <requirements file> [package-index-options] ... |
| %prog [options] <vcs project url> ... |
| %prog [options] <local project path> ... |
| %prog [options] <archive url/path> ...""" |
| |
| def add_options(self): |
| # type: () -> None |
| self.cmd_opts.add_option(cmdoptions.constraints()) |
| self.cmd_opts.add_option(cmdoptions.requirements()) |
| self.cmd_opts.add_option(cmdoptions.build_dir()) |
| self.cmd_opts.add_option(cmdoptions.no_deps()) |
| self.cmd_opts.add_option(cmdoptions.global_options()) |
| self.cmd_opts.add_option(cmdoptions.no_binary()) |
| self.cmd_opts.add_option(cmdoptions.only_binary()) |
| self.cmd_opts.add_option(cmdoptions.prefer_binary()) |
| self.cmd_opts.add_option(cmdoptions.src()) |
| self.cmd_opts.add_option(cmdoptions.pre()) |
| self.cmd_opts.add_option(cmdoptions.require_hashes()) |
| self.cmd_opts.add_option(cmdoptions.progress_bar()) |
| self.cmd_opts.add_option(cmdoptions.no_build_isolation()) |
| self.cmd_opts.add_option(cmdoptions.use_pep517()) |
| self.cmd_opts.add_option(cmdoptions.no_use_pep517()) |
| |
| self.cmd_opts.add_option( |
| '-d', '--dest', '--destination-dir', '--destination-directory', |
| dest='download_dir', |
| metavar='dir', |
| default=os.curdir, |
| help=("Download packages into <dir>."), |
| ) |
| |
| cmdoptions.add_target_python_options(self.cmd_opts) |
| |
| index_opts = cmdoptions.make_option_group( |
| cmdoptions.index_group, |
| self.parser, |
| ) |
| |
| self.parser.insert_option_group(0, index_opts) |
| self.parser.insert_option_group(0, self.cmd_opts) |
| |
| @with_cleanup |
| def run(self, options, args): |
| # type: (Values, List[str]) -> int |
| |
| options.ignore_installed = True |
| # editable doesn't really make sense for `pip download`, but the bowels |
| # of the RequirementSet code require that property. |
| options.editables = [] |
| |
| cmdoptions.check_dist_restriction(options) |
| |
| options.download_dir = normalize_path(options.download_dir) |
| |
| ensure_dir(options.download_dir) |
| |
| session = self.get_default_session(options) |
| |
| target_python = make_target_python(options) |
| finder = self._build_package_finder( |
| options=options, |
| session=session, |
| target_python=target_python, |
| ) |
| build_delete = (not (options.no_clean or options.build_dir)) |
| |
| req_tracker = self.enter_context(get_requirement_tracker()) |
| |
| directory = TempDirectory( |
| options.build_dir, |
| delete=build_delete, |
| kind="download", |
| globally_managed=True, |
| ) |
| |
| reqs = self.get_requirements(args, options, finder, session) |
| |
| preparer = self.make_requirement_preparer( |
| temp_build_dir=directory, |
| options=options, |
| req_tracker=req_tracker, |
| session=session, |
| finder=finder, |
| download_dir=options.download_dir, |
| use_user_site=False, |
| ) |
| |
| resolver = self.make_resolver( |
| preparer=preparer, |
| finder=finder, |
| options=options, |
| py_version_info=options.python_version, |
| ) |
| |
| self.trace_basic_info(finder) |
| |
| requirement_set = resolver.resolve( |
| reqs, check_supported_wheels=True |
| ) |
| |
| downloaded = ' '.join([req.name # type: ignore |
| for req in requirement_set.requirements.values() |
| if req.successfully_downloaded]) |
| if downloaded: |
| write_output('Successfully downloaded %s', downloaded) |
| |
| return SUCCESS |