~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/mutabletree.py

  • Committer: Jelmer Vernooij
  • Date: 2011-12-19 10:58:39 UTC
  • mfrom: (6383 +trunk)
  • mto: This revision was merged to the branch mainline in revision 6386.
  • Revision ID: jelmer@canonical.com-20111219105839-uji05ck4rkm1mj4j
Merge bzr.dev.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2010 Canonical Ltd
 
1
# Copyright (C) 2006-2011 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
14
14
# along with this program; if not, write to the Free Software
15
15
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
16
16
 
 
17
from __future__ import absolute_import
 
18
 
17
19
"""MutableTree object.
18
20
 
19
21
See MutableTree for more details.
22
24
 
23
25
from bzrlib.lazy_import import lazy_import
24
26
lazy_import(globals(), """
 
27
import operator
25
28
import os
26
29
import re
27
30
 
28
31
from bzrlib import (
29
32
    add,
30
 
    bzrdir,
 
33
    controldir,
31
34
    errors,
32
35
    hooks,
 
36
    inventory as _mod_inventory,
33
37
    osutils,
34
38
    revisiontree,
35
 
    symbol_versioning,
36
39
    trace,
 
40
    transport as _mod_transport,
37
41
    tree,
38
42
    )
39
43
""")
69
73
    conformance tests for - rather we are testing MemoryTree specifically, and
70
74
    interface testing implementations of WorkingTree.
71
75
 
72
 
    A mutable tree always has an associated Branch and BzrDir object - the
 
76
    A mutable tree always has an associated Branch and ControlDir object - the
73
77
    branch and bzrdir attributes.
74
78
    """
75
79
    def __init__(self, *args, **kw):
79
83
        # used on media which doesn't differentiate the case of names.
80
84
        self.case_sensitive = True
81
85
 
 
86
    def is_control_filename(self, filename):
 
87
        """True if filename is the name of a control file in this tree.
 
88
 
 
89
        :param filename: A filename within the tree. This is a relative path
 
90
            from the root of this tree.
 
91
 
 
92
        This is true IF and ONLY IF the filename is part of the meta data
 
93
        that bzr controls in this tree. I.E. a random .bzr directory placed
 
94
        on disk will not be a control file for this tree.
 
95
        """
 
96
        raise NotImplementedError(self.is_control_filename)
 
97
 
82
98
    @needs_tree_write_lock
83
99
    def add(self, files, ids=None, kinds=None):
84
100
        """Add paths to the set of versioned paths.
148
164
        if sub_tree_id == self.get_root_id():
149
165
            raise errors.BadReferenceTarget(self, sub_tree,
150
166
                                     'Trees have the same root id.')
151
 
        if sub_tree_id in self.inventory:
 
167
        if self.has_id(sub_tree_id):
152
168
            raise errors.BadReferenceTarget(self, sub_tree,
153
169
                                            'Root id already present in tree')
154
170
        self._add([sub_tree_path], [sub_tree_id], ['tree-reference'])
163
179
        """
164
180
        raise NotImplementedError(self._add)
165
181
 
166
 
    @needs_tree_write_lock
167
182
    def apply_inventory_delta(self, changes):
168
183
        """Apply changes to the inventory as an atomic operation.
169
184
 
172
187
        :return None:
173
188
        :seealso Inventory.apply_delta: For details on the changes parameter.
174
189
        """
175
 
        self.flush()
176
 
        inv = self.inventory
177
 
        inv.apply_delta(changes)
178
 
        self._write_inventory(inv)
 
190
        raise NotImplementedError(self.apply_inventory_delta)
179
191
 
180
192
    @needs_write_lock
181
193
    def commit(self, message=None, revprops=None, *args,
182
194
               **kwargs):
183
195
        # avoid circular imports
184
196
        from bzrlib import commit
185
 
        if revprops is None:
186
 
            revprops = {}
187
197
        possible_master_transports=[]
188
 
        if not 'branch-nick' in revprops:
189
 
            revprops['branch-nick'] = self.branch._get_nick(
 
198
        revprops = commit.Commit.update_revprops(
 
199
                revprops,
 
200
                self.branch,
 
201
                kwargs.pop('authors', None),
 
202
                kwargs.pop('author', None),
190
203
                kwargs.get('local', False),
191
204
                possible_master_transports)
192
 
        authors = kwargs.pop('authors', None)
193
 
        author = kwargs.pop('author', None)
194
 
        if authors is not None:
195
 
            if author is not None:
196
 
                raise AssertionError('Specifying both author and authors '
197
 
                        'is not allowed. Specify just authors instead')
198
 
            if 'author' in revprops or 'authors' in revprops:
199
 
                # XXX: maybe we should just accept one of them?
200
 
                raise AssertionError('author property given twice')
201
 
            if authors:
202
 
                for individual in authors:
203
 
                    if '\n' in individual:
204
 
                        raise AssertionError('\\n is not a valid character '
205
 
                                'in an author identity')
206
 
                revprops['authors'] = '\n'.join(authors)
207
 
        if author is not None:
208
 
            symbol_versioning.warn('The parameter author was deprecated'
209
 
                   ' in version 1.13. Use authors instead',
210
 
                   DeprecationWarning)
211
 
            if 'author' in revprops or 'authors' in revprops:
212
 
                # XXX: maybe we should just accept one of them?
213
 
                raise AssertionError('author property given twice')
214
 
            if '\n' in author:
215
 
                raise AssertionError('\\n is not a valid character '
216
 
                        'in an author identity')
217
 
            revprops['authors'] = author
218
205
        # args for wt.commit start at message from the Commit.commit method,
219
206
        args = (message, ) + args
220
207
        for hook in MutableTree.hooks['start_commit']:
275
262
        :param more_warning: Details about what is happening.
276
263
        """
277
264
        if strict is None:
278
 
            strict = self.branch.get_config().get_user_option_as_bool(opt_name)
 
265
            strict = self.branch.get_config_stack().get(opt_name)
279
266
        if strict is not False:
280
267
            err_class = None
281
268
            if (self.has_changes()):
358
345
        :return: None
359
346
        """
360
347
 
361
 
    def _fix_case_of_inventory_path(self, path):
362
 
        """If our tree isn't case sensitive, return the canonical path"""
363
 
        if not self.case_sensitive:
364
 
            path = self.get_canonical_inventory_path(path)
365
 
        return path
366
 
 
367
348
    @needs_write_lock
368
349
    def put_file_bytes_non_atomic(self, file_id, bytes):
369
350
        """Update the content of a file in the tree.
393
374
        """
394
375
        raise NotImplementedError(self.set_parent_trees)
395
376
 
396
 
    @needs_tree_write_lock
397
377
    def smart_add(self, file_list, recurse=True, action=None, save=True):
398
378
        """Version file_list, optionally recursing into directories.
399
379
 
400
380
        This is designed more towards DWIM for humans than API clarity.
401
381
        For the specific behaviour see the help for cmd_add().
402
382
 
 
383
        :param file_list: List of zero or more paths.  *NB: these are 
 
384
            interpreted relative to the process cwd, not relative to the 
 
385
            tree.*  (Add and most other tree methods use tree-relative
 
386
            paths.)
403
387
        :param action: A reporter to be called with the inventory, parent_ie,
404
388
            path and kind of the path being added. It may return a file_id if
405
389
            a specific one should be used.
410
394
            of added files, and ignored_files is a dict mapping files that were
411
395
            ignored to the rule that caused them to be ignored.
412
396
        """
413
 
        # not in an inner loop; and we want to remove direct use of this,
414
 
        # so here as a reminder for now. RBC 20070703
415
 
        from bzrlib.inventory import InventoryEntry
416
 
        if action is None:
417
 
            action = add.AddAction()
418
 
 
419
 
        if not file_list:
420
 
            # no paths supplied: add the entire tree.
421
 
            # FIXME: this assumes we are running in a working tree subdir :-/
422
 
            # -- vila 20100208
423
 
            file_list = [u'.']
424
 
        # mutter("smart add of %r")
 
397
        raise NotImplementedError(self.smart_add)
 
398
 
 
399
 
 
400
class MutableInventoryTree(MutableTree, tree.InventoryTree):
 
401
 
 
402
    @needs_tree_write_lock
 
403
    def apply_inventory_delta(self, changes):
 
404
        """Apply changes to the inventory as an atomic operation.
 
405
 
 
406
        :param changes: An inventory delta to apply to the working tree's
 
407
            inventory.
 
408
        :return None:
 
409
        :seealso Inventory.apply_delta: For details on the changes parameter.
 
410
        """
 
411
        self.flush()
425
412
        inv = self.inventory
426
 
        added = []
427
 
        ignored = {}
428
 
        dirs_to_add = []
429
 
        user_dirs = set()
430
 
        conflicts_related = set()
 
413
        inv.apply_delta(changes)
 
414
        self._write_inventory(inv)
 
415
 
 
416
    def _fix_case_of_inventory_path(self, path):
 
417
        """If our tree isn't case sensitive, return the canonical path"""
 
418
        if not self.case_sensitive:
 
419
            path = self.get_canonical_inventory_path(path)
 
420
        return path
 
421
 
 
422
    @needs_tree_write_lock
 
423
    def smart_add(self, file_list, recurse=True, action=None, save=True):
 
424
        """Version file_list, optionally recursing into directories.
 
425
 
 
426
        This is designed more towards DWIM for humans than API clarity.
 
427
        For the specific behaviour see the help for cmd_add().
 
428
 
 
429
        :param file_list: List of zero or more paths.  *NB: these are 
 
430
            interpreted relative to the process cwd, not relative to the 
 
431
            tree.*  (Add and most other tree methods use tree-relative
 
432
            paths.)
 
433
        :param action: A reporter to be called with the inventory, parent_ie,
 
434
            path and kind of the path being added. It may return a file_id if
 
435
            a specific one should be used.
 
436
        :param save: Save the inventory after completing the adds. If False
 
437
            this provides dry-run functionality by doing the add and not saving
 
438
            the inventory.
 
439
        :return: A tuple - files_added, ignored_files. files_added is the count
 
440
            of added files, and ignored_files is a dict mapping files that were
 
441
            ignored to the rule that caused them to be ignored.
 
442
        """
431
443
        # Not all mutable trees can have conflicts
432
444
        if getattr(self, 'conflicts', None) is not None:
433
445
            # Collect all related files without checking whether they exist or
434
446
            # are versioned. It's cheaper to do that once for all conflicts
435
447
            # than trying to find the relevant conflict for each added file.
 
448
            conflicts_related = set()
436
449
            for c in self.conflicts():
437
450
                conflicts_related.update(c.associated_filenames())
438
 
 
439
 
        # validate user file paths and convert all paths to tree
440
 
        # relative : it's cheaper to make a tree relative path an abspath
441
 
        # than to convert an abspath to tree relative, and it's cheaper to
442
 
        # perform the canonicalization in bulk.
443
 
        for filepath in osutils.canonical_relpaths(self.basedir, file_list):
444
 
            rf = _FastPath(filepath)
445
 
            # validate user parameters. Our recursive code avoids adding new
446
 
            # files that need such validation
447
 
            if self.is_control_filename(rf.raw_path):
448
 
                raise errors.ForbiddenControlFileError(filename=rf.raw_path)
449
 
 
450
 
            abspath = self.abspath(rf.raw_path)
451
 
            kind = osutils.file_kind(abspath)
452
 
            if kind == 'directory':
453
 
                # schedule the dir for scanning
454
 
                user_dirs.add(rf)
455
 
            else:
456
 
                if not InventoryEntry.versionable_kind(kind):
457
 
                    raise errors.BadFileKindError(filename=abspath, kind=kind)
458
 
            # ensure the named path is added, so that ignore rules in the later
459
 
            # directory walk dont skip it.
460
 
            # we dont have a parent ie known yet.: use the relatively slower
461
 
            # inventory probing method
462
 
            versioned = inv.has_filename(rf.raw_path)
463
 
            if versioned:
464
 
                continue
465
 
            added.extend(_add_one_and_parent(self, inv, None, rf, kind, action))
466
 
 
467
 
        if not recurse:
468
 
            # no need to walk any directories at all.
469
 
            if len(added) > 0 and save:
470
 
                self._write_inventory(inv)
471
 
            return added, ignored
472
 
 
473
 
        # only walk the minimal parents needed: we have user_dirs to override
474
 
        # ignores.
475
 
        prev_dir = None
476
 
 
477
 
        is_inside = osutils.is_inside_or_parent_of_any
478
 
        for path in sorted(user_dirs):
479
 
            if (prev_dir is None or not is_inside([prev_dir], path.raw_path)):
480
 
                dirs_to_add.append((path, None))
481
 
            prev_dir = path.raw_path
482
 
 
483
 
        illegalpath_re = re.compile(r'[\r\n]')
484
 
        # dirs_to_add is initialised to a list of directories, but as we scan
485
 
        # directories we append files to it.
486
 
        # XXX: We should determine kind of files when we scan them rather than
487
 
        # adding to this list. RBC 20070703
488
 
        for directory, parent_ie in dirs_to_add:
489
 
            # directory is tree-relative
490
 
            abspath = self.abspath(directory.raw_path)
491
 
 
492
 
            # get the contents of this directory.
493
 
 
494
 
            # find the kind of the path being added.
495
 
            kind = osutils.file_kind(abspath)
496
 
 
497
 
            if not InventoryEntry.versionable_kind(kind):
498
 
                trace.warning("skipping %s (can't add file of kind '%s')",
499
 
                              abspath, kind)
500
 
                continue
501
 
            if illegalpath_re.search(directory.raw_path):
502
 
                trace.warning("skipping %r (contains \\n or \\r)" % abspath)
503
 
                continue
504
 
            if directory.raw_path in conflicts_related:
505
 
                # If the file looks like one generated for a conflict, don't
506
 
                # add it.
507
 
                trace.warning(
508
 
                    'skipping %s (generated to help resolve conflicts)',
509
 
                    abspath)
510
 
                continue
511
 
 
512
 
            if parent_ie is not None:
513
 
                versioned = directory.base_path in parent_ie.children
514
 
            else:
515
 
                # without the parent ie, use the relatively slower inventory
516
 
                # probing method
517
 
                versioned = inv.has_filename(
518
 
                        self._fix_case_of_inventory_path(directory.raw_path))
519
 
 
520
 
            if kind == 'directory':
521
 
                try:
522
 
                    sub_branch = bzrdir.BzrDir.open(abspath)
523
 
                    sub_tree = True
524
 
                except errors.NotBranchError:
525
 
                    sub_tree = False
526
 
                except errors.UnsupportedFormatError:
527
 
                    sub_tree = True
528
 
            else:
529
 
                sub_tree = False
530
 
 
531
 
            if directory.raw_path == '':
532
 
                # mutter("tree root doesn't need to be added")
533
 
                sub_tree = False
534
 
            elif versioned:
535
 
                pass
536
 
                # mutter("%r is already versioned", abspath)
537
 
            elif sub_tree:
538
 
                # XXX: This is wrong; people *might* reasonably be trying to
539
 
                # add subtrees as subtrees.  This should probably only be done
540
 
                # in formats which can represent subtrees, and even then
541
 
                # perhaps only when the user asked to add subtrees.  At the
542
 
                # moment you can add them specially through 'join --reference',
543
 
                # which is perhaps reasonable: adding a new reference is a
544
 
                # special operation and can have a special behaviour.  mbp
545
 
                # 20070306
546
 
                trace.mutter("%r is a nested bzr tree", abspath)
547
 
            else:
548
 
                _add_one(self, inv, parent_ie, directory, kind, action)
549
 
                added.append(directory.raw_path)
550
 
 
551
 
            if kind == 'directory' and not sub_tree:
552
 
                if parent_ie is not None:
553
 
                    # must be present:
554
 
                    this_ie = parent_ie.children[directory.base_path]
555
 
                else:
556
 
                    # without the parent ie, use the relatively slower inventory
557
 
                    # probing method
558
 
                    this_id = inv.path2id(
559
 
                        self._fix_case_of_inventory_path(directory.raw_path))
560
 
                    if this_id is None:
561
 
                        this_ie = None
562
 
                    else:
563
 
                        this_ie = inv[this_id]
564
 
 
565
 
                for subf in sorted(os.listdir(abspath)):
566
 
                    # here we could use TreeDirectory rather than
567
 
                    # string concatenation.
568
 
                    subp = osutils.pathjoin(directory.raw_path, subf)
569
 
                    # TODO: is_control_filename is very slow. Make it faster.
570
 
                    # TreeDirectory.is_control_filename could also make this
571
 
                    # faster - its impossible for a non root dir to have a
572
 
                    # control file.
573
 
                    if self.is_control_filename(subp):
574
 
                        trace.mutter("skip control directory %r", subp)
575
 
                    elif subf in this_ie.children:
576
 
                        # recurse into this already versioned subdir.
577
 
                        dirs_to_add.append((_FastPath(subp, subf), this_ie))
578
 
                    else:
579
 
                        # user selection overrides ignoes
580
 
                        # ignore while selecting files - if we globbed in the
581
 
                        # outer loop we would ignore user files.
582
 
                        ignore_glob = self.is_ignored(subp)
583
 
                        if ignore_glob is not None:
584
 
                            # mutter("skip ignored sub-file %r", subp)
585
 
                            ignored.setdefault(ignore_glob, []).append(subp)
586
 
                        else:
587
 
                            #mutter("queue to add sub-file %r", subp)
588
 
                            dirs_to_add.append((_FastPath(subp, subf), this_ie))
589
 
 
590
 
        if len(added) > 0:
591
 
            if save:
592
 
                self._write_inventory(inv)
593
 
            else:
594
 
                self.read_working_inventory()
595
 
        return added, ignored
 
451
        else:
 
452
            conflicts_related = None
 
453
        adder = _SmartAddHelper(self, action, conflicts_related)
 
454
        adder.add(file_list, recurse=recurse)
 
455
        if save:
 
456
            invdelta = adder.get_inventory_delta()
 
457
            self.apply_inventory_delta(invdelta)
 
458
        return adder.added, adder.ignored
596
459
 
597
460
    def update_basis_by_delta(self, new_revid, delta):
598
461
        """Update the parents of this tree after a commit.
630
493
        # TODO: Consider re-evaluating the need for this with CHKInventory
631
494
        # we don't strictly need to mutate an inventory for this
632
495
        # it only makes sense when apply_delta is cheaper than get_inventory()
633
 
        inventory = basis.inventory._get_mutable_inventory()
 
496
        inventory = _mod_inventory.mutable_inventory_from_tree(basis)
634
497
        basis.unlock()
635
498
        inventory.apply_delta(delta)
636
 
        rev_tree = revisiontree.RevisionTree(self.branch.repository,
 
499
        rev_tree = revisiontree.InventoryRevisionTree(self.branch.repository,
637
500
                                             inventory, new_revid)
638
501
        self.set_parent_trees([(new_revid, rev_tree)])
639
502
 
647
510
        """Create the default hooks.
648
511
 
649
512
        """
650
 
        hooks.Hooks.__init__(self)
651
 
        self.create_hook(hooks.HookPoint('start_commit',
 
513
        hooks.Hooks.__init__(self, "bzrlib.mutabletree", "MutableTree.hooks")
 
514
        self.add_hook('start_commit',
652
515
            "Called before a commit is performed on a tree. The start commit "
653
516
            "hook is able to change the tree before the commit takes place. "
654
517
            "start_commit is called with the bzrlib.mutabletree.MutableTree "
655
 
            "that the commit is being performed on.", (1, 4), None))
656
 
        self.create_hook(hooks.HookPoint('post_commit',
 
518
            "that the commit is being performed on.", (1, 4))
 
519
        self.add_hook('post_commit',
657
520
            "Called after a commit is performed on a tree. The hook is "
658
521
            "called with a bzrlib.mutabletree.PostCommitHookParams object. "
659
522
            "The mutable tree the commit was performed on is available via "
660
 
            "the mutable_tree attribute of that object.", (2, 0), None))
 
523
            "the mutable_tree attribute of that object.", (2, 0))
661
524
 
662
525
 
663
526
# install the default hooks into the MutableTree class.
677
540
        self.mutable_tree = mutable_tree
678
541
 
679
542
 
680
 
class _FastPath(object):
681
 
    """A path object with fast accessors for things like basename."""
682
 
 
683
 
    __slots__ = ['raw_path', 'base_path']
684
 
 
685
 
    def __init__(self, path, base_path=None):
686
 
        """Construct a FastPath from path."""
687
 
        if base_path is None:
688
 
            self.base_path = osutils.basename(path)
689
 
        else:
690
 
            self.base_path = base_path
691
 
        self.raw_path = path
692
 
 
693
 
    def __cmp__(self, other):
694
 
        return cmp(self.raw_path, other.raw_path)
695
 
 
696
 
    def __hash__(self):
697
 
        return hash(self.raw_path)
698
 
 
699
 
 
700
 
def _add_one_and_parent(tree, inv, parent_ie, path, kind, action):
701
 
    """Add a new entry to the inventory and automatically add unversioned parents.
702
 
 
703
 
    :param inv: Inventory which will receive the new entry.
704
 
    :param parent_ie: Parent inventory entry if known, or None.  If
705
 
        None, the parent is looked up by name and used if present, otherwise it
706
 
        is recursively added.
707
 
    :param kind: Kind of new entry (file, directory, etc)
708
 
    :param action: callback(inv, parent_ie, path, kind); return ignored.
709
 
    :return: A list of paths which have been added.
710
 
    """
711
 
    # Nothing to do if path is already versioned.
712
 
    # This is safe from infinite recursion because the tree root is
713
 
    # always versioned.
714
 
    if parent_ie is not None:
715
 
        # we have a parent ie already
716
 
        added = []
717
 
    else:
718
 
        # slower but does not need parent_ie
719
 
        if inv.has_filename(tree._fix_case_of_inventory_path(path.raw_path)):
720
 
            return []
721
 
        # its really not there : add the parent
722
 
        # note that the dirname use leads to some extra str copying etc but as
723
 
        # there are a limited number of dirs we can be nested under, it should
724
 
        # generally find it very fast and not recurse after that.
725
 
        added = _add_one_and_parent(tree, inv, None,
726
 
            _FastPath(osutils.dirname(path.raw_path)), 'directory', action)
727
 
        parent_id = inv.path2id(osutils.dirname(path.raw_path))
728
 
        parent_ie = inv[parent_id]
729
 
    _add_one(tree, inv, parent_ie, path, kind, action)
730
 
    return added + [path.raw_path]
731
 
 
732
 
 
733
 
def _add_one(tree, inv, parent_ie, path, kind, file_id_callback):
734
 
    """Add a new entry to the inventory.
735
 
 
736
 
    :param inv: Inventory which will receive the new entry.
737
 
    :param parent_ie: Parent inventory entry.
738
 
    :param kind: Kind of new entry (file, directory, etc)
739
 
    :param file_id_callback: callback(inv, parent_ie, path, kind); return a
740
 
        file_id or None to generate a new file id
741
 
    :returns: None
742
 
    """
743
 
    file_id = file_id_callback(inv, parent_ie, path, kind)
744
 
    entry = inv.make_entry(kind, path.base_path, parent_ie.file_id,
745
 
        file_id=file_id)
746
 
    inv.add(entry)
 
543
class _SmartAddHelper(object):
 
544
    """Helper for MutableTree.smart_add."""
 
545
 
 
546
    def get_inventory_delta(self):
 
547
        return self._invdelta.values()
 
548
 
 
549
    def _get_ie(self, inv_path):
 
550
        """Retrieve the most up to date inventory entry for a path.
 
551
 
 
552
        :param inv_path: Normalized inventory path
 
553
        :return: Inventory entry (with possibly invalid .children for
 
554
            directories)
 
555
        """
 
556
        entry = self._invdelta.get(inv_path)
 
557
        if entry is not None:
 
558
            return entry[3]
 
559
        # Find a 'best fit' match if the filesystem is case-insensitive
 
560
        inv_path = self.tree._fix_case_of_inventory_path(inv_path)
 
561
        file_id = self.tree.path2id(inv_path)
 
562
        if file_id is not None:
 
563
            return self.tree.iter_entries_by_dir([file_id]).next()[1]
 
564
        return None
 
565
 
 
566
    def _convert_to_directory(self, this_ie, inv_path):
 
567
        """Convert an entry to a directory.
 
568
 
 
569
        :param this_ie: Inventory entry
 
570
        :param inv_path: Normalized path for the inventory entry
 
571
        :return: The new inventory entry
 
572
        """
 
573
        # Same as in _add_one below, if the inventory doesn't
 
574
        # think this is a directory, update the inventory
 
575
        this_ie = _mod_inventory.InventoryDirectory(
 
576
            this_ie.file_id, this_ie.name, this_ie.parent_id)
 
577
        self._invdelta[inv_path] = (inv_path, inv_path, this_ie.file_id,
 
578
            this_ie)
 
579
        return this_ie
 
580
 
 
581
    def _add_one_and_parent(self, parent_ie, path, kind, inv_path):
 
582
        """Add a new entry to the inventory and automatically add unversioned parents.
 
583
 
 
584
        :param parent_ie: Parent inventory entry if known, or None.  If
 
585
            None, the parent is looked up by name and used if present, otherwise it
 
586
            is recursively added.
 
587
        :param path: 
 
588
        :param kind: Kind of new entry (file, directory, etc)
 
589
        :param inv_path:
 
590
        :return: Inventory entry for path and a list of paths which have been added.
 
591
        """
 
592
        # Nothing to do if path is already versioned.
 
593
        # This is safe from infinite recursion because the tree root is
 
594
        # always versioned.
 
595
        inv_dirname = osutils.dirname(inv_path)
 
596
        dirname, basename = osutils.split(path)
 
597
        if parent_ie is None:
 
598
            # slower but does not need parent_ie
 
599
            this_ie = self._get_ie(inv_path)
 
600
            if this_ie is not None:
 
601
                return this_ie
 
602
            # its really not there : add the parent
 
603
            # note that the dirname use leads to some extra str copying etc but as
 
604
            # there are a limited number of dirs we can be nested under, it should
 
605
            # generally find it very fast and not recurse after that.
 
606
            parent_ie = self._add_one_and_parent(None,
 
607
                dirname, 'directory', 
 
608
                inv_dirname)
 
609
        # if the parent exists, but isn't a directory, we have to do the
 
610
        # kind change now -- really the inventory shouldn't pretend to know
 
611
        # the kind of wt files, but it does.
 
612
        if parent_ie.kind != 'directory':
 
613
            # nb: this relies on someone else checking that the path we're using
 
614
            # doesn't contain symlinks.
 
615
            parent_ie = self._convert_to_directory(parent_ie, inv_dirname)
 
616
        file_id = self.action(self.tree.inventory, parent_ie, path, kind)
 
617
        entry = _mod_inventory.make_entry(kind, basename, parent_ie.file_id,
 
618
            file_id=file_id)
 
619
        self._invdelta[inv_path] = (None, inv_path, entry.file_id, entry)
 
620
        self.added.append(inv_path)
 
621
        return entry
 
622
 
 
623
    def _gather_dirs_to_add(self, user_dirs):
 
624
        # only walk the minimal parents needed: we have user_dirs to override
 
625
        # ignores.
 
626
        prev_dir = None
 
627
 
 
628
        is_inside = osutils.is_inside_or_parent_of_any
 
629
        for path, (inv_path, this_ie) in sorted(
 
630
                user_dirs.iteritems(), key=operator.itemgetter(0)):
 
631
            if (prev_dir is None or not is_inside([prev_dir], path)):
 
632
                yield (path, inv_path, this_ie, None)
 
633
            prev_dir = path
 
634
        
 
635
    def __init__(self, tree, action, conflicts_related=None):
 
636
        self.tree = tree
 
637
        if action is None:
 
638
            self.action = add.AddAction()
 
639
        else:
 
640
            self.action = action
 
641
        self._invdelta = {}
 
642
        self.added = []
 
643
        self.ignored = {}
 
644
        if conflicts_related is None:
 
645
            self.conflicts_related = frozenset()
 
646
        else:
 
647
            self.conflicts_related = conflicts_related
 
648
 
 
649
    def add(self, file_list, recurse=True):
 
650
        from bzrlib.inventory import InventoryEntry
 
651
        if not file_list:
 
652
            # no paths supplied: add the entire tree.
 
653
            # FIXME: this assumes we are running in a working tree subdir :-/
 
654
            # -- vila 20100208
 
655
            file_list = [u'.']
 
656
 
 
657
        # expand any symlinks in the directory part, while leaving the
 
658
        # filename alone
 
659
        # only expanding if symlinks are supported avoids windows path bugs
 
660
        if osutils.has_symlinks():
 
661
            file_list = map(osutils.normalizepath, file_list)
 
662
 
 
663
        user_dirs = {}
 
664
        # validate user file paths and convert all paths to tree
 
665
        # relative : it's cheaper to make a tree relative path an abspath
 
666
        # than to convert an abspath to tree relative, and it's cheaper to
 
667
        # perform the canonicalization in bulk.
 
668
        for filepath in osutils.canonical_relpaths(self.tree.basedir, file_list):
 
669
            # validate user parameters. Our recursive code avoids adding new
 
670
            # files that need such validation
 
671
            if self.tree.is_control_filename(filepath):
 
672
                raise errors.ForbiddenControlFileError(filename=filepath)
 
673
 
 
674
            abspath = self.tree.abspath(filepath)
 
675
            kind = osutils.file_kind(abspath)
 
676
            # ensure the named path is added, so that ignore rules in the later
 
677
            # directory walk dont skip it.
 
678
            # we dont have a parent ie known yet.: use the relatively slower
 
679
            # inventory probing method
 
680
            inv_path, _ = osutils.normalized_filename(filepath)
 
681
            this_ie = self._get_ie(inv_path)
 
682
            if this_ie is None:
 
683
                this_ie = self._add_one_and_parent(None, filepath, kind, inv_path)
 
684
            if kind == 'directory':
 
685
                # schedule the dir for scanning
 
686
                user_dirs[filepath] = (inv_path, this_ie)
 
687
 
 
688
        if not recurse:
 
689
            # no need to walk any directories at all.
 
690
            return
 
691
 
 
692
        things_to_add = list(self._gather_dirs_to_add(user_dirs))
 
693
 
 
694
        illegalpath_re = re.compile(r'[\r\n]')
 
695
        for directory, inv_path, this_ie, parent_ie in things_to_add:
 
696
            # directory is tree-relative
 
697
            abspath = self.tree.abspath(directory)
 
698
 
 
699
            # get the contents of this directory.
 
700
 
 
701
            # find the kind of the path being added, and save stat_value
 
702
            # for reuse
 
703
            stat_value = None
 
704
            if this_ie is None:
 
705
                stat_value = osutils.file_stat(abspath)
 
706
                kind = osutils.file_kind_from_stat_mode(stat_value.st_mode)
 
707
            else:
 
708
                kind = this_ie.kind
 
709
            
 
710
            # allow AddAction to skip this file
 
711
            if self.action.skip_file(self.tree,  abspath,  kind,  stat_value):
 
712
                continue
 
713
            if not InventoryEntry.versionable_kind(kind):
 
714
                trace.warning("skipping %s (can't add file of kind '%s')",
 
715
                              abspath, kind)
 
716
                continue
 
717
            if illegalpath_re.search(directory):
 
718
                trace.warning("skipping %r (contains \\n or \\r)" % abspath)
 
719
                continue
 
720
            if directory in self.conflicts_related:
 
721
                # If the file looks like one generated for a conflict, don't
 
722
                # add it.
 
723
                trace.warning(
 
724
                    'skipping %s (generated to help resolve conflicts)',
 
725
                    abspath)
 
726
                continue
 
727
 
 
728
            if kind == 'directory' and directory != '':
 
729
                try:
 
730
                    transport = _mod_transport.get_transport_from_path(abspath)
 
731
                    controldir.ControlDirFormat.find_format(transport)
 
732
                    sub_tree = True
 
733
                except errors.NotBranchError:
 
734
                    sub_tree = False
 
735
                except errors.UnsupportedFormatError:
 
736
                    sub_tree = True
 
737
            else:
 
738
                sub_tree = False
 
739
 
 
740
            if this_ie is not None:
 
741
                pass
 
742
            elif sub_tree:
 
743
                # XXX: This is wrong; people *might* reasonably be trying to
 
744
                # add subtrees as subtrees.  This should probably only be done
 
745
                # in formats which can represent subtrees, and even then
 
746
                # perhaps only when the user asked to add subtrees.  At the
 
747
                # moment you can add them specially through 'join --reference',
 
748
                # which is perhaps reasonable: adding a new reference is a
 
749
                # special operation and can have a special behaviour.  mbp
 
750
                # 20070306
 
751
                trace.warning("skipping nested tree %r", abspath)
 
752
            else:
 
753
                this_ie = self._add_one_and_parent(parent_ie, directory, kind,
 
754
                    inv_path)
 
755
 
 
756
            if kind == 'directory' and not sub_tree:
 
757
                if this_ie.kind != 'directory':
 
758
                    this_ie = self._convert_to_directory(this_ie, inv_path)
 
759
 
 
760
                for subf in sorted(os.listdir(abspath)):
 
761
                    inv_f, _ = osutils.normalized_filename(subf)
 
762
                    # here we could use TreeDirectory rather than
 
763
                    # string concatenation.
 
764
                    subp = osutils.pathjoin(directory, subf)
 
765
                    # TODO: is_control_filename is very slow. Make it faster.
 
766
                    # TreeDirectory.is_control_filename could also make this
 
767
                    # faster - its impossible for a non root dir to have a
 
768
                    # control file.
 
769
                    if self.tree.is_control_filename(subp):
 
770
                        trace.mutter("skip control directory %r", subp)
 
771
                        continue
 
772
                    sub_invp = osutils.pathjoin(inv_path, inv_f)
 
773
                    entry = self._invdelta.get(sub_invp)
 
774
                    if entry is not None:
 
775
                        sub_ie = entry[3]
 
776
                    else:
 
777
                        sub_ie = this_ie.children.get(inv_f)
 
778
                    if sub_ie is not None:
 
779
                        # recurse into this already versioned subdir.
 
780
                        things_to_add.append((subp, sub_invp, sub_ie, this_ie))
 
781
                    else:
 
782
                        # user selection overrides ignores
 
783
                        # ignore while selecting files - if we globbed in the
 
784
                        # outer loop we would ignore user files.
 
785
                        ignore_glob = self.tree.is_ignored(subp)
 
786
                        if ignore_glob is not None:
 
787
                            self.ignored.setdefault(ignore_glob, []).append(subp)
 
788
                        else:
 
789
                            things_to_add.append((subp, sub_invp, None, this_ie))