222
202
Hooks.__init__(self)
223
self.create_hook(HookPoint('server_started',
224
"Called by the bzr server when it starts serving a directory. "
225
"server_started is called with (backing urls, public url), "
226
"where backing_url is a list of URLs giving the "
227
"server-specific directory locations, and public_url is the "
228
"public URL for the directory being served.", (0, 16), None))
229
self.create_hook(HookPoint('server_started_ex',
230
"Called by the bzr server when it starts serving a directory. "
231
"server_started is called with (backing_urls, server_obj).",
233
self.create_hook(HookPoint('server_stopped',
234
"Called by the bzr server when it stops serving a directory. "
235
"server_stopped is called with the same parameters as the "
236
"server_started hook: (backing_urls, public_url).", (0, 16), None))
203
# Introduced in 0.16:
204
# invoked whenever the server starts serving a directory.
205
# The api signature is (backing urls, public url).
206
self['server_started'] = []
207
# Introduced in 0.16:
208
# invoked whenever the server stops serving a directory.
209
# The api signature is (backing urls, public url).
210
self['server_stopped'] = []
238
212
SmartTCPServer.hooks = SmartServerHooks()
241
def _local_path_for_transport(transport):
242
"""Return a local path for transport, if reasonably possible.
244
This function works even if transport's url has a "readonly+" prefix,
245
unlike local_path_from_url.
247
This essentially recovers the --directory argument the user passed to "bzr
248
serve" from the transport passed to serve_bzr.
215
class SmartTCPServer_for_testing(SmartTCPServer):
216
"""Server suitable for use by transport tests.
218
This server is backed by the process's cwd.
251
base_url = transport.external_url()
252
except (errors.InProcessTransport, NotImplementedError):
255
# Strip readonly prefix
256
if base_url.startswith('readonly+'):
257
base_url = base_url[len('readonly+'):]
259
return urlutils.local_path_from_url(base_url)
260
except errors.InvalidURL:
264
class BzrServerFactory(object):
265
"""Helper class for serve_bzr."""
267
def __init__(self, userdir_expander=None, get_base_path=None):
269
self.base_path = None
270
self.backing_transport = None
271
if userdir_expander is None:
272
userdir_expander = os.path.expanduser
273
self.userdir_expander = userdir_expander
274
if get_base_path is None:
275
get_base_path = _local_path_for_transport
276
self.get_base_path = get_base_path
278
def _expand_userdirs(self, path):
279
"""Translate /~/ or /~user/ to e.g. /home/foo, using
280
self.userdir_expander (os.path.expanduser by default).
282
If the translated path would fall outside base_path, or the path does
283
not start with ~, then no translation is applied.
285
If the path is inside, it is adjusted to be relative to the base path.
287
e.g. if base_path is /home, and the expanded path is /home/joe, then
288
the translated path is joe.
221
def __init__(self, thread_name_suffix=''):
222
SmartTCPServer.__init__(self, None)
223
self.client_path_extra = None
224
self.thread_name_suffix = thread_name_suffix
226
def get_backing_transport(self, backing_transport_server):
227
"""Get a backing transport from a server we are decorating."""
228
return transport.get_transport(backing_transport_server.get_url())
230
def setUp(self, backing_transport_server=None,
231
client_path_extra='/extra/'):
232
"""Set up server for testing.
234
:param backing_transport_server: backing server to use. If not
235
specified, a LocalURLServer at the current working directory will
237
:param client_path_extra: a path segment starting with '/' to append to
238
the root URL for this server. For instance, a value of '/foo/bar/'
239
will mean the root of the backing transport will be published at a
240
URL like `bzr://127.0.0.1:nnnn/foo/bar/`, rather than
241
`bzr://127.0.0.1:nnnn/`. Default value is `extra`, so that tests
242
by default will fail unless they do the necessary path translation.
291
if path.startswith('~'):
292
expanded = self.userdir_expander(path)
293
if not expanded.endswith('/'):
295
if expanded.startswith(self.base_path):
296
result = expanded[len(self.base_path):]
299
def _make_expand_userdirs_filter(self, transport):
300
return pathfilter.PathFilteringServer(transport, self._expand_userdirs)
302
def _make_backing_transport(self, transport):
303
"""Chroot transport, and decorate with userdir expander."""
304
self.base_path = self.get_base_path(transport)
305
chroot_server = chroot.ChrootServer(transport)
306
chroot_server.start_server()
307
self.cleanups.append(chroot_server.stop_server)
308
transport = get_transport(chroot_server.get_url())
309
if self.base_path is not None:
310
# Decorate the server's backing transport with a filter that can
312
expand_userdirs = self._make_expand_userdirs_filter(transport)
313
expand_userdirs.start_server()
314
self.cleanups.append(expand_userdirs.stop_server)
315
transport = get_transport(expand_userdirs.get_url())
316
self.transport = transport
318
def _make_smart_server(self, host, port, inet):
320
smart_server = medium.SmartServerPipeStreamMedium(
321
sys.stdin, sys.stdout, self.transport)
324
host = medium.BZR_DEFAULT_INTERFACE
326
port = medium.BZR_DEFAULT_PORT
327
smart_server = SmartTCPServer(self.transport, host=host, port=port)
328
trace.note('listening on port: %s' % smart_server.port)
329
self.smart_server = smart_server
331
def _change_globals(self):
332
from bzrlib import lockdir, ui
333
# For the duration of this server, no UI output is permitted. note
334
# that this may cause problems with blackbox tests. This should be
335
# changed with care though, as we dont want to use bandwidth sending
336
# progress over stderr to smart server clients!
337
old_factory = ui.ui_factory
338
old_lockdir_timeout = lockdir._DEFAULT_TIMEOUT_SECONDS
339
def restore_default_ui_factory_and_lockdir_timeout():
340
ui.ui_factory = old_factory
341
lockdir._DEFAULT_TIMEOUT_SECONDS = old_lockdir_timeout
342
self.cleanups.append(restore_default_ui_factory_and_lockdir_timeout)
343
ui.ui_factory = ui.SilentUIFactory()
344
lockdir._DEFAULT_TIMEOUT_SECONDS = 0
346
def set_up(self, transport, host, port, inet):
347
self._make_backing_transport(transport)
348
self._make_smart_server(host, port, inet)
349
self._change_globals()
352
for cleanup in reversed(self.cleanups):
356
def serve_bzr(transport, host=None, port=None, inet=False):
357
"""This is the default implementation of 'bzr serve'.
359
It creates a TCP or pipe smart server on 'transport, and runs it. The
360
transport will be decorated with a chroot and pathfilter (using
244
if not client_path_extra.startswith('/'):
245
raise ValueError(client_path_extra)
246
from bzrlib.transport.chroot import ChrootServer
247
if backing_transport_server is None:
248
from bzrlib.transport.local import LocalURLServer
249
backing_transport_server = LocalURLServer()
250
self.chroot_server = ChrootServer(
251
self.get_backing_transport(backing_transport_server))
252
self.chroot_server.setUp()
253
self.backing_transport = transport.get_transport(
254
self.chroot_server.get_url())
255
self.root_client_path = self.client_path_extra = client_path_extra
256
self.start_background_thread(self.thread_name_suffix)
259
self.stop_background_thread()
260
self.chroot_server.tearDown()
263
url = super(SmartTCPServer_for_testing, self).get_url()
264
return url[:-1] + self.client_path_extra
266
def get_bogus_url(self):
267
"""Return a URL which will fail to connect"""
268
return 'bzr://127.0.0.1:1/'
271
class ReadonlySmartTCPServer_for_testing(SmartTCPServer_for_testing):
272
"""Get a readonly server for testing."""
274
def get_backing_transport(self, backing_transport_server):
275
"""Get a backing transport from a server we are decorating."""
276
url = 'readonly+' + backing_transport_server.get_url()
277
return transport.get_transport(url)
280
class SmartTCPServer_for_testing_v2_only(SmartTCPServer_for_testing):
281
"""A variation of SmartTCPServer_for_testing that limits the client to
282
using RPCs in protocol v2 (i.e. bzr <= 1.5).
363
bzr_server = BzrServerFactory()
365
bzr_server.set_up(transport, host, port, inet)
366
bzr_server.smart_server.serve()
368
bzr_server.tear_down()
286
url = super(SmartTCPServer_for_testing_v2_only, self).get_url()
287
url = 'bzr-v2://' + url[len('bzr://'):]
291
class ReadonlySmartTCPServer_for_testing_v2_only(SmartTCPServer_for_testing_v2_only):
292
"""Get a readonly server for testing."""
294
def get_backing_transport(self, backing_transport_server):
295
"""Get a backing transport from a server we are decorating."""
296
url = 'readonly+' + backing_transport_server.get_url()
297
return transport.get_transport(url)