# Mailstro Client for Ruby

TODO: Write a gem description

## Installation

1.  Add the `mailstro` gem to your `Gemfile`

    ```ruby
    gem "mailstro"
    ```

2.  Install the gem

    ```shell
    bundle install
    ```

3.  Configure the mailstro module with your API key.

    In rails apps, put this code to a new file at `config/initializers/mailstro.rb`

    ```ruby
    require 'mailstro'

    Mailstro.configure do |config|
      config.api_key = "YOUR_API_KEY_HERE"
    end
    ```

## Usage

Sending a basic email.

```ruby
Mailstro.deliver(
  :to            => 'shanon@mailstroapp.com',
  :template_name => :welcome,
  :template_data => {
    :coupon_code => 'THANKS01'
  }
)
```

## RSpec

Require the mailstro spec helper to automatically enable test mode.

```ruby
require 'mailsto/rspec'
```

Verify emails are being sent with simple matchers.

```ruby
Mailstro.deliver(
  :to            => 'shanon@mailstroapp.com',
  :template_name => :welcome,
)

Mailstro.should have_delivered(
  :to            => 'shanon@mailstroapp.com',
  :template_name => :welcome
)
```

## 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