zerobounce 0.0.6 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5ef1325579afd30cbb3769cfbfe204c057fa7f12
-  data.tar.gz: 425716b0fc5f8af222625c4b9761745363d6fac8
+SHA256:
+  metadata.gz: 9317c9c0d5ce41ca5c3d27d9d71706383b9687d65b58eed217a786e1c4d1ab9a
+  data.tar.gz: 9924d6348aec8c24c470384569f183bc107746ac16d67c699b455c68e70b4b3c
 SHA512:
-  metadata.gz: 9cdf22f0b5d461eb37247ba3ab8facdbd73edea58381a54d3f9f85e5bc960dcab76f88549f9452b1d69af23c43e8847ece85e9ec405d8538a8ce7602e71367b5
-  data.tar.gz: 0674c6bdd1e4b52ccd492315c59faf5006c7c1a29534082c6300ee064c292c3aeffc4b12ad248f471c955cc9ea281c610de2e767a43a9cc8e9d976586cb68cd4
+  metadata.gz: 6fa9a4f46f860bb9352e71ed50017cf6df96426a52d44b1f2c3ebdfa9f467a74b353bcbcd6ced03e19264034d141272f438763f2e8c0f098c901cf7cafed5532
+  data.tar.gz: eb17307f8b3bd194abfac75e20fa18c56856d3c421f4a98e294ba98114dcf80edf652d849b6cb56a39238f0a08ba02ac6866d4619286ab16ee157ac3bc41d4d2

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here.

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

data/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: weekly
+      time: "10:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - afrase

data/.github/pull_request_template.md

@@ -0,0 +1,22 @@
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Description
+<!--- Describe your changes in detail -->
+
+## Related Issue
+<!--- This project only accepts pull requests related to open issues -->
+<!--- If suggesting a new feature or change, please discuss it in an issue first -->
+<!--- If fixing a bug, there should be an issue describing it with steps to reproduce -->
+<!--- Please link to the issue here: -->
+
+## Motivation and Context
+<!--- Why is this change required? What problem does it solve? -->
+
+## Checklist:
+<!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
+<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
+- [ ] My code follows the code style of this project.
+- [ ] My change requires a change to the documentation.
+- [ ] I have updated the documentation accordingly.
+- [ ] I have added tests to cover my changes.
+- [ ] All new and existing tests passed.

data/.github/workflows/gem-push.yml

@@ -0,0 +1,44 @@
+name: Ruby Gem
+
+on:
+  push:
+    tags:
+      - v*
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby 2.6
+        uses: actions/setup-ruby@v1
+        with:
+          ruby-version: 2.6.x
+
+      - name: Publish to GPR
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:github: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push --KEY github --host https://rubygems.pkg.github.com/${OWNER} *.gem
+        env:
+          GEM_HOST_API_KEY: "Bearer ${{secrets.GITHUB_TOKEN}}"
+          OWNER: ${{ github.repository_owner }}
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push *.gem
+        env:
+          GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/.github/workflows/ruby.yml

@@ -0,0 +1,34 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+name: Ruby
+
+on:
+  push:
+    branches:
+      - master
+      - main
+  pull_request:
+    branches:
+      - master
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [ '2.5', '2.6', '2.7', '3.0' ]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+      - name: Run tests
+        run: bundle exec rake

data/.gitignore

@@ -14,3 +14,4 @@ Gemfile.lock
 
 # rspec failure tracking
 .rspec_status
+.env

data/.rubocop.yml

@@ -1,7 +1,8 @@
 require: rubocop-rspec
 
 AllCops:
-  TargetRubyVersion: 2.4
+  TargetRubyVersion: 2.5
+  NewCops: enable
 
   Exclude:
     - 'bin/*'
@@ -16,7 +17,7 @@ Style/Documentation:
 Metrics/AbcSize:
   Max: 18
 
-Metrics/LineLength:
+Layout/LineLength:
   Max: 120
   Exclude:
     - 'spec/**/*'
@@ -36,3 +37,6 @@ Style/SymbolArray:
 
 RSpec/NestedGroups:
   Max: 5
+
+Style/AccessorGrouping:
+  EnforcedStyle: separated

data/.ruby-version

@@ -1 +1 @@
-ruby-2.4.3
+ruby-2.7.3

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+# 0.2.0
+
+* Update faraday and faraday_middleware dependency requirements.
+* Update rubocop dev dependencies and fixed failures.
+* Updated minimum ruby version to 2.5.
+
+# 0.1.2
+
+* Removed the double quote from the body check since it appears a space is added after the colon.
+* Added changelog file.
+
+# 0.1.1
+
+* Removed safe accessor usage to work with older versions of Ruby.
+
+# 0.1.0
+
+* Added support for V2 of Zerobounce API.

data/CONTRIBUTING.md

@@ -0,0 +1 @@
+TODO fill this out

data/README.md

@@ -1,7 +1,5 @@
 # Zerobounce
-[![Maintainability](https://api.codeclimate.com/v1/badges/35879ed0fe903e15175e/maintainability)](https://codeclimate.com/github/afrase/zerobounce/maintainability)
-[![Test Coverage](https://api.codeclimate.com/v1/badges/35879ed0fe903e15175e/test_coverage)](https://codeclimate.com/github/afrase/zerobounce/test_coverage)
-[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fafrase%2Fzerobounce.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fafrase%2Fzerobounce?ref=badge_shield)
+[![Ruby](https://github.com/afrase/zerobounce/actions/workflows/ruby.yml/badge.svg)](https://github.com/afrase/zerobounce/actions/workflows/ruby.yml)
 [![Gem Version](https://badge.fury.io/rb/zerobounce.svg)](https://badge.fury.io/rb/zerobounce)
 
 A ruby client for Zerobounce.net API.

data/bin/console

@@ -2,9 +2,6 @@
 
 require 'bundler/setup'
 require 'zerobounce'
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
 require 'pry'
+
 Pry.start

data/bin/setup

@@ -4,5 +4,3 @@ IFS=$'\n\t'
 set -vx
 
 bundle install
-
-# Do any other automated setup that you need to do here

data/lib/zerobounce.rb

@@ -43,11 +43,7 @@ module Zerobounce
     # @option params [Proc] :middleware Use different middleware for this request.
     # @return [Zerobounce::Response]
     def validate(params)
-      if params.key?(:ipaddress) || params.key?(:ip_address)
-        Request.new(params).validate_with_ip(params)
-      else
-        Request.new(params).validate(params)
-      end
+      Request.new(params).validate(params)
     end
 
     # Get the number of remaining credits on the account.

data/lib/zerobounce/configuration.rb

@@ -24,6 +24,9 @@ module Zerobounce
   #   @note If you modify the default make sure to add middleware to parse
   #     the response as json and symbolize the keys.
   #
+  # @attr [String] api_version
+  #   The version of the API to use.
+  #
   # @attr [Array<Symbol>] valid_statues
   #   The statuses that are considered valid by {Response#valid?}.
   class Configuration
@@ -31,16 +34,19 @@ module Zerobounce
     attr_accessor :headers
     attr_accessor :apikey
     attr_accessor :middleware
+    attr_accessor :api_version
     attr_accessor :valid_statuses
 
     def initialize
       self.host = 'https://api.zerobounce.net'
       self.apikey = ENV['ZEROBOUNCE_API_KEY']
+      self.api_version = 'v2'
       self.valid_statuses = %i[valid catch_all]
       self.headers = { user_agent: "ZerobounceRubyGem/#{Zerobounce::VERSION}" }
 
       self.middleware = proc do |builder|
         builder.response(:json, content_type: /\bjson$/, parser_options: { symbolize_names: true })
+        builder.response(:logger) { |l| l.filter(/(api_?key=)(\w+)/, '\1[REMOVED]') } if ENV['ZEROBOUNCE_API_DEBUG']
         builder.use(Zerobounce::Middleware::RaiseError)
         builder.adapter(Faraday.default_adapter)
       end

data/lib/zerobounce/error.rb

@@ -7,28 +7,26 @@ module Zerobounce
   #
   # @author Aaron Frase
   class Error < StandardError
+    attr_reader :env
+
     def initialize(env={})
       @env = env
-    end
-
-    # Message for the error.
-    #
-    # @return [String]
-    def message
-      @env[:body]
+      super(env[:body])
     end
 
     class << self
       # Parse the response for errors.
       #
       # @param [Hash] env
-      # @return [Error]
+      # @return [Error, nil]
       def from_response(env)
         case env[:status]
         when 500
-          parse_500(env)
+          parse500(env)
         when 200
-          parse_200(env)
+          parse200(env)
+        else
+          UnknownError.new(env)
         end
       end
 
@@ -36,8 +34,8 @@ module Zerobounce
 
       # @param [Hash] env
       # @return [Error]
-      def parse_500(env)
-        if env[:body]&.start_with?('Missing parameter')
+      def parse500(env)
+        if env[:body].to_s.start_with?('Missing parameter')
           MissingParameter.new(env)
         else
           InternalServerError.new(env)
@@ -46,10 +44,10 @@ module Zerobounce
 
       # @param [Hash] env
       # @return [Error, nil]
-      def parse_200(env)
+      def parse200(env)
         # The body hasn't been parsed yet and to avoid potentially parsing the body twice
         # we just use String#start_with?
-        ApiError.new(env) if env[:body]&.start_with?('{"error":"')
+        ApiError.new(env) if env[:body].to_s.start_with?('{"error":')
       end
     end
   end
@@ -66,6 +64,12 @@ module Zerobounce
   class MissingParameter < Error
   end
 
+  # When the status code isn't in the defined codes to parse.
+  #
+  # @author Aaron Frase
+  class UnknownError < Error
+  end
+
   # General API error, the response code was 200 but an error still occurred.
   #
   # @author Aaron Frase

data/lib/zerobounce/middleware/raise_error.rb

@@ -14,7 +14,7 @@ module Zerobounce
       # @param [Hash] env
       # @raise [Error]
       def on_complete(env)
-        if (error = Zerobounce::Error.from_response(env)) # rubocop:disable GuardClause
+        if (error = Zerobounce::Error.from_response(env)) # rubocop:disable Style/GuardClause
           raise error
         end
       end

data/lib/zerobounce/request.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'faraday'
+require 'zerobounce/request/v1_request'
+require 'zerobounce/request/v2_request'
 
 module Zerobounce
   # Sends the HTTP request.
@@ -16,46 +18,30 @@ module Zerobounce
   # @attr_reader [Proc] middleware
   #   Faraday middleware used for the request.
   class Request
-    # The normal email validation endpoint.
-    VALIDATE_PATH = '/v1/validate'
-    # The validation endpoint for email and IP validation.
-    VALIDATE_WITH_IP_PATH = '/v1/validatewithip'
-    # The path to get number number of credits remaining on the account.
-    GET_CREDITS_PATH = '/v1/getcredits'
-
     attr_reader :host
     attr_reader :headers
     attr_reader :middleware
+    attr_reader :api_version
 
+    # Set instance variables and extends the correct Zerobounce::Request
+    #
     # @param [Hash] params
     # @option params [String] :middleware default: {Configuration#middleware} {include:#middleware}
     # @option params [String] :headers default: {Configuration#headers} {include:#headers}
     # @option params [String] :host default: {Configuration#host} {include:#host}
+    # @option params [String] :api_version default: {Configuration#api_version} {include:#api_version}
     def initialize(params={})
       @middleware = params[:middleware] || Zerobounce.config.middleware
       @headers = params[:headers] || Zerobounce.config.headers
       @host = params[:host] || Zerobounce.config.host
-    end
-
-    # Validate the email address.
-    #
-    # @param [Hash] params
-    # @option params [String] :email
-    # @option params [String] :apikey
-    # @return [Zerobounce::Response]
-    def validate(params)
-      Response.new(get(VALIDATE_PATH, params), self)
-    end
+      @api_version = params[:api_version] || Zerobounce.config.api_version
 
-    # Validate the email address and get geoip info for the IP.
-    #
-    # @param [Hash] params
-    # @option params [String] :email
-    # @option params [String] :ip_address
-    # @option params [String] :apikey
-    # @return [Zerobounce::Response]
-    def validate_with_ip(params)
-      Response.new(get(VALIDATE_WITH_IP_PATH, params), self)
+      case api_version
+      when 'v2'
+        extend(V2Request)
+      else
+        extend(V1Request)
+      end
     end
 
     # Get the number of remaining credits on the account.
@@ -64,7 +50,7 @@ module Zerobounce
     # @option params [String] :apikey
     # @return [Integer] A value of -1 can mean the API is invalid.
     def credits(params={})
-      get(GET_CREDITS_PATH, params).body[:Credits]&.to_i
+      get('getcredits', params).body[:Credits].to_i
     end
 
     private
@@ -80,15 +66,7 @@ module Zerobounce
 
     # @return [Faraday::Connection]
     def conn
-      @conn ||= Faraday.new(host, headers: headers, &middleware)
-    end
-
-    # @param [Hash] params
-    # @return [Hash]
-    def get_params(params)
-      valid_params = %i[apikey ipaddress email]
-      params[:ipaddress] = params.delete(:ip_address) if params.key?(:ip_address) # normalize ipaddress key
-      { apikey: Zerobounce.config.apikey }.merge(params.select { |k, _| valid_params.include?(k) })
+      @conn ||= Faraday.new("#{host}/#{api_version}", headers: headers, &middleware)
     end
   end
 end