1
# Copyright (C) 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
18
"""Black-box tests for bzr help.
23
from bzrlib.tests.blackbox import ExternalBase
26
class TestHelp(ExternalBase):
28
def test_help_basic(self):
29
for cmd in ['--help', 'help', '-h', '-?']:
30
output = self.runbzr(cmd)[0]
31
line1 = output.split('\n')[0]
32
if not line1.startswith('Bazaar'):
33
self.fail("bad output from bzr %s:\n%r" % (cmd, output))
34
# see https://launchpad.net/products/bzr/+bug/35940, -h doesn't work
36
def test_help_topics(self):
37
"""Smoketest for 'bzr help topics'"""
38
out, err = self.run_bzr('help', 'topics')
39
self.assertContainsRe(out, 'basic')
40
self.assertContainsRe(out, 'topics')
41
self.assertContainsRe(out, 'commands')
42
self.assertContainsRe(out, 'revisionspec')
44
def test_help_revisionspec(self):
45
"""Smoke test for 'bzr help revisionspec'"""
46
out, err = self.run_bzr('help', 'revisionspec')
47
self.assertContainsRe(out, 'revno:')
48
self.assertContainsRe(out, 'date:')
49
self.assertContainsRe(out, 'revid:')
50
self.assertContainsRe(out, 'last:')
51
self.assertContainsRe(out, 'before:')
52
self.assertContainsRe(out, 'ancestor:')
53
self.assertContainsRe(out, 'branch:')
55
def test_help_checkouts(self):
56
"""Smoke test for 'bzr help checkouts'"""
57
out, err = self.runbzr('help checkouts')
58
self.assertContainsRe(out, 'checkout')
59
self.assertContainsRe(out, 'lightweight')
61
def test_help_urlspec(self):
62
"""Smoke test for 'bzr help urlspec'"""
63
out, err = self.run_bzr('help', 'urlspec')
64
self.assertContainsRe(out, 'aftp://')
65
self.assertContainsRe(out, 'bzr://')
66
self.assertContainsRe(out, 'bzr\+ssh://')
67
self.assertContainsRe(out, 'file://')
68
self.assertContainsRe(out, 'ftp://')
69
self.assertContainsRe(out, 'http://')
70
self.assertContainsRe(out, 'https://')
71
self.assertContainsRe(out, 'sftp://')
73
def test_help_repositories(self):
74
"""Smoke test for 'bzr help repositories'"""
75
out, err = self.runbzr('help repositories')
76
self.assertEqual(bzrlib.help_topics._repositories, out)
78
def test_help_working_trees(self):
79
"""Smoke test for 'bzr help working-trees'"""
80
out, err = self.runbzr('help working-trees')
81
self.assertEqual(bzrlib.help_topics._working_trees, out)
83
def test_help_commands(self):
84
dash_help = self.runbzr('--help commands')[0]
85
commands = self.runbzr('help commands')[0]
86
hidden = self.runbzr('help hidden-commands')[0]
87
long_help = self.runbzr('help --long')[0]
88
qmark_long = self.runbzr('? --long')[0]
89
qmark_cmds = self.runbzr('? commands')[0]
90
self.assertEquals(dash_help, commands)
91
self.assertEquals(dash_help, long_help)
92
self.assertEquals(dash_help, qmark_long)
93
self.assertEquals(dash_help, qmark_cmds)
95
def test_hidden(self):
96
commands = self.runbzr('help commands')[0]
97
hidden = self.runbzr('help hidden-commands')[0]
98
self.assertTrue('commit' in commands)
99
self.assertTrue('commit' not in hidden)
100
self.assertTrue('rocks' in hidden)
101
self.assertTrue('rocks' not in commands)
103
def test_help_detail(self):
104
dash_h = self.runbzr('commit -h')[0]
105
help_x = self.runbzr('help commit')[0]
106
qmark_x = self.runbzr('help commit')[0]
107
self.assertEquals(dash_h, help_x)
108
self.assertEquals(dash_h, qmark_x)
110
def test_help_help(self):
111
help = self.runbzr('help help')[0]
112
qmark = self.runbzr('? ?')[0]
113
self.assertEquals(help, qmark)
114
for line in help.split('\n'):
116
self.assertTrue('show help on all commands' in line)