Formerly known as MicroTest.

PryTest

aka pry-test

A small test framework that supports debugging test failures & errors when they happen.

Values

Simplicity - writing tests should be easy & devoid of friction
Intelligibility - tests should be readable & unambiguous
Immediacy - test failures should be dealt with quickly when they occur

Benefits

A simple test API
An awesome fail pry pass workflow
Optional async test runs

An important note on debugging test failures with Pry.

The API

Everything you need to know about PryTest's API is outlined here.

`PryTest::Test`	Superclass for all test classes.
`test(desc, &block)`	Defines a test method. `desc` - a description of what is being tested `&block` - a block of code which defines the test
`assert(value)`	Verifies the truthiness of a value. `value` - the value to assert
`refute(value)`	Verifies the falsiness of a value. `value` - the value to refute
`before(&block)`	A callback that runs before each test method. `&block` - the block of code to execute
`after(&block)`	A callback that runs after each test method. `&block` - the block of code to execute

A Complete Example

The entire public interface is used in this basic example.

class MathTest < PryTest::Test

  before do
    # runs before each test method
  end

  after do
    # runs after each test method
  end

  test "basic addition" do
    assert 2 + 2 == 4
  end

  test "all is right in the world" do
    refute 0 > 1
  end
end

Get Started

PryTest ships with a demo so you can try it out easily.

gem install pry-test
pry-test --help
pry-test --demo

Try some advanced features.

pry-test --demo --async
pry-test --demo --disable-pry

Testing Your Own Projects

PryTest assumes your test directory is located at PROJECT_ROOT/test; however, this isn't a requirement. You can indicate your test directory location.

pry-test /path/to/test/dir

If you have multiple versions of PryTest installed, it's safest to run your tests with bundle exec.

bundle exec pry-test /path/to/test/dir

PryTest is small & unobtrusive. It plays nice with other test frameworks, & can be introduced to existing projects incrementally.

Advanced

See the wiki to troubleshoot or get help with more advanced topics.

pry-test

Development

Runtime