rspec-core 2.11.1 → 2.12.0

data/Changelog.md

@@ -1,3 +1,62 @@
+### 2.12.0 / 2012-11-12
+[full changelog](http://github.com/rspec/rspec-core/compare/v2.11.1...2.12.0)
+
+Enhancements
+
+* Add support for custom ordering strategies for groups and examples.
+  (Myron Marston)
+* JSON Formatter (Alex Chaffee)
+* Refactor rake task internals (Sam Phippen)
+* Refactor HtmlFormatter (Pete Hodgson)
+* Autotest supports a path to Ruby that contains spaces (dsisnero)
+* Provide a helpful warning when a shared example group is redefined.
+  (Mark Burns).
+* `--default_path` can be specified as `--default-line`. `--line_number` can be
+  specified as `--line-number`. Hyphens are more idiomatic command line argument
+  separators (Sam Phippen).
+* A more useful error message is shown when an invalid command line option is
+  used (Jordi Polo).
+* Add `format_docstrings { |str| }` config option. It can be used to
+  apply formatting rules to example group and example docstrings.
+  (Alex Tan)
+* Add support for an `.rspec-local` options file. This is intended to
+  allow individual developers to set options in a git-ignored file that
+  override the common project options in `.rspec`. (Sam Phippen)
+* Support for mocha 0.13.0. (Andy Lindeman)
+
+Bug fixes
+
+* Remove override of `ExampleGroup#ancestors`. This is a core ruby method that
+  RSpec shouldn't override. Instead, define `ExampleGroup#parent_groups`. (Myron
+  Marston)
+* Limit monkey patching of shared example/context declaration methods
+  (`shared_examples_for`, etc.) to just the objects that need it rather than
+  every object in the system (Myron Marston).
+* Fix Metadata#fetch to support computed values (Sam Goldman).
+* Named subject can now be referred to from within subject block in a nested
+  group (tomykaira).
+* Fix `fail_fast` so that it properly exits when an error occurs in a
+  `before(:all) hook` (Bradley Schaefer).
+* Make the order spec files are loaded consistent, regardless of the
+  order of the files returned by the OS or the order passed at
+  the command line (Jo Liss and Sam Phippen).
+* Ensure instance variables from `before(:all)` are always exposed
+  from `after(:all)`, even if an error occurs in `before(:all)`
+  (Sam Phippen).
+* `rspec --init` no longer generates an incorrect warning about `--configure`
+  being deprecated (Sam Phippen).
+* Fix pluralization of `1 seconds` (Odin Dutton)
+* Fix ANSICON url (Jarmo Pertman)
+* Use dup of Time so reporting isn't clobbered by examples that modify Time
+  without properly restoring it. (David Chelimsky)
+
+Deprecations
+
+* `share_as` is no longer needed. `shared_context` and/or
+  `RSpec::SharedContext` provide better mechanisms (Sam Phippen).
+* Deprecate `RSpec.configuration` with a block (use `RSpec.configure`).
+
+
 ### 2.11.1 / 2012-07-18
 [full changelog](http://github.com/rspec/rspec-core/compare/v2.11.0...v2.11.1)
 

data/README.md

@@ -167,6 +167,28 @@ the command line.
 rspec-core ships with an Autotest extension, which is loaded automatically if
 there is a `.rspec` file in the project's root directory.
 
+## rcov integration
+
+rcov is best integrated via the [rcov rake
+task](http://www.rubydoc.info/github/relevance/rcov/master/Rcov/RcovTask).
+
+rcov can also be integrated via the rspec rake task, but it requires a bit
+more setup:
+
+```ruby
+# Rakefile
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |config|
+  config.rcov = true
+end
+
+task :default => :spec
+
+# spec/spec_helper.rb
+require 'rspec/autorun' # **add this**
+```
+
 ## get started
 
 Start with a simple example of behavior you expect from your system. Do

data/features/command_line/example_name_option.feature

@@ -13,21 +13,21 @@ Feature: --example option
 
   Background:
     Given a file named "first_spec.rb" with:
-      """
+      """ruby
       describe "first group" do
         it "first example in first group" do; end
         it "second example in first group" do; end
       end
       """
     And a file named "second_spec.rb" with:
-      """
+      """ruby
       describe "second group" do
         it "first example in second group" do; end
         it "second example in second group" do; end
       end
       """
     And a file named "third_spec.rb" with:
-      """
+      """ruby
       describe "third group" do
         it "first example in third group" do; end
         context "nested group" do
@@ -37,7 +37,7 @@ Feature: --example option
       end
       """
     And a file named "fourth_spec.rb" with:
-      """
+      """ruby
       describe Array do
         describe "#length" do
           it "is the number of items" do
@@ -98,4 +98,4 @@ Feature: --example option
     And the output should not contain any of these:
       |first example in third group|
       |nested group first example in nested group|
-      |nested group second example in nested group|
+      |nested group second example in nested group|

data/features/command_line/exit_status.feature

@@ -6,7 +6,7 @@ Feature: exit status
 
   Scenario: exit with 0 when all examples pass
     Given a file named "ok_spec.rb" with:
-      """
+      """ruby
       describe "ok" do
         it "passes" do
         end
@@ -18,7 +18,7 @@ Feature: exit status
 
   Scenario: exit with 1 when one example fails
     Given a file named "ko_spec.rb" with:
-      """
+      """ruby
       describe "KO" do
         it "fails" do
           raise "KO"
@@ -31,7 +31,7 @@ Feature: exit status
 
   Scenario: exit with 1 when a nested examples fails
     Given a file named "nested_ko_spec.rb" with:
-      """
+      """ruby
       describe "KO" do
         describe "nested" do
           it "fails" do
@@ -46,7 +46,7 @@ Feature: exit status
 
   Scenario: exit with 0 when no examples are run
     Given a file named "a_no_examples_spec.rb" with:
-      """
+      """ruby
       """
     When I run `rspec a_no_examples_spec.rb`
     Then the exit status should be 0
@@ -54,7 +54,7 @@ Feature: exit status
 
   Scenario: exit with 2 when one example fails and --failure-exit-code is 2
     Given a file named "ko_spec.rb" with:
-      """
+      """ruby
       describe "KO" do
         it "fails" do
           raise "KO"
@@ -68,7 +68,7 @@ Feature: exit status
   @wip
   Scenario: exit with rspec's exit code when an at_exit hook is added upstream
     Given a file named "exit_at_spec.rb" with:
-      """
+      """ruby
       require 'rspec/autorun'
 
       describe "exit 0 at_exit" do

data/features/command_line/format_option.feature

@@ -17,7 +17,7 @@ Feature: --format option
   You can also specify an output target (STDOUT by default) by appending a
   filename to the argument:
 
-    $ rspec spec --format documentation:rspec.output.txt
+    $ rspec spec --format documentation --out rspec.txt
 
   `rspec --help` lists available formatters:
 
@@ -29,7 +29,7 @@ Feature: --format option
 
   Background:
     Given a file named "example_spec.rb" with:
-      """
+      """ruby
       describe "something" do
         it "does something that passes" do
           5.should eq(5)

data/features/command_line/line_number_appended_to_path.feature

@@ -6,7 +6,7 @@ Feature: line number appended to file path
   
   Background:
     Given a file named "example_spec.rb" with:
-      """
+      """ruby
       describe "outer group" do
 
         it "first example in outer group" do
@@ -28,7 +28,7 @@ Feature: line number appended to file path
       end
       """
     And a file named "example2_spec.rb" with:
-      """
+      """ruby
       describe "yet another group" do
         it "first example in second file" do
         end

data/features/command_line/line_number_option.feature

@@ -8,7 +8,7 @@ Feature: --line_number option
 
   Scenario: standard examples
     Given a file named "example_spec.rb" with:
-      """
+      """ruby
       require "rspec/expectations"
 
       describe 9 do
@@ -41,7 +41,7 @@ Feature: --line_number option
 
   Scenario: one liner
     Given a file named "example_spec.rb" with:
-      """
+      """ruby
       require "rspec/expectations"
 
       describe 9 do

data/features/command_line/pattern_option.feature

@@ -8,7 +8,7 @@ Feature: pattern option
 
   Scenario: default pattern
     Given a file named "spec/example_spec.rb" with:
-      """
+      """ruby
       describe "addition" do
         it "adds things" do
           (1 + 2).should eq(3)
@@ -20,7 +20,7 @@ Feature: pattern option
 
   Scenario: override the default pattern on the command line
     Given a file named "spec/example.spec" with:
-      """
+      """ruby
       describe "addition" do
         it "adds things" do
           (1 + 2).should eq(3)

data/features/command_line/rake_task.feature

@@ -4,7 +4,7 @@ Feature: rake task
 
   Scenario: default options with passing spec (prints command and exit status is 0)
     Given a file named "Rakefile" with:
-      """
+      """ruby
       require 'rspec/core/rake_task'
 
       RSpec::Core::RakeTask.new(:spec)
@@ -12,7 +12,7 @@ Feature: rake task
       task :default => :spec
       """
     And a file named "spec/thing_spec.rb" with:
-      """
+      """ruby
       describe "something" do
         it "does something" do
           # pass
@@ -20,12 +20,12 @@ Feature: rake task
       end
       """
     When I run `rake`
-    Then the output should contain "ruby -S rspec"
+    Then the output should match /(ruby|rbx) -S rspec/
     Then the exit status should be 0
 
   Scenario: default options with failing spec (exit status is 1)
     Given a file named "Rakefile" with:
-      """
+      """ruby
       require 'rspec/core/rake_task'
 
       RSpec::Core::RakeTask.new(:spec)
@@ -33,7 +33,7 @@ Feature: rake task
       task :default => :spec
       """
     And a file named "spec/thing_spec.rb" with:
-      """
+      """ruby
       describe "something" do
         it "does something" do
           fail
@@ -45,7 +45,7 @@ Feature: rake task
       
   Scenario: fail_on_error = false with failing spec (exit status is 0)
     Given a file named "Rakefile" with:
-      """
+      """ruby
       require 'rspec/core/rake_task'
 
       RSpec::Core::RakeTask.new(:spec) do |t|
@@ -55,7 +55,7 @@ Feature: rake task
       task :default => :spec
       """
     And a file named "spec/thing_spec.rb" with:
-      """
+      """ruby
       describe "something" do
         it "does something" do
           fail
@@ -64,5 +64,59 @@ Feature: rake task
       """
     When I run `rake`
     Then the exit status should be 0
-      
 
+  Scenario: rspec_opts is specified in order to pass args to the rspec command
+    Given a file named "Rakefile" with:
+      """ruby
+      require 'rspec/core/rake_task'
+
+      RSpec::Core::RakeTask.new(:spec) do |t|
+        t.rspec_opts = "--tag fast"
+      end
+      """
+    And a file named "spec/thing_spec.rb" with:
+      """ruby
+      describe "something" do
+        it "has a tag", :fast => true do
+          # pass
+        end
+
+        it "does not have a tag" do
+          fail
+        end
+      end
+      """
+    When I run `rake spec`
+    Then the exit status should be 0
+    Then the output should match:
+      """
+      (ruby|rbx) -S rspec ./spec/thing_spec.rb --tag fast
+      """
+
+  Scenario: rspec_opts is specified using arguments to the rake task
+    Given a file named "Rakefile" with:
+      """ruby
+      require 'rspec/core/rake_task'
+
+      RSpec::Core::RakeTask.new(:spec, :tag) do |t, task_args|
+        t.rspec_opts = "--tag #{task_args[:tag]}"
+      end
+      """
+    And a file named "spec/thing_spec.rb" with:
+      """ruby
+      describe "something" do
+        it "has a tag", :fast => true do
+          # pass
+        end
+
+        it "does not have a tag" do
+          fail
+        end
+      end
+      """
+    When I run `rake spec[fast]`
+    Then the exit status should be 0
+    Then the output should match:
+      """
+      (ruby|rbx) -S rspec ./spec/thing_spec.rb --tag fast
+      """

data/features/command_line/ruby.feature

@@ -9,7 +9,7 @@ Feature: run with ruby command
 
   Scenario:
     Given a file named "example_spec.rb" with:
-      """
+      """ruby
       require 'rspec/autorun'
 
       describe 1 do

data/features/command_line/tag.feature

@@ -16,7 +16,7 @@ Feature: --tag option
 
   Background:
     Given a file named "tagged_spec.rb" with:
-      """
+      """ruby
       describe "group with tagged specs" do
         it "example I'm working now", :focus => true do; end
         it "special example with string", :type => 'special' do; end

data/features/configuration/alias_example_to.feature

@@ -8,7 +8,7 @@ Feature: alias_example_to
 
   Scenario: Use alias_example_to to define focused example
     Given a file named "alias_example_to_spec.rb" with:
-      """
+      """ruby
       RSpec.configure do |c|
         c.alias_example_to :fit, :focused => true
         c.filter_run :focused => true
@@ -28,7 +28,7 @@ Feature: alias_example_to
 
   Scenario: use symbols as metadata
     Given a file named "use_symbols_as_metadata_spec.rb" with:
-      """
+      """ruby
       RSpec.configure do |c|
         c.treat_symbols_as_metadata_keys_with_true_values = true
         c.alias_example_to :fit, :focused

data/features/configuration/custom_settings.feature

@@ -4,7 +4,7 @@ Feature: custom settings
 
   Scenario: simple setting (with defaults)
     Given a file named "additional_setting_spec.rb" with:
-      """
+      """ruby
       RSpec.configure do |c|
         c.add_setting :custom_setting
       end
@@ -34,7 +34,7 @@ Feature: custom settings
 
   Scenario: default to true
     Given a file named "additional_setting_spec.rb" with:
-      """
+      """ruby
       RSpec.configure do |c|
         c.add_setting :custom_setting, :default => true
       end
@@ -60,7 +60,7 @@ Feature: custom settings
 
   Scenario: overridden in a subsequent RSpec.configure block
     Given a file named "additional_setting_spec.rb" with:
-      """
+      """ruby
       RSpec.configure do |c|
         c.add_setting :custom_setting
       end

data/features/configuration/default_path.feature

@@ -13,7 +13,7 @@ Feature: default_path
 
   Scenario: run `rspec` with default default_path (`spec` directory)
     Given a file named "spec/example_spec.rb" with:
-      """
+      """ruby
       describe "an example" do
         it "passes" do
         end
@@ -21,14 +21,14 @@ Feature: default_path
       """
     When I run `rspec`
     Then the output should contain "1 example, 0 failures"
-    
+
   Scenario: run `rspec` with customized default_path
     Given a file named ".rspec" with:
       """
       --default_path behavior
       """
     Given a file named "behavior/example_spec.rb" with:
-      """      
+      """ruby
       describe "an example" do
         it "passes" do
         end