tu-context – Adds context blocks for Test::Unit¶ ↑

github.com/djsun/context github.com/jeremymcanally/context

DESCRIPTION:¶ ↑

If you’ve ever wanted contexts in your Test::Unit tests, then context is for you. Your tests will be easier to read and write without all the magic and extra code smell!

FEATURES/PROBLEMS:¶ ↑

Add contexts to Test::Unit tests
Small DSL for specifying tests that are pretty
Ability to chain context lifecycle methods (coming soon)

SYNOPSIS:¶ ↑

Add contexts using familiar syntax:

class UserTest < Test::Unit::TestCase
  context "A new User" do
    # Before/after lifecycle blocks
    before do
      @user = User.first
    end

    # Specify tests using DSL
    test "should have the right full_name" do
      assert_equal "Dude Man", @user.full_name
    end

    test "should be able to set parts of the name" do
      @user.first_name = "Mad"
      @user.last_name = "Max"
      @user.save
      assert_equal "Mad Max", @user.full_name
    end

    after do
      @user.first_name = "Dude"
      @user.last_name = "Man"
      @user.save!
    end
  end
end

It also has aliases that match other library’s syntaxes (all of which can be mixed and matched):

class UserTest < Test::Unit::TestCase
  context "A new Account" do
    test "should be new" do
      Account.new.new_record?
    end
  end

  # RSpec-esque
  describe "A new User" do
    it "should do things" do
      User.first.do_things!
    end
  end

  # Shoulda-esque
  context "Another User" do
    should "do things that are fun" do
      User.first.do_things!(:fun)
    end
  end
end

Contexts can also be nested:

class UserTest < Test::Unit::TestCase
  context "A new User" do
    context "with clown shoes" do
      test "should squeak" do
        assert_true User.find_by_shoes("clown").squeak?
      end
    end

    context "without clown shoes" do
      test "should not squeak" do
        assert_false User.find_by_shoes("dressy").squeak?
      end
    end
  end
end

You can also share behavior among contexts:

class UserTest < Test::Unit::TestCase
  shared "shared things" do
    test "things are shared" do
      # test logic here...
    end
  end

  context "the first thing" do
    uses "shared things"

    test "other things..." do
      # More testing...
    end
  end
end

Shared behaviors can also use RSpec syntax

class UserTest < Test::Unit::TestCase
  share_examples_for "shared things" do
    it "things are shared" do
      # test logic here...
    end
  end

  describe "the first thing" do
    it_should_behave_like "shared things"

    it "other things..." do
      # More testing...
    end
  end
end

REQUIREMENTS:¶ ↑

Test::Unit (you have it; trust me)

INSTALL:¶ ↑

$ gem sources -a http://gems.github.com
$ sudo gem install jeremymcanally-context

ACKNOWLEDGEMENTS:¶ ↑

Original implementation by Jeremy McAnally, but heavily tweaked and borrowed from Rails Core and Pratik Naik. Repackaged as the tu-context gem by David James after pulling together various Github forks.

djsun / context