RSpec-1.1.0 is released

The RSpec Development Team is pleased as glug (that's kind of like punch, but more festive) to announce RSpec-1.1.0.

Thanks to all who have contributed patches over the last few months. Big thanks to Dan North and Brian Takita for their important work on this release. Dan contributed his rbehave framework which is now the Story Runner. Brian patiently did a TON of refactoring around interoperability with Test::Unit, and the result is a much cleaner RSpec core, and a clean adapter model that gets loaded when Test::Unit is on the path.

== RSpec 1.1 brings four significant changes for RSpec users:

* The RSpec Story Runner * Nested Example Groups * Support for Rails 2.0.1 * Test::Unit interoperability

== Story Runner

The RSpec Story Runner is Dan North's rbehave framework merged into RSpec. The Story Runner is a framework for expressing high level requirements in the form of executable User Stories with Scenarios that represent Customer Acceptance Tests.

RSpec 1.1 also ships with a Ruby on Rails extension called RailsStory, which lets you write executable user stories for your rails apps as well.

== Nested Example Groups

Now you can nest groups to organize things a bit better:

describe RubyDeveloper do

  before(:each) do     @ruby_developer = RubyDeveloper.new   end

  describe "using RSpec 1.1.0" do

    before(:each) do       @ruby_developer.use_rspec('1.1.0')     end

    it "should be able to nest example groups" do       @ruby_developer.should be_able_to_nest_example_groups     end

  end

  describe "using RSpec 1.0.1" do

    before(:each) do       @ruby_developer.use_rspec('1.0.8')     end

    it "should not be able to nest example groups" do       @ruby_developer.should_not be_able_to_nest_example_groups     end

  end

end

Running this outputs:

RubyDeveloper using RSpec 1.1.0 - should be able to nest example groups

RubyDeveloper using RSpec 1.0.8 - should not be able to nest example groups

== Support for Rails 2.0.1

gem install rails rails myapp ruby script/install http://rspec.rubyforge.org/svn/tags/REL_1_1_0/rspec ruby script/install http://rspec.rubyforge.org/svn/tags/REL_1_1_0/rspec_on_rails script/generate rspec

== Test::Unit Interoperability

Contrary to popular belief, Spec::Rails, RSpec's Ruby on Rails plugin, has been a Test::Unit wrapper since the the 0.7 release in November of 2006. RSpec 1.1 ups the ante though, offering a smooth transition from Test::Unit to RSpec with or without Rails:

1. Start with a TestCase:

require 'test/unit'

class TransitionTest < Test::Unit::TestCase   def test_should_be_smooth     transition = Transition.new(       :from => "Test::Unit::TestCase",       :to => "Spec::ExampleGroup"     )     assert_equal "really smooth", transition.in_practice   end end 2. Require 'spec'

require 'test/unit' require 'spec'

class TransitionTest < Test::Unit::TestCase   def test_should_be_smooth     transition = Transition.new(       :from => "Test::Unit::TestCase",       :to => "Spec::ExampleGroup"     )     assert_equal "really smooth", transition.in_practice   end end 3. Convert TestCase to ExampleGroup

require 'test/unit' require 'spec'

describe "transitioning from TestCase to ExampleGroup" do   def test_should_be_smooth     transition = Transition.new(       :from => "Test::Unit::TestCase",       :to => "Spec::ExampleGroup"     )     assert_equal "really smooth", transition.in_practice   end end 4. Convert test methods to examples

require 'test/unit' require 'spec'

describe "transitioning from TestCase to ExampleGroup" do   it "should be smooth" do     transition = Transition.new(       :from => "Test::Unit::TestCase",       :to => "Spec::ExampleGroup"     )     assert_equal "really smooth", transition.in_practice   end end 5. Convert assertions to expectations

require 'test/unit' require 'spec'

describe "transitioning from TestCase to ExampleGroup" do   it "should be smooth" do     transition = Transition.new(       :from => "Test::Unit::TestCase",       :to => "Spec::ExampleGroup")     transition.in_practice.should == "really smooth"   end end 6. Un-require test/unit

require 'spec'

describe "transitioning from TestCase to ExampleGroup" do   it "should be smooth" do     transition = Transition.new(       :from => "Test::Unit::TestCase",       :to => "Spec::ExampleGroup"     )     transition.in_practice.should == "really smooth"   end end At every one of these steps after step 2, you can run the file with the ruby command and you'll be getting RSpec's developer friendly output. This means that you can transition things as gradually as you like: no wholesale changes.

That's the story. Thanks again to all who contributed and to all who continue do so.

Congratulations!! Very cool.

Pat

Wow, did you really need to quote the ENTIRE email just to put in a ONE word reply?

I think you mean three words, plus two exclamation marks :slight_smile:

Pat

Funny.