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

github.com/mynyml/phocus

rdocs

docs.github.com/mynyml/phocus