1
# Copyright (C) 2005-2010 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
from __future__ import absolute_import
19
from .lazy_import import lazy_import
20
lazy_import(globals(), """
23
transport as _mod_transport,
26
from breezy.bundle import serializer as _serializer
27
from breezy.merge_directive import MergeDirective
28
from breezy.i18n import gettext
34
from .trace import note
37
class Mergeable(object):
38
"""A mergeable object."""
40
def install_revisions(self, repository):
41
"""Install the data from this mergeable into the specified repository.
43
:param repository: Repository
45
raise NotImplementedError(self.install_revisions)
47
def get_merge_request(self, repository):
48
"""Extract merge request data.
50
:return: tuple with (base_revision_id, target_revision_id, verified)
52
raise NotImplementedError(self.get_merge_request)
55
def read_mergeable_from_url(url, _do_directive=True, possible_transports=None):
56
"""Read mergable object from a given URL.
58
:return: An object supporting get_target_revision. Raises NotABundle if
59
the target is not a mergeable type.
61
child_transport = _mod_transport.get_transport(
62
url, possible_transports=possible_transports)
63
transport = child_transport.clone('..')
64
filename = transport.relpath(child_transport.base)
65
mergeable, transport = read_mergeable_from_transport(transport, filename,
70
def read_mergeable_from_transport(transport, filename, _do_directive=True):
71
def get_bundle(transport):
72
return BytesIO(transport.get_bytes(filename)), transport
74
def redirected_transport(transport, exception, redirection_notice):
75
note(redirection_notice)
76
url, filename = urlutils.split(exception.target,
77
exclude_trailing_slash=False)
79
raise errors.NotABundle(gettext('A directory cannot be a bundle'))
80
return _mod_transport.get_transport_from_url(url)
83
bytef, transport = _mod_transport.do_catching_redirections(
84
get_bundle, transport, redirected_transport)
85
except errors.TooManyRedirections:
86
raise errors.NotABundle(transport.clone(filename).base)
87
except (errors.ConnectionReset, errors.ConnectionError) as e:
89
except (errors.TransportError, errors.PathError) as e:
90
raise errors.NotABundle(str(e))
91
except (IOError,) as e:
93
# Abstraction leakage, SFTPTransport.get('directory')
94
# doesn't always fail at get() time. Sometimes it fails
95
# during read. And that raises a generic IOError with
96
# just the string 'Failure'
97
# StubSFTPServer does fail during get() (because of prefetch)
98
# so it has an opportunity to translate the error.
99
raise errors.NotABundle(str(e))
103
return MergeDirective.from_lines(bytef), transport
104
except errors.NotAMergeDirective:
107
return _serializer.read_bundle(bytef), transport