rake 13.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (75) hide show
  1. checksums.yaml +7 -0
  2. data/.github/workflows/macos.yml +22 -0
  3. data/.github/workflows/ubuntu-rvm.yml +28 -0
  4. data/.github/workflows/ubuntu.yml +20 -0
  5. data/.github/workflows/windows.yml +20 -0
  6. data/CONTRIBUTING.rdoc +43 -0
  7. data/Gemfile +10 -0
  8. data/History.rdoc +2359 -0
  9. data/MIT-LICENSE +21 -0
  10. data/README.rdoc +155 -0
  11. data/Rakefile +41 -0
  12. data/bin/bundle +105 -0
  13. data/bin/console +7 -0
  14. data/bin/rake +29 -0
  15. data/bin/rdoc +29 -0
  16. data/bin/rubocop +29 -0
  17. data/bin/setup +6 -0
  18. data/doc/command_line_usage.rdoc +158 -0
  19. data/doc/example/Rakefile1 +38 -0
  20. data/doc/example/Rakefile2 +35 -0
  21. data/doc/example/a.c +6 -0
  22. data/doc/example/b.c +6 -0
  23. data/doc/example/main.c +11 -0
  24. data/doc/glossary.rdoc +42 -0
  25. data/doc/jamis.rb +592 -0
  26. data/doc/proto_rake.rdoc +127 -0
  27. data/doc/rake.1 +156 -0
  28. data/doc/rakefile.rdoc +622 -0
  29. data/doc/rational.rdoc +151 -0
  30. data/exe/rake +27 -0
  31. data/lib/rake.rb +71 -0
  32. data/lib/rake/application.rb +824 -0
  33. data/lib/rake/backtrace.rb +24 -0
  34. data/lib/rake/clean.rb +78 -0
  35. data/lib/rake/cloneable.rb +17 -0
  36. data/lib/rake/cpu_counter.rb +107 -0
  37. data/lib/rake/default_loader.rb +15 -0
  38. data/lib/rake/dsl_definition.rb +195 -0
  39. data/lib/rake/early_time.rb +22 -0
  40. data/lib/rake/ext/core.rb +26 -0
  41. data/lib/rake/ext/string.rb +176 -0
  42. data/lib/rake/file_creation_task.rb +25 -0
  43. data/lib/rake/file_list.rb +435 -0
  44. data/lib/rake/file_task.rb +54 -0
  45. data/lib/rake/file_utils.rb +134 -0
  46. data/lib/rake/file_utils_ext.rb +134 -0
  47. data/lib/rake/invocation_chain.rb +57 -0
  48. data/lib/rake/invocation_exception_mixin.rb +17 -0
  49. data/lib/rake/late_time.rb +18 -0
  50. data/lib/rake/linked_list.rb +112 -0
  51. data/lib/rake/loaders/makefile.rb +54 -0
  52. data/lib/rake/multi_task.rb +14 -0
  53. data/lib/rake/name_space.rb +38 -0
  54. data/lib/rake/packagetask.rb +222 -0
  55. data/lib/rake/phony.rb +16 -0
  56. data/lib/rake/private_reader.rb +21 -0
  57. data/lib/rake/promise.rb +100 -0
  58. data/lib/rake/pseudo_status.rb +30 -0
  59. data/lib/rake/rake_module.rb +67 -0
  60. data/lib/rake/rake_test_loader.rb +27 -0
  61. data/lib/rake/rule_recursion_overflow_error.rb +20 -0
  62. data/lib/rake/scope.rb +43 -0
  63. data/lib/rake/task.rb +433 -0
  64. data/lib/rake/task_argument_error.rb +8 -0
  65. data/lib/rake/task_arguments.rb +109 -0
  66. data/lib/rake/task_manager.rb +328 -0
  67. data/lib/rake/tasklib.rb +12 -0
  68. data/lib/rake/testtask.rb +224 -0
  69. data/lib/rake/thread_history_display.rb +49 -0
  70. data/lib/rake/thread_pool.rb +163 -0
  71. data/lib/rake/trace_output.rb +23 -0
  72. data/lib/rake/version.rb +10 -0
  73. data/lib/rake/win32.rb +51 -0
  74. data/rake.gemspec +36 -0
  75. metadata +132 -0
@@ -0,0 +1,26 @@
1
+ # frozen_string_literal: true
2
+ class Module
3
+ # Check for an existing method in the current class before extending. If
4
+ # the method already exists, then a warning is printed and the extension is
5
+ # not added. Otherwise the block is yielded and any definitions in the
6
+ # block will take effect.
7
+ #
8
+ # Usage:
9
+ #
10
+ # class String
11
+ # rake_extension("xyz") do
12
+ # def xyz
13
+ # ...
14
+ # end
15
+ # end
16
+ # end
17
+ #
18
+ def rake_extension(method) # :nodoc:
19
+ if method_defined?(method)
20
+ $stderr.puts "WARNING: Possible conflict with Rake extension: " +
21
+ "#{self}##{method} already exists"
22
+ else
23
+ yield
24
+ end
25
+ end
26
+ end
@@ -0,0 +1,176 @@
1
+ # frozen_string_literal: true
2
+ require "rake/ext/core"
3
+
4
+ class String
5
+
6
+ rake_extension("ext") do
7
+ # Replace the file extension with +newext+. If there is no extension on
8
+ # the string, append the new extension to the end. If the new extension
9
+ # is not given, or is the empty string, remove any existing extension.
10
+ #
11
+ # +ext+ is a user added method for the String class.
12
+ #
13
+ # This String extension comes from Rake
14
+ def ext(newext="")
15
+ return self.dup if [".", ".."].include? self
16
+ if newext != ""
17
+ newext = "." + newext unless newext =~ /^\./
18
+ end
19
+ self.chomp(File.extname(self)) << newext
20
+ end
21
+ end
22
+
23
+ rake_extension("pathmap") do
24
+ # Explode a path into individual components. Used by +pathmap+.
25
+ #
26
+ # This String extension comes from Rake
27
+ def pathmap_explode
28
+ head, tail = File.split(self)
29
+ return [self] if head == self
30
+ return [tail] if head == "." || tail == "/"
31
+ return [head, tail] if head == "/"
32
+ return head.pathmap_explode + [tail]
33
+ end
34
+ protected :pathmap_explode
35
+
36
+ # Extract a partial path from the path. Include +n+ directories from the
37
+ # front end (left hand side) if +n+ is positive. Include |+n+|
38
+ # directories from the back end (right hand side) if +n+ is negative.
39
+ #
40
+ # This String extension comes from Rake
41
+ def pathmap_partial(n)
42
+ dirs = File.dirname(self).pathmap_explode
43
+ partial_dirs =
44
+ if n > 0
45
+ dirs[0...n]
46
+ elsif n < 0
47
+ dirs.reverse[0...-n].reverse
48
+ else
49
+ "."
50
+ end
51
+ File.join(partial_dirs)
52
+ end
53
+ protected :pathmap_partial
54
+
55
+ # Perform the pathmap replacement operations on the given path. The
56
+ # patterns take the form 'pat1,rep1;pat2,rep2...'.
57
+ #
58
+ # This String extension comes from Rake
59
+ def pathmap_replace(patterns, &block)
60
+ result = self
61
+ patterns.split(";").each do |pair|
62
+ pattern, replacement = pair.split(",")
63
+ pattern = Regexp.new(pattern)
64
+ if replacement == "*" && block_given?
65
+ result = result.sub(pattern, &block)
66
+ elsif replacement
67
+ result = result.sub(pattern, replacement)
68
+ else
69
+ result = result.sub(pattern, "")
70
+ end
71
+ end
72
+ result
73
+ end
74
+ protected :pathmap_replace
75
+
76
+ # Map the path according to the given specification. The specification
77
+ # controls the details of the mapping. The following special patterns are
78
+ # recognized:
79
+ #
80
+ # <tt>%p</tt> :: The complete path.
81
+ # <tt>%f</tt> :: The base file name of the path, with its file extension,
82
+ # but without any directories.
83
+ # <tt>%n</tt> :: The file name of the path without its file extension.
84
+ # <tt>%d</tt> :: The directory list of the path.
85
+ # <tt>%x</tt> :: The file extension of the path. An empty string if there
86
+ # is no extension.
87
+ # <tt>%X</tt> :: Everything *but* the file extension.
88
+ # <tt>%s</tt> :: The alternate file separator if defined, otherwise use #
89
+ # the standard file separator.
90
+ # <tt>%%</tt> :: A percent sign.
91
+ #
92
+ # The <tt>%d</tt> specifier can also have a numeric prefix (e.g. '%2d').
93
+ # If the number is positive, only return (up to) +n+ directories in the
94
+ # path, starting from the left hand side. If +n+ is negative, return (up
95
+ # to) +n+ directories from the right hand side of the path.
96
+ #
97
+ # Examples:
98
+ #
99
+ # 'a/b/c/d/file.txt'.pathmap("%2d") => 'a/b'
100
+ # 'a/b/c/d/file.txt'.pathmap("%-2d") => 'c/d'
101
+ #
102
+ # Also the <tt>%d</tt>, <tt>%p</tt>, <tt>%f</tt>, <tt>%n</tt>,
103
+ # <tt>%x</tt>, and <tt>%X</tt> operators can take a pattern/replacement
104
+ # argument to perform simple string substitutions on a particular part of
105
+ # the path. The pattern and replacement are separated by a comma and are
106
+ # enclosed by curly braces. The replacement spec comes after the %
107
+ # character but before the operator letter. (e.g. "%{old,new}d").
108
+ # Multiple replacement specs should be separated by semi-colons (e.g.
109
+ # "%{old,new;src,bin}d").
110
+ #
111
+ # Regular expressions may be used for the pattern, and back refs may be
112
+ # used in the replacement text. Curly braces, commas and semi-colons are
113
+ # excluded from both the pattern and replacement text (let's keep parsing
114
+ # reasonable).
115
+ #
116
+ # For example:
117
+ #
118
+ # "src/org/onestepback/proj/A.java".pathmap("%{^src,class}X.class")
119
+ #
120
+ # returns:
121
+ #
122
+ # "class/org/onestepback/proj/A.class"
123
+ #
124
+ # If the replacement text is '*', then a block may be provided to perform
125
+ # some arbitrary calculation for the replacement.
126
+ #
127
+ # For example:
128
+ #
129
+ # "/path/to/file.TXT".pathmap("%X%{.*,*}x") { |ext|
130
+ # ext.downcase
131
+ # }
132
+ #
133
+ # Returns:
134
+ #
135
+ # "/path/to/file.txt"
136
+ #
137
+ # This String extension comes from Rake
138
+ def pathmap(spec=nil, &block)
139
+ return self if spec.nil?
140
+ result = "".dup
141
+ spec.scan(/%\{[^}]*\}-?\d*[sdpfnxX%]|%-?\d+d|%.|[^%]+/) do |frag|
142
+ case frag
143
+ when "%f"
144
+ result << File.basename(self)
145
+ when "%n"
146
+ result << File.basename(self).ext
147
+ when "%d"
148
+ result << File.dirname(self)
149
+ when "%x"
150
+ result << File.extname(self)
151
+ when "%X"
152
+ result << self.ext
153
+ when "%p"
154
+ result << self
155
+ when "%s"
156
+ result << (File::ALT_SEPARATOR || File::SEPARATOR)
157
+ when "%-"
158
+ # do nothing
159
+ when "%%"
160
+ result << "%"
161
+ when /%(-?\d+)d/
162
+ result << pathmap_partial($1.to_i)
163
+ when /^%\{([^}]*)\}(\d*[dpfnxX])/
164
+ patterns, operator = $1, $2
165
+ result << pathmap("%" + operator).pathmap_replace(patterns, &block)
166
+ when /^%/
167
+ fail ArgumentError, "Unknown pathmap specifier #{frag} in '#{spec}'"
168
+ else
169
+ result << frag
170
+ end
171
+ end
172
+ result
173
+ end
174
+ end
175
+
176
+ end
@@ -0,0 +1,25 @@
1
+ # frozen_string_literal: true
2
+ require "rake/file_task"
3
+ require "rake/early_time"
4
+
5
+ module Rake
6
+
7
+ # A FileCreationTask is a file task that when used as a dependency will be
8
+ # needed if and only if the file has not been created. Once created, it is
9
+ # not re-triggered if any of its dependencies are newer, nor does trigger
10
+ # any rebuilds of tasks that depend on it whenever it is updated.
11
+ #
12
+ class FileCreationTask < FileTask
13
+ # Is this file task needed? Yes if it doesn't exist.
14
+ def needed?
15
+ !File.exist?(name)
16
+ end
17
+
18
+ # Time stamp for file creation task. This time stamp is earlier
19
+ # than any other time stamp.
20
+ def timestamp
21
+ Rake::EARLY
22
+ end
23
+ end
24
+
25
+ end
@@ -0,0 +1,435 @@
1
+ # frozen_string_literal: true
2
+ require "rake/cloneable"
3
+ require "rake/file_utils_ext"
4
+ require "rake/ext/string"
5
+
6
+ module Rake
7
+
8
+ ##
9
+ # A FileList is essentially an array with a few helper methods defined to
10
+ # make file manipulation a bit easier.
11
+ #
12
+ # FileLists are lazy. When given a list of glob patterns for possible files
13
+ # to be included in the file list, instead of searching the file structures
14
+ # to find the files, a FileList holds the pattern for latter use.
15
+ #
16
+ # This allows us to define a number of FileList to match any number of
17
+ # files, but only search out the actual files when then FileList itself is
18
+ # actually used. The key is that the first time an element of the
19
+ # FileList/Array is requested, the pending patterns are resolved into a real
20
+ # list of file names.
21
+ #
22
+ class FileList
23
+
24
+ include Cloneable
25
+
26
+ # == Method Delegation
27
+ #
28
+ # The lazy evaluation magic of FileLists happens by implementing all the
29
+ # array specific methods to call +resolve+ before delegating the heavy
30
+ # lifting to an embedded array object (@items).
31
+ #
32
+ # In addition, there are two kinds of delegation calls. The regular kind
33
+ # delegates to the @items array and returns the result directly. Well,
34
+ # almost directly. It checks if the returned value is the @items object
35
+ # itself, and if so will return the FileList object instead.
36
+ #
37
+ # The second kind of delegation call is used in methods that normally
38
+ # return a new Array object. We want to capture the return value of these
39
+ # methods and wrap them in a new FileList object. We enumerate these
40
+ # methods in the +SPECIAL_RETURN+ list below.
41
+
42
+ # List of array methods (that are not in +Object+) that need to be
43
+ # delegated.
44
+ ARRAY_METHODS = (Array.instance_methods - Object.instance_methods).map(&:to_s)
45
+
46
+ # List of additional methods that must be delegated.
47
+ MUST_DEFINE = %w[inspect <=>]
48
+
49
+ # List of methods that should not be delegated here (we define special
50
+ # versions of them explicitly below).
51
+ MUST_NOT_DEFINE = %w[to_a to_ary partition * <<]
52
+
53
+ # List of delegated methods that return new array values which need
54
+ # wrapping.
55
+ SPECIAL_RETURN = %w[
56
+ map collect sort sort_by select find_all reject grep
57
+ compact flatten uniq values_at
58
+ + - & |
59
+ ]
60
+
61
+ DELEGATING_METHODS = (ARRAY_METHODS + MUST_DEFINE - MUST_NOT_DEFINE).map(&:to_s).sort.uniq
62
+
63
+ # Now do the delegation.
64
+ DELEGATING_METHODS.each do |sym|
65
+ if SPECIAL_RETURN.include?(sym)
66
+ ln = __LINE__ + 1
67
+ class_eval %{
68
+ def #{sym}(*args, &block)
69
+ resolve
70
+ result = @items.send(:#{sym}, *args, &block)
71
+ self.class.new.import(result)
72
+ end
73
+ }, __FILE__, ln
74
+ else
75
+ ln = __LINE__ + 1
76
+ class_eval %{
77
+ def #{sym}(*args, &block)
78
+ resolve
79
+ result = @items.send(:#{sym}, *args, &block)
80
+ result.object_id == @items.object_id ? self : result
81
+ end
82
+ }, __FILE__, ln
83
+ end
84
+ end
85
+
86
+ GLOB_PATTERN = %r{[*?\[\{]}
87
+
88
+ # Create a file list from the globbable patterns given. If you wish to
89
+ # perform multiple includes or excludes at object build time, use the
90
+ # "yield self" pattern.
91
+ #
92
+ # Example:
93
+ # file_list = FileList.new('lib/**/*.rb', 'test/test*.rb')
94
+ #
95
+ # pkg_files = FileList.new('lib/**/*') do |fl|
96
+ # fl.exclude(/\bCVS\b/)
97
+ # end
98
+ #
99
+ def initialize(*patterns)
100
+ @pending_add = []
101
+ @pending = false
102
+ @exclude_patterns = DEFAULT_IGNORE_PATTERNS.dup
103
+ @exclude_procs = DEFAULT_IGNORE_PROCS.dup
104
+ @items = []
105
+ patterns.each { |pattern| include(pattern) }
106
+ yield self if block_given?
107
+ end
108
+
109
+ # Add file names defined by glob patterns to the file list. If an array
110
+ # is given, add each element of the array.
111
+ #
112
+ # Example:
113
+ # file_list.include("*.java", "*.cfg")
114
+ # file_list.include %w( math.c lib.h *.o )
115
+ #
116
+ def include(*filenames)
117
+ # TODO: check for pending
118
+ filenames.each do |fn|
119
+ if fn.respond_to? :to_ary
120
+ include(*fn.to_ary)
121
+ else
122
+ @pending_add << Rake.from_pathname(fn)
123
+ end
124
+ end
125
+ @pending = true
126
+ self
127
+ end
128
+ alias :add :include
129
+
130
+ # Register a list of file name patterns that should be excluded from the
131
+ # list. Patterns may be regular expressions, glob patterns or regular
132
+ # strings. In addition, a block given to exclude will remove entries that
133
+ # return true when given to the block.
134
+ #
135
+ # Note that glob patterns are expanded against the file system. If a file
136
+ # is explicitly added to a file list, but does not exist in the file
137
+ # system, then an glob pattern in the exclude list will not exclude the
138
+ # file.
139
+ #
140
+ # Examples:
141
+ # FileList['a.c', 'b.c'].exclude("a.c") => ['b.c']
142
+ # FileList['a.c', 'b.c'].exclude(/^a/) => ['b.c']
143
+ #
144
+ # If "a.c" is a file, then ...
145
+ # FileList['a.c', 'b.c'].exclude("a.*") => ['b.c']
146
+ #
147
+ # If "a.c" is not a file, then ...
148
+ # FileList['a.c', 'b.c'].exclude("a.*") => ['a.c', 'b.c']
149
+ #
150
+ def exclude(*patterns, &block)
151
+ patterns.each do |pat|
152
+ if pat.respond_to? :to_ary
153
+ exclude(*pat.to_ary)
154
+ else
155
+ @exclude_patterns << Rake.from_pathname(pat)
156
+ end
157
+ end
158
+ @exclude_procs << block if block_given?
159
+ resolve_exclude unless @pending
160
+ self
161
+ end
162
+
163
+ # Clear all the exclude patterns so that we exclude nothing.
164
+ def clear_exclude
165
+ @exclude_patterns = []
166
+ @exclude_procs = []
167
+ self
168
+ end
169
+
170
+ # A FileList is equal through array equality.
171
+ def ==(array)
172
+ to_ary == array
173
+ end
174
+
175
+ # Return the internal array object.
176
+ def to_a
177
+ resolve
178
+ @items
179
+ end
180
+
181
+ # Return the internal array object.
182
+ def to_ary
183
+ to_a
184
+ end
185
+
186
+ # Lie about our class.
187
+ def is_a?(klass)
188
+ klass == Array || super(klass)
189
+ end
190
+ alias kind_of? is_a?
191
+
192
+ # Redefine * to return either a string or a new file list.
193
+ def *(other)
194
+ result = @items * other
195
+ case result
196
+ when Array
197
+ self.class.new.import(result)
198
+ else
199
+ result
200
+ end
201
+ end
202
+
203
+ def <<(obj)
204
+ resolve
205
+ @items << Rake.from_pathname(obj)
206
+ self
207
+ end
208
+
209
+ # Resolve all the pending adds now.
210
+ def resolve
211
+ if @pending
212
+ @pending = false
213
+ @pending_add.each do |fn| resolve_add(fn) end
214
+ @pending_add = []
215
+ resolve_exclude
216
+ end
217
+ self
218
+ end
219
+
220
+ def resolve_add(fn) # :nodoc:
221
+ case fn
222
+ when GLOB_PATTERN
223
+ add_matching(fn)
224
+ else
225
+ self << fn
226
+ end
227
+ end
228
+ private :resolve_add
229
+
230
+ def resolve_exclude # :nodoc:
231
+ reject! { |fn| excluded_from_list?(fn) }
232
+ self
233
+ end
234
+ private :resolve_exclude
235
+
236
+ # Return a new FileList with the results of running +sub+ against each
237
+ # element of the original list.
238
+ #
239
+ # Example:
240
+ # FileList['a.c', 'b.c'].sub(/\.c$/, '.o') => ['a.o', 'b.o']
241
+ #
242
+ def sub(pat, rep)
243
+ inject(self.class.new) { |res, fn| res << fn.sub(pat, rep) }
244
+ end
245
+
246
+ # Return a new FileList with the results of running +gsub+ against each
247
+ # element of the original list.
248
+ #
249
+ # Example:
250
+ # FileList['lib/test/file', 'x/y'].gsub(/\//, "\\")
251
+ # => ['lib\\test\\file', 'x\\y']
252
+ #
253
+ def gsub(pat, rep)
254
+ inject(self.class.new) { |res, fn| res << fn.gsub(pat, rep) }
255
+ end
256
+
257
+ # Same as +sub+ except that the original file list is modified.
258
+ def sub!(pat, rep)
259
+ each_with_index { |fn, i| self[i] = fn.sub(pat, rep) }
260
+ self
261
+ end
262
+
263
+ # Same as +gsub+ except that the original file list is modified.
264
+ def gsub!(pat, rep)
265
+ each_with_index { |fn, i| self[i] = fn.gsub(pat, rep) }
266
+ self
267
+ end
268
+
269
+ # Apply the pathmap spec to each of the included file names, returning a
270
+ # new file list with the modified paths. (See String#pathmap for
271
+ # details.)
272
+ def pathmap(spec=nil, &block)
273
+ collect { |fn| fn.pathmap(spec, &block) }
274
+ end
275
+
276
+ # Return a new FileList with <tt>String#ext</tt> method applied to
277
+ # each member of the array.
278
+ #
279
+ # This method is a shortcut for:
280
+ #
281
+ # array.collect { |item| item.ext(newext) }
282
+ #
283
+ # +ext+ is a user added method for the Array class.
284
+ def ext(newext="")
285
+ collect { |fn| fn.ext(newext) }
286
+ end
287
+
288
+ # Grep each of the files in the filelist using the given pattern. If a
289
+ # block is given, call the block on each matching line, passing the file
290
+ # name, line number, and the matching line of text. If no block is given,
291
+ # a standard emacs style file:linenumber:line message will be printed to
292
+ # standard out. Returns the number of matched items.
293
+ def egrep(pattern, *options)
294
+ matched = 0
295
+ each do |fn|
296
+ begin
297
+ File.open(fn, "r", *options) do |inf|
298
+ count = 0
299
+ inf.each do |line|
300
+ count += 1
301
+ if pattern.match(line)
302
+ matched += 1
303
+ if block_given?
304
+ yield fn, count, line
305
+ else
306
+ puts "#{fn}:#{count}:#{line}"
307
+ end
308
+ end
309
+ end
310
+ end
311
+ rescue StandardError => ex
312
+ $stderr.puts "Error while processing '#{fn}': #{ex}"
313
+ end
314
+ end
315
+ matched
316
+ end
317
+
318
+ # Return a new file list that only contains file names from the current
319
+ # file list that exist on the file system.
320
+ def existing
321
+ select { |fn| File.exist?(fn) }.uniq
322
+ end
323
+
324
+ # Modify the current file list so that it contains only file name that
325
+ # exist on the file system.
326
+ def existing!
327
+ resolve
328
+ @items = @items.select { |fn| File.exist?(fn) }.uniq
329
+ self
330
+ end
331
+
332
+ # FileList version of partition. Needed because the nested arrays should
333
+ # be FileLists in this version.
334
+ def partition(&block) # :nodoc:
335
+ resolve
336
+ result = @items.partition(&block)
337
+ [
338
+ self.class.new.import(result[0]),
339
+ self.class.new.import(result[1]),
340
+ ]
341
+ end
342
+
343
+ # Convert a FileList to a string by joining all elements with a space.
344
+ def to_s
345
+ resolve
346
+ self.join(" ")
347
+ end
348
+
349
+ # Add matching glob patterns.
350
+ def add_matching(pattern)
351
+ self.class.glob(pattern).each do |fn|
352
+ self << fn unless excluded_from_list?(fn)
353
+ end
354
+ end
355
+ private :add_matching
356
+
357
+ # Should the given file name be excluded from the list?
358
+ #
359
+ # NOTE: This method was formerly named "exclude?", but Rails
360
+ # introduced an exclude? method as an array method and setup a
361
+ # conflict with file list. We renamed the method to avoid
362
+ # confusion. If you were using "FileList#exclude?" in your user
363
+ # code, you will need to update.
364
+ def excluded_from_list?(fn)
365
+ return true if @exclude_patterns.any? do |pat|
366
+ case pat
367
+ when Regexp
368
+ fn =~ pat
369
+ when GLOB_PATTERN
370
+ flags = File::FNM_PATHNAME
371
+ # Ruby <= 1.9.3 does not support File::FNM_EXTGLOB
372
+ flags |= File::FNM_EXTGLOB if defined? File::FNM_EXTGLOB
373
+ File.fnmatch?(pat, fn, flags)
374
+ else
375
+ fn == pat
376
+ end
377
+ end
378
+ @exclude_procs.any? { |p| p.call(fn) }
379
+ end
380
+
381
+ DEFAULT_IGNORE_PATTERNS = [
382
+ /(^|[\/\\])CVS([\/\\]|$)/,
383
+ /(^|[\/\\])\.svn([\/\\]|$)/,
384
+ /\.bak$/,
385
+ /~$/
386
+ ]
387
+ DEFAULT_IGNORE_PROCS = [
388
+ proc { |fn| fn =~ /(^|[\/\\])core$/ && !File.directory?(fn) }
389
+ ]
390
+
391
+ def import(array) # :nodoc:
392
+ @items = array
393
+ self
394
+ end
395
+
396
+ class << self
397
+ # Create a new file list including the files listed. Similar to:
398
+ #
399
+ # FileList.new(*args)
400
+ def [](*args)
401
+ new(*args)
402
+ end
403
+
404
+ # Get a sorted list of files matching the pattern. This method
405
+ # should be preferred to Dir[pattern] and Dir.glob(pattern) because
406
+ # the files returned are guaranteed to be sorted.
407
+ def glob(pattern, *args)
408
+ Dir.glob(pattern, *args).sort
409
+ end
410
+ end
411
+ end
412
+ end
413
+
414
+ module Rake
415
+ class << self
416
+
417
+ # Yield each file or directory component.
418
+ def each_dir_parent(dir) # :nodoc:
419
+ old_length = nil
420
+ while dir != "." && dir.length != old_length
421
+ yield(dir)
422
+ old_length = dir.length
423
+ dir = File.dirname(dir)
424
+ end
425
+ end
426
+
427
+ # Convert Pathname and Pathname-like objects to strings;
428
+ # leave everything else alone
429
+ def from_pathname(path) # :nodoc:
430
+ path = path.to_path if path.respond_to?(:to_path)
431
+ path = path.to_str if path.respond_to?(:to_str)
432
+ path
433
+ end
434
+ end
435
+ end # module Rake