recurly 2.17.0 → 3.14.0

data/CONTRIBUTING.md

@@ -0,0 +1,106 @@
+# Contributing Guide
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Filing an Issue or a Pull Request is often the best way to address a problem with this library;
+however, we may not get to these right away. Although we try to be quick, our primary, daily focus is
+writing code. If you want a timely response (especially if you have an emergency), we recommend
+you contact our [official support team](https://support.recurly.com/).
+
+## Code of Conduct
+
+Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
+
+#### Table Of Contents
+
+* [I don't want to read this whole thing, I just have a question!!!](#i-dont-want-to-read-this-whole-thing-i-just-have-a-question)
+* [I think something is wrong with this library](#i-think-something-is-wrong-with-this-library)
+* [I know what's wrong and I want to submit a code change](#i-know-whats-wrong-and-i-want-to-submit-a-code-change)
+  * [Development Dependencies](#development-dependencies)
+  * [Building and Testing](#building-and-testing)
+  * [Formatting Code](#formatting-code)
+  * [Generated Code](#generated-code)
+
+
+## I don't want to read this whole thing I just have a question!!!
+
+The best way to get a question answered is through our [official support channel](https://support.recurly.com/). If you
+have a specific question related to this library and cannot find an answer, feel free to post an issue with the question.
+
+## I think something is wrong with this library
+
+Are you getting an exception or seeing some unexpected behavior from the library? An issue is the way to go.
+Submit an issue and make sure you provide as much detail as possible. Some things you'll want to include:
+
+* Your dependency versions (client version, language version, OS, etc)
+* A stack trace if available
+* A [Minimal, Reproducible Example](https://stackoverflow.com/help/minimal-reproducible-example)
+
+The more information you give us, the quicker and easier the response will be. Keep in mind that issues should be scoped
+to a problem in this library and we may often redirect you to our official support for problems originating from
+upstream systems.
+
+## I know what's wrong and I want to submit a code change
+
+So, you are sure you want to submit a change to the code? We appreciate the help!
+Before you do, consider opening a discussion in the form of an issue. This accomplish a few things:
+
+1. We can give you advice to implement the change
+2. We can give you an idea of our openness to the change
+
+**Note**: Sending code without a discussion is *always* fine. Discussion on the PR is often easier anyway. Just understand that we may
+not accept the code if we don't think it's best for everyone using the library.
+
+The rest of this section describes what you'll need to know.
+
+### Development Dependencies
+
+You're going to first need a supported version of the language toolchain. The best way to find which versions are supported are by checking
+the [Travis File](.travis.yml) which is used to run our tests. We try to test against every supported version of the language. The [README](README.md)
+may also have something to say about supported dependencies.
+
+### Building and Testing
+
+All of our client libraries contain a `scripts` folder which houses a set of bash scripts for doing common
+development tasks. These scripts follow the same naming conventions so this can act as a kind of "Bash API"
+for manipulating the libraries.
+
+**Note**: If you are on a system without bash (such as some Windows systems), you should find the scripts only consist of a
+few commands which can easily be run in your terminal or editor directly.
+
+Start by running the `build` script to setup deps, compile (if applicable), build docs, etc:
+
+```bash
+./scripts/build
+```
+
+Use the `test` script to run the tests:
+
+```bash
+./scripts/test
+```
+
+Make sure the tests pass locally before submitting your change.
+
+### Formatting Code
+
+The PR (and often the tests) will fail if you have not properly formatted the code. Instead of having a style-guide, we've provided
+an auto-formatter. To use it, run the `format` script:
+
+```bash
+./scripts/format
+```
+
+### Generated Code
+
+Some files in this codebase are generated by a non-public, proprietary program. Because they are regularly generated and updated as the
+API and docs change, we won't accept any PRs that modify these files. Each of these files has a disclaimer on the top saying that they cannot
+be edited by hand. By convention, they relate to things that are specific to the Recurly API that may change. For example:
+
+* Response Schemas (Resources)
+* Request Schemas (Requests)
+* API endpoints (Operations)
+* Errors
+
+If you feel like you need one of these to change, please file an issue and we can discuss getting the change upstreamed.
+

data/GETTING_STARTED.md

@@ -0,0 +1,319 @@
+This repository houses the official ruby client for Recurly's V3 API.
+
+# Installing
+
+In your Gemfile, add `recurly` as a dependency.
+
+```ruby
+gem 'recurly', '~> 3.14'
+```
+
+> *Note*: We try to follow [semantic versioning](https://semver.org/) and will only apply breaking changes to major versions.
+
+# Creating a client
+
+A client represents a connection to the Recurly servers. Every call
+to the server exists as a method on this class. To initialize, you only need the private API key
+which can be obtained on the [API Credentials Page](https://app.recurly.com/go/integrations/api_keys).
+
+```ruby
+API_KEY = '83749879bbde395b5fe0cc1a5abf8e5'
+client = Recurly::Client.new(api_key: API_KEY)
+sub = client.get_subscription(subscription_id: 'abcd123456')
+```
+
+You can also pass the initializer a block. This will give you a client scoped for just that block:
+
+```ruby
+Recurly::Client.new(api_key: API_KEY) do |client|
+  sub = client.get_subscription(subscription_id: 'abcd123456')
+end
+```
+
+If you plan on using the client for more than one site, you should initialize a new client for each site.
+
+```ruby
+client = Recurly::Client.new(api_key: API_KEY1) 
+sub = client.get_subscription(subscription_id: 'abcd123456')
+
+# you should create a new client to connect to another site
+client = Recurly::Client.new(api_key: API_KEY2) 
+sub = client.get_subscription(subscription_id: 'abcd7890')
+```
+
+## Logging
+
+The client constructor optionally accepts a logger provided by the programmer. The logger you pass should be an instance of ruby stdlib's [Logger](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html)
+or follow the same interface. By default, the client creates a logger to `STDOUT` with level `WARN`.
+
+```ruby
+require 'logger'
+
+# Create a logger to STDOUT
+logger = Logger.new(STDOUT)
+logger.level = Logger::INFO
+
+# You could also use an existing logger
+# If you are using Rails you may want to use your application's logger
+logger = Rails.logger
+
+client = Recurly::Client.new(api_key: API_KEY, logger: logger)
+```
+
+> *SECURITY WARNING*: The log level should never be set to DEBUG in production. This could potentially result in sensitive data in your logging system.
+
+# Operations
+
+The {Recurly::Client} contains every `operation` you can perform on the site as a list of methods. Each method is documented explaining
+the types and descriptions for each input and return type. You can view all available operations by looking at the `Instance Methods Summary` list
+on the {Recurly::Client} documentation page. Clicking a method will give you detailed information about its inputs and returns. Take the `create_account`
+operation as an example: {Recurly::Client#create_account}.
+
+# Pagination
+
+Pagination is done by the class {Recurly::Pager}. All `list_*` methods on the client return an instance of this class.
+The pager has an `each` method which accepts a block for each object in the entire list. Each page is fetched automatically
+for you presenting the elements as a single enumerable.
+
+```ruby
+plans = client.list_plans()
+plans.each do |plan|
+  puts "Plan: #{plan.id}"
+end
+```
+
+You may also paginate in chunks with `each_page`.
+
+```ruby
+plans = client.list_plans()
+plans.each_page do |data|
+  data.each do |plan|
+    puts "Plan: #{plan.id}"
+  end
+end
+```
+
+Both {Pager#each} and {Pager#each_page} return Enumerators if a block is not given. This allows you to use other Enumerator methods
+such as `map` or `each_with_index`.
+
+```ruby
+plans = client.list_plans()
+plans.each_page.each_with_index do |data, page_num|
+  puts "Page Number #{page_num}"
+  data.each do |plan|
+    puts "Plan: #{plan.id}"
+  end
+end
+```
+
+Pagination endpoints take a number of options to sort and filter the results. They can be passed in as keyword arguments.
+The names, types, and descriptions of these arguments are listed in the rubydocs for each method:
+
+```ruby
+options = {
+  limit: 200, # number of items per page
+  state: :active, # only active plans
+  sort: :updated_at,
+  order: :asc,
+  begin_time: DateTime.new(2017,1,1), # January 1st 2017,
+  end_time: DateTime.now
+}
+
+plans = client.list_plans(**options)
+plans.each do |plan|
+  puts "Plan: #{plan.id}"
+end
+```
+
+**A note on `limit`**:
+
+`limit` defaults to 20 items per page and can be set from 1 to 200. Choosing a lower limit means more network requests but smaller payloads.
+We recommend keeping the default for most cases but increasing the limit if you are planning on iterating through many pages of items (e.g. all transactions in your site).
+
+## Efficiently Fetch the First or Last Resource
+
+The Pager class implements a first method which allows you to fetch just the first or last resource from the server. On top of being a convenient abstraction, this is implemented efficiently by only asking the server for the 1 item you want.
+
+```ruby
+accounts = client.list_accounts(
+  subscriber: true,
+  order: :desc
+)
+
+last_subscriber = accounts.first
+```
+
+If you want to fetch the last account in this scenario, invert the order from descending `desc` to ascending `asc`:
+
+```ruby
+accounts = client.list_accounts(
+  subscriber: true,
+  order: :asc
+)
+
+first_subscriber = accounts.first
+```
+
+## Counting Resources
+
+The Pager class implements a `count` method which allows you to count the resources the pager would return. It does so by calling the endpoint with `HEAD` and parsing and returning the `Recurly-Total-Records` header. This method respects any filtering parameters you apply to the pager, but the sorting parameters will have no effect.
+
+```ruby
+accounts = client.list_accounts(
+  subscriber: true,
+  begin_time: DateTime.new(2017,1,1)
+)
+
+# Calling count here will return an integer indicating
+# the number of subscribers since 2017
+count = accounts.count
+# => 573
+```
+
+# Creating Resources
+
+Currently, resources are created by passing in a `body` keyword argument in the form of a `Hash`.
+This Hash must follow the schema of the documented request type. For example, the `create_plan` operation
+takes a request of type {Recurly::Requests::PlanCreate}. Failing to conform to this schema will result in an argument
+error.
+
+```ruby
+require 'securerandom'
+
+code = SecureRandom.uuid
+plan_data = {
+  code: code,
+  interval_length: 1,
+  interval_unit: 'months',
+  name: code,
+  currencies: [
+    {
+      currency: 'USD',
+      setup_fee: 800,
+      unit_amount: 10
+    }
+  ]
+}
+
+plan = client.create_plan(body: plan_data)
+```
+
+# Error Handling
+
+This library currently throws 2 types of exceptions. {Recurly::Errors::APIError} and {Recurly::Errors::NetworkError}. See these 2 files for the types of exceptions you can catch:
+
+1. [API Errors](./lib/recurly/errors/api_errors.rb)
+2. [Network Errors](./lib/recurly/errors/network_errors.rb)
+
+You will normally be working with {Recurly::Errors::APIError}. You can catch specific or generic versions of these exceptions. Example:
+
+```ruby
+begin
+  client = Recurly::Client.new(api_key: API_KEY)
+  code = "iexistalready"
+  plan_data = {
+    code: code,
+    interval_length: 1,
+    interval_unit: 'months',
+    name: code,
+    currencies: [
+      {
+        currency: 'USD',
+        setup_fee: 800,
+        unit_amount: 10
+      }
+    ]
+  }
+
+  plan = client.create_plan(body: plan_data)
+rescue Recurly::Errors::ValidationError => ex
+  puts ex.inspect
+  #=> #<Recurly::ValidationError: Recurly::ValidationError: Code 'iexistalready' already exists>
+  puts ex.recurly_error.inspect
+  #=> #<Recurly::Error:0x007fbbdf8a32c8 @attributes={:type=>"validation", :message=>"Code 'iexistalready' already exists", :params=>[{"param"=>"code", "message"=>"'iexistalready' already exists"}]}>
+  puts ex.status_code
+  #=> 422
+rescue Recurly::Errors::APIError => ex
+  # catch a generic api error
+rescue Recurly::Errors::TimeoutError => ex
+  # catch a specific network error
+rescue Recurly::Errors::NetworkError => ex
+  # catch a generic network error
+end
+```
+
+# HTTP Metadata
+
+Sometimes you might want to get some additional information about the underlying HTTP request and response. Instead of
+returning this information directly and forcing the programmer to unwrap it, we inject this metadata into the top level
+resource that was returned. You can access the {Recurly::HTTP::Response} by calling `#get_response` on any {Recurly::Resource}.
+
+**Warning**: Do not log or render whole requests or responses as they may contain PII or sensitive data.
+
+```ruby
+account = @client.get_account(account_id: "code-benjamin")
+response = account.get_response
+response.rate_limit_remaining #=> 1985
+response.request_id #=> "0av50sm5l2n2gkf88ehg"
+response.request.path #=> "/sites/subdomain-mysite/accounts/code-benjamin"
+response.request.body #=> None
+```
+
+This also works on {Recurly::Resources::Empty} responses:
+
+```ruby
+response = @client.remove_line_item(
+  line_item_id: "a959576b2b10b012"
+).get_response
+```
+And it can be captured on exceptions through the {Recurly::ApiError} object:
+
+```ruby
+begin
+  account = client.get_account(account_id: "code-benjamin")
+rescue Recurly::Errors::NotFoundError => e
+  response = e.get_response()
+  puts "Give this request id to Recurly Support: #{response.request_id}"
+end
+```
+
+# Webhooks
+
+Recurly can send webhooks to any publicly accessible server.
+When an event in Recurly triggers a webhook (e.g., an account is opened),
+Recurly will attempt to send this notification to the endpoint(s) you specify.
+You can specify up to 10 endpoints through the application. All notifications will
+be sent to all configured endpoints for your site. 
+
+See our [product docs](https://docs.recurly.com/docs/webhooks) to learn more about webhooks
+and see our [dev docs](https://developers.recurly.com/pages/webhooks.html) to learn about what payloads
+are available.
+
+Although our API is now JSON, our webhook payloads are still formatted as XML for the time being.
+This library is not yet responsible for handling webhooks. If you do need webhooks, we recommend using a simple
+XML to Hash parser.
+
+If you are using Rails, we'd recommend [Hash.from_xml](https://apidock.com/rails/Hash/from_xml/class).
+
+```ruby
+notification = Hash.from_xml <<-XML
+  <?xml version="1.0" encoding="UTF-8"?>
+  <new_account_notification>
+    <account>
+      <account_code>1</account_code>
+      <username nil="true"></username>
+      <email>verena@example.com</email>
+      <first_name>Verena</first_name>
+      <last_name>Example</last_name>
+      <company_name nil="true"></company_name>
+    </account>
+  </new_account_notification>
+XML
+
+code = notification["new_account_notification"]["account"]["account_code"]
+puts "New Account with code #{code} created."
+```
+
+If you are not using Rails, we recommend you use [nokogiri](https://nokogiri.org/); however, heed security warnings
+about parse options. Although the XML should only be coming from Recurly, you should parse it as untrusted to be safe.
+Read more about the security implications of parsing untrusted XML in [this OWASP cheatsheet](https://cheatsheetseries.owasp.org/cheatsheets/XML_Security_Cheat_Sheet.html).

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in recurly.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Recurly Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -1,161 +1,17 @@
-# Recurly [![Build Status](https://secure.travis-ci.org/recurly/recurly-client-ruby.png?branch=master)](http://travis-ci.org/recurly/recurly-client-ruby) [![Gem Version](https://badge.fury.io/rb/recurly.svg)](http://badge.fury.io/rb/recurly)
+# Recurly
 
-<https://github.com/recurly/recurly-client-ruby>
+[![Rubygems](https://img.shields.io/static/v1?label=rubygems&message=recurly&color=purple)](https://rubygems.org/gems/recurly)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
 
-[Recurly](https://recurly.com/)'s Ruby client library is an interface to its
-[REST API](https://dev.recurly.com/docs/getting-started).
+This repository houses the official ruby client for Recurly's V3 API.
 
-You can also look at [rubydocs](http://www.rubydoc.info/github/recurly/recurly-client-ruby/master)
-to see documentation on the classes and methods available.
+> *Note*:
+> If you were looking for the V2 client, see the [v2 branch](https://github.com/recurly/recurly-client-ruby/tree/v2).
 
-## Installation
+## Reference Documentation
 
-Recurly is packaged as a Ruby gem. We recommend you install it with
-[Bundler](http://gembundler.com/) by adding the following line to your Gemfile:
-
-``` ruby
-gem 'recurly', '~> 2.17'
-```
-
-Recurly will automatically use [Nokogiri](http://nokogiri.org/) (for a nice
-speed boost) if it's available and loaded in your app's environment.
-
-## Configuration
-
-If you're using Rails, you can generate an initializer with the following
-command:
-
-``` bash
-$ rails g recurly:config
-```
-
-If you're not using Rails, use the following template:
-
-``` ruby
-Recurly.subdomain      = ENV['RECURLY_SUBDOMAIN']
-Recurly.api_key        = ENV['RECURLY_API_KEY']
-```
-
-Configure the client library with
-[your API credentials](https://app.recurly.com/go/developer/api_access).
-
-* `RECURLY_SUBDOMAIN` should contain subdomain for your recurly account.
-* `RECURLY_API_KEY` is your "Private API Key" which can be found under "API Credentials" on the `api_access` admin page.
-
-The default currency is USD. To override with a different code:
-
-``` ruby
-Recurly.default_currency = 'EUR' # Assign nil to disable the default entirely.
-```
-
-If you are using [Recurly.js](https://js.recurly.com) you can store "Public API Key" (which can be found
-under "API Credentials" on the `api_access` admin page):
-
-``` ruby
-Recurly.js.public_key = ENV['RECURLY_PUBLIC_API_KEY']
-```
-
-Then, in your Rails project you can create `recurly_service.js.erb` file and
-[configure](https://docs.recurly.com/js/#configure) recurly.js with public key this way:
-
-``` js
-recurly.configure({ publicKey: '<%= Recurly.js.public_key %>'});
-```
-
-The client library currently uses a Net::HTTP adapter. If you need to
-configure the settings passed to Net::HTTP (e.g., an SSL certificates path or timeout lengths),
-make sure you assign them when initializing the library:
-
-``` ruby
-Recurly::API.net_http = {
-  ca_path: "/etc/ssl/certs",
-  open_timeout: 5, # 5 seconds (defaults to 60)
-  read_timeout: 45 # 45 seconds (defaults to 60)
-}
-```
-
-To see which keys are supported for this Hash, see the `Attributes` section
-of the [Net::HTTP documentation](http://ruby-doc.org/stdlib-2.4.1/libdoc/net/http/rdoc/Net/HTTP.html) for your ruby version.
-
-## Multi-Threaded Configuration
-If you are using the client in a multi-threaded environment and require a different configuration per
-thread you can use the following within the thread's context:
-
-``` ruby
-Recurly.config({
-  subdomain: ENV['RECURLY_SUBDOMAIN']
-  api_key: ENV['RECURLY_API_KEY'],
-  default_currency: "US"
-})
-```
-
-Any configuration items you do not include in the above config call will be defaulted to the standard
-configuration items. For example if you do not define default_currency then Recurly.default_currency
-will be used.
-
-## Supported Ruby Versions
-
-We are currently supporting ruby language versions `2.3` and above. `1.9`, `2.0`, `2.1`, and `2.3` may still work but are not officially supported.
-
-If you are still using one of these rubies, you should know that support for them ended in
-2015 (1.9), 2016 (2.0), 2017 (2.1), 2018 (2.2) and continuing to use them is a security risk.
-
-- https://www.ruby-lang.org/en/news/2015/02/23/support-for-ruby-1-9-3-has-ended/
-- https://www.ruby-lang.org/en/news/2016/02/24/support-plan-of-ruby-2-0-0-and-2-1/
-- https://www.ruby-lang.org/en/news/2017/04/01/support-of-ruby-2-1-has-ended/
-- https://www.ruby-lang.org/en/news/2018/06/20/support-of-ruby-2-2-has-ended/
-
-## Nokogiri Support
-
-For now, we are still running the tests on 2.0 and below but without `nokogiri` and only `rexml`. Nokogiri is
-no longer supported on 1.9 or 2.0 and has patched known vulnerabilities since dropping support.
-If you must run one of these rubies (this includes jruby1.7), you must use rexml and not nokogiri.
-
-## Usage
-
-Instructions and examples are available on
-[Recurly's documentation site](https://dev.recurly.com/docs/getting-started).
-
-Recurly's gem API is available
-[here](http://rubydoc.info/gems/recurly/frames/Recurly).
-
-## Support
-
-- [https://support.recurly.com](https://support.recurly.com)
-- [stackoverflow](http://stackoverflow.com/questions/tagged/recurly)
+Getting Started Guide and reference documentation can be found on [Github Pages](https://recurly.github.io/recurly-client-ruby/).
 
 ## Contributing
 
-Developing for the Recurly gem is easy with [Bundler](http://gembundler.com/).
-
-Fork and clone the repository, `cd` into the directory, and, with a Ruby of your choice
-(1.9.3 or greater), set up your environment.
-
-If you don't have Bundler installed, install it with the following command:
-
-``` bash
-$ [sudo] gem install bundler
-```
-
-And bundle:
-
-``` bash
-$ bundle --path=vendor/bundle
-```
-
-You should now be able to run the test suite with Rake:
-
-``` bash
-$ bundle exec rake
-```
-
-To run the suite using Nokogiri:
-
-``` bash
-$ XML=nokogiri bundle exec rake
-```
-
-If you plan on submitting a patch, please write tests for it (we use
-[MiniTest::Spec](http://bfts.rubyforge.org/minitest/MiniTest/Expectations.html)).
-
-If everything looks good, submit a pull request on GitHub and we'll bring in your changes.
+Please see our [Contributing Guide](CONTRIBUTING.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/benchmark.rb

@@ -0,0 +1,16 @@
+require "rubygems"
+require "bundler/setup"
+require "recurly"
+require "benchmark"
+
+N = 1_000
+
+account_body = "{\"id\":\"ljvmmbjchtgs\",\"object\":\"account\",\"code\":\"9ebd49f7288@example.com\",\"parent_account_id\":null,\"bill_to\":\"self\",\"state\":\"active\",\"username\":null,\"email\":null,\"cc_emails\":null,\"preferred_locale\":null,\"first_name\":\"Benjamin\",\"last_name\":\"Du Monde\",\"company\":null,\"vat_number\":null,\"tax_exempt\":false,\"exemption_certificate\":null,\"address\":null,\"billing_info\":null,\"shipping_addresses\":[{\"object\":\"shipping_address\",\"first_name\":\"Benjamin\",\"last_name\":\"Du Monde\",\"company\":null,\"phone\":null,\"street1\":\"1 Tchoupitoulas St\",\"street2\":null,\"city\":\"New Orleans\",\"region\":\"LA\",\"postal_code\":\"70115\",\"country\":\"US\",\"nickname\":\"Home\",\"email\":null,\"vat_number\":null,\"id\":\"ljvmmbk9e1as\",\"account_id\":\"ljvmmbjchtgs\",\"created_at\":\"2019-09-19T22:45:59Z\",\"updated_at\":\"2019-09-19T22:45:59Z\"}],\"custom_fields\":[],\"hosted_login_token\":\"PSvcHow5H4HGEGKTfHXadLNoDcRaDVMK\",\"created_at\":\"2019-09-19T22:45:59Z\",\"updated_at\":\"2019-09-19T22:45:59Z\",\"deleted_at\":null}"
+
+Benchmark.bm do |benchmark|
+  benchmark.report("JSON parsing and casting\n") do
+    N.times do
+      _account = Recurly::JSONParser.parse(nil, account_body)
+    end
+  end
+end