← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/testament.py

  • Committer: Robert Collins
  • Date: 2005-10-18 13:11:57 UTC
  • mfrom: (1185.16.72) (0.2.1)
  • Revision ID: robertc@robertcollins.net-20051018131157-76a9970aa78e927e
Merged Martin.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/testament.py
1
 
# Copyright (C) 2005 Canonical Ltd
 
1
# Copyright (C) 2005 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
70
70
# revisions can be serialized.
71
71
 
72
72
from copy import copy
 
73
from cStringIO import StringIO
 
74
import string
73
75
from sha import sha
74
76
 
75
77
from bzrlib.osutils import contains_whitespace, contains_linebreaks
76
78
 
77
 
 
78
79
class Testament(object):
79
80
    """Reduced summary of a revision.
80
81
 
81
82
    Testaments can be 
82
83
 
83
84
      - produced from a revision
84
 
      - written to a stream
 
85
      - writen to a stream
85
86
      - loaded from a stream
86
87
      - compared to a revision
87
88
    """
88
89
 
89
 
    long_header = 'bazaar-ng testament version 1\n'
90
 
    short_header = 'bazaar-ng testament short form 1\n'
91
 
 
92
90
    @classmethod
93
 
    def from_revision(cls, repository, revision_id):
 
91
    def from_revision(cls, branch, revision_id):
94
92
        """Produce a new testament from a historical revision"""
95
 
        rev = repository.get_revision(revision_id)
96
 
        inventory = repository.get_inventory(revision_id)
 
93
        rev = branch.get_revision(revision_id)
 
94
        inventory = branch.get_inventory(revision_id)
97
95
        return cls(rev, inventory)
98
96
 
99
97
    def __init__(self, rev, inventory):
116
114
        hashed in that encoding.
117
115
        """
118
116
        r = []
119
 
        a = r.append
120
 
        a(self.long_header)
 
117
        def a(s):
 
118
            r.append(s)
 
119
        a('bazaar-ng testament version 1\n')
121
120
        a('revision-id: %s\n' % self.revision_id)
122
121
        a('committer: %s\n' % self.committer)
123
122
        a('timestamp: %d\n' % self.timestamp)
131
130
        for l in self.message.splitlines():
132
131
            a('  %s\n' % l)
133
132
        a('inventory:\n')
134
 
        for path, ie in self._get_entries():
 
133
        for path, ie in self.inventory.iter_entries():
135
134
            a(self._entry_to_line(path, ie))
136
135
        r.extend(self._revprops_to_lines())
137
136
        if __debug__:
138
137
            for l in r:
139
138
                assert isinstance(l, basestring), \
140
139
                    '%r of type %s is not a plain string' % (l, type(l))
141
 
        return [line.encode('utf-8') for line in r]
142
 
 
143
 
    def _get_entries(self):
144
 
        entries = self.inventory.iter_entries()
145
 
        entries.next()
146
 
        return entries
 
140
        return r
147
141
 
148
142
    def _escape_path(self, path):
149
143
        assert not contains_linebreaks(path)
150
 
        return unicode(path.replace('\\', '/').replace(' ', '\ '))
 
144
        return unicode(path.replace('\\', '/').replace(' ', '\ ')).encode('utf-8')
151
145
 
152
146
    def _entry_to_line(self, path, ie):
153
147
        """Turn an inventory entry into a testament line"""
 
148
        l = '  ' + str(ie.kind)
 
149
        l += ' ' + self._escape_path(path)
154
150
        assert not contains_whitespace(ie.file_id)
155
 
 
156
 
        content = ''
157
 
        content_spacer=''
 
151
        l += ' ' + unicode(ie.file_id).encode('utf-8')
158
152
        if ie.kind == 'file':
159
153
            # TODO: avoid switching on kind
160
154
            assert ie.text_sha1
161
 
            content = ie.text_sha1
162
 
            content_spacer = ' '
 
155
            l += ' ' + ie.text_sha1
163
156
        elif ie.kind == 'symlink':
164
157
            assert ie.symlink_target
165
 
            content = self._escape_path(ie.symlink_target)
166
 
            content_spacer = ' '
167
 
 
168
 
        l = u'  %s %s %s%s%s\n' % (ie.kind, self._escape_path(path),
169
 
                                   unicode(ie.file_id),
170
 
                                   content_spacer, content)
 
158
            l += ' ' + self._escape_path(ie.symlink_target)
 
159
        l += '\n'
171
160
        return l
172
161
 
173
162
    def as_text(self):
175
164
 
176
165
    def as_short_text(self):
177
166
        """Return short digest-based testament."""
178
 
        return (self.short_header + 
 
167
        s = sha()
 
168
        map(s.update, self.as_text_lines())
 
169
        return ('bazaar-ng testament short form 1\n'
179
170
                'revision-id: %s\n'
180
171
                'sha1: %s\n'
181
 
                % (self.revision_id, self.as_sha1()))
 
172
                % (self.revision_id, s.hexdigest()))
182
173
 
183
174
    def _revprops_to_lines(self):
184
175
        """Pack up revision properties."""
190
181
            assert not contains_whitespace(name)
191
182
            r.append('  %s:\n' % name)
192
183
            for line in value.splitlines():
193
 
                r.append(u'    %s\n' % line)
 
184
                if not isinstance(line, str):
 
185
                    line = line.encode('utf-8')
 
186
                r.append('    %s\n' % line)
194
187
        return r
195
 
 
196
 
    def as_sha1(self):
197
 
        s = sha()
198
 
        map(s.update, self.as_text_lines())
199
 
        return s.hexdigest()
200
 
 
201
 
 
202
 
class StrictTestament(Testament):
203
 
    """This testament format is for use as a checksum in bundle format 0.8"""
204
 
 
205
 
    long_header = 'bazaar-ng testament version 2.1\n'
206
 
    short_header = 'bazaar-ng testament short form 2.1\n'
207
 
    def _entry_to_line(self, path, ie):
208
 
        l = Testament._entry_to_line(self, path, ie)[:-1]
209
 
        l += ' ' + ie.revision
210
 
        l += {True: ' yes\n', False: ' no\n'}[ie.executable]
211
 
        return l
212
 
 
213
 
 
214
 
class StrictTestament3(StrictTestament):
215
 
    """This testament format is for use as a checksum in bundle format 0.9+
216
 
    
217
 
    It differs from StrictTestament by including data about the tree root.
218
 
    """
219
 
 
220
 
    long_header = 'bazaar testament version 3 strict\n'
221
 
    short_header = 'bazaar testament short form 3 strict\n'
222
 
    def _get_entries(self):
223
 
        return self.inventory.iter_entries()
224
 
 
225
 
    def _escape_path(self, path):
226
 
        assert not contains_linebreaks(path)
227
 
        if path == '':
228
 
            path = '.'
229
 
        return unicode(path.replace('\\', '/').replace(' ', '\ '))