← 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: Robert Collins
  • Date: 2009-09-07 03:08:30 UTC
  • mto: This revision was merged to the branch mainline in revision 4690.
  • Revision ID: robertc@robertcollins.net-20090907030830-rf59kt28d550eauj
Milestones language tightning, internal consistency.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tests/blackbox/test_help.py
1
 
# Copyright (C) 2005 by Canonical Ltd
2
 
# -*- coding: utf-8 -*-
3
 
 
 
1
# Copyright (C) 2005, 2006 Canonical Ltd
 
2
#
4
3
# This program is free software; you can redistribute it and/or modify
5
4
# it under the terms of the GNU General Public License as published by
6
5
# the Free Software Foundation; either version 2 of the License, or
7
6
# (at your option) any later version.
8
 
 
 
7
#
9
8
# This program is distributed in the hope that it will be useful,
10
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
11
# GNU General Public License for more details.
13
 
 
 
12
#
14
13
# You should have received a copy of the GNU General Public License
15
14
# along with this program; if not, write to the Free Software
16
 
# 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
17
16
 
18
17
 
19
18
"""Black-box tests for bzr help.
20
19
"""
21
20
 
22
21
 
 
22
import bzrlib
23
23
from bzrlib.tests.blackbox import ExternalBase
 
24
from bzrlib.config import (ensure_config_dir_exists, config_filename)
24
25
 
25
26
 
26
27
class TestHelp(ExternalBase):
27
28
 
28
29
    def test_help_basic(self):
29
 
        dash_help = self.runbzr('--help')[0]
30
 
        just_help = self.runbzr('help')[0]
31
 
        quest_mk  = self.runbzr('?')[0]
32
 
        self.assertEquals(dash_help, just_help)
33
 
        self.assertEquals(dash_help, quest_mk)
 
30
        for cmd in ['--help', 'help', '-h', '-?']:
 
31
            output = self.run_bzr(cmd)[0]
 
32
            line1 = output.split('\n')[0]
 
33
            if not line1.startswith('Bazaar'):
 
34
                self.fail("bad output from bzr %s:\n%r" % (cmd, output))
 
35
        # see https://launchpad.net/products/bzr/+bug/35940, -h doesn't work
 
36
 
 
37
    def test_help_topics(self):
 
38
        """Smoketest for 'bzr help topics'"""
 
39
        out, err = self.run_bzr('help topics')
 
40
        self.assertContainsRe(out, 'basic')
 
41
        self.assertContainsRe(out, 'topics')
 
42
        self.assertContainsRe(out, 'commands')
 
43
        self.assertContainsRe(out, 'revisionspec')
 
44
 
 
45
    def test_help_revisionspec(self):
 
46
        """Smoke test for 'bzr help revisionspec'"""
 
47
        out, err = self.run_bzr('help revisionspec')
 
48
        self.assertContainsRe(out, 'revno:')
 
49
        self.assertContainsRe(out, 'date:')
 
50
        self.assertContainsRe(out, 'revid:')
 
51
        self.assertContainsRe(out, 'last:')
 
52
        self.assertContainsRe(out, 'before:')
 
53
        self.assertContainsRe(out, 'ancestor:')
 
54
        self.assertContainsRe(out, 'branch:')
 
55
 
 
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')
 
61
 
 
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://')
 
73
 
 
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)
 
80
 
 
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)
 
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)
34
94
 
35
95
    def test_help_commands(self):
36
 
        dash_help  = self.runbzr('--help commands')[0]
37
 
        commands   = self.runbzr('help commands')[0]
38
 
        long_help  = self.runbzr('help --long')[0]
39
 
        qmark_long = self.runbzr('? --long')[0]
40
 
        qmark_cmds = self.runbzr('? commands')[0]
 
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]
41
102
        self.assertEquals(dash_help, commands)
42
103
        self.assertEquals(dash_help, long_help)
43
104
        self.assertEquals(dash_help, qmark_long)
44
105
        self.assertEquals(dash_help, qmark_cmds)
45
106
 
 
107
    def test_hidden(self):
 
108
        commands = self.run_bzr('help commands')[0]
 
109
        hidden = self.run_bzr('help hidden-commands')[0]
 
110
        self.assertTrue('commit' in commands)
 
111
        self.assertTrue('commit' not in hidden)
 
112
        self.assertTrue('rocks' in hidden)
 
113
        self.assertTrue('rocks' not in commands)
 
114
 
46
115
    def test_help_detail(self):
47
 
        dash_h  = self.runbzr('commit -h')[0]
48
 
        help_x  = self.runbzr('help commit')[0]
49
 
        qmark_x = self.runbzr('help commit')[0]
 
116
        dash_h  = self.run_bzr('diff -h')[0]
 
117
        help_x  = self.run_bzr('help diff')[0]
50
118
        self.assertEquals(dash_h, help_x)
51
 
        self.assertEquals(dash_h, qmark_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:")
 
126
 
 
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:")
52
136
 
53
137
    def test_help_help(self):
54
 
        help = self.runbzr('help help')[0]
55
 
        qmark = self.runbzr('? ?')[0]
 
138
        help = self.run_bzr('help help')[0]
 
139
        qmark = self.run_bzr('? ?')[0]
56
140
        self.assertEquals(help, qmark)
57
141
        for line in help.split('\n'):
58
142
            if '--long' in line:
59
 
                self.assertTrue('show help on all commands' in line)
 
143
                self.assertContainsRe(line,
 
144
                    r'Show help on all commands\.')
 
145
 
 
146
    def test_help_with_aliases(self):
 
147
        original = self.run_bzr('help cat')[0]
 
148
 
 
149
        ensure_config_dir_exists()
 
150
        CONFIG=("[ALIASES]\n"
 
151
        "c=cat\n"
 
152
        "cat=cat\n")
 
153
 
 
154
        open(config_filename(),'wb').write(CONFIG)
 
155
 
 
156
        expected = original + "'bzr cat' is an alias for 'bzr cat'.\n"
 
157
        self.assertEqual(expected, self.run_bzr('help cat')[0])
 
158
 
 
159
        self.assertEqual("'bzr c' is an alias for 'bzr cat'.\n",
 
160
                         self.run_bzr('help c')[0])