241
213
if self.__doc__ == Command.__doc__:
242
214
warn("No help message set for %r" % self)
244
def _maybe_expand_globs(self, file_list):
245
"""Glob expand file_list if the platform does not do that itself.
247
:return: A possibly empty list of unicode paths.
249
Introduced in bzrlib 0.18.
253
if sys.platform == 'win32':
254
file_list = win32utils.glob_expand(file_list)
255
return list(file_list)
258
"""Return single-line grammar for this command.
260
Only describes arguments, not options.
262
s = 'bzr ' + self.name() + ' '
263
for aname in self.takes_args:
264
aname = aname.upper()
265
if aname[-1] in ['$', '+']:
266
aname = aname[:-1] + '...'
267
elif aname[-1] == '?':
268
aname = '[' + aname[:-1] + ']'
269
elif aname[-1] == '*':
270
aname = '[' + aname[:-1] + '...]'
277
def get_help_text(self, additional_see_also=None):
278
"""Return a text string with help for this command.
280
:param additional_see_also: Additional help topics to be
285
raise NotImplementedError("sorry, no detailed help yet for %r" % self.name())
288
result += 'usage: %s\n' % self._usage()
291
result += 'aliases: '
292
result += ', '.join(self.aliases) + '\n'
296
plugin_name = self.plugin_name()
297
if plugin_name is not None:
298
result += '(From plugin "%s")' % plugin_name
302
if result[-1] != '\n':
305
result += option.get_optparser(self.options()).format_option_help()
306
see_also = self.get_see_also(additional_see_also)
308
result += '\nSee also: '
309
result += ', '.join(see_also)
313
def get_help_topic(self):
314
"""Return the commands help topic - its name."""
317
def get_see_also(self, additional_terms=None):
318
"""Return a list of help topics that are related to this ommand.
320
The list is derived from the content of the _see_also attribute. Any
321
duplicates are removed and the result is in lexical order.
322
:param additional_terms: Additional help topics to cross-reference.
323
:return: A list of help topics.
325
see_also = set(getattr(self, '_see_also', []))
327
see_also.update(additional_terms)
328
return sorted(see_also)
330
216
def options(self):
331
217
"""Return dict of valid options for this command.
333
219
Maps from long option name to option object."""
335
r['help'] = option.Option.OPTIONS['help']
221
r['help'] = Option.OPTIONS['help']
336
222
for o in self.takes_options:
337
if isinstance(o, basestring):
338
o = option.Option.OPTIONS[o]
223
if not isinstance(o, Option):
224
o = Option.OPTIONS[o]
342
def _setup_outf(self):
228
def _setup_stdout(self):
343
229
"""Return a file linked to stdout, which has proper encoding."""
344
230
assert self.encoding_type in ['strict', 'exact', 'replace']
346
232
# Originally I was using self.stdout, but that looks
347
233
# *way* too much like sys.stdout
348
234
if self.encoding_type == 'exact':
349
# force sys.stdout to be binary stream on win32
350
if sys.platform == 'win32':
351
fileno = getattr(sys.stdout, 'fileno', None)
354
msvcrt.setmode(fileno(), os.O_BINARY)
355
235
self.outf = sys.stdout
358
output_encoding = osutils.get_terminal_encoding()
238
output_encoding = getattr(sys.stdout, 'encoding', None)
239
if not output_encoding:
240
output_encoding = bzrlib.user_encoding
241
mutter('encoding stdout bzrlib.user_encoding %r', output_encoding)
243
mutter('encoding stdout log as sys.stdout encoding %r', output_encoding)
360
245
# use 'replace' so that we don't abort if trying to write out
361
246
# in e.g. the default C locale.
362
247
self.outf = codecs.getwriter(output_encoding)(sys.stdout, errors=self.encoding_type)
363
# For whatever reason codecs.getwriter() does not advertise its encoding
364
# it just returns the encoding of the wrapped file, which is completely
365
# bogus. So set the attribute, so we can find the correct encoding later.
366
self.outf.encoding = output_encoding
249
@deprecated_method(zero_eight)
250
def run_argv(self, argv):
251
"""Parse command line and run.
253
See run_argv_aliases for the 0.8 and beyond api.
255
return self.run_argv_aliases(argv)
368
257
def run_argv_aliases(self, argv, alias_argv=None):
369
258
"""Parse the command line and run with extra aliases in alias_argv."""
371
warn("Passing None for [] is deprecated from bzrlib 0.10",
372
DeprecationWarning, stacklevel=2)
374
259
args, opts = parse_args(self, argv, alias_argv)
375
260
if 'help' in opts: # e.g. bzr add --help
376
sys.stdout.write(self.get_help_text())
261
from bzrlib.help import help_on_command
262
help_on_command(self.name())
264
# XXX: This should be handled by the parser
265
allowed_names = self.options().keys()
267
if oname not in allowed_names:
268
raise BzrCommandError("option '--%s' is not allowed for"
269
" command %r" % (oname, self.name()))
378
270
# mix arguments and options into one dictionary
379
271
cmdargs = _match_argform(self.name(), self.takes_args, args)
465
343
lookup table, something about the available options, what optargs
466
344
they take, and which commands will accept them.
468
# TODO: make it a method of the Command?
469
parser = option.get_optparser(command.options())
470
if alias_argv is not None:
471
args = alias_argv + argv
475
options, args = parser.parse_args(args)
476
opts = dict([(k, v) for k, v in options.__dict__.iteritems() if
477
v is not option.OptionParser.DEFAULT_VALUE])
346
# TODO: chop up this beast; make it a method of the Command
351
cmd_options = command.options()
353
proc_aliasarg = True # Are we processing alias_argv now?
354
for proc_argv in alias_argv, argv:
361
# We've received a standalone -- No more flags
365
# option names must not be unicode
369
mutter(" got option %r", a)
371
optname, optarg = a[2:].split('=', 1)
374
if optname not in cmd_options:
375
raise BzrOptionError('unknown long option %r for'
380
if shortopt in Option.SHORT_OPTIONS:
381
# Multi-character options must have a space to delimit
383
# ^^^ what does this mean? mbp 20051014
384
optname = Option.SHORT_OPTIONS[shortopt].name
386
# Single character short options, can be chained,
387
# and have their value appended to their name
389
if shortopt not in Option.SHORT_OPTIONS:
390
# We didn't find the multi-character name, and we
391
# didn't find the single char name
392
raise BzrError('unknown short option %r' % a)
393
optname = Option.SHORT_OPTIONS[shortopt].name
396
# There are extra things on this option
397
# see if it is the value, or if it is another
399
optargfn = Option.OPTIONS[optname].type
401
# This option does not take an argument, so the
402
# next entry is another short option, pack it
404
proc_argv.insert(0, '-' + a[2:])
406
# This option takes an argument, so pack it
410
if optname not in cmd_options:
411
raise BzrOptionError('unknown short option %r for'
413
(shortopt, command.name()))
415
# XXX: Do we ever want to support this, e.g. for -r?
417
raise BzrError('repeated option %r' % a)
418
elif optname in alias_opts:
419
# Replace what's in the alias with what's in the real
421
del alias_opts[optname]
423
proc_argv.insert(0, a)
426
raise BzrError('repeated option %r' % a)
428
option_obj = cmd_options[optname]
429
optargfn = option_obj.type
433
raise BzrError('option %r needs an argument' % a)
435
optarg = proc_argv.pop(0)
436
opts[optname] = optargfn(optarg)
438
alias_opts[optname] = optargfn(optarg)
441
raise BzrError('option %r takes no argument' % optname)
444
alias_opts[optname] = True
447
proc_aliasarg = False # Done with alias argv
478
448
return args, opts
495
465
argdict[argname + '_list'] = None
496
466
elif ap[-1] == '+':
498
raise errors.BzrCommandError("command %r needs one or more %s"
499
% (cmd, argname.upper()))
468
raise BzrCommandError("command %r needs one or more %s"
469
% (cmd, argname.upper()))
501
471
argdict[argname + '_list'] = args[:]
503
473
elif ap[-1] == '$': # all but one
504
474
if len(args) < 2:
505
raise errors.BzrCommandError("command %r needs one or more %s"
506
% (cmd, argname.upper()))
475
raise BzrCommandError("command %r needs one or more %s"
476
% (cmd, argname.upper()))
507
477
argdict[argname + '_list'] = args[:-1]
510
480
# just a plain arg
513
raise errors.BzrCommandError("command %r requires argument %s"
514
% (cmd, argname.upper()))
483
raise BzrCommandError("command %r requires argument %s"
484
% (cmd, argname.upper()))
516
486
argdict[argname] = args.pop(0)
519
raise errors.BzrCommandError("extra argument to command %s: %s"
489
raise BzrCommandError("extra argument to command %s: %s"
549
519
def apply_lsprofiled(filename, the_callable, *args, **kwargs):
550
520
from bzrlib.lsprof import profile
551
522
ret, stats = profile(the_callable, *args, **kwargs)
553
524
if filename is None:
557
trace.note('Profile data written to "%s".', filename)
528
cPickle.dump(stats, open(filename, 'w'), 2)
529
print 'Profile data written to %r.' % filename
561
def get_alias(cmd, config=None):
562
"""Return an expanded alias, or None if no alias exists.
565
Command to be checked for an alias.
567
Used to specify an alternative config to use,
568
which is especially useful for testing.
569
If it is unspecified, the global config will be used.
573
config = bzrlib.config.GlobalConfig()
574
alias = config.get_alias(cmd)
534
"""Return an expanded alias, or None if no alias exists"""
536
alias = bzrlib.config.GlobalConfig().get_alias(cmd)
577
return [a.decode('utf-8') for a in shlex.split(alias.encode('utf-8'))]
538
return alias.split(' ')
719
675
from bzrlib.ui.text import TextUIFactory
676
## bzrlib.trace.enable_default_logging()
677
bzrlib.trace.log_startup(argv)
720
678
bzrlib.ui.ui_factory = TextUIFactory()
721
680
argv = [a.decode(bzrlib.user_encoding) for a in argv[1:]]
722
681
ret = run_bzr_catch_errors(argv)
723
trace.mutter("return code %d", ret)
682
mutter("return code %d", ret)
727
686
def run_bzr_catch_errors(argv):
730
except (KeyboardInterrupt, Exception), e:
691
# do this here inside the exception wrappers to catch EPIPE
731
694
# used to handle AssertionError and KeyboardInterrupt
732
695
# specially here, but hopefully they're handled ok by the logger now
733
trace.report_exception(sys.exc_info(), sys.stderr)
734
if os.environ.get('BZR_PDB'):
735
print '**** entering debugger'
737
pdb.post_mortem(sys.exc_traceback)
741
class HelpCommandIndex(object):
742
"""A index for bzr help that returns commands."""
745
self.prefix = 'commands/'
747
def get_topics(self, topic):
748
"""Search for topic amongst commands.
750
:param topic: A topic to search for.
751
:return: A list which is either empty or contains a single
754
if topic and topic.startswith(self.prefix):
755
topic = topic[len(self.prefix):]
757
cmd = _get_cmd_object(topic)
697
if (isinstance(e, IOError)
698
and hasattr(e, 'errno')
699
and e.errno == errno.EPIPE):
700
bzrlib.trace.note('broken pipe')
703
bzrlib.trace.log_exception()
704
if os.environ.get('BZR_PDB'):
705
print '**** entering debugger'
707
pdb.post_mortem(sys.exc_traceback)
764
710
if __name__ == '__main__':
765
711
sys.exit(main(sys.argv))