easypost 4.2.1 → 4.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9106fd21b72e0361b541741ba63630f8a2edb3d51cc2c911af06a2bd55c413df
-  data.tar.gz: 9333539ff70f45618cb81b83dc427469048f7f2585deeb2ea044983dfa7b2955
+  metadata.gz: 10f43ed8bb80d557e81cb7904f2972d5869db45393e18d6d29374d8be9cb84da
+  data.tar.gz: 1956b7baf66e1906c3e0de4252c0563d914ec115d0eafb60a7b17e11493e9d89
 SHA512:
-  metadata.gz: d59cd4adcf74d2018d6a76bedfc583d9b0cc79c88a28742c0cffb12fa5756552c99cc30e1c720e29f9b26ca4063b93873a5faf82d8adbdca1c9731005e75ff88
-  data.tar.gz: ebce5da4126834f9b76c67b6912717047b8396eed2a51be10e0057860b4268487f3ff91eb7857b88976e0402bc352220af984cebd280774470de22cdca418f4c
+  metadata.gz: 735164cd9f181b41aeca6e9f411ad190b6dfcd11772d8be7fa89f8764330dbb7e7578558c3a03b21253a5e98bc0bb4ce0f99ed87991a838719ff7fcb80464404
+  data.tar.gz: 5112f6462def1f310ec78ab55fb38c555888ec39adf9d0605e930a01ddbbc282b7635d08a4348b63d562b67dd6fa48111022e8404a330812cd4922f853bf840e

data/.gitattributes

@@ -0,0 +1,4 @@
+* text=auto
+
+spec/cassettes/**/* -diff
+spec/cassettes/**/* linguist-generated

data/.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
           ruby-version: ${{ matrix.rubyversion }}
           bundler-cache: true
       - name: run tests
-        run: bundle exec rspec
+        run: EASYPOST_TEST_API_KEY=123 EASYPOST_PROD_API_KEY=123 make test
   lint:
     runs-on: ubuntu-latest
     steps:
@@ -31,6 +31,8 @@ jobs:
         with:
           ruby-version: "3.1"
       - name: Install Dependencies
-        run: bundle install
+        run: make install
       - name: Lint Project
-        run: rubocop
+        run: make lint
+      - name: Run security analysis
+        run: make brakeman

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## v4.5.0 (2022-07-18)
+
+- Adds ability to generate shipment forms via `generate_form` function
+
+## v4.4.0 (2022-07-11)
+
+- Adds `Billing.retrieve_payment_methods()`, `Billing.fund_wallet()`, and `Billing.delete_payment_method()` functions
+- Captures OS information in the user-agent header for easier debugging
+- Update functions now use `patch` instead of `put` under the hood to better match API behavior and documentation. The behavior of these functions should remain the same
+
+## v4.3.0 (2022-05-19)
+
+- Adds the `EndShipper` Beta class with `create`, `retrieve`, `all`, and `save` functions
+- Requests will now fail fast with an error if an API key is not provided instead of making a live API call with no key
+- Fixes a bug where the library could not properly parse the response of deleting a child user
+- Fixes a bug where you could not update a webhook due to a `wrong number of arguments` error
+
 ## v4.2.1 (2022-05-11)
 
 - Corrects the `Beta` namespace for the new Referral class

data/Makefile

@@ -0,0 +1,37 @@
+## help - Display help about make targets for this Makefile
+help:
+	@cat Makefile | grep '^## ' --color=never | cut -c4- | sed -e "`printf 's/ - /\t- /;'`" | column -s "`printf '\t'`" -t
+
+## brakeman - Runs security analysis on the project with Brakeman
+brakeman:
+	brakeman lib --force
+
+## build - Builds the project
+build:
+	gem build easypost.gemspec
+
+## clean - Cleans the project
+clean:
+	rm -rf coverage doc *.gem
+
+## fix - Fix Rubocop errors
+fix:
+	rubocop -A
+
+## install - Install globally from source
+install:
+	bundle install
+
+## lint - Lint the project
+lint:
+	rubocop
+
+## push - Pushes the built gem to Rubygems
+push:
+	gem push *.gem
+
+## test - Test the project
+test:
+	bundle exec rspec
+
+.PHONY: help build clean fix install lint push test

data/README.md

@@ -3,7 +3,7 @@
 [![Build Status](https://github.com/EasyPost/easypost-ruby/workflows/CI/badge.svg)](https://github.com/EasyPost/easypost-ruby/actions?query=workflow%3ACI)
 [![Gem Version](https://badge.fury.io/rb/easypost.svg)](https://badge.fury.io/rb/easypost)
 
-EasyPost, the simple shipping solution. You can sign up for an account at https://easypost.com.
+EasyPost, the simple shipping solution. You can sign up for an account at <https://easypost.com>.
 
 ## Install
 
@@ -110,24 +110,41 @@ end
 
 ## Documentation
 
-API Documentation can be found at: https://easypost.com/docs/api.
+API Documentation can be found at: <https://easypost.com/docs/api>.
 
 ## Development
 
 ```bash
 # Install dependencies
-bundle install
+make install
+
+# Lint project
+make lint
 
 # Run tests (coverage is generated on a successful test suite run)
-EASYPOST_TEST_API_KEY=123... EASYPOST_PROD_API_KEY=123... bundle exec rspec
+EASYPOST_TEST_API_KEY=123... EASYPOST_PROD_API_KEY=123... make test
 ```
 
 ### Testing
 
 The test suite in this project was specifically built to produce consistent results on every run, regardless of when they run or who is running them. This project uses [VCR](https://github.com/vcr/vcr) to record and replay HTTP requests and responses via "cassettes". When the suite is run, the HTTP requests and responses for each test function will be saved to a cassette if they do not exist already and replayed from this saved file if they do, which saves the need to make live API calls on every test run.
 
-If you make an addition to this project, the request/response will get recorded automatically for you. When making changes to this project, you'll need to re-record the associated cassette to force a new live API call for that test which will then record the request/response used on the next run.
+**Sensitive Data:** We've made every attempt to include scrubbers for sensitive data when recording cassettes so that PII or sensitive info does not persist in version control; however, please ensure when recording or re-recording cassettes that prior to committing your changes, no PII or sensitive information gets persisted by inspecting the cassette.
+
+**Making Changes:** If you make an addition to this project, the request/response will get recorded automatically for you. When making changes to this project, you'll need to re-record the associated cassette to force a new live API call for that test which will then record the request/response used on the next run.
+
+**Test Data:** The test suite has been populated with various helpful fixtures that are available for use, each completely independent from a particular user **with the exception of the USPS carrier account ID** (see [Unit Test API Keys](#unit-test-api-keys) for more information) which has a fallback value of our internal testing user's ID. Some fixtures use hard-coded dates that may need to be incremented if cassettes get re-recorded (such as reports or pickups).
+
+#### Unit Test API Keys
+
+The following are required on every test run:
+
+- `EASYPOST_TEST_API_KEY`
+- `EASYPOST_PROD_API_KEY`
+
+The following are required when you need to re-record cassettes for applicable tests (fallback values are used otherwise):
 
-The test suite has been populated with various helpful fixtures that are available for use, each completely independent from a particular user **with the exception of the USPS carrier account ID** which has a fallback value to our internal testing user's ID. If you are a non-EasyPost employee and are re-recording cassettes, you may need to provide the `USPS_CARRIER_ACCOUNT_ID` environment variable with the ID associated with your USPS account (which will be associated with your API keys in use) for tests that use this fixture.
+- `USPS_CARRIER_ACCOUNT_ID` (eg: one-call buying a shipment for non-EasyPost employees)
+- `REFERRAL_USER_PROD_API_KEY` (eg: adding a credit card to a referral user)
 
-**Note on dates:** Some fixtures use hard-coded dates that may need to be incremented if cassettes get re-recorded (such as reports or pickups).
+Some tests may require a user with a particular set of enabled features such as a `Partner` user when creating referrals. We have attempted to call out these functions in their respective docstrings.

data/VERSION

@@ -1 +1 @@
-4.2.1
+4.5.0

data/easypost.gemspec

@@ -21,6 +21,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
   spec.required_ruby_version = '>= 2.5'
 
+  spec.add_development_dependency 'brakeman', '~> 5.2'
   spec.add_development_dependency 'pry', '~> 0.14'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.10'

data/lib/easypost/beta/end_shipper.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# EndShipper objects are fully-qualified Address objects that require all parameters and get verified upon creation.
+class EasyPost::Beta::EndShipper < EasyPost::Resource
+  # Create an EndShipper object.
+  def self.create(params = {}, api_key = nil)
+    response = EasyPost.make_request(:post, '/beta/end_shippers', api_key, { address: params })
+    EasyPost::Util.convert_to_easypost_object(response, api_key)
+  end
+
+  # Retrieves an EndShipper object.
+  def self.retrieve(id, params = {}, api_key = nil)
+    response = EasyPost.make_request(:get, "/beta/end_shippers/#{id}", api_key, params)
+    EasyPost::Util.convert_to_easypost_object(response, api_key)
+  end
+
+  # Retrieves a list of EndShipper objects.
+  def self.all(params = {}, api_key = nil)
+    response = EasyPost.make_request(:get, '/beta/end_shippers', api_key, params)
+    EasyPost::Util.convert_to_easypost_object(response, api_key)
+  end
+
+  # Updates (saves) an EndShipper object. This requires all parameters to be set.
+  def save
+    if @unsaved_values.length.positive?
+      values = {}
+      @unsaved_values.each { |k| values[k] = @values[k] }
+
+      wrapped_params = { address: values }
+
+      response = EasyPost.make_request(:put, "/beta/end_shippers/#{id}", @api_key, wrapped_params)
+      refresh_from(response, api_key)
+    end
+    self
+  end
+end

data/lib/easypost/beta/referral.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# Referral objects are User objects created from a Partner user.
 class EasyPost::Beta::Referral < EasyPost::Resource
   # Create a referral user. This function requires the Partner User's API key.
   def self.create(params = {}, api_key = nil)
@@ -14,7 +15,7 @@ class EasyPost::Beta::Referral < EasyPost::Resource
         email: email,
       },
     }
-    _ = EasyPost.make_request(:put, "/beta/referral_customers/#{user_id}", api_key, wrapped_params)
+    EasyPost.make_request(:put, "/beta/referral_customers/#{user_id}", api_key, wrapped_params)
 
     # return true if API succeeds, else an error is throw if it fails.
     true

data/lib/easypost/beta.rb

@@ -3,4 +3,5 @@
 module EasyPost::Beta
 end
 
+require_relative 'beta/end_shipper'
 require_relative 'beta/referral'

data/lib/easypost/billing.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# Billing class that users can manage their payment and fund
+class EasyPost::Billing < EasyPost::Resource
+  # Fund your EasyPost wallet by charging your primary or secondary card on file.
+  def self.fund_wallet(amount, primary_or_secondary = 'primary', api_key = nil)
+    payment_info = EasyPost::Billing.get_payment_method_info(primary_or_secondary.downcase)
+    endpoint = payment_info[0]
+    payment_id = payment_info[1]
+
+    wrapped_params = { amount: amount }
+    EasyPost.make_request(:post, "#{endpoint}/#{payment_id}/charges", api_key, wrapped_params)
+
+    # Return true if succeeds, an error will be thrown if it fails
+    true
+  end
+
+  # Delete a payment method.
+  def self.delete_payment_method(primary_or_secondary, api_key = nil)
+    payment_info = EasyPost::Billing.get_payment_method_info(primary_or_secondary.downcase)
+    endpoint = payment_info[0]
+    payment_id = payment_info[1]
+
+    EasyPost.make_request(:delete, "#{endpoint}/#{payment_id}", api_key)
+
+    # Return true if succeeds, an error will be thrown if it fails
+    true
+  end
+
+  # Retrieve all payment methods.
+  def self.retrieve_payment_methods(api_key = nil)
+    response = EasyPost.make_request(:get, '/v2/payment_methods', api_key)
+
+    if response['id'].nil?
+      raise EasyPost::Error.new('Billing has not been setup for this user. Please add a payment method.')
+    end
+
+    EasyPost::Util.convert_to_easypost_object(response, api_key)
+  end
+
+  # Get payment method info (type of the payment method and ID of the payment method)
+  private_class_method def self.get_payment_method_info(primary_or_secondary)
+    payment_methods = EasyPost::Billing.retrieve_payment_methods
+    payment_method_map = {
+      'primary' => 'primary_payment_method',
+      'secondary' => 'secondary_payment_method',
+    }
+
+    payment_method_to_use = payment_method_map[primary_or_secondary]
+
+    error_string = 'The chosen payment method is not valid. Please try again.'
+    raise EasyPost::Error.new(error_string) if payment_methods[payment_method_to_use].nil?
+
+    payment_method_id = payment_methods[payment_method_to_use]['id']
+
+    unless payment_method_id.nil?
+      if payment_method_id.start_with?('card_')
+        endpoint = '/v2/credit_cards'
+      elsif payment_method_id.start_with?('bank_')
+        endpoint = '/v2/bank_accounts'
+      else
+        raise EasyPost::Error.new(error_string)
+      end
+    end
+
+    [endpoint, payment_method_id]
+  end
+end

data/lib/easypost/connection.rb

@@ -10,6 +10,10 @@ EasyPost::Connection = Struct.new(:uri, :config, keyword_init: true) do
   # @raise [EasyPost::Error] if the response has a non-2xx status code
   # @return [Hash] JSON object parsed from the response body
   def call(method, path, api_key = nil, body = nil)
+    if api_key.nil?
+      raise EasyPost::Error, 'No API key provided.'
+    end
+
     connection =
       if config[:proxy]
         proxy_uri = URI(config[:proxy])
@@ -51,11 +55,12 @@ EasyPost::Connection = Struct.new(:uri, :config, keyword_init: true) do
     request['Authorization'] = EasyPost.authorization(api_key) if api_key
 
     response = connection.request(request)
+    response_is_json = response['Content-Type'] ? response['Content-Type'].start_with?('application/json') : false
 
     EasyPost.parse_response(
       status: response.code.to_i,
       body: response.body,
-      json: response['Content-Type'].start_with?('application/json'),
+      json: response_is_json,
     )
   end
 end

data/lib/easypost/payment_method.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+# PaymentMethod objects represent a payment method of a user.
+class EasyPost::PaymentMethod < EasyPost::Resource
+  # Retrieve all payment methods.
+  def self.all(api_key = nil)
+    response = EasyPost.make_request(:get, url, api_key)
+
+    if response['id'].nil?
+      raise EasyPost::Error.new('Billing has not been setup for this user. Please add a payment method.')
+    end
+
+    EasyPost::Util.convert_to_easypost_object(response, api_key)
+  end
+end

data/lib/easypost/resource.rb

@@ -97,7 +97,7 @@ class EasyPost::Resource < EasyPost::EasyPostObject
 
       wrapped_params = { self.class.class_name => values }
 
-      response = EasyPost.make_request(:put, url, @api_key, wrapped_params)
+      response = EasyPost.make_request(:patch, url, @api_key, wrapped_params)
       refresh_from(response, api_key)
     end
     self

data/lib/easypost/shipment.rb

@@ -112,4 +112,19 @@ class EasyPost::Shipment < EasyPost::Resource
 
     lowest_smartrate
   end
+
+  # Generate a form for a Shipment.
+  def generate_form(form_type, form_options = {})
+    params = {}
+    params[:type] = form_type
+    merged_params = params.merge(form_options)
+    wrapped_params = {
+      form: merged_params,
+    }
+
+    response = EasyPost.make_request(:post, "#{url}/forms", @api_key, wrapped_params)
+    refresh_from(response, @api_key)
+
+    self
+  end
 end

data/lib/easypost/user.rb

@@ -16,12 +16,18 @@ class EasyPost::User < EasyPost::Resource
 
       wrapped_params = { user: values }
 
-      response = EasyPost.make_request(:put, url, @api_key, wrapped_params)
+      response = EasyPost.make_request(:patch, url, @api_key, wrapped_params)
       refresh_from(response, api_key)
     end
     self
   end
 
+  # Delete a User.
+  def delete
+    EasyPost.make_request(:delete, url, @api_key)
+    self
+  end
+
   # Retrieve the authenticated User.
   def self.retrieve_me
     all

data/lib/easypost/util.rb

@@ -2,6 +2,90 @@
 
 # Internal utilities helpful for this libraries operation.
 module EasyPost::Util
+  attr_accessor :os_name, :os_version, :os_arch
+
+  BY_PREFIX = {
+    'adr' => EasyPost::Address,
+    'batch' => EasyPost::Batch,
+    'brd' => EasyPost::Brand,
+    'ca' => EasyPost::CarrierAccount,
+    'cstinfo' => EasyPost::CustomsInfo,
+    'cstitem' => EasyPost::CustomsItem,
+    'es' => EasyPost::Beta::EndShipper,
+    'evt' => EasyPost::Event,
+    'hook' => EasyPost::Webhook,
+    'ins' => EasyPost::Insurance,
+    'order' => EasyPost::Order,
+    'pickup' => EasyPost::Pickup,
+    'pickuprate' => EasyPost::PickupRate,
+    'pl' => EasyPost::PostageLabel,
+    'plrep' => EasyPost::Report,
+    'prcl' => EasyPost::Parcel,
+    'rate' => EasyPost::Rate,
+    'refrep' => EasyPost::Report,
+    'rfnd' => EasyPost::Refund,
+    'sf' => EasyPost::ScanForm,
+    'shp' => EasyPost::Shipment,
+    'shpinvrep' => EasyPost::Report,
+    'shprep' => EasyPost::Report,
+    'trk' => EasyPost::Tracker,
+    'trkrep' => EasyPost::Report,
+    'user' => EasyPost::User,
+  }.freeze
+
+  BY_TYPE = {
+    'Address' => EasyPost::Address,
+    'Batch' => EasyPost::Batch,
+    'Brand' => EasyPost::Brand,
+    'CarrierAccount' => EasyPost::CarrierAccount,
+    'CustomsInfo' => EasyPost::CustomsInfo,
+    'CustomsItem' => EasyPost::CustomsItem,
+    'EndShipper' => EasyPost::Beta::EndShipper,
+    'Event' => EasyPost::Event,
+    'Insurance' => EasyPost::Insurance,
+    'Order' => EasyPost::Order,
+    'Parcel' => EasyPost::Parcel,
+    'PaymentLogReport' => EasyPost::Report,
+    'Pickup' => EasyPost::Pickup,
+    'PickupRate' => EasyPost::PickupRate,
+    'PostageLabel' => EasyPost::PostageLabel,
+    'Rate' => EasyPost::Rate,
+    'Referral' => EasyPost::Beta::Referral,
+    'Refund' => EasyPost::Refund,
+    'RefundReport' => EasyPost::Report,
+    'Report' => EasyPost::Report,
+    'ScanForm' => EasyPost::ScanForm,
+    'Shipment' => EasyPost::Shipment,
+    'ShipmentInvoiceReport' => EasyPost::Report,
+    'ShipmentReport' => EasyPost::Report,
+    'TaxIdentifier' => EasyPost::TaxIdentifier,
+    'Tracker' => EasyPost::Tracker,
+    'TrackerReport' => EasyPost::Report,
+    'User' => EasyPost::User,
+    'Webhook' => EasyPost::Webhook,
+  }.freeze
+
+  def self.os_name
+    case RUBY_PLATFORM
+    when /linux/i
+      'Linux'
+    when /darwin/i
+      'Darwin'
+    when /cygwin|mswin|mingw|bccwin|wince|emx/i
+      'Windows'
+    else
+      'Unknown'
+    end
+  end
+
+  def self.os_version
+    Gem::Platform.local.version
+  end
+
+  def self.os_arch
+    Gem::Platform.local.cpu
+  end
+
   # Form-encode a multi-layer dictionary to a one-layer dictionary.
   def self.form_encode_params(hash, parent_keys = [], parent_dict = {})
     result = parent_dict or {}
@@ -55,81 +139,23 @@ module EasyPost::Util
 
   # Convert data to an EasyPost Object.
   def self.convert_to_easypost_object(response, api_key, parent = nil, name = nil)
-    types = {
-      'Address' => EasyPost::Address,
-      'Batch' => EasyPost::Batch,
-      'Brand' => EasyPost::Brand,
-      'CarrierAccount' => EasyPost::CarrierAccount,
-      'CustomsInfo' => EasyPost::CustomsInfo,
-      'CustomsItem' => EasyPost::CustomsItem,
-      'Event' => EasyPost::Event,
-      'Insurance' => EasyPost::Insurance,
-      'Order' => EasyPost::Order,
-      'Parcel' => EasyPost::Parcel,
-      'PaymentLogReport' => EasyPost::Report,
-      'Pickup' => EasyPost::Pickup,
-      'PickupRate' => EasyPost::PickupRate,
-      'PostageLabel' => EasyPost::PostageLabel,
-      'Rate' => EasyPost::Rate,
-      'Refund' => EasyPost::Refund,
-      'RefundReport' => EasyPost::Report,
-      'Report' => EasyPost::Report,
-      'ScanForm' => EasyPost::ScanForm,
-      'Shipment' => EasyPost::Shipment,
-      'TaxIdentifier' => EasyPost::TaxIdentifier,
-      'ShipmentInvoiceReport' => EasyPost::Report,
-      'ShipmentReport' => EasyPost::Report,
-      'Tracker' => EasyPost::Tracker,
-      'TrackerReport' => EasyPost::Report,
-      'User' => EasyPost::User,
-      'Webhook' => EasyPost::Webhook,
-    }
-
-    prefixes = {
-      'adr' => EasyPost::Address,
-      'batch' => EasyPost::Batch,
-      'brd' => EasyPost::Brand,
-      'ca' => EasyPost::CarrierAccount,
-      'cstinfo' => EasyPost::CustomsInfo,
-      'cstitem' => EasyPost::CustomsItem,
-      'evt' => EasyPost::Event,
-      'hook' => EasyPost::Webhook,
-      'ins' => EasyPost::Insurance,
-      'order' => EasyPost::Order,
-      'pickup' => EasyPost::Pickup,
-      'pickuprate' => EasyPost::PickupRate,
-      'pl' => EasyPost::PostageLabel,
-      'plrep' => EasyPost::Report,
-      'prcl' => EasyPost::Parcel,
-      'rate' => EasyPost::Rate,
-      'refrep' => EasyPost::Report,
-      'rfnd' => EasyPost::Refund,
-      'sf' => EasyPost::ScanForm,
-      'shp' => EasyPost::Shipment,
-      'shpinvrep' => EasyPost::Report,
-      'shprep' => EasyPost::Report,
-      'trk' => EasyPost::Tracker,
-      'trkrep' => EasyPost::Report,
-      'user' => EasyPost::User,
-    }
-
     case response
     when Array
       response.map { |i| convert_to_easypost_object(i, api_key, parent) }
     when Hash
       if (cls_name = response[:object])
-        cls = types[cls_name]
+        cls = BY_TYPE[cls_name]
       elsif response[:id]
         if response[:id].index('_').nil?
           cls = EasyPost::EasyPostObject
         elsif (cls_prefix = response[:id][0..response[:id].index('_')])
-          cls = prefixes[cls_prefix[0..-2]]
+          cls = BY_PREFIX[cls_prefix[0..-2]]
         end
       elsif response['id']
         if response['id'].index('_').nil?
           cls = EasyPost::EasyPostObject
         elsif (cls_prefix = response['id'][0..response['id'].index('_')])
-          cls = prefixes[cls_prefix[0..-2]]
+          cls = BY_PREFIX[cls_prefix[0..-2]]
         end
       end
 

data/lib/easypost/webhook.rb

@@ -12,8 +12,8 @@ class EasyPost::Webhook < EasyPost::Resource
 
     instance_url = "#{self.class.url}/#{CGI.escape(id)}"
 
-    response = EasyPost.make_request(:put, instance_url, @api_key, params)
-    refresh_from(response, api_key, true)
+    response = EasyPost.make_request(:patch, instance_url, @api_key, params)
+    refresh_from(response, api_key)
 
     self
   end

data/lib/easypost.rb

@@ -5,7 +5,6 @@ require 'cgi'
 require 'net/http'
 
 require 'easypost/version'
-require 'easypost/util'
 require 'easypost/object'
 require 'easypost/resource'
 require 'easypost/error'
@@ -15,6 +14,7 @@ require 'easypost/connection'
 require 'easypost/address'
 require 'easypost/api_key'
 require 'easypost/batch'
+require 'easypost/billing'
 require 'easypost/brand'
 require 'easypost/carrier_account'
 require 'easypost/carrier_type'
@@ -38,9 +38,10 @@ require 'easypost/user'
 require 'easypost/webhook'
 require 'easypost/beta'
 
+require 'easypost/util'
+
 module EasyPost
   DEFAULT_API_BASE = 'https://api.easypost.com'
-  DEFAULT_USER_AGENT = "EasyPost/v2 RubyClient/#{EasyPost::VERSION} Ruby/#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}"
 
   class << self
     attr_accessor :api_key, :api_base
@@ -49,10 +50,17 @@ module EasyPost
 
   self.api_base = DEFAULT_API_BASE
 
+  def self.user_agent
+    @user_agent ||=
+      "EasyPost/v2 RubyClient/#{EasyPost::VERSION} Ruby/#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL} " \
+      "OS/#{EasyPost::Util.os_name} OSVersion/#{EasyPost::Util.os_version} " \
+      "OSArch/#{EasyPost::Util.os_arch}"
+  end
+
   def self.default_headers
     @default_headers ||= {
       'Content-Type' => 'application/json',
-      'User-Agent' => EasyPost::DEFAULT_USER_AGENT,
+      'User-Agent' => user_agent,
     }
   end
 
@@ -134,7 +142,7 @@ module EasyPost
       )
     end
 
-    json ? JSON.parse(body) : body
+    json || !body.nil? && !body.match(/\A\s+\z/) ? JSON.parse(body) : body
   rescue JSON::ParserError
     raise "Invalid response object from API, unable to decode.\n#{body}"
   end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: easypost
 version: !ruby/object:Gem::Version
-  version: 4.2.1
+  version: 4.5.0
 platform: ruby
 authors:
 - EasyPost Developers
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-11 00:00:00.000000000 Z
+date: 2022-07-18 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: brakeman
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -143,6 +157,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitattributes"
 - ".github/ISSUE_TEMPLATE/bug_report.yml"
 - ".github/ISSUE_TEMPLATE/feature_request.yml"
 - ".github/PULL_REQUEST_TEMPLATE.md"
@@ -154,6 +169,7 @@ files:
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE
+- Makefile
 - README.md
 - Rakefile
 - SECURITY.md
@@ -168,7 +184,9 @@ files:
 - lib/easypost/api_key.rb
 - lib/easypost/batch.rb
 - lib/easypost/beta.rb
+- lib/easypost/beta/end_shipper.rb
 - lib/easypost/beta/referral.rb
+- lib/easypost/billing.rb
 - lib/easypost/brand.rb
 - lib/easypost/carrier_account.rb
 - lib/easypost/carrier_type.rb
@@ -181,6 +199,7 @@ files:
 - lib/easypost/object.rb
 - lib/easypost/order.rb
 - lib/easypost/parcel.rb
+- lib/easypost/payment_method.rb
 - lib/easypost/pickup.rb
 - lib/easypost/pickup_rate.rb
 - lib/easypost/postage_label.rb
@@ -215,7 +234,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.11
 signing_key:
 specification_version: 4
 summary: EasyPost Ruby Client Library