= Buildr This is Buildr, the build system that doesn't suck. http://incubator.apache.org/buildr/ == Get Started === Install Buildr Buildr needs Ruby 1.8 or later and RubyGems 0.9 or later. Windows users can get the one-click Ruby installer, which includes the latest version of Ruby and RubyGems: http://rubyinstaller.rubyforge.org Make sure to set JAVA_HOME environment variable first, then: gem install buildr (Use sudo for Linux and OS/X) More installation and setup instructions available online http://incubator.apache.org/buildr/ === RTFM * Buildr documentation: http://incubator.apache.org/buildr/ * More about Rake: http://docs.rubyrake.org * Antwrap documentation: http://antwrap.rubyforge.org === Mailing list * Users: buildr-user@incubator.apache.org (subscribe: buildr-user-subscribe@incubator.apache.org, archive: http://mail-archives.apache.org/mod_mbox/incubator-buildr-user/ * Developers: buildr-dev@incubator.apache.org (subscribe: buildr-dev-subscribe@incubator.apache.org, archive: http://mail-archives.apache.org/mod_mbox/incubator-buildr-dev/ Create your own Buildfile and start living the life! == Where's My Ruby? Buildr needs Ruby 1.8 or later and RubyGems 0.9 or later. All other dependencies are installed when you run: gem install buildr === Windows Windows users can get the one-click Ruby installer, which includes the latest version of Ruby and RubyGems: http://rubyinstaller.rubyforge.org Before installing Buildr, please set the JAVA_HOME environment variable to point to your JDK distribution. Next, use Ruby Gem to install Buildr: > gem install buildr When prompted for a platform, select mswin32. === Linux, BSD, Cygwin On Linux/BSD/Cygwin, use your default package manager, for example, for Ubuntu: $ sudo apt-get install ruby $ sudo apt-get install ruby1.8-dev $ sudo apt-get install build-essential $ sudo apt-get install libopenssl-ruby Before installing Buildr, please set the JAVA_HOME environment variable to point to your JDK distribution. Next, use Ruby Gem to install Buildr: $ sudo env JAVA_HOME=$JAVA_HOME gem install buildr When prompted for a platform, select ruby. === OS/X Leopard includes the latest version of Ruby, if you are using Tiger or an older release, we recommend re-installing the latest: http://hivelogic.com/narrative/articles/ruby-rails-mongrel-mysql-osx To install Buildr: $ sudo gem install buildr When prompted for a platform, select ruby. == Living On the Edge You can check the latest sources from SVN: svn co http://svn.apache.org/repos/asf/incubator/buildr/trunk Or browse the SVN repository online: http://svn.apache.org/repos/asf/incubator/buildr To install Buildr locally from source: cd buildr rake install If the cutting edge doesn't work, make sure to check the CHANGELOG, to see which changes might have broken your build. To run all the test cases: rake spec == Disclaimer :include:DISCLAIMER == License :include:LICENSE == Third-party dependencies Even though those dependencies aren't shipped with Buildr, Buildr needs the third-party libraries listed below to run. According licenses are bundled under the etc/legal directory (when available). * Rake - http://rubyforge.org/projects/rake Licensed under MIT/X Consortium Copyright 2003, 2004 by Jim Weirich. * Builder - http://rubyforge.org/projects/builder Licensed under MIT/X Consortium Copyright 2004 by Jim Weirich (jim@weirichhouse.org). * net-ssh - http://rubyforge.org/projects/net-ssh Licensed under BSD Copyright 2004, Jamis Buck (jamis@37signals.com) * rubyzip - http://rubyforge.org/projects/rubyzip Licensed under the Ruby License Authors: Thomas Sondergaard (thomas at sondergaard.cc), Technorama Ltd. (oss-ruby-zip at technorama.net), extra-field support contributed by Tatsuki Sugiura (sugi at nemui.org) * highline - http://rubyforge.org/projects/highline Licensed under the Ruby License Copyright 2005 Gray Productions. Copyright 2007 Jeremy Hinegardner. * antwrap - http://rubyforge.org/projects/antwrap Licensed under LGPL Copyright Caleb Powell 2007 * rspec - http://rubyforge.org/projects/rspec Licensed under MIT/X Consortium Copyright 2005-2007 The RSpec Development Team * xml-simple - http://rubyforge.org/projects/xml-simple Licensed under the Ruby License Copyright (c) 2003 Maik Schmidt * ruwiki (archive-tar-minitar) - http://rubyforge.org/projects/ruwiki/ Licensed under the Ruby License Copyright 2004 Mauricio Julio Fernández Pradier and Austin Ziegler