Contents

# Starting Blocks

## Why?

The purpose of this gem is to run my Minitest specs, with no hassle. No Rakefile updates, no Gemfile/gemspec installs, and no regex Guard files.

Just. Run. The. Tests.

Install the gem. Type "sb" in your command line.  All of the tests in your current directory are run. 

## What tests, though?

Starting Blocks runs all files that have a "test" or "spec" prefix or suffix.  Like:

* spec_apple.rb
* apple_spec.rb
* test_orange.rb
* orange_test.rb

It also looks for matches between "non-test" files and spec files.  So if "apple.rb" is updated and "apple_spec.rb" exists, Starting Blocks will run the "apple_spec.rb" tests.


## Usage

Run all of your Minitest tests and specs in your current directory and all child directories:

````
sb
````

Run the tests in any test or spec file after it is saved. Will also run the specs for any file that has a matching test or spec file:

````
sb watch
````

Run any arbitrary command through starting blocks. The results of the statement (notably the success or failure determined by the exit code) will be published through your starting blocks plugins.

````
sb execute "git push heroku master"
````

## Plugins

### Blinky Light
Turn your [blinky light](https://github.com/perryn/blinky) red/yellow/green based on the results of your test run:

````
gem install starting_blocks-blinky
sb blinky
````

### Growl
Pop a growl message based on your test results:

````
gem install starting_blocks-growl
sb growl
````

### Stopplicht

Change your stopplicht based on your test results:

````
gem install starting_blocks-stopplicht
sb growl
````

## Installation

Install it yourself with:

    $ gem install starting_blocks

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
starting_blocks-1.3.1	README.md
starting_blocks-1.3.0	README.md