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 io import BytesIO
21
from .lazy_import import lazy_import
22
lazy_import(globals(), """
24
transport as _mod_transport,
27
from breezy.bzr.bundle import serializer as _serializer
28
from breezy.merge_directive import MergeDirective
29
from breezy.i18n import gettext
35
from .trace import note
38
class Mergeable(object):
39
"""A mergeable object."""
41
def install_revisions(self, repository):
42
"""Install the data from this mergeable into the specified repository.
44
:param repository: Repository
46
raise NotImplementedError(self.install_revisions)
48
def get_merge_request(self, repository):
49
"""Extract merge request data.
51
:return: tuple with (base_revision_id, target_revision_id, verified)
53
raise NotImplementedError(self.get_merge_request)
56
def read_mergeable_from_url(url, _do_directive=True, possible_transports=None):
57
"""Read mergable object from a given URL.
59
:return: An object supporting get_target_revision. Raises NotABundle if
60
the target is not a mergeable type.
62
child_transport = _mod_transport.get_transport(
63
url, possible_transports=possible_transports)
64
transport = child_transport.clone('..')
65
filename = transport.relpath(child_transport.base)
66
mergeable, transport = read_mergeable_from_transport(transport, filename,
71
def read_mergeable_from_transport(transport, filename, _do_directive=True):
72
def get_bundle(transport):
73
return BytesIO(transport.get_bytes(filename)), transport
75
def redirected_transport(transport, exception, redirection_notice):
76
note(redirection_notice)
77
url, filename = urlutils.split(exception.target,
78
exclude_trailing_slash=False)
80
raise errors.NotABundle(gettext('A directory cannot be a bundle'))
81
return _mod_transport.get_transport_from_url(url)
84
bytef, transport = _mod_transport.do_catching_redirections(
85
get_bundle, transport, redirected_transport)
86
except errors.TooManyRedirections:
87
raise errors.NotABundle(transport.clone(filename).base)
88
except (errors.ConnectionReset, errors.ConnectionError) as e:
90
except (errors.TransportError, errors.PathError) as e:
91
raise errors.NotABundle(str(e))
92
except (IOError,) as e:
94
# Abstraction leakage, SFTPTransport.get('directory')
95
# doesn't always fail at get() time. Sometimes it fails
96
# during read. And that raises a generic IOError with
97
# just the string 'Failure'
98
# StubSFTPServer does fail during get() (because of prefetch)
99
# so it has an opportunity to translate the error.
100
raise errors.NotABundle(str(e))
104
return MergeDirective.from_lines(bytef), transport
105
except errors.NotAMergeDirective:
108
return _serializer.read_bundle(bytef), transport