Contents

# RSpec::Datadog
 
This gem provides a custom rspec formatter that sends events to
[DataDog](https://www.datadoghq.com/).  Events will contain four tags
("full\_description:foo", "status:succeeded", "file\_path:foo",
"line\_number:123") plus any defined in DatadogFormatter::BASE\_TAGS; more
information about `Datadog::Event` and querying these events can be found in the
[DataDog API Reference](http://docs.datadoghq.com/api/)

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'rspec-datadog'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install rspec-datadog

## Usage

Run as follows:
```
DATADOG_API_KEY=foo DATADOG_APPLICATION_KEY=bar bundle exec rspec -r rspec/datadog --format DatadogFormatter spec
```

Running with `DEBUG=1` will cause it to print output to stdout instead of emitting to DataDog.

If you have any tags you want applied to *all* examples, then add this to your
spec_helper:
```
class DatadogFormatter
  BASE_TAGS = %w(foo)
end
```

Note that all examples in a given run will have a UUID aggregation key added.

*If* you are using rspec 3, the formatter API has changed - you'll need to run
with `--require rspec/legacy_formatters` and have the `rspec-legacy_formatters`
gem installed.

## Contributing

Bug reports and pull requests are welcome on GitHub at
https://github.com/lookout/rspec-datadog.  Please see the Contributor License
Agreement in CONTRIBUTING.


## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
rspec-datadog-0.3.0	README.md
rspec-datadog-0.2.0	README.md