← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/blackbox/test_help.py

  • Committer: Aaron Bentley
  • Date: 2007-06-21 23:43:17 UTC
  • mto: (2520.5.2 bzr.mpbundle)
  • mto: This revision was merged to the branch mainline in revision 2631.
  • Revision ID: abentley@panoramicfeedback.com-20070621234317-5w3h8h36oe90sups
Implement new merge directive format

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tests/blackbox/test_help.py
1
 
# Copyright (C) 2006, 2007, 2009, 2010 Canonical Ltd
 
1
# Copyright (C) 2005, 2006 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
12
12
#
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
16
16
 
17
17
 
18
18
"""Black-box tests for bzr help.
21
21
 
22
22
import bzrlib
23
23
from bzrlib.tests.blackbox import ExternalBase
24
 
from bzrlib.config import (ensure_config_dir_exists, config_filename)
25
24
 
26
25
 
27
26
class TestHelp(ExternalBase):
28
27
 
29
28
    def test_help_basic(self):
30
29
        for cmd in ['--help', 'help', '-h', '-?']:
31
 
            output = self.run_bzr(cmd)[0]
 
30
            output = self.runbzr(cmd)[0]
32
31
            line1 = output.split('\n')[0]
33
32
            if not line1.startswith('Bazaar'):
34
33
                self.fail("bad output from bzr %s:\n%r" % (cmd, output))
36
35
 
37
36
    def test_help_topics(self):
38
37
        """Smoketest for 'bzr help topics'"""
39
 
        out, err = self.run_bzr('help topics')
 
38
        out, err = self.run_bzr('help', 'topics')
40
39
        self.assertContainsRe(out, 'basic')
41
40
        self.assertContainsRe(out, 'topics')
42
41
        self.assertContainsRe(out, 'commands')
44
43
 
45
44
    def test_help_revisionspec(self):
46
45
        """Smoke test for 'bzr help revisionspec'"""
47
 
        out, err = self.run_bzr('help revisionspec')
 
46
        out, err = self.run_bzr('help', 'revisionspec')
48
47
        self.assertContainsRe(out, 'revno:')
49
48
        self.assertContainsRe(out, 'date:')
50
49
        self.assertContainsRe(out, 'revid:')
55
54
 
56
55
    def test_help_checkouts(self):
57
56
        """Smoke test for 'bzr help checkouts'"""
58
 
        out, err = self.run_bzr('help checkouts')
 
57
        out, err = self.runbzr('help checkouts')
59
58
        self.assertContainsRe(out, 'checkout')
60
59
        self.assertContainsRe(out, 'lightweight')
61
 
 
 
60
        
62
61
    def test_help_urlspec(self):
63
62
        """Smoke test for 'bzr help urlspec'"""
64
 
        out, err = self.run_bzr('help urlspec')
 
63
        out, err = self.run_bzr('help', 'urlspec')
65
64
        self.assertContainsRe(out, 'aftp://')
66
65
        self.assertContainsRe(out, 'bzr://')
67
66
        self.assertContainsRe(out, 'bzr\+ssh://')
73
72
 
74
73
    def test_help_repositories(self):
75
74
        """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)
 
75
        out, err = self.runbzr('help repositories')
 
76
        self.assertEqual(bzrlib.help_topics._repositories, out)
80
77
 
81
78
    def test_help_working_trees(self):
82
79
        """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)
87
 
 
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)
 
80
        out, err = self.runbzr('help working-trees')
 
81
        self.assertEqual(bzrlib.help_topics._working_trees, out)
94
82
 
95
83
    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]
 
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]
102
90
        self.assertEquals(dash_help, commands)
103
91
        self.assertEquals(dash_help, long_help)
104
92
        self.assertEquals(dash_help, qmark_long)
105
93
        self.assertEquals(dash_help, qmark_cmds)
106
94
 
107
95
    def test_hidden(self):
108
 
        help_commands = self.run_bzr('help commands')[0]
109
 
        help_hidden = self.run_bzr('help hidden-commands')[0]
110
 
 
111
 
        def extract_cmd_names(help_output):
112
 
            # keep only the command names to avoid matching on help text (there
113
 
            # is a high risk to fail a test when a plugin get installed
114
 
            # otherwise)
115
 
            cmds = []
116
 
            for line in help_output.split('\n'):
117
 
                if line.startswith(' '):
118
 
                    continue # help on more than one line
119
 
                cmd = line.split(' ')[0]
120
 
                if line:
121
 
                    cmds.append(cmd)
122
 
            return cmds
123
 
        commands = extract_cmd_names(help_commands)
124
 
        hidden = extract_cmd_names(help_hidden)
 
96
        commands = self.runbzr('help commands')[0]
 
97
        hidden = self.runbzr('help hidden-commands')[0]
125
98
        self.assertTrue('commit' in commands)
126
99
        self.assertTrue('commit' not in hidden)
127
100
        self.assertTrue('rocks' in hidden)
128
101
        self.assertTrue('rocks' not in commands)
129
102
 
130
103
    def test_help_detail(self):
131
 
        dash_h  = self.run_bzr('diff -h')[0]
132
 
        help_x  = self.run_bzr('help diff')[0]
 
104
        dash_h  = self.runbzr('commit -h')[0]
 
105
        help_x  = self.runbzr('help commit')[0]
 
106
        qmark_x = self.runbzr('help commit')[0]
133
107
        self.assertEquals(dash_h, help_x)
134
 
        self.assertContainsRe(help_x, "Purpose:")
135
 
        self.assertContainsRe(help_x, "Usage:")
136
 
        self.assertContainsRe(help_x, "Options:")
137
 
        self.assertContainsRe(help_x, "Description:")
138
 
        self.assertContainsRe(help_x, "Examples:")
139
 
        self.assertContainsRe(help_x, "See also:")
140
 
        self.assertContainsRe(help_x, "Aliases:")
141
 
 
142
 
    def test_help_usage(self):
143
 
        usage  = self.run_bzr('diff --usage')[0]
144
 
        self.assertContainsRe(usage, "Purpose:")
145
 
        self.assertContainsRe(usage, "Usage:")
146
 
        self.assertContainsRe(usage, "Options:")
147
 
        self.assertNotContainsRe(usage, "Description:")
148
 
        self.assertNotContainsRe(usage, "Examples:")
149
 
        self.assertContainsRe(usage, "See also:")
150
 
        self.assertContainsRe(usage, "Aliases:")
 
108
        self.assertEquals(dash_h, qmark_x)
151
109
 
152
110
    def test_help_help(self):
153
 
        help = self.run_bzr('help help')[0]
154
 
        qmark = self.run_bzr('? ?')[0]
 
111
        help = self.runbzr('help help')[0]
 
112
        qmark = self.runbzr('? ?')[0]
155
113
        self.assertEquals(help, qmark)
156
114
        for line in help.split('\n'):
157
115
            if '--long' in line:
158
 
                self.assertContainsRe(line,
159
 
                    r'Show help on all commands\.')
160
 
 
161
 
    def test_help_with_aliases(self):
162
 
        original = self.run_bzr('help cat')[0]
163
 
 
164
 
        ensure_config_dir_exists()
165
 
        CONFIG=("[ALIASES]\n"
166
 
        "c=cat\n"
167
 
        "cat=cat\n")
168
 
 
169
 
        open(config_filename(),'wb').write(CONFIG)
170
 
 
171
 
        expected = original + "'bzr cat' is an alias for 'bzr cat'.\n"
172
 
        self.assertEqual(expected, self.run_bzr('help cat')[0])
173
 
 
174
 
        self.assertEqual("'bzr c' is an alias for 'bzr cat'.\n",
175
 
                         self.run_bzr('help c')[0])
 
116
                self.assertTrue('show help on all commands' in line)