Unfortunately, this gem is discontinued and won't get any support from me anymore ๐. Thanks for the attention.
RSpec formater that produces errors output easily consumable by automated tools
Initially, this tool came out as an attempt to use the Visual Studio Code tasks for running the RSpec and scanning its output to locate and test the failing specs very quickly. VS Code offers the mechanism of problem matchers that are, in fact, regular expressions to filter the output of a task line by line and feed the extracted info to the Problems view.
The following MRI Ruby versions are officially supported:
- 2.1
- 2.2
- 2.3
- 2.4
- 2.5
Although it's not recommended to use 2.1 or 2.2 as their support period has ended. The are no plans to support JRuby or Rubinius for now. But if the community has a strong request for it, it will likely be added.
Add this line to your application's Gemfile:
gem 'rspec_flat_error_formatter'
And then execute:
$ bundle
Or install it yourself as:
$ gem install rspec_flat_error_formatter
Pass as a value of the --format
(or -f
) option to the RSpec:
$ bundle exec rspec --format RSpecFlatErrorFormatter
Or add as to the default set of options via .rspec
file:
--format RSpecFlatErrorFormatter
Now run the tests as usual:
$ bundle exec rspec
After you've configured the formatter to be used by RSpec, you can consume its output by the tools you have to automate your test results navigation.
Here's an example of configuring rspec
and guard-rspec
using VS Code tasks to consume the output of RspecFlatErrorFormatter.
Create a .vscode
dir under your project or workspace dir. Then, create a tasks.json
file under it with the following contents:
{
"version": "2.0.0",
"tasks": [
// rspec
{
"label": "rspec",
"type": "shell",
"command": "rspec",
"group": "test",
"presentation": {
"echo": true,
"reveal": "always"
},
"problemMatcher": {
"fileLocation": ["relative", "${workspaceFolder}"],
"pattern": {
"regexp": "^(\\./.*?\\.rb):(\\d+?):\\s(error|info):\\s(.*)$",
"file": 1,
"line": 2,
"severity": 3,
"message": 4
}
}
},
// guard-rspec
{
"label": "guard",
"type": "shell",
"command": "bundle exec guard",
"presentation": {
"echo": true,
"reveal": "always",
"panel": "dedicated"
},
"isBackground": true,
"problemMatcher": {
"fileLocation": ["relative", "${workspaceFolder}"],
"pattern": {
"regexp": "^(\\./.*?\\.rb):(\\d+?):\\s(error|info):\\s(.*)$",
"file": 1,
"line": 2,
"severity": 3,
"message": 4
},
"background": {
"activeOnStart": true,
"beginsPattern": "^\\d{2}:\\d{2}:\\d{2} - INFO - Running",
"endsPattern": "^Randomized with"
}
}
}
]
}
After checking out the repo, run bundle exec rake spec
to run the tests.
To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/vittorius/rspec_flat_error_formatter.
The gem is available as open source under the terms of the MIT License.
- @sj26 for his beautiful rspec_junit_formatter - tests organization and some other stuff in repo are under the huge influence of RSpec JUnit Formatter repo