aboutsummaryrefslogtreecommitdiffstats
path: root/jython-tosca-parser/src/main/resources/Lib/site-packages/pip/cmdoptions.py
diff options
context:
space:
mode:
Diffstat (limited to 'jython-tosca-parser/src/main/resources/Lib/site-packages/pip/cmdoptions.py')
-rw-r--r--jython-tosca-parser/src/main/resources/Lib/site-packages/pip/cmdoptions.py388
1 files changed, 388 insertions, 0 deletions
diff --git a/jython-tosca-parser/src/main/resources/Lib/site-packages/pip/cmdoptions.py b/jython-tosca-parser/src/main/resources/Lib/site-packages/pip/cmdoptions.py
new file mode 100644
index 0000000..85b9abc
--- /dev/null
+++ b/jython-tosca-parser/src/main/resources/Lib/site-packages/pip/cmdoptions.py
@@ -0,0 +1,388 @@
+"""
+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 parse's general options twice internally, and shouldn't
+pass on state. To be consistent, all options will follow this design.
+
+"""
+import copy
+from optparse import OptionGroup, SUPPRESS_HELP, Option
+from pip.locations import build_prefix, default_log_file
+
+
+def make_option_group(group, parser):
+ """
+ Return an OptionGroup object
+ group -- assumed to be dict with 'name' and 'options' keys
+ parser -- an optparse Parser
+ """
+ option_group = OptionGroup(parser, group['name'])
+ for option in group['options']:
+ option_group.add_option(option.make())
+ return option_group
+
+
+class OptionMaker(object):
+ """Class that stores the args/kwargs that would be used to make an Option,
+ for making them later, and uses deepcopy's to reset state."""
+
+ def __init__(self, *args, **kwargs):
+ self.args = args
+ self.kwargs = kwargs
+
+ def make(self):
+ args_copy = copy.deepcopy(self.args)
+ kwargs_copy = copy.deepcopy(self.kwargs)
+ return Option(*args_copy, **kwargs_copy)
+
+###########
+# options #
+###########
+
+help_ = OptionMaker(
+ '-h', '--help',
+ dest='help',
+ action='help',
+ help='Show help.')
+
+require_virtualenv = OptionMaker(
+ # 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 = OptionMaker(
+ '-v', '--verbose',
+ dest='verbose',
+ action='count',
+ default=0,
+ help='Give more output. Option is additive, and can be used up to 3 times.'
+)
+
+version = OptionMaker(
+ '-V', '--version',
+ dest='version',
+ action='store_true',
+ help='Show version and exit.')
+
+quiet = OptionMaker(
+ '-q', '--quiet',
+ dest='quiet',
+ action='count',
+ default=0,
+ help='Give less output.')
+
+log = OptionMaker(
+ '--log',
+ dest='log',
+ metavar='path',
+ help='Path to a verbose appending log. This log is inactive by default.')
+
+log_explicit_levels = OptionMaker(
+ # Writes the log levels explicitely to the log'
+ '--log-explicit-levels',
+ dest='log_explicit_levels',
+ action='store_true',
+ default=False,
+ help=SUPPRESS_HELP)
+
+log_file = OptionMaker(
+ # The default log file
+ '--log-file', '--local-log',
+ dest='log_file',
+ metavar='path',
+ default=default_log_file,
+ help='Path to a verbose non-appending log, that only logs failures. This '
+ 'log is active by default at %default.')
+
+no_input = OptionMaker(
+ # Don't ask for input
+ '--no-input',
+ dest='no_input',
+ action='store_true',
+ default=False,
+ help=SUPPRESS_HELP)
+
+proxy = OptionMaker(
+ '--proxy',
+ dest='proxy',
+ type='str',
+ default='',
+ help="Specify a proxy in the form [user:passwd@]proxy.server:port.")
+
+retries = OptionMaker(
+ '--retries',
+ dest='retries',
+ type='int',
+ default=3,
+ help="Maximum number of retries each connection should attempt "
+ "(default %default times).")
+
+timeout = OptionMaker(
+ '--timeout', '--default-timeout',
+ metavar='sec',
+ dest='timeout',
+ type='float',
+ default=15,
+ help='Set the socket timeout (default %default seconds).')
+
+default_vcs = OptionMaker(
+ # The default version control system for editables, e.g. 'svn'
+ '--default-vcs',
+ dest='default_vcs',
+ type='str',
+ default='',
+ help=SUPPRESS_HELP)
+
+skip_requirements_regex = OptionMaker(
+ # A regex to be used to skip requirements
+ '--skip-requirements-regex',
+ dest='skip_requirements_regex',
+ type='str',
+ default='',
+ help=SUPPRESS_HELP)
+
+exists_action = OptionMaker(
+ # Option when path already exist
+ '--exists-action',
+ dest='exists_action',
+ type='choice',
+ choices=['s', 'i', 'w', 'b'],
+ default=[],
+ action='append',
+ metavar='action',
+ help="Default action when a path already exists: "
+ "(s)witch, (i)gnore, (w)ipe, (b)ackup.")
+
+cert = OptionMaker(
+ '--cert',
+ dest='cert',
+ type='str',
+ default='',
+ metavar='path',
+ help="Path to alternate CA bundle.")
+
+client_cert = OptionMaker(
+ '--client-cert',
+ dest='client_cert',
+ type='str',
+ default=None,
+ metavar='path',
+ help="Path to SSL client certificate, a single file containing the "
+ "private key and the certificate in PEM format.")
+
+index_url = OptionMaker(
+ '-i', '--index-url', '--pypi-url',
+ dest='index_url',
+ metavar='URL',
+ default='https://pypi.python.org/simple/',
+ help='Base URL of Python Package Index (default %default).')
+
+extra_index_url = OptionMaker(
+ '--extra-index-url',
+ dest='extra_index_urls',
+ metavar='URL',
+ action='append',
+ default=[],
+ help='Extra URLs of package indexes to use in addition to --index-url.')
+
+no_index = OptionMaker(
+ '--no-index',
+ dest='no_index',
+ action='store_true',
+ default=False,
+ help='Ignore package index (only looking at --find-links URLs instead).')
+
+find_links = OptionMaker(
+ '-f', '--find-links',
+ dest='find_links',
+ action='append',
+ default=[],
+ metavar='url',
+ help="If a url or path to an html file, then parse for links to archives. "
+ "If a local path or file:// url that's a directory, then look for "
+ "archives in the directory listing.")
+
+# TODO: Remove after 1.6
+use_mirrors = OptionMaker(
+ '-M', '--use-mirrors',
+ dest='use_mirrors',
+ action='store_true',
+ default=False,
+ help=SUPPRESS_HELP)
+
+# TODO: Remove after 1.6
+mirrors = OptionMaker(
+ '--mirrors',
+ dest='mirrors',
+ metavar='URL',
+ action='append',
+ default=[],
+ help=SUPPRESS_HELP)
+
+allow_external = OptionMaker(
+ "--allow-external",
+ dest="allow_external",
+ action="append",
+ default=[],
+ metavar="PACKAGE",
+ help="Allow the installation of externally hosted files",
+)
+
+allow_all_external = OptionMaker(
+ "--allow-all-external",
+ dest="allow_all_external",
+ action="store_true",
+ default=False,
+ help="Allow the installation of all externally hosted files",
+)
+
+# Remove after 1.7
+no_allow_external = OptionMaker(
+ "--no-allow-external",
+ dest="allow_all_external",
+ action="store_false",
+ default=False,
+ help=SUPPRESS_HELP,
+)
+
+# Remove --allow-insecure after 1.7
+allow_unsafe = OptionMaker(
+ "--allow-unverified", "--allow-insecure",
+ dest="allow_unverified",
+ action="append",
+ default=[],
+ metavar="PACKAGE",
+ help="Allow the installation of insecure and unverifiable files",
+)
+
+# Remove after 1.7
+no_allow_unsafe = OptionMaker(
+ "--no-allow-insecure",
+ dest="allow_all_insecure",
+ action="store_false",
+ default=False,
+ help=SUPPRESS_HELP
+)
+
+requirements = OptionMaker(
+ '-r', '--requirement',
+ dest='requirements',
+ action='append',
+ default=[],
+ metavar='file',
+ help='Install from the given requirements file. '
+ 'This option can be used multiple times.')
+
+use_wheel = OptionMaker(
+ '--use-wheel',
+ dest='use_wheel',
+ action='store_true',
+ help=SUPPRESS_HELP,
+)
+
+no_use_wheel = OptionMaker(
+ '--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.'),
+)
+
+download_cache = OptionMaker(
+ '--download-cache',
+ dest='download_cache',
+ metavar='dir',
+ default=None,
+ help='Cache downloaded packages in <dir>.')
+
+no_deps = OptionMaker(
+ '--no-deps', '--no-dependencies',
+ dest='ignore_dependencies',
+ action='store_true',
+ default=False,
+ help="Don't install package dependencies.")
+
+build_dir = OptionMaker(
+ '-b', '--build', '--build-dir', '--build-directory',
+ dest='build_dir',
+ metavar='dir',
+ default=build_prefix,
+ help='Directory to unpack packages into and build in. '
+ 'The default in a virtualenv is "<venv path>/build". '
+ 'The default for global installs is "<OS temp dir>/pip_build_<username>".')
+
+install_options = OptionMaker(
+ '--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.")
+
+global_options = OptionMaker(
+ '--global-option',
+ dest='global_options',
+ action='append',
+ metavar='options',
+ help="Extra global options to be supplied to the setup.py "
+ "call before the install command.")
+
+no_clean = OptionMaker(
+ '--no-clean',
+ action='store_true',
+ default=False,
+ help="Don't clean up build directories.")
+
+
+##########
+# groups #
+##########
+
+general_group = {
+ 'name': 'General Options',
+ 'options': [
+ help_,
+ require_virtualenv,
+ verbose,
+ version,
+ quiet,
+ log_file,
+ log,
+ log_explicit_levels,
+ no_input,
+ proxy,
+ retries,
+ timeout,
+ default_vcs,
+ skip_requirements_regex,
+ exists_action,
+ cert,
+ client_cert,
+ ]
+}
+
+index_group = {
+ 'name': 'Package Index Options',
+ 'options': [
+ index_url,
+ extra_index_url,
+ no_index,
+ find_links,
+ use_mirrors,
+ mirrors,
+ allow_external,
+ allow_all_external,
+ no_allow_external,
+ allow_unsafe,
+ no_allow_unsafe,
+ ]
+}