[![Version](http://allthebadges.io/hqmq/mention-api/badge_fury.png)](http://allthebadges.io/hqmq/mention-api/badge_fury)
[![Dependencies](http://allthebadges.io/hqmq/mention-api/gemnasium.png)](http://allthebadges.io/hqmq/mention-api/gemnasium)
[![Build Status](http://allthebadges.io/hqmq/mention-api/travis.png)](http://allthebadges.io/hqmq/mention-api/travis)
[![Code Climate](http://allthebadges.io/hqmq/mention-api/code_climate.png)](http://allthebadges.io/hqmq/mention-api/code_climate)

# Mention::Api

A nice ruby interface to wrap the [Mention.net](http://mention.net/) API.

## Installation

Add this line to your application's Gemfile:

    gem 'mention-api'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install mention-api

## Developing

There are a list of acceptance specs that run against the live mention service. In order to run these specs you will need to create a file at spec/fixtures/credentials.yml. The contents should look like this:

```yaml
---
:account_id: your-account-id-here
:access_token: your-access-token-here
```

The unit tests for this project are under spec/lib. These need to be run separately from the acceptance tests since they use webmock to stub out all of the HTTP requests, whereas the acceptance tests specifically need to reach out the actual web service.

```bash
rspec spec/lib
...

rspec spec/acceptance
...
```

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request