stripe 13.0.0 → 13.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93281cf4747b2cf59d647ef17cbe034031435578c8729c0bf06eab21cfc04c37
-  data.tar.gz: a4e618140b391965e3a8deae7055416435a3cfccd3eaabd8b415d27e38beb4f9
+  metadata.gz: 5bb4e5e3353b792a5253af7a6d02d741f0a889b69e96a862b9dd0e7e4b70e5a4
+  data.tar.gz: a64378a08b23ba357d17d807636bc35e95fe3cf4b72c268960859b6a51b066c5
 SHA512:
-  metadata.gz: 1099c298d6ff0fc5ed0db7064679d88c3fe5a48eafa9575a9220404f8d42d3a06b85f61228446c11fce3f06556fa1049f82f78dfd1bd2b0ae25c4e9bd9e73679
-  data.tar.gz: c9f18b4b29441bae95f73d20787c4fa24f0534a38721e2bf4192956ef7f6ee95ad9f5e83235dba538065e31ea76bdf5fe7340faa7e079b54fe4d7a360a567d42
+  metadata.gz: 3ab94f415b05c7671704c9f2aeb11b0f6f3515eedca50564c1568c1cce37825f3459f6369ca95157f0f0d6252119888b26b1efdea03542250faacffba6c17084
+  data.tar.gz: 6e5f594ae791ed24c0e7b998dd0cf5726d8477c14c3d2cb3395a6fe694e2c0da2d4c27e4bd2523d3f8d464a8016fc5dcff95c1b4d8e396ae9194ae7ebbd51a34

data/CHANGELOG.md

@@ -1,4 +1,15 @@
 # Changelog
+## 13.0.2 - 2024-10-23
+* [#1473](https://github.com/stripe/stripe-ruby/pull/1473) Always return the result of APIResource#refresh in APIResource.retrieve
+  
+  * Fix bug where we would not return the mutated `self` object when calling `APIResource.retrieve`
+
+## 13.0.1 - 2024-10-18
+* [#1471](https://github.com/stripe/stripe-ruby/pull/1471) update object tags for meter-related classes
+  
+  - fixes a bug where the `object` property of the `MeterEvent`, `MeterEventAdjustment`, and `MeterEventSession` didn't match the server.
+* [#1470](https://github.com/stripe/stripe-ruby/pull/1470) Cleaned up examples and added documentation
+
 ## 13.0.0 - 2024-10-01
 * [#1458](https://github.com/stripe/stripe-ruby/pull/1458) Support for APIs in the new API version 2024-09-30.acacia
   

data/README.md

@@ -367,7 +367,7 @@ 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
+go install github.com/stripe/stripe-mock@latest
 stripe-mock
 ```
 

data/VERSION

@@ -1 +1 @@
-13.0.0
+13.0.2

data/examples/README.md

@@ -3,9 +3,14 @@
 From the examples folder, run:
 `RUBYLIB=../lib ruby your_example.rb`
 
+e.g.
+
+`RUBYLIB=../lib ruby thinevent_webhook_handler.rb`
+
 ## Adding a new example
 
 1. Clone new_example.rb
 2. Implement your example
-3. Run it (as per above)
-4. 👍
+3. Fill out the file comment. Include a description and key steps that are being demonstrated.
+4. Run it (as per above)
+5. 👍

data/examples/example_template.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# example_template.py - This is a template for defining new examples.  It is not intended to be used directly.
+#
+# <describe what this example does>
+#
+# In this example, we:
+#   - <key step 1>
+#   - <key step 2
+#   - ...
+#
+# <describe assumptions about the user's stripe account, environment, or configuration;
+# or things to watch out for when running>
+
+require "stripe"
+require "date"
+
+class ExampleTemplate
+  attr_accessor :api_key
+
+  def initialize(api_key)
+    @api_key = api_key
+  end
+
+  def do_something_great
+    puts "Hello World"
+    # client = Stripe::StripeClient.new(api_key)
+    # client.v1
+  end
+end
+
+# Send meter events
+api_key = "{{API_KEY}}"
+
+example = ExampleTemplate.new(api_key)
+example.do_something_great

data/examples/meter_event_stream.rb

@@ -1,5 +1,15 @@
 # frozen_string_literal: true
 
+# meter_event_stream.py - use the high-throughput meter event stream to report create billing meter events.
+#
+# In this example, we:
+#   - create a meter event session and store the session's authentication token
+#   - define an event with a payload
+#   - use the meter_event_stream service accessor in StripeClient to create an event stream that reports this event
+#
+# This example expects a billing meter with an event_name of 'alpaca_ai_tokens'.  If you have
+# a different meter event name, you can change it before running this example.
+
 require "stripe"
 require "date"
 

data/examples/{stripe_webhook_handler.rb → thinevent_webhook_handler.rb}

@@ -1,6 +1,17 @@
 # frozen_string_literal: true
 # typed: false
 
+# thinevent_webhook_handler.rb - receive and process thin events like the
+# v1.billing.meter.error_report_triggered event.
+#
+# In this example, we:
+#     - create a StripeClient called client
+#     - use client.parse_thin_event to parse the received thin event webhook body
+#     - call client.v2.core.events.retrieve to retrieve the full event object
+#     - if it is a V1BillingMeterErrorReportTriggeredEvent event type, call
+#       event.fetchRelatedObject to retrieve the Billing Meter object associated
+#       with the event.
+
 require "stripe"
 require "sinatra"
 

data/lib/stripe/api_resource.rb

@@ -110,7 +110,6 @@ module Stripe
       opts = Util.normalize_opts(opts)
       instance = new(id, opts)
       instance.refresh
-      instance
     end
 
     def request_stripe_object(method:, path:, params:, base_address: :api, opts: {})

data/lib/stripe/resources/v2/billing/meter_event.rb

@@ -6,9 +6,9 @@ module Stripe
     module Billing
       # Fix me empty_doc_string.
       class MeterEvent < APIResource
-        OBJECT_NAME = "billing.meter_event"
+        OBJECT_NAME = "v2.billing.meter_event"
         def self.object_name
-          "billing.meter_event"
+          "v2.billing.meter_event"
         end
       end
     end

data/lib/stripe/resources/v2/billing/meter_event_adjustment.rb

@@ -5,9 +5,9 @@ module Stripe
   module V2
     module Billing
       class MeterEventAdjustment < APIResource
-        OBJECT_NAME = "billing.meter_event_adjustment"
+        OBJECT_NAME = "v2.billing.meter_event_adjustment"
         def self.object_name
-          "billing.meter_event_adjustment"
+          "v2.billing.meter_event_adjustment"
         end
       end
     end

data/lib/stripe/resources/v2/billing/meter_event_session.rb

@@ -5,9 +5,9 @@ module Stripe
   module V2
     module Billing
       class MeterEventSession < APIResource
-        OBJECT_NAME = "billing.meter_event_session"
+        OBJECT_NAME = "v2.billing.meter_event_session"
         def self.object_name
-          "billing.meter_event_session"
+          "v2.billing.meter_event_session"
         end
       end
     end

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "13.0.0"
+  VERSION = "13.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 13.0.0
+  version: 13.0.2
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-10-01 00:00:00.000000000 Z
+date: 2024-10-23 00:00:00.000000000 Z
 dependencies: []
 description: Stripe is the easiest way to accept payments online.  See https://stripe.com
   for details.
@@ -30,9 +30,9 @@ files:
 - Rakefile
 - VERSION
 - examples/README.md
+- examples/example_template.rb
 - examples/meter_event_stream.rb
-- examples/new_example.rb
-- examples/stripe_webhook_handler.rb
+- examples/thinevent_webhook_handler.rb
 - exe/stripe-console
 - lib/data/ca-certificates.crt
 - lib/stripe.rb

data/examples/new_example.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require "stripe"
-require "date"
-
-class NewExample
-  attr_accessor :api_key
-
-  def initialize(api_key)
-    @api_key = api_key
-  end
-
-  def do_something_great
-    puts "Hello World"
-    # client = Stripe::StripeClient.new(api_key)
-    # client.v1
-  end
-end
-
-# Send meter events
-api_key = "{{API_KEY}}"
-
-example = NewExample.new(api_key)
-example.do_something_great