<h2>Editing File: /usr/lib/python2.7/site-packages/pip/cmdoptions.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;
shared options and groups

The principle here is to define options once, but *not* instantiate them
globally. One reason being that options with action='append' can carry state
between parses. pip parses general options twice internally, and shouldn't
pass on state. To be consistent, all options will follow this design.

&quot;&quot;&quot;
from __future__ import absolute_import

from functools import partial
from optparse import OptionGroup, SUPPRESS_HELP, Option
import warnings

from pip.index import (
    FormatControl, fmt_ctl_handle_mutual_exclude, fmt_ctl_no_binary,
    fmt_ctl_no_use_wheel)
from pip.models import PyPI
from pip.locations import USER_CACHE_DIR, src_prefix
from pip.utils.hashes import STRONG_HASHES


def make_option_group(group, parser):
    &quot;&quot;&quot;
    Return an OptionGroup object
    group  -- assumed to be dict with 'name' and 'options' keys
    parser -- an optparse Parser
    &quot;&quot;&quot;
    option_group = OptionGroup(parser, group['name'])
    for option in group['options']:
        option_group.add_option(option())
    return option_group


def resolve_wheel_no_use_binary(options):
    if not options.use_wheel:
        control = options.format_control
        fmt_ctl_no_use_wheel(control)


def check_install_build_global(options, check_options=None):
    &quot;&quot;&quot;Disable wheels if per-setup.py call options are set.

    :param options: The OptionParser options to update.
    :param check_options: The options to check, if not supplied defaults to
        options.
    &quot;&quot;&quot;
    if check_options is None:
        check_options = options

    def getname(n):
        return getattr(check_options, n, None)
    names = [&quot;build_options&quot;, &quot;global_options&quot;, &quot;install_options&quot;]
    if any(map(getname, names)):
        control = options.format_control
        fmt_ctl_no_binary(control)
        warnings.warn(
            'Disabling all use of wheels due to the use of --build-options '
            '/ --global-options / --install-options.', stacklevel=2)


###########
# options #
###########

help_ = partial(
    Option,
    '-h', '--help',
    dest='help',
    action='help',
    help='Show help.')

isolated_mode = partial(
    Option,
    &quot;--isolated&quot;,
    dest=&quot;isolated_mode&quot;,
    action=&quot;store_true&quot;,
    default=False,
    help=(
        &quot;Run pip in an isolated mode, ignoring environment variables and user &quot;
        &quot;configuration.&quot;
    ),
)

require_virtualenv = partial(
    Option,
    # Run only if inside a virtualenv, bail if not.
    '--require-virtualenv', '--require-venv',
    dest='require_venv',
    action='store_true',
    default=False,
    help=SUPPRESS_HELP)

verbose = partial(
    Option,
    '-v', '--verbose',
    dest='verbose',
    action='count',
    default=0,
    help='Give more output. Option is additive, and can be used up to 3 times.'
)

version = partial(
    Option,
    '-V', '--version',
    dest='version',
    action='store_true',
    help='Show version and exit.')

quiet = partial(
    Option,
    '-q', '--quiet',
    dest='quiet',
    action='count',
    default=0,
    help=('Give less output. Option is additive, and can be used up to 3'
          ' times (corresponding to WARNING, ERROR, and CRITICAL logging'
          ' levels).')
)

log = partial(
    Option,
    &quot;--log&quot;, &quot;--log-file&quot;, &quot;--local-log&quot;,
    dest=&quot;log&quot;,
    metavar=&quot;path&quot;,
    help=&quot;Path to a verbose appending log.&quot;
)

no_input = partial(
    Option,
    # Don't ask for input
    '--no-input',
    dest='no_input',
    action='store_true',
    default=False,
    help=SUPPRESS_HELP)

proxy = partial(
    Option,
    '--proxy',
    dest='proxy',
    type='str',
    default='',
    help=&quot;Specify a proxy in the form [user:passwd@]proxy.server:port.&quot;)

retries = partial(
    Option,
    '--retries',
    dest='retries',
    type='int',
    default=5,
    help=&quot;Maximum number of retries each connection should attempt &quot;
         &quot;(default %default times).&quot;)

timeout = partial(
    Option,
    '--timeout', '--default-timeout',
    metavar='sec',
    dest='timeout',
    type='float',
    default=15,
    help='Set the socket timeout (default %default seconds).')

default_vcs = partial(
    Option,
    # The default version control system for editables, e.g. 'svn'
    '--default-vcs',
    dest='default_vcs',
    type='str',
    default='',
    help=SUPPRESS_HELP)

skip_requirements_regex = partial(
    Option,
    # A regex to be used to skip requirements
    '--skip-requirements-regex',
    dest='skip_requirements_regex',
    type='str',
    default='',
    help=SUPPRESS_HELP)


def exists_action():
    return Option(
        # Option when path already exist
        '--exists-action',
        dest='exists_action',
        type='choice',
        choices=['s', 'i', 'w', 'b', 'a'],
        default=[],
        action='append',
        metavar='action',
        help=&quot;Default action when a path already exists: &quot;
        &quot;(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.&quot;)


cert = partial(
    Option,
    '--cert',
    dest='cert',
    type='str',
    metavar='path',
    help=&quot;Path to alternate CA bundle.&quot;)

client_cert = partial(
    Option,
    '--client-cert',
    dest='client_cert',
    type='str',
    default=None,
    metavar='path',
    help=&quot;Path to SSL client certificate, a single file containing the &quot;
         &quot;private key and the certificate in PEM format.&quot;)

index_url = partial(
    Option,
    '-i', '--index-url', '--pypi-url',
    dest='index_url',
    metavar='URL',
    default=PyPI.simple_url,
    help=&quot;Base URL of Python Package Index (default %default). &quot;
         &quot;This should point to a repository compliant with PEP 503 &quot;
         &quot;(the simple repository API) or a local directory laid out &quot;
         &quot;in the same format.&quot;)


def extra_index_url():
    return Option(
        '--extra-index-url',
        dest='extra_index_urls',
        metavar='URL',
        action='append',
        default=[],
        help=&quot;Extra URLs of package indexes to use in addition to &quot;
             &quot;--index-url. Should follow the same rules as &quot;
             &quot;--index-url.&quot;
    )


no_index = partial(
    Option,
    '--no-index',
    dest='no_index',
    action='store_true',
    default=False,
    help='Ignore package index (only looking at --find-links URLs instead).')


def find_links():
    return Option(
        '-f', '--find-links',
        dest='find_links',
        action='append',
        default=[],
        metavar='url',
        help=&quot;If a url or path to an html file, then parse for links to &quot;
             &quot;archives. If a local path or file:// url that's a directory, &quot;
             &quot;then look for archives in the directory listing.&quot;)


def allow_external():
    return Option(
        &quot;--allow-external&quot;,
        dest=&quot;allow_external&quot;,
        action=&quot;append&quot;,
        default=[],
        metavar=&quot;PACKAGE&quot;,
        help=SUPPRESS_HELP,
    )


allow_all_external = partial(
    Option,
    &quot;--allow-all-external&quot;,
    dest=&quot;allow_all_external&quot;,
    action=&quot;store_true&quot;,
    default=False,
    help=SUPPRESS_HELP,
)


def trusted_host():
    return Option(
        &quot;--trusted-host&quot;,
        dest=&quot;trusted_hosts&quot;,
        action=&quot;append&quot;,
        metavar=&quot;HOSTNAME&quot;,
        default=[],
        help=&quot;Mark this host as trusted, even though it does not have valid &quot;
             &quot;or any HTTPS.&quot;,
    )


# Remove after 7.0
no_allow_external = partial(
    Option,
    &quot;--no-allow-external&quot;,
    dest=&quot;allow_all_external&quot;,
    action=&quot;store_false&quot;,
    default=False,
    help=SUPPRESS_HELP,
)


# Remove --allow-insecure after 7.0
def allow_unsafe():
    return Option(
        &quot;--allow-unverified&quot;, &quot;--allow-insecure&quot;,
        dest=&quot;allow_unverified&quot;,
        action=&quot;append&quot;,
        default=[],
        metavar=&quot;PACKAGE&quot;,
        help=SUPPRESS_HELP,
    )

# Remove after 7.0
no_allow_unsafe = partial(
    Option,
    &quot;--no-allow-insecure&quot;,
    dest=&quot;allow_all_insecure&quot;,
    action=&quot;store_false&quot;,
    default=False,
    help=SUPPRESS_HELP
)

# Remove after 1.5
process_dependency_links = partial(
    Option,
    &quot;--process-dependency-links&quot;,
    dest=&quot;process_dependency_links&quot;,
    action=&quot;store_true&quot;,
    default=False,
    help=&quot;Enable the processing of dependency links.&quot;,
)


def constraints():
    return Option(
        '-c', '--constraint',
        dest='constraints',
        action='append',
        default=[],
        metavar='file',
        help='Constrain versions using the given constraints file. '
        'This option can be used multiple times.')


def requirements():
    return Option(
        '-r', '--requirement',
        dest='requirements',
        action='append',
        default=[],
        metavar='file',
        help='Install from the given requirements file. '
        'This option can be used multiple times.')


def editable():
    return Option(
        '-e', '--editable',
        dest='editables',
        action='append',
        default=[],
        metavar='path/url',
        help=('Install a project in editable mode (i.e. setuptools '
              '&quot;develop mode&quot;) from a local project path or a VCS url.'),
    )

src = partial(
    Option,
    '--src', '--source', '--source-dir', '--source-directory',
    dest='src_dir',
    metavar='dir',
    default=src_prefix,
    help='Directory to check out editable projects into. '
    'The default in a virtualenv is &quot;&lt;venv path&gt;/src&quot;. '
    'The default for global installs is &quot;&lt;current dir&gt;/src&quot;.'
)

# XXX: deprecated, remove in 9.0
use_wheel = partial(
    Option,
    '--use-wheel',
    dest='use_wheel',
    action='store_true',
    default=True,
    help=SUPPRESS_HELP,
)

# XXX: deprecated, remove in 9.0
no_use_wheel = partial(
    Option,
    '--no-use-wheel',
    dest='use_wheel',
    action='store_false',
    default=True,
    help=('Do not Find and prefer wheel archives when searching indexes and '
          'find-links locations. DEPRECATED in favour of --no-binary.'),
)


def _get_format_control(values, option):
    &quot;&quot;&quot;Get a format_control object.&quot;&quot;&quot;
    return getattr(values, option.dest)


def _handle_no_binary(option, opt_str, value, parser):
    existing = getattr(parser.values, option.dest)
    fmt_ctl_handle_mutual_exclude(
        value, existing.no_binary, existing.only_binary)


def _handle_only_binary(option, opt_str, value, parser):
    existing = getattr(parser.values, option.dest)
    fmt_ctl_handle_mutual_exclude(
        value, existing.only_binary, existing.no_binary)


def no_binary():
    return Option(
        &quot;--no-binary&quot;, dest=&quot;format_control&quot;, action=&quot;callback&quot;,
        callback=_handle_no_binary, type=&quot;str&quot;,
        default=FormatControl(set(), set()),
        help=&quot;Do not use binary packages. Can be supplied multiple times, and &quot;
             &quot;each time adds to the existing value. Accepts either :all: to &quot;
             &quot;disable all binary packages, :none: to empty the set, or one or &quot;
             &quot;more package names with commas between them. Note that some &quot;
             &quot;packages are tricky to compile and may fail to install when &quot;
             &quot;this option is used on them.&quot;)


def only_binary():
    return Option(
        &quot;--only-binary&quot;, dest=&quot;format_control&quot;, action=&quot;callback&quot;,
        callback=_handle_only_binary, type=&quot;str&quot;,
        default=FormatControl(set(), set()),
        help=&quot;Do not use source packages. Can be supplied multiple times, and &quot;
             &quot;each time adds to the existing value. Accepts either :all: to &quot;
             &quot;disable all source packages, :none: to empty the set, or one or &quot;
             &quot;more package names with commas between them. Packages without &quot;
             &quot;binary distributions will fail to install when this option is &quot;
             &quot;used on them.&quot;)


cache_dir = partial(
    Option,
    &quot;--cache-dir&quot;,
    dest=&quot;cache_dir&quot;,
    default=USER_CACHE_DIR,
    metavar=&quot;dir&quot;,
    help=&quot;Store the cache data in &lt;dir&gt;.&quot;
)

no_cache = partial(
    Option,
    &quot;--no-cache-dir&quot;,
    dest=&quot;cache_dir&quot;,
    action=&quot;store_false&quot;,
    help=&quot;Disable the cache.&quot;,
)

no_deps = partial(
    Option,
    '--no-deps', '--no-dependencies',
    dest='ignore_dependencies',
    action='store_true',
    default=False,
    help=&quot;Don't install package dependencies.&quot;)

build_dir = partial(
    Option,
    '-b', '--build', '--build-dir', '--build-directory',
    dest='build_dir',
    metavar='dir',
    help='Directory to unpack packages into and build in.'
)

ignore_requires_python = partial(
    Option,
    '--ignore-requires-python',
    dest='ignore_requires_python',
    action='store_true',
    help='Ignore the Requires-Python information.')

install_options = partial(
    Option,
    '--install-option',
    dest='install_options',
    action='append',
    metavar='options',
    help=&quot;Extra arguments to be supplied to the setup.py install &quot;
         &quot;command (use like --install-option=\&quot;--install-scripts=/usr/local/&quot;
         &quot;bin\&quot;). Use multiple --install-option options to pass multiple &quot;
         &quot;options to setup.py install. If you are using an option with a &quot;
         &quot;directory path, be sure to use absolute path.&quot;)

global_options = partial(
    Option,
    '--global-option',
    dest='global_options',
    action='append',
    metavar='options',
    help=&quot;Extra global options to be supplied to the setup.py &quot;
         &quot;call before the install command.&quot;)

no_clean = partial(
    Option,
    '--no-clean',
    action='store_true',
    default=False,
    help=&quot;Don't clean up build directories.&quot;)

pre = partial(
    Option,
    '--pre',
    action='store_true',
    default=False,
    help=&quot;Include pre-release and development versions. By default, &quot;
         &quot;pip only finds stable versions.&quot;)

disable_pip_version_check = partial(
    Option,
    &quot;--disable-pip-version-check&quot;,
    dest=&quot;disable_pip_version_check&quot;,
    action=&quot;store_true&quot;,
    default=False,
    help=&quot;Don't periodically check PyPI to determine whether a new version &quot;
         &quot;of pip is available for download. Implied with --no-index.&quot;)

# Deprecated, Remove later
always_unzip = partial(
    Option,
    '-Z', '--always-unzip',
    dest='always_unzip',
    action='store_true',
    help=SUPPRESS_HELP,
)


def _merge_hash(option, opt_str, value, parser):
    &quot;&quot;&quot;Given a value spelled &quot;algo:digest&quot;, append the digest to a list
    pointed to in a dict by the algo name.&quot;&quot;&quot;
    if not parser.values.hashes:
        parser.values.hashes = {}
    try:
        algo, digest = value.split(':', 1)
    except ValueError:
        parser.error('Arguments to %s must be a hash name '
                     'followed by a value, like --hash=sha256:abcde...' %
                     opt_str)
    if algo not in STRONG_HASHES:
        parser.error('Allowed hash algorithms for %s are %s.' %
                     (opt_str, ', '.join(STRONG_HASHES)))
    parser.values.hashes.setdefault(algo, []).append(digest)


hash = partial(
    Option,
    '--hash',
    # Hash values eventually end up in InstallRequirement.hashes due to
    # __dict__ copying in process_line().
    dest='hashes',
    action='callback',
    callback=_merge_hash,
    type='string',
    help=&quot;Verify that the package's archive matches this &quot;
         'hash before installing. Example: --hash=sha256:abcdef...')


require_hashes = partial(
    Option,
    '--require-hashes',
    dest='require_hashes',
    action='store_true',
    default=False,
    help='Require a hash to check each requirement against, for '
         'repeatable installs. This option is implied when any package in a '
         'requirements file has a --hash option.')


##########
# groups #
##########

general_group = {
    'name': 'General Options',
    'options': [
        help_,
        isolated_mode,
        require_virtualenv,
        verbose,
        version,
        quiet,
        log,
        no_input,
        proxy,
        retries,
        timeout,
        default_vcs,
        skip_requirements_regex,
        exists_action,
        trusted_host,
        cert,
        client_cert,
        cache_dir,
        no_cache,
        disable_pip_version_check,
    ]
}

non_deprecated_index_group = {
    'name': 'Package Index Options',
    'options': [
        index_url,
        extra_index_url,
        no_index,
        find_links,
        process_dependency_links,
    ]
}

index_group = {
    'name': 'Package Index Options (including deprecated options)',
    'options': non_deprecated_index_group['options'] + [
        allow_external,
        allow_all_external,
        no_allow_external,
        allow_unsafe,
        no_allow_unsafe,
    ]
}
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flib%2Fpython2.7%2Fsite-packages%2Fpip'>Back to Directory</a>