1
 
# Copyright (C) 2007-2010 Canonical Ltd
 
 
1
# Copyright (C) 2007 Canonical Ltd
 
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
 
 
37
35
from bzrlib.email_message import EmailMessage
 
40
 
class MergeRequestBodyParams(object):
 
41
 
    """Parameter object for the merge_request_body hook."""
 
43
 
    def __init__(self, body, orig_body, directive, to, basename, subject,
 
46
 
        self.orig_body = orig_body
 
47
 
        self.directive = directive
 
51
 
        self.basename = basename
 
52
 
        self.subject = subject
 
55
 
class MergeDirectiveHooks(hooks.Hooks):
 
56
 
    """Hooks for MergeDirective classes."""
 
59
 
        hooks.Hooks.__init__(self)
 
60
 
        self.create_hook(hooks.HookPoint('merge_request_body',
 
61
 
            "Called with a MergeRequestBodyParams when a body is needed for"
 
62
 
            " a merge request.  Callbacks must return a body.  If more"
 
63
 
            " than one callback is registered, the output of one callback is"
 
64
 
            " provided to the next.", (1, 15, 0), False))
 
67
 
class BaseMergeDirective(object):
 
68
 
    """A request to perform a merge into a branch.
 
70
 
    This is the base class that all merge directive implementations 
 
73
 
    :cvar multiple_output_files: Whether or not this merge directive 
 
74
 
        stores a set of revisions in more than one file
 
77
 
    hooks = MergeDirectiveHooks()
 
79
 
    multiple_output_files = False
 
 
38
class _BaseMergeDirective(object):
 
81
40
    def __init__(self, revision_id, testament_sha1, time, timezone,
 
82
41
                 target_branch, patch=None, source_branch=None, message=None,
 
 
102
61
        self.source_branch = source_branch
 
103
62
        self.message = message
 
106
 
        """Serialize as a list of lines
 
108
 
        :return: a list of lines
 
110
 
        raise NotImplementedError(self.to_lines)
 
113
 
        """Serialize as a set of files.
 
115
 
        :return: List of tuples with filename and contents as lines
 
117
 
        raise NotImplementedError(self.to_files)
 
119
 
    def get_raw_bundle(self):
 
120
 
        """Return the bundle for this merge directive.
 
122
 
        :return: bundle text or None if there is no bundle
 
126
64
    def _to_lines(self, base_revision=False):
 
127
65
        """Serialize as a list of lines
 
 
142
80
        lines.append('# \n')
 
145
 
    def write_to_directory(self, path):
 
146
 
        """Write this merge directive to a series of files in a directory.
 
148
 
        :param path: Filesystem path to write to
 
150
 
        raise NotImplementedError(self.write_to_directory)
 
153
84
    def from_objects(klass, repository, revision_id, time, timezone,
 
154
85
                 target_branch, patch_type='bundle',
 
 
309
240
                target_repo.fetch(source_branch.repository, self.revision_id)
 
310
241
        return self.revision_id
 
312
 
    def compose_merge_request(self, mail_client, to, body, branch, tree=None):
 
313
 
        """Compose a request to merge this directive.
 
315
 
        :param mail_client: The mail client to use for composing this request.
 
316
 
        :param to: The address to compose the request to.
 
317
 
        :param branch: The Branch that was used to produce this directive.
 
318
 
        :param tree: The Tree (if any) for the Branch used to produce this
 
321
 
        basename = self.get_disk_name(branch)
 
323
 
        if self.message is not None:
 
324
 
            subject += self.message
 
326
 
            revision = branch.repository.get_revision(self.revision_id)
 
327
 
            subject += revision.get_summary()
 
328
 
        if getattr(mail_client, 'supports_body', False):
 
330
 
            for hook in self.hooks['merge_request_body']:
 
331
 
                params = MergeRequestBodyParams(body, orig_body, self,
 
332
 
                                                to, basename, subject, branch,
 
335
 
        elif len(self.hooks['merge_request_body']) > 0:
 
336
 
            trace.warning('Cannot run merge_request_body hooks because mail'
 
337
 
                          ' client %s does not support message bodies.',
 
338
 
                        mail_client.__class__.__name__)
 
339
 
        mail_client.compose_merge_request(to, subject,
 
340
 
                                          ''.join(self.to_lines()),
 
344
 
class MergeDirective(BaseMergeDirective):
 
 
244
class MergeDirective(_BaseMergeDirective):
 
346
246
    """A request to perform a merge into a branch.
 
 
376
276
        :param source_branch: A public location to merge the revision from
 
377
277
        :param message: The message to use when committing this merge
 
379
 
        BaseMergeDirective.__init__(self, revision_id, testament_sha1, time,
 
 
279
        _BaseMergeDirective.__init__(self, revision_id, testament_sha1, time,
 
380
280
            timezone, target_branch, patch, source_branch, message)
 
381
281
        if patch_type not in (None, 'diff', 'bundle'):
 
382
282
            raise ValueError(patch_type)
 
 
409
309
        :return: a MergeRequest
 
411
311
        line_iter = iter(lines)
 
413
312
        for line in line_iter:
 
414
313
            if line.startswith('# Bazaar merge directive format '):
 
415
 
                return _format_registry.get(line[2:].rstrip())._from_lines(
 
417
 
            firstline = firstline or line.strip()
 
418
 
        raise errors.NotAMergeDirective(firstline)
 
 
317
                raise errors.NotAMergeDirective(lines[0])
 
 
319
                raise errors.NotAMergeDirective('')
 
 
320
        return _format_registry.get(line[2:].rstrip())._from_lines(line_iter)
 
421
323
    def _from_lines(klass, line_iter):
 
 
466
368
        return None, self.revision_id, 'inapplicable'
 
469
 
class MergeDirective2(BaseMergeDirective):
 
 
371
class MergeDirective2(_BaseMergeDirective):
 
471
373
    _format_string = 'Bazaar merge directive format 2 (Bazaar 0.90)'
 
 
475
377
                 bundle=None, base_revision_id=None):
 
476
378
        if source_branch is None and bundle is None:
 
477
379
            raise errors.NoMergeSource()
 
478
 
        BaseMergeDirective.__init__(self, revision_id, testament_sha1, time,
 
 
380
        _BaseMergeDirective.__init__(self, revision_id, testament_sha1, time,
 
479
381
            timezone, target_branch, patch, source_branch, message)
 
480
382
        self.bundle = bundle
 
481
383
        self.base_revision_id = base_revision_id
 
 
619
521
                    raise errors.PublicBranchOutOfDate(public_branch,
 
621
 
            testament_sha1 = t.as_sha1()
 
623
524
            for entry in reversed(locked):
 
625
 
        return klass(revision_id, testament_sha1, time, timezone,
 
626
 
            target_branch, patch, public_branch, message, bundle,
 
 
526
        return klass(revision_id, t.as_sha1(), time, timezone, target_branch,
 
 
527
            patch, public_branch, message, bundle, base_revision_id)
 
629
529
    def _verify_patch(self, repository):
 
630
530
        calculated_patch = self._generate_diff(repository, self.revision_id,
 
 
666
566
_format_registry = MergeDirectiveFormatRegistry()
 
667
567
_format_registry.register(MergeDirective)
 
668
568
_format_registry.register(MergeDirective2)
 
669
 
# 0.19 never existed.  It got renamed to 0.90.  But by that point, there were
 
670
 
# already merge directives in the wild that used 0.19. Registering with the old
 
671
 
# format string to retain compatibility with those merge directives.
 
672
569
_format_registry.register(MergeDirective2,
 
673
570
                          'Bazaar merge directive format 2 (Bazaar 0.19)')