phocus

phocus copied to clipboard

==== Summary

Phocus let's you temporarily focus some tests, ignoring all others, even across test classes.

==== Install

gem install phocus --source http://gemcutter.org

==== Features

• Ultra simple to use
• Works accross testcase classes
• Works within contexts
• Can focus multiple tests
• Simple code (< 50 LOCs)
• Compatible with various testing frameworks

==== Examples

require 'test/unit' require 'phocus'

class TestUser < Test::Unit::TestCase

focus
def test_foo
  assert User.do_something
end

def test_bar
  assert User.do_something_else
end

end

class TestAcmeWidget < Test::Unit::TestCase

def test_abc
  assert true
end

focus
def test_xyz
  assert true
end

end

Executing these tests (say with +rake test+ or +autotest+), will only run +test_foo+ and +test_xyz+.

Also works fine with +test "description"+ style tests (or +it+, or +should+, ...).

focus
test "abc" do
  assert true
end

==== Testing Framework Compatibility

Phocus is known to be compatible with the following testing frameworks (see test/compat/*):

• test/unit
• minitest/unit
• shoulda
• context
• contest

It is possibly compatible out of the box with other test/unit-based testing frameworks as well, but it should be fairly easy to set up if it isn't (include Phocus in parent testcase class and set proper method_pattern. See rdocs)

==== Links

source:: http://github.com/mynyml/phocus rdocs:: http://docs.github.com/mynyml/phocus