/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 breezy/tests/http_server.py

  • Committer: Jelmer Vernooij
  • Date: 2018-04-02 00:52:27 UTC
  • mfrom: (6939 work)
  • mto: This revision was merged to the branch mainline in revision 7274.
  • Revision ID: jelmer@jelmer.uk-20180402005227-pecflp1mvdjrjqd6
Merge trunk.

Show diffs side-by-side

added added

removed removed

Lines of Context:
breezy/tests/http_server.py
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2006-2011 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
 
import httplib
 
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
19
24
import os
20
25
import posixpath
21
26
import random
22
27
import re
23
 
import select
24
 
import SimpleHTTPServer
25
28
import socket
26
 
import SocketServer
27
 
import sys
28
 
import threading
29
 
import time
30
 
import urllib
31
 
import urlparse
 
29
try:
 
30
    from urlparse import urlparse
 
31
except ImportError:
 
32
    from urllib.parse import urlparse
32
33
 
33
 
from bzrlib import transport
34
 
from bzrlib.tests import test_server
35
 
from bzrlib.transport import local
 
34
from .. import (
 
35
    osutils,
 
36
    urlutils,
 
37
)
 
38
from . import test_server
36
39
 
37
40
 
38
41
class BadWebserverPath(ValueError):
40
43
        return 'path %s is not in %s' % self.args
41
44
 
42
45
 
43
 
class TestingHTTPRequestHandler(SimpleHTTPServer.SimpleHTTPRequestHandler):
 
46
class TestingHTTPRequestHandler(http_server.SimpleHTTPRequestHandler):
44
47
    """Handles one request.
45
48
 
46
49
    A TestingHTTPRequestHandler is instantiated for every request received by
52
55
    protocol_version = 'HTTP/1.1'
53
56
 
54
57
    # The Message-like class used to parse the request headers
55
 
    MessageClass = httplib.HTTPMessage
 
58
    MessageClass = http_client.HTTPMessage
56
59
 
57
60
    def setup(self):
58
 
        SimpleHTTPServer.SimpleHTTPRequestHandler.setup(self)
 
61
        http_server.SimpleHTTPRequestHandler.setup(self)
59
62
        self._cwd = self.server._home_dir
60
63
        tcs = self.server.test_case_server
61
64
        if tcs.protocol_version is not None:
78
81
        connection early to avoid polluting the test results.
79
82
        """
80
83
        try:
81
 
            SimpleHTTPServer.SimpleHTTPRequestHandler.handle_one_request(self)
82
 
        except socket.error, e:
 
84
            self._handle_one_request()
 
85
        except socket.error as e:
83
86
            # Any socket error should close the connection, but some errors are
84
87
            # due to the client closing early and we don't want to pollute test
85
88
            # results, so we raise only the others.
89
92
                                     errno.ECONNABORTED, errno.EBADF)):
90
93
                raise
91
94
 
92
 
    _range_regexp = re.compile(r'^(?P<start>\d+)-(?P<end>\d+)$')
 
95
    error_content_type = 'text/plain'
 
96
    error_message_format = '''\
 
97
Error code: %(code)s.
 
98
Message: %(message)s.
 
99
'''
 
100
 
 
101
    def send_error(self, code, message=None):
 
102
        """Send and log an error reply.
 
103
 
 
104
        We redefine the python-provided version to be able to set a 
 
105
        ``Content-Length`` header as some http/1.1 clients complain otherwise
 
106
        (see bug #568421).
 
107
 
 
108
        :param code: The HTTP error code.
 
109
 
 
110
        :param message: The explanation of the error code, Defaults to a short
 
111
             entry.
 
112
        """
 
113
 
 
114
        if message is None:
 
115
            try:
 
116
                message = self.responses[code][0]
 
117
            except KeyError:
 
118
                message = '???'
 
119
        self.log_error("code %d, message %s", code, message)
 
120
        content = (self.error_message_format %
 
121
                   {'code': code, 'message': message})
 
122
        self.send_response(code, message)
 
123
        self.send_header("Content-Type", self.error_content_type)
 
124
        self.send_header("Content-Length", "%d" % len(content))
 
125
        self.send_header('Connection', 'close')
 
126
        self.end_headers()
 
127
        if self.command != 'HEAD' and code >= 200 and code not in (204, 304):
 
128
            self.wfile.write(content)
 
129
 
 
130
    def _handle_one_request(self):
 
131
        http_server.SimpleHTTPRequestHandler.handle_one_request(self)
 
132
 
 
133
    _range_regexp = re.compile(r'^(?P<start>\d+)-(?P<end>\d+)?$')
93
134
    _tail_regexp = re.compile(r'^-(?P<tail>\d+)$')
94
135
 
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.
 
136
    def _parse_ranges(self, ranges_header, file_size):
 
137
        """Parse the range header value and returns ranges.
 
138
 
 
139
        RFC2616 14.35 says that syntactically invalid range specifiers MUST be
 
140
        ignored. In that case, we return None instead of a range list.
 
141
 
 
142
        :param ranges_header: The 'Range' header value.
 
143
 
 
144
        :param file_size: The size of the requested file.
 
145
 
 
146
        :return: A list of (start, end) tuples or None if some invalid range
 
147
            specifier is encountered.
101
148
        """
102
 
        tail = 0
103
 
        ranges = []
104
149
        if not ranges_header.startswith('bytes='):
105
150
            # Syntactically invalid header
106
 
            return 0, []
 
151
            return None
107
152
 
 
153
        tail = None
 
154
        ranges = []
108
155
        ranges_header = ranges_header[len('bytes='):]
109
156
        for range_str in ranges_header.split(','):
110
 
            # FIXME: RFC2616 says end is optional and default to file_size
111
157
            range_match = self._range_regexp.match(range_str)
112
158
            if range_match is not None:
113
159
                start = int(range_match.group('start'))
114
 
                end = int(range_match.group('end'))
 
160
                end_match = range_match.group('end')
 
161
                if end_match is None:
 
162
                    # RFC2616 says end is optional and default to file_size
 
163
                    end = file_size
 
164
                else:
 
165
                    end = int(end_match)
115
166
                if start > end:
116
167
                    # Syntactically invalid range
117
 
                    return 0, []
 
168
                    return None
118
169
                ranges.append((start, end))
119
170
            else:
120
171
                tail_match = self._tail_regexp.match(range_str)
122
173
                    tail = int(tail_match.group('tail'))
123
174
                else:
124
175
                    # Syntactically invalid range
125
 
                    return 0, []
126
 
        return tail, ranges
 
176
                    return None
 
177
        if tail is not None:
 
178
            # Normalize tail into ranges
 
179
            ranges.append((max(0, file_size - tail), file_size))
 
180
 
 
181
        checked_ranges = []
 
182
        for start, end in ranges:
 
183
            if start >= file_size:
 
184
                # RFC2616 14.35, ranges are invalid if start >= file_size
 
185
                return None
 
186
            # RFC2616 14.35, end values should be truncated
 
187
            # to file_size -1 if they exceed it
 
188
            end = min(end, file_size - 1)
 
189
            checked_ranges.append((start, end))
 
190
        return checked_ranges
127
191
 
128
192
    def _header_line_length(self, keyword, value):
129
193
        header_line = '%s: %s\r\n' % (keyword, value)
143
207
            self.end_headers()
144
208
            return None
145
209
 
146
 
        return SimpleHTTPServer.SimpleHTTPRequestHandler.send_head(self)
 
210
        return http_server.SimpleHTTPRequestHandler.send_head(self)
147
211
 
148
212
    def send_range_content(self, file, start, length):
149
213
        file.seek(start)
165
229
    def get_multiple_ranges(self, file, file_size, ranges):
166
230
        self.send_response(206)
167
231
        self.send_header('Accept-Ranges', 'bytes')
168
 
        boundary = '%d' % random.randint(0,0x7FFFFFFF)
 
232
        boundary = '%d' % random.randint(0, 0x7FFFFFFF)
169
233
        self.send_header('Content-Type',
170
234
                         'multipart/byteranges; boundary=%s' % boundary)
171
235
        boundary_line = '--%s\r\n' % boundary
206
270
        ranges_header_value = self.headers.get('Range')
207
271
        if ranges_header_value is None or os.path.isdir(path):
208
272
            # Let the mother class handle most cases
209
 
            return SimpleHTTPServer.SimpleHTTPRequestHandler.do_GET(self)
 
273
            return http_server.SimpleHTTPRequestHandler.do_GET(self)
210
274
 
211
275
        try:
212
276
            # Always read in binary mode. Opening files in text
213
277
            # mode may cause newline translations, making the
214
278
            # actual size of the content transmitted *less* than
215
279
            # the content-length!
216
 
            file = open(path, 'rb')
 
280
            f = open(path, 'rb')
217
281
        except IOError:
218
282
            self.send_error(404, "File not found")
219
283
            return
220
284
 
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:
 
285
        file_size = os.fstat(f.fileno())[6]
 
286
        ranges = self._parse_ranges(ranges_header_value, file_size)
 
287
        if not ranges:
245
288
            # RFC2616 14.16 and 14.35 says that when a server
246
289
            # encounters unsatisfiable range specifiers, it
247
290
            # SHOULD return a 416.
248
 
            file.close()
 
291
            f.close()
249
292
            # FIXME: We SHOULD send a Content-Range header too,
250
293
            # but the implementation of send_error does not
251
294
            # allows that. So far.
254
297
 
255
298
        if len(ranges) == 1:
256
299
            (start, end) = ranges[0]
257
 
            self.get_single_range(file, file_size, start, end)
 
300
            self.get_single_range(f, file_size, start, end)
258
301
        else:
259
 
            self.get_multiple_ranges(file, file_size, ranges)
260
 
        file.close()
 
302
            self.get_multiple_ranges(f, file_size, ranges)
 
303
        f.close()
261
304
 
262
305
    def translate_path(self, path):
263
306
        """Translate a /-separated PATH to the local filename syntax.
276
319
            # do beginning with python 2.4.3: abandon query
277
320
            # parameters, scheme, host port, etc (which ensure we
278
321
            # provide the right behaviour on all python versions).
279
 
            path = urlparse.urlparse(path)[2]
 
322
            path = urlparse(path)[2]
280
323
            # And now, we can apply *our* trick to proxy files
281
324
            path += '-proxied'
282
325
 
294
337
        Override from python standard library to stop it calling os.getcwd()
295
338
        """
296
339
        # abandon query parameters
297
 
        path = urlparse.urlparse(path)[2]
298
 
        path = posixpath.normpath(urllib.unquote(path))
 
340
        path = urlparse(path)[2]
 
341
        path = posixpath.normpath(urlutils.unquote(path))
299
342
        path = path.decode('utf-8')
300
343
        words = path.split('/')
301
 
        words = filter(None, words)
302
344
        path = self._cwd
303
 
        for num, word in enumerate(words):
 
345
        for num, word in enumerate(w for w in words if w):
304
346
            if num == 0:
305
347
                drive, word = os.path.splitdrive(word)
306
348
            head, word = os.path.split(word)
319
361
        self.test_case_server = test_case_server
320
362
        self._home_dir = test_case_server._home_dir
321
363
 
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):
 
364
 
 
365
class TestingHTTPServer(test_server.TestingTCPServer, TestingHTTPServerMixin):
359
366
 
360
367
    def __init__(self, server_address, request_handler_class,
361
368
                 test_case_server):
 
369
        test_server.TestingTCPServer.__init__(self, server_address,
 
370
                                              request_handler_class)
362
371
        TestingHTTPServerMixin.__init__(self, test_case_server)
363
 
        SocketServer.TCPServer.__init__(self, server_address,
364
 
                                        request_handler_class)
365
 
 
366
 
 
367
 
class TestingThreadingHTTPServer(SocketServer.ThreadingTCPServer,
 
372
 
 
373
 
 
374
class TestingThreadingHTTPServer(test_server.TestingThreadingTCPServer,
368
375
                                 TestingHTTPServerMixin):
369
376
    """A threading HTTP test server for HTTP 1.1.
370
377
 
372
379
    server, we need an independent connection for each of them. We achieve that
373
380
    by spawning a new thread for each connection.
374
381
    """
375
 
 
376
382
    def __init__(self, server_address, request_handler_class,
377
383
                 test_case_server):
 
384
        test_server.TestingThreadingTCPServer.__init__(self, server_address,
 
385
                                                       request_handler_class)
378
386
        TestingHTTPServerMixin.__init__(self, test_case_server)
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):
 
387
 
 
388
 
 
389
class HttpServer(test_server.TestingTCPServerInAThread):
405
390
    """A test server for http transports.
406
391
 
407
392
    Subclasses can provide a specific request handler.
429
414
        :param protocol_version: if specified, will override the protocol
430
415
            version of the request handler.
431
416
        """
432
 
        transport.Server.__init__(self)
433
 
        self.request_handler = request_handler
 
417
        # Depending on the protocol version, we will create the approriate
 
418
        # server
 
419
        if protocol_version is None:
 
420
            # Use the request handler one
 
421
            proto_vers = request_handler.protocol_version
 
422
        else:
 
423
            # Use our own, it will be used to override the request handler
 
424
            # one too.
 
425
            proto_vers = protocol_version
 
426
        # Get the appropriate server class for the required protocol
 
427
        serv_cls = self.http_server_class.get(proto_vers, None)
 
428
        if serv_cls is None:
 
429
            raise http_client.UnknownProtocol(proto_vers)
434
430
        self.host = 'localhost'
435
431
        self.port = 0
436
 
        self._httpd = None
437
 
        self.protocol_version = protocol_version
 
432
        super(HttpServer, self).__init__((self.host, self.port),
 
433
                                         serv_cls,
 
434
                                         request_handler)
 
435
        self.protocol_version = proto_vers
438
436
        # Allows tests to verify number of GET requests issued
439
437
        self.GET_request_nb = 0
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
 
438
        self._http_base_url = None
 
439
        self.logs = []
 
440
 
 
441
    def create_server(self):
 
442
        return self.server_class(
 
443
            (self.host, self.port), self.request_handler_class, self)
508
444
 
509
445
    def _get_remote_url(self, path):
510
446
        path_parts = path.split(os.path.sep)
523
459
        self.logs.append(format % args)
524
460
 
525
461
    def start_server(self, backing_transport_server=None):
526
 
        """See bzrlib.transport.Server.start_server.
 
462
        """See breezy.transport.Server.start_server.
527
463
 
528
464
        :param backing_transport_server: The transport that requests over this
529
465
            protocol should be forwarded to. Note that this is currently not
535
471
                or isinstance(backing_transport_server,
536
472
                              test_server.LocalURLServer)):
537
473
            raise AssertionError(
538
 
                "HTTPServer currently assumes local transport, got %s" % \
 
474
                "HTTPServer currently assumes local transport, got %s" %
539
475
                backing_transport_server)
540
 
        self._home_dir = os.getcwdu()
 
476
        self._home_dir = osutils.getcwd()
541
477
        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()
560
478
        self.logs = []
561
479
 
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.
 
480
        super(HttpServer, self).start_server()
 
481
        self._http_base_url = '%s://%s:%s/' % (
 
482
            self._url_protocol, self.host, self.port)
568
483
 
569
484
    def get_url(self):
570
 
        """See bzrlib.transport.Server.get_url."""
 
485
        """See breezy.transport.Server.get_url."""
571
486
        return self._get_remote_url(self._home_dir)
572
487
 
573
488
    def get_bogus_url(self):
574
 
        """See bzrlib.transport.Server.get_bogus_url."""
 
489
        """See breezy.transport.Server.get_bogus_url."""
575
490
        # this is chosen to try to prevent trouble with proxies, weird dns,
576
491
        # etc
577
492
        return self._url_protocol + '://127.0.0.1:1/'
586
501
 
587
502
    # urls returned by this server should require the urllib client impl
588
503
    _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'