/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to bzrlib/bundle/commands.py

  • Committer: Robert Collins
  • Date: 2007-06-21 03:06:32 UTC
  • mto: This revision was merged to the branch mainline in revision 2543.
  • Revision ID: robertc@robertcollins.net-20070621030632-u20tpto23hcj15td
Create a document describing bundles and their motivation.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/bundle/commands.py
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2006 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
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
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
"""\
17
17
This is an attempt to take the internal delta object, and represent
18
18
it as a single-file text-only changeset.
21
21
"""
22
22
 
23
23
import sys
24
 
from cStringIO import StringIO
25
24
 
26
25
from bzrlib.lazy_import import lazy_import
27
26
lazy_import(globals(), """
28
27
from bzrlib import (
29
28
    branch,
30
29
    errors,
31
 
    merge_directive,
32
 
    revision as _mod_revision,
33
30
    urlutils,
34
 
    transport,
35
31
    )
36
32
""")
37
33
 
40
36
from bzrlib.trace import note
41
37
 
42
38
 
43
 
class cmd_bundle_info(Command):
44
 
    __doc__ = """Output interesting stats about a bundle"""
45
 
 
46
 
    hidden = True
47
 
    takes_args = ['location']
48
 
    takes_options = ['verbose']
 
39
class cmd_send_changeset(Command):
 
40
    """Send a bundled up changset via mail.
 
41
 
 
42
    If no revision has been specified, the last commited change will
 
43
    be sent.
 
44
 
 
45
    Subject of the mail can be specified by the --message option,
 
46
    otherwise information from the changeset log will be used.
 
47
 
 
48
    A editor will be spawned where the user may enter a description
 
49
    of the changeset.  The description can be read from a file with
 
50
    the --file FILE option.
 
51
    """
 
52
    takes_options = ['revision', 'message', 'file']
 
53
    takes_args = ['to?']
 
54
 
 
55
    def run(self, to=None, message=None, revision=None, file=None):
 
56
        from bzrlib.errors import BzrCommandError
 
57
        from send_changeset import send_changeset
 
58
        
 
59
        if isinstance(revision, (list, tuple)):
 
60
            if len(revision) > 1:
 
61
                raise BzrCommandError('We do not support rollup-changesets yet.')
 
62
            revision = revision[0]
 
63
 
 
64
        b = branch.Branch.open_containing('.')
 
65
 
 
66
        if not to:
 
67
            try:
 
68
                to = b.controlfile('x-send-address', 'rb').read().strip('\n')
 
69
            except:
 
70
                raise BzrCommandError('destination address is not known')
 
71
 
 
72
        if not isinstance(revision, (list, tuple)):
 
73
            revision = [revision]
 
74
 
 
75
        send_changeset(b, revision, to, message, file)
 
76
 
 
77
 
 
78
class cmd_bundle_revisions(Command):
 
79
    """Generate a revision bundle.
 
80
 
 
81
    This bundle contains all of the meta-information of a
 
82
    diff, rather than just containing the patch information.
 
83
 
 
84
    You can apply it to another tree using 'bzr merge'.
 
85
 
 
86
    bzr bundle-revisions
 
87
        - Generate a bundle relative to a remembered location
 
88
 
 
89
    bzr bundle-revisions BASE
 
90
        - Bundle to apply the current tree into BASE
 
91
 
 
92
    bzr bundle-revisions --revision A
 
93
        - Bundle to apply revision A to remembered location 
 
94
 
 
95
    bzr bundle-revisions --revision A..B
 
96
        - Bundle to transform A into B
 
97
    """
 
98
    takes_options = ['revision', 'remember',
 
99
                     Option("output", help="write bundle to specified file",
 
100
                            type=unicode)]
 
101
    takes_args = ['base?']
 
102
    aliases = ['bundle']
49
103
    encoding_type = 'exact'
50
104
 
51
 
    def run(self, location, verbose=False):
52
 
        from bzrlib.bundle.serializer import read_bundle
53
 
        from bzrlib.bundle import read_mergeable_from_url
54
 
        from bzrlib import osutils
55
 
        term_encoding = osutils.get_terminal_encoding()
56
 
        bundle_info = read_mergeable_from_url(location)
57
 
        if isinstance(bundle_info, merge_directive.BaseMergeDirective):
58
 
            bundle_file = StringIO(bundle_info.get_raw_bundle())
59
 
            bundle_info = read_bundle(bundle_file)
60
 
        else:
61
 
            if verbose:
62
 
                raise errors.BzrCommandError('--verbose requires a merge'
63
 
                    ' directive')
64
 
        reader_method = getattr(bundle_info, 'get_bundle_reader', None)
65
 
        if reader_method is None:
66
 
            raise errors.BzrCommandError('Bundle format not supported')
67
 
 
68
 
        by_kind = {}
69
 
        file_ids = set()
70
 
        for bytes, parents, repo_kind, revision_id, file_id\
71
 
            in reader_method().iter_records():
72
 
            by_kind.setdefault(repo_kind, []).append(
73
 
                (bytes, parents, repo_kind, revision_id, file_id))
74
 
            if file_id is not None:
75
 
                file_ids.add(file_id)
76
 
        self.outf.write('Records\n')
77
 
        for kind, records in sorted(by_kind.iteritems()):
78
 
            multiparent = sum(1 for b, m, k, r, f in records if
79
 
                              len(m.get('parents', [])) > 1)
80
 
            self.outf.write('%s: %d (%d multiparent)\n' % \
81
 
                (kind, len(records), multiparent))
82
 
        self.outf.write('unique files: %d\n' % len(file_ids))
83
 
        self.outf.write('\n')
84
 
        nicks = set()
85
 
        committers = set()
86
 
        for revision in bundle_info.real_revisions:
87
 
            if 'branch-nick' in revision.properties:
88
 
                nicks.add(revision.properties['branch-nick'])
89
 
            committers.add(revision.committer)
90
 
 
91
 
        self.outf.write('Revisions\n')
92
 
        self.outf.write(('nicks: %s\n'
93
 
            % ', '.join(sorted(nicks))).encode(term_encoding, 'replace'))
94
 
        self.outf.write(('committers: \n%s\n' %
95
 
        '\n'.join(sorted(committers)).encode(term_encoding, 'replace')))
96
 
        if verbose:
97
 
            self.outf.write('\n')
98
 
            bundle_file.seek(0)
99
 
            line = bundle_file.readline()
100
 
            line = bundle_file.readline()
101
 
            content = bundle_file.read().decode('bz2')
102
 
            self.outf.write("Decoded contents\n")
103
 
            self.outf.write(content)
104
 
            self.outf.write('\n')
 
105
    def run(self, base=None, revision=None, output=None, remember=False):
 
106
        from bzrlib import user_encoding
 
107
        from bzrlib.bundle.serializer import write_bundle
 
108
 
 
109
        target_branch = branch.Branch.open_containing(u'.')[0]
 
110
 
 
111
        if base is None:
 
112
            base_specified = False
 
113
        else:
 
114
            base_specified = True
 
115
 
 
116
        if revision is None:
 
117
            target_revision = target_branch.last_revision()
 
118
        elif len(revision) < 3:
 
119
            target_revision = revision[-1].in_history(target_branch).rev_id
 
120
            if len(revision) == 2:
 
121
                if base_specified:
 
122
                    raise errors.BzrCommandError('Cannot specify base as well'
 
123
                                                 ' as two revision arguments.')
 
124
                base_revision = revision[0].in_history(target_branch).rev_id
 
125
        else:
 
126
            raise errors.BzrCommandError('--revision takes 1 or 2 parameters')
 
127
 
 
128
        if revision is None or len(revision) < 2:
 
129
            submit_branch = target_branch.get_submit_branch()
 
130
            if base is None:
 
131
                base = submit_branch
 
132
            if base is None:
 
133
                base = target_branch.get_parent()
 
134
            if base is None:
 
135
                raise errors.BzrCommandError("No base branch known or"
 
136
                                             " specified.")
 
137
            elif not base_specified:
 
138
                # FIXME:
 
139
                # note() doesn't pay attention to terminal_encoding() so
 
140
                # we must format with 'ascii' to be safe
 
141
                note('Using saved location: %s',
 
142
                     urlutils.unescape_for_display(base, 'ascii'))
 
143
            base_branch = branch.Branch.open(base)
 
144
 
 
145
            # We don't want to lock the same branch across
 
146
            # 2 different branches
 
147
            if target_branch.base == base_branch.base:
 
148
                base_branch = target_branch 
 
149
            if submit_branch is None or remember:
 
150
                if base_specified:
 
151
                    target_branch.set_submit_branch(base_branch.base)
 
152
                elif remember:
 
153
                    raise errors.BzrCommandError('--remember requires a branch'
 
154
                                                 ' to be specified.')
 
155
            target_branch.repository.fetch(base_branch.repository, 
 
156
                                           base_branch.last_revision())
 
157
            graph = target_branch.repository.get_graph()
 
158
            base_revision = graph.find_unique_lca(
 
159
                base_branch.last_revision(), target_revision)
 
160
 
 
161
        if output is not None:
 
162
            fileobj = file(output, 'wb')
 
163
        else:
 
164
            fileobj = sys.stdout
 
165
        target_branch.repository.lock_read()
 
166
        try:
 
167
            write_bundle(target_branch.repository, target_revision,
 
168
                         base_revision, fileobj)
 
169
        finally:
 
170
            target_branch.repository.unlock()
 
171
 
 
172
 
 
173
class cmd_verify_changeset(Command):
 
174
    """Read a written changeset, and make sure it is valid.
 
175
 
 
176
    """
 
177
    takes_args = ['filename?']
 
178
 
 
179
    def run(self, filename=None):
 
180
        from read_changeset import read_changeset
 
181
        #from bzrlib.xml import serializer_v4
 
182
 
 
183
        b, relpath = branch.Branch.open_containing('.')
 
184
 
 
185
        if filename is None or filename == '-':
 
186
            f = sys.stdin
 
187
        else:
 
188
            f = open(filename, 'U')
 
189
 
 
190
        cset_info, cset_tree = read_changeset(f, b)
 
191
        # print cset_info
 
192
        # print cset_tree
 
193
        #serializer_v4.write(cset_tree.inventory, sys.stdout)