mailgunner 2.6.0 → 3.0.0

data/lib/mailgunner/client/tags.rb

@@ -2,8 +2,8 @@
 
 module Mailgunner
   class Client
-    def get_tags(params = {})
-      get("/v3/#{escape @domain}/tags", params)
+    def get_tags(params = PARAMS)
+      get("/v3/#{escape @domain}/tags", query: params)
     end
 
     def get_tag(id)
@@ -15,7 +15,7 @@ module Mailgunner
     end
 
     def get_tag_stats(id, params)
-      get("/v3/#{escape @domain}/tags/#{escape id}/stats", params)
+      get("/v3/#{escape @domain}/tags/#{escape id}/stats", query: params)
     end
 
     def delete_tag(id)

data/lib/mailgunner/client/webhooks.rb

@@ -10,11 +10,11 @@ module Mailgunner
       get("/v3/domains/#{escape @domain}/webhooks/#{escape id}")
     end
 
-    def add_webhook(attributes = {})
+    def add_webhook(attributes = ATTRIBUTES)
       post("/v3/domains/#{escape @domain}/webhooks", attributes)
     end
 
-    def update_webhook(id, attributes = {})
+    def update_webhook(id, attributes = ATTRIBUTES)
       put("/v3/domains/#{escape @domain}/webhooks/#{escape id}", attributes)
     end
 

data/lib/mailgunner/config.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Mailgunner
+  class Config
+    def domain
+      @domain ||= default_domain
+    end
+
+    attr_writer :domain
+
+    def api_key
+      @api_key ||= ENV.fetch('MAILGUN_API_KEY')
+    end
+
+    attr_writer :api_key
+
+    def api_host
+      @api_host ||= 'api.mailgun.net'
+    end
+
+    attr_writer :api_host
+
+    def user_agent
+      @user_agent ||= "Ruby/#{RUBY_VERSION} Mailgunner/#{VERSION}"
+    end
+
+    attr_writer :user_agent
+
+    module NoDomainProvided
+      def self.to_s
+        raise Error, 'No domain provided'
+      end
+    end
+
+    private_constant :NoDomainProvided
+
+    private
+
+    def default_domain
+      return NoDomainProvided unless ENV.key?('MAILGUN_SMTP_LOGIN')
+
+      ENV['MAILGUN_SMTP_LOGIN'].to_s.split('@').last
+    end
+  end
+end

data/lib/mailgunner/delivery_method.rb

@@ -1,6 +1,7 @@
 require 'mail/check_delivery_params'
 
 module Mailgunner
+  # @private
   class DeliveryMethod
     attr_accessor :settings
 

data/lib/mailgunner/errors.rb

@@ -1,15 +1,33 @@
+# frozen_string_literal: true
+
 module Mailgunner
-  class Error < StandardError; end
+  class Error < StandardError
+    # @private
+    def self.parse(response)
+      exception_class = case response
+        when Net::HTTPUnauthorized
+          AuthenticationError
+        when Net::HTTPClientError
+          ClientError
+        when Net::HTTPServerError
+          ServerError
+        else
+          Error
+        end
+
+      message = if response['Content-Type']&.start_with?('application/json')
+        JSON.parse(response.body)['message']
+      end
+
+      message ||= "HTTP #{response.code} response from Mailgun API"
+
+      exception_class.new(message)
+    end
+  end
 
   class ClientError < Error; end
 
   class AuthenticationError < ClientError; end
 
   class ServerError < Error; end
-
-  module NoDomainProvided
-    def self.to_s
-      raise Error, 'No domain provided'
-    end
-  end
 end

data/lib/mailgunner/params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+require 'cgi'
+
+module Mailgunner
+  module Params
+    def self.encode(params)
+      params.flat_map { |k, vs| Array(vs).map { |v| "#{escape(k)}=#{escape(v)}" } }.join('&')
+    end
+
+    def self.escape(component)
+      CGI.escape(component.to_s)
+    end
+  end
+
+  private_constant :Params
+end

data/lib/mailgunner/railtie.rb

@@ -1,4 +1,5 @@
 module Mailgunner
+  # @private
   class Railtie < Rails::Railtie
     config.before_initialize do
       require 'mailgunner/delivery_method'

data/lib/mailgunner/struct.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Mailgunner
+  class Struct
+    def initialize(hash = nil)
+      @hash = hash || {}
+    end
+
+    def [](key)
+      @hash[key.to_s]
+    end
+
+    def []=(key, value)
+      @hash[key] = value
+    end
+
+    def to_h
+      @hash
+    end
+
+    def ==(other)
+      other.is_a?(self.class) && other.to_h == @hash
+    end
+
+    def respond_to_missing?(name, include_all)
+      @hash.key?(name.to_s)
+    end
+
+    def method_missing(name, *args)
+      return @hash[name.to_s] if @hash.key?(name.to_s)
+
+      super
+    end
+
+    def pretty_print(q)
+      q.object_address_group(self) do
+        q.seplist(@hash, lambda { q.text ',' }) do |key, value|
+          q.breakable
+          q.text key.to_s
+          q.text '='
+          q.group(1) {
+            q.breakable ''
+            q.pp value
+          }
+        end
+      end
+    end
+  end
+end

data/lib/mailgunner/version.rb

@@ -1,3 +1,3 @@
 module Mailgunner
-  VERSION = '2.6.0'
+  VERSION = '3.0.0'
 end

data/mailgunner.gemspec

@@ -7,12 +7,14 @@ Gem::Specification.new do |s|
   s.platform = Gem::Platform::RUBY
   s.authors = ['Tim Craft']
   s.email = ['mail@timcraft.com']
-  s.homepage = 'http://github.com/readysteady/mailgunner'
+  s.homepage = 'https://github.com/readysteady/mailgunner'
   s.description = 'Ruby client for the Mailgun API'
   s.summary = 'Ruby client for the Mailgun API'
-  s.files = Dir.glob('{lib,spec}/**/*') + %w(LICENSE.txt README.md mailgunner.gemspec)
-  s.required_ruby_version = '>= 1.9.3'
-  s.add_development_dependency('rake', '>= 12')
+  s.files = Dir.glob('lib/**/*.rb') + %w(LICENSE.txt README.md mailgunner.gemspec)
+  s.required_ruby_version = '>= 2.5.0'
+  s.add_development_dependency('rake', '~> 12')
+  s.add_development_dependency('yard', '~> 0.9')
+  s.add_development_dependency('redcarpet', '~> 3') unless RUBY_PLATFORM == 'java'
   s.add_development_dependency('webmock', '~> 3')
   s.add_development_dependency('mail', '~> 2')
   s.add_development_dependency('actionmailer', '~> 5')

metadata

@@ -1,29 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: mailgunner
 version: !ruby/object:Gem::Version
-  version: 2.6.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Tim Craft
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-16 00:00:00.000000000 Z
+date: 2019-06-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '12'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
@@ -102,14 +130,15 @@ files:
 - lib/mailgunner/client/suppressions.rb
 - lib/mailgunner/client/tags.rb
 - lib/mailgunner/client/webhooks.rb
+- lib/mailgunner/config.rb
 - lib/mailgunner/delivery_method.rb
 - lib/mailgunner/errors.rb
+- lib/mailgunner/params.rb
 - lib/mailgunner/railtie.rb
+- lib/mailgunner/struct.rb
 - lib/mailgunner/version.rb
 - mailgunner.gemspec
-- spec/mailgunner_delivery_method_spec.rb
-- spec/mailgunner_spec.rb
-homepage: http://github.com/readysteady/mailgunner
+homepage: https://github.com/readysteady/mailgunner
 licenses:
 - LGPL-3.0
 metadata:
@@ -125,15 +154,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Ruby client for the Mailgun API

data/spec/mailgunner_delivery_method_spec.rb

@@ -1,37 +0,0 @@
-require 'minitest/autorun'
-require 'webmock/minitest'
-require 'action_mailer'
-require 'mailgunner'
-require 'mailgunner/delivery_method'
-
-class ExampleMailer < ActionMailer::Base
-  default from: 'testing@localhost'
-
-  def registration_confirmation(user)
-    mail to: user[:email], subject: 'Welcome!', body: 'Hello!'
-  end
-end
-
-describe 'Mailgunner::DeliveryMethod' do
-  before do
-    @api_key = 'xxx'
-
-    @domain = 'samples.mailgun.org'
-
-    @base_url = 'https://api.mailgun.net/v3'
-
-    @auth = ['api', @api_key]
-
-    @address = 'user@example.com'
-
-    ActionMailer::Base.delivery_method = :mailgun
-
-    ActionMailer::Base.mailgun_settings = {api_key: @api_key, domain: @domain}
-  end
-
-  it 'delivers the mail to mailgun in mime format' do
-    stub_request(:post, "#@base_url/#@domain/messages.mime").with(basic_auth: @auth)
-
-    ExampleMailer.registration_confirmation(email: @address).deliver_now
-  end
-end

data/spec/mailgunner_spec.rb

@@ -1,747 +0,0 @@
-require 'minitest/autorun'
-require 'webmock/minitest'
-require 'mocha/setup'
-require 'mailgunner'
-require 'json'
-require 'mail'
-
-describe 'Mailgunner::Client' do
-  before do
-    @domain = 'samples.mailgun.org'
-
-    @api_key = 'xxx'
-
-    @base_url = 'https://@api.mailgun.net/v3'
-
-    @json_response_object = {'key' => 'value'}
-
-    @client = Mailgunner::Client.new(domain: @domain, api_key: @api_key)
-
-    @address = 'user@example.com'
-
-    @encoded_address = 'user%40example.com'
-
-    @login = 'bob.bar'
-
-    @id = 'idxxx'
-  end
-
-  def stub(http_method, url, body: nil, headers: nil)
-    headers ||= {}
-    headers['User-Agent'] = /\ARuby\/\d+\.\d+\.\d+ Mailgunner\/\d+\.\d+\.\d+\z/
-
-    params = {basic_auth: ['api', @api_key]}
-    params[:headers] = headers
-    params[:body] = body if body
-
-    response_headers = {'Content-Type' => 'application/json;charset=utf-8'}
-    response_body = '{"key":"value"}'
-
-    stub_request(http_method, url).with(params).to_return(headers: response_headers, body: response_body)
-  end
-
-  describe 'http method' do
-    it 'returns a net http object' do
-      @client.http.must_be_instance_of(Net::HTTP)
-    end
-  end
-
-  describe 'http object' do
-    it 'uses ssl' do
-      @client.http.use_ssl?.must_equal(true)
-    end
-
-    it 'uses the address from the api_host option' do
-      api_host = 'api.eu.mailgun.net'
-
-      @client = Mailgunner::Client.new(api_key: @api_key, api_host: api_host)
-
-      @client.http.address.must_equal(api_host)
-    end
-  end
-
-  describe 'domain method' do
-    it 'returns the value passed to the constructor' do
-      @client.domain.must_equal(@domain)
-    end
-
-    it 'defaults to the domain in the MAILGUN_SMTP_LOGIN environment variable' do
-      ENV['MAILGUN_SMTP_LOGIN'] = 'postmaster@samples.mailgun.org'
-
-      Mailgunner::Client.new(api_key: @api_key).domain.must_equal(@domain)
-
-      ENV.delete('MAILGUN_SMTP_LOGIN')
-    end
-  end
-
-  describe 'api_key method' do
-    it 'returns the value passed to the constructor' do
-      @client.api_key.must_equal(@api_key)
-    end
-
-    it 'defaults to the value of MAILGUN_API_KEY environment variable' do
-      ENV['MAILGUN_API_KEY'] = @api_key
-
-      Mailgunner::Client.new(domain: @domain).api_key.must_equal(@api_key)
-
-      ENV.delete('MAILGUN_API_KEY')
-    end
-  end
-
-  describe 'validate_address method' do
-    it 'calls the address validate resource with the given email address and returns the response object' do
-      stub(:get, "#@base_url/address/validate?address=#@encoded_address")
-
-      @client.validate_address(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'parse_addresses method' do
-    it 'calls the address parse resource with the given email addresses and returns the response object' do
-      stub(:get, "#@base_url/address/parse?addresses=bob%40example.com%2Ceve%40example.com")
-
-      @client.parse_addresses(['bob@example.com', 'eve@example.com']).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_message method' do
-    it 'fetches the domain message resource with the given id and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/messages/#@id")
-
-      @client.get_message(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_mime_message method' do
-    it 'fetches the domain message resource with the given key and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/messages/#@id", headers: {'Accept' => 'message/rfc2822'})
-
-      @client.get_mime_message(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'send_message method' do
-    it 'posts to the domain messages resource and returns the response object' do
-      stub(:post, "#@base_url/#@domain/messages", body: "to=#@encoded_address")
-
-      @client.send_message({to: @address}).must_equal(@json_response_object)
-    end
-
-    it 'raises an exception if the domain is not provided' do
-      @client = Mailgunner::Client.new(api_key: @api_key)
-
-      exception = proc { @client.send_message({}) }.must_raise(Mailgunner::Error)
-      exception.message.must_include('No domain provided')
-    end
-
-    it 'encodes the message attributes as multipart form data when sending attachments' do
-      # TODO
-    end
-  end
-
-  describe 'send_mime method' do
-    before do
-      @mail = Mail.new({
-        to: 'alice@example.com',
-        from: 'bob@example.com',
-        subject: 'Test email',
-        body: 'This is a test email'
-      })
-    end
-
-    it 'posts to the domain messages resource and returns the response object' do
-      stub(:post, "#@base_url/#@domain/messages.mime")
-
-      @client.send_mime(@mail).must_equal(@json_response_object)
-    end
-
-    it 'includes all recipients of the message' do
-      @mail.cc = 'carol@example.com'
-      @mail.bcc = 'dave@example.com'
-
-      stub(:post, "#@base_url/#@domain/messages.mime")
-
-      recipients = 'alice@example.com,carol@example.com,dave@example.com'
-
-      Net::HTTP::Post.any_instance.expects(:set_form).with(includes(['to', recipients]), 'multipart/form-data')
-
-      @client.send_mime(@mail)
-    end
-  end
-
-  describe 'delete_message method' do
-    it 'deletes the domain message resource with the given key and returns the response object' do
-      stub(:delete, "#@base_url/domains/#@domain/messages/#@id")
-
-      @client.delete_message(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_domains method' do
-    it 'fetches the domains resource and returns the response object' do
-      stub(:get, "#@base_url/domains")
-
-      @client.get_domains.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_domain method' do
-    it 'fetches the domain resource and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain")
-
-      @client.get_domain(@domain).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_domain method' do
-    it 'posts to the domains resource and returns the response object' do
-      stub(:post, "#@base_url/domains", body: "name=#@domain")
-
-      @client.add_domain({name: @domain}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_domain method' do
-    it 'deletes the domain resource with the given name and returns the response object' do
-      stub(:delete, "#@base_url/domains/#@domain")
-
-      @client.delete_domain(@domain).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_credentials method' do
-    it 'fetches the domain credentials resource and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/credentials")
-
-      @client.get_credentials.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_credentials method' do
-    it 'posts to the domain credentials resource and returns the response object' do
-      stub(:post, "#@base_url/domains/#@domain/credentials", body: "login=#@login")
-
-      @client.add_credentials(login: @login).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_credentials method' do
-    it 'updates the domain credentials resource with the given login and returns the response object' do
-      stub(:put, "#@base_url/domains/#@domain/credentials/#@login", body: 'password=secret')
-
-      @client.update_credentials(@login, {password: 'secret'}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_credentials method' do
-    it 'deletes the domain credentials resource with the given login and returns the response object' do
-      stub(:delete, "#@base_url/domains/#@domain/credentials/#@login")
-
-      @client.delete_credentials(@login).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_connection_settings method' do
-    it 'fetches the domain connection settings resource and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/connection")
-
-      @client.get_connection_settings.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_connection_settings method' do
-    it 'updates the domain connection settings resource and returns the response object' do
-      stub(:put, "#@base_url/domains/#@domain/connection", body: 'require_tls=true')
-
-      @client.update_connection_settings({require_tls: true}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_unsubscribes method' do
-    it 'fetches the domain unsubscribes resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/unsubscribes")
-
-      @client.get_unsubscribes.must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/#@domain/unsubscribes?skip=1&limit=2")
-
-      @client.get_unsubscribes(skip: 1, limit: 2)
-    end
-  end
-
-  describe 'get_unsubscribe method' do
-    it 'fetches the unsubscribe resource with the given address and returns the response object' do
-      stub(:get, "#@base_url/#@domain/unsubscribes/#@encoded_address")
-
-      @client.get_unsubscribe(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_unsubscribe method' do
-    it 'deletes the domain unsubscribe resource with the given address and returns the response object' do
-      stub(:delete, "#@base_url/#@domain/unsubscribes/#@encoded_address")
-
-      @client.delete_unsubscribe(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_unsubscribe method' do
-    it 'posts to the domain unsubscribes resource and returns the response object' do
-      stub(:post, "#@base_url/#@domain/unsubscribes", body: "address=#@encoded_address")
-
-      @client.add_unsubscribe({address: @address}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_complaints method' do
-    it 'fetches the domain complaints resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/complaints")
-
-      @client.get_complaints.must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/#@domain/complaints?skip=1&limit=2")
-
-      @client.get_complaints(skip: 1, limit: 2)
-    end
-  end
-
-  describe 'get_complaint method' do
-    it 'fetches the complaint resource with the given address and returns the response object' do
-      stub(:get, "#@base_url/#@domain/complaints/#@encoded_address")
-
-      @client.get_complaint(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_complaint method' do
-    it 'posts to the domain complaints resource and returns the response object' do
-      stub(:post, "#@base_url/#@domain/complaints", body: "address=#@encoded_address")
-
-      @client.add_complaint({address: @address}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_complaint method' do
-    it 'deletes the domain complaint resource with the given address and returns the response object' do
-      stub(:delete, "#@base_url/#@domain/complaints/#@encoded_address")
-
-      @client.delete_complaint(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_bounces method' do
-    it 'fetches the domain bounces resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/bounces")
-
-      @client.get_bounces.must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/#@domain/bounces?skip=1&limit=2")
-
-      @client.get_bounces(skip: 1, limit: 2)
-    end
-  end
-
-  describe 'get_bounce method' do
-    it 'fetches the bounce resource with the given address and returns the response object' do
-      stub(:get, "#@base_url/#@domain/bounces/#@encoded_address")
-
-      @client.get_bounce(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_bounce method' do
-    it 'posts to the domain bounces resource and returns the response object' do
-      stub(:post, "#@base_url/#@domain/bounces", body: "address=#@encoded_address")
-
-      @client.add_bounce({address: @address}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_bounce method' do
-    it 'deletes the domain bounce resource with the given address and returns the response object' do
-      stub(:delete, "#@base_url/#@domain/bounces/#@encoded_address")
-
-      @client.delete_bounce(@address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_bounces method' do
-    it 'deletes the domain bounces resource and returns the response object' do
-      stub(:delete, "#@base_url/#@domain/bounces")
-
-      @client.delete_bounces.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_stats method' do
-    before do
-      Kernel.stubs(:warn)
-    end
-
-    it 'fetches the domain stats resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/stats")
-
-      @client.get_stats.must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/#@domain/stats?skip=1&limit=2")
-
-      @client.get_stats(skip: 1, limit: 2)
-    end
-
-    it 'encodes an event parameter with multiple values' do
-      WebMock::Config.instance.query_values_notation = :flat_array
-
-      stub(:get, "#@base_url/#@domain/stats?event=opened&event=sent")
-
-      @client.get_stats(event: %w(sent opened))
-
-      WebMock::Config.instance.query_values_notation = nil
-    end
-
-    it 'emits a deprecation warning' do
-      stub(:get, "#@base_url/#@domain/stats")
-
-      Kernel.expects(:warn).with(regexp_matches(/Mailgunner::Client#get_stats is deprecated/))
-
-      @client.get_stats
-    end
-  end
-
-  describe 'get_total_stats method' do
-    it 'fetches the domain total stats resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/stats/total?event=delivered")
-
-      @client.get_total_stats(event: 'delivered').must_equal(@json_response_object)
-    end
-
-    it 'encodes optional parameters' do
-      stub(:get, "#@base_url/#@domain/stats/total?event=delivered&resolution=hour")
-
-      @client.get_total_stats(event: 'delivered', resolution: 'hour')
-    end
-
-    it 'encodes an event parameter with multiple values' do
-      WebMock::Config.instance.query_values_notation = :flat_array
-
-      stub(:get, "#@base_url/#@domain/stats/total?event=delivered&event=accepted")
-
-      @client.get_total_stats(event: %w(accepted delivered))
-
-      WebMock::Config.instance.query_values_notation = nil
-    end
-  end
-
-  describe 'get_events method' do
-    it 'fetches the domain events resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/events")
-
-      @client.get_events.must_equal(@json_response_object)
-    end
-
-    it 'encodes optional parameters' do
-      stub(:get, "#@base_url/#@domain/events?event=accepted&limit=10")
-
-      @client.get_events(event: 'accepted', limit: 10)
-    end
-  end
-
-  describe 'get_tags method' do
-    it 'fetches the domain tags resource and returns the response object' do
-      stub(:get, "#@base_url/#@domain/tags")
-
-      @client.get_tags.must_equal(@json_response_object)
-    end
-
-    it 'encodes optional limit parameter' do
-      stub(:get, "#@base_url/#@domain/tags?limit=2")
-
-      @client.get_tags(limit: 2)
-    end
-  end
-
-  describe 'get_tag method' do
-    it 'fetches the domain tag resource with the given id and returns the response object' do
-      stub(:get, "#@base_url/#@domain/tags/#@id")
-
-      @client.get_tag(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_tag method' do
-    it 'updates the domain tag resource with the given id and returns the response object' do
-      stub(:put, "#@base_url/#@domain/tags/#@id", body: 'description=Tag+description')
-
-      @client.update_tag(@id, {description: 'Tag description'}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_tag_stats method' do
-    it 'fetches the domain tag stats resource with the given id and returns the response object' do
-      stub(:get, "#@base_url/#@domain/tags/#@id/stats?event=accepted")
-
-      @client.get_tag_stats(@id, event: 'accepted').must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_tag method' do
-    it 'deletes the domain tag resource with the given id and returns the response object' do
-      stub(:delete, "#@base_url/#@domain/tags/#@id")
-
-      @client.delete_tag(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_routes method' do
-    it 'fetches the routes resource and returns the response object' do
-      stub(:get, "#@base_url/routes")
-
-      @client.get_routes.must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/routes?skip=1&limit=2")
-
-      @client.get_routes(skip: 1, limit: 2)
-    end
-  end
-
-  describe 'get_route method' do
-    it 'fetches the route resource with the given id and returns the response object' do
-      stub(:get, "#@base_url/routes/#@id")
-
-      @client.get_route(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_route method' do
-    it 'posts to the routes resource and returns the response object' do
-      stub(:post, "#@base_url/routes", body: 'description=Example+route&priority=1')
-
-      @client.add_route({description: 'Example route', priority: 1}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_route method' do
-    it 'updates the route resource with the given id and returns the response object' do
-      stub(:put, "#@base_url/routes/#@id", body: 'priority=10')
-
-      @client.update_route(@id, {priority: 10}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_route method' do
-    it 'deletes the route resource with the given id and returns the response object' do
-      stub(:delete, "#@base_url/routes/#@id")
-
-      @client.delete_route(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_webhooks method' do
-    it 'fetches the domain webhooks resource and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/webhooks")
-
-      @client.get_webhooks.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_webhook method' do
-    it 'fetches the domain webhook resource with the given id and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/webhooks/#@id")
-
-      @client.get_webhook(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_webhook method' do
-    it 'posts to the domain webhooks resource and returns the response object' do
-      attributes = {id: @id, url: 'http://example.com/webhook'}
-
-      stub(:post, "#@base_url/domains/#@domain/webhooks", body: attributes)
-
-      @client.add_webhook(attributes).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_webhook method' do
-    it 'updates the domain webhook resource with the given id and returns the response object' do
-      attributes = {url: 'http://example.com/webhook'}
-
-      stub(:put, "#@base_url/domains/#@domain/webhooks/#@id", body: attributes)
-
-      @client.update_webhook(@id, attributes).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_webhook method' do
-    it 'deletes the domain webhook resource with the given address and returns the response object' do
-      stub(:delete, "#@base_url/domains/#@domain/webhooks/#@id")
-
-      @client.delete_webhook(@id).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_all_ips method' do
-    it 'fetches the ips resource and returns the response object' do
-      stub(:get, "#@base_url/ips")
-
-      @client.get_all_ips.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_ip method' do
-    it 'fetches the ip resource with the given address and returns the response object' do
-      address = '127.0.0.1'
-
-      stub(:get, "#@base_url/ips/#{address}")
-
-      @client.get_ip(address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_ips method' do
-    it 'fetches the domain ips resource and returns the response object' do
-      stub(:get, "#@base_url/domains/#@domain/ips")
-
-      @client.get_ips.must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_ip method' do
-    it 'posts to the domain ips resource and returns the response object' do
-      address = '127.0.0.1'
-
-      stub(:post, "#@base_url/domains/#@domain/ips", body: {ip: address})
-
-      @client.add_ip(address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_ip method' do
-    it 'deletes the domain ip resource with the given address and returns the response object' do
-      address = '127.0.0.1'
-
-      stub(:delete, "#@base_url/domains/#@domain/ips/#{address}")
-
-      @client.delete_ip(address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_lists method' do
-    it 'fetches the lists resource and returns the response object' do
-      stub(:get, "#@base_url/lists")
-
-      @client.get_lists.must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/lists?skip=1&limit=2")
-
-      @client.get_lists(skip: 1, limit: 2)
-    end
-  end
-
-  describe 'get_list method' do
-    it 'fetches the list resource with the given address and returns the response object' do
-      stub(:get, "#@base_url/lists/developers%40mailgun.net")
-
-      @client.get_list('developers@mailgun.net').must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_list method' do
-    it 'posts to the lists resource and returns the response object' do
-      stub(:post, "#@base_url/lists", body: 'address=developers%40mailgun.net')
-
-      @client.add_list({address: 'developers@mailgun.net'}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_list method' do
-    it 'updates the list resource and returns the response object' do
-      stub(:put, "#@base_url/lists/developers%40mailgun.net", body: 'name=Example+list')
-
-      @client.update_list('developers@mailgun.net', {name: 'Example list'}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_list method' do
-    it 'deletes the list resource with the given address and returns the response object' do
-      stub(:delete, "#@base_url/lists/developers%40mailgun.net")
-
-      @client.delete_list('developers@mailgun.net').must_equal(@json_response_object)
-    end
-  end
-
-  describe 'get_list_members method' do
-    it 'fetches the list members resource and returns the response object' do
-      stub(:get, "#@base_url/lists/developers%40mailgun.net/members")
-
-      @client.get_list_members('developers@mailgun.net').must_equal(@json_response_object)
-    end
-
-    it 'encodes skip and limit parameters' do
-      stub(:get, "#@base_url/lists/developers%40mailgun.net/members?skip=1&limit=2")
-
-      @client.get_list_members('developers@mailgun.net', skip: 1, limit: 2)
-    end
-  end
-
-  describe 'get_list_member method' do
-    it 'fetches the list member resource with the given address and returns the response object' do
-      stub(:get, "#@base_url/lists/developers%40mailgun.net/members/#@encoded_address")
-
-      @client.get_list_member('developers@mailgun.net', @address).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'add_list_member method' do
-    it 'posts to the list members resource and returns the response object' do
-      stub(:post, "#@base_url/lists/developers%40mailgun.net/members", body: "address=#@encoded_address")
-
-      @client.add_list_member('developers@mailgun.net', {address: @address}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'update_list_member method' do
-    it 'updates the list member resource with the given address and returns the response object' do
-      stub(:put, "#@base_url/lists/developers%40mailgun.net/members/#@encoded_address", body: 'subscribed=no')
-
-      @client.update_list_member('developers@mailgun.net', @address, {subscribed: 'no'}).must_equal(@json_response_object)
-    end
-  end
-
-  describe 'delete_list_member method' do
-    it 'deletes the list member resource with the given address and returns the response object' do
-      stub(:delete, "#@base_url/lists/developers%40mailgun.net/members/#@encoded_address")
-
-      @client.delete_list_member('developers@mailgun.net', @address).must_equal(@json_response_object)
-    end
-  end
-
-  it 'raises an exception for authentication errors' do
-    stub_request(:any, /api\.mailgun\.net/).to_return(status: 401)
-
-    proc { @client.get_message(@id) }.must_raise(Mailgunner::AuthenticationError)
-  end
-
-  it 'raises an exception for client errors' do
-    stub_request(:any, /api\.mailgun\.net/).to_return(status: 400)
-
-    proc { @client.get_message(@id) }.must_raise(Mailgunner::ClientError)
-  end
-
-  it 'raises an exception for server errors' do
-    stub_request(:any, /api\.mailgun\.net/).to_return(status: 500)
-
-    proc { @client.get_message(@id) }.must_raise(Mailgunner::ServerError)
-  end
-end