Readme.markdown in infinity_test-1.0.2 vs Readme.markdown in infinity_test-1.0.3
- old
+ new
@@ -1,26 +1,26 @@
# Infinity Test
+Infinity Test is a continuous testing library and a flexible alternative to
+Autotest, using the awesome Watchr library with RSpec, Test::Unit, Bacon and
+with RVM functionality, giving the possibility to test with all Ruby versions
+that you have in your RVM configuration.
-Infinity Test is a continuous testing library and a flexible alternative to Autotest,
-using the awesome Watchr library with Rspec, Test::Unit, Bacon and with RVM funcionality,
-giving the possibility to test with all <b>Rubies</b> that you have in your RVM configuration.
-
## To Infinity and Beyond!
<div style="padding:2px; border:1px solid silver; float:right; margin:0 0 1em 2em; background:white">
- <img src="http://github.com/tomas-stefano/infinity_test/raw/master/buzz_images/to_infinity_and_beyond.png" alt="Infinity Test" />
- <p style="text-align:center"> Photo taken by <a href="http://www.mixed-metaphor.org/fan/buzz/" title="buzz-light-year"> this site </a></p>
+ <img src="https://github.com/tomas-stefano/infinity_test/raw/master/buzz_images/to_infinity_and_beyond.png" alt="Infinity Test" />
+ <p style="text-align:center">Photo taken from <a href="http://www.mixed-metaphor.org/fan/buzz/" title="buzz-light-year">this site</a></p>
</div>
## Install
- gem install infinity_test
+ gem install infinity_test
-## Running Tests only in one ruby
+## Running Tests with the current Ruby
-With Rspec:
+With RSpec:
infinity_test --rspec
With Test::Unit:
@@ -28,13 +28,13 @@
With Bacon:
infinity_test --bacon
-## Running Tests with many Rubies
+## Running Tests with multiple Rubies
-With Rspec:
+With RSpec:
infinity_test --rspec --rubies=1.8.7,jruby,1.9.2,ree
Or with Test::Unit:
@@ -42,80 +42,105 @@
Or with bacon:
infinity_test --bacon --rubies=1.8.7,ree,1.9.2
-<b>And you are ready to Test with all ruby versions your Rspec or Test::Unit Suite with Autotest-like Behavior.</b>
+You can pass arguments to specific versions of Ruby with a '+' character:
-## Running Tests with Rails (only in master branch!)
+ infinity_test --rspec --rubies=jruby+"J-cp bar/whisky-in-the.jar:."
-With Rails:
+**Now you are ready to run your test suite against all Ruby versions with
+Autotest-like behavior.**
+## Running Tests with Rails
+
infinity_test --rails
## Configuration file
### Simple Domain Specific Language for Infinity Test file
-If you don't set all the time the rubies that you want, test framework that you want, notifications that you want,
-you can write some code that infinity_test understand.
+If you'd rather not constantly specify which versions of Ruby to use, or the
+testing framework to use, or which notifications you want to receive, you can
+specify those options one time in an `.infinity_test` file.
-So create the global file or project file called:
+You can create this file in your `$HOME` directory to be used globally across
+all projects, or you can specify the options per-project in the project's root
+folder:
- ~/.infinity_test or .infinity_test
+ # ~/.infinity_test or .infinity_test
- infinity_test do
+ infinity_test do
+ notifications :growl do
+ show_images :mode => :mario_bros
+ end
- notifications :growl do
- show_images :mode => :mario_bros
- end
+ use :rubies => %w(1.9.1 jruby 1.9.2 ree), :test_framework => :rspec
- use :rubies => %w(1.9.1 jruby 1.9.2 ree), :test_framework => :rspec
+ use :specific_options => {'jruby' => 'J-cp bar/whisky-in-the.jar:.'}
- before(:each_ruby) do |environment|
- # ...
- end
+ before(:each_ruby) do |environment|
+ # ...
+ end
- after(:each_ruby) do |environment|
- # ...
- end
+ after(:each_ruby) do |environment|
+ # ...
+ end
- before_run do
- clear :terminal
- end
+ before_run do
+ clear :terminal
+ end
- after_run do
- # ...
- end
+ after_run do
+ # ...
+ end
- heuristics('my_pattern') do |file|
- # ...
- end
+ heuristics('my_pattern') do |file|
+ # ...
+ end
- replace_patterns do |application|
- # ...
- end
-
+ replace_patterns do |application|
+ # ...
end
+ end
## Customize the .infinity_test file
-#### If you want to customize and understand the .infinity_test file, <a href='http://github.com/tomas-stefano/infinity_test/wiki/Customize-Infinity-Test'>Read this Page</a>
+If you want to customize and understand the .infinity_test file, [read this
+page](http://github.com/tomas-stefano/infinity_test/wiki/Customize-Infinity-Test).
# Color in RSpec
-### Put this in your <b>.rspec</b> file:
+### Put this in your .rspec file:
+In RSpec 2.2.0:
+
--color
+ --tty
+
+In RSpec 2.1.0:
+
+ --color
--autotest
+In RSpec 1.3, use the **spec.opts** file:
+
+ --color
+ --autospec
+
+**Note: These options will be the defaults in a future version of Infinity Test**
+
+### Future
+
+* Add support for focus files (run failed results and then run all tests if those pass, etc.)
+
## You Like it the Idea?
-<b>So make a fork and start contributing =].</b>
+So make a fork and start contributing =].
## You have a Feature request or Fix?
-<b>Contact me in Github and let's talk! =] </b>
+Contact me on GitHub, or Twitter ([@tomas_stefano](https://twitter.com/tomas_stefano)) and let's talk! =]
# Acknowledgments
* Thanks to Mynyml and Watchr library.
* Thanks to Waynee Seguin and the RVM.