assaf-buildr 1.3.3

data/rakelib/changelog.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.
+
+
+# Handling of CHANGELOG.
+namespace 'changelog' do
+
+  task 'check'=>'CHANGELOG' do
+    print 'Checking that CHANGELOG indicates most recent version and today\'s date ... '
+    expecting = "#{spec.version} (#{Time.now.strftime('%Y-%m-%d')})"
+    header = File.readlines('CHANGELOG').first.chomp
+    fail "Expecting CHANGELOG to start with #{expecting}, but found #{header} instead" unless expecting == header
+    puts 'OK'
+  end
+
+  file 'staged/CHANGES'=>'CHANGELOG' do |task|
+    # Read the changes for this release.
+    print 'Looking for changes between this release and previous one ... '
+    pattern = /(^(\d+\.\d+(?:\.\d+)?)\s+\(\d{4}-\d{2}-\d{2}\)\s*((:?^[^\n]+\n)*))/
+    changes = File.read('CHANGELOG').scan(pattern).inject({}) { |hash, set| hash[set[1]] = set[2] ; hash }
+    current = changes[spec.version.to_s]
+    fail "No changeset found for version #{spec.version}" unless current
+    File.open task.name, 'w' do |file|
+      file.write "#{spec.version} (#{Time.now.strftime('%Y-%m-%d')})\n"
+      file.write current
+    end
+    puts 'OK'
+  end
+
+  task 'wrapup'=>'CHANGELOG' 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('.')
+    print 'Adding new entry to CHANGELOG ... '
+    modified = "#{next_version} (Pending)\n\n" + File.read('CHANGELOG')
+    File.open 'CHANGELOG', 'w' do |file|
+      file.write modified
+    end
+    puts 'Done'
+  end
+
+end
+
+task 'stage:check'=>'changelog:check'
+task 'stage:prepare'=>'staged/CHANGES'
+task 'release:wrapup'=>'changelog:wrapup'

data/rakelib/doc.rake

@@ -0,0 +1,103 @@
+# 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/rdoctask'
+
+desc 'Generate RDoc documentation'
+rdoc = Rake::RDocTask.new('rdoc') do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = spec.name
+  rdoc.options  = spec.rdoc_options + ['--promiscuous']
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include spec.extra_rdoc_files
+end
+
+
+begin
+  gem 'allison'
+  rdoc.template = File.expand_path('lib/allison.rb', Gem.loaded_specs['allison'].full_gem_path)
+rescue LoadError
+  puts 'Please run rake setup to install the Allison RDoc template'
+  task 'setup' do
+    install_gem 'allison'
+  end
+  task 'stage:check' do
+    fail 'Please run rake setup to install the Allison RDoc template'
+  end
+end
+
+
+begin
+  require 'docter'
+  require 'docter/server'
+
+  #Docter.filter_for(:footnote) do |html|
+  #  html.gsub(/<p id="fn(\d+)">(.*?)<\/p>/, %{<p id="fn\\1" class="footnote">\\2</p>})
+  #end
+
+  collection = Docter.collection(spec.name).using('doc/site.toc.yaml').include('doc/pages', 'LICENSE', 'CHANGELOG')
+  # TODO:  Add coverage reports when we get them to run.
+  template   = Docter.template('doc/site.haml').
+    include('doc/css', 'doc/images', 'doc/scripts', 'reports/coverage', 'reports/specs.html', 'rdoc', 'print/buildr.pdf')
+
+  desc 'Run Docter server on port 3000'
+  Docter::Rake.serve 'docter', collection, template, :port=>3000
+
+  desc 'Generate Web site in directory site'
+  Docter::Rake.generate 'site', collection, template
+
+  Docter::Rake.generate 'print',
+    Docter.collection(spec.name).using('doc/print.toc.yaml').include('doc/pages'),
+    Docter.template('doc/print.haml').include('doc/css', 'doc/images'), :one_page
+
+  file('print/buildr.pdf'=>'print') do |task|
+    mkpath 'site'
+    sh 'prince', 'print/index.html', '-o', task.name, '--media=print' do |ok, res|
+      fail 'Failed to create PDF, see errors above' unless ok
+    end
+  end
+  task 'site'=>'print/buildr.pdf' do
+    cp 'print/buildr.pdf', 'site'
+  end
+
+  task 'site' do
+    print 'Checking that we have site documentation, RDoc and PDF ... '
+    fail 'No PDF generated, you need to install PrinceXML!' unless File.exist?('site/buildr.pdf')
+    fail 'No RDocs in site directory' unless File.exist?('site/rdoc/files/lib/buildr_rb.html')
+    fail 'No site documentation in site directory' unless File.exist?('site/index.html')
+    fail 'No specifications site directory' unless File.exist?('site/specs.html')
+    puts 'OK'
+  end
+
+  desc 'Produce PDF'
+  task 'pdf'=>'print/buildr.pdf' do |task|
+    sh 'open', 'print/buildr.pdf'
+  end
+
+  task 'clobber' do
+    rm_rf 'print'
+    rm_rf 'site'
+  end
+
+rescue LoadError
+  puts 'Please run rake setup to install the Docter document generation library'
+  task 'setup' do
+    install_gem 'docter', '~>1.1.3'
+  end
+  task 'stage:check' do
+    fail 'Please run rake setup to install the Docter document generation library'
+  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'
+
+
+desc 'Clean up all temporary directories used for running tests, creating documentation, packaging, etc.'
+task 'clobber'
+
+package = Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_tar = true
+  pkg.need_zip = true
+end
+
+desc 'Install the package locally'
+task 'install'=>['setup', "#{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 'Done'
+end
+
+desc 'Uninstall previously installed packaged'
+task 'uninstall' do |task|
+  print "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 'Done'
+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.
+  for dep in spec.dependencies
+    current = Gem::SourceInfoCache.search(dep, true, true).last
+    latest = Gem::SourceInfoCache.search(Gem::Dependency.new(dep.name, '>0'), true, true).last
+    puts "A new version of #{dep.name} is available, #{latest.version} replaces #{current.version}" if 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
+    dep_spec.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}"
+    for trans in transitive[dep]
+      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
+end
+
+task 'stage:check'=>'dependency'

data/rakelib/release.rake

@@ -0,0 +1,65 @@
+# 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.
+
+# Released files are placed in this directory first, and from there published to various servers.
+file 'published' do |task, args|
+  mkpath task.name
+  puts "Populating published directory from #{args.staging} ..."
+  sh 'rsync', '--progress', '--recursive', "#{args.staging}/", 'published'
+  puts 'Done'
+end
+
+task 'clobber' do
+  rm_rf 'published'
+end
+
+namespace 'release' do
+  task 'prepare'=>['setup', 'clobber', 'published']
+
+  task 'publish'
+
+  task 'wrapup'
+end
+
+desc "Make a release using previously staged files"
+task 'release'=>['release:prepare', 'release:publish', 'release:wrapup']
+
+
+task 'next_version' 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)
+    print "Updating #{ver_file} to next version number (#{next_version}) ... "
+    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 'Done'
+  end
+
+  spec_file = "#{spec.name}.gemspec"
+  if File.exist?(spec_file)
+    print "Updating #{spec_file} to next version number (#{next_version}) ... "
+    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 'Done'
+  end
+end
+
+task 'release:wrapup'=>'next_version'

data/rakelib/rspec.rake

@@ -0,0 +1,83 @@
+# 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'
+  task 'clobber' do
+    rm_f 'failed'
+    rm_rf 'reports'
+  end
+
+  desc 'Run all specs'
+  Spec::Rake::SpecTask.new('spec'=>'reports') do |task|
+    task.spec_files = Dir['spec/**/*_spec.rb']
+    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'=>'spec'
+
+  desc 'Run all failed examples from previous run'
+  Spec::Rake::SpecTask.new('failed') do |task|
+    task.spec_files = Dir['spec/**/*_spec.rb']
+    task.spec_opts = %w{--format specdoc --format failing_examples:failed --example failed --backtrace}    
+    task.spec_opts << '--colour' if $stdout.isatty
+  end
+
+  # TODO: Horribly broken!  Fix some other time.
+  desc 'Run RSpec and generate Spec and coverage reports (slow)'
+  Spec::Rake::SpecTask.new('coverage'=>'reports') do |task|
+    task.spec_files = Dir['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 << '--exclude / --include-file ^lib --include-file ^addon --text-summary'
+  end
+  file 'reports/coverage'=>'coverage'
+
+  # 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 'setup' do
+    install_gem 'win32console' if windows? && !RUBY_PLATFORM[/java/] # Colors for RSpec, only on Windows platform.
+  end
+
+rescue LoadError
+  puts 'Please run rake setup to install RSpec'
+  task 'stage:check' do
+    fail 'Please run rake setup to install RSpec'
+  end
+end
+
+
+task 'stage:prepare'=>'spec'
+task 'stage:prepare'=>RUBY_PLATFORM =~ /java/ ? 'spec:ruby' : 'spec:jruby' # Test the *other* platform

data/rakelib/rubyforge.rake

@@ -0,0 +1,53 @@
+# 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 'rubyforge'
+rescue LoadError
+  puts 'Please run rake setup to install the RubyForge gem'
+  task 'setup' do
+    install_gem 'rubyforge'
+  end
+  task 'release:check' do
+    fail 'Please run rake setup to install the RubyForge gem'
+  end
+end
+
+
+namespace 'rubyforge' do
+
+  file 'published/rubyforge'=>'published' do
+    mkdir 'published/rubyforge'
+    FileList['published/distro/*.{gem,tgz,zip}'].each do |pkg|
+      cp pkg, 'published/rubyforge/' + File.basename(pkg).sub(/-incubating/, '')
+    end
+  end
+
+  task 'release'=>'published/rubyforge' do |task|
+    changes = FileList['published/CHANGES'].first
+    files = FileList['published/rubyforge/*.{gem,tgz,zip}'].exclude(changes).existing
+    print "Uploading #{spec.version} to RubyForge ... "
+    rubyforge = RubyForge.new
+    rubyforge.configure
+    rubyforge.login 
+    rubyforge.userconfig.merge!('release_changes'=>changes,  'preformatted' => true) if changes
+    rubyforge.add_release spec.rubyforge_project.downcase, spec.name.downcase, spec.version.to_s, *files
+    puts 'Done'
+  end
+
+end
+
+task 'release:publish'=>'rubyforge:release'

data/rakelib/scm.rake

@@ -0,0 +1,49 @@
+# 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.
+
+
+# Handling of source control.
+namespace 'scm' do
+
+  task 'check' do
+    print 'Checking there are no local changes ... '
+    svn = `svn status`
+    fail "Cannot release unless all local changes are in SVN:\n#{svn}" unless svn.empty?
+    git = `git status`
+    fail "Cannot release unless all local changes are in Git:\n#{git}" if git[/^#\t/]
+    puts 'OK'
+  end
+
+  task 'tag' do
+    info = `svn info` + `git svn info` # Using either svn or git-svn
+    url = info[/^URL:/] && info.scan(/^URL: (.*)/)[0][0] 
+    break unless url
+    new_url = url.sub(/(trunk$)|(branches\/\w*)$/, "tags/#{spec.version}")
+    break if url == new_url
+    print "Tagging release as tags/#{spec.version} ... "
+    sh 'svn', 'copy', url, new_url, '-m', "Release #{spec.version}", :verbose=>false do |ok, res|
+      if ok
+        puts 'Done'
+      else
+        puts 'Could not create tag, please do it yourself!'
+        puts %{  svn copy #{url} #{new_url} -m "#{spec.version}"}
+      end
+    end
+  end
+
+end
+
+task 'stage:check'=>'scm:check'
+task 'release:wrapup'=>'scm:tag'