mirror of
https://github.com/pypa/pip
synced 2023-12-13 21:30:23 +01:00
7427eca00b
Rework the way commands are defined, loaded and ran in pip: - Commands are instantiated on demand in pip.main(). - A command 'registry' - mapping of command names to command classes in pip.commands.__init__. - Remove deferred command module loading.
178 lines
5.8 KiB
Python
178 lines
5.8 KiB
Python
"""Base Command class, and related routines"""
|
|
|
|
import os
|
|
from pkgutil import walk_packages
|
|
import socket
|
|
import sys
|
|
import tempfile
|
|
import traceback
|
|
import time
|
|
|
|
from pip.log import logger
|
|
from pip.baseparser import parser, ConfigOptionParser, UpdatingDefaultsHelpFormatter
|
|
from pip.download import urlopen
|
|
from pip.exceptions import (BadCommand, InstallationError, UninstallationError,
|
|
CommandError)
|
|
from pip.backwardcompat import StringIO
|
|
from pip.status_codes import SUCCESS, ERROR, UNKNOWN_ERROR, VIRTUALENV_NOT_FOUND
|
|
from pip.util import get_prog
|
|
|
|
|
|
__all__ = ['Command']
|
|
|
|
|
|
# for backwards compatibiliy
|
|
get_proxy = urlopen.get_proxy
|
|
|
|
|
|
class Command(object):
|
|
name = None
|
|
usage = None
|
|
hidden = False
|
|
|
|
def __init__(self):
|
|
assert self.name
|
|
self.parser = ConfigOptionParser(
|
|
usage=self.usage,
|
|
prog='%s %s' % (get_prog(), self.name),
|
|
version=parser.version,
|
|
formatter=UpdatingDefaultsHelpFormatter(),
|
|
name=self.name)
|
|
for option in parser.option_list:
|
|
if not option.dest or option.dest == 'help':
|
|
# -h, --version, etc
|
|
continue
|
|
self.parser.add_option(option)
|
|
command_dict[self.name] = self
|
|
|
|
def merge_options(self, initial_options, options):
|
|
# Make sure we have all global options carried over
|
|
for attr in ['log', 'proxy', 'require_venv',
|
|
'log_explicit_levels', 'log_file',
|
|
'timeout', 'default_vcs',
|
|
'skip_requirements_regex',
|
|
'no_input', 'exists_action']:
|
|
setattr(options, attr, getattr(initial_options, attr) or getattr(options, attr))
|
|
options.quiet += initial_options.quiet
|
|
options.verbose += initial_options.verbose
|
|
|
|
def setup_logging(self):
|
|
pass
|
|
|
|
def main(self, args, initial_options):
|
|
options, args = self.parser.parse_args(args)
|
|
self.merge_options(initial_options, options)
|
|
|
|
level = 1 # Notify
|
|
level += options.verbose
|
|
level -= options.quiet
|
|
level = logger.level_for_integer(4-level)
|
|
complete_log = []
|
|
logger.consumers.extend(
|
|
[(level, sys.stdout),
|
|
(logger.DEBUG, complete_log.append)])
|
|
if options.log_explicit_levels:
|
|
logger.explicit_levels = True
|
|
|
|
self.setup_logging()
|
|
|
|
if options.no_input:
|
|
os.environ['PIP_NO_INPUT'] = '1'
|
|
|
|
if options.exists_action:
|
|
os.environ['PIP_EXISTS_ACTION'] = ''.join(options.exists_action)
|
|
|
|
if options.require_venv:
|
|
# If a venv is required check if it can really be found
|
|
if not os.environ.get('VIRTUAL_ENV'):
|
|
logger.fatal('Could not find an activated virtualenv (required).')
|
|
sys.exit(VIRTUALENV_NOT_FOUND)
|
|
|
|
if options.log:
|
|
log_fp = open_logfile(options.log, 'a')
|
|
logger.consumers.append((logger.DEBUG, log_fp))
|
|
else:
|
|
log_fp = None
|
|
|
|
socket.setdefaulttimeout(options.timeout or None)
|
|
|
|
urlopen.setup(proxystr=options.proxy, prompting=not options.no_input)
|
|
|
|
exit = SUCCESS
|
|
store_log = False
|
|
try:
|
|
status = self.run(options, args)
|
|
# FIXME: all commands should return an exit status
|
|
# and when it is done, isinstance is not needed anymore
|
|
if isinstance(status, int):
|
|
exit = status
|
|
except (InstallationError, UninstallationError):
|
|
e = sys.exc_info()[1]
|
|
logger.fatal(str(e))
|
|
logger.info('Exception information:\n%s' % format_exc())
|
|
store_log = True
|
|
exit = ERROR
|
|
except BadCommand:
|
|
e = sys.exc_info()[1]
|
|
logger.fatal(str(e))
|
|
logger.info('Exception information:\n%s' % format_exc())
|
|
store_log = True
|
|
exit = ERROR
|
|
except CommandError:
|
|
e = sys.exc_info()[1]
|
|
logger.fatal('ERROR: %s' % e)
|
|
logger.info('Exception information:\n%s' % format_exc())
|
|
exit = ERROR
|
|
except KeyboardInterrupt:
|
|
logger.fatal('Operation cancelled by user')
|
|
logger.info('Exception information:\n%s' % format_exc())
|
|
store_log = True
|
|
exit = ERROR
|
|
except:
|
|
logger.fatal('Exception:\n%s' % format_exc())
|
|
store_log = True
|
|
exit = UNKNOWN_ERROR
|
|
if log_fp is not None:
|
|
log_fp.close()
|
|
if store_log:
|
|
log_fn = options.log_file
|
|
text = '\n'.join(complete_log)
|
|
try:
|
|
log_fp = open_logfile(log_fn, 'w')
|
|
except IOError:
|
|
temp = tempfile.NamedTemporaryFile(delete=False)
|
|
log_fn = temp.name
|
|
log_fp = open_logfile(log_fn, 'w')
|
|
logger.fatal('Storing complete log in %s' % log_fn)
|
|
log_fp.write(text)
|
|
log_fp.close()
|
|
return exit
|
|
|
|
|
|
def format_exc(exc_info=None):
|
|
if exc_info is None:
|
|
exc_info = sys.exc_info()
|
|
out = StringIO()
|
|
traceback.print_exception(*exc_info, **dict(file=out))
|
|
return out.getvalue()
|
|
|
|
|
|
def open_logfile(filename, mode='a'):
|
|
"""Open the named log file in append mode.
|
|
|
|
If the file already exists, a separator will also be printed to
|
|
the file to separate past activity from current activity.
|
|
"""
|
|
filename = os.path.expanduser(filename)
|
|
filename = os.path.abspath(filename)
|
|
dirname = os.path.dirname(filename)
|
|
if not os.path.exists(dirname):
|
|
os.makedirs(dirname)
|
|
exists = os.path.exists(filename)
|
|
|
|
log_fp = open(filename, mode)
|
|
if exists:
|
|
log_fp.write('%s\n' % ('-'*60))
|
|
log_fp.write('%s run on %s\n' % (sys.argv[0], time.strftime('%c')))
|
|
return log_fp
|
|
|