← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/tree.py

Update news and readme

- better explanation of dependencies

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/tree.py
26
26
from bzrlib.inventory import Inventory
27
27
from bzrlib.osutils import appendpath, fingerprint_file
28
28
 
 
29
 
 
30
exporters = {}
 
31
 
29
32
class Tree(object):
30
33
    """Abstract file tree.
31
34
 
68
71
    def id2path(self, file_id):
69
72
        return self.inventory.id2path(file_id)
70
73
 
71
 
    def kind(self, file_id):
72
 
        raise NotImplementedError("subclasses must implement kind")
73
 
 
74
74
    def _get_inventory(self):
75
75
        return self._inventory
76
76
    
106
106
        sys.stdout.write(self.get_file_text(file_id))
107
107
        
108
108
        
 
109
    def export(self, dest, format='dir', root=None):
 
110
        """Export this tree."""
 
111
        try:
 
112
            exporter = exporters[format]
 
113
        except KeyError:
 
114
            from bzrlib.errors import BzrCommandError
 
115
            raise BzrCommandError("export format %r not supported" % format)
 
116
        exporter(self, dest, root)
 
117
 
 
118
 
 
119
 
109
120
class RevisionTree(Tree):
110
121
    """Tree viewing a previous revision.
111
122
 
171
182
    def kind(self, file_id):
172
183
        return self._inventory[file_id].kind
173
184
 
174
 
 
175
185
class EmptyTree(Tree):
176
186
    def __init__(self):
177
187
        self._inventory = Inventory()
182
192
    def has_filename(self, filename):
183
193
        return False
184
194
 
185
 
    def kind(self, file_id):
186
 
        assert self._inventory[file_id].kind == "root_directory"
187
 
        return "root_directory"
188
 
 
189
195
    def list_files(self):
190
196
        return iter([])
191
197
    
263
269
            
264
270
 
265
271
 
 
272
######################################################################
 
273
# export
 
274
 
 
275
def dir_exporter(tree, dest, root):
 
276
    """Export this tree to a new directory.
 
277
 
 
278
    `dest` should not exist, and will be created holding the
 
279
    contents of this tree.
 
280
 
 
281
    TODO: To handle subdirectories we need to create the
 
282
           directories first.
 
283
 
 
284
    :note: If the export fails, the destination directory will be
 
285
           left in a half-assed state.
 
286
    """
 
287
    import os
 
288
    os.mkdir(dest)
 
289
    mutter('export version %r' % tree)
 
290
    inv = tree.inventory
 
291
    for dp, ie in inv.iter_entries():
 
292
        ie.put_on_disk(dest, dp, tree)
 
293
 
 
294
exporters['dir'] = dir_exporter
 
295
 
 
296
try:
 
297
    import tarfile
 
298
except ImportError:
 
299
    pass
 
300
else:
 
301
    def get_root_name(dest):
 
302
        """Get just the root name for a tarball.
 
303
 
 
304
        >>> get_root_name('mytar.tar')
 
305
        'mytar'
 
306
        >>> get_root_name('mytar.tar.bz2')
 
307
        'mytar'
 
308
        >>> get_root_name('tar.tar.tar.tgz')
 
309
        'tar.tar.tar'
 
310
        >>> get_root_name('bzr-0.0.5.tar.gz')
 
311
        'bzr-0.0.5'
 
312
        >>> get_root_name('a/long/path/mytar.tgz')
 
313
        'mytar'
 
314
        >>> get_root_name('../parent/../dir/other.tbz2')
 
315
        'other'
 
316
        """
 
317
        endings = ['.tar', '.tar.gz', '.tgz', '.tar.bz2', '.tbz2']
 
318
        dest = os.path.basename(dest)
 
319
        for end in endings:
 
320
            if dest.endswith(end):
 
321
                return dest[:-len(end)]
 
322
 
 
323
    def tar_exporter(tree, dest, root, compression=None):
 
324
        """Export this tree to a new tar file.
 
325
 
 
326
        `dest` will be created holding the contents of this tree; if it
 
327
        already exists, it will be clobbered, like with "tar -c".
 
328
        """
 
329
        from time import time
 
330
        now = time()
 
331
        compression = str(compression or '')
 
332
        if root is None:
 
333
            root = get_root_name(dest)
 
334
        try:
 
335
            ball = tarfile.open(dest, 'w:' + compression)
 
336
        except tarfile.CompressionError, e:
 
337
            raise BzrError(str(e))
 
338
        mutter('export version %r' % tree)
 
339
        inv = tree.inventory
 
340
        for dp, ie in inv.iter_entries():
 
341
            mutter("  export {%s} kind %s to %s" % (ie.file_id, ie.kind, dest))
 
342
            item, fileobj = ie.get_tar_item(root, dp, now, tree)
 
343
            ball.addfile(item, fileobj)
 
344
        ball.close()
 
345
 
 
346
    exporters['tar'] = tar_exporter
 
347
 
 
348
    def tgz_exporter(tree, dest, root):
 
349
        tar_exporter(tree, dest, root, compression='gz')
 
350
    exporters['tgz'] = tgz_exporter
 
351
 
 
352
    def tbz_exporter(tree, dest, root):
 
353
        tar_exporter(tree, dest, root, compression='bz2')
 
354
    exporters['tbz2'] = tbz_exporter