~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Date: 2006-12-01 19:41:16 UTC
  • mfrom: (2158 +trunk)
  • mto: This revision was merged to the branch mainline in revision 2159.
  • Revision ID: john@arbash-meinel.com-20061201194116-nvn5qhfxux5284jc
[merge] bzr.dev 2158

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 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
"""Tests of the bzr serve command."""
19
19
 
20
20
import os
21
 
import os.path
22
21
import signal
23
22
import subprocess
24
 
import sys
25
 
import thread
26
23
import threading
27
24
 
28
 
from bzrlib import (
29
 
    builtins,
30
 
    debug,
31
 
    errors,
32
 
    osutils,
33
 
    revision as _mod_revision,
34
 
    urlutils,
35
 
    )
 
25
from bzrlib import errors
36
26
from bzrlib.branch import Branch
37
27
from bzrlib.bzrdir import BzrDir
38
 
from bzrlib.smart import client, medium
39
 
from bzrlib.smart.server import BzrServerFactory, SmartTCPServer
40
 
from bzrlib.tests import (
41
 
    TestCaseWithMemoryTransport,
42
 
    TestCaseWithTransport,
43
 
    TestSkipped,
44
 
    )
45
 
from bzrlib.trace import mutter
46
 
from bzrlib.transport import get_transport, remote
47
 
 
48
 
 
49
 
class TestBzrServeBase(TestCaseWithTransport):
50
 
 
51
 
    def run_bzr_serve_then_func(self, serve_args, retcode=0, func=None,
52
 
                                *func_args, **func_kwargs):
53
 
        """Run 'bzr serve', and run the given func in a thread once the server
54
 
        has started.
55
 
        
56
 
        When 'func' terminates, the server will be terminated too.
57
 
        
58
 
        Returns stdout and stderr.
59
 
        """
60
 
        # install hook
61
 
        def on_server_start(backing_urls, tcp_server):
62
 
            t = threading.Thread(
63
 
                target=on_server_start_thread, args=(tcp_server,))
64
 
            t.start()
65
 
        def on_server_start_thread(tcp_server):
66
 
            try:
67
 
                # Run func if set
68
 
                self.tcp_server = tcp_server
69
 
                if not func is None:
70
 
                    try:
71
 
                        func(*func_args, **func_kwargs)
72
 
                    except Exception, e:
73
 
                        # Log errors to make some test failures a little less
74
 
                        # mysterious.
75
 
                        mutter('func broke: %r', e)
76
 
            finally:
77
 
                # Then stop the server
78
 
                mutter('interrupting...')
79
 
                thread.interrupt_main()
80
 
        SmartTCPServer.hooks.install_named_hook(
81
 
            'server_started_ex', on_server_start,
82
 
            'run_bzr_serve_then_func hook')
83
 
        # start a TCP server
84
 
        try:
85
 
            out, err = self.run_bzr(['serve'] + list(serve_args))
86
 
        except KeyboardInterrupt, e:
87
 
            out, err = e.args
88
 
        return out, err
89
 
 
90
 
 
91
 
class TestBzrServe(TestBzrServeBase):
92
 
 
93
 
    def setUp(self):
94
 
        super(TestBzrServe, self).setUp()
95
 
        self.disable_missing_extensions_warning()
 
28
from bzrlib.errors import ParamikoNotPresent
 
29
from bzrlib.tests import TestCaseWithTransport, TestSkipped
 
30
from bzrlib.transport import get_transport, smart
 
31
 
 
32
 
 
33
class TestBzrServe(TestCaseWithTransport):
96
34
 
97
35
    def assertInetServerShutsdownCleanly(self, process):
98
36
        """Shutdown the server process looking for errors."""
101
39
        process.stdin.close()
102
40
        # Hide stdin from the subprocess module, so it won't fail to close it.
103
41
        process.stdin = None
104
 
        result = self.finish_bzr_subprocess(process)
 
42
        result = self.finish_bzr_subprocess(process, retcode=0)
105
43
        self.assertEqual('', result[0])
106
44
        self.assertEqual('', result[1])
107
 
 
 
45
    
108
46
    def assertServerFinishesCleanly(self, process):
109
47
        """Shutdown the bzr serve instance process looking for errors."""
110
48
        # Shutdown the server
113
51
        self.assertEqual('', result[0])
114
52
        self.assertEqual('bzr: interrupted\n', result[1])
115
53
 
116
 
    def make_read_requests(self, branch):
117
 
        """Do some read only requests."""
118
 
        branch.lock_read()
119
 
        try:
120
 
            branch.repository.all_revision_ids()
121
 
            self.assertEqual(_mod_revision.NULL_REVISION,
122
 
                             _mod_revision.ensure_null(branch.last_revision()))
123
 
        finally:
124
 
            branch.unlock()
125
 
 
126
54
    def start_server_inet(self, extra_options=()):
127
55
        """Start a bzr server subprocess using the --inet option.
128
56
 
131
59
            finish_bzr_subprocess, a client for the server, and a transport.
132
60
        """
133
61
        # Serve from the current directory
134
 
        args = ['serve', '--inet']
135
 
        args.extend(extra_options)
136
 
        process = self.start_bzr_subprocess(args)
 
62
        process = self.start_bzr_subprocess(['serve', '--inet'])
137
63
 
138
64
        # Connect to the server
139
65
        # We use this url because while this is no valid URL to connect to this
140
66
        # server instance, the transport needs a URL.
141
 
        url = 'bzr://localhost/'
142
 
        self.permit_url(url)
143
 
        client_medium = medium.SmartSimplePipesClientMedium(
144
 
            process.stdout, process.stdin, url)
145
 
        transport = remote.RemoteTransport(url, medium=client_medium)
 
67
        medium = smart.SmartSimplePipesClientMedium(
 
68
            process.stdout, process.stdin)
 
69
        transport = smart.SmartTransport('bzr://localhost/', medium=medium)
146
70
        return process, transport
147
71
 
148
72
    def start_server_port(self, extra_options=()):
156
80
        args = ['serve', '--port', 'localhost:0']
157
81
        args.extend(extra_options)
158
82
        process = self.start_bzr_subprocess(args, skip_if_plan_to_signal=True)
159
 
        port_line = process.stderr.readline()
 
83
        port_line = process.stdout.readline()
160
84
        prefix = 'listening on port: '
161
85
        self.assertStartsWith(port_line, prefix)
162
86
        port = int(port_line[len(prefix):])
163
 
        url = 'bzr://localhost:%d/' % port
164
 
        self.permit_url(url)
165
 
        return process, url
166
 
    
167
 
    def test_bzr_serve_quiet(self):
168
 
        self.make_branch('.')
169
 
        args = ['--port', 'localhost:0', '--quiet']
170
 
        out, err = self.run_bzr_serve_then_func(args, retcode=3)
171
 
        self.assertEqual('', out)
172
 
        self.assertEqual('', err)
 
87
        return process,'bzr://localhost:%d/' % port
173
88
 
174
89
    def test_bzr_serve_inet_readonly(self):
175
90
        """bzr server should provide a read only filesystem by default."""
183
98
 
184
99
        process, transport = self.start_server_inet(['--allow-writes'])
185
100
 
186
 
        # We get a working branch, and can create a directory
 
101
        # We get a working branch
187
102
        branch = BzrDir.open_from_transport(transport).open_branch()
188
 
        self.make_read_requests(branch)
189
 
        transport.mkdir('adir')
 
103
        branch.repository.get_revision_graph()
 
104
        self.assertEqual(None, branch.last_revision())
190
105
        self.assertInetServerShutsdownCleanly(process)
191
106
 
192
107
    def test_bzr_serve_port_readonly(self):
204
119
 
205
120
        # Connect to the server
206
121
        branch = Branch.open(url)
207
 
        self.make_read_requests(branch)
 
122
 
 
123
        # We get a working branch
 
124
        branch.repository.get_revision_graph()
 
125
        self.assertEqual(None, branch.last_revision())
 
126
 
208
127
        self.assertServerFinishesCleanly(process)
209
128
 
210
 
    def test_bzr_serve_supports_protocol(self):
 
129
    def test_bzr_serve_no_args(self):
 
130
        """'bzr serve' with no arguments or options should not traceback."""
 
131
        out, err = self.run_bzr_error(
 
132
            ['bzr serve requires one of --inet or --port'], 'serve')
 
133
 
 
134
    def test_bzr_connect_to_bzr_ssh(self):
 
135
        """User acceptance that get_transport of a bzr+ssh:// behaves correctly.
 
136
 
 
137
        bzr+ssh:// should cause bzr to run a remote bzr smart server over SSH.
 
138
        """
 
139
        try:
 
140
            from bzrlib.transport.sftp import SFTPServer
 
141
        except ParamikoNotPresent:
 
142
            raise TestSkipped('Paramiko not installed')
 
143
        from bzrlib.tests.stub_sftp import StubServer
 
144
        
211
145
        # Make a branch
212
 
        self.make_branch('.')
213
 
 
214
 
        process, url = self.start_server_port(['--allow-writes',
215
 
                                               '--protocol=bzr'])
216
 
 
217
 
        # Connect to the server
218
 
        branch = Branch.open(url)
219
 
        self.make_read_requests(branch)
220
 
        self.assertServerFinishesCleanly(process)
221
 
 
222
 
    def test_bzr_serve_dhpss(self):
223
 
        # This is a smoke test that the server doesn't crash when run with
224
 
        # -Dhpss, and does drop some hpss logging to the file.
225
 
        self.make_branch('.')
226
 
        log_fname = os.getcwd() + '/server.log'
227
 
        self._captureVar('BZR_LOG', log_fname)
228
 
        process, transport = self.start_server_inet(['-Dhpss'])
229
 
        branch = BzrDir.open_from_transport(transport).open_branch()
230
 
        self.make_read_requests(branch)
231
 
        self.assertInetServerShutsdownCleanly(process)
232
 
        f = open(log_fname, 'rb')
233
 
        content = f.read()
234
 
        f.close()
235
 
        self.assertContainsRe(content, r'hpss request: \[[0-9-]+\]')
236
 
 
237
 
 
238
 
class TestCmdServeChrooting(TestBzrServeBase):
239
 
 
240
 
    def test_serve_tcp(self):
241
 
        """'bzr serve' wraps the given --directory in a ChrootServer.
242
 
 
243
 
        So requests that search up through the parent directories (like
244
 
        find_repositoryV3) will give "not found" responses, rather than
245
 
        InvalidURLJoin or jail break errors.
246
 
        """
247
 
        t = self.get_transport()
248
 
        t.mkdir('server-root')
249
 
        self.run_bzr_serve_then_func(
250
 
            ['--port', '127.0.0.1:0',
251
 
             '--directory', t.local_abspath('server-root'),
252
 
             '--allow-writes'],
253
 
            func=self.when_server_started)
254
 
        # The when_server_started method issued a find_repositoryV3 that should
255
 
        # fail with 'norepository' because there are no repositories inside the
256
 
        # --directory.
257
 
        self.assertEqual(('norepository',), self.client_resp)
258
 
 
259
 
    def when_server_started(self):
260
 
        # Connect to the TCP server and issue some requests and see what comes
261
 
        # back.
262
 
        client_medium = medium.SmartTCPClientMedium(
263
 
            '127.0.0.1', self.tcp_server.port,
264
 
            'bzr://localhost:%d/' % (self.tcp_server.port,))
265
 
        smart_client = client._SmartClient(client_medium)
266
 
        resp = smart_client.call('mkdir', 'foo', '')
267
 
        resp = smart_client.call('BzrDirFormat.initialize', 'foo/')
 
146
        self.make_branch('a_branch')
 
147
 
 
148
        # Start an SSH server
 
149
        self.command_executed = []
 
150
        # XXX: This is horrible -- we define a really dumb SSH server that
 
151
        # executes commands, and manage the hooking up of stdin/out/err to the
 
152
        # SSH channel ourselves.  Surely this has already been implemented
 
153
        # elsewhere?
 
154
        class StubSSHServer(StubServer):
 
155
 
 
156
            test = self
 
157
 
 
158
            def check_channel_exec_request(self, channel, command):
 
159
                self.test.command_executed.append(command)
 
160
                proc = subprocess.Popen(
 
161
                    command, shell=True, stdin=subprocess.PIPE,
 
162
                    stdout=subprocess.PIPE, stderr=subprocess.PIPE)
 
163
                
 
164
                # XXX: horribly inefficient, not to mention ugly.
 
165
                # Start a thread for each of stdin/out/err, and relay bytes from
 
166
                # the subprocess to channel and vice versa.
 
167
                def ferry_bytes(read, write, close):
 
168
                    while True:
 
169
                        bytes = read(1)
 
170
                        if bytes == '':
 
171
                            close()
 
172
                            break
 
173
                        write(bytes)
 
174
 
 
175
                file_functions = [
 
176
                    (channel.recv, proc.stdin.write, proc.stdin.close),
 
177
                    (proc.stdout.read, channel.sendall, channel.close),
 
178
                    (proc.stderr.read, channel.sendall_stderr, channel.close)]
 
179
                for read, write, close in file_functions:
 
180
                    t = threading.Thread(
 
181
                        target=ferry_bytes, args=(read, write, close))
 
182
                    t.start()
 
183
 
 
184
                return True
 
185
 
 
186
        ssh_server = SFTPServer(StubSSHServer)
 
187
        # XXX: We *don't* want to override the default SSH vendor, so we set
 
188
        # _vendor to what _get_ssh_vendor returns.
 
189
        ssh_server.setUp()
 
190
        self.addCleanup(ssh_server.tearDown)
 
191
        port = ssh_server._listener.port
 
192
 
 
193
        # Access the branch via a bzr+ssh URL.  The BZR_REMOTE_PATH environment
 
194
        # variable is used to tell bzr what command to run on the remote end.
 
195
        path_to_branch = os.path.abspath('a_branch')
 
196
        
 
197
        orig_bzr_remote_path = os.environ.get('BZR_REMOTE_PATH')
 
198
        os.environ['BZR_REMOTE_PATH'] = self.get_bzr_path()
268
199
        try:
269
 
            resp = smart_client.call('BzrDir.find_repositoryV3', 'foo/')
270
 
        except errors.ErrorFromSmartServer, e:
271
 
            resp = e.error_tuple
272
 
        self.client_resp = resp
273
 
        client_medium.disconnect()
274
 
 
275
 
 
276
 
class TestUserdirExpansion(TestCaseWithMemoryTransport):
277
 
 
278
 
    def fake_expanduser(self, path):
279
 
        """A simple, environment-independent, function for the duration of this
280
 
        test.
281
 
 
282
 
        Paths starting with a path segment of '~user' will expand to start with
283
 
        '/home/user/'.  Every other path will be unchanged.
284
 
        """
285
 
        if path.split('/', 1)[0] == '~user':
286
 
            return '/home/user' + path[len('~user'):]
287
 
        return path
288
 
 
289
 
    def make_test_server(self, base_path='/'):
290
 
        """Make and start a BzrServerFactory, backed by a memory transport, and
291
 
        creat '/home/user' in that transport.
292
 
        """
293
 
        bzr_server = BzrServerFactory(
294
 
            self.fake_expanduser, lambda t: base_path)
295
 
        mem_transport = self.get_transport()
296
 
        mem_transport.mkdir_multi(['home', 'home/user'])
297
 
        bzr_server.set_up(mem_transport, None, None, inet=True)
298
 
        self.addCleanup(bzr_server.tear_down)
299
 
        return bzr_server
300
 
 
301
 
    def test_bzr_serve_expands_userdir(self):
302
 
        bzr_server = self.make_test_server()
303
 
        self.assertTrue(bzr_server.smart_server.backing_transport.has('~user'))
304
 
 
305
 
    def test_bzr_serve_does_not_expand_userdir_outside_base(self):
306
 
        bzr_server = self.make_test_server('/foo')
307
 
        self.assertFalse(bzr_server.smart_server.backing_transport.has('~user'))
308
 
 
309
 
    def test_get_base_path(self):
310
 
        """cmd_serve will turn the --directory option into a LocalTransport
311
 
        (optionally decorated with 'readonly+').  BzrServerFactory can
312
 
        determine the original --directory from that transport.
313
 
        """
314
 
        # URLs always include the trailing slash, and get_base_path returns it
315
 
        base_dir = osutils.abspath('/a/b/c') + '/'
316
 
        base_url = urlutils.local_path_to_url(base_dir) + '/'
317
 
        # Define a fake 'protocol' to capture the transport that cmd_serve
318
 
        # passes to serve_bzr.
319
 
        def capture_transport(transport, host, port, inet):
320
 
            self.bzr_serve_transport = transport
321
 
        cmd = builtins.cmd_serve()
322
 
        # Read-only
323
 
        cmd.run(directory=base_dir, protocol=capture_transport)
324
 
        server_maker = BzrServerFactory()
325
 
        self.assertEqual(
326
 
            'readonly+%s' % base_url, self.bzr_serve_transport.base)
327
 
        self.assertEqual(
328
 
            base_dir, server_maker.get_base_path(self.bzr_serve_transport))
329
 
        # Read-write
330
 
        cmd.run(directory=base_dir, protocol=capture_transport,
331
 
            allow_writes=True)
332
 
        server_maker = BzrServerFactory()
333
 
        self.assertEqual(base_url, self.bzr_serve_transport.base)
334
 
        self.assertEqual(base_dir,
335
 
            server_maker.get_base_path(self.bzr_serve_transport))
336
 
 
 
200
            branch = Branch.open(
 
201
                'bzr+ssh://fred:secret@localhost:%d%s' % (port, path_to_branch))
 
202
            
 
203
            branch.repository.get_revision_graph()
 
204
            self.assertEqual(None, branch.last_revision())
 
205
            # Check we can perform write operations
 
206
            branch.bzrdir.root_transport.mkdir('foo')
 
207
        finally:
 
208
            # Restore the BZR_REMOTE_PATH environment variable back to its
 
209
            # original state.
 
210
            if orig_bzr_remote_path is None:
 
211
                del os.environ['BZR_REMOTE_PATH']
 
212
            else:
 
213
                os.environ['BZR_REMOTE_PATH'] = orig_bzr_remote_path
 
214
 
 
215
        self.assertEqual(
 
216
            ['%s serve --inet --directory=/ --allow-writes'
 
217
             % self.get_bzr_path()],
 
218
            self.command_executed)
 
219