/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/tests/http_server.py

  • Committer: Marius Kruger
  • Date: 2010-07-10 21:28:56 UTC
  • mto: (5384.1.1 integration)
  • mto: This revision was merged to the branch mainline in revision 5385.
  • Revision ID: marius.kruger@enerweb.co.za-20100710212856-uq4ji3go0u5se7hx
* Update documentation
* add NEWS

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tests/http_server.py
1
 
# Copyright (C) 2006-2011 Canonical Ltd
 
1
# Copyright (C) 2006-2010 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
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
17
17
import errno
18
 
try:
19
 
    import http.client as http_client
20
 
    import http.server as http_server
21
 
except ImportError:
22
 
    import httplib as http_client
23
 
    import SimpleHTTPServer as http_server
 
18
import httplib
24
19
import os
25
20
import posixpath
26
21
import random
27
22
import re
 
23
import select
 
24
import SimpleHTTPServer
28
25
import socket
 
26
import SocketServer
29
27
import sys
30
 
try:
31
 
    from urlparse import urlparse
32
 
except ImportError:
33
 
    from urllib.parse import urlparse
 
28
import threading
 
29
import time
 
30
import urllib
 
31
import urlparse
34
32
 
35
 
from .. import (
36
 
    osutils,
37
 
    urlutils,
38
 
)
39
 
from . import test_server
 
33
from bzrlib import transport
 
34
from bzrlib.tests import test_server
 
35
from bzrlib.transport import local
40
36
 
41
37
 
42
38
class BadWebserverPath(ValueError):
44
40
        return 'path %s is not in %s' % self.args
45
41
 
46
42
 
47
 
class TestingHTTPRequestHandler(http_server.SimpleHTTPRequestHandler):
 
43
class TestingHTTPRequestHandler(SimpleHTTPServer.SimpleHTTPRequestHandler):
48
44
    """Handles one request.
49
45
 
50
46
    A TestingHTTPRequestHandler is instantiated for every request received by
56
52
    protocol_version = 'HTTP/1.1'
57
53
 
58
54
    # The Message-like class used to parse the request headers
59
 
    MessageClass = http_client.HTTPMessage
 
55
    MessageClass = httplib.HTTPMessage
60
56
 
61
57
    def setup(self):
62
 
        http_server.SimpleHTTPRequestHandler.setup(self)
 
58
        SimpleHTTPServer.SimpleHTTPRequestHandler.setup(self)
63
59
        self._cwd = self.server._home_dir
64
60
        tcs = self.server.test_case_server
65
61
        if tcs.protocol_version is not None:
82
78
        connection early to avoid polluting the test results.
83
79
        """
84
80
        try:
85
 
            self._handle_one_request()
86
 
        except socket.error as e:
 
81
            SimpleHTTPServer.SimpleHTTPRequestHandler.handle_one_request(self)
 
82
        except socket.error, e:
87
83
            # Any socket error should close the connection, but some errors are
88
84
            # due to the client closing early and we don't want to pollute test
89
85
            # results, so we raise only the others.
93
89
                                     errno.ECONNABORTED, errno.EBADF)):
94
90
                raise
95
91
 
96
 
    error_content_type = 'text/plain'
97
 
    error_message_format = '''\
98
 
Error code: %(code)s.
99
 
Message: %(message)s.
100
 
'''
101
 
 
102
 
    def send_error(self, code, message=None):
103
 
        """Send and log an error reply.
104
 
 
105
 
        We redefine the python-provided version to be able to set a
106
 
        ``Content-Length`` header as some http/1.1 clients complain otherwise
107
 
        (see bug #568421).
108
 
 
109
 
        :param code: The HTTP error code.
110
 
 
111
 
        :param message: The explanation of the error code, Defaults to a short
112
 
             entry.
113
 
        """
114
 
 
115
 
        if message is None:
116
 
            try:
117
 
                message = self.responses[code][0]
118
 
            except KeyError:
119
 
                message = '???'
120
 
        self.log_error("code %d, message %s", code, message)
121
 
        content = (self.error_message_format %
122
 
                   {'code': code, 'message': message})
123
 
        self.send_response(code, message)
124
 
        self.send_header("Content-Type", self.error_content_type)
125
 
        self.send_header("Content-Length", "%d" % len(content))
126
 
        self.send_header('Connection', 'close')
127
 
        self.end_headers()
128
 
        if self.command != 'HEAD' and code >= 200 and code not in (204, 304):
129
 
            self.wfile.write(content.encode('utf-8'))
130
 
 
131
 
    def _handle_one_request(self):
132
 
        http_server.SimpleHTTPRequestHandler.handle_one_request(self)
133
 
 
134
 
    _range_regexp = re.compile(r'^(?P<start>\d+)-(?P<end>\d+)?$')
 
92
    _range_regexp = re.compile(r'^(?P<start>\d+)-(?P<end>\d+)$')
135
93
    _tail_regexp = re.compile(r'^-(?P<tail>\d+)$')
136
94
 
137
 
    def _parse_ranges(self, ranges_header, file_size):
138
 
        """Parse the range header value and returns ranges.
139
 
 
140
 
        RFC2616 14.35 says that syntactically invalid range specifiers MUST be
141
 
        ignored. In that case, we return None instead of a range list.
142
 
 
143
 
        :param ranges_header: The 'Range' header value.
144
 
 
145
 
        :param file_size: The size of the requested file.
146
 
 
147
 
        :return: A list of (start, end) tuples or None if some invalid range
148
 
            specifier is encountered.
 
95
    def parse_ranges(self, ranges_header):
 
96
        """Parse the range header value and returns ranges and tail.
 
97
 
 
98
        RFC2616 14.35 says that syntactically invalid range
 
99
        specifiers MUST be ignored. In that case, we return 0 for
 
100
        tail and [] for ranges.
149
101
        """
 
102
        tail = 0
 
103
        ranges = []
150
104
        if not ranges_header.startswith('bytes='):
151
105
            # Syntactically invalid header
152
 
            return None
 
106
            return 0, []
153
107
 
154
 
        tail = None
155
 
        ranges = []
156
108
        ranges_header = ranges_header[len('bytes='):]
157
109
        for range_str in ranges_header.split(','):
 
110
            # FIXME: RFC2616 says end is optional and default to file_size
158
111
            range_match = self._range_regexp.match(range_str)
159
112
            if range_match is not None:
160
113
                start = int(range_match.group('start'))
161
 
                end_match = range_match.group('end')
162
 
                if end_match is None:
163
 
                    # RFC2616 says end is optional and default to file_size
164
 
                    end = file_size
165
 
                else:
166
 
                    end = int(end_match)
 
114
                end = int(range_match.group('end'))
167
115
                if start > end:
168
116
                    # Syntactically invalid range
169
 
                    return None
 
117
                    return 0, []
170
118
                ranges.append((start, end))
171
119
            else:
172
120
                tail_match = self._tail_regexp.match(range_str)
174
122
                    tail = int(tail_match.group('tail'))
175
123
                else:
176
124
                    # Syntactically invalid range
177
 
                    return None
178
 
        if tail is not None:
179
 
            # Normalize tail into ranges
180
 
            ranges.append((max(0, file_size - tail), file_size))
181
 
 
182
 
        checked_ranges = []
183
 
        for start, end in ranges:
184
 
            if start >= file_size:
185
 
                # RFC2616 14.35, ranges are invalid if start >= file_size
186
 
                return None
187
 
            # RFC2616 14.35, end values should be truncated
188
 
            # to file_size -1 if they exceed it
189
 
            end = min(end, file_size - 1)
190
 
            checked_ranges.append((start, end))
191
 
        return checked_ranges
 
125
                    return 0, []
 
126
        return tail, ranges
192
127
 
193
128
    def _header_line_length(self, keyword, value):
194
129
        header_line = '%s: %s\r\n' % (keyword, value)
208
143
            self.end_headers()
209
144
            return None
210
145
 
211
 
        return http_server.SimpleHTTPRequestHandler.send_head(self)
 
146
        return SimpleHTTPServer.SimpleHTTPRequestHandler.send_head(self)
212
147
 
213
148
    def send_range_content(self, file, start, length):
214
149
        file.seek(start)
230
165
    def get_multiple_ranges(self, file, file_size, ranges):
231
166
        self.send_response(206)
232
167
        self.send_header('Accept-Ranges', 'bytes')
233
 
        boundary = '%d' % random.randint(0, 0x7FFFFFFF)
 
168
        boundary = '%d' % random.randint(0,0x7FFFFFFF)
234
169
        self.send_header('Content-Type',
235
170
                         'multipart/byteranges; boundary=%s' % boundary)
236
 
        boundary_line = b'--%s\r\n' % boundary.encode('ascii')
 
171
        boundary_line = '--%s\r\n' % boundary
237
172
        # Calculate the Content-Length
238
173
        content_length = 0
239
174
        for (start, end) in ranges:
242
177
                'Content-type', 'application/octet-stream')
243
178
            content_length += self._header_line_length(
244
179
                'Content-Range', 'bytes %d-%d/%d' % (start, end, file_size))
245
 
            content_length += len('\r\n')  # end headers
 
180
            content_length += len('\r\n') # end headers
246
181
            content_length += end - start + 1
247
182
        content_length += len(boundary_line)
248
183
        self.send_header('Content-length', content_length)
271
206
        ranges_header_value = self.headers.get('Range')
272
207
        if ranges_header_value is None or os.path.isdir(path):
273
208
            # Let the mother class handle most cases
274
 
            return http_server.SimpleHTTPRequestHandler.do_GET(self)
 
209
            return SimpleHTTPServer.SimpleHTTPRequestHandler.do_GET(self)
275
210
 
276
211
        try:
277
212
            # Always read in binary mode. Opening files in text
278
213
            # mode may cause newline translations, making the
279
214
            # actual size of the content transmitted *less* than
280
215
            # the content-length!
281
 
            f = open(path, 'rb')
 
216
            file = open(path, 'rb')
282
217
        except IOError:
283
218
            self.send_error(404, "File not found")
284
219
            return
285
220
 
286
 
        file_size = os.fstat(f.fileno())[6]
287
 
        ranges = self._parse_ranges(ranges_header_value, file_size)
288
 
        if not ranges:
 
221
        file_size = os.fstat(file.fileno())[6]
 
222
        tail, ranges = self.parse_ranges(ranges_header_value)
 
223
        # Normalize tail into ranges
 
224
        if tail != 0:
 
225
            ranges.append((file_size - tail, file_size))
 
226
 
 
227
        self._satisfiable_ranges = True
 
228
        if len(ranges) == 0:
 
229
            self._satisfiable_ranges = False
 
230
        else:
 
231
            def check_range(range_specifier):
 
232
                start, end = range_specifier
 
233
                # RFC2616 14.35, ranges are invalid if start >= file_size
 
234
                if start >= file_size:
 
235
                    self._satisfiable_ranges = False # Side-effect !
 
236
                    return 0, 0
 
237
                # RFC2616 14.35, end values should be truncated
 
238
                # to file_size -1 if they exceed it
 
239
                end = min(end, file_size - 1)
 
240
                return start, end
 
241
 
 
242
            ranges = map(check_range, ranges)
 
243
 
 
244
        if not self._satisfiable_ranges:
289
245
            # RFC2616 14.16 and 14.35 says that when a server
290
246
            # encounters unsatisfiable range specifiers, it
291
247
            # SHOULD return a 416.
292
 
            f.close()
 
248
            file.close()
293
249
            # FIXME: We SHOULD send a Content-Range header too,
294
250
            # but the implementation of send_error does not
295
251
            # allows that. So far.
298
254
 
299
255
        if len(ranges) == 1:
300
256
            (start, end) = ranges[0]
301
 
            self.get_single_range(f, file_size, start, end)
 
257
            self.get_single_range(file, file_size, start, end)
302
258
        else:
303
 
            self.get_multiple_ranges(f, file_size, ranges)
304
 
        f.close()
 
259
            self.get_multiple_ranges(file, file_size, ranges)
 
260
        file.close()
305
261
 
306
262
    def translate_path(self, path):
307
263
        """Translate a /-separated PATH to the local filename syntax.
320
276
            # do beginning with python 2.4.3: abandon query
321
277
            # parameters, scheme, host port, etc (which ensure we
322
278
            # provide the right behaviour on all python versions).
323
 
            path = urlparse(path)[2]
 
279
            path = urlparse.urlparse(path)[2]
324
280
            # And now, we can apply *our* trick to proxy files
325
281
            path += '-proxied'
326
282
 
338
294
        Override from python standard library to stop it calling os.getcwd()
339
295
        """
340
296
        # abandon query parameters
341
 
        path = urlparse(path)[2]
342
 
        path = posixpath.normpath(urlutils.unquote(path))
343
 
        if sys.version_info[0] == 2:
344
 
            path = path.decode('utf-8')
 
297
        path = urlparse.urlparse(path)[2]
 
298
        path = posixpath.normpath(urllib.unquote(path))
 
299
        path = path.decode('utf-8')
345
300
        words = path.split('/')
 
301
        words = filter(None, words)
346
302
        path = self._cwd
347
 
        for num, word in enumerate(w for w in words if w):
 
303
        for num, word in enumerate(words):
348
304
            if num == 0:
349
305
                drive, word = os.path.splitdrive(word)
350
306
            head, word = os.path.split(word)
351
 
            if word in (os.curdir, os.pardir):
352
 
                continue
 
307
            if word in (os.curdir, os.pardir): continue
353
308
            path = os.path.join(path, word)
354
309
        return path
355
310
 
364
319
        self.test_case_server = test_case_server
365
320
        self._home_dir = test_case_server._home_dir
366
321
 
367
 
 
368
 
class TestingHTTPServer(test_server.TestingTCPServer, TestingHTTPServerMixin):
 
322
    def stop_server(self):
 
323
         """Called to clean-up the server.
 
324
 
 
325
         Since the server may be (surely is, even) in a blocking listen, we
 
326
         shutdown its socket before closing it.
 
327
         """
 
328
         # Note that is this executed as part of the implicit tear down in the
 
329
         # main thread while the server runs in its own thread. The clean way
 
330
         # to tear down the server is to instruct him to stop accepting
 
331
         # connections and wait for the current connection(s) to end
 
332
         # naturally. To end the connection naturally, the http transports
 
333
         # should close their socket when they do not need to talk to the
 
334
         # server anymore. This happens naturally during the garbage collection
 
335
         # phase of the test transport objetcs (the server clients), so we
 
336
         # don't have to worry about them.  So, for the server, we must tear
 
337
         # down here, from the main thread, when the test have ended.  Note
 
338
         # that since the server is in a blocking operation and since python
 
339
         # use select internally, shutting down the socket is reliable and
 
340
         # relatively clean.
 
341
         try:
 
342
             self.socket.shutdown(socket.SHUT_RDWR)
 
343
         except socket.error, e:
 
344
             # WSAENOTCONN (10057) 'Socket is not connected' is harmless on
 
345
             # windows (occurs before the first connection attempt
 
346
             # vila--20071230)
 
347
 
 
348
             # 'Socket is not connected' can also occur on OSX, with a
 
349
             # "regular" ENOTCONN (when something went wrong during test case
 
350
             # setup leading to self.setUp() *not* being called but
 
351
             # self.stop_server() still being called -- vila20081106
 
352
             if not len(e.args) or e.args[0] not in (errno.ENOTCONN, 10057):
 
353
                 raise
 
354
         # Let the server properly close the socket
 
355
         self.server_close()
 
356
 
 
357
 
 
358
class TestingHTTPServer(SocketServer.TCPServer, TestingHTTPServerMixin):
369
359
 
370
360
    def __init__(self, server_address, request_handler_class,
371
361
                 test_case_server):
372
 
        test_server.TestingTCPServer.__init__(self, server_address,
373
 
                                              request_handler_class)
374
362
        TestingHTTPServerMixin.__init__(self, test_case_server)
375
 
 
376
 
 
377
 
class TestingThreadingHTTPServer(test_server.TestingThreadingTCPServer,
 
363
        SocketServer.TCPServer.__init__(self, server_address,
 
364
                                        request_handler_class)
 
365
 
 
366
 
 
367
class TestingThreadingHTTPServer(SocketServer.ThreadingTCPServer,
378
368
                                 TestingHTTPServerMixin):
379
369
    """A threading HTTP test server for HTTP 1.1.
380
370
 
385
375
 
386
376
    def __init__(self, server_address, request_handler_class,
387
377
                 test_case_server):
388
 
        test_server.TestingThreadingTCPServer.__init__(self, server_address,
389
 
                                                       request_handler_class)
390
378
        TestingHTTPServerMixin.__init__(self, test_case_server)
391
 
 
392
 
 
393
 
class HttpServer(test_server.TestingTCPServerInAThread):
 
379
        SocketServer.ThreadingTCPServer.__init__(self, server_address,
 
380
                                                 request_handler_class)
 
381
        # Decides how threads will act upon termination of the main
 
382
        # process. This is prophylactic as we should not leave the threads
 
383
        # lying around.
 
384
        self.daemon_threads = True
 
385
 
 
386
    def process_request_thread(self, request, client_address):
 
387
        SocketServer.ThreadingTCPServer.process_request_thread(
 
388
            self, request, client_address)
 
389
        # Under some circumstances (as in bug #383920), we need to force the
 
390
        # shutdown as python delays it until gc occur otherwise and the client
 
391
        # may hang.
 
392
        try:
 
393
            # The request process has been completed, the thread is about to
 
394
            # die, let's shutdown the socket if we can.
 
395
            request.shutdown(socket.SHUT_RDWR)
 
396
        except (socket.error, select.error), e:
 
397
            if e[0] in (errno.EBADF, errno.ENOTCONN):
 
398
                # Right, the socket is already down
 
399
                pass
 
400
            else:
 
401
                raise
 
402
 
 
403
 
 
404
class HttpServer(transport.Server):
394
405
    """A test server for http transports.
395
406
 
396
407
    Subclasses can provide a specific request handler.
418
429
        :param protocol_version: if specified, will override the protocol
419
430
            version of the request handler.
420
431
        """
421
 
        # Depending on the protocol version, we will create the approriate
422
 
        # server
423
 
        if protocol_version is None:
424
 
            # Use the request handler one
425
 
            proto_vers = request_handler.protocol_version
426
 
        else:
427
 
            # Use our own, it will be used to override the request handler
428
 
            # one too.
429
 
            proto_vers = protocol_version
430
 
        # Get the appropriate server class for the required protocol
431
 
        serv_cls = self.http_server_class.get(proto_vers, None)
432
 
        if serv_cls is None:
433
 
            raise http_client.UnknownProtocol(proto_vers)
 
432
        transport.Server.__init__(self)
 
433
        self.request_handler = request_handler
434
434
        self.host = 'localhost'
435
435
        self.port = 0
436
 
        super(HttpServer, self).__init__((self.host, self.port),
437
 
                                         serv_cls,
438
 
                                         request_handler)
439
 
        self.protocol_version = proto_vers
 
436
        self._httpd = None
 
437
        self.protocol_version = protocol_version
440
438
        # Allows tests to verify number of GET requests issued
441
439
        self.GET_request_nb = 0
442
 
        self._http_base_url = None
443
 
        self.logs = []
444
 
 
445
 
    def create_server(self):
446
 
        return self.server_class(
447
 
            (self.host, self.port), self.request_handler_class, self)
 
440
 
 
441
    def create_httpd(self, serv_cls, rhandler_cls):
 
442
        return serv_cls((self.host, self.port), self.request_handler, self)
 
443
 
 
444
    def __repr__(self):
 
445
        return "%s(%s:%s)" % \
 
446
            (self.__class__.__name__, self.host, self.port)
 
447
 
 
448
    def _get_httpd(self):
 
449
        if self._httpd is None:
 
450
            rhandler = self.request_handler
 
451
            # Depending on the protocol version, we will create the approriate
 
452
            # server
 
453
            if self.protocol_version is None:
 
454
                # Use the request handler one
 
455
                proto_vers = rhandler.protocol_version
 
456
            else:
 
457
                # Use our own, it will be used to override the request handler
 
458
                # one too.
 
459
                proto_vers = self.protocol_version
 
460
            # Create the appropriate server for the required protocol
 
461
            serv_cls = self.http_server_class.get(proto_vers, None)
 
462
            if serv_cls is None:
 
463
                raise httplib.UnknownProtocol(proto_vers)
 
464
            else:
 
465
                self._httpd = self.create_httpd(serv_cls, rhandler)
 
466
            self.host, self.port = self._httpd.socket.getsockname()
 
467
        return self._httpd
 
468
 
 
469
    def _http_start(self):
 
470
        """Server thread main entry point. """
 
471
        self._http_running = False
 
472
        try:
 
473
            try:
 
474
                httpd = self._get_httpd()
 
475
                self._http_base_url = '%s://%s:%s/' % (self._url_protocol,
 
476
                                                       self.host, self.port)
 
477
                self._http_running = True
 
478
            except:
 
479
                # Whatever goes wrong, we save the exception for the main
 
480
                # thread. Note that since we are running in a thread, no signal
 
481
                # can be received, so we don't care about KeyboardInterrupt.
 
482
                self._http_exception = sys.exc_info()
 
483
        finally:
 
484
            # Release the lock or the main thread will block and the whole
 
485
            # process will hang.
 
486
            self._http_starting.release()
 
487
 
 
488
        # From now on, exceptions are taken care of by the
 
489
        # SocketServer.BaseServer or the request handler.
 
490
        while self._http_running:
 
491
            try:
 
492
                # Really an HTTP connection but the python framework is generic
 
493
                # and call them requests
 
494
                httpd.handle_request()
 
495
            except socket.timeout:
 
496
                pass
 
497
            except (socket.error, select.error), e:
 
498
                if (e[0] == errno.EBADF
 
499
                    or (sys.platform == 'win32' and e[0] == 10038)):
 
500
                    # Starting with python-2.6, handle_request may raise socket
 
501
                    # or select exceptions when the server is shut down (as we
 
502
                    # do).
 
503
                    # 10038 = WSAENOTSOCK
 
504
                    # http://msdn.microsoft.com/en-us/library/ms740668%28VS.85%29.aspx
 
505
                    pass
 
506
                else:
 
507
                    raise
448
508
 
449
509
    def _get_remote_url(self, path):
450
510
        path_parts = path.split(os.path.sep)
451
511
        if os.path.isabs(path):
452
512
            if path_parts[:len(self._local_path_parts)] != \
453
 
                    self._local_path_parts:
 
513
                   self._local_path_parts:
454
514
                raise BadWebserverPath(path, self.test_dir)
455
515
            remote_path = '/'.join(path_parts[len(self._local_path_parts):])
456
516
        else:
463
523
        self.logs.append(format % args)
464
524
 
465
525
    def start_server(self, backing_transport_server=None):
466
 
        """See breezy.transport.Server.start_server.
 
526
        """See bzrlib.transport.Server.start_server.
467
527
 
468
528
        :param backing_transport_server: The transport that requests over this
469
529
            protocol should be forwarded to. Note that this is currently not
475
535
                or isinstance(backing_transport_server,
476
536
                              test_server.LocalURLServer)):
477
537
            raise AssertionError(
478
 
                "HTTPServer currently assumes local transport, got %s" %
 
538
                "HTTPServer currently assumes local transport, got %s" % \
479
539
                backing_transport_server)
480
 
        self._home_dir = osutils.getcwd()
 
540
        self._home_dir = os.getcwdu()
481
541
        self._local_path_parts = self._home_dir.split(os.path.sep)
 
542
        self._http_base_url = None
 
543
 
 
544
        # Create the server thread
 
545
        self._http_starting = threading.Lock()
 
546
        self._http_starting.acquire()
 
547
        self._http_thread = threading.Thread(target=self._http_start)
 
548
        self._http_thread.setDaemon(True)
 
549
        self._http_exception = None
 
550
        self._http_thread.start()
 
551
 
 
552
        # Wait for the server thread to start (i.e release the lock)
 
553
        self._http_starting.acquire()
 
554
 
 
555
        if self._http_exception is not None:
 
556
            # Something went wrong during server start
 
557
            exc_class, exc_value, exc_tb = self._http_exception
 
558
            raise exc_class, exc_value, exc_tb
 
559
        self._http_starting.release()
482
560
        self.logs = []
483
561
 
484
 
        super(HttpServer, self).start_server()
485
 
        self._http_base_url = '%s://%s:%s/' % (
486
 
            self._url_protocol, self.host, self.port)
 
562
    def stop_server(self):
 
563
        self._httpd.stop_server()
 
564
        self._http_running = False
 
565
        # We don't need to 'self._http_thread.join()' here since the thread is
 
566
        # a daemonic one and will be garbage collected anyway. Joining just
 
567
        # slows us down for no added benefit.
487
568
 
488
569
    def get_url(self):
489
 
        """See breezy.transport.Server.get_url."""
 
570
        """See bzrlib.transport.Server.get_url."""
490
571
        return self._get_remote_url(self._home_dir)
491
572
 
492
573
    def get_bogus_url(self):
493
 
        """See breezy.transport.Server.get_bogus_url."""
 
574
        """See bzrlib.transport.Server.get_bogus_url."""
494
575
        # this is chosen to try to prevent trouble with proxies, weird dns,
495
576
        # etc
496
577
        return self._url_protocol + '://127.0.0.1:1/'
 
578
 
 
579
 
 
580
class HttpServer_urllib(HttpServer):
 
581
    """Subclass of HttpServer that gives http+urllib urls.
 
582
 
 
583
    This is for use in testing: connections to this server will always go
 
584
    through urllib where possible.
 
585
    """
 
586
 
 
587
    # urls returned by this server should require the urllib client impl
 
588
    _url_protocol = 'http+urllib'
 
589
 
 
590
 
 
591
class HttpServer_PyCurl(HttpServer):
 
592
    """Subclass of HttpServer that gives http+pycurl urls.
 
593
 
 
594
    This is for use in testing: connections to this server will always go
 
595
    through pycurl where possible.
 
596
    """
 
597
 
 
598
    # We don't care about checking the pycurl availability as
 
599
    # this server will be required only when pycurl is present
 
600
 
 
601
    # urls returned by this server should require the pycurl client impl
 
602
    _url_protocol = 'http+pycurl'