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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
18
"""Black-box tests for bzr help.
23
22
from bzrlib.tests.blackbox import ExternalBase
24
from bzrlib.config import (ensure_config_dir_exists, config_filename)
27
25
class TestHelp(ExternalBase):
29
27
def test_help_basic(self):
30
28
for cmd in ['--help', 'help', '-h', '-?']:
31
output = self.run_bzr(cmd)[0]
29
output = self.runbzr(cmd)[0]
32
30
line1 = output.split('\n')[0]
33
31
if not line1.startswith('Bazaar'):
34
32
self.fail("bad output from bzr %s:\n%r" % (cmd, output))
53
51
self.assertContainsRe(out, 'ancestor:')
54
52
self.assertContainsRe(out, 'branch:')
56
def test_help_checkouts(self):
57
"""Smoke test for 'bzr help checkouts'"""
58
out, err = self.run_bzr('help checkouts')
59
self.assertContainsRe(out, 'checkout')
60
self.assertContainsRe(out, 'lightweight')
62
def test_help_urlspec(self):
63
"""Smoke test for 'bzr help urlspec'"""
64
out, err = self.run_bzr('help urlspec')
65
self.assertContainsRe(out, 'aftp://')
66
self.assertContainsRe(out, 'bzr://')
67
self.assertContainsRe(out, 'bzr\+ssh://')
68
self.assertContainsRe(out, 'file://')
69
self.assertContainsRe(out, 'ftp://')
70
self.assertContainsRe(out, 'http://')
71
self.assertContainsRe(out, 'https://')
72
self.assertContainsRe(out, 'sftp://')
74
def test_help_repositories(self):
75
"""Smoke test for 'bzr help repositories'"""
76
out, err = self.run_bzr('help repositories')
77
from bzrlib.help_topics import help_as_plain_text, _repositories
78
expected = help_as_plain_text(_repositories)
79
self.assertEqual(expected, out)
81
def test_help_working_trees(self):
82
"""Smoke test for 'bzr help working-trees'"""
83
out, err = self.run_bzr('help working-trees')
84
from bzrlib.help_topics import help_as_plain_text, _working_trees
85
expected = help_as_plain_text(_working_trees)
86
self.assertEqual(expected, out)
88
def test_help_status_flags(self):
89
"""Smoke test for 'bzr help status-flags'"""
90
out, err = self.run_bzr('help status-flags')
91
from bzrlib.help_topics import help_as_plain_text, _status_flags
92
expected = help_as_plain_text(_status_flags)
93
self.assertEqual(expected, out)
95
54
def test_help_commands(self):
96
dash_help = self.run_bzr('--help commands')[0]
97
commands = self.run_bzr('help commands')[0]
98
hidden = self.run_bzr('help hidden-commands')[0]
99
long_help = self.run_bzr('help --long')[0]
100
qmark_long = self.run_bzr('? --long')[0]
101
qmark_cmds = self.run_bzr('? commands')[0]
55
dash_help = self.runbzr('--help commands')[0]
56
commands = self.runbzr('help commands')[0]
57
hidden = self.runbzr('help hidden-commands')[0]
58
long_help = self.runbzr('help --long')[0]
59
qmark_long = self.runbzr('? --long')[0]
60
qmark_cmds = self.runbzr('? commands')[0]
102
61
self.assertEquals(dash_help, commands)
103
62
self.assertEquals(dash_help, long_help)
104
63
self.assertEquals(dash_help, qmark_long)
105
64
self.assertEquals(dash_help, qmark_cmds)
107
66
def test_hidden(self):
108
commands = self.run_bzr('help commands')[0]
109
hidden = self.run_bzr('help hidden-commands')[0]
67
commands = self.runbzr('help commands')[0]
68
hidden = self.runbzr('help hidden-commands')[0]
110
69
self.assertTrue('commit' in commands)
111
70
self.assertTrue('commit' not in hidden)
112
71
self.assertTrue('rocks' in hidden)
113
72
self.assertTrue('rocks' not in commands)
115
74
def test_help_detail(self):
116
dash_h = self.run_bzr('diff -h')[0]
117
help_x = self.run_bzr('help diff')[0]
75
dash_h = self.runbzr('commit -h')[0]
76
help_x = self.runbzr('help commit')[0]
77
qmark_x = self.runbzr('help commit')[0]
118
78
self.assertEquals(dash_h, help_x)
119
self.assertContainsRe(help_x, "Purpose:")
120
self.assertContainsRe(help_x, "Usage:")
121
self.assertContainsRe(help_x, "Options:")
122
self.assertContainsRe(help_x, "Description:")
123
self.assertContainsRe(help_x, "Examples:")
124
self.assertContainsRe(help_x, "See also:")
125
self.assertContainsRe(help_x, "Aliases:")
127
def test_help_usage(self):
128
usage = self.run_bzr('diff --usage')[0]
129
self.assertContainsRe(usage, "Purpose:")
130
self.assertContainsRe(usage, "Usage:")
131
self.assertContainsRe(usage, "Options:")
132
self.assertNotContainsRe(usage, "Description:")
133
self.assertNotContainsRe(usage, "Examples:")
134
self.assertContainsRe(usage, "See also:")
135
self.assertContainsRe(usage, "Aliases:")
79
self.assertEquals(dash_h, qmark_x)
137
81
def test_help_help(self):
138
help = self.run_bzr('help help')[0]
139
qmark = self.run_bzr('? ?')[0]
82
help = self.runbzr('help help')[0]
83
qmark = self.runbzr('? ?')[0]
140
84
self.assertEquals(help, qmark)
141
85
for line in help.split('\n'):
142
86
if '--long' in line:
143
self.assertContainsRe(line,
144
r'Show help on all commands\.')
146
def test_help_with_aliases(self):
147
original = self.run_bzr('help cat')[0]
149
ensure_config_dir_exists()
150
CONFIG=("[ALIASES]\n"
154
open(config_filename(),'wb').write(CONFIG)
156
expected = original + "'bzr cat' is an alias for 'bzr cat'.\n"
157
self.assertEqual(expected, self.run_bzr('help cat')[0])
159
self.assertEqual("'bzr c' is an alias for 'bzr cat'.\n",
160
self.run_bzr('help c')[0])
87
self.assertTrue('show help on all commands' in line)