~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/add.py

  • Committer: Aaron Bentley
  • Date: 2006-07-11 15:04:57 UTC
  • mto: This revision was merged to the branch mainline in revision 1858.
  • Revision ID: abentley@panoramicfeedback.com-20060711150457-d4c96e9c60843973
Ensure commit respects file spec when committing removals

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2005, 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
16
 
 
17
 
"""Helper functions for adding files to working trees."""
18
 
 
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
 
17
import errno
 
18
import os
 
19
from os.path import dirname
19
20
import sys
20
21
 
21
 
from bzrlib import (
22
 
    osutils,
23
 
    )
 
22
import bzrlib.errors as errors
 
23
from bzrlib.inventory import InventoryEntry
 
24
from bzrlib.trace import mutter, note, warning
 
25
from bzrlib.errors import NotBranchError
 
26
import bzrlib.osutils
 
27
from bzrlib.workingtree import WorkingTree
 
28
 
 
29
 
 
30
def glob_expand_for_win32(file_list):
 
31
    if not file_list:
 
32
        return
 
33
    import glob
 
34
    expanded_file_list = []
 
35
    for possible_glob in file_list:
 
36
        glob_files = glob.glob(possible_glob)
 
37
       
 
38
        if glob_files == []:
 
39
            # special case to let the normal code path handle
 
40
            # files that do not exists
 
41
            expanded_file_list.append(possible_glob)
 
42
        else:
 
43
            expanded_file_list += glob_files
 
44
    return expanded_file_list
 
45
 
 
46
 
 
47
def _prepare_file_list(file_list):
 
48
    """Prepare a file list for use by smart_add_*."""
 
49
    if sys.platform == 'win32':
 
50
        file_list = glob_expand_for_win32(file_list)
 
51
    if not file_list:
 
52
        file_list = [u'.']
 
53
    file_list = list(file_list)
 
54
    return file_list
24
55
 
25
56
 
26
57
class AddAction(object):
27
58
    """A class which defines what action to take when adding a file."""
28
59
 
29
60
    def __init__(self, to_file=None, should_print=None):
30
 
        """Initialize an action which prints added files to an output stream.
31
 
 
32
 
        :param to_file: The stream to write into. This is expected to take
33
 
            Unicode paths. If not supplied, it will default to ``sys.stdout``.
34
 
        :param should_print: If False, printing will be suppressed.
35
 
        """
36
61
        self._to_file = to_file
37
62
        if to_file is None:
38
63
            self._to_file = sys.stdout
40
65
        if should_print is not None:
41
66
            self.should_print = should_print
42
67
 
43
 
    def __call__(self, inv, parent_ie, path, kind, _quote=osutils.quotefn):
 
68
    def __call__(self, inv, parent_ie, path, kind, _quote=bzrlib.osutils.quotefn):
44
69
        """Add path to inventory.
45
70
 
46
71
        The default action does nothing.
49
74
        :param path: The FastPath being added
50
75
        :param kind: The kind of the object being added.
51
76
        """
52
 
        if self.should_print:
53
 
            self._to_file.write('adding %s\n' % _quote(path))
54
 
        return None
55
 
 
56
 
 
57
 
class AddFromBaseAction(AddAction):
58
 
    """This class will try to extract file ids from another tree."""
59
 
 
60
 
    def __init__(self, base_tree, base_path, to_file=None, should_print=None):
61
 
        super(AddFromBaseAction, self).__init__(to_file=to_file,
62
 
                                                should_print=should_print)
63
 
        self.base_tree = base_tree
64
 
        self.base_path = base_path
65
 
 
66
 
    def __call__(self, inv, parent_ie, path, kind):
67
 
        # Place the parent call
68
 
        # Now check to see if we can extract an id for this file
69
 
        file_id, base_path = self._get_base_file_id(path, parent_ie)
70
 
        if file_id is not None:
71
 
            if self.should_print:
72
 
                self._to_file.write('adding %s w/ file id from %s\n'
73
 
                                    % (path, base_path))
74
 
        else:
75
 
            # we aren't doing anything special, so let the default
76
 
            # reporter happen
77
 
            file_id = super(AddFromBaseAction, self).__call__(
78
 
                        inv, parent_ie, path, kind)
79
 
        return file_id
80
 
 
81
 
    def _get_base_file_id(self, path, parent_ie):
82
 
        """Look for a file id in the base branch.
83
 
 
84
 
        First, if the base tree has the parent directory,
85
 
        we look for a file with the same name in that directory.
86
 
        Else, we look for an entry in the base tree with the same path.
87
 
        """
88
 
 
89
 
        if self.base_tree.has_id(parent_ie.file_id):
90
 
            base_parent_ie = self.base_tree.inventory[parent_ie.file_id]
91
 
            base_child_ie = base_parent_ie.children.get(
92
 
                osutils.basename(path))
93
 
            if base_child_ie is not None:
94
 
                return (base_child_ie.file_id,
95
 
                        self.base_tree.id2path(base_child_ie.file_id))
96
 
        full_base_path = osutils.pathjoin(self.base_path, path)
97
 
        # This may return None, but it is our last attempt
98
 
        return self.base_tree.path2id(full_base_path), full_base_path
 
77
        if not self.should_print:
 
78
            return
 
79
        self._to_file.write('added %s\n' % _quote(path.raw_path))
 
80
 
 
81
 
 
82
# TODO: jam 20050105 These could be used for compatibility
 
83
#       however, they bind against the current stdout, not the
 
84
#       one which exists at the time they are called, so they
 
85
#       don't work for the test suite.
 
86
# deprecated
 
87
add_action_add = AddAction()
 
88
add_action_null = add_action_add
 
89
add_action_add_and_print = AddAction(should_print=True)
 
90
add_action_print = add_action_add_and_print
 
91
 
 
92
 
 
93
def smart_add(file_list, recurse=True, action=None, save=True):
 
94
    """Add files to version, optionally recursing into directories.
 
95
 
 
96
    This is designed more towards DWIM for humans than API simplicity.
 
97
    For the specific behaviour see the help for cmd_add().
 
98
 
 
99
    Returns the number of files added.
 
100
    Please see smart_add_tree for more detail.
 
101
    """
 
102
    file_list = _prepare_file_list(file_list)
 
103
    tree = WorkingTree.open_containing(file_list[0])[0]
 
104
    return smart_add_tree(tree, file_list, recurse, action=action)
 
105
 
 
106
 
 
107
class FastPath(object):
 
108
    """A path object with fast accessors for things like basename."""
 
109
 
 
110
    __slots__ = ['raw_path', 'base_path']
 
111
 
 
112
    def __init__(self, path, base_path=None):
 
113
        """Construct a FastPath from path."""
 
114
        if base_path is None:
 
115
            self.base_path = bzrlib.osutils.basename(path)
 
116
        else:
 
117
            self.base_path = base_path
 
118
        self.raw_path = path
 
119
 
 
120
 
 
121
def smart_add_tree(tree, file_list, recurse=True, action=None, save=True):
 
122
    """Add files to version, optionally recursing into directories.
 
123
 
 
124
    This is designed more towards DWIM for humans than API simplicity.
 
125
    For the specific behaviour see the help for cmd_add().
 
126
 
 
127
    This calls reporter with each (path, kind, file_id) of added files.
 
128
 
 
129
    Returns the number of files added.
 
130
    
 
131
    :param save: Save the inventory after completing the adds. If False this
 
132
    provides dry-run functionality by doing the add and not saving the
 
133
    inventory.  Note that the modified inventory is left in place, allowing 
 
134
    further dry-run tasks to take place. To restore the original inventory
 
135
    call tree.read_working_inventory().
 
136
    """
 
137
    assert isinstance(recurse, bool)
 
138
    if action is None:
 
139
        action = AddAction()
 
140
    
 
141
    prepared_list = _prepare_file_list(file_list)
 
142
    mutter("smart add of %r, originally %r", prepared_list, file_list)
 
143
    inv = tree.read_working_inventory()
 
144
    added = []
 
145
    ignored = {}
 
146
    dirs_to_add = []
 
147
    user_dirs = set()
 
148
 
 
149
    # validate user file paths and convert all paths to tree 
 
150
    # relative : its cheaper to make a tree relative path an abspath
 
151
    # than to convert an abspath to tree relative.
 
152
    for filepath in prepared_list:
 
153
        rf = FastPath(tree.relpath(filepath))
 
154
        # validate user parameters. Our recursive code avoids adding new files
 
155
        # that need such validation 
 
156
        if tree.is_control_filename(rf.raw_path):
 
157
            raise errors.ForbiddenControlFileError(filename=rf)
 
158
        
 
159
        abspath = tree.abspath(rf.raw_path)
 
160
        kind = bzrlib.osutils.file_kind(abspath)
 
161
        if kind == 'directory':
 
162
            # schedule the dir for scanning
 
163
            user_dirs.add(rf.raw_path)
 
164
        else:
 
165
            if not InventoryEntry.versionable_kind(kind):
 
166
                raise errors.BadFileKindError(filename=abspath, kind=kind)
 
167
        # ensure the named path is added, so that ignore rules in the later directory
 
168
        # walk dont skip it.
 
169
        # we dont have a parent ie known yet.: use the relatively slower inventory 
 
170
        # probing method
 
171
        versioned = inv.has_filename(rf.raw_path)
 
172
        if versioned:
 
173
            continue
 
174
        added.extend(__add_one_and_parent(tree, inv, None, rf, kind, action))
 
175
 
 
176
    if not recurse:
 
177
        # no need to walk any directories at all.
 
178
        if len(added) > 0 and save:
 
179
            tree._write_inventory(inv)
 
180
        return added, ignored
 
181
 
 
182
    # only walk the minimal parents needed: we have user_dirs to override
 
183
    # ignores.
 
184
    prev_dir = None
 
185
    for path in sorted(user_dirs):
 
186
        if (prev_dir is None or not
 
187
            bzrlib.osutils.is_inside_or_parent_of_any([prev_dir], path)):
 
188
            dirs_to_add.append((rf, None))
 
189
        prev_dir = path
 
190
 
 
191
    # this will eventually be *just* directories, right now it starts off with 
 
192
    # just directories.
 
193
    for directory, parent_ie in dirs_to_add:
 
194
        # directory is tree-relative
 
195
        abspath = tree.abspath(directory.raw_path)
 
196
 
 
197
        # get the contents of this directory.
 
198
 
 
199
        # find the kind of the path being added.
 
200
        kind = bzrlib.osutils.file_kind(abspath)
 
201
 
 
202
        if not InventoryEntry.versionable_kind(kind):
 
203
            warning("skipping %s (can't add file of kind '%s')", abspath, kind)
 
204
            continue
 
205
 
 
206
        if parent_ie is not None:
 
207
            versioned = directory.base_path in parent_ie.children
 
208
        else:
 
209
            # without the parent ie, use the relatively slower inventory 
 
210
            # probing method
 
211
            versioned = inv.has_filename(directory.raw_path)
 
212
 
 
213
        if kind == 'directory':
 
214
            try:
 
215
                sub_branch = bzrlib.bzrdir.BzrDir.open(abspath)
 
216
                sub_tree = True
 
217
            except NotBranchError:
 
218
                sub_tree = False
 
219
            except errors.UnsupportedFormatError:
 
220
                sub_tree = True
 
221
        else:
 
222
            sub_tree = False
 
223
 
 
224
        if directory.raw_path == '':
 
225
            # mutter("tree root doesn't need to be added")
 
226
            sub_tree = False
 
227
        elif versioned:
 
228
            pass
 
229
            # mutter("%r is already versioned", abspath)
 
230
        elif sub_tree:
 
231
            mutter("%r is a nested bzr tree", abspath)
 
232
        else:
 
233
            __add_one(tree, inv, parent_ie, directory, kind, action)
 
234
            added.append(directory.raw_path)
 
235
 
 
236
        if kind == 'directory' and not sub_tree:
 
237
            if parent_ie is not None:
 
238
                # must be present:
 
239
                this_ie = parent_ie.children[directory.base_path]
 
240
            else:
 
241
                # without the parent ie, use the relatively slower inventory 
 
242
                # probing method
 
243
                this_id = inv.path2id(directory.raw_path)
 
244
                if this_id is None:
 
245
                    this_ie = None
 
246
                else:
 
247
                    this_ie = inv[this_id]
 
248
 
 
249
            for subf in os.listdir(abspath):
 
250
                # here we could use TreeDirectory rather than 
 
251
                # string concatenation.
 
252
                subp = bzrlib.osutils.pathjoin(directory.raw_path, subf)
 
253
                # TODO: is_control_filename is very slow. Make it faster. 
 
254
                # TreeDirectory.is_control_filename could also make this 
 
255
                # faster - its impossible for a non root dir to have a 
 
256
                # control file.
 
257
                if tree.is_control_filename(subp):
 
258
                    mutter("skip control directory %r", subp)
 
259
                elif subf in this_ie.children:
 
260
                    # recurse into this already versioned subdir.
 
261
                    dirs_to_add.append((FastPath(subp, subf), this_ie))
 
262
                else:
 
263
                    # user selection overrides ignoes
 
264
                    # ignore while selecting files - if we globbed in the
 
265
                    # outer loop we would ignore user files.
 
266
                    ignore_glob = tree.is_ignored(subp)
 
267
                    if ignore_glob is not None:
 
268
                        # mutter("skip ignored sub-file %r", subp)
 
269
                        if ignore_glob not in ignored:
 
270
                            ignored[ignore_glob] = []
 
271
                        ignored[ignore_glob].append(subp)
 
272
                    else:
 
273
                        #mutter("queue to add sub-file %r", subp)
 
274
                        dirs_to_add.append((FastPath(subp, subf), this_ie))
 
275
 
 
276
    if len(added) > 0 and save:
 
277
        tree._write_inventory(inv)
 
278
    return added, ignored
 
279
 
 
280
 
 
281
def __add_one_and_parent(tree, inv, parent_ie, path, kind, action):
 
282
    """Add a new entry to the inventory and automatically add unversioned parents.
 
283
 
 
284
    :param inv: Inventory which will receive the new entry.
 
285
    :param parent_ie: Parent inventory entry if known, or None.  If
 
286
    None, the parent is looked up by name and used if present, otherwise
 
287
    it is recursively added.
 
288
    :param kind: Kind of new entry (file, directory, etc)
 
289
    :param action: callback(inv, parent_ie, path, kind); return ignored.
 
290
    :returns: A list of paths which have been added.
 
291
    """
 
292
    # Nothing to do if path is already versioned.
 
293
    # This is safe from infinite recursion because the tree root is
 
294
    # always versioned.
 
295
    if parent_ie is not None:
 
296
        # we have a parent ie already
 
297
        added = []
 
298
    else:
 
299
        # slower but does not need parent_ie
 
300
        if inv.has_filename(path.raw_path):
 
301
            return []
 
302
        # its really not there : add the parent
 
303
        # note that the dirname use leads to some extra str copying etc but as
 
304
        # there are a limited number of dirs we can be nested under, it should
 
305
        # generally find it very fast and not recurse after that.
 
306
        added = __add_one_and_parent(tree, inv, None, FastPath(dirname(path.raw_path)), 'directory', action)
 
307
        parent_id = inv.path2id(dirname(path.raw_path))
 
308
        parent_ie = inv[parent_id]
 
309
    __add_one(tree, inv, parent_ie, path, kind, action)
 
310
    return added + [path.raw_path]
 
311
 
 
312
 
 
313
def __add_one(tree, inv, parent_ie, path, kind, action):
 
314
    """Add a new entry to the inventory.
 
315
 
 
316
    :param inv: Inventory which will receive the new entry.
 
317
    :param parent_ie: Parent inventory entry.
 
318
    :param kind: Kind of new entry (file, directory, etc)
 
319
    :param action: callback(inv, parent_ie, path, kind); return ignored.
 
320
    :returns: None
 
321
    """
 
322
    action(inv, parent_ie, path, kind)
 
323
    entry = bzrlib.inventory.make_entry(kind, path.base_path, parent_ie.file_id)
 
324
    inv.add(entry)