shoe 0.4.0 → 0.5.0

data/CHANGELOG.rdoc

@@ -1,3 +1,10 @@
+== Git
+
+* Lean on cucumber.yml to define cucumber tasks.
+* Lean on spec.test_files and Gem::Validator to run tests.
+* Shoe::Tasks can now be used a la carte.
+* The shoe generator script now requires a path argument.
+
 == 0.4.0
 
 * Don't generate the gemspec; *use* it instead.

data/README.rdoc

@@ -1,66 +1,96 @@
 = Shoe
 
-Shoe is a library of Rake tasks that (unlike
-Hoe[http://seattlerb.rubyforge.org/hoe] and
-Jeweler[http://github.com/technicalpickles/jeweler]) honors your gemspec.
-(Background[http://yehudakatz.com/2010/04/02/using-gemspecs-as-intended/].)
-
-Shoe's Rake tasks accept *zero* configuration parameters. All configuration
-should be performed in your (checked into version control) gemspec. This way,
-Shoe can lean on Rubygems for the things it's already good at, using
-{Gem::Ext::ExtConfBuilder}[http://rubygems.rubyforge.org/rubygems-update/Gem/Ext/ExtConfBuilder.html]
-and
-{Gem::DocManager}[http://rubygems.rubyforge.org/rubygems-update/Gem/DocManager.html]
-instead of {ad-hoc}[http://github.com/luislavena/rake-compiler/] {Rake
-tasks}[http://rake.rubyforge.org/classes/Rake/RDocTask.html] -- indeed, this is
-what your users will be doing when they install your gem!
-
-(I have a pipe dream of one day running tests strictly with
-{Gem::Validator}[http://rubygems.rubyforge.org/rubygems-update/Gem/Validator.html].)
+Shoe is an ecosystem-friendly library of Rake tasks for your gem.
+
+* It <b>reads your gemspec</b> instead of writing it like
+  Hoe[http://seattlerb.rubyforge.org/hoe] and
+  Jeweler[http://github.com/technicalpickles/jeweler] do.
+  (Background[http://yehudakatz.com/2010/04/02/using-gemspecs-as-intended/].)
+
+* It <b>uses Rubygems</b>
+  {for}[http://rubygems.rubyforge.org/rubygems-update/Gem/Ext/ExtConfBuilder.html]
+  {common}[http://rubygems.rubyforge.org/rubygems-update/Gem/DocManager.html]
+  {functionality}[http://rubygems.rubyforge.org/rubygems-update/Gem/Validator.html],
+  rather than
+  {reinventing}[http://github.com/luislavena/rake-compiler/]
+  {the}[http://rake.rubyforge.org/classes/Rake/RDocTask.html]
+  {wheel}[http://rake.rubyforge.org/classes/Rake/TestTask.html].
+
 
 == Install
 
  $ gem install shoe
 
-== Use
 
-In your <tt>Rakefile</tt>:
+== Use
 
  require 'shoe'
 
  Shoe::Tasks.define('my_project.gemspec')
 
-Then you'll see (at most) the following rake tasks available:
 
- rake clean         # Remove ignored files
- rake compile       # Compile C extensions
- rake cucumber:ok   # Run features
- rake cucumber:wip  # Run work-in-progress features
- rake default       # Run tests / Run features
- rake rdoc          # Generate documentation
- rake release       # Release myproject-0.1.0
- rake test          # Run tests
+== Configure
+
+Shoe::Tasks accept no direct configuration. Instead, they rely on your project environment:
+
+Shoe::Tasks::Clean::
+  calls <tt>`git clean -fdX`</tt>.
+
+Shoe::Tasks::Compile::
+  builds the
+  <tt>extensions[http://docs.rubygems.org/read/chapter/20#extensions]</tt> in
+  your gemspec.
+
+Shoe::Tasks::Cucumber::
+  runs individual profiles in your
+  <tt>{cucumber.yml}[http://wiki.github.com/aslakhellesoy/cucumber/cucumberyml]</tt>.
+
+Shoe::Tasks::Rdoc::
+  uses the
+  <tt>rdoc_options[http://docs.rubygems.org/read/chapter/20#rdoc_options]</tt>
+  and
+  <tt>extra_rdoc_files[http://docs.rubygems.org/read/chapter/20#extra_rdoc_files]</tt>
+  in your gemspec.
+
+Shoe::Tasks::Release::
+  calls <tt>`git tag`</tt>, <tt>`git push`</tt>, <tt>`gem build`</tt> and
+  <tt>`gem push`</tt>, of course.
+
+Shoe::Tasks::Test::
+  runs the
+  <tt>test_files[http://docs.rubygems.org/read/chapter/20#test_files]</tt> in
+  your gemspec.
+
+Each Task class definition has more specific configuration notes.
+
+
+== Cherry Pick
+
+If you don't want to use all the Shoe::Tasks, just instantiate the ones you
+want:
+
+ require 'shoe'
+
+ Shoe::Tasks::Cucumber.new('my_project.gemspec')
+ Shoe::Tasks::Rdoc.new('my_project.gemspec')
 
-I say "at most" because, when possible, tasks are conditionally defined: you
-won't see "rake compile" if you don't specify any extensions in your gemspec,
-for example.
 
 == Bootstrap
 
-If you like, you can also use the provided <tt>shoe</tt> executable to generate
-some starter files for your new project:
+The provided <tt>shoe</tt> executable will generate a helpful gemspec and some
+other skeleton files for your new project:
 
- $ mkdir foo
- $ cd foo
- $ shoe
+ $ shoe my_project
 
-This will generate <tt>README.rdoc</tt>, <tt>Rakefile</tt>,
-<tt>foo.gemspec</tt>, and <tt>lib/foo/version.rb</tt>.
+If you're using {Bundler}[http://gembundler.com], see
+{bundler.rdoc}[link:files/doc/bundler_rdoc.html] for some helpful tips.
 
-If you're using Bundler, see {BUNDLER.rdoc}[link:files/BUNDLER_rdoc.html] for more.
 
-== Send Me Feedback
+== Contribute
 
-A number of these tasks are maybe less useful for you than they could be, probably because you and I use different conventions. If you have some ideas for making Shoe better, I'd love to hear them! Feel free to send issues / pull requests / messages through GitHub.
+A number of these tasks are maybe less useful for you than they could be,
+probably because you and I use different conventions. If you have some ideas
+for making Shoe better, I'd love to hear them! Feel free to send issues / pull
+requests / messages through GitHub.
 
 All the best,  -- Matthew

data/TODO.rdoc

@@ -1,8 +1,6 @@
 = Next Up
 
 * Help generate man pages?
-* Ditch cucumber tasks? (This moves us more into the pure-gemspec space.)
-* Use Gem::Validator to run tests.
-* Find a nicer way to express task dependencies; then maybe tasks could be used a la carte?
 * How would I incorporate Gem::Specification#add_bundler_dependencies?
-* Require a path argument for the shoe executable.
+* Support any extension flavor that Rubygems supports, not just extconf.rb.
+* Find a better way to clean; I don't want to whack .bundler and .rvmrc.

data/bin/shoe

@@ -1,4 +1,4 @@
 #!/usr/bin/env ruby
 
 require 'shoe'
-Shoe::Generator.new.run
+Shoe::Generator.new(*ARGV).run

data/cucumber.yml

@@ -0,0 +1,2 @@
+default: --format progress --tags ~@wip
+wip: --tags @wip --wip

data/{BUNDLER.rdoc → doc/bundler.rdoc}

@@ -1,4 +1,4 @@
-= Using Shoe with Bundler
+= Using Shoe with {Bundler}[http://gembundler.com]
 
 Bootstrapping is a little chicken-and-egg-y, but with the following initial <tt>Gemfile</tt>:
 
@@ -8,7 +8,7 @@ Bootstrapping is a little chicken-and-egg-y, but with the following initial <tt>
 You should be able to:
 
  $ bundle install
- $ bundle exec shoe
+ $ bundle exec shoe .
 
 From there, I've been preferring <tt>`bundle exec bash`</tt> over <tt>`bundle
 exec rake`</tt> or using <tt>require 'bundler/setup'</tt> in my

data/features/cucumber.feature

@@ -11,8 +11,18 @@ Feature: Cucumber
   Scenario: Running rake --tasks in a shoe project with Cucumber features
     Given I have created a project called "my_project"
     And I have appended "gem 'cucumber'" to "my_project/Gemfile"
-    And I have created a directory called "my_project/features"
+    And I have created a file called "my_project/cucumber.yml" containing:
+      """
+      default: --tags ~@wip
+      wip: --tags @wip --wip
+      """
     When I run bundle exec rake --tasks inside "my_project"
     Then I should see "rake cucumber" on standard out
     And I should see "rake cucumber:wip" on standard out
 
+  Scenario: Running rake --tasks in a shoe project with a bad cucumber.yml
+    Given I have created a project called "my_project"
+    And I have appended "gem 'cucumber'" to "my_project/Gemfile"
+    And I have created a file called "my_project/cucumber.yml" containing ""
+    When I run bundle exec rake --tasks inside "my_project"
+    Then I should not see "rake cucumber" on standard out

data/features/getting_started.feature

@@ -10,7 +10,7 @@ Feature: Getting started
       source :rubygems
       gem 'shoe', :group => :development
       """
-    When I run bundle exec shoe inside "my_project"
+    When I run bundle exec shoe . inside "my_project"
     Then I should see a file "my_project/Rakefile"
     And I should see a file "my_project/README.rdoc"
     And I should see a file "my_project/lib/my_project/version.rb"
@@ -24,6 +24,6 @@ Feature: Getting started
       gem 'shoe', :group => :development
       """
     And I have created a file called "my_project/Rakefile" containing "# RAKEFILE CONTENTS"
-    When I run bundle exec shoe inside "my_project"
+    When I run bundle exec shoe . inside "my_project"
     Then I should see "Rakefile exists. Not clobbering." on standard error
     And the contents of "my_project/Rakefile" should still be "# RAKEFILE CONTENTS"

data/features/step_definitions/shoe_steps.rb

@@ -4,7 +4,7 @@ Given /^I have created a project called "([^\"]*)"$/ do |name|
     source :rubygems
     gem 'shoe', :group => :development
   END
-  run('bundle exec shoe', name)
+  run('bundle exec shoe .', name)
 end
 
 Given /^I have created a directory called "([^\"]*)"$/ do |name|

data/features/test.feature

@@ -0,0 +1,18 @@
+Feature: Test
+  In order to run tests
+  As a developer
+  I want shoe to give me a rake task
+
+  Scenario: Running rake --tasks in a shoe project without tests
+    Given I have created a project called "my_project"
+    And I have run git init inside "my_project"
+    When I run bundle exec rake --tasks inside "my_project"
+    Then I should not see "rake test" on standard out
+
+  Scenario: Running rake --tasks in a shoe project with tests
+    Given I have created a project called "my_project"
+    And I have run git init inside "my_project"
+    And I have created a directory called "my_project/test"
+    And I have created a file called "my_project/test/foo_test.rb" containing ""
+    When I run bundle exec rake --tasks inside "my_project"
+    Then I should see "rake test" on standard out

data/lib/shoe/generator.rb

@@ -3,8 +3,8 @@ require 'pathname'
 
 module Shoe
   class Generator
-    def initialize
-      @root          = Pathname.pwd.expand_path
+    def initialize(root)
+      @root          = Pathname.new(root).expand_path
       @template_path = Pathname.new(__FILE__).dirname.join('templates')
     end
 

data/lib/shoe/tasks.rb

@@ -9,18 +9,18 @@ module Shoe
     autoload :Release,   'shoe/tasks/release'
     autoload :Test,      'shoe/tasks/test'
 
-    LOAD_ORDER = %w(
+    NAMES = %w(
       Clean
+      Compile
+      Cucumber
       Rdoc
       Release
       Test
-      Cucumber
-      Compile
     )
 
     def self.define(spec)
-      LOAD_ORDER.map { |name| const_get(name) }.
-                each { |task| task.new(spec)  }
+      NAMES.map { |name| const_get(name) }.
+           each { |task| task.new(spec)  }
     end
 
   end

data/lib/shoe/tasks/abstract.rb

@@ -11,25 +11,18 @@ module Shoe
                   Gem::Specification.load(spec)
                 end
 
+        @spec.extend(LocalGemspecExtensions)
+
         if active?
           define
         end
       end
 
-      def active?
-        true
-      end
-
       private
 
-      def before(name, dependency)
-        desc Rake::Task[dependency].comment
-        task name => dependency
-      end
-
-      def before_existing(name, dependency)
-        if Rake::Task.task_defined?(name)
-          task name => dependency
+      module LocalGemspecExtensions #:nodoc:
+        def full_gem_path
+          Dir.pwd
         end
       end
 

data/lib/shoe/tasks/clean.rb

@@ -1,6 +1,15 @@
 module Shoe
   module Tasks
 
+    # Defines <tt>`rake clean`</tt> to remove <tt>.gitignore</tt>d files and
+    # directories.
+    #
+    # Uses <tt>`{git clean}[http://www.kernel.org/pub/software/scm/git/docs/git-clean.html] -fdX`</tt>.
+    #
+    # To enable, version your project with git[http://git-scm.com].
+    #
+    # To configure, edit your
+    # <tt>{.gitignore}[http://www.kernel.org/pub/software/scm/git/docs/gitignore.html]</tt>.
     class Clean < Abstract
       def active?
         File.directory?('.git')

data/lib/shoe/tasks/compile.rb

@@ -3,6 +3,16 @@ require 'rubygems/ext'
 module Shoe
   module Tasks
 
+    # Defines <tt>`rake compile`</tt> to build your C extensions.
+    #
+    # Uses
+    # <tt>{Gem::Ext::ExtConfBuilder}[http://rubygems.rubyforge.org/rubygems-update/Gem/Ext/ExtConfBuilder.html]</tt>,
+    # so extensions are compiled locally just as they will be with <tt>`gem
+    # install`</tt>. Your users will thank you.
+    #
+    # To enable and configure, add
+    # <tt>extensions[http://docs.rubygems.org/read/chapter/20#extensions]</tt>
+    # to your gemspec.
     class Compile < Abstract
       def active?
         !spec.extensions.empty?
@@ -26,14 +36,7 @@ module Shoe
           end
         end
 
-        %w(
-          test
-          cucumber:ok
-          cucumber:wip
-          release
-        ).each do |name|
-          before_existing(name, :compile)
-        end
+        task :prepare => :compile
       end
     end
 

data/lib/shoe/tasks/cucumber.rb

@@ -1,9 +1,18 @@
+require 'yaml'
+
 module Shoe
   module Tasks
 
+    # Defines <tt>`rake cucumber`</tt> and <tt>`rake cucumber:<PROFILE>`</tt> to
+    # run your Cucumber[http://cukes.info] features.
+    #
+    # <tt>`rake cucumber`</tt> will run features according to the <tt>default</tt> profile; <tt>`rake cucumber:foo`</tt> according to the <tt>foo</tt> profile.
+    #
+    # To enable and configure, create and edit your
+    # <tt>{cucumber.yml}[http://wiki.github.com/aslakhellesoy/cucumber/cucumberyml]</tt>.
     class Cucumber < Abstract
       def active?
-        File.directory?('features')
+        !cucumber_profiles.empty?
       end
 
       def define
@@ -11,7 +20,7 @@ module Shoe
           require 'cucumber/rake/task'
         rescue LoadError
           warn 'cucumber',
-            "Although you have a features directory, it seems you don't have cucumber installed.",
+            "Although you have a cucumber.yml, it seems you don't have cucumber installed.",
             "You probably want to add a \"gem 'cucumber'\" to your Gemfile."
         else
           define_tasks
@@ -21,18 +30,38 @@ module Shoe
       private
 
       def define_tasks
-        namespace :cucumber do
-          ::Cucumber::Rake::Task.new(:ok, 'Run features') do |task|
-            task.cucumber_opts = '--tags ~@wip'
+        cucumber_profiles.each do |profile|
+          if profile == 'default'
+            define_default_task
+          else
+            define_profile_task(profile)
           end
+        end
+      end
 
-          ::Cucumber::Rake::Task.new(:wip, 'Run work-in-progress features') do |task|
-            task.cucumber_opts = '--tags @wip --wip'
-          end
+      def cucumber_profiles
+        YAML.load_file('cucumber.yml').keys rescue []
+      end
+
+      def define_default_task
+        task :prepare
+
+        ::Cucumber::Rake::Task.new({ :cucumber => :prepare }, 'Run features') do |task|
+          task.profile = 'default'
         end
 
-        before(:default, 'cucumber:ok')
-        before(:default, 'cucumber:wip')
+        task :default
+        Rake.application[:default].prerequisites.push(Rake.application[:cucumber])
+      end
+
+      def define_profile_task(profile)
+        task :prepare
+
+        namespace :cucumber do
+          ::Cucumber::Rake::Task.new({ profile => :prepare }, "Run #{profile} features") do |task|
+            task.profile = profile
+          end
+        end
       end
     end
 

data/lib/shoe/tasks/rdoc.rb

@@ -3,7 +3,30 @@ require 'rubygems/doc_manager'
 module Shoe
   module Tasks
 
+    # Defines <tt>`rake rdoc`</tt> to generate project documentation.
+    #
+    # Uses
+    # <tt>{Gem::DocManager}[http://rubygems.rubyforge.org/rubygems-update/Gem/DocManager.html]</tt>,
+    # so rdoc is generated locally just as it will be with <tt>`gem
+    # install`</tt> and <tt>`gem rdoc`</tt>. Your users will thank you for
+    # making sure their local documentation looks nice.
+    #
+    # (Incidentally, this is why Shoe prefers rdoc (the file format) over
+    # Markdown[http://daringfireball.net/projects/markdown/] and rdoc (the
+    # tool) over YARD[http://yardoc.org/], even though both have considerable
+    # advantages -- it's what your users are going to get!)
+    #
+    # This task is always enabled.
+    #
+    # To configure, add
+    # <tt>rdoc_options[http://docs.rubygems.org/read/chapter/20#rdoc_options]</tt> and
+    # <tt>extra_rdoc_files[http://docs.rubygems.org/read/chapter/20#extra_rdoc_files]</tt>
+    # to your gemspec.
     class Rdoc < Abstract
+      def active?
+        true
+      end
+
       def define
         desc 'Generate documentation'
         task :rdoc do
@@ -29,16 +52,8 @@ module Shoe
           @spec      = spec
           @doc_dir   = Dir.pwd
           @rdoc_args = []
-          adjust_spec_so_that_we_can_generate_rdoc_locally
-        end
-
-        def adjust_spec_so_that_we_can_generate_rdoc_locally
-          def @spec.full_gem_path
-            Dir.pwd
-          end
         end
       end
-
     end
 
   end

data/lib/shoe/tasks/release.rb

@@ -1,6 +1,30 @@
 module Shoe
   module Tasks
 
+    # Defines <tt>`rake release`</tt> to release your gem.
+    #
+    # To release is to: commit, tag, optionally push (with tags), and then
+    # build and push your gem.
+    #
+    # This task is enabled under very specific circumstances, to safeguard
+    # against accidental releases:
+    # 1. Your <tt>version[http://docs.rubygems.org/read/chapter/20#version]</tt> is greater than <tt>0.0.0</tt>.
+    # 2. There is no existing git tag <tt>"v#{version}"</tt>.
+    # 3. You are currently on the <tt>master</tt> branch.
+    #
+    # To configure, adjust the
+    # <tt>version[http://docs.rubygems.org/read/chapter/20#version]</tt> in
+    # your gemspec.
+    #
+    # = Semantic Versioning
+    #
+    # Shoe helps you follow the Tagging Specification of {Semantic
+    # Versioning}[http://semver.org] by tagging your releases as
+    # <tt>"v#{version}"</tt>, prefixing a <tt>"v"</tt> before the version
+    # number.
+    #
+    # Shoe additionally complains if you haven't yet created a <tt>semver</tt>
+    # tag to denote your compliance.
     class Release < Abstract
       def active?
         spec.extend(VersionExtensions)

data/lib/shoe/tasks/test.rb

@@ -1,22 +1,111 @@
-require 'rake/testtask'
+require 'rubygems/validator'
+require 'test/unit/ui/console/testrunner'
+
+# Disable Test::Unit::AutoRunner.
+#
+# Though I tried to be really restrictive with the above testrunner require
+# statement, test/unit itself still gets pulled in, activating the at_exit
+# hook. Dang.
+Test::Unit.run = true
 
 module Shoe
   module Tasks
 
-    # MAYBE be a little more forgiving in test selection, using
-    # test/**/*_test.rb. Or create suites based on subdirectory?
+    # Defines <tt>`rake test`</tt> to run your tests.
+    #
+    # Uses
+    # <tt>{Gem::Validator}[http://rubygems.rubyforge.org/rubygems-update/Gem/Validator.html]</tt>,
+    # so tests are run locally just as they will be with <tt>`{gem
+    # check}[http://docs.rubygems.org/read/chapter/10#page30] --test
+    # your_project`</tt>.
+    #
+    # (Incidentally, this ensures your tests _are_ runnable via <tt>`gem
+    # check`</tt>, a forgotten command second only to <tt>`{gem
+    # cert}[http://docs.rubygems.org/read/chapter/10#page93]`</tt> in its
+    # underuse.)
+    #
+    # To enable and configure, edit the
+    # <tt>test_files[http://docs.rubygems.org/read/chapter/20#test_files]</tt>
+    # in your gemspec.
+    #
+    # = <tt>Test::Unit</tt>
+    #
+    # Using <tt>Gem::Validator</tt> in this way means that you *must* use
+    # <tt>Test::Unit</tt> in all of your
+    # <tt>test_files[http://docs</tt>.rubygems.org/read/chapter/20#test_files]
+    # -- if you prefer Rspec[http://rspec.info], just leave <tt>test_files</tt>
+    # blank and set up your own Rake task.
+    #
+    # = <tt>$LOAD_PATH</tt>
+    #
+    # At test time, the root of your gem, any
+    # <tt>{require_paths}[http://docs.rubygems.org/read/chapter/20#require_paths]</tt>,
+    # and any
+    # <tt>{dependencies}[http://docs.rubygems.org/read/chapter/20#dependencies]</tt>
+    # are on the <tt>$LOAD_PATH</tt>.
+    #
+    # <b>Bad:</b>
+    #
+    #  # Don't do this; test_helper's not in the $LOAD_PATH
+    #  require 'test_helper'
+    #
+    # <b>Good:</b>
+    #
+    #  require 'test/test_helper'
+    #
     class Test < Abstract
       def active?
-        File.directory?('test')
+        !spec.test_files.empty?
       end
 
       def define
-        Rake::TestTask.new do |task|
-          task.libs    = ['lib', 'test']
-          task.pattern = 'test/*_test.rb'
+        desc 'Run tests'
+        task :test do
+          Gem.source_index.extend(LocalGemSourceIndex)
+          Gem.source_index.local_gemspec = spec
+
+          Gem::Validator.send(:remove_const, :TestRunner)
+          Gem::Validator.const_set(:TestRunner, LocalTestRunner)
+          Gem::Validator.new.extend(LocalGemValidator).unit_test(spec)
+        end
+
+        task :prepare
+        task :test => :prepare
+
+        task :default
+        Rake.application[:default].prerequisites.unshift(Rake.application[:test])
+      end
+
+      private
+
+      module LocalGemSourceIndex #:nodoc:
+        attr_accessor :local_gemspec
+
+        def find_name(*args)
+          if args.first == local_gemspec.name
+            [local_gemspec]
+          else
+            super
+          end
+        end
+      end
+
+      module LocalGemValidator #:nodoc:
+        def alert_error(*args)
+          # no-op
         end
 
-        before(:default, :test)
+        def unit_test(*args)
+          unless super.passed?
+            exit 1
+          end
+        end
+      end
+
+      class LocalTestRunner < ::Test::Unit::UI::Console::TestRunner #:nodoc:
+        def self.run(*args)
+          new(args.first, ::Test::Unit::UI::NORMAL).start
+        end
       end
     end
 

data/lib/shoe/templates/gemspec.erb

@@ -25,6 +25,7 @@ Gem::Specification.new do |spec|
   spec.files       = spec.git_files
   spec.executables = spec.git_files('bin/*').map &File.method(:basename)
   spec.extensions  = spec.git_files('ext/**/extconf.rb')
+  spec.test_files  = spec.git_files('test/{,**/}*_test.rb')
 
   spec.extra_rdoc_files = spec.git_files('{,**/}*.rdoc')
   spec.rdoc_options     = %W(

data/lib/shoe/version.rb

@@ -1,3 +1,3 @@
 module Shoe
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 end

data/shoe.gemspec

@@ -5,8 +5,13 @@ Gem::Specification.new do |spec|
   spec.name    = 'shoe'
   spec.version = Shoe::VERSION
 
-  spec.summary = 'Another take on hoe, jeweler & friends.'
-  spec.description = spec.summary
+  spec.summary = 'An ecosystem-friendly library of Rake tasks for your gem.'
+  spec.description = <<-END.gsub(/^\s*/, '')
+    Shoe assumes you could be using any number of other tools -- bundler,
+    cucumber, git, rip, rubygems -- and so leans hard on them for the things
+    they do well, relegating command-line rake to mere syntactic sugar.
+  END
+
   spec.author = 'Matthew Todd'
   spec.email  = 'matthew.todd@gmail.com'
   spec.homepage = 'http://github.com/matthewtodd/shoe'
@@ -23,6 +28,7 @@ Gem::Specification.new do |spec|
   spec.files       = spec.git_files
   spec.executables = spec.git_files('bin/*').map &File.method(:basename)
   spec.extensions  = spec.git_files('ext/**/extconf.rb')
+  spec.test_files  = spec.git_files('test/{,**/}*_test.rb')
 
   spec.extra_rdoc_files = spec.git_files('{,**/}*.rdoc')
   spec.rdoc_options     = %W(

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 4
+  - 5
   - 0
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors: 
 - Matthew Todd
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-07 00:00:00 +03:00
+date: 2010-04-08 00:00:00 +03:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,20 +41,23 @@ dependencies:
         version: "0"
   type: :development
   version_requirements: *id002
-description: Another take on hoe, jeweler & friends.
+description: |
+  Shoe assumes you could be using any number of other tools -- bundler,
+  cucumber, git, rip, rubygems -- and so leans hard on them for the things
+  they do well, relegating command-line rake to mere syntactic sugar.
+
 email: matthew.todd@gmail.com
 executables: 
 - shoe
 extensions: []
 
 extra_rdoc_files: 
-- BUNDLER.rdoc
 - CHANGELOG.rdoc
 - README.rdoc
 - TODO.rdoc
+- doc/bundler.rdoc
 files: 
 - .gitignore
-- BUNDLER.rdoc
 - CHANGELOG.rdoc
 - Gemfile
 - Gemfile.lock
@@ -62,11 +65,14 @@ files:
 - Rakefile
 - TODO.rdoc
 - bin/shoe
+- cucumber.yml
+- doc/bundler.rdoc
 - features/cucumber.feature
 - features/getting_started.feature
 - features/release.feature
 - features/step_definitions/shoe_steps.rb
 - features/support/env.rb
+- features/test.feature
 - lib/shoe.rb
 - lib/shoe/generator.rb
 - lib/shoe/tasks.rb
@@ -92,7 +98,7 @@ rdoc_options:
 - --main
 - README.rdoc
 - --title
-- shoe-0.4.0
+- shoe-0.5.0
 - --inline-source
 require_paths: 
 - lib
@@ -118,6 +124,6 @@ rubyforge_project:
 rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
-summary: Another take on hoe, jeweler & friends.
+summary: An ecosystem-friendly library of Rake tasks for your gem.
 test_files: []