https://github.com/dblock/rspec-rerun

Re-run (retry) failed RSpec examples.
https://github.com/dblock/rspec-rerun

Last synced: 17 days ago
JSON representation

Re-run (retry) failed RSpec examples.

• Host: GitHub
• URL: https://github.com/dblock/rspec-rerun
• Owner: dblock
• License: mit
• Created: 2012-08-14T11:46:12.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2020-10-02T13:47:41.000Z (about 4 years ago)
• Last Synced: 2024-10-08T23:10:50.095Z (about 1 month ago)
• Language: Ruby
• Homepage:
• Size: 551 KB
• Stars: 94
• Watchers: 6
• Forks: 35
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
![rspec-rerun](https://raw.github.com/dblock/rspec-rerun/master/rspec-rerun.png)

[![Gem Version](http://img.shields.io/gem/v/rspec-rerun.svg)](http://badge.fury.io/rb/rspec-rerun)

[![Build Status](http://img.shields.io/travis/dblock/rspec-rerun.svg)](https://travis-ci.org/dblock/rspec-rerun)

[![Dependency Status](https://gemnasium.com/dblock/rspec-rerun.svg)](https://gemnasium.com/dblock/rspec-rerun)

[![Code Climate](https://codeclimate.com/github/dblock/rspec-rerun.svg)](https://codeclimate.com/github/dblock/rspec-rerun)

**rspec-rerun** reruns failed RSpec examples (for brittle tests). 

It writes failed examples to the file `rspec.failures` and feeds these back to RSpec via `-e`.

Usage

-----

(For RSpec 2 use version '~> 0.3.1'. )

``` ruby

# Gemfile

group :development, :test do

  gem 'rspec-rerun'

end

```

```ruby

# Rakefile

require 'rspec-rerun/tasks'

task default: 'rspec-rerun:spec'

```

```bash

echo rspec.failures >> .gitignore

```

Run `rake` or `rake rspec-rerun:spec`. Failed examples will be rerun automatically.

Parameters

----------

The `rspec-rerun:spec` task accepts the following parameters:

* `retry_count`: number of retries, defaults to 1

e.g. `rake rspec-rerun:spec[3]`. ZSH users will want to try noglob or quote around the task name: `rake 'rspec-rerun:spec[3]'`.

You can set the following global environment variables:

* `RSPEC_RERUN_RETRY_COUNT`: number of retries, defaults to the value of `retry_count` or 1

* `RSPEC_RERUN_PATTERN`: spec file pattern, defaults to the value defined by `RSpec::Core::RakeTask`

* `RSPEC_RERUN_TAG`: only execute the tag specified

* `RSPEC_RERUN_VERBOSE`: if 'false', don't show the rspec command invoked by Rake

History

-------

Rerunning failed specs has been a long requested feature [#456](https://github.com/rspec/rspec-core/issues/456) in [RSpec](https://github.com/rspec/rspec-core/). A viable approach was suggested in [#596](https://github.com/rspec/rspec-core/pull/596). The infrastructure from that pull request was merged and released with rspec-core 2.11, which enabled re-running specs outside of RSpec, as described in [our blog post](http://artsy.github.com/blog/2012/05/15/how-to-organize-over-3000-rspec-specs-and-retry-test-failures/). This gem has evolved from it.

Contributing

------------

See [CONTRIBUTING](CONTRIBUTING.md).

Copyright and License

---------------------

MIT License, see [LICENSE](LICENSE.md) for details.

(c) 2012-2015 [Artsy Inc.](http://artsy.github.com), [Daniel Doubrovkine](https://github.com/dblock) and [Contributors](https://github.com/dblock/rspec-rerun/blob/master/CHANGELOG.md)