Reap is the original Ruby project assistant application, providing the various tools Ruby developers need to manage their projects, from scaffolding to releasing.
Reap was first started in way back 2005 as simple add-on to Rake. Since then it has gone through a number of transformations in an exploration for the best design. The final product, Reap 10, is culmination of this work.
NOTE: The current release is actually the 9.x series. This is a beta series before the final release of Reap 10.
This poor little video is my first crack at a screencast :) It's me creating a new project for my Cut-based AOP library. It's a bit scant, but it will at least give you a quick idea of what Reap does and how it works. Click here to enlarge...
Whew! It's been a long journey... Reap 10 is the culmination of a long exploration into the design of a Ruby project management tool, which I conducted on-and-off over the last couple of years. Reap started out as an add-on to Rake (similar to Hoe). But had soon transformed into a Rake-like build tool in it's own right. However, I wasn't satisfied with the design. So Reap remained semi-incomplete as I explored various redesigns. It truned out to be a tedious endeavor, and at times I came quite close to just putting the whole thing aside. But my own project management requirements kept drawing me back. A good thing too. All the work has finally paid off. Reap is proving to be an awesome tool.
Via RubyGems:
$ gem install reap
With the source code:
$ tar -xzf reap-x.y.z.tar.gz
$ cd reap-x.y.z
$ sudo setup.rb
Microsoft Windows users, you'll have to use ruby setup instead.
Usage is fairly straight forward. Primarily it involves running the desired reap command. Reap provides its functions through a set of executables. Using standard tab completion one can easily see the commands Reap provides.
$ reap- reap-announce reap-install-gem reap-package-tgz reap-stats reap-check-load reap-log reap-package-zip reap-test reap-check-syntax reap-log-changes reap-prepare reap-test-cross reap-clean reap-log-notes reap-publish reap-test-load reap-clobber reap-make reap-release reap-test-solo reap-doc reap-make-clean reap-rollout reap-uninstall reap-doc-rdoc reap-make-distclean reap-scaffold reap-uninstall-gem reap-doc-ri reap-make-extconf reap-scm-branch reap-version reap-init reap-make-static reap-scm-tag reap-inspect reap-package reap-spec reap-install reap-package-gem reap-spec-doc
For detailed usage documentation, please refer to the tutorial and RDocs.
Reap is hosted by Rubyforge at http://reap.rubyforge.org.
This project's SVN repository can be checked out through anonymous access with the following command(s).
svn checkout svn://rubyforge.org/var/svn/proutils/reap svn checkout http://proutils.rubyforge.org/svn/reap
Only project developers can access the SVN tree via this method. SSH must be installed on your client machine. Substitute developername with the proper values. Enter your site password when prompted.
svn checkout svn+ssh://developername@rubyforge.org/var/svn/proutils/reap
Special thanks to Mikel Lansaar (TMail) for being the first guinea pig... I mean beta tester ;) And thanks to Peter Van Broekhoven, as always, for his ongoing encouragment.
Reap, Copyright © 2007 Tiger Ops
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.