snov 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29a980f1ec57e85a5f0fbf089fdcb646e5a66454c91515d90e33b7aaec042ac6
-  data.tar.gz: 17e52baa847e7f42eba8696e35509f7478582696092a8e0cd229cf108c097d5c
+  metadata.gz: 83ba4d0a62cbaa8174ff7b35a0ec270fa9d1b5381743aedc80dd0d6d834f021e
+  data.tar.gz: d3d598766a17f72df681ab1cccdc951f7582647dfadc45642d9679953d501636
 SHA512:
-  metadata.gz: 9ce75c52ecf8c7bd180ad2a2b4ea510acb494b59060f779424c0d5db7888ca18c75d9eb16ed8b66b58e46555a193e89f41b8df760177f0bd70f6076e3b94a9b9
-  data.tar.gz: 41e171a1eaa943b01e82369979939f2f28523ed3a2835029453918965b324946a1507e8dae64df88980e603073d50d8d9c1de9612fd9f0017745cfca96733e0b
+  metadata.gz: a9a3b218b1d8689904f37e579e71349bb5ef29caf3f9360ed854fd346c0cad55255a989cbf877e561dce09bf0225bc3cdd4302a6004faa73602b59409b68a4e9
+  data.tar.gz: 1d713a008faccc5cbb2487c324c0451d5181e23752b5571f6338af584c99795c5cdb0ace999986db278df2dae1e17b3ae0420f9cfb4118b7732f6a435571aa72

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+* add OutOfCreditsError
+
+## [0.5.0]
+* support for https://snov.io/api#EmailFinder (GetEmailsFromName)
+
 ## [0.4.1]
 * allow forward slash for test response files while using fake client
 

data/README.md

@@ -198,6 +198,19 @@ see https://snov.io/api#EmailFinder
   end
 ```
 
+### AddNamesToFindEmails
+
+convenience wrapper for `AddNamesToFindEmails` to add a prospect with name
+
+see https://snov.io/api#AddNamestoFindEmails
+
+```ruby
+  added_name = Snov::AddNamesToFindEmails.new(first_name: "gavin", last_name: "vanrooyen", domain: "octagon.com").add
+
+  puts added_name.sent # true added to snov queue for searching
+  puts added_name.success
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/snov.rb

@@ -26,4 +26,5 @@ require 'snov/get_prospect_list'
 require 'snov/get_user_lists'
 require 'snov/get_emails_by_social_url'
 require 'snov/get_emails_from_name'
+require 'snov/add_names_to_find_emails'
 require 'snov/domain_search'

data/lib/snov/add_names_to_find_emails.rb

@@ -0,0 +1,30 @@
+module Snov
+  class AddNamesToFindEmails
+    attr_reader :client
+
+    def initialize(client: Snov.client, first_name:, last_name:, domain:)
+      @client = client
+      @first_name = first_name
+      @last_name = last_name
+      @domain = domain
+    end
+
+    def add
+      @add ||= ProspectResult.new(raw_result)
+    end
+
+    def raw_result
+      @raw_result ||= client.post("/v1/add-names-to-find-emails",
+                                  "firstName" => @first_name,
+                                  "lastName" => @last_name,
+                                  "domain" => @domain)
+                            .deep_transform_keys! { |key| key.underscore }
+    end
+
+    class ProspectResult
+      include ActiveModel::Model
+
+      attr_accessor :success, :first_name, :last_name, :domain, :user_id, :sent
+    end
+  end
+end

data/lib/snov/client.rb

@@ -22,6 +22,8 @@ module Snov
 
     class BadGatewayError < ResponseError; end
 
+    class OutOfCreditsError < BadGatewayError; end
+
     class ForbiddenError < ResponseError; end
 
     class GatewayTimeOut < ResponseError; end
@@ -33,6 +35,14 @@ module Snov
     ERROR_CLASSES = { 401 => UnauthorizedError, 502 => BadGatewayError, 403 => ForbiddenError,
                       504 => GatewayTimeOut, 400 => BadRequest, 405 => MethodNotAllowed }
 
+    def self.select_error_class(resp, fallback: ResponseError)
+      if resp&.body.to_s.include?('you ran out of credits')
+        OutOfCreditsError
+      else
+        ERROR_CLASSES.fetch(resp.status, fallback)
+      end
+    end
+
     def initialize(client_id:, client_secret:, access_token: nil, timeout_seconds: 90)
       self.client_id = client_id.to_str
       self.client_secret = client_secret.to_str
@@ -66,7 +76,7 @@ module Snov
 
     def parse_response(resp, path, _params)
       unless resp.success?
-        error_class = ERROR_CLASSES.fetch(resp.status, ResponseError)
+        error_class = Client.select_error_class(resp, fallback: ResponseError)
         raise error_class.new("#{path} (#{resp.status})", response: resp&.body)
       end
       MultiJson.load(resp.body)

data/lib/snov/version.rb

@@ -1,3 +1,3 @@
 module Snov
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: snov
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Grant Petersen-Speelman
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-06-18 00:00:00.000000000 Z
+date: 2021-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -134,6 +134,7 @@ files:
 - bin/setup
 - gems.rb
 - lib/snov.rb
+- lib/snov/add_names_to_find_emails.rb
 - lib/snov/client.rb
 - lib/snov/domain_search.rb
 - lib/snov/fake_client.rb