coulda icon indicating copy to clipboard operation
coulda copied to clipboard

Given-when-then for Test::Unit (or "If shoulda and cucumber had a baby")

Coulda

Coulda gives you Cucumber-like BDD power but with an internal DSL. This means no "call-by-regexp" and no Gherkin/plain-text/external DSL. Coulda is just code -- but with a Cucumber-like take on BDD.

Coulda, obviously was inspired by Cucumber, Shoulda, but also Thor. Coulda believes that the best way to reuse code is the good ol' fashioned method. Instead of sharing files of regexps mapped to procs, you just write methods. That simple.

You can define the implementation of your Given/When/Then right there with the behavior description. Or, if you want to reuse some Givens/Whens/Thens, just write a method! And if you find your Feature is getting too bloated or that you would like to reuse Givens/Whens/Thens between features, put them in a helper.

Coulda also easily supports your Test::Unit framework of choice (including Rails Tests).

See http://coulda.tiggerpalace.com for more information.

Easy as pie.

require 'rubygems' require 'coulda' include Coulda

Coulda.default_testcase_class = ActiveSupport::TestCase

Feature "feature name" do in_order_to "foo" as_a "bar" i_want_to "blech"

def given_something
end

Scenario "pending scenario"

Scenario "another scenario" do
  Given "a pending prereq"
  When "something happens" do
    # an event here
  end
  Then "expect something else" do
    # assert something here
  end
end

Scenario "that is live" do
  given_something
  When "bar" do; end
  Then "blech" do; end
end

end

Thanks to

  • David Chelimsky and Jim Weirich for turning me into the test-obsessed developer that I am.
  • Timothy King for putting up with my scotch-powered rambling while working on v0.4.0
  • We Are Titans (http://www.wearetitans.net/) for sponsoring v0.4.0 through 0.5.5