lob 4.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 98855f792febf3dad2f0d885fb55f1995faea52f
-  data.tar.gz: a630435538c358b6c2bb72caae28490e588ea94d
+  metadata.gz: d8c8884204048312baba9bd6fff2f8ef66511ba0
+  data.tar.gz: 43cf728195ba982d634961759390d85d89245c8f
 SHA512:
-  metadata.gz: bc028726b431293f20f313ed6852e8e08de864dff3e7bfe016422801991d8d171e8d05d173628d6c2e880c93729e35f17cd0e5eb41b707dd361b7ca50a25e410
-  data.tar.gz: 7b95754a03c640da8c37967286820883105c58f90d5d1ffbfd1342a2f1cd92e8a4e5523914d60e04899dbe700d62ac32df6e0cf2a3168b4fcdbda07450dd903c
+  metadata.gz: 30bef61ae90c6d136b990d81c5338eec3138618226dae65c8d96a83f50b1c6334ae10817491903195f9d83d13533677afe18e22b33ff3da351712901b15e9afc
+  data.tar.gz: 8e8effd0fac3ffa615668303462a282e479dd43d3f1d40181da5ad824eab9fea94548e77f981637d07e4b1cf95e88c5ae23ce4c27f789a3508d8952a934a56a3

data/.travis.yml

@@ -4,11 +4,10 @@ sudo: false
 
 rvm:
   - jruby
-  - 2.0.0
   - 2.1
   - 2.2
-  - 2.3.0
-  - 2.3.1
+  - 2.3
+  - 2.4
 
 env:
   JRUBY_OPTS=--2.0

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## [**4.1.0**](https://github.com/lob/lob-ruby/releases/tag/v4.1.0)
+- [**#158**] (https://github.com/lob/lob-ruby/pull/158) add US Zip Lookups API endpoint to wrapper
+
 ## 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.

data/README.md

@@ -31,6 +31,8 @@ Here's a general overview of the Lob services available, click through to read m
 - [Area Mail API](https://lob.com/services/area)
 - [Address Verification API](https://lob.com/services/verifications)
 
+Please read through the official [API Documentation](#api-documentation) to get a complete sense of what to expect from each endpoint.
+
 ### Registration
 
 First, you will need to first create an account at [Lob.com](https://dashboard.lob.com/#/register) and obtain your Test and Live API Keys.
@@ -105,9 +107,7 @@ end
 
 We've provided various examples for you to try out [here](https://github.com/lob/lob-ruby/tree/master/examples).
 
-There are simple scripts to demonstrate how to create all the core Lob products (checks, letters, postcards, jobs etc.), as well as more complex examples that utilize other libraries and external files:
-
-- [Creating Dynamic Postcards with HTML and Data](https://github.com/lob/lob-ruby/tree/master/examples/csv_postcards)
+There are simple scripts to demonstrate how to create all the core Lob objects (checks, letters, postcards. etc.) as well as more complex examples that utilize other libraries and external files.
 
 ## API Documentation
 
@@ -116,69 +116,77 @@ There are simple scripts to demonstrate how to create all the core Lob products
 - [Errors](https://lob.com/docs/ruby#errors)
 - [Rate Limiting](https://lob.com/docs/ruby#rate-limits)
 - [Webhooks](https://lob.com/docs/ruby#webhooks)
+- [Cancellation Windows](https://lob.com/docs/ruby#cancellation)
+- [Scheduled Mailings](https://lob.com/docs/ruby#scheduled)
 - [Metadata](https://lob.com/docs/ruby#metadata)
+- [HTML Templates](https://lob.com/docs/ruby#templates)
 - [Asset URLs](https://lob.com/docs/ruby#urls)
 - **Addresses**
-  - [Address Book](https://lob.com/docs/ruby#addresses)
-    - [The Address Object](https://lob.com/docs/ruby#addresses_object)
-    - [Create an Address](https://lob.com/docs/ruby#addresses_create)
-    - [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 Book](https://lob.com/docs/ruby#addresses)
+  - [The Address Object](https://lob.com/docs/ruby#addresses_object)
+  - [Create an Address](https://lob.com/docs/ruby#addresses_create)
+  - [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)
 - **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)
+- [US Verification API](https://lob.com/docs/ruby#us_verifications)
+  - [The US Verification Object](https://lob.com/docs/ruby#us_verifications_object)
+  - [Verify a US Address](https://lob.com/docs/ruby#us_verifications_create)
+  - [The US Zip Lookup Object](https://lob.com/docs/ruby#us_zip_lookups_object)
+  - [Lookup a US Zip Code](https://lob.com/docs/ruby#us_zip_lookups_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)
+- [International Verifications](https://lob.com/docs/ruby#intl_verifications)
+  - [Verify an International 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)
-    - [Create a Postcard](https://lob.com/docs/ruby#postcards_create)
-    - [Retrieve a Postcard](https://lob.com/docs/ruby#postcards_retrieve)
-    - [List all Postcards](https://lob.com/docs/ruby#postcards_list)
+- [Postcards](https://lob.com/docs/ruby#postcards)
+  - [The Postcard Object](https://lob.com/docs/ruby#postcards_object)
+  - [Create a Postcard](https://lob.com/docs/ruby#postcards_create)
+  - [Retrieve a Postcard](https://lob.com/docs/ruby#postcards_retrieve)
+  - [Cancel a Postcard](https://lob.com/docs/ruby#postcards_delete)
+  - [List all Postcards](https://lob.com/docs/ruby#postcards_list)
 - **Letters API**
-  - [Letters](https://lob.com/docs/ruby#letters)
-    - [The Letter Object](https://lob.com/docs/ruby#letters_object)
-    - [Create a Letter](https://lob.com/docs/ruby#letters_create)
-    - [Retrieve a Letter](https://lob.com/docs/ruby#letters_retrieve)
-    - [List all Letters](https://lob.com/docs/ruby#letters_list)
+- [Letters](https://lob.com/docs/ruby#letters)
+  - [The Letter Object](https://lob.com/docs/ruby#letters_object)
+  - [Create a Letter](https://lob.com/docs/ruby#letters_create)
+  - [Retrieve a Letter](https://lob.com/docs/ruby#letters_retrieve)
+  - [Cancel a Letter](https://lob.com/docs/ruby#letters_delete)
+  - [List all Letters](https://lob.com/docs/ruby#letters_list)
 - **Checks API**
-  - [Checks](https://lob.com/docs/ruby#checks)
-    - [The Check Object](https://lob.com/docs/ruby#checks_object)
-    - [Create a Check](https://lob.com/docs/ruby#checks_create)
-    - [Retrieve a Check](https://lob.com/docs/ruby#checks_retrieve)
-    - [List all Checks](https://lob.com/docs/ruby#checks_list)
-  - [Bank Accounts](https://lob.com/docs/ruby#bank-accounts)
-    - [The Bank Account Object](https://lob.com/docs/ruby#bankaccounts_object)
-    - [Create a Bank Account](https://lob.com/docs/ruby#bankaccounts_create)
-    - [Retrieve a Bank Account](https://lob.com/docs/ruby#bankaccounts_retrieve)
-    - [Delete a Bank Account](https://lob.com/docs/ruby#bankaccounts_delete)
-    - [Verify a Bank Account](https://lob.com/docs/ruby#bankaccounts_verify)
-    - [List all Bank Accounts](https://lob.com/docs/ruby#bankaccounts_list)
+- [Checks](https://lob.com/docs/ruby#checks)
+  - [The Check Object](https://lob.com/docs/ruby#checks_object)
+  - [Create a Check](https://lob.com/docs/ruby#checks_create)
+  - [Retrieve a Check](https://lob.com/docs/ruby#checks_retrieve)
+  - [Cancel a Check](https://lob.com/docs/ruby#checks_delete)
+  - [List all Checks](https://lob.com/docs/ruby#checks_list)
+- [Bank Accounts](https://lob.com/docs/ruby#bank-accounts)
+  - [The Bank Account Object](https://lob.com/docs/ruby#bankaccounts_object)
+  - [Create a Bank Account](https://lob.com/docs/ruby#bankaccounts_create)
+  - [Retrieve a Bank Account](https://lob.com/docs/ruby#bankaccounts_retrieve)
+  - [Delete a Bank Account](https://lob.com/docs/ruby#bankaccounts_delete)
+  - [Verify a Bank Account](https://lob.com/docs/ruby#bankaccounts_verify)
+  - [List all Bank Accounts](https://lob.com/docs/ruby#bankaccounts_list)
 - **Area Mail API**
-  - [Areas](https://lob.com/docs/ruby#areas)
-    - [The Area Object](https://lob.com/docs/ruby#areas_object)
-    - [Create an Area Mailing](https://lob.com/docs/ruby#areas_create)
-    - [Retrieve an Area Mailing](https://lob.com/docs/ruby#areas_retrieve)
-    - [List all Area Mailings](https://lob.com/docs/ruby#areas_list)
-  - [Routes](https://lob.com/docs/ruby#routes)
-    - [The Routes Object](https://lob.com/docs/ruby#routes_object)
-    - [Retrieve Routes](https://lob.com/docs/ruby#routes_retrieve)
-    - [List all Routes](https://lob.com/docs/ruby#routes_list)
+- [Areas](https://lob.com/docs/ruby#areas)
+  - [The Area Object](https://lob.com/docs/ruby#areas_object)
+  - [Create an Area Mailing](https://lob.com/docs/ruby#areas_create)
+  - [Retrieve an Area Mailing](https://lob.com/docs/ruby#areas_retrieve)
+  - [List all Area Mailings](https://lob.com/docs/ruby#areas_list)
+- [Routes](https://lob.com/docs/ruby#routes)
+  - [The Routes Object](https://lob.com/docs/ruby#routes_object)
+  - [Retrieve Routes](https://lob.com/docs/ruby#routes_retrieve)
+  - [List all Routes](https://lob.com/docs/ruby#routes_list)
 - **Resources**
-  - [Countries](https://lob.com/docs/ruby#countries)
-    - [List all Countries](https://lob.com/docs/ruby#countries_list)
-  - [States](https://lob.com/docs/ruby#states)
-    - [List all States](https://lob.com/docs/ruby#states_list)
+- [Countries](https://lob.com/docs/ruby#countries)
+  - [List all Countries](https://lob.com/docs/ruby#countries_list)
+- [States](https://lob.com/docs/ruby#states)
+  - [List all States](https://lob.com/docs/ruby#states_list)
 - **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)
+- [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
 
@@ -199,4 +207,3 @@ You can also configure, TravisCI for your fork of the repository and it'll run t
 Copyright © 2016 Lob.com
 
 Released under the MIT License, which can be found in the repository in `LICENSE.txt`.
-

data/examples/README.md

@@ -1,26 +1,28 @@
 # Ruby Examples
 
-This directory contains a collection of ruby example to help get you started using the Lob API. As always, feel free to [contact us](https://lob.com/support) directly if you have any questions.
+Here we have put together a hand full of ruby examples to help get you started. Please read through the official [API Documentation](../README.md#api-documentation) to get a complete sense of what to expect from each endpoint. As always, feel free to [contact us](https://lob.com/support) directly if you have any questions on implementation.
 
 ## /csv_checks/
 
-An example showing how to dynamically create checks from a CSV using HTML, variable data, and Lob's [Checks API](https://lob.com/services/checks).
+An example showing how to dynamically create checks from a CSV using HTML, merge variables, and Lob's [Checks API](https://lob.com/services/checks).
 
 ## /csv_letters/
 
-An example showing how to dynamically create letters from a CSV using HTML, a custom font, variable data, and Lob's [Letters API](https://lob.com/services/letters).
+An example showing how to dynamically create letters from a CSV using HTML, a custom font, merge variables, and Lob's [Letters API](https://lob.com/services/letters).
 
 ## /csv_postcards/
 
-An example showing how to dynamically create postcards from a CSV using HTML, a custom font, variable data, and Lob's [Postcards API](https://lob.com/services/postcards).
+An example showing how to dynamically create postcards from a CSV using HTML, a custom font, merge variables, and Lob's [Postcards API](https://lob.com/services/postcards).
 
-## /checks.rb
+## /csv_verify/
 
-An example showing how to create a check using Lob's [Checks API](https://lob.com/services/checks).
+An example showing how to validate and cleanse a CSV spreadsheet full of shipping addresses using Lob's [US Verification API](https://lob.com/services/verifications).
+  		  
+Please note that if you are running this with a Test API Key, the verification API will always return [a dummy address](https://lob.com/docs#us_verifications_create).
 
-## /jobs.rb
+## /checks.rb
 
-An example showing how to create objects and jobs using Lob's [Jobs API](https://lob.com/services/sps).
+An example showing how to create a check using Lob's [Checks API](https://lob.com/services/checks).
 
 ## /letters.rb
 
@@ -29,7 +31,3 @@ An example showing how to create a letter using Lob's [Letters API](https://lob.
 ## /postcards.rb
 
 An example showing how to create a postcard using Lob's [Postcards API](https://lob.com/services/postcards).
-
-## /verify/
-
-An example showing how to verify an address using the [StreetAddress gem](https://github.com/derrek/street-address) and Lob's verify endpoint. This example saves verified addresses in a CSV file.

data/examples/csv_letters/create_letters.rb

@@ -30,7 +30,7 @@ CSV.foreach(File.expand_path('../input.csv', __FILE__)) do |row|
       address_country: 'US'
     },
     file: letter_html,
-    data: {
+    merge_variables: {
       name: row[0],
       city: row[3]
     },

data/examples/csv_postcards/create_postcards.rb

@@ -33,7 +33,7 @@ CSV.foreach(File.expand_path('../input.csv', __FILE__)) do |row|
     size: "6x11",
     front: front_html,
     back: back_html,
-    data: {
+    merge_variables: {
       background_image: row[1],
       background_color: row[2],
       name: row[0],

data/examples/csv_verify/input.csv

@@ -0,0 +1,7 @@
+185 Berry St,Unit 1510,,San Francisco,CA,
+185 Berry St,Ste 1510,,SF,CA,
+185 Berry St,,,SF,CA,
+185 NW Berry St,,,SF,CA,
+1600 Pennsylvania Ave,,,Washington,DC,20500
+5904 Richmond Hwy Ste 340,,,Alexandria,VA,22303-1864
+5905 Richmond Hwy Ste 340,,,Alexandria,VA,

data/examples/csv_verify/verify.rb

@@ -0,0 +1,36 @@
+$:.unshift File.expand_path("../../lib", File.dirname(__FILE__))
+
+require 'csv'
+require 'lob'
+
+# Initialize Lob object
+lob = Lob::Client.new(api_key: 'test_799ff27291c166d10ba191902ad02fb059c')
+
+output = File.open(File.expand_path('../output.csv', __FILE__), 'w')
+
+output.puts ['primary_line', 'secondary_line', 'urbanization', 'last_line', 'deliverability'].join(',')
+
+# Parse the input file and verify the addresses
+File.open(File.expand_path('../input.csv', __FILE__)).each_line do |line|
+  address_components = line.split(',')
+
+  verified_address = lob.us_verifications.verify(
+    primary_line: address_components[0],
+    secondary_line: address_components[1],
+    urbanization: address_components[2],
+    city: address_components[3],
+    state: address_components[4],
+    zip_code: address_components[5]
+  )
+
+  output.puts [
+    verified_address['primary_line'],
+    verified_address['secondary_line'],
+    verified_address['urbanization'],
+    verified_address['last_line'],
+    verified_address['deliverability']
+  ].join(',')
+
+end
+
+output.close

data/examples/letters.rb

@@ -66,7 +66,7 @@ puts lob.letters.create(
   to: to_address["id"],
   from: from_address["id"],
   file: html,
-  data: { name: 'Albert', event: 'HTML Letter Conference'},
+  merge_variables: { name: 'Albert', event: 'HTML Letter Conference'},
   metadata: { campaign: 'HTML 1.0' },
   color: false
 )

data/examples/postcards.rb

@@ -80,7 +80,7 @@ puts lob.postcards.create(
   to: to_address["id"],
   from: from_address["id"],
   metadata: { campaign: "Summer 2015 Beach" },
-  data: { name: "Albert", event: "Summer 2015 Beach-athon" },
+  merge_variables: { name: "Albert", event: "Summer 2015 Beach-athon" },
   front: html,
   message: "Please RSVP as soon as possible to reserve your lounge chair."
 )

data/lib/lob/client.rb

@@ -9,6 +9,7 @@ require "lob/resources/postcard"
 require "lob/resources/route"
 require "lob/resources/state"
 require "lob/resources/us_verifications"
+require "lob/resources/us_zip_lookups"
 
 module Lob
   class Client
@@ -67,5 +68,9 @@ module Lob
       Lob::Resources::USVerifications.new(config)
     end
 
+    def us_zip_lookups
+      Lob::Resources::USZipLookups.new(config)
+    end
+
   end
 end

data/lib/lob/resources/us_zip_lookups.rb

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

data/lib/lob/version.rb

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

data/spec/lob/resources/us_zip_lookups_spec.rb

@@ -0,0 +1,23 @@
+require "spec_helper"
+
+describe Lob::Resources::USZipLookups do
+
+  before :each do
+    @sample_params = {
+      zip_code: "94107"
+    }
+  end
+
+  subject { Lob::Client.new(api_key: API_KEY) }
+
+  describe "lookup" do
+    it "should lookup a US zip code" do
+      result = subject.us_zip_lookups.lookup @sample_params
+
+      result["zip_code"].must_equal(@sample_params[:zip_code])
+      result["zip_code_type"].must_equal("standard")
+      result["cities"].length.must_equal(1)
+    end
+  end
+
+end

metadata

@@ -1,145 +1,145 @@
 --- !ruby/object:Gem::Specification
 name: lob
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.1.0
 platform: ruby
 authors:
 - Lob
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-17 00:00:00.000000000 Z
+date: 2017-08-04 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'
-  name: rest-client
-  prerelease: false
   type: :runtime
+  prerelease: false
   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'
-  name: bundler
-  prerelease: false
   type: :development
+  prerelease: false
   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
-  name: rake
-  prerelease: false
   type: :development
+  prerelease: false
   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
-  name: minitest
-  prerelease: false
   type: :development
+  prerelease: false
   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'
-  name: webmock
-  prerelease: false
   type: :development
+  prerelease: false
   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
-  name: travis-lint
-  prerelease: false
   type: :development
+  prerelease: false
   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
-  name: coveralls
-  prerelease: false
   type: :development
+  prerelease: false
   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
-  name: simplecov
-  prerelease: false
   type: :development
+  prerelease: false
   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
-  name: pry
-  prerelease: false
   type: :development
+  prerelease: false
   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
@@ -168,10 +168,10 @@ files:
 - examples/csv_postcards/input.csv
 - examples/csv_postcards/postcard_back.html
 - examples/csv_postcards/postcard_front.html
+- examples/csv_verify/input.csv
+- examples/csv_verify/verify.rb
 - examples/letters.rb
 - examples/postcards.rb
-- examples/verify/input.txt
-- examples/verify/verify.rb
 - lib/lob.rb
 - lib/lob/client.rb
 - lib/lob/errors/invalid_request_error.rb
@@ -188,6 +188,7 @@ files:
 - lib/lob/resources/route.rb
 - lib/lob/resources/state.rb
 - lib/lob/resources/us_verifications.rb
+- lib/lob/resources/us_zip_lookups.rb
 - lib/lob/version.rb
 - lob.gemspec
 - spec/lob/errors/lob_error_spec.rb
@@ -203,6 +204,7 @@ files:
 - spec/lob/resources/route_spec.rb
 - spec/lob/resources/state_spec.rb
 - spec/lob/resources/us_verifications_spec.rb
+- spec/lob/resources/us_zip_lookups_spec.rb
 - spec/lob_spec.rb
 - spec/samples/8.5x11.pdf
 - spec/samples/postcardback.pdf
@@ -212,24 +214,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.4.5
-signing_key:
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
 specification_version: 4
 summary: Ruby wrapper for Lob.com API with ActiveRecord-style syntax
 test_files:
@@ -246,6 +248,7 @@ test_files:
 - spec/lob/resources/route_spec.rb
 - spec/lob/resources/state_spec.rb
 - spec/lob/resources/us_verifications_spec.rb
+- spec/lob/resources/us_zip_lookups_spec.rb
 - spec/lob_spec.rb
 - spec/samples/8.5x11.pdf
 - spec/samples/postcardback.pdf

data/examples/verify/input.txt

@@ -1,7 +0,0 @@
-185 Berry St Unit 1510 San Francisco CA
-185 Berry St Ste 1510 SF CA
-185 Berry St SF CA
-185 NW Berry St, SF CA
-1600 Pennsylvania Ave, Washington, DC, 20500
-5904 Richmond Hwy Ste 340 Alexandria VA 22303-1864
-5905 Richmond Hwy Ste 340 Alexandria VA

data/examples/verify/verify.rb

@@ -1,37 +0,0 @@
-$:.unshift File.expand_path("../../lib", File.dirname(__FILE__))
-
-require 'csv'
-require 'lob'
-
-# Be sure to install the StreetAddress gem.
-require 'street_address'
-
-# Initialize Lob object
-lob = Lob::Client.new(api_key: 'test_799ff27291c166d10ba191902ad02fb059c')
-
-output = File.open(File.expand_path('../output.csv', __FILE__), 'w')
-
-output.puts ['address_line1', 'address_city', 'address_state', 'address_zip', 'address_country'].join(',')
-
-# Parse the input file and verify the addresses
-File.open(File.expand_path('../input.txt', __FILE__)).each_line do |line|
-  parsed_address = StreetAddress::US.parse(line)
-
-  verified_address = lob.addresses.verify(
-    address_line1: parsed_address.to_s(:line1),
-    address_city: parsed_address.city,
-    address_state: parsed_address.state,
-    address_country: 'US'
-  )['address']
-
-  output.puts [
-    verified_address['address_line1'],
-    verified_address['address_city'],
-    verified_address['address_state'],
-    verified_address['address_zip'],
-    verified_address['address_country']
-  ].join(',')
-
-end
-
-output.close