1
# Copyright (C) 2004, 2005, 2006 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program; if not, write to the Free Software
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
# TODO: Some way to get a list of external commands (defined by shell
18
# scripts) so that they can be included in the help listing as well.
19
# It should be enough to just list the plugin directory and look for
20
# executable files with reasonable names.
22
# TODO: `help commands --all` should show hidden commands
33
def help(topic=None, outfile=None):
34
"""Write the help for the specific topic to outfile"""
41
if topic in help_topics.topic_registry:
42
txt = help_topics.topic_registry.get_detail(topic)
45
help_on_command(topic, outfile=outfile)
48
def command_usage(cmd_object):
49
"""Return single-line grammar for command.
51
Only describes arguments, not options.
53
s = 'bzr ' + cmd_object.name() + ' '
54
for aname in cmd_object.takes_args:
56
if aname[-1] in ['$', '+']:
57
aname = aname[:-1] + '...'
58
elif aname[-1] == '?':
59
aname = '[' + aname[:-1] + ']'
60
elif aname[-1] == '*':
61
aname = '[' + aname[:-1] + '...]'
70
def print_command_plugin(cmd_object, outfile, format):
71
"""Print the plugin that provides a command object, if any.
73
If the cmd_object is provided by a plugin, prints the plugin name to
74
outfile using the provided format string.
76
plugin_name = cmd_object.plugin_name()
77
if plugin_name is not None:
78
out_str = '(From plugin "%s")' % plugin_name
79
outfile.write(format % out_str)
82
def help_on_command(cmdname, outfile=None):
83
from bzrlib.commands import get_cmd_object
85
cmdname = str(cmdname)
90
cmd_object = get_cmd_object(cmdname)
92
doc = cmd_object.help()
94
raise NotImplementedError("sorry, no detailed help yet for %r" % cmdname)
96
print >>outfile, 'usage:', command_usage(cmd_object)
98
if cmd_object.aliases:
99
print >>outfile, 'aliases:',
100
print >>outfile, ', '.join(cmd_object.aliases)
104
print_command_plugin(cmd_object, outfile, '%s\n\n')
109
help_on_command_options(cmd_object, outfile)
112
def help_on_command_options(cmd, outfile=None):
113
from bzrlib.option import Option, get_optparser
116
options = cmd.options()
118
outfile.write(get_optparser(options).format_option_help())
121
def help_commands(outfile=None):
122
"""List all commands"""
125
outfile.write(_help_commands_to_text('commands'))
128
def _help_commands_to_text(topic):
129
"""Generate the help text for the list of commands"""
130
from bzrlib.commands import (builtin_command_names,
131
plugin_command_names,
135
names = set(builtin_command_names()) # to eliminate duplicates
136
names.update(plugin_command_names())
137
commands = ((n, get_cmd_object(n)) for n in names)
138
shown_commands = [(n, o) for n, o in commands if not o.hidden]
139
max_name = max(len(n) for n, o in shown_commands)
140
indent = ' ' * (max_name + 1)
141
width = osutils.terminal_width() - 1
143
for cmd_name, cmd_object in sorted(shown_commands):
144
plugin_name = cmd_object.plugin_name()
145
if plugin_name is None:
148
plugin_name = ' [%s]' % plugin_name
150
cmd_help = cmd_object.help()
152
firstline = cmd_help.split('\n', 1)[0]
155
helpstring = '%-*s %s%s' % (max_name, cmd_name, firstline, plugin_name)
156
lines = textwrap.wrap(helpstring, subsequent_indent=indent,
159
out.append(line + '\n')
163
help_topics.topic_registry.register("commands",
164
_help_commands_to_text,
165
"Basic help for all commands")
added
removed
bzrlib/help.py
