← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2010-02-09 17:19:50 UTC
  • mto: (5029.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 5030.
  • Revision ID: v.ladeuil+lp@free.fr-20100209171950-nxdtof8b29fene6e
Move FakeNFSServer to bzrlib.tests.test_server

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tests/blackbox/test_serve.py
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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
 
18
18
"""Tests of the bzr serve command."""
19
19
 
20
20
import os
 
21
import os.path
21
22
import signal
22
23
import subprocess
23
24
import sys
 
25
import thread
24
26
import threading
25
27
 
26
28
from bzrlib import (
 
29
    builtins,
 
30
    debug,
27
31
    errors,
28
32
    osutils,
 
33
    revision as _mod_revision,
 
34
    urlutils,
29
35
    )
30
36
from bzrlib.branch import Branch
31
37
from bzrlib.bzrdir import BzrDir
32
 
from bzrlib.errors import ParamikoNotPresent
33
 
from bzrlib.smart import medium
34
 
from bzrlib.tests import TestCaseWithTransport, TestSkipped
 
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
35
46
from bzrlib.transport import get_transport, remote
36
47
 
37
48
 
38
 
class TestBzrServe(TestCaseWithTransport):
 
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()
39
96
 
40
97
    def assertInetServerShutsdownCleanly(self, process):
41
98
        """Shutdown the server process looking for errors."""
44
101
        process.stdin.close()
45
102
        # Hide stdin from the subprocess module, so it won't fail to close it.
46
103
        process.stdin = None
47
 
        result = self.finish_bzr_subprocess(process, retcode=0)
 
104
        result = self.finish_bzr_subprocess(process)
48
105
        self.assertEqual('', result[0])
49
106
        self.assertEqual('', result[1])
50
 
    
 
107
 
51
108
    def assertServerFinishesCleanly(self, process):
52
109
        """Shutdown the bzr serve instance process looking for errors."""
53
110
        # Shutdown the server
56
113
        self.assertEqual('', result[0])
57
114
        self.assertEqual('bzr: interrupted\n', result[1])
58
115
 
 
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
 
59
126
    def start_server_inet(self, extra_options=()):
60
127
        """Start a bzr server subprocess using the --inet option.
61
128
 
64
131
            finish_bzr_subprocess, a client for the server, and a transport.
65
132
        """
66
133
        # Serve from the current directory
67
 
        process = self.start_bzr_subprocess(['serve', '--inet'])
 
134
        args = ['serve', '--inet']
 
135
        args.extend(extra_options)
 
136
        process = self.start_bzr_subprocess(args)
68
137
 
69
138
        # Connect to the server
70
139
        # We use this url because while this is no valid URL to connect to this
71
140
        # server instance, the transport needs a URL.
 
141
        url = 'bzr://localhost/'
 
142
        self.permit_url(url)
72
143
        client_medium = medium.SmartSimplePipesClientMedium(
73
 
            process.stdout, process.stdin)
74
 
        transport = remote.RemoteTransport(
75
 
            'bzr://localhost/', medium=client_medium)
 
144
            process.stdout, process.stdin, url)
 
145
        transport = remote.RemoteTransport(url, medium=client_medium)
76
146
        return process, transport
77
147
 
78
148
    def start_server_port(self, extra_options=()):
86
156
        args = ['serve', '--port', 'localhost:0']
87
157
        args.extend(extra_options)
88
158
        process = self.start_bzr_subprocess(args, skip_if_plan_to_signal=True)
89
 
        port_line = process.stdout.readline()
 
159
        port_line = process.stderr.readline()
90
160
        prefix = 'listening on port: '
91
161
        self.assertStartsWith(port_line, prefix)
92
162
        port = int(port_line[len(prefix):])
93
 
        return process,'bzr://localhost:%d/' % port
 
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)
94
173
 
95
174
    def test_bzr_serve_inet_readonly(self):
96
175
        """bzr server should provide a read only filesystem by default."""
104
183
 
105
184
        process, transport = self.start_server_inet(['--allow-writes'])
106
185
 
107
 
        # We get a working branch
 
186
        # We get a working branch, and can create a directory
108
187
        branch = BzrDir.open_from_transport(transport).open_branch()
109
 
        branch.repository.get_revision_graph()
110
 
        self.assertEqual(None, branch.last_revision())
 
188
        self.make_read_requests(branch)
 
189
        transport.mkdir('adir')
111
190
        self.assertInetServerShutsdownCleanly(process)
112
191
 
113
192
    def test_bzr_serve_port_readonly(self):
125
204
 
126
205
        # Connect to the server
127
206
        branch = Branch.open(url)
128
 
 
129
 
        # We get a working branch
130
 
        branch.repository.get_revision_graph()
131
 
        self.assertEqual(None, branch.last_revision())
132
 
 
 
207
        self.make_read_requests(branch)
133
208
        self.assertServerFinishesCleanly(process)
134
209
 
135
 
    def test_bzr_connect_to_bzr_ssh(self):
136
 
        """User acceptance that get_transport of a bzr+ssh:// behaves correctly.
137
 
 
138
 
        bzr+ssh:// should cause bzr to run a remote bzr smart server over SSH.
139
 
        """
140
 
        try:
141
 
            from bzrlib.transport.sftp import SFTPServer
142
 
        except ParamikoNotPresent:
143
 
            raise TestSkipped('Paramiko not installed')
144
 
        from bzrlib.tests.stub_sftp import StubServer
145
 
        
 
210
    def test_bzr_serve_supports_protocol(self):
146
211
        # Make a branch
147
 
        self.make_branch('a_branch')
148
 
 
149
 
        # Start an SSH server
150
 
        self.command_executed = []
151
 
        # XXX: This is horrible -- we define a really dumb SSH server that
152
 
        # executes commands, and manage the hooking up of stdin/out/err to the
153
 
        # SSH channel ourselves.  Surely this has already been implemented
154
 
        # elsewhere?
155
 
        class StubSSHServer(StubServer):
156
 
 
157
 
            test = self
158
 
 
159
 
            def check_channel_exec_request(self, channel, command):
160
 
                self.test.command_executed.append(command)
161
 
                proc = subprocess.Popen(
162
 
                    command, shell=True, stdin=subprocess.PIPE,
163
 
                    stdout=subprocess.PIPE, stderr=subprocess.PIPE)
164
 
                
165
 
                # XXX: horribly inefficient, not to mention ugly.
166
 
                # Start a thread for each of stdin/out/err, and relay bytes from
167
 
                # the subprocess to channel and vice versa.
168
 
                def ferry_bytes(read, write, close):
169
 
                    while True:
170
 
                        bytes = read(1)
171
 
                        if bytes == '':
172
 
                            close()
173
 
                            break
174
 
                        write(bytes)
175
 
 
176
 
                file_functions = [
177
 
                    (channel.recv, proc.stdin.write, proc.stdin.close),
178
 
                    (proc.stdout.read, channel.sendall, channel.close),
179
 
                    (proc.stderr.read, channel.sendall_stderr, channel.close)]
180
 
                for read, write, close in file_functions:
181
 
                    t = threading.Thread(
182
 
                        target=ferry_bytes, args=(read, write, close))
183
 
                    t.start()
184
 
 
185
 
                return True
186
 
 
187
 
        ssh_server = SFTPServer(StubSSHServer)
188
 
        # XXX: We *don't* want to override the default SSH vendor, so we set
189
 
        # _vendor to what _get_ssh_vendor returns.
190
 
        ssh_server.setUp()
191
 
        self.addCleanup(ssh_server.tearDown)
192
 
        port = ssh_server._listener.port
193
 
 
194
 
        # Access the branch via a bzr+ssh URL.  The BZR_REMOTE_PATH environment
195
 
        # variable is used to tell bzr what command to run on the remote end.
196
 
        path_to_branch = osutils.abspath('a_branch')
197
 
        
198
 
        orig_bzr_remote_path = os.environ.get('BZR_REMOTE_PATH')
199
 
        bzr_remote_path = self.get_bzr_path()
200
 
        if sys.platform == 'win32':
201
 
            bzr_remote_path = sys.executable + ' ' + self.get_bzr_path()
202
 
        os.environ['BZR_REMOTE_PATH'] = bzr_remote_path
 
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/')
203
268
        try:
204
 
            if sys.platform == 'win32':
205
 
                path_to_branch = os.path.splitdrive(path_to_branch)[1]
206
 
            branch = Branch.open(
207
 
                'bzr+ssh://fred:secret@localhost:%d%s' % (port, path_to_branch))
208
 
            
209
 
            branch.repository.get_revision_graph()
210
 
            self.assertEqual(None, branch.last_revision())
211
 
            # Check we can perform write operations
212
 
            branch.bzrdir.root_transport.mkdir('foo')
213
 
        finally:
214
 
            # Restore the BZR_REMOTE_PATH environment variable back to its
215
 
            # original state.
216
 
            if orig_bzr_remote_path is None:
217
 
                del os.environ['BZR_REMOTE_PATH']
218
 
            else:
219
 
                os.environ['BZR_REMOTE_PATH'] = orig_bzr_remote_path
220
 
 
221
 
        self.assertEqual(
222
 
            ['%s serve --inet --directory=/ --allow-writes'
223
 
             % bzr_remote_path],
224
 
            self.command_executed)
225
 
        
 
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