~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/ignores.py

  • Committer: mbp at sourcefrog
  • Date: 2005-03-28 02:24:18 UTC
  • Revision ID: mbp@sourcefrog.net-20050328022418-9d37f56361aa18e9
doc: more on ignore patterns

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2005, 2006 Canonical Ltd
2
 
#
3
 
# This program is free software; you can redistribute it and/or modify
4
 
# it under the terms of the GNU General Public License as published by
5
 
# the Free Software Foundation; either version 2 of the License, or
6
 
# (at your option) any later version.
7
 
#
8
 
# This program is distributed in the hope that it will be useful,
9
 
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
 
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11
 
# GNU General Public License for more details.
12
 
#
13
 
# You should have received a copy of the GNU General Public License
14
 
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
 
 
17
 
"""Lists of ignore files, etc."""
18
 
 
19
 
import errno
20
 
 
21
 
from bzrlib import config
22
 
 
23
 
# This was the full ignore list for bzr 0.8
24
 
# please keep these sorted (in C locale order) to aid merging
25
 
OLD_DEFAULTS = [
26
 
    '#*#',
27
 
    '*$',
28
 
    '*,v',
29
 
    '*.BAK',
30
 
    '*.a',
31
 
    '*.bak',
32
 
    '*.elc',
33
 
    '*.exe',
34
 
    '*.la',
35
 
    '*.lo',
36
 
    '*.o',
37
 
    '*.obj',
38
 
    '*.orig',
39
 
    '*.py[oc]',
40
 
    '*.so',
41
 
    '*.tmp',
42
 
    '*~',
43
 
    '.#*',
44
 
    '.*.sw[nop]',
45
 
    '.*.tmp',
46
 
    # Our setup tests dump .python-eggs in the bzr source tree root
47
 
    './.python-eggs',
48
 
    '.DS_Store',
49
 
    '.arch-ids',
50
 
    '.arch-inventory',
51
 
    '.bzr.log',
52
 
    '.del-*',
53
 
    '.git',
54
 
    '.hg',
55
 
    '.jamdeps'
56
 
    '.libs',
57
 
    '.make.state',
58
 
    '.sconsign*',
59
 
    '.svn',
60
 
    '.sw[nop]',    # vim editing nameless file
61
 
    '.tmp*',
62
 
    'BitKeeper',
63
 
    'CVS',
64
 
    'CVS.adm',
65
 
    'RCS',
66
 
    'SCCS',
67
 
    'TAGS',
68
 
    '_darcs',
69
 
    'aclocal.m4',
70
 
    'autom4te*',
71
 
    'config.h',
72
 
    'config.h.in',
73
 
    'config.log',
74
 
    'config.status',
75
 
    'config.sub',
76
 
    'stamp-h',
77
 
    'stamp-h.in',
78
 
    'stamp-h1',
79
 
    '{arch}',
80
 
]
81
 
 
82
 
 
83
 
# ~/.bazaar/ignore will be filled out using
84
 
# this ignore list, if it does not exist
85
 
# please keep these sorted (in C locale order) to aid merging
86
 
USER_DEFAULTS = [
87
 
    '*.a',
88
 
    '*.o',
89
 
    '*.py[co]',
90
 
    '*.so',
91
 
    '*.sw[nop]',
92
 
    '*~',
93
 
    '.#*',
94
 
    '[#]*#',
95
 
]
96
 
 
97
 
 
98
 
def parse_ignore_file(f):
99
 
    """Read in all of the lines in the file and turn it into an ignore list"""
100
 
    ignored = set()
101
 
    for line in f.read().decode('utf8').split('\n'):
102
 
        line = line.rstrip('/\r\n')
103
 
        if not line or line.startswith('#'):
104
 
            continue
105
 
        ignored.add(line)
106
 
    return ignored
107
 
 
108
 
 
109
 
def get_user_ignores():
110
 
    """Get the list of user ignored files, possibly creating it."""
111
 
    path = config.user_ignore_config_filename()
112
 
    patterns = set(USER_DEFAULTS)
113
 
    try:
114
 
        f = open(path, 'rb')
115
 
    except (IOError, OSError), e:
116
 
        # open() shouldn't return an IOError without errno, but just in case
117
 
        err = getattr(e, 'errno', None)
118
 
        if err not in (errno.ENOENT,):
119
 
            raise
120
 
        # Create the ignore file, and just return the default
121
 
        # We want to ignore if we can't write to the file
122
 
        # since get_* should be a safe operation
123
 
        try:
124
 
            _set_user_ignores(USER_DEFAULTS)
125
 
        except (IOError, OSError), e:
126
 
            if e.errno not in (errno.EPERM,):
127
 
                raise
128
 
        return patterns
129
 
 
130
 
    try:
131
 
        return parse_ignore_file(f)
132
 
    finally:
133
 
        f.close()
134
 
 
135
 
 
136
 
def _set_user_ignores(patterns):
137
 
    """Fill out the user ignore file with the given patterns
138
 
 
139
 
    This may raise an error if it doesn't have permission to
140
 
    write to the user ignore file.
141
 
    This is mostly used for testing, since it would be
142
 
    bad form to rewrite a user's ignore list.
143
 
    bzrlib only writes this file if it does not exist.
144
 
    """
145
 
    ignore_path = config.user_ignore_config_filename()
146
 
    config.ensure_config_dir_exists()
147
 
 
148
 
    # Create an empty file
149
 
    f = open(ignore_path, 'wb')
150
 
    try:
151
 
        for pattern in patterns:
152
 
            f.write(pattern.encode('utf8') + '\n')
153
 
    finally:
154
 
        f.close()
155
 
 
156
 
 
157
 
def add_unique_user_ignores(new_ignores):
158
 
    """Add entries to the user's ignore list if not present.
159
 
 
160
 
    :param new_ignores: A list of ignore patterns
161
 
    :return: The list of ignores that were added
162
 
    """
163
 
    ignored = get_user_ignores()
164
 
    to_add = []
165
 
    for ignore in new_ignores:
166
 
        ignore = ignore.rstrip('/')
167
 
        if ignore not in ignored:
168
 
            ignored.add(ignore)
169
 
            to_add.append(ignore)
170
 
 
171
 
    if not to_add:
172
 
        return []
173
 
 
174
 
    f = open(config.user_ignore_config_filename(), 'ab')
175
 
    try:
176
 
        for pattern in to_add:
177
 
            f.write(pattern.encode('utf8') + '\n')
178
 
    finally:
179
 
        f.close()
180
 
 
181
 
    return to_add
182
 
 
183
 
 
184
 
_runtime_ignores = set()
185
 
 
186
 
 
187
 
def add_runtime_ignores(ignores):
188
 
    """Add some ignore patterns that only exists in memory.
189
 
 
190
 
    This is used by some plugins that want bzr to ignore files,
191
 
    but don't want to change a users ignore list.
192
 
    (Such as a conversion script that needs to ignore temporary files,
193
 
    but does not want to modify the project's ignore list.)
194
 
 
195
 
    :param ignores: A list or generator of ignore patterns.
196
 
    :return: None
197
 
    """
198
 
    global _runtime_ignores
199
 
    _runtime_ignores.update(set(ignores))
200
 
 
201
 
 
202
 
def get_runtime_ignores():
203
 
    """Get the current set of runtime ignores."""
204
 
    return _runtime_ignores