1
# Copyright (C) 2006 Canonical Ltd
 
 
3
# This program is free software; you can redistribute it and/or modify
 
 
4
# it under the terms of the GNU General Public License as published by
 
 
5
# the Free Software Foundation; either version 2 of the License, or
 
 
6
# (at your option) any later version.
 
 
8
# This program is distributed in the hope that it will be useful,
 
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
 
11
# GNU General Public License for more details.
 
 
13
# You should have received a copy of the GNU General Public License
 
 
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
 
 
18
from urlparse import urlparse
 
 
20
from bzrlib.smart import protocol
 
 
27
class _SmartClient(object):
 
 
29
    def __init__(self, medium, base):
 
 
32
        :param medium: a SmartClientMedium
 
 
38
    def _build_client_protocol(self):
 
 
39
        version = self._medium.protocol_version()
 
 
40
        request = self._medium.get_request()
 
 
42
            smart_protocol = protocol.SmartClientRequestProtocolTwo(request)
 
 
44
            smart_protocol = protocol.SmartClientRequestProtocolOne(request)
 
 
47
    def call(self, method, *args):
 
 
48
        """Call a method on the remote server."""
 
 
49
        result, protocol = self.call_expecting_body(method, *args)
 
 
50
        protocol.cancel_read_body()
 
 
53
    def call_expecting_body(self, method, *args):
 
 
54
        """Call a method and return the result and the protocol object.
 
 
56
        The body can be read like so::
 
 
58
            result, smart_protocol = smart_client.call_expecting_body(...)
 
 
59
            body = smart_protocol.read_body_bytes()
 
 
61
        smart_protocol = self._build_client_protocol()
 
 
62
        smart_protocol.call(method, *args)
 
 
63
        return smart_protocol.read_response_tuple(expect_body=True), smart_protocol
 
 
65
    def call_with_body_bytes(self, method, args, body):
 
 
66
        """Call a method on the remote server with body bytes."""
 
 
67
        if type(method) is not str:
 
 
68
            raise TypeError('method must be a byte string, not %r' % (method,))
 
 
70
            if type(arg) is not str:
 
 
71
                raise TypeError('args must be byte strings, not %r' % (args,))
 
 
72
        if type(body) is not str:
 
 
73
            raise TypeError('body must be byte string, not %r' % (body,))
 
 
74
        smart_protocol = self._build_client_protocol()
 
 
75
        smart_protocol.call_with_body_bytes((method, ) + args, body)
 
 
76
        return smart_protocol.read_response_tuple()
 
 
78
    def call_with_body_bytes_expecting_body(self, method, args, body):
 
 
79
        """Call a method on the remote server with body bytes."""
 
 
80
        if type(method) is not str:
 
 
81
            raise TypeError('method must be a byte string, not %r' % (method,))
 
 
83
            if type(arg) is not str:
 
 
84
                raise TypeError('args must be byte strings, not %r' % (args,))
 
 
85
        if type(body) is not str:
 
 
86
            raise TypeError('body must be byte string, not %r' % (body,))
 
 
87
        smart_protocol = self._build_client_protocol()
 
 
88
        smart_protocol.call_with_body_bytes((method, ) + args, body)
 
 
89
        return smart_protocol.read_response_tuple(expect_body=True), smart_protocol
 
 
91
    def remote_path_from_transport(self, transport):
 
 
92
        """Convert transport into a path suitable for using in a request.
 
 
94
        Note that the resulting remote path doesn't encode the host name or
 
 
95
        anything but path, so it is only safe to use it in requests sent over
 
 
96
        the medium from the matching transport.
 
 
99
        if (base.startswith('bzr+http://') or base.startswith('bzr+https://')
 
 
100
            or base.startswith('http://') or base.startswith('https://')):
 
 
101
            medium_base = self._base
 
 
103
            medium_base = urlutils.join(self._base, '/')
 
 
105
        rel_url = urlutils.relative_url(medium_base, transport.base)
 
 
106
        return urllib.unquote(rel_url)