A super tight library to add contexts to tests.
Ruby
Switch branches/tags
Pull request Compare This branch is 26 commits ahead of jm:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
tasks
test
.document
.gitignore
License.txt
README.rdoc
Rakefile
VERSION
tu-context.gemspec

README.rdoc

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.