stripe 5.55.0 → 18.2.0.pre.beta.1

data/CODE_OF_CONDUCT.md

@@ -1,77 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to make participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies within all project spaces, and it also applies when
-an individual is representing the project or its community in public spaces.
-Examples of representing a project or community include using an official
-project e-mail address, posting via an official social media account, or acting
-as an appointed representative at an online or offline event. Representation of
-a project may be further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at conduct@stripe.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq
-

data/CONTRIBUTORS

@@ -1,3 +0,0 @@
-Greg Brockman <gdb@gregbrockman.com>
-Ross Boucher <rboucher@gmail.com>
-Bradley Grzesiak <brad@bendyworks.com>

data/Gemfile

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-gemspec
-
-group :development do
-  gem "mocha", "~> 0.13.2"
-  gem "rack", ">= 2.0.6"
-  gem "rake"
-
-  # Update to 2.0.0 once it ships.
-  gem "shoulda-context", "2.0.0.rc4"
-
-  gem "test-unit"
-
-  # Version doesn't matter that much, but this one contains some fixes for Ruby
-  # 2.7 warnings that add noise to the test suite.
-  gem "webmock", ">= 3.8.0"
-
-  # Rubocop changes pretty quickly: new cops get added and old cops change
-  # names or go into new namespaces. This is a library and we don't have
-  # `Gemfile.lock` checked in, so to prevent good builds from suddenly going
-  # bad, pin to a specific version number here. Try to keep this relatively
-  # up-to-date, but it's not the end of the world if it's not.
-  gem "rubocop", "0.80"
-
-  platforms :mri do
-    gem "byebug"
-    gem "pry"
-    gem "pry-byebug"
-  end
-end

data/History.txt

@@ -1 +0,0 @@
-History.txt has been converted to a formal changelog. Please see CHANGELOG.md.

data/LICENSE

@@ -1,21 +0,0 @@
-The MIT License
-
-Copyright (c) 2011- Stripe, Inc. (https://stripe.com)
-
-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/Makefile

@@ -1,7 +0,0 @@
-.PHONY: update-version codegen-format
-update-version:
-	@echo "$(VERSION)" > VERSION
-	@perl -pi -e 's|VERSION = "[.\d]+"|VERSION = "$(VERSION)"|' lib/stripe/version.rb
-
-codegen-format:
-	bundle exec rubocop -o /dev/null --auto-correct

data/README.md

@@ -1,350 +0,0 @@
-# Stripe Ruby Library
-
-[![Gem Version](https://badge.fury.io/rb/stripe.svg)](https://badge.fury.io/rb/stripe)
-[![Build Status](https://travis-ci.org/stripe/stripe-ruby.svg?branch=master)](https://travis-ci.org/stripe/stripe-ruby)
-
-The Stripe Ruby library provides convenient access to the Stripe API from
-applications written in the Ruby language. It includes a pre-defined set of
-classes for API resources that initialize themselves dynamically from API
-responses which makes it compatible with a wide range of versions of the Stripe
-API.
-
-The library also provides other features. For example:
-
-- Easy configuration path for fast setup and use.
-- Helpers for pagination.
-- Built-in mechanisms for the serialization of parameters according to the
-  expectations of Stripe's API.
-
-## Documentation
-
-See the [Ruby API docs](https://stripe.com/docs/api?lang=ruby).
-
-See [video demonstrations][youtube-playlist] covering how to use the library.
-
-
-## Installation
-
-You don't need this source code unless you want to modify the gem. If you just
-want to use the package, just run:
-
-```sh
-gem install stripe
-```
-
-If you want to build the gem from source:
-
-```sh
-gem build stripe.gemspec
-```
-
-### Requirements
-
-- Ruby 2.3+.
-
-### Bundler
-
-If you are installing via bundler, you should be sure to use the https rubygems
-source in your Gemfile, as any gems fetched over http could potentially be
-compromised in transit and alter the code of gems fetched securely over https:
-
-```ruby
-source 'https://rubygems.org'
-
-gem 'rails'
-gem 'stripe'
-```
-
-## Usage
-
-The library needs to be configured with your account's secret key which is
-available in your [Stripe Dashboard][api-keys]. Set `Stripe.api_key` to its
-value:
-
-```ruby
-require 'stripe'
-Stripe.api_key = 'sk_test_...'
-
-# list customers
-Stripe::Customer.list()
-
-# retrieve single customer
-Stripe::Customer.retrieve('cus_123456789')
-```
-
-### Per-request Configuration
-
-For apps that need to use multiple keys during the lifetime of a process, like
-one that uses [Stripe Connect][connect], it's also possible to set a
-per-request key and/or account:
-
-```ruby
-require "stripe"
-
-Stripe::Customer.list(
-  {},
-  {
-    api_key: 'sk_test_...',
-    stripe_account: 'acct_...',
-    stripe_version: '2018-02-28',
-  }
-)
-
-Stripe::Customer.retrieve(
-  'cus_123456789',
-  {
-    api_key: 'sk_test_...',
-    stripe_account: 'acct_...',
-    stripe_version: '2018-02-28',
-  }
-)
-
-Stripe::Customer.retrieve(
-  {
-    id: 'cus_123456789',
-    expand: %w(balance_transaction)
-  },
-  {
-    stripe_version: '2018-02-28',
-    api_key: 'sk_test_...',
-  }
-)
-
-Stripe::Customer.capture(
-  'cus_123456789',
-  {},
-  {
-    stripe_version: '2018-02-28',
-    api_key: 'sk_test_...',
-  }
-)
-```
-
-Keep in mind that there are different method signatures depending on the action:
-
-- When operating on a collection (e.g. `.list`, `.create`) the method signature is
-  `method(params, opts)`.
-- When operating on resource (e.g. `.capture`, `.update`) the method signature is
-  `method(id, params, opts)`.
-- One exception is that `retrieve`, despite being an operation on a resource, has the signature
-  `retrieve(id, opts)`. In addition, it will accept a Hash for the `id` param but will extract the
-  `id` key out and use the others as options.
-
-### Accessing a response object
-
-Get access to response objects by initializing a client and using its `request`
-method:
-
-```ruby
-client = Stripe::StripeClient.new
-customer, resp = client.request do
-  Stripe::Customer.retrieve('cus_123456789',)
-end
-puts resp.request_id
-```
-
-### Configuring a proxy
-
-A proxy can be configured with `Stripe.proxy`:
-
-```ruby
-Stripe.proxy = 'https://user:pass@example.com:1234'
-```
-
-### Configuring an API Version
-
-By default, the library will use the API version pinned to the account making
-a request. This can be overridden with this global option:
-
-```ruby
-Stripe.api_version = '2018-02-28'
-```
-
-See [versioning in the API reference][versioning] for more information.
-
-### Configuring CA Bundles
-
-By default, the library will use its own internal bundle of known CA
-certificates, but it's possible to configure your own:
-
-```ruby
-Stripe.ca_bundle_path = 'path/to/ca/bundle'
-```
-
-### Configuring Automatic Retries
-
-You can enable automatic retries on requests that fail due to a transient
-problem by configuring the maximum number of retries:
-
-```ruby
-Stripe.max_network_retries = 2
-```
-
-Various errors can trigger a retry, like a connection error or a timeout, and
-also certain API responses like HTTP status `409 Conflict`.
-
-[Idempotency keys][idempotency-keys] are added to requests to guarantee that
-retries are safe.
-
-### Configuring Timeouts
-
-Open, read and write timeouts are configurable:
-
-```ruby
-Stripe.open_timeout = 30 # in seconds
-Stripe.read_timeout = 80
-Stripe.write_timeout = 30 # only supported on Ruby 2.6+
-```
-
-Please take care to set conservative read timeouts. Some API requests can take
-some time, and a short timeout increases the likelihood of a problem within our
-servers.
-
-### Logging
-
-The library can be configured to emit logging that will give you better insight
-into what it's doing. The `info` logging level is usually most appropriate for
-production use, but `debug` is also available for more verbosity.
-
-There are a few options for enabling it:
-
-1. Set the environment variable `STRIPE_LOG` to the value `debug` or `info`:
-
-   ```sh
-   $ export STRIPE_LOG=info
-   ```
-
-2. Set `Stripe.log_level`:
-
-   ```ruby
-   Stripe.log_level = Stripe::LEVEL_INFO
-   ```
-
-### Instrumentation
-
-The library has various hooks that user code can tie into by passing a block to
-`Stripe::Instrumentation.subscribe` to be notified about specific events.
-
-#### `request_begin`
-
-Invoked when an HTTP request starts. Receives `RequestBeginEvent` with the
-following properties:
-
-- `method`: HTTP method. (`Symbol`)
-- `path`: Request path. (`String`)
-- `user_data`: A hash on which users can set arbitrary data, and which will be
-  passed through to `request_end` invocations. This could be used, for example,
-  to assign unique IDs to each request, and it'd work even if many requests are
-  running in parallel. All subscribers share the same object for any particular
-  request, so they must be careful to use unique keys that will not conflict
-  with other subscribers. (`Hash`)
-
-#### `request_end`
-
-Invoked when an HTTP request finishes, regardless of whether it terminated with
-a success or error. Receives `RequestEndEvent` with the following properties:
-
-- `duration`: Request duration in seconds. (`Float`)
-- `http_status`: HTTP response code (`Integer`) if available, or `nil` in case
-  of a lower level network error.
-- `method`: HTTP method. (`Symbol`)
-- `num_retries`: The number of retries. (`Integer`)
-- `path`: Request path. (`String`)
-- `user_data`: A hash on which users may have set arbitrary data in
-  `request_begin`. See above for more information. (`Hash`)
-- `request_id`. HTTP request identifier.
-
-#### Example
-
-For example:
-
-```ruby
-Stripe::Instrumentation.subscribe(:request_end) do |request_event|
-  tags = {
-    method: request_event.method,
-    resource: request_event.path.split('/')[2],
-    code: request_event.http_status,
-    retries: request_event.num_retries
-  }
-  StatsD.distribution('stripe_request', request_event.duration, tags: tags)
-end
-```
-
-### Writing a Plugin
-
-If you're writing a plugin that uses the library, we'd appreciate it if you
-identified using `#set_app_info`:
-
-```ruby
-Stripe.set_app_info('MyAwesomePlugin', version: '1.2.34', url: 'https://myawesomeplugin.info')
-```
-
-This information is passed along when the library makes calls to the Stripe
-API.
-
-### Request latency telemetry
-
-By default, the library sends request latency telemetry to Stripe. These
-numbers help Stripe improve the overall latency of its API for all users.
-
-You can disable this behavior if you prefer:
-
-```ruby
-Stripe.enable_telemetry = false
-```
-
-## Development
-
-The test suite depends on [stripe-mock], so make sure to fetch and run it from a
-background terminal ([stripe-mock's README][stripe-mock] also contains
-instructions for installing via Homebrew and other methods):
-
-```sh
-go get -u github.com/stripe/stripe-mock
-stripe-mock
-```
-
-Run all tests:
-
-```sh
-bundle exec rake test
-```
-
-Run a single test suite:
-
-```sh
-bundle exec ruby -Ilib/ test/stripe/util_test.rb
-```
-
-Run a single test:
-
-```sh
-bundle exec ruby -Ilib/ test/stripe/util_test.rb -n /should.convert.names.to.symbols/
-```
-
-Run the linter:
-
-```sh
-bundle exec rake rubocop
-```
-
-Update bundled CA certificates from the [Mozilla cURL release][curl]:
-
-```sh
-bundle exec rake update_certs
-```
-
-Update the bundled [stripe-mock] by editing the version number found in
-`.travis.yml`.
-
-[api-keys]: https://dashboard.stripe.com/account/apikeys
-[connect]: https://stripe.com/connect
-[curl]: http://curl.haxx.se/docs/caextract.html
-[idempotency-keys]: https://stripe.com/docs/api/idempotent_requests?lang=ruby
-[stripe-mock]: https://github.com/stripe/stripe-mock
-[versioning]: https://stripe.com/docs/api/versioning?lang=ruby
-[youtube-playlist]: https://www.youtube.com/playlist?list=PLy1nL-pvL2M50RmP6ie-gdcSnfOuQCRYk
-
-<!--
-# vim: set tw=79:
--->

data/Rakefile

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-require "rake/testtask"
-require "rubocop/rake_task"
-
-task default: %i[test rubocop]
-
-Rake::TestTask.new do |t|
-  t.pattern = "./test/**/*_test.rb"
-end
-
-RuboCop::RakeTask.new
-
-desc "Update bundled certs"
-task :update_certs do
-  require "net/http"
-  require "uri"
-
-  fetch_file "https://curl.haxx.se/ca/cacert.pem",
-             ::File.expand_path("../lib/data/ca-certificates.crt", __FILE__)
-end
-
-#
-# helpers
-#
-
-def fetch_file(uri, dest)
-  ::File.open(dest, "w") do |file|
-    resp = Net::HTTP.get_response(URI.parse(uri))
-    unless resp.code.to_i == 200
-      abort("bad response when fetching: #{uri}\n" \
-        "Status #{resp.code}: #{resp.body}")
-    end
-    file.write(resp.body)
-    puts "Successfully fetched: #{uri}"
-  end
-end

data/VERSION

@@ -1 +0,0 @@
-5.55.0

data/lib/stripe/resources/bitcoin_receiver.rb

@@ -1,24 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-module Stripe
-  # Directly creating or retrieving BitcoinReceivers is deprecated. Please use
-  # the Sources API instead: https://stripe.com/docs/sources/bitcoin
-  class BitcoinReceiver < APIResource
-    extend Stripe::APIOperations::List
-
-    OBJECT_NAME = "bitcoin_receiver"
-
-    def self.resource_url
-      "/v1/bitcoin/receivers"
-    end
-
-    def resource_url
-      if respond_to?(:customer) && !customer.nil? && customer != ""
-        "#{Customer.resource_url}/#{CGI.escape(customer)}/sources/#{CGI.escape(id)}"
-      else
-        "#{self.class.resource_url}/#{CGI.escape(id)}"
-      end
-    end
-  end
-end

data/lib/stripe/resources/bitcoin_transaction.rb

@@ -1,16 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-module Stripe
-  # Directly retrieving BitcoinTransactions is deprecated. Please use
-  # the Sources API instead: https://stripe.com/docs/sources/bitcoin
-  class BitcoinTransaction < APIResource
-    extend Stripe::APIOperations::List
-
-    OBJECT_NAME = "bitcoin_transaction"
-
-    def self.resource_url
-      "/v1/bitcoin/transactions"
-    end
-  end
-end

data/lib/stripe/resources/order_return.rb

@@ -1,10 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-module Stripe
-  class OrderReturn < APIResource
-    extend Stripe::APIOperations::List
-
-    OBJECT_NAME = "order_return"
-  end
-end

data/lib/stripe/resources/recipient.rb

@@ -1,14 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-module Stripe
-  # Recipients objects are deprecated. Please use Stripe Connect instead.
-  class Recipient < APIResource
-    extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Delete
-    extend Stripe::APIOperations::List
-    include Stripe::APIOperations::Save
-
-    OBJECT_NAME = "recipient"
-  end
-end

data/lib/stripe/resources/sku.rb

@@ -1,13 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-module Stripe
-  class SKU < APIResource
-    extend Stripe::APIOperations::Create
-    include Stripe::APIOperations::Delete
-    extend Stripe::APIOperations::List
-    include Stripe::APIOperations::Save
-
-    OBJECT_NAME = "sku"
-  end
-end

data/lib/stripe/resources/three_d_secure.rb

@@ -1,14 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-module Stripe
-  class ThreeDSecure < APIResource
-    extend Stripe::APIOperations::Create
-
-    OBJECT_NAME = "three_d_secure"
-
-    def self.resource_url
-      "/v1/3d_secure"
-    end
-  end
-end

data/stripe.gemspec

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-$LOAD_PATH.unshift(::File.join(::File.dirname(__FILE__), "lib"))
-
-require "stripe/version"
-
-Gem::Specification.new do |s|
-  s.name = "stripe"
-  s.version = Stripe::VERSION
-  s.required_ruby_version = ">= 2.3.0"
-  s.summary = "Ruby bindings for the Stripe API"
-  s.description = "Stripe is the easiest way to accept payments online.  " \
-                  "See https://stripe.com for details."
-  s.author = "Stripe"
-  s.email = "support@stripe.com"
-  s.homepage = "https://stripe.com/docs/api?lang=ruby"
-  s.license = "MIT"
-
-  s.metadata = {
-    "bug_tracker_uri" => "https://github.com/stripe/stripe-ruby/issues",
-    "changelog_uri" =>
-      "https://github.com/stripe/stripe-ruby/blob/master/CHANGELOG.md",
-    "documentation_uri" => "https://stripe.com/docs/api?lang=ruby",
-    "github_repo" => "ssh://github.com/stripe/stripe-ruby",
-    "homepage_uri" => "https://stripe.com/docs/api?lang=ruby",
-    "source_code_uri" => "https://github.com/stripe/stripe-ruby",
-  }
-
-  ignored = Regexp.union(
-    /\A\.editorconfig/,
-    /\A\.git/,
-    /\A\.rubocop/,
-    /\A\.travis.yml/,
-    /\A\.vscode/,
-    /\Atest/
-  )
-  s.files = `git ls-files`.split("\n").reject { |f| ignored.match(f) }
-  s.executables   = `git ls-files -- bin/*`.split("\n")
-                                           .map { |f| ::File.basename(f) }
-  s.require_paths = ["lib"]
-end