15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18
"""Black-box tests for bzr help.
18
"""Black-box tests for brz help.
23
from bzrlib.tests.blackbox import ExternalBase
24
from bzrlib.config import (ensure_config_dir_exists, config_filename)
27
class TestHelp(ExternalBase):
28
from breezy.tests.test_i18n import ZzzTranslations
31
class TestHelp(tests.TestCaseWithTransport):
29
33
def test_help_basic(self):
30
34
for cmd in ['--help', 'help', '-h', '-?']:
31
35
output = self.run_bzr(cmd)[0]
32
36
line1 = output.split('\n')[0]
33
if not line1.startswith('Bazaar'):
34
self.fail("bad output from bzr %s:\n%r" % (cmd, output))
37
if not line1.startswith('Breezy'):
38
self.fail("bad output from brz %s:\n%r" % (cmd, output))
35
39
# see https://launchpad.net/products/bzr/+bug/35940, -h doesn't work
37
41
def test_help_topics(self):
38
"""Smoketest for 'bzr help topics'"""
42
"""Smoketest for 'brz help topics'"""
39
43
out, err = self.run_bzr('help topics')
40
44
self.assertContainsRe(out, 'basic')
41
45
self.assertContainsRe(out, 'topics')
54
58
self.assertContainsRe(out, 'branch:')
56
60
def test_help_checkouts(self):
57
"""Smoke test for 'bzr help checkouts'"""
61
"""Smoke test for 'brz help checkouts'"""
58
62
out, err = self.run_bzr('help checkouts')
59
63
self.assertContainsRe(out, 'checkout')
60
64
self.assertContainsRe(out, 'lightweight')
62
66
def test_help_urlspec(self):
63
"""Smoke test for 'bzr help urlspec'"""
67
"""Smoke test for 'brz help urlspec'"""
64
68
out, err = self.run_bzr('help urlspec')
65
self.assertContainsRe(out, 'aftp://')
66
69
self.assertContainsRe(out, 'bzr://')
67
self.assertContainsRe(out, 'bzr\+ssh://')
70
self.assertContainsRe(out, 'bzr\\+ssh://')
68
71
self.assertContainsRe(out, 'file://')
69
self.assertContainsRe(out, 'ftp://')
70
72
self.assertContainsRe(out, 'http://')
71
73
self.assertContainsRe(out, 'https://')
72
74
self.assertContainsRe(out, 'sftp://')
74
76
def test_help_repositories(self):
75
"""Smoke test for 'bzr help repositories'"""
77
"""Smoke test for 'brz help repositories'"""
76
78
out, err = self.run_bzr('help repositories')
77
from bzrlib.help_topics import help_as_plain_text, _repositories
79
from breezy.help_topics import help_as_plain_text, _repositories
78
80
expected = help_as_plain_text(_repositories)
79
81
self.assertEqual(expected, out)
81
83
def test_help_working_trees(self):
82
"""Smoke test for 'bzr help working-trees'"""
84
"""Smoke test for 'brz help working-trees'"""
83
85
out, err = self.run_bzr('help working-trees')
84
from bzrlib.help_topics import help_as_plain_text, _working_trees
86
from breezy.help_topics import help_as_plain_text, _working_trees
85
87
expected = help_as_plain_text(_working_trees)
86
88
self.assertEqual(expected, out)
88
90
def test_help_status_flags(self):
89
"""Smoke test for 'bzr help status-flags'"""
91
"""Smoke test for 'brz help status-flags'"""
90
92
out, err = self.run_bzr('help status-flags')
91
from bzrlib.help_topics import help_as_plain_text, _status_flags
93
from breezy.help_topics import help_as_plain_text, _status_flags
92
94
expected = help_as_plain_text(_status_flags)
93
95
self.assertEqual(expected, out)
95
97
def test_help_commands(self):
96
dash_help = self.run_bzr('--help commands')[0]
97
commands = self.run_bzr('help commands')[0]
98
dash_help = self.run_bzr('--help commands')[0]
99
commands = self.run_bzr('help commands')[0]
98
100
hidden = self.run_bzr('help hidden-commands')[0]
99
long_help = self.run_bzr('help --long')[0]
101
long_help = self.run_bzr('help --long')[0]
100
102
qmark_long = self.run_bzr('? --long')[0]
101
103
qmark_cmds = self.run_bzr('? commands')[0]
102
self.assertEquals(dash_help, commands)
103
self.assertEquals(dash_help, long_help)
104
self.assertEquals(dash_help, qmark_long)
105
self.assertEquals(dash_help, qmark_cmds)
104
self.assertEqual(dash_help, commands)
105
self.assertEqual(dash_help, long_help)
106
self.assertEqual(dash_help, qmark_long)
107
self.assertEqual(dash_help, qmark_cmds)
109
def test_help_width_zero(self):
110
self.overrideEnv('BRZ_COLUMNS', '0')
111
self.run_bzr('help commands')
107
113
def test_hidden(self):
108
114
help_commands = self.run_bzr('help commands')[0]
128
134
self.assertTrue('rocks' not in commands)
130
136
def test_help_detail(self):
131
dash_h = self.run_bzr('diff -h')[0]
132
help_x = self.run_bzr('help diff')[0]
133
self.assertEquals(dash_h, help_x)
137
dash_h = self.run_bzr('diff -h')[0]
138
help_x = self.run_bzr('help diff')[0]
139
self.assertEqual(dash_h, help_x)
134
140
self.assertContainsRe(help_x, "Purpose:")
135
141
self.assertContainsRe(help_x, "Usage:")
136
142
self.assertContainsRe(help_x, "Options:")
152
158
def test_help_help(self):
153
159
help = self.run_bzr('help help')[0]
154
160
qmark = self.run_bzr('? ?')[0]
155
self.assertEquals(help, qmark)
161
self.assertEqual(help, qmark)
156
162
for line in help.split('\n'):
157
163
if '--long' in line:
158
164
self.assertContainsRe(line,
159
r'Show help on all commands\.')
165
r'Show help on all commands\.')
161
167
def test_help_with_aliases(self):
162
168
original = self.run_bzr('help cat')[0]
164
ensure_config_dir_exists()
165
CONFIG=("[ALIASES]\n"
169
open(config_filename(),'wb').write(CONFIG)
171
expected = original + "'bzr cat' is an alias for 'bzr cat'.\n"
170
conf = config.GlobalConfig.from_string('''[ALIASES]
175
expected = original + "'brz cat' is an alias for 'brz cat'.\n"
172
176
self.assertEqual(expected, self.run_bzr('help cat')[0])
174
self.assertEqual("'bzr c' is an alias for 'bzr cat'.\n",
178
self.assertEqual("'brz c' is an alias for 'brz cat'.\n",
175
179
self.run_bzr('help c')[0])
182
class TestTranslatedHelp(tests.TestCaseWithTransport):
183
"""Tests for display of translated help topics"""
186
super(TestTranslatedHelp, self).setUp()
187
self.overrideAttr(i18n, '_translations', ZzzTranslations())
189
def test_help_command_utf8(self):
190
out, err = self.run_bzr_raw(["help", "push"], encoding="utf-8")
191
self.assertContainsRe(out, b"zz\xc3\xa5{{:See also:")
193
def test_help_switch_utf8(self):
194
out, err = self.run_bzr_raw(["push", "--help"], encoding="utf-8")
195
self.assertContainsRe(out, b"zz\xc3\xa5{{:See also:")
197
def test_help_command_ascii(self):
198
out, err = self.run_bzr_raw(["help", "push"], encoding="ascii")
199
self.assertContainsRe(out, b"zz\\?{{:See also:")
201
def test_help_switch_ascii(self):
202
out, err = self.run_bzr_raw(["push", "--help"], encoding="ascii")
203
self.assertContainsRe(out, b"zz\\?{{:See also:")