emailable 3.2.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59b57b0948d78b837e5a3f82a0a0e5c5446742f57e50ebbd2c5b0817f0aabfc5
-  data.tar.gz: 58ce6a2ac2a9846e5daa63157014cbe0b557f4c94f30c71d9252db8e169cc12f
+  metadata.gz: 02e893db37f9960d70d4a0ed17f712ef1e02f13f707d57e7428c3f2b07e36b6d
+  data.tar.gz: 7ab4fc1440cc5cd172059f4d2bb53cc51f169f5f21cb7a9bb919d97f04b2b543
 SHA512:
-  metadata.gz: 033fe8af379957fdee488fca886d3e3ac4818a7f8587b80554424c7ec824bd9dd1ed949268bc246da1460d0afc449df640cdca8e7bf4fcfbef6790c6c5b1fb1a
-  data.tar.gz: 9d9ff16f6db49bc2c8791ae46be20dfdc7e5d8e58cc9b603e9e04492b85d97bc0bf48b7933ca46a1362469cba4ca923b35a4444c056699716a15417518454897
+  metadata.gz: eb96ef05631762f2e6fa53e13a621e6006f23af42dba60fa36a86adc978b8b537def118e7547c8af4da8925109a7b671e7cfba4c5eab031a4c874f2e15e64f1d
+  data.tar.gz: c1292e55f4ba32a80da7a30e9d9f401d51f0747d23ccac2f1e8cd336020b9cda45413e7f423eb0b00fee24bb618704e596d20203f8334f532a9d364b97df218f

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    emailable (3.1.1)
+    emailable (4.0.0)
 
 GEM
   remote: https://rubygems.org/
@@ -17,20 +17,20 @@ GEM
     ansi (1.5.0)
     awesome_print (1.8.0)
     builder (3.2.3)
-    coderay (1.1.2)
+    coderay (1.1.3)
     concurrent-ruby (1.1.7)
     i18n (1.8.5)
       concurrent-ruby (~> 1.0)
-    method_source (0.9.2)
+    method_source (1.0.0)
     minitest (5.11.3)
     minitest-reporters (1.3.6)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
     rake (13.0.1)
     ruby-progressbar (1.10.1)
     thread_safe (0.3.6)

data/README.md

@@ -29,7 +29,9 @@ Or install it yourself as:
 
 ## Usage
 
-The library needs to be configured with your account's API key which is available in your [Emailable Dashboard](https://app.emailable.com/api). Set `Emailable.api_key` to its value:
+The library needs to be configured with your account's API key which is
+available in your [Emailable Dashboard](https://app.emailable.com/api). Set
+`Emailable.api_key` to its value:
 
 ### Setup
 
@@ -47,6 +49,9 @@ Emailable.api_key = 'live_...'
 Emailable.verify('jarrett@emailable.com')
 ```
 
+All supported parameters for the verify endpoint can be passed in as hash
+arguments to the `verify` method.
+
 #### Slow Email Server Handling
 
 Some email servers are slow to respond. As a result, the timeout may be reached
@@ -60,23 +65,29 @@ email `slow@example.com`.
 
 ### Batch Verification
 
+First, create an `Emailable::Batch` object. Then, call the `verify` method to
+start the batch. All supported parameters for the batch verification endpoint
+can be passed in as hash arguments to the `verify` method.
+
 #### Start a batch
 
 ```ruby
 emails = ['jarrett@emailable.com', 'support@emailable.com', ...]
 batch = Emailable::Batch.new(emails)
 
-# you can optionally pass in a callback url that we'll POST to when the
-# batch is complete.
-batch = Emailable::Batch.new(emails, callback: 'https://emailable.com/')
-
 # start verifying the batch
 batch.verify
+
+# you can optionally pass in a callback url that we'll POST to when the batch
+# is complete.
+batch.verify(url: 'https://emailable.com/')
 ```
 
 #### Get the status / results of a batch
 
-Calling `status` on a batch will return the status. It will contain the results as well once complete. You can also `results` to get just the results.
+Calling `status` on a batch will return the status. It will contain the results
+as well once complete. All supported parameters for the status endpoint can be
+passed in as hash arguments to the `status` method.
 
 ```ruby
 id = '5cfcbfdeede34200693c4319'
@@ -85,6 +96,9 @@ batch = Emailable::Batch.new(id)
 # get status of batch
 batch.status
 
+# get the status of a batch, with partial results if the batch is incomplete
+batch.status(partial: true)
+
 # gets the results
 batch.status.emails
 
@@ -126,10 +140,17 @@ attr_accessor :email_verification_result
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake test` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and tags, and push the `.gem` file to
+[rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/emailable/emailable-ruby.
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/emailable/emailable-ruby.

data/lib/emailable/batch.rb

@@ -2,15 +2,13 @@ module Emailable
   class Batch
     attr_accessor :id
 
-    def initialize(id_or_emails, callback: nil)
+    def initialize(id_or_emails)
       if id_or_emails.is_a?(Array)
         @id = nil
         @emails = id_or_emails
-        @callback = callback
       elsif id_or_emails.is_a?(String)
         @id = id_or_emails
         @emails = nil
-        @callback = nil
       else
         raise ArgumentError, 'expected an array of emails or batch id'
       end
@@ -19,21 +17,21 @@ module Emailable
       @status = nil
     end
 
-    def verify(simulate: nil)
+    def verify(parameters = {})
       return @id unless @id.nil?
 
-      opts = { emails: @emails.join(','), url: @callback, simulate: simulate }
-      response = @client.request(:post, 'batch', opts)
+      parameters[:emails] = @emails.join(',')
+      response = @client.request(:post, 'batch', parameters)
 
       @id = response.body['id']
     end
 
-    def status(simulate: nil, partial: nil)
+    def status(parameters = {})
       return nil unless @id
       return @status if @status
 
-      body = { id: @id, simulate: simulate, partial: partial }
-      response = @client.request(:get, 'batch', body)
+      parameters[:id] = @id
+      response = @client.request(:get, 'batch', parameters)
       bs = BatchStatus.new(response.body)
       @status = bs if bs.complete?
 

data/lib/emailable/email_validator.rb

@@ -38,7 +38,7 @@ class EmailValidator < ActiveModel::EachValidator
 
     api_options = { timeout: timeout, smtp: smtp }
     api_options[:accept_all] = true unless accept_all
-    ev = Emailable.verify(value, **api_options)
+    ev = Emailable.verify(value, api_options)
 
     result_accessor = "#{attribute}_verification_result"
     if record.respond_to?(result_accessor)

data/lib/emailable/version.rb

@@ -1,3 +1,3 @@
 module Emailable
-  VERSION = '3.2.0'
+  VERSION = '4.0.0'
 end

data/lib/emailable.rb

@@ -28,13 +28,11 @@ module Emailable
 
   module_function
 
-  def verify(email, smtp: nil, accept_all: nil, timeout: nil)
-    opts = {
-      email: email, smtp: smtp, accept_all: accept_all, timeout: timeout
-    }
+  def verify(email, parameters = {})
+    parameters[:email] = email
 
     client = Emailable::Client.new
-    response = client.request(:get, 'verify', opts)
+    response = client.request(:get, 'verify', parameters)
 
     if response.status == 249
       raise Emailable::TimeoutError.new(response.body)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: emailable
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Emailable
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-17 00:00:00.000000000 Z
+date: 2022-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler