mailgun-ruby 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: 15c6226ce2745501543bd148db41a0297f2d58df
-  data.tar.gz: 2110bec8de2f21d49fee5d56ad41aef0d4fbc2b7
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MjI5MjJkMTdmNGY4M2Q0OTRkY2I4MjY5YzRmNjBhYzVhYmUyNzNkMQ==
+  data.tar.gz: !binary |-
+    MGViNjllYzBlODY3NzhhZjc3OTczYzAyNTc0YTgxMDg4ODU1ZTZjNw==
 SHA512:
-  metadata.gz: 04f6a82d67c5d8cda08c7a38956edfab2ff28b9c16b9344fcee2e3ec3caf1e0e69f901797de3a98640a962af9c28fff58d7151deb3cffbc32bee740df48eb901
-  data.tar.gz: 4fc8aec4b0e5e5c100a707c3cf44151b9eb2fe1e1cd047bf0df3c0122c1443c9264e048d27fe65390e23a9718be2ce5ab8d6009deaaf7ec0f512e9a7217f3552
+  metadata.gz: !binary |-
+    YWNmMmRjZTU1OTZiNzA0NzMwM2QwN2E5ZGFiM2NkNjZmOWVkY2Q3MmQ3MjU5
+    MDQxMjU4NzI4YjZkOGQ1NzRhMGY4NGE3NjE0ZWFhNTMxNWZiM2Y4Y2U2NDM5
+    MWJkMTJhNmZiZTczZDZlM2JhNGIzNjg2YzAwNzQ2NTNlZjIzNmM=
+  data.tar.gz: !binary |-
+    YTg1M2UwNzdiMWIwNGZhMGVjYzJmY2FjMjhkMjJmMjljZWRkYzY5NGRmYmY3
+    MDcxY2Q4MzVkY2M2NGQ4OWE1Mzc4ZTQyZGUyYTE4NjE5NzJiMGNiMjRlNTNi
+    YWM1Y2VmODBlMWFiZTU1NmQ4ZmJkMmJmZjFiYzliOTBmOGJmOGI=

data/.gitignore

@@ -20,3 +20,4 @@ test.rb
 ruby
 .ruby-env.yml
 .rspec-local
+.tool-versions

data/.travis.yml

@@ -1,9 +1,22 @@
 language: ruby
-rvm:
-  - 2.2
-  - 2.1
-  - 2.0.0
-  - 1.9.3
 sudo: false
-gemfile: Gemfile
-script: bundle exec rake spec
+rvm:
+- 2.3.1
+- 2.2
+- 2.1
+- 2.0.0
+script:
+- bundle exec rake spec
+- '[[ "${TRAVIS_PULL_REQUEST}" == "false" ]] && ( bundle exec rake spec:integration
+  ) || ( echo "Testing PR - No integration tests available")'
+deploy:
+  provider: rubygems
+  api_key:
+    secure: QTNP+6720w38b8krtvXM25WDEOUxw9BlUwdXgWLrU0MGAOSvVFgnWTJs+7QvGWODjhrIqAfAm11zc+yEpzgD9P8np9cteWv5K7rMxsUMcb14kaGIA+MKO+RRJXlru4teBNX5jtp2GJiNS2mn7urzn5YhE9x9P7pMjcF+j5usoF0=
+  gemspec: mailgun.gemspec
+  on:
+    tags: true
+notifications:
+  slack:
+    rooms:
+      secure: G4iBtDfFGeryQslfrKZK4hSPikOy9y3SDnpzwmN8SoB0uIAWE2mLfMUJZonKm7yoz+DbPU0u3c1SwiMLwHkXZhPdnJdC1fb1DpicXnVgGZYdiLGiY+OAwkvcBE9p3piWhpwigTjvmSqTaNSRL/VLhG4qwQbHU0fTl1M1zwU4e6c=

data/Gemfile

@@ -2,3 +2,5 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in mailgun.gemspec
 gemspec
+
+gem 'json', '~> 1.8', platform: :mri_19

data/README.md

@@ -19,14 +19,7 @@ gem install mailgun-ruby
 Gemfile:
 
 ```ruby
-gem 'mailgun-ruby', '~>1.0.5', require: 'mailgun'
-```
-
-Include
---------
-
-```ruby
-require 'mailgun'
+gem 'mailgun-ruby', '~>1.1.1'
 ```
 
 Usage

data/lib/mailgun-ruby.rb

@@ -0,0 +1 @@
+require 'mailgun'

data/lib/mailgun.rb

@@ -7,6 +7,7 @@ require 'mailgun/version'
 require 'mailgun/client'
 require 'mailgun/response'
 require 'mailgun/chains'
+require 'mailgun/address'
 require 'mailgun/lists/opt_in_handler'
 require 'mailgun/messages/batch_message'
 require 'mailgun/messages/message_builder'

data/lib/mailgun/address.rb

@@ -0,0 +1,45 @@
+require 'mailgun/exceptions/exceptions'
+
+module Mailgun
+
+  # Mailgun::Address is a simple interface to the Email Validation API.
+  class Address
+
+    # @param [String] api_key Mailgun API - public key
+    def initialize(api_key = "")
+      if api_key == "" then
+        fail ParameterError.new('Public API key is required for Mailgun::Address.initialize()', nil)
+      end
+
+      @api_key = api_key
+      @client = Mailgun::Client.new(api_key = api_key)
+    end
+
+    # Given an arbitrary address, validates it based on defined checks.
+    #
+    # @param [String] address Email address to validate (max 512 chars.)
+    def validate(address)
+      res = @client.get "address/validate", {:address => address}
+      return res.to_h!
+    end
+
+    # Parses a delimiter separated list of email addresses into two lists:
+    # parsed addresses and unparsable portions. The parsed addresses are a
+    # list of addresses that are syntactically valid (and optionally have
+    # DNS and ESP specific grammar checks) the unparsable list is a list
+    # of characters sequences that the parser was not able to understand.
+    # These often align with invalid email addresses, but not always.
+    # Delimiter characters are comma (,) and semicolon (;).
+    #
+    # @param [Array] addresses Addresses to parse
+    # @param [TrueClass|FalseClass] syntax_only Perform only syntax checks
+    def parse(addresses, syntax_only = true)
+      validate_addrs = addresses.join(";")
+
+      res = @client.get "address/parse", {:addresses => validate_addrs,
+                                          :syntax_only => syntax_only.to_s}
+      return res.to_h!
+    end
+  end
+
+end

data/lib/mailgun/lists/opt_in_handler.rb

@@ -1,4 +1,3 @@
-require 'json'
 require 'uri'
 require 'base64'
 require 'openssl'

data/lib/mailgun/messages/message_builder.rb

@@ -1,5 +1,4 @@
 require 'time'
-require 'json'
 
 module Mailgun
 
@@ -334,10 +333,10 @@ module Mailgun
 
     # Private: Adds a file to the message.
     #
-    # disposition - a Symbol of either :inline or :attachment specifying how to
-    #   to set the file/image
-    # attachment  - either a file object or string which is a path to the file
-    # filename    - optional String signifying the filename
+    # @param [Symbol] disposition The type of file: :attachment or :inline
+    # @param [String] attachment A file object for attaching as an attachment.
+    # @param [String] filename The filename you wish the attachment to be.
+    # @return [void]
     #
     # Returns nothing
     def add_file(disposition, filedata, filename)

data/lib/mailgun/version.rb

@@ -1,4 +1,4 @@
 # It's the version. Yeay!
 module Mailgun
-  VERSION = '1.1.0'
+  VERSION = '1.1.1'
 end

data/mailgun.gemspec

@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = '>= 1.9.3'
+  spec.required_ruby_version = '>= 2.0.0'
 
   spec.add_development_dependency 'bundler', '~> 1.5'
   spec.add_development_dependency 'rspec', '~> 3.0'
@@ -32,7 +32,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'vcr', '~> 3.0'
   spec.add_development_dependency 'simplecov', '~> 0.11'
 
-  spec.add_dependency 'rest-client', '~> 1.6'
-  spec.add_dependency 'json', '~> 1.8'
+  spec.add_dependency 'rest-client', '~> 2.0'
 
 end

data/spec/integration/email_validation_spec.rb

@@ -1,29 +1,57 @@
 require 'spec_helper'
+
 require 'mailgun'
+require 'mailgun/address'
 
 vcr_opts = { :cassette_name => "email_validation" }
 
-describe 'For the Email Validation endpoint', vcr: vcr_opts do
+describe 'For the email validation endpoint', order: :defined, vcr: vcr_opts do
   before(:all) do
-    @mg_obj = Mailgun::Client.new(PUB_APIKEY)
+    @mg_obj = Mailgun::Address.new(PUB_APIKEY)
+
+    @valid = ["Alice <alice@example.com>", "bob@example.com"]
+    @invalid = ["example.org"]
+
+    @all_addrs = @valid + @invalid
   end
 
-  it 'validates an address.' do
-    result = @mg_obj.get("address/validate",
-                         {:address => "test@#{TESTDOMAIN}"})
+  it 'returns parsed and unparsable lists' do
+    res = @mg_obj.parse(@all_addrs)
 
-    result.to_h!
-    expect(result.body["is_valid"]).to eq(true)
-    expect(result.body["address"]).to eq("test@#{TESTDOMAIN}")
+    expect(res["parsed"]).to eq(@valid)
+    expect(res["unparseable"]).to eq(@invalid)
   end
 
-  it 'parses an address.' do
-    result = @mg_obj.get("address/parse",
-                         {:addresses => "Alice <alice@#{TESTDOMAIN}>,bob@#{TESTDOMAIN},#{TESTDOMAIN}"})
+  it 'validates alice@mailgun.net with info' do
+    res = @mg_obj.validate("alice@mailgun.net")
 
-    result.to_h!
-    expect(result.body["parsed"]).to include("Alice <alice@#{TESTDOMAIN}>")
-    expect(result.body["parsed"]).to include("bob@#{TESTDOMAIN}")
-    expect(result.body["unparseable"]).to include("#{TESTDOMAIN}")
+    expected = {
+        "address" => "alice@mailgun.net",
+        "did_you_mean" => nil,
+        "is_valid" => true,
+        "parts" => {
+            "display_name" => nil,
+            "domain" => "mailgun.net",
+            "local_part" => "alice",
+        },
+    }
+    expect(res).to eq(expected)
   end
+
+  it 'fails to validate example.org' do
+    res = @mg_obj.validate("example.org")
+
+    expected = {
+        "address" => "example.org",
+        "did_you_mean" => nil,
+        "is_valid" => false,
+        "parts" => {
+            "display_name" => nil,
+            "domain" => nil,
+            "local_part" => nil,
+        },
+    }
+    expect(res).to eq(expected)
+  end
+
 end

data/spec/unit/messages/message_builder_spec.rb

@@ -1,9 +1,10 @@
 require 'spec_helper'
+require 'stringio'
 
 describe 'MessageBuilder attribute readers' do
   it 'should be readable' do
     @mb_obj = Mailgun::MessageBuilder.new()
-    
+
     expect(@mb_obj).to respond_to(:message)
     expect(@mb_obj).to respond_to(:counters)
   end
@@ -52,7 +53,7 @@ describe 'The method add_recipient' do
   it 'adds a "cc" recipient type to the message body and counter is incremented' do
     recipient_type = :cc
     @mb_obj.add_recipient(recipient_type, @address, @variables)
-    
+
     expect(@mb_obj.message[recipient_type][0]).to eq("'#{@variables['first']} #{@variables['last']}' <#{@address}>")
     expect(@mb_obj.counters[:recipients][recipient_type]).to eq(1)
   end
@@ -60,7 +61,7 @@ describe 'The method add_recipient' do
   it 'adds a "bcc" recipient type to the message body and counter is incremented' do
     recipient_type = :bcc
     @mb_obj.add_recipient(recipient_type, @address, @variables)
-    
+
     expect(@mb_obj.message[recipient_type][0]).to eq("'#{@variables['first']} #{@variables['last']}' <#{@address}>")
     expect(@mb_obj.counters[:recipients][recipient_type]).to eq(1)
   end
@@ -68,7 +69,7 @@ describe 'The method add_recipient' do
   it 'adds a "h:reply-to" recipient type to the message body and counters are not incremented' do
     recipient_type = 'h:reply-to'
     @mb_obj.add_recipient(recipient_type, @address, @variables)
-    
+
     expect(@mb_obj.message[recipient_type][0]).to eq("'#{@variables['first']} #{@variables['last']}' <#{@address}>")
     @mb_obj.counters[:recipients].each_value{|value| expect(value).to eq(0)}
   end
@@ -76,13 +77,13 @@ describe 'The method add_recipient' do
   it 'ensures a random recipient type is added to the message body and counters are not incremented' do
     recipient_type = 'im-not-really-real'
     @mb_obj.add_recipient(recipient_type, @address, @variables)
-    
+
     expect(@mb_obj.message[recipient_type][0]).to eq("'#{@variables['first']} #{@variables['last']}' <#{@address}>")
     @mb_obj.counters[:recipients].each_value{|value| expect(value).to eq(0)}
   end
   it 'adds too many to recipients and raises an exception.' do
     recipient_type = :to
-    
+
     expect{
       1001.times do
         @mb_obj.add_recipient(recipient_type, @address, @variables)
@@ -90,7 +91,7 @@ describe 'The method add_recipient' do
   end
   it 'adds too many cc recipients and raises an exception.' do
     recipient_type = :cc
-    
+
     expect{
       1001.times do
         @mb_obj.add_recipient(recipient_type, @address, @variables)
@@ -98,7 +99,7 @@ describe 'The method add_recipient' do
   end
   it 'adds too many bcc recipients and raises an exception.' do
     recipient_type = :bcc
-    
+
     expect{
       1001.times do
         @mb_obj.add_recipient(recipient_type, @address, @variables)
@@ -118,17 +119,17 @@ describe 'The method subject' do
   before(:each) do
     @mb_obj = Mailgun::MessageBuilder.new
   end
-  
+
   it 'sets the message subject to blank if called and no parameters are provided' do
     @mb_obj.subject
-    
+
     expect(@mb_obj.message[:subject][0]).to eq('')
   end
-  
+
   it 'sets the message subject if called with the subject parameter' do
     the_subject = 'This is my subject!'
     @mb_obj.subject(the_subject)
-    
+
     expect(@mb_obj.message[:subject][0]).to eq(the_subject)
   end
 
@@ -137,7 +138,7 @@ describe 'The method subject' do
     the_second_subject = 'This is my second subject!'
     @mb_obj.subject(the_first_subject)
     @mb_obj.subject(the_second_subject)
-    
+
     expect(@mb_obj.message[:subject].length).to eq(1)
     expect(@mb_obj.message[:subject][0]).to eq(the_second_subject)
   end
@@ -169,7 +170,7 @@ describe 'The method body_text' do
     the_second_text = 'Don\'t mess with Texas!'
     @mb_obj.body_text(the_first_text)
     @mb_obj.body_text(the_second_text)
-    
+
     expect(@mb_obj.message[:text].length).to eq(1)
     expect(@mb_obj.message[:text][0]).to eq(the_second_text)
   end
@@ -187,11 +188,11 @@ describe 'The method from' do
   before(:each) do
     @mb_obj = Mailgun::MessageBuilder.new
   end
-  
+
   it 'sets the from address' do
     the_from_address = 'test@mailgun.com'
     @mb_obj.from(the_from_address)
-    
+
     expect(@mb_obj.message[:from]).to eq([the_from_address])
   end
 
@@ -200,7 +201,7 @@ describe 'The method from' do
     the_first_name = 'Magilla'
     the_last_name = 'Gorilla'
     @mb_obj.from(the_from_address, {'first' => the_first_name, 'last' => the_last_name})
-    
+
     expect(@mb_obj.message[:from]).to eq(["'#{the_first_name} #{the_last_name}' <#{the_from_address}>"])
   end
 end
@@ -217,7 +218,7 @@ describe 'The method add_attachment' do
     file_paths = [file1, file2]
 
     file_paths.each {|item| @mb_obj.add_attachment(item)}
-    
+
     expect(@mb_obj.message[:attachment].length).to eq(2)
   end
 
@@ -243,7 +244,7 @@ describe 'The method add_inline_image' do
     file_paths = [file1, file2]
 
     file_paths.each {|item| @mb_obj.add_inline_image(item)}
-    
+
     expect(@mb_obj.message[:inline].length).to eq(2)
   end
 end
@@ -262,29 +263,29 @@ describe 'The method test_mode' do
   end
   it 'turns on test mode with boolean true' do
     @mb_obj.test_mode(true)
-    
+
     expect(@mb_obj.message["o:testmode"][0]).to eq("yes")
   end
   it 'turns on test mode with string true' do
     @mb_obj.test_mode("true")
-    
+
     expect(@mb_obj.message["o:testmode"][0]).to eq("yes")
   end
   it 'turns off test mode with boolean false' do
     @mb_obj.test_mode(false)
-    
+
     expect(@mb_obj.message["o:testmode"][0]).to eq("no")
   end
   it 'turns off test mode with string false' do
     @mb_obj.test_mode("false")
-    
+
     expect(@mb_obj.message["o:testmode"][0]).to eq("no")
   end
   it 'does not allow multiple values' do
     @mb_obj.test_mode("false")
     @mb_obj.test_mode("true")
     @mb_obj.test_mode("false")
-    
+
     expect(@mb_obj.message["o:testmode"].length).to eq(1)
     expect(@mb_obj.message["o:testmode"][0]).to eq("no")
   end
@@ -304,29 +305,29 @@ describe 'The method dkim' do
   end
   it 'turns on dkim with boolean true' do
     @mb_obj.dkim(true)
-    
+
     expect(@mb_obj.message["o:dkim"][0]).to eq("yes")
   end
   it 'turns on dkim with string true' do
     @mb_obj.dkim("true")
-    
+
     expect(@mb_obj.message["o:dkim"][0]).to eq("yes")
   end
   it 'turns off dkim with boolean false' do
     @mb_obj.dkim(false)
-    
+
     expect(@mb_obj.message["o:dkim"][0]).to eq("no")
   end
   it 'turns off dkim with string false' do
     @mb_obj.dkim("false")
-    
+
     expect(@mb_obj.message["o:dkim"][0]).to eq("no")
   end
   it 'does not allow multiple values' do
     @mb_obj.dkim("false")
     @mb_obj.dkim("true")
     @mb_obj.dkim("false")
-    
+
     expect(@mb_obj.message["o:dkim"].length).to eq(1)
     expect(@mb_obj.message["o:dkim"][0]).to eq("no")
   end
@@ -338,14 +339,14 @@ describe 'The method add_campaign_id' do
   end
   it 'adds a campaign ID to the message' do
     @mb_obj.add_campaign_id('My-Campaign-Id-1')
-    
+
     expect(@mb_obj.message["o:campaign"][0]).to eq ("My-Campaign-Id-1")
   end
   it 'adds a few more campaign IDs to the message' do
     @mb_obj.add_campaign_id('My-Campaign-Id-1')
     @mb_obj.add_campaign_id('My-Campaign-Id-2')
     @mb_obj.add_campaign_id('My-Campaign-Id-3')
-    
+
     expect(@mb_obj.message["o:campaign"][0]).to eq("My-Campaign-Id-1")
     expect(@mb_obj.message["o:campaign"][1]).to eq("My-Campaign-Id-2")
     expect(@mb_obj.message["o:campaign"][2]).to eq("My-Campaign-Id-3")
@@ -364,14 +365,14 @@ describe 'The method add_tag' do
   end
   it 'adds a tag to the message' do
     @mb_obj.add_tag('My-Tag-1')
-    
+
     expect(@mb_obj.message["o:tag"][0]).to eq("My-Tag-1")
   end
   it 'adds a few more tags to the message' do
     @mb_obj.add_tag('My-Tag-1')
     @mb_obj.add_tag('My-Tag-2')
     @mb_obj.add_tag('My-Tag-3')
-    
+
     expect(@mb_obj.message["o:tag"][0]).to eq("My-Tag-1")
     expect(@mb_obj.message["o:tag"][1]).to eq("My-Tag-2")
     expect(@mb_obj.message["o:tag"][2]).to eq("My-Tag-3")
@@ -398,19 +399,19 @@ describe 'The method track_opens' do
   end
   it 'enables/disables open tracking on a per message basis.' do
     @mb_obj.track_opens('Yes')
-    
+
     expect(@mb_obj.message["o:tracking-opens"][0]).to eq("yes")
-    
+
     @mb_obj.track_opens('No')
-    
+
     expect(@mb_obj.message["o:tracking-opens"][0]).to eq("no")
-    
+
     @mb_obj.track_opens(true)
-    
+
     expect(@mb_obj.message["o:tracking-opens"][0]).to eq("yes")
-    
+
     @mb_obj.track_opens(false)
-    
+
     expect(@mb_obj.message["o:tracking-opens"][0]).to eq("no")
   end
 end
@@ -429,23 +430,23 @@ describe 'The method track_clicks' do
   end
   it 'enables/disables click tracking on a per message basis.' do
     @mb_obj.track_clicks('Yes')
-    
+
     expect(@mb_obj.message["o:tracking-clicks"][0]).to eq("yes")
-    
+
     @mb_obj.track_clicks('No')
-    
+
     expect(@mb_obj.message["o:tracking-clicks"][0]).to eq("no")
-    
+
     @mb_obj.track_clicks(true)
-    
+
     expect(@mb_obj.message["o:tracking-clicks"][0]).to eq("yes")
-    
+
     @mb_obj.track_clicks(false)
-    
+
     expect(@mb_obj.message["o:tracking-clicks"][0]).to eq("no")
-    
+
     @mb_obj.track_clicks('html')
-    
+
     expect(@mb_obj.message["o:tracking-clicks"][0]).to eq("html")
   end
 end
@@ -464,7 +465,7 @@ describe 'The method deliver_at' do
   end
   it 'defines a time/date to deliver a message in RFC2822 format.' do
     @mb_obj.deliver_at('October 25, 2013 10:00PM CST')
-    
+
     expect(@mb_obj.message["o:deliverytime"][0]).to eq("Fri, 25 Oct 2013 22:00:00 -0600")
   end
 end
@@ -483,14 +484,14 @@ describe 'The method header' do
   end
   it 'accepts valid JSON and appends as data to the message.' do
     @mb_obj.header('my-data', '{"key":"value"}')
-    
+
     expect(@mb_obj.message["v:my-data"][0]).to be_kind_of(String)
     expect(@mb_obj.message["v:my-data"][0].to_s).to eq('{"key"=>"value"}')
   end
   it 'accepts a hash and appends as data to the message.' do
     data = {'key' => 'value'}
     @mb_obj.header('my-data', data)
-    
+
     expect(@mb_obj.message["v:my-data"][0]).to be_kind_of(String)
     expect(@mb_obj.message["v:my-data"][0].to_s).to eq('{"key"=>"value"}')
   end
@@ -506,7 +507,7 @@ describe 'The method add_custom_parameter' do
   end
   it 'adds an undefined parameter to the message.' do
     @mb_obj.add_custom_parameter('h:my-sweet-header', 'datagoeshere')
-    
+
     expect(@mb_obj.message["h:my-sweet-header"][0]).to eq("datagoeshere")
   end
 end
@@ -526,21 +527,21 @@ describe 'The method message_id' do
   end
   it 'correctly sets the Message-Id header' do
     @mb_obj.message_id(@the_message_id)
-    
+
     expect(@mb_obj.message['h:Message-Id']).to eq(@the_message_id)
   end
   it 'correctly clears the Message-Id header when passed nil' do
     @mb_obj.message_id(nil)
-    
+
     expect(@mb_obj.message.has_key?('h:Message-Id')).to eq(false)
   end
   it 'correctly sets the Message-Id header when passed an empty string' do
     @mb_obj.message_id(@the_message_id)
-    
+
     expect(@mb_obj.message.has_key?('h:Message-Id')).to eq(true)
-    
+
     @mb_obj.message_id('')
-    
+
     expect(@mb_obj.message.has_key?('h:Message-Id')).to eq(false)
   end
 end

data/vcr_cassettes/email_validation.yml

@@ -2,7 +2,7 @@
 http_interactions:
 - request:
     method: get
-    uri: https://api:<PUBKEY>@api.mailgun.net/v3/address/validate?address=test@DOMAIN.TEST
+    uri: https://api:<PUBKEY>@api.mailgun.net/v3/address/parse?addresses=Alice%20%3Calice@example.com%3E%3Bbob@example.com%3Bexample.org&syntax_only=true
     body:
       encoding: US-ASCII
       string: ''
@@ -12,7 +12,9 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.0 (linux-gnu x86_64) ruby/2.3.1p112
+      Host:
+      - api.mailgun.net
   response:
     status:
       code: 200
@@ -21,13 +23,15 @@ http_interactions:
       Server:
       - nginx
       Date:
-      - Thu, 07 Jan 2016 22:08:10 GMT
+      - Wed, 26 Oct 2016 22:44:07 GMT
       Content-Type:
       - application/json
       Content-Length:
-      - '247'
+      - '118'
       Connection:
       - keep-alive
+      Content-Disposition:
+      - inline
       Access-Control-Allow-Origin:
       - "*"
       Access-Control-Max-Age:
@@ -40,20 +44,74 @@ http_interactions:
       encoding: UTF-8
       string: |-
         {
-          "address": "test@DOMAIN.TEST",
+          "parsed": [
+            "Alice <alice@example.com>",
+            "bob@example.com"
+          ],
+          "unparseable": [
+            "example.org"
+          ]
+        }
+    http_version: 
+  recorded_at: Wed, 26 Oct 2016 22:44:50 GMT
+- request:
+    method: get
+    uri: https://api:<PUBKEY>@api.mailgun.net/v3/address/validate?address=alice@mailgun.net
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept:
+      - "*/*"
+      Accept-Encoding:
+      - gzip, deflate
+      User-Agent:
+      - rest-client/2.0.0 (linux-gnu x86_64) ruby/2.3.1p112
+      Host:
+      - api.mailgun.net
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Wed, 26 Oct 2016 22:44:08 GMT
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '179'
+      Connection:
+      - keep-alive
+      Content-Disposition:
+      - inline
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Max-Age:
+      - '600'
+      Access-Control-Allow-Methods:
+      - GET, POST, PUT, DELETE, OPTIONS
+      Access-Control-Allow-Headers:
+      - Content-Type, x-requested-with
+    body:
+      encoding: UTF-8
+      string: |-
+        {
+          "address": "alice@mailgun.net",
           "did_you_mean": null,
           "is_valid": true,
           "parts": {
             "display_name": null,
-            "domain": "DOMAIN.TEST",
-            "local_part": "test"
+            "domain": "mailgun.net",
+            "local_part": "alice"
           }
         }
     http_version: 
-  recorded_at: Thu, 07 Jan 2016 22:08:10 GMT
+  recorded_at: Wed, 26 Oct 2016 22:44:50 GMT
 - request:
     method: get
-    uri: https://api:<PUBKEY>@api.mailgun.net/v3/address/parse?addresses=Alice%20%3Calice@DOMAIN.TEST%3E,bob@DOMAIN.TEST,DOMAIN.TEST
+    uri: https://api:<PUBKEY>@api.mailgun.net/v3/address/validate?address=example.org
     body:
       encoding: US-ASCII
       string: ''
@@ -63,7 +121,9 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.0 (linux-gnu x86_64) ruby/2.3.1p112
+      Host:
+      - api.mailgun.net
   response:
     status:
       code: 200
@@ -72,13 +132,15 @@ http_interactions:
       Server:
       - nginx
       Date:
-      - Thu, 07 Jan 2016 22:08:10 GMT
+      - Wed, 26 Oct 2016 22:44:08 GMT
       Content-Type:
       - application/json
       Content-Length:
-      - '223'
+      - '162'
       Connection:
       - keep-alive
+      Content-Disposition:
+      - inline
       Access-Control-Allow-Origin:
       - "*"
       Access-Control-Max-Age:
@@ -91,14 +153,15 @@ http_interactions:
       encoding: UTF-8
       string: |-
         {
-          "parsed": [
-            "Alice <alice@DOMAIN.TEST>",
-            "bob@DOMAIN.TEST"
-          ],
-          "unparseable": [
-            "DOMAIN.TEST"
-          ]
+          "address": "example.org",
+          "did_you_mean": null,
+          "is_valid": false,
+          "parts": {
+            "display_name": null,
+            "domain": null,
+            "local_part": null
+          }
         }
     http_version: 
-  recorded_at: Thu, 07 Jan 2016 22:08:10 GMT
-recorded_with: VCR 3.0.1
+  recorded_at: Wed, 26 Oct 2016 22:44:50 GMT
+recorded_with: VCR 3.0.3

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mailgun-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Mailgun
@@ -9,145 +9,131 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-10 00:00:00.000000000 Z
+date: 2016-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.5'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.22'
 - !ruby/object:Gem::Dependency
   name: pry
   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: vcr
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.11'
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '1.6'
-- !ruby/object:Gem::Dependency
-  name: json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '2.0'
 description: Mailgun's Official Ruby SDK for interacting with the Mailgun API.
 email: support@mailgunhq.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rubocop.yml"
-- ".rubocop_todo.yml"
-- ".ruby-env.yml.example"
-- ".travis.yml"
+- .gitignore
+- .rubocop.yml
+- .rubocop_todo.yml
+- .ruby-env.yml.example
+- .travis.yml
 - Domains.md
 - Events.md
 - Gemfile
@@ -159,7 +145,9 @@ files:
 - Rakefile
 - Snippets.md
 - Webhooks.md
+- lib/mailgun-ruby.rb
 - lib/mailgun.rb
+- lib/mailgun/address.rb
 - lib/mailgun/chains.rb
 - lib/mailgun/client.rb
 - lib/mailgun/domains/domains.rb
@@ -220,17 +208,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Mailgun's Official Ruby SDK