hoe 1.12.2 → 2.0.0

data/History.txt

@@ -1,3 +1,22 @@
+=== 2.0.0 / 2009-06-02
+
+* 3 major enhancements:
+
+  * Added a plugin system and extracted nearly everything into separate plugins.
+  * Added Clean, Debug, Deps, Flay, Flog, Inline, Package, Publish, Rake, Rcov, Signing, and Test plugins
+
+* 9 minor enhancements:
+
+  * Added Hoe::spec replacing old Hoe.new spec form. Now with DSL flavors!
+  * Added DEFAULT_CONFIG so plugins can add to it.
+  * Added pluggable! to declare your package depends on rubygems 1.3.1+.
+  * Changes are now included in the gem's description.
+  * Deprecated Hoe.new spec form.
+  * Filled in all the blanks on rdoc.
+  * Refactored nearly all the spec logic down to much smaller/cleaner pieces.
+  * Updated templates to use new form. No clue how best to update yours. :P
+  * Version number is now auto-searchable by grepping in all the files.
+
 === 1.12.2 / 2009-04-16
 
 * 1 minor enhancement:

data/Manifest.txt

@@ -4,6 +4,18 @@ README.txt
 Rakefile
 bin/sow
 lib/hoe.rb
+lib/hoe/clean.rb
+lib/hoe/debug.rb
+lib/hoe/deps.rb
+lib/hoe/flay.rb
+lib/hoe/flog.rb
+lib/hoe/inline.rb
+lib/hoe/package.rb
+lib/hoe/publish.rb
+lib/hoe/rake.rb
+lib/hoe/rcov.rb
+lib/hoe/signing.rb
+lib/hoe/test.rb
 template/.autotest.erb
 template/History.txt.erb
 template/Manifest.txt.erb

data/README.txt

@@ -6,58 +6,45 @@
 
 == DESCRIPTION:
 
-Hoe is a simple rake/rubygems helper for project Rakefiles. It
-generates all the usual tasks for projects including rdoc generation,
-testing, packaging, and deployment.
-
-Tasks Provided:
-
-* announce          - Create news email file and post to rubyforge.
-* audit             - Run ZenTest against the package.
-* check_extra_deps  - Install missing dependencies.
-* check_manifest    - Verify the manifest.
-* clean             - Clean up all the extras.
-* config_hoe        - Create a fresh ~/.hoerc file.
-* debug_gem         - Show information about the gem.
-* default           - Run the default task(s).
-* deps:email        - Print a contact list for gems dependent on this gem
-* deps:fetch        - Fetch all the dependent gems of this gem into tarballs
-* deps:list         - List all the dependent gems of this gem
-* docs              - Build the docs HTML Files
-* email             - Generate email announcement file.
-* flay              - Analyze for code duplication.
-* flog              - Analyze code complexity.
-* gem               - Build the gem file hoe-1.9.0.gem
-* generate_key      - Generate a key for signing your gems.
-* install_gem       - Install the package as a gem.
-* multi             - Run the test suite using multiruby.
-* package           - Build all the packages
-* post_blog         - Post announcement to blog.
-* post_news         - Post announcement to rubyforge.
-* publish_docs      - Publish RDoc to RubyForge.
-* rcov              - Analyze code coverage with tests
-* release           - Package and upload the release to rubyforge.
-* ridocs            - Generate ri locally for testing.
-* tasks             - Generate a list of tasks for doco.
-* test              - Run the test suite.
-* test_deps         - Show which test files fail when run alone.
+Hoe is a rake/rubygems helper for project Rakefiles. It helps generate
+rubygems and includes a dynamic plug-in system allowing for easy
+extensibility. Hoe ships with plug-ins for all your usual project
+tasks including rdoc generation, testing, packaging, and deployment.
+
+Plug-ins Provided:
+
+* Hoe::Clean
+* Hoe::Debug
+* Hoe::Deps
+* Hoe::Flay
+* Hoe::Flog
+* Hoe::Inline
+* Hoe::Package
+* Hoe::Publish
+* Hoe::RCov
+* Hoe::Signing
+* Hoe::Test
 
 See class rdoc for help. Hint: ri Hoe
 
 == FEATURES/PROBLEMS:
 
+* Includes a dynamic plug-in system allowing for easy extensibility.
+* Auto-intuits changes, description, summary, and version.
+* Uses a manifest for safe and secure deployment.
 * Provides 'sow' for quick project directory creation.
-* Make making and maintaining Rakefiles fun and easy.
+* Sow uses a simple ERB templating system allowing you to capture your
+  project patterns
 
 == SYNOPSIS:
 
   % sow [group] project
 
-or
+or:
 
   require 'hoe'
   
-  Hoe.new(projectname, version) do |p|
+  Hoe.spec projectname do
     # ... project specific data ...
   end
 

data/Rakefile

@@ -1,31 +1,24 @@
 # -*- ruby -*-
 
+$: << 'lib'
+
 require './lib/hoe.rb'
 
+# TODO:
+# Hoe.plugin :perforce
+# Hoe.plugin :minitest
+
 Hoe.add_include_dirs("../../minitest/dev/lib")
 
-Hoe.new("hoe", Hoe::VERSION) do |hoe|
-  hoe.rubyforge_name = "seattlerb"
+Hoe.spec "hoe" do
+  developer "Ryan Davis", "ryand-ruby@zenspider.com"
 
-  hoe.developer("Ryan Davis", "ryand-ruby@zenspider.com")
+  self.rubyforge_name = "seattlerb"
+  self.testlib        = :minitest
 
-  hoe.testlib = :minitest
-  hoe.blog_categories << "Seattle.rb" << "Ruby"
-end
+  blog_categories << "Seattle.rb" << "Ruby"
 
-desc "Generate a list of tasks for doco. RDOC=1 for commented output"
-task :tasks do
-  tasks = `rake -T`.scan(/rake (\w+)\s+# (.*)/)
-  tasks.reject! { |t,d| t =~ /^(clobber|tasks|re(package|docs))/ }
-  max   = tasks.map { |x,y| x.size }.max
-
-  tasks.each do |t,d|
-    if ENV['RDOC'] then
-      puts "# %-#{max+2}s %s" % [t + "::", d]
-    else
-      puts "* %-#{max}s - %s" % [t, d]
-    end
-  end
+  pluggable!
 end
 
 # vim: syntax=Ruby

data/bin/sow

@@ -67,11 +67,9 @@ if $d || $t then
   FileUtils.mv temp_dir, "#{project}/#{$d ? 'dev' : 'trunk'}", :verbose => true
 end
 
-WINDOZE = /mswin|mingw/ =~ RUBY_PLATFORM
-
 puts
 puts "... done, now go fix all occurrences of '#{XIF}':"
-if WINDOZE then
+if Hoe::WINDOZE then
   puts `findstr /N /S /C:#{XIF} #{project}\\*`
 else
   puts `find #{project} -type f | xargs grep -n #{XIF}`.gsub(/\A|\n/, "\n  ")

data/lib/hoe.rb

@@ -19,134 +19,57 @@ rescue Gem::LoadError
 end
 
 ##
-# hoe - a tool to help rake
-#
-# Hoe is a simple rake/rubygems helper for project Rakefiles. It
-# generates all the usual tasks for projects including rdoc generation,
-# testing, packaging, and deployment.
+# Hoe is a simple rake/rubygems helper for project Rakefiles. It helps
+# generate rubygems and includes a dynamic plug-in system allowing for
+# easy extensibility. Hoe ships with plug-ins for all your usual
+# project tasks including rdoc generation, testing, packaging, and
+# deployment.
 #
 # == Using Hoe
 #
 # === Basics
 #
-# Use this as a minimal starting point:
-#
-#   require 'hoe'
-#   require './lib/project.rb'
-#
-#   Hoe.new("project_name", Project::VERSION) do |p|
-#     p.rubyforge_name = "rf_project"
-#     p.developer("Joe Blow", "joe@example.com")
-#     # add other details here
-#   end
+# Sow generates a new project from scratch. Sow uses a simple ERB
+# templating system allowing you to capture patterns common to your
+# projects. Run `sow` and then see ~/.hoe_template for more info:
 #
-#   # add other tasks here
+#   % sow project_name
+#   ...
+#   % cd project_name
 #
-# === Tasks Provided:
-#
-# announce::           Create news email file and post to rubyforge.
-# audit::              Run ZenTest against the package.
-# check_extra_deps::   Install missing dependencies.
-# check_manifest::     Verify the manifest.
-# clean::              Clean up all the extras.
-# config_hoe::         Create a fresh ~/.hoerc file.
-# debug_gem::          Show information about the gem.
-# default::            Run the default task(s).
-# deps:email::         Print a contact list for gems dependent on this gem
-# deps:fetch::         Fetch all the dependent gems of this gem into tarballs
-# deps:list::          List all the dependent gems of this gem
-# docs::               Build the docs HTML Files
-# email::              Generate email announcement file.
-# flay::               Analyze for code duplication.
-# flog::               Analyze code complexity.
-# gem::                Build the gem file hoe-1.9.0.gem
-# generate_key::       Generate a key for signing your gems.
-# install_gem::        Install the package as a gem.
-# multi::              Run the test suite using multiruby.
-# package::            Build all the packages
-# post_blog::          Post announcement to blog.
-# post_news::          Post announcement to rubyforge.
-# publish_docs::       Publish RDoc to RubyForge.
-# rcov::               Analyze code coverage with tests
-# release::            Package and upload the release to rubyforge.
-# ridocs::             Generate ri locally for testing.
-# tasks::              Generate a list of tasks for doco.
-# test::               Run the test suite.
-# test_deps::          Show which test files fail when run alone.
+# and have at it.
 #
 # === Extra Configuration Options:
 #
-# Run +config_hoe+ to generate a new ~/.hoerc file. The file is a
-# YAML formatted config file with the following settings:
-#
-# exclude::             A regular expression of files to exclude from
-#                       +check_manifest+.
-# publish_on_announce:: Run +publish_docs+ when you run +release+.
-# signing_key_file::    Signs your gems with this private key.
-# signing_cert_file::   Signs your gem with this certificate.
-# blogs::               An array of hashes of blog settings.
-#
-# Run +config_hoe+ and see ~/.hoerc for examples.
-#
-# === Signing Gems:
-#
-# Run the 'generate_key' task.  This will:
-#
-# 1. Configure your ~/.hoerc.
-# 2. Generate a signing key and certificate.
-# 3. Install the private key and public certificate files into ~/.gem.
-# 4. Upload the certificate to RubyForge.
-#
-# Hoe will now generate signed gems when the package task is run.  If you have
-# multiple machines you build gems on, be sure to install your key and
-# certificate on each machine.
-#
-# Keep your private key secret!  Keep your private key safe!
-#
-# To make sure your gems are signed run:
+# Hoe maintains a config file for cross-project values. The file is
+# located at <tt>~/.hoerc</tt>. The file is a YAML formatted config file with
+# the following settings (extended by plugins):
 #
-#   rake package; tar tf pkg/yourproject-1.2.3.gem
+# exclude:: A regular expression of files to exclude from +check_manifest+.
 #
-# If your gem is signed you will see:
+# Run <tt>`rake config_hoe`</tt> and see ~/.hoerc for examples.
 #
-#   data.tar.gz
-#   data.tar.gz.sig
-#   metadata.gz
-#   metadata.gz.sig
+# == Extending Hoe
 #
-# === Platform awareness
+# Hoe can be extended via its plugin system. Hoe searches out all
+# installed files matching <tt>'hoe/*.rb'</tt> and loads them. Those files are
+# expected to define a module matching the file name. The module must
+# define a define task method and can optionally define an initialize
+# method. Both methods must be named to match the file. eg
 #
-# Hoe allows bundling of pre-compiled extensions in the +package+ task.
-#
-# To create a package for your current platform:
-#
-#   rake package INLINE=1
-#
-# This will force Hoe analize your +Inline+ already compiled
-# extensions and include them in your gem.
-#
-# If somehow you need to force a specific platform:
-#
-#   rake package INLINE=1 FORCE_PLATFORM=mswin32
-#
-# This will set the +Gem::Specification+ platform to the one indicated in
-# +FORCE_PLATFORM+ (instead of default Gem::Platform::CURRENT)
+#   module Hoe::Blah
+#     def initialize_blah # optional
+#       # ...
+#     end
 #
+#     def define_blah_tasks
+#       # ...
+#     end
+#   end
 
 class Hoe
-  VERSION = '1.12.2'
-  GEMURL = URI.parse 'http://gems.rubyforge.org' # for namespace :deps below
-
-  ruby_prefix = Config::CONFIG['prefix']
-  sitelibdir = Config::CONFIG['sitelibdir']
-
-  ##
-  # Configuration for the supported test frameworks for test task.
-
-  SUPPORTED_TEST_FRAMEWORKS = {
-    :testunit => "test/unit",
-    :minitest => "minitest/autorun",
-  }
+  # duh
+  VERSION = '2.0.0'
 
   ##
   # Used to add extra flags to RUBY_FLAGS.
@@ -162,62 +85,36 @@ class Hoe
   RUBY_FLAGS = ENV['RUBY_FLAGS'] || default_ruby_flags
 
   ##
-  # Used to add flags to test_unit (e.g., -n test_borked).
-  #
-  # eg FILTER="-n test_blah"
-
-  FILTER = ENV['FILTER'] || ENV['TESTOPTS']
+  # Default configuration values for .hoerc. Plugins should populate
+  # this on load.
 
-  # :stopdoc:
+  DEFAULT_CONFIG = {
+    "exclude" => /tmp$|CVS|\.svn|\.log$/,
+  }
 
-  DLEXT = Config::CONFIG['DLEXT']
+  ##
+  # True if you're a masochist developer. Used for building commands.
 
   WINDOZE = /mswin|mingw/ =~ RUBY_PLATFORM unless defined? WINDOZE
 
-  DIFF = if WINDOZE
-           'diff.exe'
-         else
-           if system("gdiff", __FILE__, __FILE__)
-             'gdiff' # solaris and kin suck
-           else
-             'diff'
-           end
-         end unless defined? DIFF
-
-  # :startdoc:
-
   ##
   # *MANDATORY*: The author(s) of the package. (can be array)
 
   attr_accessor :author
 
-  ##
-  # Populated automatically from the manifest. List of executables.
-
-  attr_accessor :bin_files # :nodoc:
-
-  ##
-  # *Optional*: An array of the project's blog categories. Defaults to project name.
-
-  attr_accessor :blog_categories
-
   ##
   # Optional: A description of the release's latest changes. Auto-populates.
 
   attr_accessor :changes
 
-  ##
-  # Optional: An array of file patterns to delete on clean.
-
-  attr_accessor :clean_globs
-
   ##
   # Optional: A description of the project. Auto-populates.
 
   attr_accessor :description
 
   ##
-  # Optional: What sections from the readme to use for auto-description. Defaults to %w(description).
+  # Optional: What sections from the readme to use for
+  # auto-description. Defaults to %w(description).
 
   attr_accessor :description_sections
 
@@ -243,46 +140,16 @@ class Hoe
 
   attr_accessor :extra_rdoc_files
 
-  ##
-  # Optional: flay threshold to determine threshold failure. [default: 1200-100]
-
-  attr_accessor :flay_threshold
-
-  ##
-  # Optional: flog threshold to determine threshold failure. [default: 1500-200]
-
-  attr_accessor :flog_threshold
-
   ##
   # Optional: The filename for the project history. [default: History.txt]
 
   attr_accessor :history_file
 
-  ##
-  # Populated automatically from the manifest. List of library files.
-
-  attr_accessor :lib_files # :nodoc:
-
-  ##
-  # Optional: Array of incompatible versions for multiruby filtering. Used as a regex.
-
-  attr_accessor :multiruby_skip
-
   ##
   # *MANDATORY*: The name of the release.
 
   attr_accessor :name
 
-  ##
-  # Optional: Should package create a tarball? [default: true]
-
-  attr_accessor :need_tar
-
-  ##
-  # Optional: Should package create a zipfile? [default: false]
-
-  attr_accessor :need_zip
-
   ##
   # Optional: A post-install message to be displayed when gem is installed.
 
@@ -293,26 +160,6 @@ class Hoe
 
   attr_accessor :readme_file
 
-  ##
-  # Optional: Name of RDoc destination directory on Rubyforge. [default: +name+]
-
-  attr_accessor :remote_rdoc_dir
-
-  ##
-  # Optional: RSpec dirs. [default: %w(spec lib)]
-
-  attr_accessor :rspec_dirs
-
-  ##
-  # Optional: RSpec options. [default: []]
-
-  attr_accessor :rspec_options
-
-  ##
-  # Optional: Flags for RDoc rsync. [default: "-av --delete"]
-
-  attr_accessor :rsync_args
-
   ##
   # Optional: The name of the rubyforge project. [default: name.downcase]
 
@@ -338,21 +185,11 @@ class Hoe
 
   attr_accessor :summary_sentences
 
-  ##
-  # Populated automatically from the manifest. List of tests.
-
-  attr_accessor :test_files # :nodoc:
-
   ##
   # Optional: An array of test file patterns [default: test/**/test_*.rb]
 
   attr_accessor :test_globs
 
-  ##
-  # Optional: What test library to require [default: :testunit]
-
-  attr_accessor :testlib
-
   ##
   # Optional: The url(s) of the project. (can be array). Auto-populates.
 
@@ -364,16 +201,41 @@ class Hoe
   attr_accessor :version
 
   ##
-  # Add extra dirs to both $: and RUBY_FLAGS (for test runs)
+  # Add extra dirs to both $: and RUBY_FLAGS (for test runs and rakefile deps)
 
   def self.add_include_dirs(*dirs)
     dirs = dirs.flatten
     $:.unshift(*dirs)
     s = File::PATH_SEPARATOR
-    Hoe::RUBY_FLAGS.sub!(/-I/, "-I#{dirs.join(s)}#{s}")
+    RUBY_FLAGS.sub!(/-I/, "-I#{dirs.join(s)}#{s}")
+  end
+
+  ##
+  # Find and load all plugin files.
+  #
+  # It is called at the end of hoe.rb
+
+  def self.load_plugins
+    loaded = {}
+
+    Gem.find_files("hoe/*.rb").each do |plugin|
+      name = File.basename plugin
+      next if loaded[name]
+      begin
+        load plugin
+        loaded[name] = true
+      rescue LoadError => e
+        warn "error loading #{plugin.inspect}: #{e.message}. skipping..."
+      end
+    end
   end
 
-  def self.normalize_names project
+  ##
+  # Normalize a project name into the project, file, and klass cases (?!?).
+  #
+  # no, I have no idea how to describe this. Does the thing with the stuff.
+
+  def self.normalize_names project # :nodoc:
     project   = project.tr('-', '_').gsub(/([A-Z])/, '_\1').downcase.sub(/^_/, '')
     klass     = project.gsub(/(?:^|_)([a-z])/) { $1.upcase }
     file_name = project
@@ -381,98 +243,50 @@ class Hoe
     return project, file_name, klass
   end
 
-  def normalize_deps deps
-    Array(deps).map { |o| String === o ? [o] : o }
-  end
+  ##
+  # Activate a plugin.
 
-  def missing name
-    warn "** #{name} is missing or in the wrong format for auto-intuiting."
-    warn "   run `sow blah` and look at its text files"
+  def self.plugin name
+    self.plugins << name
   end
 
-  def timebomb n, m, finis = '2010-04-01', start = '2009-03-14'
-    finis = Time.parse finis
-    start = Time.parse start
-    rest  = (finis - Time.now)
-    full  = (finis - start)
+  ##
+  # Return the list of activated plugins.
 
-    ((n - m) * rest / full).to_i + m
+  def self.plugins
+    @@plugins ||= []
   end
 
-  def initialize(name, version) # :nodoc:
-    self.name    = name
-    self.version = version
-
-    # Defaults
-    self.author               = []
-    self.blog_categories      = [name]
-    self.clean_globs          = %w(diff diff.txt email.txt ri deps .source_index
-                                   *.gem **/*~ **/.*~ **/*.rbc coverage*)
-    self.description_sections = %w(description)
-    self.email                = []
-    self.extra_deps           = []
-    self.extra_dev_deps       = []
-    self.extra_rdoc_files     = []
-    self.flay_threshold       = timebomb 1200, 100  # 80% of average :(
-    self.flog_threshold       = timebomb 1500, 1000 # 80% of average :(
-    self.history_file         = "History.txt"
-    self.multiruby_skip       = []
-    self.need_tar             = true
-    self.need_zip             = false
-    self.post_install_message = nil
-    self.readme_file          = "README.txt"
-    self.remote_rdoc_dir      = name
-    self.rspec_dirs           = %w(spec lib)
-    self.rspec_options        = []
-    self.rsync_args           = '-av --delete'
-    self.rubyforge_name       = name.downcase
-    self.spec_extras          = {}
-    self.summary_sentences    = 1
-    self.test_globs           = ['test/**/test_*.rb']
-    self.testlib              = :testunit
-
-    yield self if block_given?
+  ##
+  # Create a new hoe-specification executing the supplied block
 
-    # Intuit values:
+  def self.spec name, &block
+    spec = self.new name
+    spec.activate_plugins
+    spec.instance_eval(&block)
+    spec.post_initialize
+    spec # TODO: remove?
+  end
 
-    readme = File.read(readme_file).split(/^(=+ .*)$/)[1..-1] rescue ''
-    unless readme.empty? then
-      sections = readme.map { |s|
-        s =~ /^=/ ? s.strip.downcase.chomp(':').split.last : s.strip
-      }
-      sections = Hash[*sections]
-      desc = sections.values_at(*description_sections).join("\n\n")
-      summ = desc.split(/\.\s+/).first(summary_sentences).join(". ")
+  ##
+  # Activate plugin modules and add them to the current instance.
 
-      self.description ||= desc
-      self.summary     ||= summ
-      self.url         ||= readme[1].gsub(/^\* /, '').split(/\n/).grep(/\S+/)
-    else
-      missing readme_file
+  def activate_plugins
+    self.class.constants.reject { |n| n =~ /^[A-Z_]+$/ }.each do |name|
+      self.extend Hoe.const_get(name)
     end
 
-    self.changes ||= begin
-                       h = File.read(history_file)
-                       h.split(/^(===.*)/)[1..2].join.strip
-                     rescue
-                       missing history_file
-                       ''
-                     end
-
-    %w(email author).each do |field|
-      value = self.send(field)
-      if value.nil? or value.empty? then
-        if Time.now < Time.local(2008, 4, 1) then
-          warn "Hoe #{field} value not set - Fix by 2008-04-01!"
-          self.send "#{field}=", "doofus"
-        else
-          abort "Hoe #{field} value not set. aborting"
-        end
-      end
+    self.class.plugins.each do |plugin|
+      send "initialize_#{plugin}" rescue nil
     end
+  end
+
+  ##
+  # Add standard and user defined dependencies to the spec.
 
+  def add_dependencies
     hoe_deps = {
-      'rake' => ">= #{RAKEVERSION}",
+      'rake'      => ">= #{RAKEVERSION}",
       'rubyforge' => ">= #{::RubyForge::VERSION}",
     }
 
@@ -486,143 +300,37 @@ class Hoe
     else
       extra_dev_deps << ['hoe', ">= #{VERSION}"] unless hoe_deps.has_key? name
     end
-
-    define_tasks
   end
 
-  def developer name, email
-    self.author << name
-    self.email << email
-  end
-
-  def with_config # :nodoc:
-    rc = File.expand_path("~/.hoerc")
-    exists = File.exist? rc
-    config = exists ? YAML.load_file(rc) : {}
-    yield(config, rc)
-  end
-
-  def define_tasks # :nodoc:
-    default_tasks = []
-
-    if File.directory? "test" then
-      desc 'Run the test suite. Use FILTER or TESTOPTS to add flags/args.'
-      task :test do
-        ruby make_test_cmd
-      end
-
-      desc 'Run the test suite using multiruby.'
-      task :multi do
-        ruby make_test_cmd(:multi)
-      end
-
-      desc 'Show which test files fail when run alone.'
-      task :test_deps do
-        tests = Dir["test/**/test_*.rb"]  +  Dir["test/**/*_test.rb"]
-
-        paths = ['bin', 'lib', 'test'].join(File::PATH_SEPARATOR)
-        null_dev = WINDOZE ? '> NUL 2>&1' : '&> /dev/null'
-
-        tests.each do |test|
-          if not system "ruby -I#{paths} #{test} #{null_dev}" then
-            puts "Dependency Issues: #{test}"
-          end
-        end
-      end
-
-      default_tasks << :test
-    end
-
-    if File.directory? "spec" then
-      begin
-        require 'spec/rake/spectask'
-
-        desc "Run all specifications"
-        Spec::Rake::SpecTask.new(:spec) do |t|
-          t.libs = self.rspec_dirs
-          t.spec_opts = self.rspec_options
-        end
-      rescue LoadError
-        # do nothing
-      end
-      default_tasks << :spec
-    end
-
-    desc 'Run the default task(s).'
-    task :default => default_tasks
-
-    begin # take a whack at defining rcov tasks
-      require 'rcov/rcovtask'
-
-      Rcov::RcovTask.new do |t|
-        pattern = ENV['PATTERN'] || 'test/test_*.rb'
-
-        t.test_files = FileList[pattern]
-        t.verbose = true
-        t.rcov_opts << "--no-color"
-        t.rcov_opts << "--save coverage.info"
-        t.rcov_opts << "-x ^/"
-      end
-
-      # this is for my emacs rcov overlay stuff on emacswiki.
-      task :rcov_overlay do
-        path = ENV["FILE"]
-        rcov, eol = Marshal.load(File.read("coverage.info")).last[path], 1
-        puts rcov[:lines].zip(rcov[:coverage]).map { |line, coverage|
-          bol, eol = eol, eol + line.length
-          [bol, eol, "#ffcccc"] unless coverage
-        }.compact.inspect
-      end
-    rescue LoadError
-      # skip
-    end
-
-    begin
-      require 'flay'
-      require 'flay_task'
-      FlayTask.new :flay, self.flay_threshold
-    rescue LoadError
-      # skip
-    end
-
-    begin
-      require 'flog'
-      require 'flog_task'
-      FlogTask.new :flog, self.flog_threshold
-    rescue LoadError
-      # skip
-    end
-
-    ############################################################
-    # Packaging and Installing
-
-    signing_key = nil
-    cert_chain = []
+  ##
+  # Define the Gem::Specification.
 
-    with_config do |config, path|
-      break unless config['signing_key_file'] and config['signing_cert_file']
-      key_file = File.expand_path config['signing_key_file'].to_s
-      signing_key = key_file if File.exist? key_file
+  def define_spec
+    self.spec = Gem::Specification.new do |s|
+      dirs = Dir['{lib,ext}']
 
-      cert_file = File.expand_path config['signing_cert_file'].to_s
-      cert_chain << cert_file if File.exist? cert_file
-    end
+      s.name                 = name
+      s.version              = version if version
+      s.summary              = summary
+      s.email                = email
+      s.homepage             = Array(url).first
+      s.rubyforge_project    = rubyforge_name
+      s.description          = description
+      s.files                = File.read("Manifest.txt").split(/\r?\n\r?/)
+      s.executables          = s.files.grep(/^bin/) { |f| File.basename(f) }
+      s.bindir               = "bin"
+      s.require_paths        = dirs unless dirs.empty?
+      s.rdoc_options         = ['--main', readme_file]
+      s.has_rdoc             = true
+      s.post_install_message = post_install_message
+      s.test_files           = Dir[*self.test_globs]
 
-    self.spec = Gem::Specification.new do |s|
-      s.name = name
-      s.version = version
-      s.summary = summary
       case author
       when Array
         s.authors = author
       else
-        s.author = author
+        s.author  = author
       end
-      s.email = email
-      s.homepage = Array(url).first
-      s.rubyforge_project = rubyforge_name
-
-      s.description = description
 
       extra_deps.each do |dep|
         s.add_dependency(*dep)
@@ -632,67 +340,9 @@ class Hoe
         s.add_development_dependency(*dep)
       end
 
-      s.files = File.read("Manifest.txt").delete("\r").split(/\n/)
-      s.executables = s.files.grep(/^bin/) { |f| File.basename(f) }
-
-      s.bindir = "bin"
-      dirs = Dir['{lib,ext}']
-      s.require_paths = dirs unless dirs.empty?
-
-      s.rdoc_options = ['--main', readme_file]
-
       s.extra_rdoc_files += s.files.grep(/txt$/)
       s.extra_rdoc_files.reject! { |f| f =~ %r%^(test|spec|vendor|template|data|tmp)/% }
       s.extra_rdoc_files += @extra_rdoc_files
-      s.has_rdoc = true
-
-      s.post_install_message = post_install_message
-
-      if test ?f, "test/test_all.rb" then
-        s.test_file = "test/test_all.rb"
-      else
-        s.test_files = Dir[*self.test_globs]
-      end
-
-      if signing_key and cert_chain then
-        s.signing_key = signing_key
-        s.cert_chain = cert_chain
-      end
-
-      ############################################################
-      # Allow automatic inclusion of compiled extensions
-      if ENV['INLINE'] then
-        s.platform = ENV['FORCE_PLATFORM'] || Gem::Platform::CURRENT
-
-        # Try collecting Inline extensions for +name+
-        if defined?(Inline) then
-          directory 'lib/inline'
-
-          Inline.registered_inline_classes.each do |cls|
-            name = cls.name # TODO: what about X::Y::Z?
-            # name of the extension is CamelCase
-            alternate_name = if name =~ /[A-Z]/ then
-                               name.gsub(/([A-Z])/, '_\1').downcase.sub(/^_/, '')
-                             elsif name =~ /_/ then
-                               name.capitalize.gsub(/_([a-z])/) { $1.upcase }
-                             end
-
-            extensions = Dir.chdir(Inline::directory) {
-              Dir["Inline_{#{name},#{alternate_name}}_*.#{DLEXT}"]
-            }
-
-            extensions.each do |ext|
-              # add the inlined extension to the spec files
-              s.files += ["lib/inline/#{ext}"]
-
-              # include the file in the tasks
-              file "lib/inline/#{ext}" => ["lib/inline"] do
-                cp File.join(Inline::directory, ext), "lib/inline"
-              end
-            end
-          end
-        end
-      end
 
       # Do any extra stuff the user wants
       spec_extras.each do |msg, val|
@@ -705,448 +355,116 @@ class Hoe
       end
     end
 
-    desc 'Show information about the gem.'
-    task :debug_gem do
-      puts spec.to_ruby
-    end
-
-    self.lib_files  = spec.files.grep(/^(lib|ext)/)
-    self.bin_files  = spec.files.grep(/^bin/)
-    self.test_files = spec.files.grep(/^test/)
-
-    Rake::GemPackageTask.new spec do |pkg|
-      pkg.need_tar = @need_tar
-      pkg.need_zip = @need_zip
-    end
-
-    desc 'Install the package as a gem.'
-    task :install_gem => [:clean, :package, :check_extra_deps] do
-      install_gem Dir['pkg/*.gem'].first
-    end
-
-    desc 'Package and upload the release to rubyforge.'
-    task :release => [:clean, :package] do |t|
-      v = ENV["VERSION"] or abort "Must supply VERSION=x.y.z"
-      abort "Versions don't match #{v} vs #{version}" if v != version
-      pkg = "pkg/#{name}-#{version}"
-
-      if $DEBUG then
-        puts "release_id = rf.add_release #{rubyforge_name.inspect}, #{name.inspect}, #{version.inspect}, \"#{pkg}.tgz\""
-        puts "rf.add_file #{rubyforge_name.inspect}, #{name.inspect}, release_id, \"#{pkg}.gem\""
-      end
-
-      rf = RubyForge.new.configure
-      puts "Logging in"
-      rf.login
-
-      c = rf.userconfig
-      c["release_notes"] = description if description
-      c["release_changes"] = changes if changes
-      c["preformatted"] = true
-
-      files = [(@need_tar ? "#{pkg}.tgz" : nil),
-               (@need_zip ? "#{pkg}.zip" : nil),
-               "#{pkg}.gem"].compact
-
-      puts "Releasing #{name} v. #{version}"
-      rf.add_release rubyforge_name, name, version, *files
-    end
-
-    ############################################################
-    # Doco
-
-    Rake::RDocTask.new(:docs) do |rd|
-      rd.main = readme_file
-      rd.options << '-d' if (`which dot` =~ /\/dot/) unless
-        ENV['NODOT'] || WINDOZE
-      rd.rdoc_dir = 'doc'
-
-      rd.rdoc_files += spec.require_paths
-      rd.rdoc_files += spec.extra_rdoc_files
-
-      title = "#{name}-#{version} Documentation"
-      title = "#{rubyforge_name}'s " + title if rubyforge_name != name
-
-      rd.options << "-t" << title
-    end
-
-    desc 'Generate ri locally for testing.'
-    task :ridocs => :clean do
-      sh %q{ rdoc --ri -o ri . }
-    end
-
-    desc 'Publish RDoc to RubyForge.'
-    task :publish_docs => [:clean, :docs] do
-      config = YAML.load(File.read(File.expand_path("~/.rubyforge/user-config.yml")))
-      host = "#{config["username"]}@rubyforge.org"
-
-      remote_dir = "/var/www/gforge-projects/#{rubyforge_name}/#{remote_rdoc_dir}"
-      local_dir = 'doc'
-
-      sh %{rsync #{rsync_args} #{local_dir}/ #{host}:#{remote_dir}}
-    end
-
-    # no doco for this one
-    task :publish_on_announce do
-      with_config do |config, _|
-        Rake::Task['publish_docs'].invoke if config["publish_on_announce"]
-      end
-    end
-
-    ############################################################
-    # Dependencies:
-
-    namespace :deps do
-      require 'zlib' # HACK for rubygems 1.3.0
-      require 'rubygems/remote_fetcher'
-
-      @@index = nil
-
-      def self.get_source_index
-        return @@index if @@index
-
-        dump = unless File.exist? '.source_index' then
-                 url = GEMURL + "Marshal.#{Gem.marshal_version}.Z"
-                 dump = Gem::RemoteFetcher.fetcher.fetch_path url
-                 dump = Gem.inflate dump
-                 open '.source_index', 'wb' do |io| io.write dump end
-                 dump
-               else
-                 open '.source_index', 'rb' do |io| io.read end
-               end
-
-        @@index = Marshal.load dump
-      end
-
-      def self.get_latest_gems
-        @@cache ||= get_source_index.latest_specs
-      end
-
-      def self.get_gems_by_name
-        @@by_name ||= Hash[*get_latest_gems.map { |gem|
-                             [gem.name, gem, gem.full_name, gem]
-                           }.flatten]
-      end
-
-      def self.dependent_upon name
-        get_latest_gems.find_all { |gem|
-          gem.dependencies.any? { |dep| dep.name == name }
-        }
-      end
-
-
-      desc "List all the dependent gems of this gem"
-      task :list do
-        gems = self.get_gems_by_name
-        gem  = gems[self.name]
-
-        abort "Couldn't find gem: #{self.name}" unless gem
-
-        deps = self.dependent_upon self.name
-        max  = deps.map { |s| s.full_name.size }.max
-
-        puts "  dependents:"
-        unless deps.empty? then
-          deps.sort_by { |spec| spec.full_name }.each do |spec|
-            vers = spec.dependencies.find {|s| s.name == name }.requirement_list
-            puts "    %-*s - %s" % [max, spec.full_name, vers.join(", ")]
-          end
-        else
-          puts "    none"
-        end
-      end
-
-      desc "Print a contact list for gems dependent on this gem"
-      task :email do
-        gems = self.get_gems_by_name
-        gem  = gems[self.name]
-
-        abort "Couldn't find gem: #{self.name}" unless gem
-
-        deps = self.dependent_upon self.name
-
-        email = deps.map { |s| s.email }.flatten.sort.uniq
-        email = email.map { |s| s.split(/,\s*/) }.flatten.sort.uniq
-
-        email.map! { |s| # don't you people realize how easy this is?
-          s.gsub(/ at | _at_ |\s*(atmark|@nospam@|-at?-|@at?@|<at?>|\[at?\]|\(at?\))\s*/i, '@').gsub(/\s*(dot|\[d(ot)?\]|\.dot\.)\s*/i, '.').gsub(/\s+com$/, '.com')
-        }
-
-        bad, good = email.partition { |e| e !~ /^[\w.+-]+\@[\w.+-]+$/ }
-
-        warn "Rejecting #{bad.size} email. I couldn't unmunge them." unless
-          bad.empty?
-
-        puts good.join(", ")
-      end
-
-      desc "Fetch all the dependent gems of this gem into tarballs"
-      task :fetch do
-        gems = self.get_gems_by_name
-        gem  = gems[self.name]
-        deps = self.dependent_upon self.name
-
-        mkdir "deps" unless File.directory? "deps"
-        Dir.chdir "deps" do
-          begin
-            deps.sort_by { |spec| spec.full_name }.each do |spec|
-              full_name = spec.full_name
-              tgz_name  = "#{full_name}.tgz"
-              gem_name  = "#{full_name}.gem"
-
-              next if File.exist? tgz_name
-              FileUtils.rm_rf [full_name, gem_name]
-
-              begin
-                warn "downloading #{full_name}"
-                Gem::RemoteFetcher.fetcher.download(spec, GEMURL, Dir.pwd)
-                FileUtils.mv "cache/#{gem_name}", '.'
-              rescue Gem::RemoteFetcher::FetchError
-                warn "  failed"
-                next
-              end
-
-              warn "converting #{gem_name} to tarball"
-
-              system "gem unpack #{gem_name} 2> /dev/null"
-              system "gem spec -l #{gem_name} > #{full_name}/gemspec.rb"
-              system "tar zmcf #{tgz_name} #{full_name}"
-              FileUtils.rm_rf [full_name, gem_name, "cache"]
-            end
-          ensure
-            FileUtils.rm_rf "cache"
-          end
-        end
-      end
-    end
-
-    ############################################################
-    # Misc/Maintenance:
-
-    desc 'Run ZenTest against the package.'
-    task :audit do
-      libs = %w(lib test ext).join(File::PATH_SEPARATOR)
-      sh "zentest -I=#{libs} #{spec.files.grep(/^(lib|test)/).join(' ')}"
-    end
-
-    task :clobber_rcov # in case rcov didn't load
+    unless self.version then
+      version = nil
 
-    desc 'Clean up all the extras.'
-    task :clean => [ :clobber_docs, :clobber_package, :clobber_rcov ] do
-      clean_globs.each do |pattern|
-        files = Dir[pattern]
-        rm_rf files, :verbose => true unless files.empty?
+      spec.files.each do |file|
+        next unless File.exist? file
+        version = File.read(file)[/VERSION = ([\"\'])([\d\.]+)\1/, 2]
+        break if version
       end
-    end
 
-    desc 'Install missing dependencies.'
-    task :check_extra_deps do
-      # extra_deps = [["rubyforge", ">= 1.0.0"], ["rake", ">= 0.8.1"]]
-      extra_deps.each do |dep|
-        begin
-          gem(*dep)
-        rescue Gem::LoadError
-          install_gem(*dep)
-        end
-      end
+      spec.version = self.version = version
     end
 
-    desc 'Create a fresh ~/.hoerc file.'
-    task :config_hoe do
-      with_config do |config, path|
-        default_config = {
-          "exclude"             => /tmp$|CVS|\.svn|\.log$/,
-          "publish_on_announce" => false,
-          "signing_key_file"    => "~/.gem/gem-private_key.pem",
-          "signing_cert_file"   => "~/.gem/gem-public_cert.pem",
-          "blogs" => [
-                      {
-                        "user"     => "user",
-                        "password" => "password",
-                        "url"      => "url",
-                        "blog_id"  => "blog_id",
-                        "extra_headers" => {
-                          "mt_convert_breaks" => "markdown"
-                        },
-                      }
-                     ],
-        }
-        File.open(path, "w") do |f|
-          YAML.dump(default_config.merge(config), f)
-        end
-
-        editor = ENV['EDITOR'] || 'vi'
-        system "#{editor} #{path}" if ENV['SHOW_EDITOR'] != 'no'
-      end
-    end
+    raise "Need version" unless self.version
+  end
 
-    desc 'Generate email announcement file.'
-    task :email do
-      require 'rubyforge'
-      subject, title, body, urls = announcement
-
-      File.open("email.txt", "w") do |mail|
-        mail.puts "Subject: [ANN] #{subject}"
-        mail.puts
-        mail.puts title
-        mail.puts
-        mail.puts urls
-        mail.puts
-        mail.puts body
-        mail.puts
-        mail.puts urls
-      end
-      puts "Created email.txt"
-    end
+  ##
+  # Convenience method to set add to both the author and email fields.
 
-    desc 'Post announcement to blog.'
-    task :post_blog do
-      require 'xmlrpc/client'
+  def developer name, email
+    self.author << name
+    self.email  << email
+  end
 
-      with_config do |config, path|
-        break unless config['blogs']
+  ##
+  # Create a newly initialized hoe spec. If a block is given, yield on
+  # it and finish post_initialize steps. This is deprecated behavior
+  # and should be switched from Hoe.new to Hoe.spec.
 
-        subject, title, body, urls = announcement
-        body += "\n\n#{urls}"
+  def initialize name, version = nil # :nodoc:
+    self.name                 = name
+    self.version              = version
 
-        config['blogs'].each do |site|
-          server = XMLRPC::Client.new2(site['url'])
-          content = site['extra_headers'].merge(:title => title,
-                                                :description => body,
-                                                :categories => blog_categories)
+    self.author               = []
+    self.changes              = nil
+    self.description          = nil
+    self.description_sections = %w(description)
+    self.email                = []
+    self.extra_deps           = []
+    self.extra_dev_deps       = []
+    self.extra_rdoc_files     = []
+    self.history_file         = "History.txt"
+    self.post_install_message = nil
+    self.readme_file          = "README.txt"
+    self.rubyforge_name       = name.downcase
+    self.spec                 = nil
+    self.spec_extras          = {}
+    self.summary              = nil
+    self.summary_sentences    = 1
+    self.test_globs           = ['test/**/test_*.rb']
+    self.url                  = nil
 
-          result = server.call('metaWeblog.newPost',
-                               site['blog_id'],
-                               site['user'],
-                               site['password'],
-                               content,
-                               true)
-        end
-      end
+    if block_given? then
+      warn "Hoe.new {...} deprecated. Switch to Hoe.spec."
+      self.activate_plugins
+      yield self
+      post_initialize
     end
+  end
 
-    desc 'Post announcement to rubyforge.'
-    task :post_news do
-      require 'rubyforge'
-      subject, title, body, urls = announcement
+  ##
+  # Intuit values from the readme and history files.
 
-      rf = RubyForge.new.configure
-      rf.login
-      rf.post_news(rubyforge_name, subject, "#{title}\n\n#{body}")
-      puts "Posted to rubyforge"
-    end
+  def intuit_values
+    readme = File.read(readme_file).split(/^(=+ .*)$/)[1..-1] rescue ''
+    unless readme.empty? then
+      sections = readme.map { |s|
+        s =~ /^=/ ? s.strip.downcase.chomp(':').split.last : s.strip
+      }
+      sections = Hash[*sections]
+      desc     = sections.values_at(*description_sections).join("\n\n")
+      summ     = desc.split(/\.\s+/).first(summary_sentences).join(". ")
 
-    desc 'Create news email file and post to rubyforge.'
-    task :announce => [:email, :post_news, :post_blog, :publish_on_announce ]
-
-    desc 'Verify the manifest.'
-    task :check_manifest => :clean do
-      f = "Manifest.tmp"
-      require 'find'
-      files = []
-      with_config do |config, _|
-        exclusions = config["exclude"]
-        abort "exclude entry missing from .hoerc. Aborting." if exclusions.nil?
-        Find.find '.' do |path|
-          next unless File.file? path
-          next if path =~ exclusions
-          files << path[2..-1]
-        end
-        files = files.sort.join "\n"
-        File.open f, 'w' do |fp| fp.puts files end
-        system "#{DIFF} -du Manifest.txt #{f}"
-        rm f
-      end
+      self.description ||= desc
+      self.summary     ||= summ
+      self.url         ||= readme[1].gsub(/^\* /, '').split(/\n/).grep(/\S+/)
+    else
+      missing readme_file
     end
 
-    desc 'Generate a key for signing your gems.'
-    task :generate_key do
-      email = Array(spec.email)
-      abort "No email in your gemspec" if email.nil? or email.empty?
-
-      key_file = with_config { |config, _| config['signing_key_file'] }
-      cert_file = with_config { |config, _| config['signing_cert_file'] }
-
-      if key_file.nil? or cert_file.nil? then
-        ENV['SHOW_EDITOR'] ||= 'no'
-        Rake::Task['config_hoe'].invoke
-
-        key_file = with_config { |config, _| config['signing_key_file'] }
-        cert_file = with_config { |config, _| config['signing_cert_file'] }
-      end
-
-      key_file = File.expand_path key_file
-      cert_file = File.expand_path cert_file
-
-      unless File.exist? key_file or File.exist? cert_file then
-        warn "NOTICE: using #{email.first} for certificate" if email.size > 1
-
-        sh "gem cert --build #{email.first}"
-        mv "gem-private_key.pem", key_file, :verbose => true
-        mv "gem-public_cert.pem", cert_file, :verbose => true
-
-        puts "Installed key and certificate."
-
-        rf = RubyForge.new.configure
-        rf.login
-
-        cert_package = "#{rubyforge_name}-certificates"
-
-        begin
-          rf.lookup 'package', cert_package
-        rescue
-          rf.create_package rubyforge_name, cert_package
-        end
+    self.changes ||= begin
+                       h = File.read(history_file)
+                       h.split(/^(===.*)/)[1..2].join.strip
+                     rescue
+                       missing history_file
+                       ''
+                     end
+  end
 
-        begin
-          rf.lookup('release', cert_package)['certificates']
-          rf.add_file rubyforge_name, cert_package, 'certificates', cert_file
-        rescue
-          rf.create_package rubyforge_name, cert_package
-          rf.add_release rubyforge_name, cert_package, 'certificates', cert_file
-        end
+  ##
+  # Load activated plugins by calling their define tasks method.
 
-        puts "Uploaded certificate to release \"certificates\" in package #{cert_package}"
-      else
-        puts "Keys already exist: #{key_file} and #{cert_file}"
-      end
+  def load_plugin_tasks
+    self.class.plugins.each do |plugin|
+      send "define_#{plugin}_tasks"
     end
-  end # end define
-
-  def install_gem name, version = nil
-    gem_cmd = Gem.default_exec_format % 'gem'
-    sudo    = 'sudo '                  unless WINDOZE
-    local   = '--local'                unless version
-    version = "--version '#{version}'" if     version
-    sh "#{sudo}#{gem_cmd} install #{local} #{name} #{version}"
   end
 
-  def make_test_cmd multi = false # :nodoc:
-    framework = SUPPORTED_TEST_FRAMEWORKS[testlib]
-    raise "unsupported test framework #{testlib}" unless framework
-
-    tests = ["rubygems", framework] +
-      test_globs.map { |g| Dir.glob(g) }.flatten
-    tests.map! {|f| %(require "#{f}")}
-
-    cmd = "#{RUBY_FLAGS} -e '#{tests.join("; ")}' #{FILTER}"
-
-    if multi then
-      ENV['EXCLUDED_VERSIONS'] = multiruby_skip.join ":"
-      cmd = "-S multiruby #{cmd}"
-    end
+  ##
+  # Bitch about a file that is missing data or unparsable for intuiting values.
 
-    cmd
+  def missing name
+    warn "** #{name} is missing or in the wrong format for auto-intuiting."
+    warn "   run `sow blah` and look at its text files"
   end
 
-  def announcement # :nodoc:
-    changes = self.changes.rdoc_to_markdown
-    subject = "#{name} #{version} Released"
-    title   = "#{name} version #{version} has been released!"
-    body    = "#{description}\n\nChanges:\n\n#{changes}".rdoc_to_markdown
-    urls    = Array(url).map { |s| "* <#{s.strip.rdoc_to_markdown}>" }.join("\n")
+  ##
+  # Normalize the dependencies.
 
-    return subject, title, body, urls
+  def normalize_deps deps
+    Array(deps).map { |o| String === o ? [o] : o }
   end
 
   ##
@@ -1155,75 +473,60 @@ class Hoe
   #   changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
   #   summary, *description = p.paragraphs_of('README.txt', 3, 3..8)
 
-  def paragraphs_of(path, *paragraphs)
+  def paragraphs_of path, *paragraphs
     File.read(path).delete("\r").split(/\n\n+/).values_at(*paragraphs)
   end
-end
 
-module Rake
-  module TaskManager
-    ##
-    # This gives us access to the tasks already defined in rake.
-    def all_tasks
-      @tasks
-    end
+  ##
+  # Tell the world you're a pluggable package (ie you require rubygems 1.3.1+)
+
+  def pluggable!
+    abort "update rubygems to >= 1.3.1" unless  Gem.respond_to? :find_files
+    spec_extras[:required_rubygems_version] = '>= 1.3.1'
   end
 
   ##
-  # Simple shortcut for Rake.application.all_tasks
-  def self.all_tasks
-    Rake.application.all_tasks
+  # Finalize configuration
+
+  def post_initialize
+    intuit_values
+    validate_fields
+    add_dependencies
+    define_spec
+    load_plugin_tasks
   end
 
   ##
-  # Hooks into rake and allows us to clear out a task by name or
-  # regexp. Use this if you want to completely override a task instead
-  # of extend it.
-  def self.clear_tasks(*tasks)
-    tasks.flatten.each do |name|
-      case name
-      when Regexp then
-        all_tasks.delete_if { |k,_| k =~ name }
-      else
-        all_tasks.delete(name)
-      end
-    end
+  # Provide a linear degrading value from n to m over start to finis dates.
+
+  def timebomb n, m, finis = '2010-04-01', start = '2009-03-14'
+    finis = Time.parse finis
+    start = Time.parse start
+    rest  = (finis - Time.now)
+    full  = (finis - start)
+
+    ((n - m) * rest / full).to_i + m
   end
 
   ##
-  # Removes the last action added to a task. Use this when two
-  # libraries define the same task and you only want one of the
-  # actions.
-  #
-  #   require 'hoe'
-  #   require 'tasks/rails'
-  #   Rake.undo("test") # rolls out rails' test task
-  def self.undo(*names)
-    names.each do |name|
-      all_tasks[name].actions.delete_at(-1)
+  # Verify that mandatory fields are set.
+
+  def validate_fields
+    %w(email author).each do |field|
+      value = self.send(field)
+      abort "Hoe #{field} value not set. aborting" if value.nil? or value.empty?
     end
   end
-end
-
-# :enddoc:
 
-class ::Rake::SshDirPublisher # :nodoc:
-  attr_reader :host, :remote_dir, :local_dir
-end
+  ##
+  # Load or create a default config and yield it
 
-class String
-  def rdoc_to_markdown
-    self.gsub(/^mailto:/, '').gsub(/^(=+)/) { "#" * $1.size }
+  def with_config # :nodoc:
+    rc = File.expand_path("~/.hoerc")
+    exists = File.exist? rc
+    config = exists ? YAML.load_file(rc) : {}
+    yield(config, rc)
   end
-end
 
-if $0 == __FILE__ then
-  out = `rake -T | egrep -v "redocs|repackage|clobber|trunk"`
-  if ARGV.empty? then
-    # # default::        Run the default tasks.
-    puts out.gsub(/(\s*)\#/, '::\1').gsub(/^rake /, '# ')
-  else
-    # * default        - Run the default tasks.
-    puts out.gsub(/\#/, '-').gsub(/^rake /, '* ')
-  end
+  Hoe.load_plugins
 end