rspec-core 2.0.0.a2 → 2.0.0.a3

data/.document

@@ -1,5 +1,5 @@
-README.rdoc
+README.markdown
 lib/**/*.rb
 bin/*
 features/**/*.feature
-LICENSE
+License.txt

data/.gitignore

@@ -1,6 +1,7 @@
 *.sw?
 .DS_Store
 coverage*
+doc
 rdoc
 pkg
 tmp

data/README.markdown

@@ -1,11 +1,17 @@
 # RSpec Core
 
-See README.markdown at [http://github.com/rspec/meta](http://github.com/rspec/meta)
+rspec-core includes the runner, output formatters, and the `rspec` command.
 
-#### Also see
+rspec-core is currently in alpha release. While you are welcome to track, fork,
+explore, etc, we're too early in the process to start fielding pull requests
+and or issues from outside the core development team, so please don't waste
+your time until this notice changes.
 
-* [http://github.com/rspec/rspec-expectations](http://github.com/rspec/rspec-expectations)
-* [http://github.com/rspec/rspec-mocks](http://github.com/rspec/rspec-mocks)
+## Install
+
+    [sudo] gem install rspec --prerelease
+
+This will install rspec, rspec-core, rspec-expectations and rspec-mocks.
 
 ## Known Issues
 
@@ -38,3 +44,11 @@ You can, of course, fully qualify the declaration and everything works fine:
         Foo.new
       end
     end
+
+#### Also see
+
+* [http://github.com/rspec/rspec](http://github.com/rspec/rspec)
+* [http://github.com/rspec/rspec-expectations](http://github.com/rspec/rspec-expectations)
+* [http://github.com/rspec/rspec-mocks](http://github.com/rspec/rspec-mocks)
+* [http://github.com/rspec/rspec-dev](http://github.com/rspec/rspec-dev)
+

data/Rakefile

@@ -15,16 +15,15 @@ begin
   Jeweler::Tasks.new do |gem|
     gem.name = "rspec-core"
     gem.version = Rspec::Core::Version::STRING
-    gem.rubyforge_project = "rspec"
-    gem.summary = 'Rspec runner and example group classes'
+    gem.summary = Rspec::Core::Version::SUMMARY
+    gem.description = 'Rspec runner and example group classes'
     gem.email = "dchelimsky@gmail.com;chad.humphries@gmail.com"
     gem.homepage = "http://github.com/rspec/core"
     gem.authors = ["David Chelimsky", "Chad Humphries"]
-    gem.version = Rspec::Core::Version::STRING
+    gem.rubyforge_project = "rspec"
     gem.add_development_dependency "rspec-expectations", ">= #{Rspec::Core::Version::STRING}"
     gem.add_development_dependency "rspec-mocks", ">= #{Rspec::Core::Version::STRING}"
     gem.add_development_dependency('cucumber', '>= 0.5.3')
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError
@@ -32,16 +31,13 @@ rescue LoadError
 end
 
 begin
-  Rspec::Core::RakeTask.new :spec do |t|
-    t.pattern = "spec/**/*_spec.rb"
-  end
+  Rspec::Core::RakeTask.new :spec
 
   desc "Run all examples using rcov"
   Rspec::Core::RakeTask.new :rcov => :cleanup_rcov_files do |t|
     t.rcov = true
     t.rcov_opts =  %[-Ilib -Ispec --exclude "mocks,expectations,gems/*,spec/resources,spec/lib,spec/spec_helper.rb,db/*,/Library/Ruby/*,config/*"]
     t.rcov_opts << %[--no-html --aggregate coverage.data]
-    t.pattern = "spec/**/*_spec.rb"
   end
 rescue LoadError
   puts "Rspec core or one of its dependencies is not installed. Install it with: gem install rspec-meta"
@@ -57,7 +53,7 @@ task :clobber do
   rm_rf 'coverage'
 end
 
-if RUBY_VERSION == '1.9.1'
+if RUBY_VERSION.to_f >= 1.9
   Cucumber::Rake::Task.new :features do |t|
     t.cucumber_opts = %w{--format progress}
   end
@@ -76,15 +72,8 @@ end
 
 
 Rake::RDocTask.new do |rdoc|
-  if File.exist?('VERSION.yml')
-    config = YAML.load(File.read('VERSION.yml'))
-    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
-  else
-    version = ""
-  end
-
   rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "rspec-core #{version}"
+  rdoc.title = "rspec-core #{Rspec::Core::Version::STRING}"
   rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end

data/bin/rspec

@@ -1,10 +1,2 @@
 #!/usr/bin/env ruby
-$LOAD_PATH.unshift(File.expand_path('../../lib', __FILE__))
-$LOAD_PATH.unshift(File.expand_path('../../../rspec-expectations/lib', __FILE__))
-$LOAD_PATH.unshift(File.expand_path('../../../rspec-mocks/lib', __FILE__))
-require 'rspec/expectations'
-require 'rspec/mocks'
 require 'rspec/autorun'
-
-# TODO - this feels odd here - move to runner?
-Rspec::Core::ExampleGroup.send(:include, Rspec::Matchers)

data/example_specs/failing/README.txt

@@ -4,4 +4,4 @@ They allow us to see failure messages. RSpec wants to provide meaningful and hel
 
 To see the types of messages you can expect, stand in this directory and run:
 
-../bin/spec ./*.rb
+../bin/rspec ./*.rb

data/example_specs/failing/spec_helper.rb

@@ -1,3 +1,8 @@
-lib_path = File.expand_path(File.dirname(__FILE__) + "/../../lib")
+lib_path = File.expand_path('../../../lib', __FILE__)
 $LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
-require 'spec/autorun'
+require 'rspec/autorun'
+require 'rspec/expectations'
+
+Rspec::Core.configure do |c|
+  c.include Rspec::Matchers
+end

data/example_specs/failing/team_spec.rb

@@ -1,6 +1,5 @@
 require File.dirname(__FILE__) + '/spec_helper'
 
-
 class Team
   attr_reader :players
   def initialize

data/features/before_and_after_blocks/around.feature

@@ -3,6 +3,8 @@ Feature: before and after blocks
   Scenario: define around(:each) block in example group
     Given a file named "around_each_in_example_group_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       class Thing
         def self.cache
           @cache ||= []

data/features/command_line/example_name_option.feature

@@ -0,0 +1,54 @@
+Feature: example name option
+
+  Use the --example (or -e) option to filter the examples to be run by name.
+
+  The submitted argument is compiled to a Ruby Regexp, and matched against the
+  full description of the example, which is the concatenation of descriptions
+  of the group (including any nested groups) and the example.
+
+  This allows you to run a single uniquely named example, all examples with
+  similar names, all the example in a uniquely named group, etc, etc.
+
+  Background:
+    Given a file named "first_spec.rb" with:
+      """
+      describe "first group" do
+        it "first example in first group" do; end
+        it "second example in first group" do; end
+      end
+      """
+    Given a file named "second_spec.rb" with:
+      """
+      describe "second group" do
+        it "first example in second group" do; end
+        it "second example in second group" do; end
+      end
+      """
+
+  Scenario: no matches
+    When I run "spec . --example nothing_like_this"
+    Then the stdout should match "0 examples, 0 failures"
+
+  Scenario: all matches
+    When I run "spec . --example example"
+    Then the stdout should match "4 examples, 0 failures"
+
+  Scenario: one match in each file
+    When I run "spec . --example 'first example'"
+    Then the stdout should match "2 examples, 0 failures"
+
+  Scenario: one match in one file
+    When I run "spec . --example 'first example in first group'"
+    Then the stdout should match "1 example, 0 failures"
+
+  Scenario: one match in one file using regexp
+    When I run "spec . --example 'first .* first example'"
+    Then the stdout should match "1 example, 0 failures"
+
+  Scenario: all examples in one group
+    When I run "spec . --example 'first group'"
+    Then the stdout should match "2 examples, 0 failures"
+
+  Scenario: one match in one file with group name
+    When I run "spec . --example 'second group first example'"
+    Then the stdout should match "1 example, 0 failures"

data/features/command_line/line_number_appended_to_path.feature

@@ -0,0 +1,39 @@
+Feature: line number appended to file path
+
+  As an RSpec user
+  I want to run one example identified by the 
+    line number appended to the filepath
+  
+  Background:
+    Given a file named "example_spec.rb" with:
+      """
+      describe "a group" do
+
+        it "has a first example" do
+
+        end
+        
+        it "has a second example" do
+
+        end
+        
+      end
+      """
+
+  Scenario: two examples - both examples from the group declaration
+    When I run "spec example_spec.rb:1 --format doc"
+    Then the stdout should match "2 examples, 0 failures"
+    And the stdout should match "has a second example"
+    And the stdout should match "has a first example"
+
+  Scenario: two examples - first example on declaration line
+    When I run "spec example_spec.rb:3 --format doc"
+    Then the stdout should match "1 example, 0 failures"
+    And the stdout should match "has a first example"
+    But the stdout should not match "has a second example"
+
+  Scenario: two examples - second example on declaration line
+    When I run "spec example_spec.rb:7 --format doc"
+    Then the stdout should match "1 example, 0 failures"
+    And the stdout should match "has a second example"
+    But the stdout should not match "has a first example"

data/features/command_line/line_number_option.feature

@@ -0,0 +1,40 @@
+Feature: line number option
+
+  As an Rspec user
+  I want to run one example identified by the line number
+  
+  Scenario: standard examples
+    Given a file named "example_spec.rb" with:
+      """
+      describe 9 do
+
+        it "should be > 8" do
+          9.should be > 8
+        end
+
+        it "should be < 10" do
+          9.should be < 10
+        end
+        
+      end
+      """
+    When I run "spec example_spec.rb --line 3 --format doc"
+    Then the stdout should match "1 example, 0 failures"
+    Then the stdout should match "should be > 8"
+    But the stdout should not match "should be < 10"
+
+  Scenario: one liner
+    Given a file named "example_spec.rb" with:
+      """
+      describe 9 do
+
+        it { should be > 8 }
+
+        it { should be < 10 }
+        
+      end
+      """
+    When I run "spec example_spec.rb --line 3 --format doc"
+    Then the stdout should match "1 example, 0 failures"
+    Then the stdout should match "should be > 8"
+    But the stdout should not match "should be < 10"

data/features/matchers/define_matcher.feature

@@ -7,6 +7,8 @@ Feature: define matcher
   Scenario: define a matcher with default messages
     Given a file named "matcher_with_default_message_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :be_a_multiple_of do |expected|
         match do |actual|
           actual % expected == 0
@@ -37,8 +39,8 @@ Feature: define matcher
 
     And the stdout should match "should be a multiple of 3"
     And the stdout should match "should not be a multiple of 4"
-    And the stdout should match "should be a multiple of 4\n    Failure"
-    And the stdout should match "should not be a multiple of 3\n    Failure"
+    And the stdout should match "Failure/Error: it {should be_a_multiple_of(4)}"
+    And the stdout should match "Failure/Error: it {should_not be_a_multiple_of(3)}"
 
     And the stdout should match "4 examples, 2 failures"
     And the stdout should match "expected 9 to be a multiple of 4"
@@ -47,6 +49,8 @@ Feature: define matcher
   Scenario: overriding the failure_message_for_should
     Given a file named "matcher_with_failure_message_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :be_a_multiple_of do |expected|
         match do |actual|
           actual % expected == 0
@@ -69,6 +73,8 @@ Feature: define matcher
   Scenario: overriding the failure_message_for_should_not
     Given a file named "matcher_with_failure_for_message_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :be_a_multiple_of do |expected|
         match do |actual|
           actual % expected == 0
@@ -91,6 +97,8 @@ Feature: define matcher
   Scenario: overriding the description
     Given a file named "matcher_overriding_description_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :be_a_multiple_of do |expected|
         match do |actual|
           actual % expected == 0
@@ -117,6 +125,8 @@ Feature: define matcher
   Scenario: with no args
     Given a file named "matcher_with_no_args_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :have_7_fingers do
         match do |thing|
           thing.fingers.length == 7
@@ -139,6 +149,8 @@ Feature: define matcher
   Scenario: with multiple args
     Given a file named "matcher_with_multiple_args_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :be_the_sum_of do |a,b,c,d|
         match do |sum|
           a + b + c + d == sum
@@ -157,16 +169,18 @@ Feature: define matcher
   Scenario: with helper methods
     Given a file named "matcher_with_internal_helper_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Matchers.define :have_same_elements_as do |sample|
         match do |actual|
           similar?(sample, actual)
         end
-        
+
         def similar?(a, b)
           a.sort == b.sort
         end
       end
-      
+
       describe "these two arrays" do
         specify "should be similar" do
           [1,2,3].should have_same_elements_as([2,3,1])

data/features/matchers/define_matcher_outside_rspec.feature

@@ -7,7 +7,6 @@ Feature: define matcher outside rspec
   Scenario: define a matcher with default messages
     Given a file named "test_multiples.rb" with:
       """
-      $:.unshift File.join(File.dirname(__FILE__), "/../../lib")
       require 'test/unit'
       require 'rspec/expectations'
       
@@ -36,4 +35,4 @@ Feature: define matcher outside rspec
     When I run "ruby test_multiples.rb"
     Then the exit code should be 256
     And the stdout should match "expected 9 to be a multiple of 4"
-    And the stdout should match "2 tests, 0 assertions, 1 failures, 0 errors"
+    And the stdout should match "2 tests, 0 assertions, 0 failures, 1 errors"

data/features/mocks/mix_stubs_and_mocks.feature

@@ -6,6 +6,8 @@ Feature: Spec and test together
   Scenario: stub in before
     Given a file named "stub_and_mocks_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       Rspec::Core.configure do |config|
         config.mock_framework = :rspec
       end

data/features/subject/explicit_subject.feature

@@ -5,6 +5,8 @@ Feature: explicit subject
   Scenario: subject in top level group
     Given a file named "top_level_subject_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       describe Array, "with some elements" do
         subject { [1,2,3] }
         it "should have the prescribed elements" do
@@ -18,6 +20,8 @@ Feature: explicit subject
   Scenario: subject in a nested group
     Given a file named "nested_subject_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       describe Array do
         subject { [1,2,3] }
         describe "with some elements" do

data/features/subject/implicit_subject.feature

@@ -7,6 +7,8 @@ Feature: implicit subject
   Scenario: subject in top level group
     Given a file named "top_level_subject_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       describe Array, "when first created" do
         it "should be empty" do
           subject.should == []
@@ -19,6 +21,8 @@ Feature: implicit subject
   Scenario: subject in a nested group
     Given a file named "nested_subject_spec.rb" with:
       """
+      require 'rspec/expectations'
+
       describe Array do
         describe "when first created" do
           it "should be empty" do

data/features/support/env.rb

@@ -51,10 +51,24 @@ class RspecWorld
   def ruby(args)
     stderr_file = Tempfile.new('rspec')
     stderr_file.close
+    
     Dir.chdir(working_dir) do
-      @stdout = super("-rrubygems #{rspec_libs} #{args}", stderr_file.path)
+      File.open('load_paths.rb', 'w') do |f|
+        f.write <<-CONTENT
+$LOAD_PATH.unshift(File.expand_path('../../../lib', __FILE__))
+$LOAD_PATH.unshift(File.expand_path('../../../../rspec-expectations/lib', __FILE__))
+$LOAD_PATH.unshift(File.expand_path('../../../../rspec-mocks/lib', __FILE__))
+require 'rspec/core'
+require 'rspec/expectations'
+Rspec::Core::ExampleGroup.__send__(:include, Rspec::Matchers)
+CONTENT
+      end
+      cmd = "-rrubygems -rload_paths.rb #{rspec_libs} #{args}"
+      # p cmd
+      @stdout = super(cmd, stderr_file.path)
     end
     @stderr = IO.read(stderr_file.path)
+    p @stderr unless @stderr == ""
     @exit_code = $?.to_i
   end