buildr4osgi 0.9.0

data/rakelib/checks.rake

@@ -0,0 +1,57 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+desc "Check that source files contain the Apache license"
+task :license=>FileList["**/*.{rb,rake,java,gemspec,buildfile}", 'Rakefile'] do |task|
+  puts "Checking that files contain the Apache license ... "
+  required = task.prerequisites.select { |fn| File.file?(fn) }
+  missing = required.reject { |fn| 
+    comments = File.read(fn).scan(/(\/\*(.*?)\*\/)|^#\s+(.*?)$|^-#\s+(.*?)$|<!--(.*?)-->/m).
+      map { |match| match.compact }.flatten.join("\n")
+    comments =~ /Licensed to the Apache Software Foundation/ && comments =~ /http:\/\/www.apache.org\/licenses\/LICENSE-2.0/
+  }
+  fail "#{missing.join(', ')} missing Apache License, please add it before making a release!" unless missing.empty?
+  puts "[x] Source files contain the Apache license"
+end
+
+
+desc "Look for new dependencies, check transitive dependencies"
+task :dependency do
+  puts "Checking that all dependencies are up to date ..."
+  # Find if anything has a more recent dependency.  These are not errors, just reports.
+  spec.dependencies.each do |dep|
+    current = Gem::SourceInfoCache.search(dep).last
+    latest = Gem::SourceInfoCache.search(Gem::Dependency.new(dep.name, '>0')).last
+    puts "A new version of #{dep.name} is available, #{latest.version} replaces #{current.version}" if (current && latest && latest.version > current.version)
+  end
+
+  # Returns orderd list of transitive dependencies for the given dependency.
+  transitive = lambda { |depend|
+    dep_spec = Gem::SourceIndex.from_installed_gems.search(depend).last
+    fail "No specification for dependency #{depend}" unless dep_spec
+    dep_spec.runtime_dependencies.map { |trans| transitive[trans].push(trans) }.flatten.uniq }
+  # For each dependency, make sure *all* its transitive dependencies are listed
+  # as a Buildr dependency, and order is preserved.
+  spec.dependencies.each_with_index do |dep, index|
+    puts "checking #{dep.name}"
+    transitive[dep].each do |trans|
+      matching = spec.dependencies.find { |existing| trans =~ existing }
+      fail "#{trans} required by #{dep} and missing from spec" unless matching
+      fail "#{trans} must come before #{dep} in dependency list" unless spec.dependencies.index(matching) < index
+    end
+  end
+  puts "[X] Checked all dependencies are up to date and transitive dependencies are correctly ordered"
+end

data/rakelib/doc.rake

@@ -0,0 +1,92 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+task 'doc:setup'
+begin # For the Web site, we use the SDoc RDoc generator/theme (http://github.com/voloko/sdoc/)
+  require 'sdoc'
+rescue LoadError
+  puts "Buildr uses the SDoc RDoc generator/theme. You can install it by running rake doc:setup"
+  task('doc:setup') { install_gem 'voloko-sdoc', :source=>'http://gems.github.com' }
+end
+
+
+require 'rake/rdoctask'
+
+desc "Generate RDoc documentation in rdoc/"
+Rake::RDocTask.new :rdoc do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = spec.name
+  rdoc.options  = spec.rdoc_options.clone
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include spec.extra_rdoc_files
+end
+
+
+begin
+  require 'rakelib/jekylltask'
+
+  desc "Generate Buildr documentation in _site/"
+  JekyllTask.new :jekyll do |task|
+    task.source = 'doc'
+    task.target = '_site'
+  end
+
+rescue LoadError
+  puts "Buildr uses the mojombo-jekyll to generate the Web site. You can install it by running rake doc:setup"
+  task 'doc:setup' do
+    install_gem 'mojombo-jekyll', :source=>'http://gems.github.com', :version=>'0.5.4'
+    if `pygmentize -V`.empty?
+      args = %w{easy_install Pygments}
+      args.unshift 'sudo' unless Config::CONFIG['host_os'] =~ /windows/
+      sh *args
+    end
+  end
+end
+
+
+desc "Generate Buildr documentation as buildr.pdf"
+file 'buildr.pdf'=>'_site' do |task|
+  pages = File.read('_site/preface.html').scan(/<li><a href=['"]([^'"]+)/).flatten.map { |f| "_site/#{f}" }
+  sh 'prince', '--input=html', '--no-network', '--log=prince_errors.log', "--output=#{task.name}", '_site/preface.html', *pages
+end
+
+desc "Build a copy of the Web site in the ./_site"
+task :site=>['_site', :rdoc, '_reports/specs.html', '_reports/coverage', 'buildr.pdf'] do
+  cp_r 'rdoc', '_site'
+  fail 'No RDocs in site directory' unless File.exist?('_site/rdoc/files/lib/buildr_rb.html')
+  cp '_reports/specs.html', '_site'
+  cp_r '_reports/coverage', '_site'
+  fail 'No coverage report in site directory' unless File.exist?('_site/coverage/index.html')
+  cp 'CHANGELOG', '_site'
+  cp 'buildr.pdf', '_site'
+  fail 'No PDF in site directory' unless File.exist?('_site/buildr.pdf')
+  puts 'OK'
+end
+
+# Publish prerequisites to Web site.
+task 'publish'=>:site do
+  target = "people.apache.org:/www/#{spec.name}.apache.org/"
+  puts "Uploading new site to #{target} ..."
+  sh 'rsync', '--progress', '--recursive', '--delete', '_site/', target
+  sh 'ssh', 'people.apache.org', 'chmod', '-R', 'g+w', "/www/#{spec.name}.apache.org/*"
+  puts "Done"
+end
+
+task :clobber do
+  rm_rf '_site'
+  rm_f 'buildr.pdf'
+  rm_f 'prince_errors.log'
+end

data/rakelib/jekylltask.rb

@@ -0,0 +1,120 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+gem 'mojombo-jekyll', '~> 0.5.2' # skip past some buggy versions
+require 'rake/tasklib'
+require 'jekyll'
+
+
+class JekyllTask < Rake::TaskLib
+  def initialize(name=:jekyll)  # :yield: self
+    @name = name
+    @source = name
+    @target = name
+    yield self if block_given?
+    task name, :auto, :needs=>[@source] do |task, args|
+      generate args.auto
+    end
+    if @source != @target
+      file @target=>FileList["#{@source}/**/*"] do
+        generate
+      end
+      task 'clobber' do
+        rm_rf @target
+      end
+    end
+  end
+
+  attr_accessor :source
+  attr_accessor :target
+
+  def generate(auto = false)
+    options = { 'source'=>source, 'destination'=>target }
+    options = Jekyll.configuration(options)
+    site = Jekyll::Site.new(options)
+
+    if auto
+      require 'directory_watcher'
+      puts "Auto generating: just edit a page and save, watch the console to see when we're done regenerating pages"
+      dw = DirectoryWatcher.new(source)
+      dw.interval = 1
+      dw.glob = Dir.chdir(source) do
+        dirs = Dir['*'].select { |x| File.directory?(x) }
+        dirs -= [target]
+        dirs = dirs.map { |x| "#{x}/**/*" }
+        dirs += ['*']
+      end
+      dw.start
+      dw.add_observer do |*args|
+        t = Time.now.strftime("%Y-%m-%d %H:%M:%S")
+        puts "[#{t}] regeneration: #{args.size} files changed"
+        site.process
+        puts "Done"
+      end
+      loop { sleep 1 }
+    else
+      puts "Generating documentation in #{target}"
+      site.process
+      touch target
+    end
+  end
+end
+
+
+module TocFilter
+  def toc(input)
+    input.scan(/<(h2)(?:>|\s+(.*?)>)([^<]*)<\/\1\s*>/mi).inject(%{<ol class="toc">}) { |toc, entry|
+      id = entry[1][/^id=(['"])(.*)\1$/, 2]
+      title = entry[2].gsub(/<(\w*).*?>(.*?)<\/\1\s*>/m, '\2').strip
+      toc << %{<li><a href="##{id}">#{title}</a></li>}
+    } << "</ol>"
+  end
+end
+Liquid::Template.register_filter(TocFilter)
+
+
+
+# Under Ruby 1.9 [a,b,c].to_s doesn't join the array first. (Jekyll 0.5.2 requires this)
+module Jekyll
+  class HighlightBlock < Liquid::Block
+    def render(context)
+      if context.registers[:site].pygments
+        render_pygments(context, super.join)
+      else
+        render_codehighlighter(context, super.join)
+      end
+    end
+  end
+end
+
+# Ruby 1.9 has sane closure scoping which manages to mess Liquid filters. (Liquid 2.0.0 requires this)
+module Liquid
+  class Variable
+    def render(context)
+      return '' if @name.nil?
+      @filters.inject(context[@name]) do |output, filter|
+        filterargs = filter[1].to_a.collect do |a|
+         context[a]
+        end
+        begin
+          context.invoke(filter[0], output, *filterargs)
+        rescue FilterNotFound
+          raise FilterNotFound, "Error - filter '#{filter[0]}' in '#{@markup.strip}' could not be found."
+        end
+      end
+    end
+  end
+end

data/rakelib/package.rake

@@ -0,0 +1,73 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+require 'rake/gempackagetask'
+
+
+package = Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_tar = true
+  pkg.need_zip = true
+end
+
+desc "Install Buildr from source"
+task :install=>["#{package.package_dir}/#{package.gem_file}"] do |task|
+  print "Installing #{spec.name} ... "
+  args = Config::CONFIG['ruby_install_name'], '-S', 'gem', 'install', "#{package.package_dir}/#{package.gem_file}"
+  args.unshift('sudo') if sudo_needed?
+  sh *args
+  puts "[x] Installed Buildr #{spec.version}"
+end
+
+desc "Uninstall previous rake install"
+task :uninstall do |task|
+  puts "Uninstalling #{spec.name} ... "
+  args = Config::CONFIG['ruby_install_name'], '-S', 'gem', 'uninstall', spec.name, '--version', spec.version.to_s
+  args.unshift('sudo') if sudo_needed?
+  sh *args
+  puts "[x] Uninstalled Buildr #{spec.version}"
+end
+
+
+desc "Compile Java libraries used by Buildr"
+task :compile do
+  puts "Compiling Java libraries ..."
+  args = Config::CONFIG['ruby_install_name'], File.expand_path(RUBY_PLATFORM[/java/] ? '_jbuildr' : '_buildr'), '--buildfile', 'buildr.buildfile', 'compile'
+  args << '--trace' if Rake.application.options.trace
+  sh *args
+end
+file Rake::GemPackageTask.new(spec).package_dir=>:compile
+file Rake::GemPackageTask.new(spec).package_dir_path=>:compile
+
+# We also need the other packages (JRuby if building on Ruby, and vice versa)
+# Must call new with block, even if block does nothing, otherwise bad things happen.
+@specs.values.each do |s|
+  Rake::GemPackageTask.new(s) { |task| }
+end
+
+
+desc "Upload snapshot packages over to people.apache.org"
+task :snapshot=>[:package] do
+  rm_rf '_snapshot' # Always start with empty directory
+  puts "Copying existing gems from Apache"
+  sh 'rsync', '--progress', '--recursive', 'people.apache.org:public_html/buildr/snapshot/', '_snapshot/'
+  puts "Copying new gems over"
+  cp FileList['pkg/{*.gem,*.tgz,*.zip}'], '_snapshot/gems'
+  puts "Generating gem index ..."
+  sh 'gem', 'generate_index', '--directory', '_snapshot'
+  puts "Copying gem and index back to Apache" 
+  sh 'rsync', '--progress', '--recursive', '_snapshot/', 'people.apache.org:public_html/buildr/snapshot/'
+end
+task(:clobber) { rm_rf '_snapshot' }

data/rakelib/release.rake

@@ -0,0 +1,149 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+task :release do
+  # First, we need to get all the staged files from Apache to _release.
+  mkpath '_release'
+  lambda do
+    url = "people.apache.org:~/public_html/#{spec.name}/#{spec.version}"
+    puts "Populating _release directory from #{url} ..."
+    sh 'rsync', '--progress', '--recursive', url, '_release'
+    puts "[X] Staged files are now in _release"
+  end.call
+
+
+  # Upload binary and source packages and new Web site
+  lambda do
+    target = "people.apache.org:/www/www.apache.org/dist/#{spec.name}/#{spec.version}"
+    puts "Uploading packages to www.apache.org/dist ..."
+    host, remote_dir = target.split(':')
+    sh 'ssh', host, 'rm', '-rf', remote_dir rescue nil
+    sh 'ssh', host, 'mkdir', remote_dir
+    sh 'rsync', '--progress', '--recursive', "_release/#{spec.version}/dist/", target
+    puts "[X] Uploaded packages to www.apache.org/dist"
+
+    target = "people.apache.org:/www/#{spec.name}.apache.org/"
+    puts "Uploading new site to #{spec.name}.apache.org ..."
+    sh 'rsync', '--progress', '--recursive', '--delete', "_release/#{spec.version}/site/", target
+    sh 'ssh', 'people.apache.org', 'chmod', '-R', 'g+w', "/www/#{spec.name}.apache.org/*"
+    puts "[X] Uploaded new site to #{spec.name}.apache.org"
+  end.call
+
+
+  # Upload binary and source packages to RubyForge.
+  lambda do
+    files = FileList["_release/#{spec.version}/dist/*.{gem,tgz,zip}"]
+    puts "Uploading #{spec.version} to RubyForge ... "
+    rubyforge = RubyForge.new.configure
+    rubyforge.login
+    rubyforge.userconfig.merge!('release_changes'=>"_release/#{spec.version}/CHANGES",  'preformatted' => true)
+    rubyforge.add_release spec.rubyforge_project.downcase, spec.name.downcase, spec.version.to_s, *files
+
+    puts "Posting news to RubyForge ... "
+    changes = File.read("_release/#{spec.version}/CHANGES")[/.*?\n(.*)/m, 1]
+    rubyforge.post_news spec.rubyforge_project.downcase, "Buildr #{spec.version} released",
+      "#{spec.description}\n\nNew in Buildr #{spec.version}:\n#{changes.gsub(/^/, '  ')}\n"
+    puts "[X] Uploaded gems and source files to #{spec.name}.rubyforge.org"
+  end.call
+
+
+  # Create an SVN tag for this release.
+  lambda do
+    info = `svn info` + `git svn info` # Using either svn or git-svn
+    if url = info[/^URL:/] && info.scan(/^URL: (.*)/)[0][0] 
+      new_url = url.sub(/(trunk$)|(branches\/\w*)$/, "tags/#{spec.version}")
+      unless url == new_url
+        sh 'svn', 'copy', url, new_url, '-m', "Release #{spec.version}" do |ok, res|
+          if ok
+            puts "[X] Tagged this release as tags/#{spec.version} ... "
+          else
+            puts "Could not create tag, please do it yourself!"
+            puts %{  svn copy #{url} #{new_url} -m "Release #{spec.version}"}
+          end
+        end
+      end
+    end
+  end.call
+
+
+  # Update CHANGELOG to next release number.
+  lambda do 
+    next_version = spec.version.to_s.split('.').map { |v| v.to_i }.
+      zip([0, 0, 1]).map { |a| a.inject(0) { |t,i| t + i } }.join('.')
+    modified = "#{next_version} (Pending)\n\n" + File.read('CHANGELOG')
+    File.open 'CHANGELOG', 'w' do |file|
+      file.write modified
+    end
+    puts "[X] Updated CHANGELOG and added entry for next release"
+  end.call
+ 
+
+  # Update source files to next release number.
+  lambda do
+    next_version = spec.version.to_s.split('.').map { |v| v.to_i }.
+      zip([0, 0, 1]).map { |a| a.inject(0) { |t,i| t + i } }.join('.')
+
+    ver_file = "lib/#{spec.name}.rb"
+    if File.exist?(ver_file)
+      modified = File.read(ver_file).sub(/(VERSION\s*=\s*)(['"])(.*)\2/) { |line| "#{$1}#{$2}#{next_version}#{$2}" } 
+      File.open ver_file, 'w' do |file|
+        file.write modified
+      end
+      puts "[X] Updated #{ver_file} to next release"
+    end
+
+    spec_file = "#{spec.name}.gemspec"
+    if File.exist?(spec_file)
+      modified = File.read(spec_file).sub(/(s(?:pec)?\.version\s*=\s*)(['"])(.*)\2/) { |line| "#{$1}#{$2}#{next_version}#{$2}" } 
+      File.open spec_file, 'w' do |file|
+        file.write modified
+      end
+      puts "[X] Updated #{spec_file} to next release"
+    end
+  end.call
+
+ 
+  # Prepare release announcement email.
+  lambda do
+    changes = File.read("_release/#{spec.version}/CHANGES")[/.*?\n(.*)/m, 1]
+    email = <<-EMAIL
+To: users@buildr.apache.org, announce@apache.org
+Subject: [ANNOUNCE] Apache Buildr #{spec.version} released
+
+#{spec.description}
+
+New in this release:
+
+#{changes.gsub(/^/, '  ')}
+
+To learn more about Buildr and get started:
+http://buildr.apache.org/
+
+Thanks!
+The Apache Buildr Team
+
+    EMAIL
+    File.open 'announce-email.txt', 'w' do |file|
+      file.write email
+    end
+    puts "[X] Created release announce email template in 'announce-email.txt'"
+    puts email
+  end
+
+end
+
+
+task(:clobber) { rm_rf '_release' }

data/rakelib/rspec.rake

@@ -0,0 +1,73 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+begin
+  require 'spec/rake/spectask'
+  directory '_reports'
+
+  desc "Run all specs"
+  Spec::Rake::SpecTask.new :spec=>'_reports' do |task|
+    task.spec_files = FileList['spec/**/*_spec.rb']
+    task.spec_files.exclude('spec/groovy/*') if RUBY_PLATFORM[/java/]
+    task.spec_opts = %w{--format specdoc --format failing_examples:failed --format html:_reports/specs.html --loadby mtime --backtrace}    
+    task.spec_opts << '--colour' if $stdout.isatty
+  end
+  file('_reports/specs.html') { task(:spec).invoke }
+
+  desc 'Run all failed examples from previous run'
+  Spec::Rake::SpecTask.new :failed do |task|
+    task.spec_files = FileList['spec/**/*_spec.rb']
+    task.spec_opts = %w{--format specdoc --format failing_examples:failed --example failed --backtrace}    
+    task.spec_opts << '--colour' if $stdout.isatty
+  end
+
+  desc 'Run RSpec and generate Spec and coverage reports (slow)'
+  Spec::Rake::SpecTask.new :coverage=>'_reports' do |task|
+    task.spec_files = FileList['spec/**/*_spec.rb']
+    task.spec_opts = %W{--format progress --format failing_examples:failed --format html:_reports/specs.html --backtrace}    
+    task.spec_opts << '--colour' if $stdout.isatty
+    task.rcov = true
+    task.rcov_dir = '_reports/coverage'
+    task.rcov_opts = %w{--exclude / --include-file ^lib --text-summary}
+  end
+  file('_reports/coverage') { task(:coverage).invoke }
+
+
+  # Useful for testing with JRuby when using Ruby and vice versa.
+  namespace :spec do
+    desc "Run all specs specifically with Ruby"
+    task :ruby do
+      puts "Running test suite using Ruby ..."
+      sh 'ruby -S rake spec'
+    end
+
+    desc "Run all specs specifically with JRuby"
+    task :jruby do
+      puts "Running test suite using JRuby ..."
+      sh 'jruby -S rake spec'
+    end
+  end
+
+  task :clobber do
+    rm_f 'failed'
+    rm_rf '_reports'
+  end
+
+rescue LoadError
+  puts "Buildr uses RSpec. You can install it by running rake setup"
+  task(:setup) { install_gem 'rcov', :version=>'~>0.8' }
+  task(:setup) { install_gem 'win32console' if RUBY_PLATFORM[/win32/] } # Colors for RSpec, only on Windows platform.
+end

data/rakelib/setup.rake

@@ -0,0 +1,54 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+
+require 'jruby' if RUBY_PLATFORM[/java/]
+require 'rubygems/source_info_cache'
+
+RAKE_SUDO = case (ENV['RAKE_SUDO'] or 'yes').strip.downcase
+  when 'yes', 'true'
+    true
+  else
+    false
+end
+
+# Install the specified gem. Options include:
+# - :version -- Version requirement, e.g. '1.2' or '~> 1.2'
+# - :source  -- Gem repository, e.g. 'http://gems.github.com'
+def install_gem(name, options = {})
+  dep = Gem::Dependency.new(name, options[:version] || '>0')
+  if Gem::SourceIndex.from_installed_gems.search(dep).empty?
+    puts "Installing #{name} ..."
+    rb_bin = File.join(Config::CONFIG['bindir'], Config::CONFIG['ruby_install_name'])
+    args = []
+    args << 'sudo' << 'env' << "JAVA_HOME=#{ENV['JAVA_HOME']}" if sudo_needed? and RAKE_SUDO
+    args << rb_bin << '-S' << 'gem' << 'install' << name
+    args << '--version' << dep.version_requirements.to_s
+    args << '--source' << options[:source] if options[:source]
+    args << '--source' << 'http://gems.rubyforge.org'
+    args << '--install-dir' << ENV['GEM_HOME'] if ENV['GEM_HOME']
+    sh *args
+  end
+end
+
+
+# Setup environment for running this Rakefile (RSpec, Jekyll, etc).
+desc "If you're building from sources, run this task first to setup the necessary dependencies."
+task :setup do
+  missing = spec.dependencies.select { |dep| Gem::SourceIndex.from_installed_gems.search(dep).empty? }
+  missing.each do |dep|
+    install_gem dep.name, :version=>dep.version_requirements
+  end
+end