Skip to content

mynyml/phocus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

==== 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