rake 10.0.0.beta.2 → 13.0.0.pre.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.github/workflows/macos.yml +22 -0
- data/.github/workflows/ubuntu-rvm.yml +28 -0
- data/.github/workflows/ubuntu.yml +20 -0
- data/.github/workflows/windows.yml +20 -0
- data/CONTRIBUTING.rdoc +43 -0
- data/Gemfile +10 -0
- data/History.rdoc +2359 -0
- data/MIT-LICENSE +1 -1
- data/README.rdoc +57 -101
- data/Rakefile +22 -354
- data/bin/bundle +105 -0
- data/bin/console +7 -0
- data/bin/rake +19 -27
- data/bin/rdoc +29 -0
- data/bin/rubocop +29 -0
- data/bin/setup +6 -0
- data/doc/command_line_usage.rdoc +30 -18
- data/doc/glossary.rdoc +40 -49
- data/doc/jamis.rb +1 -0
- data/doc/rake.1 +156 -0
- data/doc/rakefile.rdoc +127 -62
- data/exe/rake +27 -0
- data/lib/rake.rb +35 -34
- data/lib/rake/application.rb +355 -188
- data/lib/rake/backtrace.rb +14 -7
- data/lib/rake/clean.rb +54 -8
- data/lib/rake/cloneable.rb +5 -4
- data/lib/rake/cpu_counter.rb +107 -0
- data/lib/rake/default_loader.rb +5 -0
- data/lib/rake/dsl_definition.rb +58 -19
- data/lib/rake/early_time.rb +5 -1
- data/lib/rake/ext/core.rb +5 -6
- data/lib/rake/ext/string.rb +61 -52
- data/lib/rake/file_creation_task.rb +4 -3
- data/lib/rake/file_list.rb +81 -49
- data/lib/rake/file_task.rb +15 -8
- data/lib/rake/file_utils.rb +63 -43
- data/lib/rake/file_utils_ext.rb +10 -22
- data/lib/rake/invocation_chain.rb +25 -19
- data/lib/rake/invocation_exception_mixin.rb +1 -0
- data/lib/rake/late_time.rb +18 -0
- data/lib/rake/linked_list.rb +112 -0
- data/lib/rake/loaders/makefile.rb +23 -9
- data/lib/rake/multi_task.rb +2 -1
- data/lib/rake/name_space.rb +36 -23
- data/lib/rake/packagetask.rb +71 -34
- data/lib/rake/phony.rb +6 -3
- data/lib/rake/private_reader.rb +21 -0
- data/lib/rake/promise.rb +100 -0
- data/lib/rake/pseudo_status.rb +8 -2
- data/lib/rake/rake_module.rb +34 -11
- data/lib/rake/rake_test_loader.rb +18 -13
- data/lib/rake/rule_recursion_overflow_error.rb +2 -2
- data/lib/rake/scope.rb +43 -0
- data/lib/rake/task.rb +166 -82
- data/lib/rake/task_argument_error.rb +1 -0
- data/lib/rake/task_arguments.rb +45 -14
- data/lib/rake/task_manager.rb +82 -50
- data/lib/rake/tasklib.rb +2 -12
- data/lib/rake/testtask.rb +68 -39
- data/lib/rake/thread_history_display.rb +10 -6
- data/lib/rake/thread_pool.rb +60 -86
- data/lib/rake/trace_output.rb +23 -0
- data/lib/rake/version.rb +6 -8
- data/lib/rake/win32.rb +14 -18
- data/rake.gemspec +36 -0
- metadata +64 -166
- data/.gemtest +0 -0
- data/CHANGES +0 -526
- data/TODO +0 -21
- data/doc/rake.1.gz +0 -0
- data/doc/release_notes/rake-0.4.14.rdoc +0 -23
- data/doc/release_notes/rake-0.4.15.rdoc +0 -35
- data/doc/release_notes/rake-0.5.0.rdoc +0 -53
- data/doc/release_notes/rake-0.5.3.rdoc +0 -78
- data/doc/release_notes/rake-0.5.4.rdoc +0 -46
- data/doc/release_notes/rake-0.6.0.rdoc +0 -141
- data/doc/release_notes/rake-0.7.0.rdoc +0 -119
- data/doc/release_notes/rake-0.7.1.rdoc +0 -59
- data/doc/release_notes/rake-0.7.2.rdoc +0 -121
- data/doc/release_notes/rake-0.7.3.rdoc +0 -47
- data/doc/release_notes/rake-0.8.0.rdoc +0 -114
- data/doc/release_notes/rake-0.8.2.rdoc +0 -165
- data/doc/release_notes/rake-0.8.3.rdoc +0 -112
- data/doc/release_notes/rake-0.8.4.rdoc +0 -147
- data/doc/release_notes/rake-0.8.5.rdoc +0 -53
- data/doc/release_notes/rake-0.8.6.rdoc +0 -55
- data/doc/release_notes/rake-0.8.7.rdoc +0 -55
- data/doc/release_notes/rake-0.9.0.rdoc +0 -112
- data/doc/release_notes/rake-0.9.1.rdoc +0 -52
- data/doc/release_notes/rake-0.9.2.2.rdoc +0 -55
- data/doc/release_notes/rake-0.9.2.rdoc +0 -49
- data/doc/release_notes/rake-0.9.3.rdoc +0 -102
- data/doc/release_notes/rake-10.0.0.rdoc +0 -178
- data/install.rb +0 -90
- data/lib/rake/alt_system.rb +0 -109
- data/lib/rake/contrib/compositepublisher.rb +0 -21
- data/lib/rake/contrib/ftptools.rb +0 -151
- data/lib/rake/contrib/publisher.rb +0 -73
- data/lib/rake/contrib/rubyforgepublisher.rb +0 -16
- data/lib/rake/contrib/sshpublisher.rb +0 -50
- data/lib/rake/ext/module.rb +0 -0
- data/lib/rake/ext/time.rb +0 -14
- data/lib/rake/pathmap.rb +0 -1
- data/lib/rake/ruby182_test_unit_fix.rb +0 -25
- data/lib/rake/runtest.rb +0 -21
- data/test/file_creation.rb +0 -34
- data/test/helper.rb +0 -522
- data/test/test_rake.rb +0 -40
- data/test/test_rake_application.rb +0 -484
- data/test/test_rake_application_options.rb +0 -427
- data/test/test_rake_backtrace.rb +0 -67
- data/test/test_rake_clean.rb +0 -14
- data/test/test_rake_definitions.rb +0 -80
- data/test/test_rake_directory_task.rb +0 -57
- data/test/test_rake_dsl.rb +0 -40
- data/test/test_rake_early_time.rb +0 -31
- data/test/test_rake_extension.rb +0 -59
- data/test/test_rake_file_creation_task.rb +0 -56
- data/test/test_rake_file_list.rb +0 -628
- data/test/test_rake_file_list_path_map.rb +0 -8
- data/test/test_rake_file_task.rb +0 -122
- data/test/test_rake_file_utils.rb +0 -305
- data/test/test_rake_ftp_file.rb +0 -59
- data/test/test_rake_functional.rb +0 -472
- data/test/test_rake_invocation_chain.rb +0 -52
- data/test/test_rake_makefile_loader.rb +0 -44
- data/test/test_rake_multi_task.rb +0 -59
- data/test/test_rake_name_space.rb +0 -43
- data/test/test_rake_package_task.rb +0 -79
- data/test/test_rake_path_map.rb +0 -157
- data/test/test_rake_path_map_explode.rb +0 -34
- data/test/test_rake_path_map_partial.rb +0 -18
- data/test/test_rake_pseudo_status.rb +0 -21
- data/test/test_rake_rake_test_loader.rb +0 -21
- data/test/test_rake_reduce_compat.rb +0 -30
- data/test/test_rake_require.rb +0 -40
- data/test/test_rake_rules.rb +0 -327
- data/test/test_rake_task.rb +0 -316
- data/test/test_rake_task_argument_parsing.rb +0 -103
- data/test/test_rake_task_arguments.rb +0 -88
- data/test/test_rake_task_lib.rb +0 -9
- data/test/test_rake_task_manager.rb +0 -157
- data/test/test_rake_task_manager_argument_resolution.rb +0 -19
- data/test/test_rake_task_with_arguments.rb +0 -162
- data/test/test_rake_test_task.rb +0 -120
- data/test/test_rake_thread_pool.rb +0 -146
- data/test/test_rake_top_level_functions.rb +0 -71
- data/test/test_rake_win32.rb +0 -72
- data/test/test_thread_history_display.rb +0 -91
@@ -1,59 +0,0 @@
|
|
1
|
-
= Rake 0.7.1 Released
|
2
|
-
|
3
|
-
Version 0.7.1 supplies a bug fix and a few minor enhancements.
|
4
|
-
|
5
|
-
== Changes
|
6
|
-
|
7
|
-
=== Bug Fixes in 0.7.1
|
8
|
-
|
9
|
-
* Changes in the exception reported for the FileUtils.ln caused
|
10
|
-
safe_ln to fail with a NotImplementedError. Rake 0.7.1 will now
|
11
|
-
catch that error or any StandardError and properly fall back to
|
12
|
-
using +cp+.
|
13
|
-
|
14
|
-
=== New Features in 0.7.1
|
15
|
-
|
16
|
-
* You can filter the results of the --task option by supplying an
|
17
|
-
optional regular expression. This allows the user to easily find a
|
18
|
-
particular task name in a long list of possible names.
|
19
|
-
|
20
|
-
* Transforming procs in a rule may now return a list of prerequisites.
|
21
|
-
This allows more flexible rule formation.
|
22
|
-
|
23
|
-
* FileList and String now support a +pathmap+ melthod that makes the
|
24
|
-
transforming paths a bit easier. See the API docs for +pathmap+ for
|
25
|
-
details.
|
26
|
-
|
27
|
-
* The -f option without a value will disable the search for a
|
28
|
-
Rakefile. This allows the Rakefile to be defined entirely in a
|
29
|
-
library (and loaded with the -r option). The current working
|
30
|
-
directory is not changed when this is done.
|
31
|
-
|
32
|
-
== What is Rake
|
33
|
-
|
34
|
-
Rake is a build tool similar to the make program in many ways. But
|
35
|
-
instead of cryptic make recipes, Rake uses standard Ruby code to
|
36
|
-
declare tasks and dependencies. You have the full power of a modern
|
37
|
-
scripting language built right into your build tool.
|
38
|
-
|
39
|
-
== Availability
|
40
|
-
|
41
|
-
The easiest way to get and install rake is via RubyGems ...
|
42
|
-
|
43
|
-
gem install rake (you may need root/admin privileges)
|
44
|
-
|
45
|
-
Otherwise, you can get it from the more traditional places:
|
46
|
-
|
47
|
-
Home Page:: http://rake.rubyforge.org/
|
48
|
-
Download:: http://rubyforge.org/project/showfiles.php?group_id=50
|
49
|
-
|
50
|
-
== Thanks
|
51
|
-
|
52
|
-
As usual, it was input from users that drove a alot of these changes.
|
53
|
-
The following people either contributed patches, made suggestions or
|
54
|
-
made otherwise helpful comments. Thanks to ...
|
55
|
-
|
56
|
-
* James Britt and Assaph Mehr for reporting and helping to debug the
|
57
|
-
safe_ln issue.
|
58
|
-
|
59
|
-
-- Jim Weirich
|
@@ -1,121 +0,0 @@
|
|
1
|
-
= Rake 0.7.2 Released
|
2
|
-
|
3
|
-
Version 0.7.2 supplies a bug fix and a few minor enhancements. In
|
4
|
-
particular, the new version fixes an incompatibility with the soon to
|
5
|
-
be released Ruby 1.8.6. We strongly recommend upgrading to Rake 0.7.2
|
6
|
-
in order to be compatible with the new version of Ruby.
|
7
|
-
|
8
|
-
== Changes
|
9
|
-
|
10
|
-
=== Bug Fixes in 0.7.2
|
11
|
-
|
12
|
-
There are quite a number of bug fixes in the new 0.7.2 version of
|
13
|
-
Rake:
|
14
|
-
|
15
|
-
* Removed dependency on internal fu_xxx functions from FileUtils.
|
16
|
-
|
17
|
-
* Error messages are now send to stderr rather than stdout (from
|
18
|
-
Payton Quackenbush).
|
19
|
-
|
20
|
-
* Better error handling on invalid command line arguments (from Payton
|
21
|
-
Quackenbush).
|
22
|
-
|
23
|
-
* Fixed some bugs where the application object was going to the global
|
24
|
-
appliation instead of using its own data.
|
25
|
-
|
26
|
-
* Fixed the method name leak from FileUtils (bug found by Glenn
|
27
|
-
Vanderburg).
|
28
|
-
|
29
|
-
* Added test for noop, bad_option and verbose flags to sh command.
|
30
|
-
|
31
|
-
* Added a description to the gem task in GemPackageTask.
|
32
|
-
|
33
|
-
* Fixed a bug when rules have multiple prerequisites (patch by Joel
|
34
|
-
VanderWerf)
|
35
|
-
|
36
|
-
* Added the handful of RakeFileUtils to the private method as well.
|
37
|
-
|
38
|
-
=== New Features in 0.7.2
|
39
|
-
|
40
|
-
The following new features are available in Rake version 0.7.2:
|
41
|
-
|
42
|
-
* Added square and curly bracket patterns to FileList#include (Tilman
|
43
|
-
Sauerbeck).
|
44
|
-
|
45
|
-
* FileLists can now pass a block to FileList#exclude to exclude files
|
46
|
-
based on calculated values.
|
47
|
-
|
48
|
-
* Added plain filename support to rule dependents (suggested by Nobu
|
49
|
-
Nakada).
|
50
|
-
|
51
|
-
* Added pathmap support to rule dependents. In other words, if a
|
52
|
-
pathmap format (beginning with a '%') is given as a Rake rule
|
53
|
-
dependent, then the name of the depend will be the name of the
|
54
|
-
target with the pathmap format applied.
|
55
|
-
|
56
|
-
* Added a 'tasks' method to a namespace to get a list of tasks
|
57
|
-
associated with the namespace.
|
58
|
-
|
59
|
-
* Added tar_command and zip_command options to the Package task.
|
60
|
-
|
61
|
-
* The clean task will no longer delete 'core' if it is a directory.
|
62
|
-
|
63
|
-
=== Internal Rake Improvements
|
64
|
-
|
65
|
-
The following changes will are mainly internal improvements and
|
66
|
-
refactorings and have little effect on the end user. But they may be
|
67
|
-
of interest to the general public.
|
68
|
-
|
69
|
-
* Added rcov task and updated unit testing for better code coverage.
|
70
|
-
|
71
|
-
* Added a 'shame' task to the Rakefile.
|
72
|
-
|
73
|
-
* Added rake_extension to handle detection of extension collisions.
|
74
|
-
|
75
|
-
* Added a protected 'require "rubygems"' to test/test_application to
|
76
|
-
unbreak cruisecontrol.rb.
|
77
|
-
|
78
|
-
* Removed rake_dup. Now we just simply rescue a bad dup.
|
79
|
-
|
80
|
-
* Refactored the FileList reject logic to remove duplication.
|
81
|
-
|
82
|
-
* Removed if __FILE__ at the end of the rake.rb file.
|
83
|
-
|
84
|
-
== What is Rake
|
85
|
-
|
86
|
-
Rake is a build tool similar to the make program in many ways. But
|
87
|
-
instead of cryptic make recipes, Rake uses standard Ruby code to
|
88
|
-
declare tasks and dependencies. You have the full power of a modern
|
89
|
-
scripting language built right into your build tool.
|
90
|
-
|
91
|
-
== Availability
|
92
|
-
|
93
|
-
The easiest way to get and install rake is via RubyGems ...
|
94
|
-
|
95
|
-
gem install rake (you may need root/admin privileges)
|
96
|
-
|
97
|
-
Otherwise, you can get it from the more traditional places:
|
98
|
-
|
99
|
-
Home Page:: http://rake.rubyforge.org/
|
100
|
-
Download:: http://rubyforge.org/project/showfiles.php?group_id=50
|
101
|
-
|
102
|
-
== Thanks
|
103
|
-
|
104
|
-
As usual, it was input from users that drove a alot of these changes.
|
105
|
-
The following people either contributed patches, made suggestions or
|
106
|
-
made otherwise helpful comments. Thanks to ...
|
107
|
-
|
108
|
-
* Payton Quackenbush -- For several error handling improvements.
|
109
|
-
|
110
|
-
* Glenn Vanderburg -- For finding and fixing the method name leak from
|
111
|
-
FileUtils.
|
112
|
-
|
113
|
-
* Joel VanderWerf -- for finding and fixing a bug in the handling of
|
114
|
-
multiple prerequisites.
|
115
|
-
|
116
|
-
* Tilman Sauerbeck -- For some enhancing FileList to support more
|
117
|
-
advanced file globbing.
|
118
|
-
|
119
|
-
* Nobu Nakada -- For suggesting plain file name support to rule dependents.
|
120
|
-
|
121
|
-
-- Jim Weirich
|
@@ -1,47 +0,0 @@
|
|
1
|
-
= Rake 0.7.3 Released
|
2
|
-
|
3
|
-
Rake version 0.7.3 is a minor release that includes some refactoring to better
|
4
|
-
support custom Rake applications.
|
5
|
-
|
6
|
-
== Changes
|
7
|
-
|
8
|
-
=== New Features in Version 0.7.3
|
9
|
-
|
10
|
-
* Added the +init+ and +top_level+ methods to make the creation of custom Rake applications a bit easier. E.g.
|
11
|
-
|
12
|
-
gem 'rake', ">= 0.7.3"
|
13
|
-
require 'rake'
|
14
|
-
|
15
|
-
Rake.application.init('myrake')
|
16
|
-
|
17
|
-
task :default do
|
18
|
-
something_interesting
|
19
|
-
end
|
20
|
-
|
21
|
-
Rake.application.top_level
|
22
|
-
|
23
|
-
== What is Rake
|
24
|
-
|
25
|
-
Rake is a build tool similar to the make program in many ways. But instead of
|
26
|
-
cryptic make recipes, Rake uses standard Ruby code to declare tasks and
|
27
|
-
dependencies. You have the full power of a modern scripting language built
|
28
|
-
right into your build tool.
|
29
|
-
|
30
|
-
== Availability
|
31
|
-
|
32
|
-
The easiest way to get and install rake is via RubyGems ...
|
33
|
-
|
34
|
-
gem install rake (you may need root/admin privileges)
|
35
|
-
|
36
|
-
Otherwise, you can get it from the more traditional places:
|
37
|
-
|
38
|
-
Home Page:: http://rake.rubyforge.org/
|
39
|
-
Download:: http://rubyforge.org/project/showfiles.php?group_id=50
|
40
|
-
|
41
|
-
== Thanks
|
42
|
-
|
43
|
-
As usual, it was input from users that drove a alot of these changes. The
|
44
|
-
following people either contributed patches, made suggestions or made
|
45
|
-
otherwise helpful comments. Thanks to ...
|
46
|
-
|
47
|
-
-- Jim Weirich
|
@@ -1,114 +0,0 @@
|
|
1
|
-
= Rake 0.8.0/0.8.1 Released
|
2
|
-
|
3
|
-
Rake version 0.8.0 is a new release of rake that includes serveral new
|
4
|
-
features.
|
5
|
-
|
6
|
-
== Changes
|
7
|
-
|
8
|
-
=== New Features in Version 0.8.0
|
9
|
-
|
10
|
-
* Tasks can now receive command line parameters. See the examples
|
11
|
-
below for more details.
|
12
|
-
|
13
|
-
* Comments are limited to 80 columns on output, but full comments can
|
14
|
-
be seen by using the -D parameter. (feature suggested by Jamis
|
15
|
-
Buck).
|
16
|
-
|
17
|
-
* Explicit exit(n) calls will now set the exit status to n. (patch
|
18
|
-
provided by Stephen Touset).
|
19
|
-
|
20
|
-
* Rake is now compatible with Ruby 1.9.
|
21
|
-
|
22
|
-
Version 0.8.1 is a minor update that includes additional Ruby 1.9
|
23
|
-
compatibility fixes.
|
24
|
-
|
25
|
-
== What is Rake
|
26
|
-
|
27
|
-
Rake is a build tool similar to the make program in many ways. But
|
28
|
-
instead of cryptic make recipes, Rake uses standard Ruby code to
|
29
|
-
declare tasks and dependencies. You have the full power of a modern
|
30
|
-
scripting language built right into your build tool.
|
31
|
-
|
32
|
-
== Availability
|
33
|
-
|
34
|
-
The easiest way to get and install rake is via RubyGems ...
|
35
|
-
|
36
|
-
gem install rake (you may need root/admin privileges)
|
37
|
-
|
38
|
-
Otherwise, you can get it from the more traditional places:
|
39
|
-
|
40
|
-
Home Page:: http://rake.rubyforge.org/
|
41
|
-
Download:: http://rubyforge.org/project/showfiles.php?group_id=50
|
42
|
-
|
43
|
-
== Task Argument Examples
|
44
|
-
|
45
|
-
Prior to version 0.8.0, rake was only able to handle command line
|
46
|
-
arguments of the form NAME=VALUE that were passed into Rake via the
|
47
|
-
ENV hash. Many folks had asked for some kind of simple command line
|
48
|
-
arguments, perhaps using "--" to separate regular task names from
|
49
|
-
argument values on the command line. The problem is that there was no
|
50
|
-
easy way to associate positional arguments on the command line with
|
51
|
-
different tasks. Suppose both tasks :a and :b expect a command line
|
52
|
-
argument: does the first value go with :a? What if :b is run first?
|
53
|
-
Should it then get the first command line argument.
|
54
|
-
|
55
|
-
Rake 0.8.0 solves this problem by explicitly passing values directly
|
56
|
-
to the tasks that need them. For example, if I had a release task
|
57
|
-
that required a version number, I could say:
|
58
|
-
|
59
|
-
rake release[0.8.0]
|
60
|
-
|
61
|
-
And the string "0.8.0" will be passed to the :release task. Multiple
|
62
|
-
arguments can be passed by separating them with a comma, for example:
|
63
|
-
|
64
|
-
rake name[john,doe]
|
65
|
-
|
66
|
-
Just a few words of caution. The rake task name and its arguments
|
67
|
-
need to be a single command line argument to rake. This generally
|
68
|
-
means no spaces. If spaces are needed, then the entire rake +
|
69
|
-
argument string should be quoted. Something like this:
|
70
|
-
|
71
|
-
rake "name[billy bob, smith]"
|
72
|
-
|
73
|
-
(Quoting rules vary between operating systems and shells, so make sure
|
74
|
-
you consult the proper docs for your OS/shell).
|
75
|
-
|
76
|
-
=== Tasks that Expect Parameters
|
77
|
-
|
78
|
-
Parameters are only given to tasks that are setup to expect them. In
|
79
|
-
order to handle named parameters, the task declaration syntax for
|
80
|
-
tasks has been extended slightly.
|
81
|
-
|
82
|
-
For example, a task that needs a first name and last name might be
|
83
|
-
declared as:
|
84
|
-
|
85
|
-
task :name, :first_name, :last_name
|
86
|
-
|
87
|
-
The first argument is still the name of the task (:name in this case).
|
88
|
-
The next to argumements are the names of the parameters expected by
|
89
|
-
:name (:first_name and :last_name in the example).
|
90
|
-
|
91
|
-
To access the values of the paramters, the block defining the task
|
92
|
-
behaviour can now accept a second parameter:
|
93
|
-
|
94
|
-
task :name, :first_name, :last_name do |t, args|
|
95
|
-
puts "First name is #{args.first_name}"
|
96
|
-
puts "Last name is #{args.last_name}"
|
97
|
-
end
|
98
|
-
|
99
|
-
The first argument of the block "t" is always bound to the current
|
100
|
-
task object. The second argument "args" is an open-struct like object
|
101
|
-
that allows access to the task arguments. Extra command line
|
102
|
-
arguments to a task are ignored. Missing command line arguments are
|
103
|
-
given the nil value.
|
104
|
-
|
105
|
-
== Thanks
|
106
|
-
|
107
|
-
As usual, it was input from users that drove a alot of these changes. The
|
108
|
-
following people either contributed patches, made suggestions or made
|
109
|
-
otherwise helpful comments. Thanks to ...
|
110
|
-
|
111
|
-
* Jamis Buck (for comment formatting suggestions)
|
112
|
-
* Stephen Touset (for exit status patch).
|
113
|
-
|
114
|
-
-- Jim Weirich
|
@@ -1,165 +0,0 @@
|
|
1
|
-
= Rake 0.8.2 Released
|
2
|
-
|
3
|
-
Rake version 0.8.2 is a new release of rake that includes a number of
|
4
|
-
new features and numerous bug fixes.
|
5
|
-
|
6
|
-
== Changes
|
7
|
-
|
8
|
-
=== New Features in Version 0.8.2
|
9
|
-
|
10
|
-
* Switched from getoptlong to optparse (patches supplied by Edwin
|
11
|
-
Pratomo).
|
12
|
-
|
13
|
-
* The -T option will now attempt to dynamically sense the size of the
|
14
|
-
terminal. The -T output will only self-truncate if the output is a
|
15
|
-
tty. However, if RAKE_COLUMNS is explicitly set, it will be honored
|
16
|
-
in any case. (Patch provided by Gavin Stark).
|
17
|
-
|
18
|
-
* The following public methods have been added to rake task objects:
|
19
|
-
|
20
|
-
* task.clear -- Clear both the prerequisites and actions of the
|
21
|
-
target rake task.
|
22
|
-
* task.clear_prerequisites -- Clear all the existing prerequisites
|
23
|
-
from the target rake task.
|
24
|
-
* task.clear_actions -- Clear all the existing actions from the
|
25
|
-
target rake task.
|
26
|
-
* task.reenable -- Re-enable a task, allowing its actions to be
|
27
|
-
executed again if the task is invoked.
|
28
|
-
|
29
|
-
* Changed RDoc test task to have no default template. This makes it
|
30
|
-
easier for the tempate to pick up the template from the environment.
|
31
|
-
|
32
|
-
* Default values for task arguments can easily be specified with the
|
33
|
-
:with_defaults method. (Idea for default argument merging supplied
|
34
|
-
by (Adam Q. Salter)
|
35
|
-
|
36
|
-
=== Bug Fixes in Version 0.8.2
|
37
|
-
|
38
|
-
* Fixed bug in package task so that it will include the subdir
|
39
|
-
directory in the package for testing. (Bug found by Adam Majer)
|
40
|
-
|
41
|
-
* Fixed filename dependency order bug in test_inspect_pending and
|
42
|
-
test_to_s_pending. (Bug found by Adam Majer)
|
43
|
-
|
44
|
-
* Fixed check for file utils options to make them immune to the
|
45
|
-
symbol/string differences. (Patch supplied by Edwin Pratomo)
|
46
|
-
|
47
|
-
* Fixed bug with rules involving multiple source, where only the first
|
48
|
-
dependency of a rule has any effect (Patch supplied by Emanuel
|
49
|
-
Indermühle)
|
50
|
-
|
51
|
-
* FileList#clone and FileList#dup have better sematics w.r.t. taint
|
52
|
-
and freeze.
|
53
|
-
|
54
|
-
* Changed from using Mutex to Monitor. Evidently Mutex causes thread
|
55
|
-
join errors when Ruby is compiled with -disable-pthreads. (Patch
|
56
|
-
supplied by Ittay Dror)
|
57
|
-
|
58
|
-
* Fixed bug in makefile parser that had problems with extra spaces in
|
59
|
-
file task names. (Patch supplied by Ittay Dror)
|
60
|
-
|
61
|
-
== Other changes in Version 0.8.2
|
62
|
-
|
63
|
-
* Added ENV var to rake's own Rakefile to prevent OS X from including
|
64
|
-
extended attribute junk in the rake package tar file. (Bug found by
|
65
|
-
Adam Majer)
|
66
|
-
|
67
|
-
* Added a performance patch for reading large makefile dependency
|
68
|
-
files. (Patch supplied by Ittay Dror)
|
69
|
-
|
70
|
-
== What is Rake
|
71
|
-
|
72
|
-
Rake is a build tool similar to the make program in many ways. But
|
73
|
-
instead of cryptic make recipes, Rake uses standard Ruby code to
|
74
|
-
declare tasks and dependencies. You have the full power of a modern
|
75
|
-
scripting language built right into your build tool.
|
76
|
-
|
77
|
-
== Availability
|
78
|
-
|
79
|
-
The easiest way to get and install rake is via RubyGems ...
|
80
|
-
|
81
|
-
gem install rake (you may need root/admin privileges)
|
82
|
-
|
83
|
-
Otherwise, you can get it from the more traditional places:
|
84
|
-
|
85
|
-
Home Page:: http://rake.rubyforge.org/
|
86
|
-
Download:: http://rubyforge.org/project/showfiles.php?group_id=50
|
87
|
-
|
88
|
-
== Task Argument Examples
|
89
|
-
|
90
|
-
Prior to version 0.8.0, rake was only able to handle command line
|
91
|
-
arguments of the form NAME=VALUE that were passed into Rake via the
|
92
|
-
ENV hash. Many folks had asked for some kind of simple command line
|
93
|
-
arguments, perhaps using "--" to separate regular task names from
|
94
|
-
argument values on the command line. The problem is that there was no
|
95
|
-
easy way to associate positional arguments on the command line with
|
96
|
-
different tasks. Suppose both tasks :a and :b expect a command line
|
97
|
-
argument: does the first value go with :a? What if :b is run first?
|
98
|
-
Should it then get the first command line argument.
|
99
|
-
|
100
|
-
Rake 0.8.0 solves this problem by explicitly passing values directly
|
101
|
-
to the tasks that need them. For example, if I had a release task
|
102
|
-
that required a version number, I could say:
|
103
|
-
|
104
|
-
rake release[0.8.2]
|
105
|
-
|
106
|
-
And the string "0.8.2" will be passed to the :release task. Multiple
|
107
|
-
arguments can be passed by separating them with a comma, for example:
|
108
|
-
|
109
|
-
rake name[john,doe]
|
110
|
-
|
111
|
-
Just a few words of caution. The rake task name and its arguments
|
112
|
-
need to be a single command line argument to rake. This generally
|
113
|
-
means no spaces. If spaces are needed, then the entire rake +
|
114
|
-
argument string should be quoted. Something like this:
|
115
|
-
|
116
|
-
rake "name[billy bob, smith]"
|
117
|
-
|
118
|
-
(Quoting rules vary between operating systems and shells, so make sure
|
119
|
-
you consult the proper docs for your OS/shell).
|
120
|
-
|
121
|
-
=== Tasks that Expect Parameters
|
122
|
-
|
123
|
-
Parameters are only given to tasks that are setup to expect them. In
|
124
|
-
order to handle named parameters, the task declaration syntax for
|
125
|
-
tasks has been extended slightly.
|
126
|
-
|
127
|
-
For example, a task that needs a first name and last name might be
|
128
|
-
declared as:
|
129
|
-
|
130
|
-
task :name, :first_name, :last_name
|
131
|
-
|
132
|
-
The first argument is still the name of the task (:name in this case).
|
133
|
-
The next to argumements are the names of the parameters expected by
|
134
|
-
:name (:first_name and :last_name in the example).
|
135
|
-
|
136
|
-
To access the values of the paramters, the block defining the task
|
137
|
-
behaviour can now accept a second parameter:
|
138
|
-
|
139
|
-
task :name, :first_name, :last_name do |t, args|
|
140
|
-
puts "First name is #{args.first_name}"
|
141
|
-
puts "Last name is #{args.last_name}"
|
142
|
-
end
|
143
|
-
|
144
|
-
The first argument of the block "t" is always bound to the current
|
145
|
-
task object. The second argument "args" is an open-struct like object
|
146
|
-
that allows access to the task arguments. Extra command line
|
147
|
-
arguments to a task are ignored. Missing command line arguments are
|
148
|
-
given the nil value.
|
149
|
-
|
150
|
-
== Thanks
|
151
|
-
|
152
|
-
As usual, it was input from users that drove a alot of these changes. The
|
153
|
-
following people either contributed patches, made suggestions or made
|
154
|
-
otherwise helpful comments. Thanks to ...
|
155
|
-
|
156
|
-
* Edwin Pratomo
|
157
|
-
* Gavin Stark
|
158
|
-
* Adam Q. Salter
|
159
|
-
* Adam Majer
|
160
|
-
* Emanuel Indermühle
|
161
|
-
* Ittay Dror
|
162
|
-
* Bheeshmar Redheendran (for spending an afternoon with me debugging
|
163
|
-
windows issues)
|
164
|
-
|
165
|
-
-- Jim Weirich
|