lob 5.1.0 → 5.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1eddef68c4e49063f15b7f4634832a240c3a23cf
-  data.tar.gz: 3edfed3dba4fddc7d7750921be0e7b96327712db
+SHA256:
+  metadata.gz: 11eb162180fd2d34bf35f62e3b3e0abdb3319c55d126c0cde0b8653952bc3663
+  data.tar.gz: 7631ad45c98fdd77acaef477d2ce59f63adad41c4f765f9f738a42808f7d2ba6
 SHA512:
-  metadata.gz: c7b161bf7195552d5ebccfa434404b091341374cc7cccc7da5d52c3d4b8fd64c197d5cdcb1768f7a00a05e00e21a7597005ac8df84e6b910ee28fa41538282f9
-  data.tar.gz: 497354d79e8fb4be0ee802ee518461caab60b5562bb3f3b9f16fa6c8c9ead1c613e6d6099f772233a225d9af26a2acde6fcb0680f5cc0f3f83db368dadf653af
+  metadata.gz: 1ce91dceebe1903673e9b782c5af29012f06c7b8aea44d399b49d7efd06cc5975b336db6c369cea13cab0c160511606ecd85fefdff52fe5f9761bd04bd8e5730
+  data.tar.gz: 7cc830a0ac6fba54f81352c050b7baa2f732bb50146ac3dcedf5c9fc53b41dd2d1c4b3eed428639f254e25dfd77abd7aca67ae596986a236ff1d153073ad3d67

data/.travis.yml

@@ -1,15 +1,12 @@
 language: ruby
 
 rvm:
-  - jruby-9.0.5.0
   - jruby-9.1.9.0
-  - 2.1
-  - 2.2
-  - 2.3
+  - jruby-9.2.9.0
   - 2.4
   - 2.5
   - 2.6
-
+  - 2.7
 env:
   JRUBY_OPTS=--2.0
 

data/CHANGELOG.md

@@ -1,3 +1,22 @@
+## [**5.3.0**](https://github.com/lob/lob-ruby/releases/tag/v5.3.0) (2021-08-25)
+- [**190**](https://github.com/lob/lob-ruby/pull/190) Adds support for bulk AV endpoints
+## [**5.2.0**](https://github.com/lob/lob-ruby/releases/tag/v5.2.0) (2021-05-03)
+- [**188**](https://github.com/lob/lob-ruby/pull/188) Adds support for Self Mailers
+## 5.1.2 (2021-02-18)
+
+##### Chores and Bug Fixes
+
+- [**185**](https://github.com/lob/lob-ruby/pull/185) Bumps rake to 12.3.3, adds Ruby 2.7, update example asset links, other cleanup.
+## 5.1.1 (2020-05-21)
+
+##### Chores
+
+* **intl-verification:**  update international verifications test mode fix ([#179](https://github.com/lob/lob-ruby/pull/179)) ([4ab7e7e2](https://github.com/lob/lob-ruby/commit/4ab7e7e2852706c37b00bd8f2df58207897bc0a3))
+
+##### Bug Fixes
+
+* **merge-variables:**  convert to json ([fa93885f](https://github.com/lob/lob-ruby/commit/fa93885f2aab4537e100b82d8a9f53cdec042f2e))
+
 ## [**5.1.0**](https://github.com/lob/lob-ruby/releases/tag/v5.1.0)
 - [**176**](https://github.com/lob/lob-ruby/pull/176) Adds support for Group Members (beta feature)
 - [**175**](https://github.com/lob/lob-ruby/pull/175) Adds support for Groups (beta feature)

data/README.md

@@ -24,10 +24,10 @@ Supports Ruby 2.0.0 and greater.
 
 Here's a general overview of the Lob services available, click through to read more.
 
-- [Postcards API](https://lob.com/services/postcards)
-- [Letters API](https://lob.com/services/letters)
-- [Checks API](https://lob.com/services/checks)
-- [Address Verification API](https://lob.com/services/verifications)
+- [Postcards API](https://lob.com/products/print-mail/postcards)
+- [Letters API](https://lob.com/products/print-mail/letters)
+- [Checks API](https://lob.com/products/print-mail/checks)
+- [Address Verification API](https://lob.com/products/address-verification)
 
 Please read through the official [API Documentation](#api-documentation) to get a complete sense of what to expect from each endpoint.
 
@@ -130,6 +130,7 @@ There are simple scripts to demonstrate how to create all the core Lob objects (
   - [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)
+    - [Bulk Verify US Addresses](https://lob.com/docs/ruby#bulk_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)
   - [US Autocompletion API](https://lob.com/docs/ruby#us_autocompletions)
@@ -139,6 +140,7 @@ There are simple scripts to demonstrate how to create all the core Lob objects (
 - **Int'l Verification API**
   - [International Verifications](https://lob.com/docs/ruby#intl_verifications)
     - [Verify an International Address](https://lob.com/docs/ruby#intl_verifications_create)
+    - [Bulk Verify International Addresses](https://lob.com/docs/ruby#bulk_intl_verifications_create)
 - **Postcards API**
   - [Postcards](https://lob.com/docs/ruby#postcards)
     - [The Postcard Object](https://lob.com/docs/ruby#postcards_object)
@@ -146,6 +148,13 @@ There are simple scripts to demonstrate how to create all the core Lob objects (
     - [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)
+- **Self Mailers API**
+  - [Self Mailers](https://lob.com/docs/ruby#self_mailers)
+    - [The Self Mailer Object](https://lob.com/docs/ruby#self_mailers_object)
+    - [Create a Self Mailer](https://lob.com/docs/ruby#self_mailers_create)
+    - [Retrieve a Self Mailer](https://lob.com/docs/ruby#self_mailers_retrieve)
+    - [Cancel a Self Mailer](https://lob.com/docs/ruby#self_mailers_delete)
+    - [List all Self Mailers](https://lob.com/docs/ruby#self_mailers_list)
 - **Letters API**
   - [Letters](https://lob.com/docs/ruby#letters)
     - [The Letter Object](https://lob.com/docs/ruby#letters_object)

data/examples/README.md

@@ -31,3 +31,7 @@ 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).
+
+## /self_mailers.rb
+
+An example showing how to create a self mailer using Lob's Self Mailers API.

data/examples/self_mailers.rb

@@ -0,0 +1,37 @@
+$:.unshift File.expand_path("../lib", File.dirname(__FILE__))
+require 'lob'
+
+# initialize Lob object
+lob = Lob::Client.new(api_key: 'YOUR_API_KEY_HERE')
+
+# create a to address
+to_address = lob.addresses.create(
+  name: "ToAddress",
+  address_line1: "120 6th Ave",
+  address_city: "Boston",
+  address_state: "MA",
+  address_country: "US",
+  address_zip: 12345
+)
+
+# create a from address
+from_address = lob.addresses.create(
+  name: "FromAddress",
+  address_line1: "120 6th Ave",
+  address_city: "Boston",
+  address_state: "MA",
+  address_country: "US",
+  address_zip: 12345
+)
+
+
+# send a self mailer
+puts lob.self_mailers.create(
+  description: "Beach Postcard",
+  to: to_address["id"],
+  from: from_address["id"],
+  metadata: { campaign: "Summer 2021 Beach" },
+  merge_variables: { name: "Albert" },
+  outside: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_outside.pdf",
+  inside: "<h1>Hi {{name}}, please RSVP as soon as possible to reserve your lounge chair.</h1>"
+)

data/lib/lob/client.rb

@@ -1,11 +1,14 @@
 require "lob/resources/address"
 require "lob/resources/bank_account"
+require "lob/resources/bulk_intl_verifications"
+require "lob/resources/bulk_us_verifications"
 require "lob/resources/check"
 require "lob/resources/group"
 require "lob/resources/groups_member"
 require "lob/resources/intl_verifications"
 require "lob/resources/letter"
 require "lob/resources/postcard"
+require "lob/resources/self_mailer"
 require "lob/resources/us_autocompletions"
 require "lob/resources/us_verifications"
 require "lob/resources/us_zip_lookups"
@@ -31,6 +34,14 @@ module Lob
       Lob::Resources::BankAccount.new(config)
     end
 
+    def bulk_intl_verifications
+      Lob::Resources::BulkIntlVerifications.new(config)
+    end
+
+    def bulk_us_verifications
+      Lob::Resources::BulkUSVerifications.new(config)
+    end
+
     def checks
       Lob::Resources::Check.new(config)
     end
@@ -55,6 +66,10 @@ module Lob
       Lob::Resources::Postcard.new(config)
     end
 
+    def self_mailers
+      Lob::Resources::SelfMailer.new(config)
+    end
+
     def us_autocompletions
       Lob::Resources::USAutocompletions.new(config)
     end

data/lib/lob/resources/bulk_intl_verifications.rb

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

data/lib/lob/resources/bulk_us_verifications.rb

@@ -0,0 +1,27 @@
+require "lob/resources/resource_base"
+
+module Lob
+  module Resources
+    class BulkUSVerifications < Lob::Resources::ResourceBase
+
+      undef_method :list, :find, :create, :destroy
+
+      def initialize(config)
+        super(config)
+        @endpoint = "bulk/us_verifications"
+      end
+
+      def verify(body={}, query={})
+        request = {
+          method: :post,
+          url: endpoint_url,
+          body: body,
+          query: query
+        }
+
+        submit request
+      end
+
+    end
+  end
+end

data/lib/lob/resources/resource_base.rb

@@ -19,7 +19,7 @@ module Lob
           query: query
         }
 
-        submit request
+        submit(request)
       end
 
       def find(resource_id)
@@ -28,7 +28,7 @@ module Lob
           url: resource_url(resource_id)
         }
 
-        submit request
+        submit(request)
       end
 
       def create(body={}, headers={}, query={})
@@ -40,7 +40,7 @@ module Lob
           query: query
         }
 
-        submit request
+        submit(request)
       end
 
       def destroy(resource_id)
@@ -49,7 +49,7 @@ module Lob
           url: resource_url(resource_id)
         }
 
-        submit request
+        submit(request)
       end
 
       private
@@ -71,11 +71,14 @@ module Lob
         if query != {}
           url = "#{url}?#{build_nested_query(query)}"
         end
-
+        
         begin
           if method == :get || method == :delete
             response = RestClient.send(method, url, headers)
           else
+            if body[:merge_variables] and body[:merge_variables].class == Hash
+              body[:merge_variables] = body[:merge_variables].to_json()
+            end
             response = RestClient.send(method, url, body, headers)
           end
 

data/lib/lob/resources/self_mailer.rb

@@ -0,0 +1,14 @@
+require "lob/resources/resource_base"
+
+module Lob
+  module Resources
+    class SelfMailer < Lob::Resources::ResourceBase
+
+      def initialize(config)
+        super(config)
+        @endpoint = "self_mailers"
+      end
+
+    end
+  end
+end

data/lib/lob/version.rb

@@ -1,3 +1,3 @@
 module Lob
-  VERSION = "5.1.0"
+  VERSION = "5.3.0"
 end

data/lob.gemspec

@@ -18,11 +18,11 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "rest-client", ">= 1.8", "< 3.0"
+  spec.add_dependency "rest-client", ">= 2.0.1", "< 3.0"
 
-  spec.add_development_dependency "rake", "~> 10.4.2"
+  spec.add_development_dependency "rake", "~> 12.3.3"
   spec.add_development_dependency "minitest", "~> 5.6.1"
   spec.add_development_dependency "webmock", "~> 1.2"
-  spec.add_development_dependency "coveralls", "~> 0.8.1"
-  spec.add_development_dependency "simplecov", "~> 0.10.0"
+  spec.add_development_dependency "coveralls", "~> 0.8.13"
+  spec.add_development_dependency "simplecov", "~> 0.11.0"
 end

data/spec/lob/resources/bulk_intl_verifications_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+
+describe Lob::Resources::BulkIntlVerifications do
+
+  before :each do
+    @sample_params = {
+      addresses: [
+        {
+          primary_line: "123 Test St",
+          city: "HEARST",
+          state: "ONTARIO",
+          postal_code: "P0L1N0",
+          country: "CA"
+        }
+      ]
+    }
+  end
+
+  subject { Lob::Client.new(api_key: API_KEY) }
+
+  describe "verify" do
+    it "should verify an international address" do
+      result = subject.bulk_intl_verifications.verify @sample_params
+      addresses = result["addresses"]
+      address = addresses.first
+      address["recipient"].must_equal("TEST KEYS DO NOT VERIFY ADDRESSES")
+    end
+  end
+
+end

data/spec/lob/resources/bulk_us_verifications_spec.rb

@@ -0,0 +1,37 @@
+require "spec_helper"
+
+describe Lob::Resources::BulkUSVerifications do
+
+  before :each do
+    @sample_params = {
+      addresses: [
+        {
+          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.bulk_us_verifications.verify @sample_params
+      addresses = result["addresses"]
+      address = addresses.first
+      address["recipient"].must_equal("TEST KEYS DO NOT VERIFY ADDRESSES")
+    end
+
+    it "should allow 'case' in query params" do
+      result = subject.bulk_us_verifications.verify @sample_params, {case: "proper"}
+      addresses = result["addresses"]
+      address = addresses.first
+      address["recipient"].must_equal("Test Keys Do Not Verify Addresses")
+    end
+  end
+
+end

data/spec/lob/resources/check_spec.rb

@@ -50,6 +50,27 @@ describe Lob::Resources::Check do
 
       result["amount"].to_s.must_equal("2000.12")
     end
+
+    it "should create a check with a merge variable conditional" do
+      new_address = subject.addresses.create @sample_address_params
+
+      new_bank_account = subject.bank_accounts.create(@sample_bank_account_params)
+
+      subject.bank_accounts.verify(new_bank_account["id"], amounts: [1, 2])
+
+      result = subject.checks.create(
+        bank_account: new_bank_account["id"],
+        to: new_address["id"],
+        from: new_address["id"],
+        amount: "2000.12",
+        attachment: "<html>{{#is_awesome}}You are awesome!{{/is_awesome}}</html>",
+        merge_variables: {
+          is_awesome: false
+        }
+      )
+
+      result["merge_variables"]["is_awesome"].must_equal(false)
+    end
   end
 
 

data/spec/lob/resources/intl_verifications_spec.rb

@@ -15,13 +15,10 @@ describe Lob::Resources::IntlVerifications do
   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
+    it "should verify an international address" do
+      result = subject.intl_verifications.verify @sample_params
+
+      result["recipient"].must_equal("TEST KEYS DO NOT VERIFY ADDRESSES")
     end
   end
 

data/spec/lob/resources/letter_spec.rb

@@ -52,6 +52,26 @@ describe Lob::Resources::Letter do
 
       new_letter["description"].must_equal("TestLetter")
     end
+
+    it "should create a letter with a merge variable object" do
+      new_address = subject.addresses.create @sample_address_params
+
+      new_letter = subject.letters.create(
+        description: "TestLetter",
+        color: true,
+        file: "<html>{{data.name}}</html>",
+        to: new_address["id"],
+        from: @sample_address_params,
+        merge_variables: {
+          data: {
+            name: "Kobe"
+          }
+        }
+      )
+
+      new_letter["description"].must_equal("TestLetter")
+      new_letter["merge_variables"]["data"]["name"].must_equal("Kobe")
+    end
   end
 
 
@@ -68,7 +88,7 @@ describe Lob::Resources::Letter do
       )
 
       result = subject.letters.find(new_letter["id"])
-      assert /#{new_letter["description"]}/ =~ result.to_s
+      assert %r{#{new_letter["description"]}} =~ result.to_s
     end
   end
 

data/spec/lob/resources/postcard_spec.rb

@@ -37,7 +37,7 @@ describe Lob::Resources::Postcard do
         description: @sample_postcard_params[:description],
         to: new_address["id"],
         back: @sample_postcard_params[:back],
-        front: "https://lob.com/postcardfront.pdf"
+        front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf"
       )
 
       result["description"].must_equal(@sample_postcard_params[:description])
@@ -48,7 +48,7 @@ describe Lob::Resources::Postcard do
         description: @sample_postcard_params[:description],
         to: @sample_address_params,
         back: @sample_postcard_params[:back],
-        front: "https://lob.com/postcardfront.pdf"
+        front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf"
       )
 
       result["description"].must_equal(@sample_postcard_params[:description])
@@ -62,7 +62,7 @@ describe Lob::Resources::Postcard do
         to: new_address["id"],
         from: @sample_address_params,
         back: @sample_postcard_params[:back],
-        front: "https://lob.com/postcardfront.pdf"
+        front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf"
       )
 
       result["description"].must_equal(@sample_postcard_params[:description])
@@ -74,8 +74,8 @@ describe Lob::Resources::Postcard do
       result = subject.postcards.create(
         description: @sample_postcard_params[:description],
         to: new_address["id"],
-        front: "https://lob.com/postcardfront.pdf",
-        back:  "https://lob.com/postcardback.pdf"
+        front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf",
+        back:  "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_back.pdf"
       )
 
       result["description"].must_equal(@sample_postcard_params[:description])
@@ -95,6 +95,31 @@ describe Lob::Resources::Postcard do
       result["description"].must_equal(@sample_postcard_params[:description])
     end
 
+    it "should create a postcard with a merge variable list" do
+      new_address = subject.addresses.create @sample_address_params
+      merge_variables = {
+        list: [
+          {
+            name: "Larissa"
+          },
+          {
+            name: "Larry"
+          }
+        ]
+      }
+
+      result = subject.postcards.create(
+        description: @sample_postcard_params[:description],
+        to: new_address["id"],
+        back: "<html>{{#list}} {{name}} {{/list}}</html>",
+        front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf",
+        merge_variables: merge_variables
+      )
+
+      result["description"].must_equal(@sample_postcard_params[:description])
+      result["merge_variables"]["list"][0]["name"].must_equal("Larissa")
+      result["merge_variables"]["list"][1]["name"].must_equal("Larry")
+    end
   end
 
 

data/spec/lob/resources/resource_base_spec.rb

@@ -55,7 +55,7 @@ describe Lob::Resources::ResourceBase do
       description: sample_postcard_params[:description],
       to: new_address["id"],
       back: sample_postcard_params[:back],
-      front: "https://lob.com/postcardfront.pdf"
+      front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf"
     }, {
       "Idempotency-Key" => idempotency_key
     })
@@ -64,7 +64,7 @@ describe Lob::Resources::ResourceBase do
       description: sample_postcard_params[:description],
       to: new_address["id"],
       back: sample_postcard_params[:back],
-      front: "https://lob.com/postcardfront.pdf"
+      front: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/pc_4x6_front.pdf"
     }, {
       "Idempotency-Key" => idempotency_key
     })

data/spec/lob/resources/self_mailer_spec.rb

@@ -0,0 +1,177 @@
+require "spec_helper"
+
+describe Lob::Resources::SelfMailer do
+
+  before :each do
+    @sample_address_params = {
+      name: "TestAddress",
+      email: "test@test.com",
+      address_line1: "123 Test Street",
+      address_line2: "Unit 199",
+      address_city: "Mountain View",
+      address_state: "CA",
+      address_country: "US",
+      address_zip: 94085
+    }
+
+    @sample_self_mailer_params = {
+      description: "Test Self Mailer",
+      outside: "<h1>Sample Self Mailer Outside</h1>",
+      inside: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_inside.pdf",
+    }
+  end
+
+  subject { Lob::Client.new(api_key: API_KEY) }
+
+  describe "list" do
+    it "should list self mailers" do
+      self_mailers = subject.self_mailers.list()
+      assert self_mailers["object"] == "list"
+    end
+  end
+
+
+  describe "create" do
+    it "should create a self mailer with address_id" do
+      new_address = subject.addresses.create @sample_address_params
+
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        outside: @sample_self_mailer_params[:outside],
+        inside: @sample_self_mailer_params[:inside],
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+
+    it "should create a self mailer with to address params" do
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: @sample_address_params,
+        outside: @sample_self_mailer_params[:outside],
+        inside: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_inside.pdf"
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+
+    it "should create a self mailer with from address params" do
+      new_address = subject.addresses.create @sample_address_params
+
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        from: @sample_address_params,
+        outside: @sample_self_mailer_params[:outside],
+        inside: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_inside.pdf"
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+
+    it "should create a self mailer with front and back as urls" do
+      new_address = subject.addresses.create @sample_address_params
+
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        outside: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_outside.pdf",
+        inside:  "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_inside.pdf"
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+
+
+    it "should create a self mailer with front and back as PDFs" do
+      new_address = subject.addresses.create @sample_address_params
+
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        outside: File.new(File.expand_path("../../../samples/sfm-6x18-outside.pdf", __FILE__)),
+        inside: File.new(File.expand_path("../../../samples/sfm-6x18-inside.pdf", __FILE__))
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+
+    it "should create a self mailer with front and back as 12x9 PDFs" do
+      new_address = subject.addresses.create @sample_address_params
+
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        size: "12x9_bifold",
+        outside: File.new(File.expand_path("../../../samples/sfm-12x9-outside.pdf", __FILE__)),
+        inside: File.new(File.expand_path("../../../samples/sfm-12x9-inside.pdf", __FILE__))
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+
+
+    it "should create a self mailer with a merge variable list" do
+      new_address = subject.addresses.create @sample_address_params
+      merge_variables = {
+        list: [
+          {
+            name: "Larissa"
+          },
+          {
+            name: "Larry"
+          }
+        ]
+      }
+
+      result = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        outside: "https://s3-us-west-2.amazonaws.com/public.lob.com/assets/templates/self_mailers/6x18_sfm_inside.pdf",
+        inside: "<html>{{#list}} {{name}} {{/list}}</html>",
+        merge_variables: merge_variables
+      )
+
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+      result["merge_variables"]["list"][0]["name"].must_equal("Larissa")
+      result["merge_variables"]["list"][1]["name"].must_equal("Larry")
+    end
+  end
+
+
+  describe "find" do
+    it "should find a self mailer" do
+      new_address = subject.addresses.create @sample_address_params
+
+      new_self_mailer = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        outside: @sample_self_mailer_params[:outside],
+        inside: @sample_self_mailer_params[:inside]
+      )
+
+      result  = subject.self_mailers.find(new_self_mailer["id"])
+      result["description"].must_equal(@sample_self_mailer_params[:description])
+    end
+  end
+
+
+  describe "destroy" do
+    it "should destroy a self mailer" do
+      new_address = subject.addresses.create @sample_address_params
+
+      new_self_mailer = subject.self_mailers.create(
+        description: @sample_self_mailer_params[:description],
+        to: new_address["id"],
+        outside: @sample_self_mailer_params[:outside],
+        inside: @sample_self_mailer_params[:inside]
+      )
+
+      result = subject.self_mailers.destroy(new_self_mailer["id"])
+      result["id"].must_equal(new_self_mailer["id"])
+      result["deleted"].must_equal(true)
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -3,10 +3,10 @@ $:.unshift File.expand_path("../lib", File.dirname(__FILE__))
 require "simplecov"
 require "coveralls"
 
-SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new([
   SimpleCov::Formatter::HTMLFormatter,
   Coveralls::SimpleCov::Formatter
-]
+])
 SimpleCov.start
 
 require "lob"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lob
 version: !ruby/object:Gem::Version
-  version: 5.1.0
+  version: 5.3.0
 platform: ruby
 authors:
 - Lob
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-30 00:00:00.000000000 Z
+date: 2021-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: 2.0.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: 2.0.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
@@ -36,14 +36,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 10.4.2
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 10.4.2
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -78,28 +78,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: 0.8.13
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: 0.8.13
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 0.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 0.11.0
 description: Lob API Ruby wrapper
 email:
 - support@lob.com
@@ -130,12 +130,15 @@ files:
 - examples/csv_verify/verify.rb
 - examples/letters.rb
 - examples/postcards.rb
+- examples/self_mailers.rb
 - lib/lob.rb
 - lib/lob/client.rb
 - lib/lob/errors/invalid_request_error.rb
 - lib/lob/errors/lob_error.rb
 - lib/lob/resources/address.rb
 - lib/lob/resources/bank_account.rb
+- lib/lob/resources/bulk_intl_verifications.rb
+- lib/lob/resources/bulk_us_verifications.rb
 - lib/lob/resources/check.rb
 - lib/lob/resources/group.rb
 - lib/lob/resources/groups_member.rb
@@ -143,6 +146,7 @@ files:
 - lib/lob/resources/letter.rb
 - lib/lob/resources/postcard.rb
 - lib/lob/resources/resource_base.rb
+- lib/lob/resources/self_mailer.rb
 - lib/lob/resources/us_autocompletions.rb
 - lib/lob/resources/us_verifications.rb
 - lib/lob/resources/us_zip_lookups.rb
@@ -151,6 +155,8 @@ files:
 - spec/lob/errors/lob_error_spec.rb
 - spec/lob/resources/address_spec.rb
 - spec/lob/resources/bank_account_spec.rb
+- spec/lob/resources/bulk_intl_verifications_spec.rb
+- spec/lob/resources/bulk_us_verifications_spec.rb
 - spec/lob/resources/check_spec.rb
 - spec/lob/resources/group_spec.rb
 - spec/lob/resources/intl_verifications_spec.rb
@@ -158,6 +164,7 @@ files:
 - spec/lob/resources/member_spec.rb
 - spec/lob/resources/postcard_spec.rb
 - spec/lob/resources/resource_base_spec.rb
+- spec/lob/resources/self_mailer_spec.rb
 - spec/lob/resources/us_autocompletions_spec.rb
 - spec/lob/resources/us_verifications_spec.rb
 - spec/lob/resources/us_zip_lookups_spec.rb
@@ -165,6 +172,10 @@ files:
 - spec/samples/8.5x11.pdf
 - spec/samples/postcardback.pdf
 - spec/samples/postcardfront.pdf
+- spec/samples/sfm-12x9-inside.pdf
+- spec/samples/sfm-12x9-outside.pdf
+- spec/samples/sfm-6x18-inside.pdf
+- spec/samples/sfm-6x18-outside.pdf
 - spec/spec_helper.rb
 homepage: https://github.com/lob/lob-ruby
 licenses:
@@ -185,8 +196,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.3
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper for Lob.com API with ActiveRecord-style syntax
@@ -194,6 +204,8 @@ test_files:
 - spec/lob/errors/lob_error_spec.rb
 - spec/lob/resources/address_spec.rb
 - spec/lob/resources/bank_account_spec.rb
+- spec/lob/resources/bulk_intl_verifications_spec.rb
+- spec/lob/resources/bulk_us_verifications_spec.rb
 - spec/lob/resources/check_spec.rb
 - spec/lob/resources/group_spec.rb
 - spec/lob/resources/intl_verifications_spec.rb
@@ -201,6 +213,7 @@ test_files:
 - spec/lob/resources/member_spec.rb
 - spec/lob/resources/postcard_spec.rb
 - spec/lob/resources/resource_base_spec.rb
+- spec/lob/resources/self_mailer_spec.rb
 - spec/lob/resources/us_autocompletions_spec.rb
 - spec/lob/resources/us_verifications_spec.rb
 - spec/lob/resources/us_zip_lookups_spec.rb
@@ -208,4 +221,8 @@ test_files:
 - spec/samples/8.5x11.pdf
 - spec/samples/postcardback.pdf
 - spec/samples/postcardfront.pdf
+- spec/samples/sfm-12x9-inside.pdf
+- spec/samples/sfm-12x9-outside.pdf
+- spec/samples/sfm-6x18-inside.pdf
+- spec/samples/sfm-6x18-outside.pdf
 - spec/spec_helper.rb