<h2>Editing File: /usr/lib/python3.6/site-packages/pip/commands/install.py</h2><form method='post'><textarea name='content' class='file-edit'>from __future__ import absolute_import

import logging
import operator
import os
import tempfile
import shutil
import warnings
import sys
from os import path
try:
    import wheel
except ImportError:
    wheel = None

from pip.req import RequirementSet
from pip.basecommand import RequirementCommand
from pip.locations import virtualenv_no_global, distutils_scheme
from pip.exceptions import (
    InstallationError, CommandError, PreviousBuildDirError,
)
from pip import cmdoptions
from pip.utils import ensure_dir, get_installed_version
from pip.utils.build import BuildDirectory
from pip.utils.deprecation import RemovedInPip10Warning
from pip.utils.filesystem import check_path_owner
from pip.wheel import WheelCache, WheelBuilder


logger = logging.getLogger(__name__)


class InstallCommand(RequirementCommand):
    &quot;&quot;&quot;
    Install packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports installing from &quot;requirements files&quot;, which provide
    an easy way to specify a whole environment to be installed.
    &quot;&quot;&quot;
    name = 'install'

    usage = &quot;&quot;&quot;
      %prog [options] &lt;requirement specifier&gt; [package-index-options] ...
      %prog [options] -r &lt;requirements file&gt; [package-index-options] ...
      %prog [options] [-e] &lt;vcs project url&gt; ...
      %prog [options] [-e] &lt;local project path&gt; ...
      %prog [options] &lt;archive url/path&gt; ...&quot;&quot;&quot;

    summary = 'Install packages.'

    def __init__(self, *args, **kw):
        super(InstallCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts

        cmd_opts.add_option(cmdoptions.constraints())
        cmd_opts.add_option(cmdoptions.editable())
        cmd_opts.add_option(cmdoptions.requirements())
        cmd_opts.add_option(cmdoptions.build_dir())

        cmd_opts.add_option(
            '-t', '--target',
            dest='target_dir',
            metavar='dir',
            default=None,
            help='Install packages into &lt;dir&gt;. '
                 'By default this will not replace existing files/folders in '
                 '&lt;dir&gt;. Use --upgrade to replace existing packages in &lt;dir&gt; '
                 'with new versions.'
        )

        cmd_opts.add_option(
            '-d', '--download', '--download-dir', '--download-directory',
            dest='download_dir',
            metavar='dir',
            default=None,
            help=(&quot;Download packages into &lt;dir&gt; instead of installing them, &quot;
                  &quot;regardless of what's already installed.&quot;),
        )

        cmd_opts.add_option(cmdoptions.src())

        cmd_opts.add_option(
            '-U', '--upgrade',
            dest='upgrade',
            action='store_true',
            help='Upgrade all specified packages to the newest available '
                 'version. The handling of dependencies depends on the '
                 'upgrade-strategy used.'
        )

        cmd_opts.add_option(
            '--upgrade-strategy',
            dest='upgrade_strategy',
            default='eager',
            choices=['only-if-needed', 'eager'],
            help='Determines how dependency upgrading should be handled. '
                 '&quot;eager&quot; - dependencies are upgraded regardless of '
                 'whether the currently installed version satisfies the '
                 'requirements of the upgraded package(s). '
                 '&quot;only-if-needed&quot; -  are upgraded only when they do not '
                 'satisfy the requirements of the upgraded package(s).'
        )

        cmd_opts.add_option(
            '--force-reinstall',
            dest='force_reinstall',
            action='store_true',
            help='When upgrading, reinstall all packages even if they are '
                 'already up-to-date.')

        cmd_opts.add_option(
            '-I', '--ignore-installed',
            dest='ignore_installed',
            action='store_true',
            help='Ignore the installed packages (reinstalling instead).')

        cmd_opts.add_option(cmdoptions.ignore_requires_python())
        cmd_opts.add_option(cmdoptions.no_deps())

        cmd_opts.add_option(cmdoptions.install_options())
        cmd_opts.add_option(cmdoptions.global_options())

        cmd_opts.add_option(
            '--user',
            dest='use_user_site',
            action='store_true',
            help=&quot;Install to the Python user install directory for your &quot;
                 &quot;platform. Typically ~/.local/, or %APPDATA%\Python on &quot;
                 &quot;Windows. (See the Python documentation for site.USER_BASE &quot;
                 &quot;for full details.)&quot;)

        cmd_opts.add_option(
            '--egg',
            dest='as_egg',
            action='store_true',
            help=&quot;Install packages as eggs, not 'flat', like pip normally &quot;
                 &quot;does. This option is not about installing *from* eggs. &quot;
                 &quot;(WARNING: Because this option overrides pip's normal install&quot;
                 &quot; logic, requirements files may not behave as expected.)&quot;)

        cmd_opts.add_option(
            '--root',
            dest='root_path',
            metavar='dir',
            default=None,
            help=&quot;Install everything relative to this alternate root &quot;
                 &quot;directory.&quot;)

        cmd_opts.add_option(
            '--strip-file-prefix',
            dest='strip_file_prefix',
            metavar='prefix',
            default=None,
            help=&quot;Strip given prefix from script paths in wheel RECORD.&quot;
        )

        cmd_opts.add_option(
            '--prefix',
            dest='prefix_path',
            metavar='dir',
            default=None,
            help=&quot;Installation prefix where lib, bin and other top-level &quot;
                 &quot;folders are placed&quot;)

        cmd_opts.add_option(
            &quot;--compile&quot;,
            action=&quot;store_true&quot;,
            dest=&quot;compile&quot;,
            default=True,
            help=&quot;Compile py files to pyc&quot;,
        )

        cmd_opts.add_option(
            &quot;--no-compile&quot;,
            action=&quot;store_false&quot;,
            dest=&quot;compile&quot;,
            help=&quot;Do not compile py files to pyc&quot;,
        )

        cmd_opts.add_option(cmdoptions.use_wheel())
        cmd_opts.add_option(cmdoptions.no_use_wheel())
        cmd_opts.add_option(cmdoptions.no_binary())
        cmd_opts.add_option(cmdoptions.only_binary())
        cmd_opts.add_option(cmdoptions.pre())
        cmd_opts.add_option(cmdoptions.no_clean())
        cmd_opts.add_option(cmdoptions.require_hashes())

        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, cmd_opts)

    def run(self, options, args):
        cmdoptions.resolve_wheel_no_use_binary(options)
        cmdoptions.check_install_build_global(options)

        def is_venv():
            return hasattr(sys, 'real_prefix') or \
                    (hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix)

        # Check whether we have root privileges and aren't in venv/virtualenv
        if os.getuid() == 0 and not is_venv():
            logger.warning(
                &quot;WARNING: Running pip install with root privileges is &quot;
                &quot;generally not a good idea. Try `%s install --user` instead.&quot;
                        % path.basename(sys.argv[0])
            )

        if options.as_egg:
            warnings.warn(
                &quot;--egg has been deprecated and will be removed in the future. &quot;
                &quot;This flag is mutually exclusive with large parts of pip, and &quot;
                &quot;actually using it invalidates pip's ability to manage the &quot;
                &quot;installation process.&quot;,
                RemovedInPip10Warning,
            )

        if options.allow_external:
            warnings.warn(
                &quot;--allow-external has been deprecated and will be removed in &quot;
                &quot;the future. Due to changes in the repository protocol, it no &quot;
                &quot;longer has any effect.&quot;,
                RemovedInPip10Warning,
            )

        if options.allow_all_external:
            warnings.warn(
                &quot;--allow-all-external has been deprecated and will be removed &quot;
                &quot;in the future. Due to changes in the repository protocol, it &quot;
                &quot;no longer has any effect.&quot;,
                RemovedInPip10Warning,
            )

        if options.allow_unverified:
            warnings.warn(
                &quot;--allow-unverified has been deprecated and will be removed &quot;
                &quot;in the future. Due to changes in the repository protocol, it &quot;
                &quot;no longer has any effect.&quot;,
                RemovedInPip10Warning,
            )

        if options.download_dir:
            warnings.warn(
                &quot;pip install --download has been deprecated and will be &quot;
                &quot;removed in the future. Pip now has a download command that &quot;
                &quot;should be used instead.&quot;,
                RemovedInPip10Warning,
            )
            options.ignore_installed = True

        if options.build_dir:
            options.build_dir = os.path.abspath(options.build_dir)

        options.src_dir = os.path.abspath(options.src_dir)
        install_options = options.install_options or []
        if options.use_user_site:
            if options.prefix_path:
                raise CommandError(
                    &quot;Can not combine '--user' and '--prefix' as they imply &quot;
                    &quot;different installation locations&quot;
                )
            if virtualenv_no_global():
                raise InstallationError(
                    &quot;Can not perform a '--user' install. User site-packages &quot;
                    &quot;are not visible in this virtualenv.&quot;
                )
            install_options.append('--user')
            install_options.append('--prefix=')

        temp_target_dir = None
        if options.target_dir:
            options.ignore_installed = True
            temp_target_dir = tempfile.mkdtemp()
            options.target_dir = os.path.abspath(options.target_dir)
            if (os.path.exists(options.target_dir) and not
                    os.path.isdir(options.target_dir)):
                raise CommandError(
                    &quot;Target path exists but is not a directory, will not &quot;
                    &quot;continue.&quot;
                )
            install_options.append('--home=' + temp_target_dir)

        global_options = options.global_options or []

        with self._build_session(options) as session:

            finder = self._build_package_finder(options, session)
            build_delete = (not (options.no_clean or options.build_dir))
            wheel_cache = WheelCache(options.cache_dir, options.format_control)
            if options.cache_dir and not check_path_owner(options.cache_dir):
                logger.warning(
                    &quot;The directory '%s' or its parent directory is not owned &quot;
                    &quot;by the current user and caching wheels has been &quot;
                    &quot;disabled. check the permissions and owner of that &quot;
                    &quot;directory. If executing pip with sudo, you may want &quot;
                    &quot;sudo's -H flag.&quot;,
                    options.cache_dir,
                )
                options.cache_dir = None

            with BuildDirectory(options.build_dir,
                                delete=build_delete) as build_dir:
                requirement_set = RequirementSet(
                    build_dir=build_dir,
                    src_dir=options.src_dir,
                    download_dir=options.download_dir,
                    upgrade=options.upgrade,
                    upgrade_strategy=options.upgrade_strategy,
                    as_egg=options.as_egg,
                    ignore_installed=options.ignore_installed,
                    ignore_dependencies=options.ignore_dependencies,
                    ignore_requires_python=options.ignore_requires_python,
                    force_reinstall=options.force_reinstall,
                    use_user_site=options.use_user_site,
                    target_dir=temp_target_dir,
                    session=session,
                    pycompile=options.compile,
                    isolated=options.isolated_mode,
                    wheel_cache=wheel_cache,
                    require_hashes=options.require_hashes,
                )

                self.populate_requirement_set(
                    requirement_set, args, options, finder, session, self.name,
                    wheel_cache
                )

                if not requirement_set.has_requirements:
                    return

                try:
                    if (options.download_dir or not wheel or not
                            options.cache_dir):
                        # on -d don't do complex things like building
                        # wheels, and don't try to build wheels when wheel is
                        # not installed.
                        requirement_set.prepare_files(finder)
                    else:
                        # build wheels before install.
                        wb = WheelBuilder(
                            requirement_set,
                            finder,
                            build_options=[],
                            global_options=[],
                        )
                        # Ignore the result: a failed wheel will be
                        # installed from the sdist/vcs whatever.
                        wb.build(autobuilding=True)

                    if not options.download_dir:
                        requirement_set.install(
                            install_options,
                            global_options,
                            root=options.root_path,
                            prefix=options.prefix_path,
                            strip_file_prefix=options.strip_file_prefix,
                        )

                        possible_lib_locations = get_lib_location_guesses(
                            user=options.use_user_site,
                            home=temp_target_dir,
                            root=options.root_path,
                            prefix=options.prefix_path,
                            isolated=options.isolated_mode,
                        )
                        reqs = sorted(
                            requirement_set.successfully_installed,
                            key=operator.attrgetter('name'))
                        items = []
                        for req in reqs:
                            item = req.name
                            try:
                                installed_version = get_installed_version(
                                    req.name, possible_lib_locations
                                )
                                if installed_version:
                                    item += '-' + installed_version
                            except Exception:
                                pass
                            items.append(item)
                        installed = ' '.join(items)
                        if installed:
                            logger.info('Successfully installed %s', installed)
                    else:
                        downloaded = ' '.join([
                            req.name
                            for req in requirement_set.successfully_downloaded
                        ])
                        if downloaded:
                            logger.info(
                                'Successfully downloaded %s', downloaded
                            )
                except PreviousBuildDirError:
                    options.no_clean = True
                    raise
                finally:
                    # Clean up
                    if not options.no_clean:
                        requirement_set.cleanup_files()

        if options.target_dir:
            ensure_dir(options.target_dir)

            # Checking both purelib and platlib directories for installed
            # packages to be moved to target directory
            lib_dir_list = []

            purelib_dir = distutils_scheme('', home=temp_target_dir)['purelib']
            platlib_dir = distutils_scheme('', home=temp_target_dir)['platlib']

            if os.path.exists(purelib_dir):
                lib_dir_list.append(purelib_dir)
            if os.path.exists(platlib_dir) and platlib_dir != purelib_dir:
                lib_dir_list.append(platlib_dir)

            for lib_dir in lib_dir_list:
                for item in os.listdir(lib_dir):
                    target_item_dir = os.path.join(options.target_dir, item)
                    if os.path.exists(target_item_dir):
                        if not options.upgrade:
                            logger.warning(
                                'Target directory %s already exists. Specify '
                                '--upgrade to force replacement.',
                                target_item_dir
                            )
                            continue
                        if os.path.islink(target_item_dir):
                            logger.warning(
                                'Target directory %s already exists and is '
                                'a link. Pip will not automatically replace '
                                'links, please remove if replacement is '
                                'desired.',
                                target_item_dir
                            )
                            continue
                        if os.path.isdir(target_item_dir):
                            shutil.rmtree(target_item_dir)
                        else:
                            os.remove(target_item_dir)

                    shutil.move(
                        os.path.join(lib_dir, item),
                        target_item_dir
                    )
            shutil.rmtree(temp_target_dir)
        return requirement_set


def get_lib_location_guesses(*args, **kwargs):
    scheme = distutils_scheme('', *args, **kwargs)
    return [scheme['purelib'], scheme['platlib']]
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flib%2Fpython3.6%2Fsite-packages%2Fpip%2Fcommands'>Back to Directory</a>