~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/plugins/launchpad/lp_registration.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2006-08-31 06:06:38 UTC
  • mfrom: (1966.1.2 build-resolver)
  • Revision ID: pqm@pqm.ubuntu.com-20060831060638-bfc0303de36a40a8
Behave reasonably when creating a checkout in a directory with files

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2006 by 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
7
7
#
8
8
# This program is distributed in the hope that it will be useful,
9
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.
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
 
11
# # GNU General Public License for more details.
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
 
 
17
 
 
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
 
 
18
from getpass import getpass
18
19
import os
19
 
import socket
20
20
from urlparse import urlsplit, urlunsplit
21
21
import urllib
22
22
import xmlrpclib
23
23
 
24
 
from bzrlib import (
25
 
    config,
26
 
    errors,
27
 
    urlutils,
28
 
    __version__ as _bzrlib_version,
29
 
    )
30
 
from bzrlib.transport.http import _urllib2_wrappers
31
 
 
 
24
import bzrlib.config
 
25
import bzrlib.errors as errors
32
26
 
33
27
# for testing, do
34
28
'''
35
29
export BZR_LP_XMLRPC_URL=http://xmlrpc.staging.launchpad.net/bazaar/
36
30
'''
37
31
 
38
 
class InvalidLaunchpadInstance(errors.BzrError):
39
 
 
40
 
    _fmt = "%(lp_instance)s is not a valid Launchpad instance."
41
 
 
42
 
    def __init__(self, lp_instance):
43
 
        errors.BzrError.__init__(self, lp_instance=lp_instance)
44
 
 
45
 
 
46
 
class NotLaunchpadBranch(errors.BzrError):
47
 
 
48
 
    _fmt = "%(url)s is not registered on Launchpad."
49
 
 
50
 
    def __init__(self, url):
51
 
        errors.BzrError.__init__(self, url=url)
52
 
 
53
 
 
54
 
class XMLRPCTransport(xmlrpclib.Transport):
55
 
 
56
 
    def __init__(self, scheme):
57
 
        # In python2.4 xmlrpclib.Transport is a old-style class, and does not
58
 
        # define __init__, so we check first
59
 
        init = getattr(xmlrpclib.Transport, '__init__', None)
60
 
        if init is not None:
61
 
            init(self)
62
 
        self._scheme = scheme
63
 
        self._opener = _urllib2_wrappers.Opener()
64
 
        self.verbose = 0
65
 
 
66
 
    def request(self, host, handler, request_body, verbose=0):
67
 
        self.verbose = verbose
68
 
        url = self._scheme + "://" + host + handler
69
 
        request = _urllib2_wrappers.Request("POST", url, request_body)
70
 
        # FIXME: _urllib2_wrappers will override user-agent with its own
71
 
        # request.add_header("User-Agent", self.user_agent)
72
 
        request.add_header("Content-Type", "text/xml")
73
 
 
74
 
        response = self._opener.open(request)
75
 
        if response.code != 200:
76
 
            raise xmlrpclib.ProtocolError(host + handler, response.code,
77
 
                                          response.msg, response.info())
78
 
        return self.parse_response(response)
79
 
 
80
 
 
81
32
class LaunchpadService(object):
82
33
    """A service to talk to Launchpad via XMLRPC.
83
 
 
84
 
    See http://wiki.bazaar.canonical.com/Specs/LaunchpadRpc for the methods we can call.
 
34
    
 
35
    See http://bazaar-vcs.org/Specs/LaunchpadRpc for the methods we can call.
85
36
    """
86
37
 
87
 
    LAUNCHPAD_DOMAINS = {
88
 
        'production': 'launchpad.net',
89
 
        'edge': 'edge.launchpad.net',
90
 
        'staging': 'staging.launchpad.net',
91
 
        'demo': 'demo.launchpad.net',
92
 
        'dev': 'launchpad.dev',
93
 
        }
94
 
 
95
 
    # NB: these should always end in a slash to avoid xmlrpclib appending
 
38
    # NB: this should always end in a slash to avoid xmlrpclib appending
96
39
    # '/RPC2'
97
 
    LAUNCHPAD_INSTANCE = {}
98
 
    for instance, domain in LAUNCHPAD_DOMAINS.iteritems():
99
 
        LAUNCHPAD_INSTANCE[instance] = 'https://xmlrpc.%s/bazaar/' % domain
100
 
 
101
 
    # Previously 'edge' was used to avoid a launchpad bug with redirection
102
 
    DEFAULT_INSTANCE = 'production'
103
 
    DEFAULT_SERVICE_URL = LAUNCHPAD_INSTANCE[DEFAULT_INSTANCE]
 
40
    DEFAULT_SERVICE_URL = 'https://xmlrpc.launchpad.net/bazaar/'
104
41
 
105
42
    transport = None
106
43
    registrant_email = None
107
44
    registrant_password = None
108
45
 
109
46
 
110
 
    def __init__(self, transport=None, lp_instance=None):
 
47
    def __init__(self, transport=None):
111
48
        """Construct a new service talking to the launchpad rpc server"""
112
 
        self._lp_instance = lp_instance
113
49
        if transport is None:
114
50
            uri_type = urllib.splittype(self.service_url)[0]
115
 
            transport = XMLRPCTransport(uri_type)
 
51
            if uri_type == 'https':
 
52
                transport = xmlrpclib.SafeTransport()
 
53
            else:
 
54
                transport = xmlrpclib.Transport()
116
55
            transport.user_agent = 'bzr/%s (xmlrpclib/%s)' \
117
 
                    % (_bzrlib_version, xmlrpclib.__version__)
 
56
                    % (bzrlib.__version__, xmlrpclib.__version__)
118
57
        self.transport = transport
119
58
 
 
59
 
120
60
    @property
121
61
    def service_url(self):
122
62
        """Return the http or https url for the xmlrpc server.
126
66
        key = 'BZR_LP_XMLRPC_URL'
127
67
        if key in os.environ:
128
68
            return os.environ[key]
129
 
        elif self._lp_instance is not None:
130
 
            try:
131
 
                return self.LAUNCHPAD_INSTANCE[self._lp_instance]
132
 
            except KeyError:
133
 
                raise InvalidLaunchpadInstance(self._lp_instance)
134
69
        else:
135
70
            return self.DEFAULT_SERVICE_URL
136
71
 
137
 
    @classmethod
138
 
    def for_url(cls, url, **kwargs):
139
 
        """Return the Launchpad service corresponding to the given URL."""
140
 
        result = urlsplit(url)
141
 
        lp_instance = result[1]
142
 
        if lp_instance == '':
143
 
            lp_instance = None
144
 
        elif lp_instance not in cls.LAUNCHPAD_INSTANCE:
145
 
            raise errors.InvalidURL(path=url)
146
 
        return cls(lp_instance=lp_instance, **kwargs)
147
 
 
148
 
    def get_proxy(self, authenticated):
 
72
    def get_proxy(self):
149
73
        """Return the proxy for XMLRPC requests."""
150
 
        if authenticated:
151
 
            # auth info must be in url
152
 
            # TODO: if there's no registrant email perhaps we should
153
 
            # just connect anonymously?
154
 
            scheme, hostinfo, path = urlsplit(self.service_url)[:3]
155
 
            if '@' in hostinfo:
156
 
                raise AssertionError(hostinfo)
157
 
            if self.registrant_email is None:
158
 
                raise AssertionError()
159
 
            if self.registrant_password is None:
160
 
                raise AssertionError()
161
 
            # TODO: perhaps fully quote the password to make it very slightly
162
 
            # obscured
163
 
            # TODO: can we perhaps add extra Authorization headers
164
 
            # directly to the request, rather than putting this into
165
 
            # the url?  perhaps a bit more secure against accidentally
166
 
            # revealing it.  std66 s3.2.1 discourages putting the
167
 
            # password in the url.
168
 
            hostinfo = '%s:%s@%s' % (urllib.quote(self.registrant_email),
169
 
                                     urllib.quote(self.registrant_password),
170
 
                                     hostinfo)
171
 
            url = urlunsplit((scheme, hostinfo, path, '', ''))
172
 
        else:
173
 
            url = self.service_url
 
74
        # auth info must be in url
 
75
        # TODO: if there's no registrant email perhaps we should just connect
 
76
        # anonymously?
 
77
        scheme, hostinfo, path = urlsplit(self.service_url)[:3]
 
78
        assert '@' not in hostinfo
 
79
        assert self.registrant_email is not None
 
80
        assert self.registrant_password is not None
 
81
        # TODO: perhaps fully quote the password to make it very slightly
 
82
        # obscured
 
83
        # TODO: can we perhaps add extra Authorization headers directly to the 
 
84
        # request, rather than putting this into the url?  perhaps a bit more 
 
85
        # secure against accidentally revealing it.  std66 s3.2.1 discourages putting
 
86
        # the password in the url.
 
87
        hostinfo = '%s:%s@%s' % (urllib.quote(self.registrant_email),
 
88
                                 urllib.quote(self.registrant_password),
 
89
                                 hostinfo)
 
90
        url = urlunsplit((scheme, hostinfo, path, '', ''))
174
91
        return xmlrpclib.ServerProxy(url, transport=self.transport)
175
92
 
176
93
    def gather_user_credentials(self):
177
94
        """Get the password from the user."""
178
 
        the_config = config.GlobalConfig()
179
 
        self.registrant_email = the_config.user_email()
 
95
        config = bzrlib.config.GlobalConfig()
 
96
        self.registrant_email = config.user_email()
180
97
        if self.registrant_password is None:
181
 
            auth = config.AuthenticationConfig()
182
 
            scheme, hostinfo = urlsplit(self.service_url)[:2]
183
98
            prompt = 'launchpad.net password for %s: ' % \
184
99
                    self.registrant_email
185
 
            # We will reuse http[s] credentials if we can, prompt user
186
 
            # otherwise
187
 
            self.registrant_password = auth.get_password(scheme, hostinfo,
188
 
                                                         self.registrant_email,
189
 
                                                         prompt=prompt)
 
100
            self.registrant_password = getpass(prompt)
190
101
 
191
 
    def send_request(self, method_name, method_params, authenticated):
192
 
        proxy = self.get_proxy(authenticated)
 
102
    def send_request(self, method_name, method_params):
 
103
        proxy = self.get_proxy()
 
104
        assert method_name
193
105
        method = getattr(proxy, method_name)
194
106
        try:
195
107
            result = method(*method_params)
206
118
                # TODO: print more headers to help in tracking down failures
207
119
                raise errors.BzrError("xmlrpc protocol error connecting to %s: %s %s"
208
120
                        % (self.service_url, e.errcode, e.errmsg))
209
 
        except socket.gaierror, e:
210
 
            raise errors.ConnectionError(
211
 
                "Could not resolve '%s'" % self.domain,
212
 
                orig_error=e)
213
121
        return result
214
122
 
215
 
    @property
216
 
    def domain(self):
217
 
        if self._lp_instance is None:
218
 
            instance = self.DEFAULT_INSTANCE
219
 
        else:
220
 
            instance = self._lp_instance
221
 
        return self.LAUNCHPAD_DOMAINS[instance]
222
 
 
223
 
    def _guess_branch_path(self, branch_url, _request_factory=None):
224
 
        scheme, hostinfo, path = urlsplit(branch_url)[:3]
225
 
        if _request_factory is None:
226
 
            _request_factory = ResolveLaunchpadPathRequest
227
 
        if scheme == 'lp':
228
 
            resolve = _request_factory(path)
229
 
            try:
230
 
                result = resolve.submit(self)
231
 
            except xmlrpclib.Fault, fault:
232
 
                raise errors.InvalidURL(branch_url, str(fault))
233
 
            branch_url = result['urls'][0]
234
 
            path = urlsplit(branch_url)[2]
235
 
        else:
236
 
            domains = (
237
 
                'bazaar.%s' % domain
238
 
                for domain in self.LAUNCHPAD_DOMAINS.itervalues())
239
 
            if hostinfo not in domains:
240
 
                raise NotLaunchpadBranch(branch_url)
241
 
        return path.lstrip('/')
242
 
 
243
 
    def get_web_url_from_branch_url(self, branch_url, _request_factory=None):
244
 
        """Get the Launchpad web URL for the given branch URL.
245
 
 
246
 
        :raise errors.InvalidURL: if 'branch_url' cannot be identified as a
247
 
            Launchpad branch URL.
248
 
        :return: The URL of the branch on Launchpad.
249
 
        """
250
 
        path = self._guess_branch_path(branch_url, _request_factory)
251
 
        return urlutils.join('https://code.%s' % self.domain, path)
252
 
 
253
123
 
254
124
class BaseRequest(object):
255
125
    """Base request for talking to a XMLRPC server."""
256
126
 
257
127
    # Set this to the XMLRPC method name.
258
128
    _methodname = None
259
 
    _authenticated = True
260
129
 
261
130
    def _request_params(self):
262
131
        """Return the arguments to pass to the method"""
268
137
        :param service: LaunchpadService indicating where to send
269
138
            the request and the authentication credentials.
270
139
        """
271
 
        return service.send_request(self._methodname, self._request_params(),
272
 
                                    self._authenticated)
 
140
        return service.send_request(self._methodname, self._request_params())
273
141
 
274
142
 
275
143
class DryRunLaunchpadService(LaunchpadService):
276
144
    """Service that just absorbs requests without sending to server.
277
 
 
 
145
    
278
146
    The dummy service does not need authentication.
279
147
    """
280
148
 
281
 
    def send_request(self, method_name, method_params, authenticated):
 
149
    def send_request(self, method_name, method_params):
282
150
        pass
283
151
 
284
152
    def gather_user_credentials(self):
297
165
                 author_email='',
298
166
                 product_name='',
299
167
                 ):
300
 
        if not branch_url:
301
 
            raise errors.InvalidURL(branch_url, "You need to specify a non-empty branch URL.")
 
168
        assert branch_url
302
169
        self.branch_url = branch_url
303
170
        if branch_name:
304
171
            self.branch_name = branch_name
332
199
    _methodname = 'link_branch_to_bug'
333
200
 
334
201
    def __init__(self, branch_url, bug_id):
 
202
        assert branch_url
335
203
        self.bug_id = bug_id
336
204
        self.branch_url = branch_url
337
205
 
340
208
        # This must match the parameter tuple expected by Launchpad for this
341
209
        # method
342
210
        return (self.branch_url, self.bug_id, '')
343
 
 
344
 
 
345
 
class ResolveLaunchpadPathRequest(BaseRequest):
346
 
    """Request to resolve the path component of an lp: URL."""
347
 
 
348
 
    _methodname = 'resolve_lp_path'
349
 
    _authenticated = False
350
 
 
351
 
    def __init__(self, path):
352
 
        if not path:
353
 
            raise errors.InvalidURL(path=path,
354
 
                                    extra="You must specify a project.")
355
 
        self.path = path
356
 
 
357
 
    def _request_params(self):
358
 
        """Return xmlrpc request parameters"""
359
 
        return (self.path,)