Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Test::Unit runner that can run tests by line number.
Ruby
branch: master

README.md

M.RB

m stands for metal, a better test/unit test runner that can run tests by line number.

________________________________________________________________________________
_________________________/\\\\____________/\\\\_________________________________
_________________________\/\\\\\\________/\\\\\\________________________________
__________________________\/\\\//\\\____/\\\//\\\_______________________________
___________________________\/\\\\///\\\/\\\/_\/\\\______________________________
____________________________\/\\\__\///\\\/___\/\\\_____________________________
_____________________________\/\\\____\///_____\/\\\____________________________
______________________________\/\\\_____________\/\\\___________________________
_______________________________\/\\\_____________\/\\\__________________________
________________________________\///______________\///__________________________
________________________________________________________________________________
  • Gem Version
  • Code Climate
  • Build Status
  • Dependency Status
  • Coverage Status

INSTALL

Install via:

$ gem install m

If you’re using Bundler, you’ll need to include it in your Gemfile. Toss it into the test group:

group :test do
  gem 'm', '~> 1.3.1'
end

Developing a RubyGem? Add m as a development dependency.

Gem::Specification.new do |gem|
  # ...
  gem.add_development_dependency "m", "~> 1.3.1"
end

m works on Ruby 1.9+ only.

USAGE

Basically, I was sick of using the -n flag to grab one test to run. Instead, I prefer how RSpec’s test runner allows tests to be run by line number.

Given this file:

$ cat -n test/example_test.rb
 1  require 'test/unit'
 2
 3  class ExampleTest < Test::Unit::TestCase
 4    def test_apple
 5      assert_equal 1, 1
 6    end
 7
 8    def test_banana
 9      assert_equal 1, 1
10    end
11  end

You can run a test by line number, using format m TEST_FILE:LINE_NUMBER_OF_TEST:

$ m test/example_test.rb:4
Run options: -n /test_apple/

# Running tests:

.

Finished tests in 0.000525s, 1904.7619 tests/s, 1904.7619 assertions/s.

1 tests, 1 assertions, 0 failures, 0 errors, 0 skips

Hit the wrong line number? No problem, m helps you out:

$ m test/example_test.rb:2
No tests found on line 2. Valid tests to run:

 test_apple: m test/examples/test_unit_example_test.rb:4
test_banana: m test/examples/test_unit_example_test.rb:8

Want to run the whole test? Just leave off the line number.

$ m test/example_test.rb
Run options:

# Running tests:

..

Finished tests in 0.001293s, 1546.7904 tests/s, 3093.5808 assertions/s.

1 tests, 2 assertions, 0 failures, 0 errors, 0 skips

SUPPORT

m works with a few Ruby test frameworks:

  • Test::Unit
  • ActiveSupport::TestCase
  • MiniTest::Unit::TestCase

CONTRIBUTING

You can run the tests for minitest 4 with:

rake appraisal:minitest4 test

and the ones for minitest 5 with:

rake appraisal:minitest5 test TEST=test/minitest_5_test.rb

In the case of minitest 5 the whole suite will fail due to incompatibilities with ruby (at least until 2.1.1).

LICENSE

This gem is MIT licensed, please see LICENSE for more information.

Something went wrong with that request. Please try again.