~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tests/http_server.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2010-07-16 14:02:58 UTC
  • mfrom: (5346.2.3 doc)
  • Revision ID: pqm@pqm.ubuntu.com-20100716140258-js1p8i24w8nodz6t
(mbp) developer docs about transports and symlinks (Martin Pool)

Show diffs side-by-side

added added

removed removed

Lines of Context:
30
30
import urllib
31
31
import urlparse
32
32
 
33
 
from bzrlib import (
34
 
    osutils,
35
 
    tests,
36
 
    transport,
37
 
    )
 
33
from bzrlib import transport
38
34
from bzrlib.tests import test_server
39
35
from bzrlib.transport import local
40
36
 
75
71
                self.headers.get('referer', '-'),
76
72
                self.headers.get('user-agent', '-'))
77
73
 
78
 
    def handle(self):
79
 
        SimpleHTTPServer.SimpleHTTPRequestHandler.handle(self)
80
 
        # Some client (pycurl, I'm looking at you) are more picky than others
81
 
        # and require that the socket itself is closed
82
 
        # (SocketServer.StreamRequestHandler only close the two associated
83
 
        # 'makefile' objects)
84
 
        self.connection.close()
85
 
 
86
74
    def handle_one_request(self):
87
75
        """Handle a single HTTP request.
88
76
 
90
78
        connection early to avoid polluting the test results.
91
79
        """
92
80
        try:
93
 
            self._handle_one_request()
 
81
            SimpleHTTPServer.SimpleHTTPRequestHandler.handle_one_request(self)
94
82
        except socket.error, e:
95
83
            # Any socket error should close the connection, but some errors are
96
84
            # due to the client closing early and we don't want to pollute test
101
89
                                     errno.ECONNABORTED, errno.EBADF)):
102
90
                raise
103
91
 
104
 
    error_content_type = 'text/plain'
105
 
    error_message_format = '''\
106
 
Error code: %(code)s.
107
 
Message: %(message)s.
108
 
'''
109
 
 
110
 
    def send_error(self, code, message=None):
111
 
        """Send and log an error reply.
112
 
 
113
 
        We redefine the python-provided version to be able to set a 
114
 
        ``Content-Length`` header as some http/1.1 clients complain otherwise
115
 
        (see bug #568421).
116
 
 
117
 
        :param code: The HTTP error code.
118
 
 
119
 
        :param message: The explanation of the error code, Defaults to a short
120
 
             entry.
121
 
        """
122
 
 
123
 
        if message is None:
124
 
            try:
125
 
                message = self.responses[code][0]
126
 
            except KeyError:
127
 
                message = '???'
128
 
        self.log_error("code %d, message %s", code, message)
129
 
        content = (self.error_message_format %
130
 
                   {'code': code, 'message': message})
131
 
        self.send_response(code, message)
132
 
        self.send_header("Content-Type", self.error_content_type)
133
 
        self.send_header("Content-Length", "%d" % len(content))
134
 
        self.send_header('Connection', 'close')
135
 
        self.end_headers()
136
 
        if self.command != 'HEAD' and code >= 200 and code not in (204, 304):
137
 
            self.wfile.write(content)
138
 
 
139
 
    def _handle_one_request(self):
140
 
        SimpleHTTPServer.SimpleHTTPRequestHandler.handle_one_request(self)
141
 
 
142
92
    _range_regexp = re.compile(r'^(?P<start>\d+)-(?P<end>\d+)$')
143
93
    _tail_regexp = re.compile(r'^-(?P<tail>\d+)$')
144
94
 
263
213
            # mode may cause newline translations, making the
264
214
            # actual size of the content transmitted *less* than
265
215
            # the content-length!
266
 
            f = open(path, 'rb')
 
216
            file = open(path, 'rb')
267
217
        except IOError:
268
218
            self.send_error(404, "File not found")
269
219
            return
270
220
 
271
 
        file_size = os.fstat(f.fileno())[6]
 
221
        file_size = os.fstat(file.fileno())[6]
272
222
        tail, ranges = self.parse_ranges(ranges_header_value)
273
223
        # Normalize tail into ranges
274
224
        if tail != 0:
295
245
            # RFC2616 14.16 and 14.35 says that when a server
296
246
            # encounters unsatisfiable range specifiers, it
297
247
            # SHOULD return a 416.
298
 
            f.close()
 
248
            file.close()
299
249
            # FIXME: We SHOULD send a Content-Range header too,
300
250
            # but the implementation of send_error does not
301
251
            # allows that. So far.
304
254
 
305
255
        if len(ranges) == 1:
306
256
            (start, end) = ranges[0]
307
 
            self.get_single_range(f, file_size, start, end)
 
257
            self.get_single_range(file, file_size, start, end)
308
258
        else:
309
 
            self.get_multiple_ranges(f, file_size, ranges)
310
 
        f.close()
 
259
            self.get_multiple_ranges(file, file_size, ranges)
 
260
        file.close()
311
261
 
312
262
    def translate_path(self, path):
313
263
        """Translate a /-separated PATH to the local filename syntax.
369
319
        self.test_case_server = test_case_server
370
320
        self._home_dir = test_case_server._home_dir
371
321
 
372
 
 
373
 
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):
374
359
 
375
360
    def __init__(self, server_address, request_handler_class,
376
361
                 test_case_server):
377
 
        test_server.TestingTCPServer.__init__(self, server_address,
378
 
                                              request_handler_class)
379
362
        TestingHTTPServerMixin.__init__(self, test_case_server)
380
 
 
381
 
 
382
 
class TestingThreadingHTTPServer(test_server.TestingThreadingTCPServer,
 
363
        SocketServer.TCPServer.__init__(self, server_address,
 
364
                                        request_handler_class)
 
365
 
 
366
 
 
367
class TestingThreadingHTTPServer(SocketServer.ThreadingTCPServer,
383
368
                                 TestingHTTPServerMixin):
384
369
    """A threading HTTP test server for HTTP 1.1.
385
370
 
387
372
    server, we need an independent connection for each of them. We achieve that
388
373
    by spawning a new thread for each connection.
389
374
    """
 
375
 
390
376
    def __init__(self, server_address, request_handler_class,
391
377
                 test_case_server):
392
 
        test_server.TestingThreadingTCPServer.__init__(self, server_address,
393
 
                                                       request_handler_class)
394
378
        TestingHTTPServerMixin.__init__(self, test_case_server)
395
 
 
396
 
 
397
 
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):
398
405
    """A test server for http transports.
399
406
 
400
407
    Subclasses can provide a specific request handler.
422
429
        :param protocol_version: if specified, will override the protocol
423
430
            version of the request handler.
424
431
        """
425
 
        # Depending on the protocol version, we will create the approriate
426
 
        # server
427
 
        if protocol_version is None:
428
 
            # Use the request handler one
429
 
            proto_vers = request_handler.protocol_version
430
 
        else:
431
 
            # Use our own, it will be used to override the request handler
432
 
            # one too.
433
 
            proto_vers = protocol_version
434
 
        # Get the appropriate server class for the required protocol
435
 
        serv_cls = self.http_server_class.get(proto_vers, None)
436
 
        if serv_cls is None:
437
 
            raise httplib.UnknownProtocol(proto_vers)
 
432
        transport.Server.__init__(self)
 
433
        self.request_handler = request_handler
438
434
        self.host = 'localhost'
439
435
        self.port = 0
440
 
        super(HttpServer, self).__init__((self.host, self.port),
441
 
                                         serv_cls,
442
 
                                         request_handler)
443
 
        self.protocol_version = proto_vers
 
436
        self._httpd = None
 
437
        self.protocol_version = protocol_version
444
438
        # Allows tests to verify number of GET requests issued
445
439
        self.GET_request_nb = 0
446
 
        self._http_base_url = None
447
 
        self.logs = []
448
 
 
449
 
    def create_server(self):
450
 
        return self.server_class(
451
 
            (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
452
508
 
453
509
    def _get_remote_url(self, path):
454
510
        path_parts = path.split(os.path.sep)
479
535
                or isinstance(backing_transport_server,
480
536
                              test_server.LocalURLServer)):
481
537
            raise AssertionError(
482
 
                "HTTPServer currently assumes local transport, got %s" %
 
538
                "HTTPServer currently assumes local transport, got %s" % \
483
539
                backing_transport_server)
484
540
        self._home_dir = os.getcwdu()
485
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()
486
560
        self.logs = []
487
561
 
488
 
        super(HttpServer, self).start_server()
489
 
        self._http_base_url = '%s://%s:%s/' % (
490
 
            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.
491
568
 
492
569
    def get_url(self):
493
570
        """See bzrlib.transport.Server.get_url."""