Version: 0.8.99.5
This package contains RemoteRake, a Rake clone with remote task execution.
RemoteRake has the following features:
-
Standard Rakefiles with the addition of the remote keyword.
-
Conditions cause a task’s execution to depend upon the prerequisites needed status (ie. not just true).
-
The decision to execute a task can be overridden with a proc.
Currently tested on:
-
ubuntu-10.04.1-server-i386 (ruby-1.8.7-p330, ruby-1.9.1-p378, ruby-1.9.2-p136)
-
Windows XP SP3 (ruby 1.8.7)
-
Mac OS X 10.6.5 (ruby 1.8.7)
-
OpenBSD 4.8 snapshot 20101224 (ruby 1.8.7)
Download and install rake with the following.
TODO gem install rrake
First, you must write a “Rakefile” file which contains the build rules. Here’s a simple example:
task :default => [:test] task :test do ruby "test/unittest.rb" end
This Rakefile has two tasks:
-
A task named “test”, which - upon invocation - will run a unit test file in Ruby.
-
A task named “default”. This task does nothing by itself, but it has exactly one dependency, namely the “test” task. Invoking the “default” task will cause Rake to invoke the “test” task as well.
Running the “rrake” command without any options will cause it to run the “default” task in the Rakefile:
% ls Rakefile test/ % rake (in /home/some_user/Projects/rake) ruby test/unittest.rb ....unit test output here...
Type “rrake –help” for all available options.
-
For details on RemoteRake’s command-line invocation, read doc/command_line_usage.rdoc
-
For details on writing Rakefiles, see doc/rakefile.rdoc.
-
For a glossary of terms, see doc/glossary.rdoc.
RemoteRake is currently hosted at github. The github web page is github.com/notro/rrake. The public git clone URL is
-
git://github.com/notro/rrake.git
If you wish to run the unit and functional tests that come with Rake:
-
Use the –development switch on gem install rrake to get the needed gems.
-
Install the ‘session’ gem in order to run the functional tests (doesn’t work on Windows and OpenBSD).
-
CD into the top project directory of rrake.
-
Type one of the following:
rrake -T # If you have a version of rrake installed ruby -Ilib bin/rrake -T # If you do not have a version of rrake installed.
Feature requests and bug reports can be made here
-
<TODO>
No account is needed for posting requests.
Issues and bug reports can be tracked here:
-
<TODO>
-
Rake Documentation Home: docs.rubyrake.org
-
Rake Project Page: rubyforge.org/projects/rake
-
Rake API Documents: rake.rubyforge.org
-
Rake Source Code Repo: github.com/jimweirich/rake
-
Rake Git Repo Clone URL: git://github.com/jimweirich/rake.git
-
Rake Issue Tracking: www.pivotaltracker.com/projects/28469
-
Rake Bug Reports: onestepback.org/cgi-bin/bugs.cgi?project=rake
-
Jim Weirich’s 2003 RubyConf presentation: onestepback.org/articles/buildingwithrake/
-
Martin Fowler’s article on Rake: martinfowler.com/articles/rake.html
-
Distributed Rake: A branch of Rake supporting automatic parallelizing of tasks. drake.rubyforge.org/
- Jim Weirich
-
For making a very versatile build tool.
- Matz
-
For making a very flexible and enjoyable language.
Rake is available under an MIT-style license.
:include: MIT-LICENSE
<TODO> The Rake homepage is rrake.rubyforge.org. You can find the Rake RubyForge page at rubyforge.org/projects/rrake.
Feel free to submit commits or feature requests. If you send a patch, remember to update the corresponding unit tests. If fact, I prefer new feature to be submitted in the form of new unit tests.
- Author
-
Noralf Tronnes <notro@tronnes.org>
- Requires
-
Ruby 1.8.7 or later
- License
-
Copyright 2003-2010 by Jim Weirich. Copyright 2010 by Noralf Tronnes. Released under an MIT-style license. See the MIT-LICENSE file included in the distribution.
This software is provided “as is” and without any express or implied warranties, including, without limitation, the implied warranties of merchantibility and fitness for a particular purpose.