~bzr-pqm/bzr/bzr.dev

2052.3.2 by John Arbash Meinel
Change Copyright .. by Canonical to Copyright ... Canonical
1
# Copyright (C) 2004, 2005 Canonical Ltd
1887.1.1 by Adeodato Simó
Do not separate paragraphs in the copyright statement with blank lines,
2
#
1185.12.59 by Aaron Bentley
Added command-quieting test
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.
1887.1.1 by Adeodato Simó
Do not separate paragraphs in the copyright statement with blank lines,
7
#
1185.12.59 by Aaron Bentley
Added command-quieting test
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.
1887.1.1 by Adeodato Simó
Do not separate paragraphs in the copyright statement with blank lines,
12
#
1185.12.59 by Aaron Bentley
Added command-quieting test
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
4183.7.1 by Sabin Iacob
update FSF mailing address
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
1185.12.59 by Aaron Bentley
Added command-quieting test
16
2155.2.3 by Marius Kruger
* commands.py
17
from cStringIO import StringIO
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
18
import errno
3785.1.4 by Aaron Bentley
Enable lazy-loading of commands
19
import sys
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
20
21
from bzrlib import (
4000.1.1 by Robert Collins
Add a new hook Commands['extend_command'] for plugins that want to alter commands without overriding the entire command.
22
    builtins,
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
23
    commands,
2155.2.1 by Marius Kruger
* Get command aliases to respect quoted arguments.
24
    config,
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
25
    errors,
2425.2.1 by Robert Collins
Command objects can now declare related help topics by having _see_also
26
    tests,
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
27
    )
28
from bzrlib.commands import display_command
2425.2.1 by Robert Collins
Command objects can now declare related help topics by having _see_also
29
from bzrlib.tests import TestSkipped
30
31
32
class TestCommands(tests.TestCase):
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
33
1185.12.59 by Aaron Bentley
Added command-quieting test
34
    def test_display_command(self):
1185.33.18 by Martin Pool
[patch] handle bad IOError subclass raised by urlopen
35
        """EPIPE message is selectively suppressed"""
1185.12.59 by Aaron Bentley
Added command-quieting test
36
        def pipe_thrower():
37
            raise IOError(errno.EPIPE, "Bogus pipe error")
38
        self.assertRaises(IOError, pipe_thrower)
39
        @display_command
40
        def non_thrower():
41
            pipe_thrower()
42
        non_thrower()
43
        @display_command
44
        def other_thrower():
45
            raise IOError(errno.ESPIPE, "Bogus pipe error")
46
        self.assertRaises(IOError, other_thrower)
47
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
48
    def test_unicode_command(self):
1948.1.8 by John Arbash Meinel
Don't raise UnicodeCommand on request, instead just let it fall out when we get to NoSuchCommand
49
        # This error is thrown when we can't find the command in the
50
        # list of available commands
51
        self.assertRaises(errors.BzrCommandError,
1948.1.1 by John Arbash Meinel
Raise a reasonable error when a command is non-ascii
52
                          commands.run_bzr, [u'cmd\xb5'])
1948.1.8 by John Arbash Meinel
Don't raise UnicodeCommand on request, instead just let it fall out when we get to NoSuchCommand
53
54
    def test_unicode_option(self):
55
        # This error is actually thrown by optparse, when it
56
        # can't find the given option
1913.2.4 by Martin Pool
python2.5 apparently has trouble with unicode options
57
        import optparse
58
        if optparse.__version__ == "1.5.3":
59
            raise TestSkipped("optparse 1.5.3 can't handle unicode options")
1948.1.8 by John Arbash Meinel
Don't raise UnicodeCommand on request, instead just let it fall out when we get to NoSuchCommand
60
        self.assertRaises(errors.BzrCommandError,
61
                          commands.run_bzr, ['log', u'--option\xb5'])
62
2155.2.3 by Marius Kruger
* commands.py
63
2425.2.1 by Robert Collins
Command objects can now declare related help topics by having _see_also
64
class TestGetAlias(tests.TestCase):
2155.2.3 by Marius Kruger
* commands.py
65
66
    def _get_config(self, config_text):
2155.2.1 by Marius Kruger
* Get command aliases to respect quoted arguments.
67
        my_config = config.GlobalConfig()
68
        config_file = StringIO(config_text.encode('utf-8'))
69
        my_config._parser = my_config._get_parser(file=config_file)
70
        return my_config
71
72
    def test_simple(self):
2155.2.3 by Marius Kruger
* commands.py
73
        my_config = self._get_config("[ALIASES]\n"
2155.2.1 by Marius Kruger
* Get command aliases to respect quoted arguments.
74
            "diff=diff -r -2..-1\n")
75
        self.assertEqual([u'diff', u'-r', u'-2..-1'],
76
            commands.get_alias("diff", config=my_config))
77
78
    def test_single_quotes(self):
2155.2.3 by Marius Kruger
* commands.py
79
        my_config = self._get_config("[ALIASES]\n"
2155.2.1 by Marius Kruger
* Get command aliases to respect quoted arguments.
80
            "diff=diff -r -2..-1 --diff-options "
81
            "'--strip-trailing-cr -wp'\n")
82
        self.assertEqual([u'diff', u'-r', u'-2..-1', u'--diff-options',
83
                          u'--strip-trailing-cr -wp'],
84
                          commands.get_alias("diff", config=my_config))
85
86
    def test_double_quotes(self):
2155.2.3 by Marius Kruger
* commands.py
87
        my_config = self._get_config("[ALIASES]\n"
2155.2.1 by Marius Kruger
* Get command aliases to respect quoted arguments.
88
            "diff=diff -r -2..-1 --diff-options "
89
            "\"--strip-trailing-cr -wp\"\n")
90
        self.assertEqual([u'diff', u'-r', u'-2..-1', u'--diff-options',
91
                          u'--strip-trailing-cr -wp'],
92
                          commands.get_alias("diff", config=my_config))
93
94
    def test_unicode(self):
2155.2.3 by Marius Kruger
* commands.py
95
        my_config = self._get_config("[ALIASES]\n"
2155.2.1 by Marius Kruger
* Get command aliases to respect quoted arguments.
96
            u"iam=whoami 'Erik B\u00e5gfors <erik@bagfors.nu>'\n")
97
        self.assertEqual([u'whoami', u'Erik B\u00e5gfors <erik@bagfors.nu>'],
98
                          commands.get_alias("iam", config=my_config))
2425.2.1 by Robert Collins
Command objects can now declare related help topics by having _see_also
99
100
101
class TestSeeAlso(tests.TestCase):
102
    """Tests for the see also functional of Command."""
103
104
    def test_default_subclass_no_see_also(self):
105
        class ACommand(commands.Command):
106
            """A sample command."""
107
        command = ACommand()
108
        self.assertEqual([], command.get_see_also())
109
110
    def test__see_also(self):
111
        """When _see_also is defined, it sets the result of get_see_also()."""
112
        class ACommand(commands.Command):
113
            _see_also = ['bar', 'foo']
114
        command = ACommand()
115
        self.assertEqual(['bar', 'foo'], command.get_see_also())
116
117
    def test_deduplication(self):
118
        """Duplicates in _see_also are stripped out."""
119
        class ACommand(commands.Command):
120
            _see_also = ['foo', 'foo']
121
        command = ACommand()
122
        self.assertEqual(['foo'], command.get_see_also())
123
124
    def test_sorted(self):
125
        """_see_also is sorted by get_see_also."""
126
        class ACommand(commands.Command):
127
            _see_also = ['foo', 'bar']
128
        command = ACommand()
129
        self.assertEqual(['bar', 'foo'], command.get_see_also())
2432.1.21 by Robert Collins
Teach Command.get_help_text to show additional help cross references when supplied.
130
131
    def test_additional_terms(self):
132
        """Additional terms can be supplied and are deduped and sorted."""
133
        class ACommand(commands.Command):
134
            _see_also = ['foo', 'bar']
135
        command = ACommand()
136
        self.assertEqual(['bar', 'foo', 'gam'],
137
            command.get_see_also(['gam', 'bar', 'gam']))
138
3785.1.4 by Aaron Bentley
Enable lazy-loading of commands
139
140
class TestRegisterLazy(tests.TestCase):
141
142
    def setUp(self):
4153.1.2 by Andrew Bennetts
Add missing TestCase.setUp upcalls.
143
        tests.TestCase.setUp(self)
3785.1.4 by Aaron Bentley
Enable lazy-loading of commands
144
        import bzrlib.tests.fake_command
145
        del sys.modules['bzrlib.tests.fake_command']
146
        global lazy_command_imported
147
        lazy_command_imported = False
148
149
    @staticmethod
150
    def remove_fake():
151
        commands.plugin_cmds.remove('fake')
152
153
    def assertIsFakeCommand(self, cmd_obj):
154
        from bzrlib.tests.fake_command import cmd_fake
155
        self.assertIsInstance(cmd_obj, cmd_fake)
156
157
    def test_register_lazy(self):
158
        """Ensure lazy registration works"""
159
        commands.plugin_cmds.register_lazy('cmd_fake', [],
160
                                           'bzrlib.tests.fake_command')
161
        self.addCleanup(self.remove_fake)
162
        self.assertFalse(lazy_command_imported)
163
        fake_instance = commands.get_cmd_object('fake')
164
        self.assertTrue(lazy_command_imported)
165
        self.assertIsFakeCommand(fake_instance)
166
167
    def test_get_unrelated_does_not_import(self):
168
        commands.plugin_cmds.register_lazy('cmd_fake', [],
169
                                           'bzrlib.tests.fake_command')
170
        self.addCleanup(self.remove_fake)
171
        commands.get_cmd_object('status')
172
        self.assertFalse(lazy_command_imported)
173
174
    def test_aliases(self):
175
        commands.plugin_cmds.register_lazy('cmd_fake', ['fake_alias'],
176
                                           'bzrlib.tests.fake_command')
177
        self.addCleanup(self.remove_fake)
178
        fake_instance = commands.get_cmd_object('fake_alias')
179
        self.assertIsFakeCommand(fake_instance)
4000.1.1 by Robert Collins
Add a new hook Commands['extend_command'] for plugins that want to alter commands without overriding the entire command.
180
181
182
class TestExtendCommandHook(tests.TestCase):
183
184
    def test_fires_on_get_cmd_object(self):
185
        # The extend_command(cmd) hook fires when commands are delivered to the
186
        # ui, not simply at registration (because lazy registered plugin
187
        # commands are registered).
188
        # when they are simply created.
189
        hook_calls = []
190
        commands.Command.hooks.install_named_hook(
191
            "extend_command", hook_calls.append, None)
192
        # create a command, should not fire
193
        class ACommand(commands.Command):
194
            """A sample command."""
195
        cmd = ACommand()
196
        self.assertEqual([], hook_calls)
197
        # -- as a builtin
198
        # register the command class, should not fire
199
        try:
200
            builtins.cmd_test_extend_command_hook = ACommand
201
            self.assertEqual([], hook_calls)
202
            # and ask for the object, should fire
203
            cmd = commands.get_cmd_object('test-extend-command-hook')
204
            # For resilience - to ensure all code paths hit it - we
205
            # fire on everything returned in the 'cmd_dict', which is currently
206
            # all known commands, so assert that cmd is in hook_calls
207
            self.assertSubset([cmd], hook_calls)
208
            del hook_calls[:]
209
        finally:
210
            del builtins.cmd_test_extend_command_hook
211
        # -- as a plugin lazy registration
212
        try:
213
            # register the command class, should not fire
214
            commands.plugin_cmds.register_lazy('cmd_fake', [],
215
                                               'bzrlib.tests.fake_command')
216
            self.assertEqual([], hook_calls)
217
            # and ask for the object, should fire
218
            cmd = commands.get_cmd_object('fake')
219
            self.assertEqual([cmd], hook_calls)
220
        finally:
221
            commands.plugin_cmds.remove('fake')