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
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19
19
from bzrlib import (
28
from bzrlib.builtins import cmd_commit, cmd_log, cmd_status
25
from bzrlib.builtins import cmd_commit
29
26
from bzrlib.commands import Command, parse_args
30
27
from bzrlib.tests import TestCase
31
28
from bzrlib.repofmt import knitrepo
42
39
def test_parse_args(self):
43
40
"""Option parser"""
44
eq = self.assertEquals
45
eq(parse_args(cmd_commit(), ['--help']),
46
([], {'fixes': [], 'help': True}))
47
eq(parse_args(cmd_commit(), ['--message=biter']),
48
([], {'fixes': [], 'message': 'biter'}))
41
# XXX: Using cmd_commit makes these tests overly sensitive to changes
42
# to cmd_commit, when they are meant to be about option parsing in
44
self.assertEqual(parse_args(cmd_commit(), ['--help']),
45
([], {'author': [], 'exclude': [], 'fixes': [], 'help': True}))
46
self.assertEqual(parse_args(cmd_commit(), ['--message=biter']),
47
([], {'author': [], 'exclude': [], 'fixes': [], 'message': 'biter'}))
50
49
def test_no_more_opts(self):
51
50
"""Terminated options"""
52
self.assertEquals(parse_args(cmd_commit(), ['--', '-file-with-dashes']),
53
(['-file-with-dashes'], {'fixes': []}))
51
self.assertEqual(parse_args(cmd_commit(), ['--', '-file-with-dashes']),
52
(['-file-with-dashes'], {'author': [], 'exclude': [], 'fixes': []}))
55
54
def test_option_help(self):
56
55
"""Options have help strings."""
67
66
def test_option_arg_help(self):
68
67
"""Help message shows option arguments."""
69
68
out, err = self.run_bzr('help commit')
70
self.assertEquals(err, '')
69
self.assertEqual(err, '')
71
70
self.assertContainsRe(out, r'--file[ =]MSGFILE')
73
72
def test_unknown_short_opt(self):
82
81
def test_allow_dash(self):
83
82
"""Test that we can pass a plain '-' as an argument."""
85
(['-'], {'fixes': []}), parse_args(cmd_commit(), ['-']))
83
self.assertEqual((['-']), parse_args(cmd_commit(), ['-'])[0])
87
85
def parse(self, options, args):
88
86
parser = option.get_optparser(dict((o.name, o) for o in options))
93
91
opts, args = self.parse(options, ['--no-hello', '--hello'])
94
92
self.assertEqual(True, opts.hello)
95
93
opts, args = self.parse(options, [])
96
self.assertEqual(option.OptionParser.DEFAULT_VALUE, opts.hello)
94
self.assertFalse(hasattr(opts, 'hello'))
97
95
opts, args = self.parse(options, ['--hello', '--no-hello'])
98
96
self.assertEqual(False, opts.hello)
99
97
options = [option.Option('number', type=int)]
104
102
self.assertRaises(errors.BzrCommandError, self.parse, options,
105
def test_is_hidden(self):
106
self.assertTrue(option.Option('foo', hidden=True).is_hidden('foo'))
107
self.assertFalse(option.Option('foo', hidden=False).is_hidden('foo'))
107
109
def test_registry_conversion(self):
108
110
registry = bzrdir.BzrDirFormatRegistry()
109
111
registry.register_metadir('one', 'RepositoryFormat7', 'one help')
153
155
self.assertIsInstance(opts.format.repository_format,
154
156
knitrepo.RepositoryFormatKnit1)
158
def test_lazy_registry(self):
159
options = [option.RegistryOption('format', '',
160
lazy_registry=('bzrlib.bzrdir','format_registry'),
162
opts, args = self.parse(options, ['--format', 'knit'])
163
self.assertEqual({'format': 'knit'}, opts)
165
errors.BadOptionValue, self.parse, options, ['--format', 'BAD'])
156
167
def test_from_kwargs(self):
157
168
my_option = option.RegistryOption.from_kwargs('my-option',
158
169
help='test option', short='be short', be_long='go long')
214
225
('two', None, None, 'two help'),
228
def test_option_callback_bool(self):
229
"Test booleans get True and False passed correctly to a callback."""
231
def cb(option, name, value, parser):
232
cb_calls.append((option,name,value,parser))
233
options = [option.Option('hello', custom_callback=cb)]
234
opts, args = self.parse(options, ['--hello', '--no-hello'])
235
self.assertEqual(2, len(cb_calls))
236
opt,name,value,parser = cb_calls[0]
237
self.assertEqual('hello', name)
238
self.assertTrue(value)
239
opt,name,value,parser = cb_calls[1]
240
self.assertEqual('hello', name)
241
self.assertFalse(value)
243
def test_option_callback_str(self):
244
"""Test callbacks work for string options both long and short."""
246
def cb(option, name, value, parser):
247
cb_calls.append((option,name,value,parser))
248
options = [option.Option('hello', type=str, custom_callback=cb,
250
opts, args = self.parse(options, ['--hello', 'world', '-h', 'mars'])
251
self.assertEqual(2, len(cb_calls))
252
opt,name,value,parser = cb_calls[0]
253
self.assertEqual('hello', name)
254
self.assertEqual('world', value)
255
opt,name,value,parser = cb_calls[1]
256
self.assertEqual('hello', name)
257
self.assertEqual('mars', value)
218
260
class TestListOptions(TestCase):
219
261
"""Tests for ListOption, used to specify lists on the command-line."""
227
269
opts, args = self.parse(options, ['--hello=world', '--hello=sailor'])
228
270
self.assertEqual(['world', 'sailor'], opts.hello)
272
def test_list_option_with_dash(self):
273
options = [option.ListOption('with-dash', type=str)]
274
opts, args = self.parse(options, ['--with-dash=world',
275
'--with-dash=sailor'])
276
self.assertEqual(['world', 'sailor'], opts.with_dash)
230
278
def test_list_option_no_arguments(self):
231
279
options = [option.ListOption('hello', type=str)]
232
280
opts, args = self.parse(options, [])
250
298
options, ['--hello=a', '--hello=b', '--hello=-', '--hello=c'])
251
299
self.assertEqual(['c'], opts.hello)
301
def test_option_callback_list(self):
302
"""Test callbacks work for list options."""
304
def cb(option, name, value, parser):
305
# Note that the value is a reference so copy to keep it
306
cb_calls.append((option,name,value[:],parser))
307
options = [option.ListOption('hello', type=str, custom_callback=cb)]
308
opts, args = self.parse(options, ['--hello=world', '--hello=mars',
310
self.assertEqual(3, len(cb_calls))
311
opt,name,value,parser = cb_calls[0]
312
self.assertEqual('hello', name)
313
self.assertEqual(['world'], value)
314
opt,name,value,parser = cb_calls[1]
315
self.assertEqual('hello', name)
316
self.assertEqual(['world', 'mars'], value)
317
opt,name,value,parser = cb_calls[2]
318
self.assertEqual('hello', name)
319
self.assertEqual([], value)
254
322
class TestOptionDefinitions(TestCase):
255
323
"""Tests for options in the Bazaar codebase."""
257
325
def get_builtin_command_options(self):
259
for cmd_name, cmd_class in sorted(commands.get_all_cmds()):
327
for cmd_name in sorted(commands.all_command_names()):
328
cmd = commands.get_cmd_object(cmd_name)
261
329
for opt_name, opt in sorted(cmd.options().items()):
262
330
g.append((cmd_name, opt))
270
338
g = dict(option.Option.OPTIONS.items())
271
339
used_globals = {}
273
for cmd_name, cmd_class in sorted(commands.get_all_cmds()):
274
for option_or_name in sorted(cmd_class.takes_options):
341
for cmd_name in sorted(commands.all_command_names()):
342
cmd = commands.get_cmd_object(cmd_name)
343
for option_or_name in sorted(cmd.takes_options):
275
344
if not isinstance(option_or_name, basestring):
276
345
self.assertIsInstance(option_or_name, option.Option)
277
346
elif not option_or_name in g:
278
347
msgs.append("apparent reference to undefined "
279
348
"global option %r from %r"
280
% (option_or_name, cmd_class))
349
% (option_or_name, cmd))
282
351
used_globals.setdefault(option_or_name, []).append(cmd_name)
283
352
unused_globals = set(g.keys()) - set(used_globals.keys())
298
367
# period and be all on a single line, because the display code will
300
369
option_re = re.compile(r'^[A-Z][^\n]+\.$')
301
for scope, option in self.get_builtin_command_options():
303
msgs.append('%-16s %-16s %s' %
304
((scope or 'GLOBAL'), option.name, 'NO HELP'))
305
elif not option_re.match(option.help):
306
msgs.append('%-16s %-16s %s' %
307
((scope or 'GLOBAL'), option.name, option.help))
370
for scope, opt in self.get_builtin_command_options():
372
msgs.append('%-16s %-16s %s' %
373
((scope or 'GLOBAL'), opt.name, 'NO HELP'))
374
elif not option_re.match(opt.help):
375
msgs.append('%-16s %-16s %s' %
376
((scope or 'GLOBAL'), opt.name, opt.help))
309
378
self.fail("The following options don't match the style guide:\n"
310
379
+ '\n'.join(msgs))
318
387
format = option.RegistryOption('format', '', registry, str)
319
388
self.assertTrue(format.is_hidden('hidden'))
320
389
self.assertFalse(format.is_hidden('visible'))
391
def test_option_custom_help(self):
392
the_opt = option.Option.OPTIONS['help']
393
orig_help = the_opt.help[:]
394
my_opt = option.custom_help('help', 'suggest lottery numbers')
395
# Confirm that my_opt has my help and the original is unchanged
396
self.assertEqual('suggest lottery numbers', my_opt.help)
397
self.assertEqual(orig_help, the_opt.help)
400
class TestVerboseQuietLinkage(TestCase):
402
def check(self, parser, level, args):
403
option._verbosity_level = 0
404
opts, args = parser.parse_args(args)
405
self.assertEqual(level, option._verbosity_level)
407
def test_verbose_quiet_linkage(self):
408
parser = option.get_optparser(option.Option.STD_OPTIONS)
409
self.check(parser, 0, [])
410
self.check(parser, 1, ['-v'])
411
self.check(parser, 2, ['-v', '-v'])
412
self.check(parser, -1, ['-q'])
413
self.check(parser, -2, ['-qq'])
414
self.check(parser, -1, ['-v', '-v', '-q'])
415
self.check(parser, 2, ['-q', '-v', '-v'])
416
self.check(parser, 0, ['--no-verbose'])
417
self.check(parser, 0, ['-v', '-q', '--no-quiet'])