lob 3.0.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 37c8b30c17f9f1e2bf17d7fb3030e6a5f503ed08
-  data.tar.gz: f3be769fb4eb543072f637e89c5a2a382391872b
+  metadata.gz: 98855f792febf3dad2f0d885fb55f1995faea52f
+  data.tar.gz: a630435538c358b6c2bb72caae28490e588ea94d
 SHA512:
-  metadata.gz: 83785a95d0f3bed197b7ce4f89269b8c695715f5aafc1591651229ed2ffe47888209097320919befa9a20b25d17ec5a72b77a496b69ca648bb6f543248c85365
-  data.tar.gz: 20bca49d8ab6271f0c4c9b0186aa55e3b4a2dc8277b68bc2795f01477b426185589e465afab92697c809a605cb8b7d016a5876ef8cf078e1592c052be84c0daf
+  metadata.gz: bc028726b431293f20f313ed6852e8e08de864dff3e7bfe016422801991d8d171e8d05d173628d6c2e880c93729e35f17cd0e5eb41b707dd361b7ca50a25e410
+  data.tar.gz: 7b95754a03c640da8c37967286820883105c58f90d5d1ffbfd1342a2f1cd92e8a4e5523914d60e04899dbe700d62ac32df6e0cf2a3168b4fcdbda07450dd903c

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 4.0.0
+
+Version 4.0.0 introduces a breaking change. It requires a minimum API version of `2017-05-17`, which introduces new US and International Verification APIs.
+
+* Removes `Lob.addresses.verify()`. Please use `Lob.us_verifications.verify()` and `Lob.intl_verifications.verify() instead.
+
 ## 3.0.0
 
 Version 3.0.0 introduces several breaking changes. It requires a minimum API version of `2015-04-11`.

data/README.md

@@ -29,7 +29,7 @@ Here's a general overview of the Lob services available, click through to read m
 - [Letters API](https://lob.com/services/letters)
 - [Checks API](https://lob.com/services/checks)
 - [Area Mail API](https://lob.com/services/area)
-- [Address Verification API](https://lob.com/verification/address)
+- [Address Verification API](https://lob.com/services/verifications)
 
 ### Registration
 
@@ -115,6 +115,7 @@ There are simple scripts to demonstrate how to create all the core Lob products
 - [Versioning](https://lob.com/docs/ruby#version)
 - [Errors](https://lob.com/docs/ruby#errors)
 - [Rate Limiting](https://lob.com/docs/ruby#rate-limits)
+- [Webhooks](https://lob.com/docs/ruby#webhooks)
 - [Metadata](https://lob.com/docs/ruby#metadata)
 - [Asset URLs](https://lob.com/docs/ruby#urls)
 - **Addresses**
@@ -124,8 +125,13 @@ There are simple scripts to demonstrate how to create all the core Lob products
     - [Retrieve an Address](https://lob.com/docs/ruby#addresses_retrieve)
     - [Delete an Address](https://lob.com/docs/ruby#addresses_delete)
     - [List all Addresses](https://lob.com/docs/ruby#addresses_list)
-  - [Address Verification API](https://lob.com/docs/ruby#verify)
-    - [Verify an Address](https://lob.com/docs/ruby#verify_create)
+- **US Verification API**
+  - [US Verifications](https://lob.com/docs/ruby#us_verifications)
+    - [The US Verifications Object](https://lob.com/docs/ruby#us_verifications_object)
+    - [Verify a US address](https://lob.com/docs/ruby#us_verifications_create)
+- **Int'l Verification API**
+  - [International Verifications](https://lob.com/docs/ruby#intl_verifications)
+    - [Verify an int'l address](https://lob.com/docs/ruby#intl_verifications_create)
 - **Postcards API**
   - [Postcards](https://lob.com/docs/ruby#postcards)
     - [The Postcard Object](https://lob.com/docs/ruby#postcards_object)
@@ -169,8 +175,10 @@ There are simple scripts to demonstrate how to create all the core Lob products
 - **Appendix**
   - [API Changelog](https://lob.com/docs/ruby#changelog)
   - [The Tracking Event Object](https://lob.com/docs/ruby#tracking_event_object)
+  - [Events](https://lob.com/docs/ruby#events)
   - [HTML Examples](https://lob.com/docs/ruby#html-examples)
   - [Image Prepping](https://lob.com/docs/ruby#prepping)
+  - [US Verification Details](https://lob.com/docs/ruby#us_verification_details)
 
 ## Contributing
 

data/lib/lob/client.rb

@@ -3,10 +3,12 @@ require "lob/resources/area"
 require "lob/resources/bank_account"
 require "lob/resources/check"
 require "lob/resources/country"
+require "lob/resources/intl_verifications"
 require "lob/resources/letter"
 require "lob/resources/postcard"
 require "lob/resources/route"
 require "lob/resources/state"
+require "lob/resources/us_verifications"
 
 module Lob
   class Client
@@ -41,6 +43,10 @@ module Lob
       Lob::Resources::Country.new(config)
     end
 
+    def intl_verifications
+      Lob::Resources::IntlVerifications.new(config)
+    end
+
     def letters
       Lob::Resources::Letter.new(config)
     end
@@ -57,5 +63,9 @@ module Lob
       Lob::Resources::State.new(config)
     end
 
+    def us_verifications
+      Lob::Resources::USVerifications.new(config)
+    end
+
   end
 end

data/lib/lob/resources/address.rb

@@ -9,16 +9,6 @@ module Lob
         @endpoint = "addresses"
       end
 
-      def verify(options={})
-        submit :post, address_verify_url, options
-      end
-
-      private
-
-      def address_verify_url
-        "#{base_url}/verify"
-      end
-
     end
   end
 end

data/lib/lob/resources/intl_verifications.rb

@@ -0,0 +1,20 @@
+require "lob/resources/resource_base"
+
+module Lob
+  module Resources
+    class IntlVerifications < Lob::Resources::ResourceBase
+
+      undef_method :list, :find, :create, :destroy
+
+      def initialize(config)
+        super(config)
+        @endpoint = "intl_verifications"
+      end
+
+      def verify(options={})
+        submit :post, endpoint_url, options
+      end
+
+    end
+  end
+end

data/lib/lob/resources/us_verifications.rb

@@ -0,0 +1,20 @@
+require "lob/resources/resource_base"
+
+module Lob
+  module Resources
+    class USVerifications < Lob::Resources::ResourceBase
+
+      undef_method :list, :find, :create, :destroy
+
+      def initialize(config)
+        super(config)
+        @endpoint = "us_verifications"
+      end
+
+      def verify(options={})
+        submit :post, endpoint_url, options
+      end
+
+    end
+  end
+end

data/lib/lob/version.rb

@@ -1,3 +1,3 @@
 module Lob
-  VERSION = "3.0.0"
+  VERSION = "4.0.0"
 end

data/spec/lob/resources/address_spec.rb

@@ -18,21 +18,6 @@ describe Lob::Resources::Address do
 
   subject { Lob::Client.new(api_key: API_KEY) }
 
-  describe "verify" do
-
-    it "should verify an address" do
-      result = subject.addresses.verify(
-        address_line1: @sample_params[:address_line1],
-        address_city:  @sample_params[:address_city],
-        address_state: @sample_params[:address_state],
-        address_zip:   @sample_params[:address_zip]
-      )
-
-      result["address"]["address_country"].must_equal("US")
-    end
-  end
-
-
   describe "list" do
     it "should list addresses" do
       assert subject.addresses.list["object"] == "list"

data/spec/lob/resources/intl_verifications_spec.rb

@@ -0,0 +1,28 @@
+require "spec_helper"
+
+describe Lob::Resources::IntlVerifications do
+
+  before :each do
+    @sample_params = {
+      address_line1: "123 Test St",
+      address_city: "HEARST",
+      address_state: "ONTARIO",
+      address_zip: "P0L1N0",
+      address_country: "CA"
+    }
+  end
+
+  subject { Lob::Client.new(api_key: API_KEY) }
+
+  describe "verify" do
+    it "should return a 403 in test mode" do
+      begin
+        subject.intl_verifications.verify @sample_params
+      rescue Lob::InvalidRequestError => e
+        assert e.http_status == 403
+        assert e._response.headers.include?(:content_type)
+      end
+    end
+  end
+
+end

data/spec/lob/resources/us_verifications_spec.rb

@@ -0,0 +1,27 @@
+require "spec_helper"
+
+describe Lob::Resources::USVerifications do
+
+  before :each do
+    @sample_params = {
+      recipient: "LOB.COM",
+      primary_line: "185 BERRY ST STE 6600",
+      city: "SAN FRANCISCO",
+      state: "CA",
+      zip_code: "94107"
+    }
+  end
+
+  subject { Lob::Client.new(api_key: API_KEY) }
+
+  describe "verify" do
+    it "should verify a US address" do
+      result = subject.us_verifications.verify @sample_params
+
+      result["recipient"].must_equal(@sample_params[:recipient])
+      result["primary_line"].must_equal(@sample_params[:primary_line])
+      result["last_line"].must_equal("SAN FRANCISCO CA 94107-1728")
+    end
+  end
+
+end

metadata

@@ -1,145 +1,145 @@
 --- !ruby/object:Gem::Specification
 name: lob
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Lob
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-10-11 00:00:00.000000000 Z
+date: 2017-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '1.8'
-    - - "<"
+    - - <
       - !ruby/object:Gem::Version
         version: '3.0'
-  type: :runtime
+  name: rest-client
   prerelease: false
+  type: :runtime
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '>='
       - !ruby/object:Gem::Version
         version: '1.8'
-    - - "<"
+    - - <
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
-  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
-  type: :development
+  name: bundler
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
-  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 10.4.2
-  type: :development
+  name: rake
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 10.4.2
 - !ruby/object:Gem::Dependency
-  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 5.6.1
-  type: :development
+  name: minitest
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 5.6.1
 - !ruby/object:Gem::Dependency
-  name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.2'
-  type: :development
+  name: webmock
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.2'
 - !ruby/object:Gem::Dependency
-  name: travis-lint
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 2.0.0
-  type: :development
+  name: travis-lint
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 2.0.0
 - !ruby/object:Gem::Dependency
-  name: coveralls
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.8.1
-  type: :development
+  name: coveralls
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.8.1
 - !ruby/object:Gem::Dependency
-  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.10.0
-  type: :development
+  name: simplecov
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.10.0
 - !ruby/object:Gem::Dependency
-  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.10.0
-  type: :development
+  name: pry
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.10.0
 description: Lob API Ruby wrapper
@@ -149,8 +149,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
+- .gitignore
+- .travis.yml
 - CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
@@ -181,11 +181,13 @@ files:
 - lib/lob/resources/bank_account.rb
 - lib/lob/resources/check.rb
 - lib/lob/resources/country.rb
+- lib/lob/resources/intl_verifications.rb
 - lib/lob/resources/letter.rb
 - lib/lob/resources/postcard.rb
 - lib/lob/resources/resource_base.rb
 - lib/lob/resources/route.rb
 - lib/lob/resources/state.rb
+- lib/lob/resources/us_verifications.rb
 - lib/lob/version.rb
 - lob.gemspec
 - spec/lob/errors/lob_error_spec.rb
@@ -194,11 +196,13 @@ files:
 - spec/lob/resources/bank_account_spec.rb
 - spec/lob/resources/check_spec.rb
 - spec/lob/resources/country_spec.rb
+- spec/lob/resources/intl_verifications_spec.rb
 - spec/lob/resources/letter_spec.rb
 - spec/lob/resources/postcard_spec.rb
 - spec/lob/resources/resource_base_spec.rb
 - spec/lob/resources/route_spec.rb
 - spec/lob/resources/state_spec.rb
+- spec/lob/resources/us_verifications_spec.rb
 - spec/lob_spec.rb
 - spec/samples/8.5x11.pdf
 - spec/samples/postcardback.pdf
@@ -208,24 +212,24 @@ homepage: https://github.com/lob/lob-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.6
-signing_key: 
+rubyforge_project:
+rubygems_version: 2.4.5
+signing_key:
 specification_version: 4
 summary: Ruby wrapper for Lob.com API with ActiveRecord-style syntax
 test_files:
@@ -235,11 +239,13 @@ test_files:
 - spec/lob/resources/bank_account_spec.rb
 - spec/lob/resources/check_spec.rb
 - spec/lob/resources/country_spec.rb
+- spec/lob/resources/intl_verifications_spec.rb
 - spec/lob/resources/letter_spec.rb
 - spec/lob/resources/postcard_spec.rb
 - spec/lob/resources/resource_base_spec.rb
 - spec/lob/resources/route_spec.rb
 - spec/lob/resources/state_spec.rb
+- spec/lob/resources/us_verifications_spec.rb
 - spec/lob_spec.rb
 - spec/samples/8.5x11.pdf
 - spec/samples/postcardback.pdf