← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/help.py

  • Committer: Robey Pointer
  • Date: 2006-07-01 19:03:33 UTC
  • mfrom: (1829 +trunk)
  • mto: This revision was merged to the branch mainline in revision 1830.
  • Revision ID: robey@lag.net-20060701190333-f58465aec4bd3412
merge from bzr.dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help.py
1
 
# Copyright (C) 2004, 2005 by Canonical Ltd
 
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
20
20
# executable files with reasonable names.
21
21
 
22
22
# TODO: `help commands --all` should show hidden commands
 
23
import textwrap
23
24
 
24
25
global_help = \
25
26
"""Bazaar-NG -- a free distributed version-control tool
26
 
http://bazaar-ng.org/
27
 
 
28
 
WARNING: This is an unstable development version.
29
 
         Please keep backups.
 
27
http://bazaar-vcs.org/
30
28
 
31
29
Basic commands:
32
30
 
87
85
    return s
88
86
 
89
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
 
90
100
def help_on_command(cmdname, outfile=None):
91
101
    from bzrlib.commands import get_cmd_object
92
102
 
109
119
 
110
120
    print >>outfile
111
121
 
 
122
    print_command_plugin(cmd_object, outfile, '%s\n\n')
 
123
 
112
124
    outfile.write(doc)
113
125
    if doc[-1] != '\n':
114
126
        outfile.write('\n')
115
 
    
116
 
    help_on_options(cmd_object.takes_options, outfile=None)
117
 
 
118
 
 
119
 
def help_on_options(options, outfile=None):
120
 
    from bzrlib.commands import SHORT_OPTIONS
121
 
    
 
127
    help_on_command_options(cmd_object, outfile)
 
128
 
 
129
 
 
130
def help_on_command_options(cmd, outfile=None):
 
131
    from bzrlib.option import Option
 
132
    options = cmd.options()
122
133
    if not options:
123
134
        return
124
 
    
125
135
    if outfile == None:
126
136
        outfile = sys.stdout
127
 
 
128
137
    outfile.write('\noptions:\n')
129
 
    for on in options:
130
 
        l = '    --' + on
131
 
        for shortname, longname in SHORT_OPTIONS.items():
132
 
            if longname == on:
133
 
                l += ', -' + shortname
134
 
                break
135
 
        outfile.write(l + '\n')
 
138
    for option_name, option in sorted(options.items()):
 
139
        l = '    --' + option_name
 
140
        if option.type is not None:
 
141
            l += ' ' + option.argname.upper()
 
142
        short_name = option.short_name()
 
143
        if short_name:
 
144
            assert len(short_name) == 1
 
145
            l += ', -' + short_name
 
146
        l += (30 - len(l)) * ' ' + option.help
 
147
        # TODO: split help over multiple lines with correct indenting and 
 
148
        # wrapping
 
149
        wrapped = textwrap.fill(l, initial_indent='', subsequent_indent=30*' ')
 
150
        outfile.write(wrapped + '\n')
136
151
 
137
152
 
138
153
def help_commands(outfile=None):
155
170
        if cmd_object.hidden:
156
171
            continue
157
172
        print >>outfile, command_usage(cmd_object)
 
173
 
 
174
        plugin_name = cmd_object.plugin_name()
 
175
        print_command_plugin(cmd_object, outfile, '        %s\n')
 
176
 
158
177
        cmd_help = cmd_object.help()
159
178
        if cmd_help:
160
179
            firstline = cmd_help.split('\n', 1)[0]
161
 
            print >>outfile, '    ' + firstline
 
180
            print >>outfile, '        ' + firstline
162
181