← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help.py

  • Committer: John Arbash Meinel
  • Date: 2006-09-11 22:48:57 UTC
  • mto: This revision was merged to the branch mainline in revision 2004.
  • Revision ID: john@arbash-meinel.com-20060911224857-d7008be21aeee33e
Switch from individual functions to a class

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help.py
1
1
# Copyright (C) 2004, 2005, 2006 by Canonical Ltd
2
 
 
 
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
5
5
# the Free Software Foundation; either version 2 of the License, or
6
6
# (at your option) any later version.
7
 
 
 
7
#
8
8
# This program is distributed in the hope that it will be useful,
9
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
11
# GNU General Public License for more details.
12
 
 
 
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
23
23
import textwrap
24
24
 
25
25
global_help = \
26
 
"""Bazaar-NG -- a free distributed version-control tool
 
26
"""Bazaar -- a free distributed version-control tool
27
27
http://bazaar-vcs.org/
28
28
 
29
29
Basic commands:
53
53
 
54
54
 
55
55
def help(topic=None, outfile = None):
56
 
    if outfile == None:
 
56
    if outfile is None:
57
57
        outfile = sys.stdout
58
 
    if topic == None:
 
58
    if topic is None:
59
59
        outfile.write(global_help)
60
60
    elif topic == 'commands':
61
61
        help_commands(outfile = outfile)
85
85
    return s
86
86
 
87
87
 
 
88
def print_command_plugin(cmd_object, outfile, format):
 
89
    """Print the plugin that provides a command object, if any.
 
90
 
 
91
    If the cmd_object is provided by a plugin, prints the plugin name to
 
92
    outfile using the provided format string.
 
93
    """
 
94
    plugin_name = cmd_object.plugin_name()
 
95
    if plugin_name is not None:
 
96
        out_str = '(From plugin "%s")' % plugin_name
 
97
        outfile.write(format % out_str)
 
98
 
 
99
 
88
100
def help_on_command(cmdname, outfile=None):
89
101
    from bzrlib.commands import get_cmd_object
90
102
 
91
103
    cmdname = str(cmdname)
92
104
 
93
 
    if outfile == None:
 
105
    if outfile is None:
94
106
        outfile = sys.stdout
95
107
 
96
108
    cmd_object = get_cmd_object(cmdname)
97
109
 
98
110
    doc = cmd_object.help()
99
 
    if doc == None:
 
111
    if doc is None:
100
112
        raise NotImplementedError("sorry, no detailed help yet for %r" % cmdname)
101
113
 
102
114
    print >>outfile, 'usage:', command_usage(cmd_object) 
107
119
 
108
120
    print >>outfile
109
121
 
 
122
    print_command_plugin(cmd_object, outfile, '%s\n\n')
 
123
 
110
124
    outfile.write(doc)
111
125
    if doc[-1] != '\n':
112
126
        outfile.write('\n')
114
128
 
115
129
 
116
130
def help_on_command_options(cmd, outfile=None):
117
 
    from bzrlib.option import Option
 
131
    from bzrlib.option import Option, get_optparser
 
132
    if outfile is None:
 
133
        outfile = sys.stdout
118
134
    options = cmd.options()
119
 
    if not options:
120
 
        return
121
 
    if outfile == None:
122
 
        outfile = sys.stdout
123
 
    outfile.write('\noptions:\n')
124
 
    for option_name, option in sorted(options.items()):
125
 
        l = '    --' + option_name
126
 
        if option.type is not None:
127
 
            l += ' ' + option.argname.upper()
128
 
        short_name = option.short_name()
129
 
        if short_name:
130
 
            assert len(short_name) == 1
131
 
            l += ', -' + short_name
132
 
        l += (30 - len(l)) * ' ' + option.help
133
 
        # TODO: split help over multiple lines with correct indenting and 
134
 
        # wrapping
135
 
        wrapped = textwrap.fill(l, initial_indent='', subsequent_indent=30*' ')
136
 
        outfile.write(wrapped + '\n')
 
135
    outfile.write('\n')
 
136
    outfile.write(get_optparser(options).format_option_help())
137
137
 
138
138
 
139
139
def help_commands(outfile=None):
142
142
                                 plugin_command_names,
143
143
                                 get_cmd_object)
144
144
 
145
 
    if outfile == None:
 
145
    if outfile is None:
146
146
        outfile = sys.stdout
147
147
 
148
148
    names = set()                       # to eliminate duplicates
156
156
        if cmd_object.hidden:
157
157
            continue
158
158
        print >>outfile, command_usage(cmd_object)
 
159
 
 
160
        plugin_name = cmd_object.plugin_name()
 
161
        print_command_plugin(cmd_object, outfile, '        %s\n')
 
162
 
159
163
        cmd_help = cmd_object.help()
160
164
        if cmd_help:
161
165
            firstline = cmd_help.split('\n', 1)[0]