rake 10.1.1 → 10.2.0

data/README.rdoc

@@ -1,7 +1,12 @@
 = RAKE -- Ruby Make
 
-This package contains Rake, a simple ruby build program with capabilities
-similar to make.
+home :: https://github.com/jimweirich/rake
+bugs :: https://github.com/jimweirich/rake/issues
+
+== Description
+
+Rake is a Make-like program implemented in Ruby. Tasks and dependencies are
+specified in standard Ruby syntax.
 
 Rake has the following features:
 
@@ -81,7 +86,7 @@ Type "rake --help" for all available options.
 === Source Repository
 
 Rake is currently hosted at github. The github web page is
-http://github.com/jimweirich/rake. The public git clone URL is
+http://github.com/jimweirich/rake . The public git clone URL is
 
 * git://github.com/jimweirich/rake.git
 
@@ -103,10 +108,6 @@ Feature requests and bug reports can be made here
 
 * https://github.com/jimweirich/rake/issues
 
-Issues and bug reports can also be tracked here:
-
-* http://www.pivotaltracker.com/projects/28469
-
 == Online Resources
 
 === Rake References
@@ -135,8 +136,6 @@ other projects with similar (and not so similar) goals.
 * http://www.a-a-p.org -- Make in Python
 * http://www.aromatic.com/tools/jam.txt -- JAM, Java Automated Make
 * http://ant.apache.org -- The Ant project
-* http://ppt.perl.org/commands/make/index.html -- Make from the Perl
-  Power Tools implementation.
 * http://search.cpan.org/search?query=PerlBuildSystem -- The Perl Build System
 * http://rubydoc.info/gems/rant/0.5.7/frames -- Rant, another Ruby make tool.
 
@@ -174,7 +173,7 @@ jim dot weirich at gmail.com.
 = Other stuff
 
 Author::   Jim Weirich <jim.weirich@gmail.com>
-Requires:: Ruby 1.8.7 or later
+Requires:: Ruby 1.9 or later
 License::  Copyright 2003-2013 by Jim Weirich.
            Released under an MIT-style license.  See the MIT-LICENSE
            file included in the distribution.

data/Rakefile

@@ -7,7 +7,6 @@
 # MIT-LICENSE for details.
 
 require 'rbconfig'
-require 'rubygems'
 
 system_rake = File.join RbConfig::CONFIG['rubylibdir'], 'rake.rb'
 
@@ -16,359 +15,57 @@ if $".include? system_rake or $".grep(/rake\/name_space\.rb$/).empty? then
   exec Gem.ruby, '-Ilib', 'bin/rake', *ARGV
 end
 
-require 'rubygems/package_task'
+require 'hoe'
 
-require 'rake/clean'
-require 'rake/testtask'
+Hoe.plugin :minitest
+Hoe.plugin :travis
 
-begin
-  gem 'rdoc'
-  require 'rdoc/task'
-rescue Gem::LoadError
-end
-
-CLEAN.include('**/*.o', '*.dot', '**/*.rbc')
-CLOBBER.include('doc/example/main')
-CLOBBER.include('TAGS')
-CLOBBER.include('coverage', 'rcov_aggregate')
-
-# Prevent OS X from including extended attribute junk in the tar output
-ENV['COPY_EXTENDED_ATTRIBUTES_DISABLE'] = 'true'
-
-def announce(msg='')
-  STDERR.puts msg
-end
-
-# Determine the current version of the software
-
-if `ruby -Ilib ./bin/rake --version` =~ /rake, version ([0-9a-z.]+)$/
-  CURRENT_VERSION = $1
-else
-  CURRENT_VERSION = "0.0.0"
-end
+hoe = Hoe.spec 'rake' do
+  developer 'Eric Hodel', 'drbrain@segment7.net'
+  developer 'Jim Weirich', ''
 
-$package_version = CURRENT_VERSION
+  require_ruby_version     '>= 1.9'
+  require_rubygems_version '>= 1.3.2'
 
-SRC_RB = FileList['lib/**/*.rb']
+  dependency 'minitest', '~> 4.0', :developer
 
-# The default task is run if rake is given no explicit arguments.
+  license "MIT"
 
-desc "Default Task"
-task :default => :test
+  self.readme_file  = 'README.rdoc'
+  self.history_file = 'History.rdoc'
 
-# Test Tasks ---------------------------------------------------------
-
-Rake::TestTask.new do |t|
-  files = FileList['test/helper.rb', 'test/test_*.rb']
-  t.loader = :rake
-  t.test_files = files
-  t.libs << "."
-  t.warning = true
-end
-
-begin
-  require 'rcov/rcovtask'
-  IGNORE_COVERAGE_IN = FileList[
-    'lib/rake/rdoctask.rb',
-    'lib/rake/testtask.rb',
-    'lib/rake/packagetask.rb',
-    'lib/rake/clean.rb',
+  self.extra_rdoc_files.concat FileList[
+    'MIT-LICENSE',
+    'doc/**/*.rdoc'
   ]
 
-  unless File::ALT_SEPARATOR
-    IGNORE_COVERAGE_IN.include(
-      'lib/rake/alt_system.rb',
-      'lib/rake/win32.rb')
-  end
-
-  Rcov::RcovTask.new do |t|
-    t.libs << "test"
-    t.rcov_opts = [
-      '-xRakefile', '-xrakefile', '-xpublish.rf',
-      '-xlib/rake/contrib', '-x/Library', '-x.rvm',
-      '--text-report',
-      '--sort coverage'
-    ] + FileList['rakelib/*.rake'].pathmap("-x%p") +
-      IGNORE_COVERAGE_IN.map { |fn| "-x#{fn}" }
-    t.test_files = FileList[
-      'test/lib/*_test.rb',
-      'test/contrib/*_test.rb',
-      'test/functional/*_test.rb'
-    ]
-    t.output_dir = 'coverage'
-    t.verbose = true
-  end
-rescue LoadError
-  task :rcov do
-    puts "RCov is not available"
-  end
-end
-
-# CVS Tasks ----------------------------------------------------------
-
-# Install rake using the standard install.rb script.
-
-desc "Install the application"
-task :install do
-  ruby "install.rb"
-end
-
-# Create a task to build the RDOC documentation tree.
-
-BASE_RDOC_OPTIONS = [
-  '--line-numbers', '--show-hash',
-  '--main', 'README.rdoc',
-  '--title', 'Rake -- Ruby Make'
-]
-
-if defined?(RDoc::Task) then
-  RDoc::Task.new do |rdoc|
-    rdoc.rdoc_dir = 'html'
-    rdoc.title    = "Rake -- Ruby Make"
-    rdoc.options = BASE_RDOC_OPTIONS.dup
-
-    rdoc.rdoc_files.include('README.rdoc', 'MIT-LICENSE', 'TODO', 'CHANGES')
-    rdoc.rdoc_files.include('lib/**/*.rb', 'doc/**/*.rdoc')
-    rdoc.rdoc_files.exclude(/\bcontrib\b/)
-  end
-else
-  warn "RDoc 2.4.2+ is required to build documentation"
-end
-
-# ====================================================================
-# Create a task that will package the Rake software into distributable
-# tar, zip and gem files.
-
-PKG_FILES = FileList[
-  '.gemtest',
-  'install.rb',
-  'CHANGES',
-  'MIT-LICENSE',
-  'README.rdoc',
-  'Rakefile',
-  'TODO',
-  'bin/rake',
-  'lib/**/*.rb',
-  'test/**/*.rb',
-  'doc/**/*'
-]
-PKG_FILES.exclude('doc/example/*.o')
-PKG_FILES.exclude('TAGS')
-PKG_FILES.exclude(%r{doc/example/main$})
-
-if ! defined?(Gem)
-  puts "Package Target requires RubyGems"
-else
-  SPEC = Gem::Specification.new do |s|
-    s.name = 'rake'
-    s.version = $package_version
-    s.summary = "Ruby based make-like utility."
-    s.license = "MIT"
-    s.description = <<-EOF.delete "\n"
-Rake is a Make-like program implemented in Ruby. Tasks and dependencies are
-specified in standard Ruby syntax.
-    EOF
-
-    s.required_ruby_version = '>= 1.8.6'
-    s.required_rubygems_version = '>= 1.3.2'
-    s.add_development_dependency 'minitest', '~> 2.1'
-
-    s.files = PKG_FILES.to_a
-
-    s.executables = ["rake"]
-
-    s.extra_rdoc_files = FileList[
-      'README.rdoc',
-      'MIT-LICENSE',
-      'TODO',
-      'CHANGES',
-      'doc/**/*.rdoc'
-    ]
-
-    s.rdoc_options = BASE_RDOC_OPTIONS
-
-    s.author = "Jim Weirich"
-    s.email = "jim.weirich@gmail.com"
-    s.homepage = "http://github.com/jimweirich/rake"
-  end
-
-  Gem::PackageTask.new(SPEC) do |pkg|
-    pkg.need_zip = true
-    pkg.need_tar = true
-  end
-
-  file "rake.gemspec" => ["Rakefile", "lib/rake.rb"] do |t|
-    require 'yaml'
-    open(t.name, "w") { |f| f.puts SPEC.to_yaml }
-  end
-
-  desc "Create a stand-alone gemspec"
-  task :gemspec => "rake.gemspec"
-end
-
-# Misc tasks =========================================================
-
-def count_lines(filename)
-  lines = 0
-  codelines = 0
-  open(filename) { |f|
-    f.each do |line|
-      lines += 1
-      next if line =~ /^\s*$/
-      next if line =~ /^\s*#/
-      codelines += 1
-    end
-  }
-  [lines, codelines]
-end
-
-def show_line(msg, lines, loc)
-  printf "%6s %6s   %s\n", lines.to_s, loc.to_s, msg
-end
-
-desc "Count lines in the main rake file"
-task :lines do
-  total_lines = 0
-  total_code = 0
-  show_line("File Name", "LINES", "LOC")
-  SRC_RB.each do |fn|
-    lines, codelines = count_lines(fn)
-    show_line(fn, lines, codelines)
-    total_lines += lines
-    total_code  += codelines
-  end
-  show_line("TOTAL", total_lines, total_code)
-end
-
-# Define an optional publish target in an external file.  If the
-# publish.rf file is not found, the publish targets won't be defined.
-
-load "publish.rf" if File.exist? "publish.rf"
-
-# Support Tasks ------------------------------------------------------
-
-RUBY_FILES = FileList['**/*.rb'].exclude('pkg')
-
-desc "Look for TODO and FIXME tags in the code"
-task :todo do
-  RUBY_FILES.egrep(/#.*(FIXME|TODO|TBD)/)
-end
-
-desc "List all ruby files"
-task :rubyfiles do
-  puts RUBY_FILES
-  puts FileList['bin/*'].exclude('bin/*.rb')
-end
-task :rf => :rubyfiles
-
-# --------------------------------------------------------------------
-# Creating a release
-
-def plugin(plugin_name)
-  require "rake/plugins/#{plugin_name}"
-end
-
-task :noop
-#plugin "release_manager"
-
-desc "Make a new release"
-task :release, [:rel, :reuse, :reltest] => [
-    :prerelease,
-    :clobber,
-    :test,
-    :update_version,
-    :package,
-    :tag
-  ] do
-  announce
-  announce "**************************************************************"
-  announce "* Release #{$package_version} Complete."
-  announce "* Packages ready to upload."
-  announce "**************************************************************"
-  announce
+  self.clean_globs += [
+    '**/*.o',
+    '**/*.rbc',
+    '*.dot',
+    'TAGS',
+    'doc/example/main',
+  ]
 end
 
-# Validate that everything is ready to go for a release.
-task :prerelease, :rel, :reuse, :reltest do |t, args|
-  $package_version = args.rel
-  announce
-  announce "**************************************************************"
-  announce "* Making RubyGem Release #{$package_version}"
-  announce "* (current version #{CURRENT_VERSION})"
-  announce "**************************************************************"
-  announce
+hoe.test_prelude = 'gem "minitest", "~> 4.0"'
 
-  # Is a release number supplied?
-  unless args.rel
-    fail "Usage: rake release[X.Y.Z] [REUSE=tag_suffix]"
-  end
+# Use custom rdoc task due to existence of doc directory
 
-  # Is the release different than the current release.
-  # (or is REUSE set?)
-  if $package_version == CURRENT_VERSION && ! args.reuse
-    fail "Current version is #{$package_version}, must specify REUSE=tag_suffix to reuse version"
-  end
+Rake::Task['docs'].clear
+Rake::Task['clobber_docs'].clear
 
-  # Are all source files checked in?
-  if args.reltest
-    announce "Release Task Testing, skipping checked-in file test"
-  else
-    announce "Checking for unchecked-in files..."
-    data = `svn st`
-    unless data =~ /^$/
-      abort "svn status is not clean ... do you have unchecked-in files?"
-    end
-    announce "No outstanding checkins found ... OK"
-  end
-end
+require 'rdoc/task'
 
-task :update_version, [:rel, :reuse, :reltest] => [:prerelease] do |t, args|
-  if args.rel == CURRENT_VERSION
-    announce "No version change ... skipping version update"
-  else
-    announce "Updating Rake version to #{args.rel}"
-    open("lib/rake.rb") do |rakein|
-      open("lib/rake.rb.new", "w") do |rakeout|
-        rakein.each do |line|
-          if line =~ /^RAKEVERSION\s*=\s*/
-            rakeout.puts "RAKEVERSION = '#{args.rel}'"
-          else
-            rakeout.puts line
-          end
-        end
-      end
-    end
-    mv "lib/rake.rb.new", "lib/rake.rb"
-    if args.reltest
-      announce "Release Task Testing, skipping commiting of new version"
-    else
-      sh %{svn commit -m "Updated to version #{args.rel}" lib/rake.rb} # "
-    end
-  end
-end
+RDoc::Task.new :rdoc => 'docs', :clobber_rdoc => 'clobber_docs' do |doc|
+  doc.main   = hoe.readme_file
+  doc.title  = 'Rake -- Ruby Make'
 
-desc "Tag all the CVS files with the latest release number (REL=x.y.z)"
-task :tag, [:rel, :reuse, :reltest] => [:prerelease] do |t, args|
-  reltag = "REL_#{args.rel.gsub(/\./, '_')}"
-  reltag << args.reuse.gsub(/\./, '_') if args.reuse
-  announce "Tagging Repository with [#{reltag}]"
-  if args.reltest
-    announce "Release Task Testing, skipping CVS tagging"
-  else
-    sh %{svn copy svn+ssh://rubyforge.org/var/svn/rake/trunk svn+ssh://rubyforge.org/var/svn/rake/tags/#{reltag} -m 'Commiting release #{reltag}'} ###'
-  end
-end
-
-# Require experimental XForge/Metaproject support.
+  rdoc_files = Rake::FileList.new %w[lib History.rdoc MIT-LICENSE doc]
+  rdoc_files.add hoe.extra_rdoc_files
 
-load 'xforge.rf' if File.exist?('xforge.rf')
+  doc.rdoc_files = rdoc_files
 
-desc "Where is the current directory.  This task displays the current rake directory"
-task :where_am_i do
-  puts Rake.original_dir
+  doc.rdoc_dir = 'html'
 end
 
-task :failure => :really_fail
-task :really_fail do
-  fail "oops"
-end