patch_ruby 1.0.0.pre → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: adcc2ae16ffd8f1fae30c7231ea100282a46b9cb59fa04ef855d37b3c0269b7e
-  data.tar.gz: 87c2e5a75eec03a3d05ccca1bc74201e658f3d1bf1a0eec3759b7df3c6815c77
+  metadata.gz: e4c502af4271525d9883ffe131279f065edd0a089adcb0acc104271ee427e86a
+  data.tar.gz: 0ec3666b9e93a7ad36a810c3d07ed53e1a46162eb566c04f473a572646881405
 SHA512:
-  metadata.gz: 0d8c3b806824a51b72215cab36372c1608e46c02b3e6ea007f060871da0c3e22e943edffc7484cbe9a9d551685bedd3e14e2eb35b3655e38dd6cfec8f9abcca6
-  data.tar.gz: b66e6323bfa7932d43d3865b28bc9e09d3cac9a14daa5177fe7a0c1bc5355403e64aed6cee1ba126c5c1fcf3b7c01152dd25408cb7add2742ddf07e20977c129
+  metadata.gz: bcd3e4e634cb5faeeedcc9d3516b075858738d43cb8c1565000b15f95f2539a60d28e48df695030c31499fbeb83e06540a7f485fff4ddc27786ff01028795a9f
+  data.tar.gz: eb808b4ca051b0922ffbcb9a98cd50be35795d0beaa01d3bc0811cf39eca0744dc249a4cd289e98761bb1e30673b880eabc135262e0008ac24c7421880a08013

data/Gemfile

@@ -6,5 +6,4 @@ group :development, :test do
   gem 'rake', '~> 13.0.1'
   gem 'pry-byebug'
   gem 'rubocop', '~> 0.66.0'
-  gem 'vcr', '~> 6.0'
 end

data/Gemfile.lock

@@ -55,7 +55,6 @@ GEM
     typhoeus (1.4.0)
       ethon (>= 0.9.0)
     unicode-display_width (1.5.0)
-    vcr (6.0.0)
 
 PLATFORMS
   ruby
@@ -66,7 +65,6 @@ DEPENDENCIES
   rake (~> 13.0.1)
   rspec (~> 3.6, >= 3.6.0)
   rubocop (~> 0.66.0)
-  vcr (~> 6.0)
 
 BUNDLED WITH
    2.1.4

data/README.md

@@ -1,11 +1,11 @@
-# Patch ruby
+# Patch Ruby SDK
 ![Test](https://github.com/patch-technology/patch-ruby/workflows/Test/badge.svg)
+[![Gem Version](https://badge.fury.io/rb/patch_ruby.svg)](https://badge.fury.io/rb/patch_ruby)
 
 The official Ruby gem for the [Patch API](https://www.usepatch.com)
 
 ## Documentation
-
-For detailed documentation and examples, see the [Patch API docs](https://www.usepatch.com).
+For a complete API reference, check out [Patch's API Reference.](https://docs.usepatch.com/docs/patch/openapi/v1/swagger.yaml)
 
 ## Installation
 
@@ -29,6 +29,8 @@ gem install patch_ruby
 
 ## Usage
 
+### Configuration
+
 After installing the gem, you'll have to configure it with your API key which is available from the API key page in the Patch dashboard:
 ```ruby
 require 'patch_ruby'
@@ -39,16 +41,90 @@ Patch.configure do |config|
 end
 ```
 
-Once configured, you can test it out:
+### Orders
+In Patch, orders represent a purchase of carbon offsets or negative emissions by mass. Place orders directly if you know the amount of carbon dioxide you would like to sequester. If you do not know how much to purchase, use an estimate.
+
+[API Reference](https://docs.usepatch.com/docs/patch/openapi/v1/swagger.yaml/paths/~1v1~1orders/get)
+
+#### Examples
 ```ruby
-begin
-  orders_response = Patch::Order.retrieve_orders
-
-  orders_response.data.each do |order|
-    puts "Order ID: #{order.id}, Order State: #{order.state}"
-  end
-# Rescue from any Patch API errors
-rescue Patch::ApiError => e
-  puts "Failed to retrieve Orders with status code #{e.code}: #{e.message}"
-end
+# Create an order
+mass = 1_000_000 # Pass in the mass in grams (i.e. 1 metric tonne)
+Patch::Order.create_order(mass_g: mass)
+
+# Retrieve an order
+order_id = 'ord_test_1234' # Pass in the order's id
+Patch::Order.retrieve_order(order_id)
+
+# Place an order
+order_id = 'ord_test_1234' # Pass in the order's id
+Patch::Order.place_order(order_id)
+
+# Cancel an order
+order_id = 'ord_test_1234' # Pass in the order's id
+Patch::Order.cancel_order(order_id)
+
+# Retrieve a list of orders
+page = 1 # Pass in which page of orders you'd like
+Patch::Order.retrieve_orders(page: page)
+```
+
+### Estimates
+Estimates allow API users to get a quote for the cost of compensating a certain amount of CO2. When creating an estimate, an order in the `draft` state will also be created, reserving the allocation of a project for 5 minutes. If you don't place your draft order within those 5 minutes, the order will automatically be cancelled.
+
+[API Reference](https://docs.usepatch.com/docs/patch/openapi/v1/swagger.yaml/paths/~1v1~1estimates/get)
+
+#### Examples
+```ruby
+# Create an estimate
+mass = 1_000_000 # Pass in the mass in grams (i.e. 1 metric tonne)
+Patch::Estimate.create_mass_estimate(mass_g: mass)
+
+# Retrieve an estimate
+estimate_id = 'est_test_1234'
+Patch::Estimate.retrieve_estimate(estimate_id)
+
+# Retrieve a list of estimates
+page = 1 # Pass in which page of estimates you'd like
+Patch::Estimate.retrieve_estimates(page: page)
+```
+
+### Projects
+Projects are the ways Patch takes CO2 out of the air. They can represent reforestation, enhanced weathering, direct air carbon capture, etc. When you place an order via Patch, it is allocated to a project.
+
+[API Reference](https://docs.usepatch.com/docs/patch/openapi/v1/swagger.yaml/paths/~1v1~1projects/get)
+
+#### Examples
+```ruby
+# Retrieve a project
+project_id = 'pro_test_1234' # Pass in the project's ID
+Patch::Project.retrieve_project(project_id)
+
+# Retrieve a list of projects
+page = 1 # Pass in which page of projects you'd like
+Patch::Project.retrieve_projects(page: page)
+```
+
+### Preferences
+Preferences are how you route your orders in Patch. If you don't have a preference, Patch will allocate your order to the least expensive option. If you do have a preference, all of your orders will be sent to that project. You can set your preferences via API, or through the [Patch Dashboard](dashboard.usepatch.com/projects).
+
+[API Reference](https://docs.usepatch.com/docs/patch/openapi/v1/swagger.yaml/paths/~1v1~1preferences/post)
+
+#### Examples
+```ruby
+# Create a preference
+project_id = 'pro_test_1234' # Pass in the project_id for your preference
+Patch::Preference.create_preference(project_id: project_id)
+
+# Retrieve a preference
+preference_id = 'pre_test_1234' # Pass in the preferences's id
+Patch::Preference.retrieve_preference(preference_id)
+
+# Delete a preference
+preference_id = 'pre_test_1234' # Pass in the preferences's id
+Patch::Preference.delete_preference(preference_id)
+
+# Retrieve a list of preferences
+page = 1 # Pass in which page of preferences you'd like
+Patch::Preference.retrieve_preferences(page: page)
 ```

data/lib/patch_ruby/version.rb

@@ -11,5 +11,5 @@ OpenAPI Generator version: 4.3.1
 =end
 
 module Patch
-  VERSION = '1.0.0.pre'
+  VERSION = '1.0.0'
 end

data/spec/api_client_spec.rb

@@ -10,43 +10,22 @@ OpenAPI Generator version: 4.3.1
 
 =end
 
-require 'spec_helper'
-
 describe Patch::ApiClient do
   context 'initialization' do
-    context 'URL stuff' do
-      context 'host' do
-        it 'removes http from host' do
-          Patch.configure { |c| c.host = 'http://example.com' }
-          expect(Patch::Configuration.default.host).to eq('example.com')
-        end
-
-        it 'removes https from host' do
-          Patch.configure { |c| c.host = 'https://wookiee.com' }
-          expect(Patch::ApiClient.default.config.host).to eq('wookiee.com')
-        end
-
-        it 'removes trailing path from host' do
-          Patch.configure { |c| c.host = 'hobo.com/v4' }
-          expect(Patch::Configuration.default.host).to eq('hobo.com')
-        end
+    context 'base_path' do
+      it "prepends a slash to base_path" do
+        Patch.configure { |c| c.base_path = 'v4/dog' }
+        expect(Patch::Configuration.default.base_path).to eq('/v4/dog')
+      end
+
+      it "doesn't prepend a slash if one is already there" do
+        Patch.configure { |c| c.base_path = '/v4/dog' }
+        expect(Patch::Configuration.default.base_path).to eq('/v4/dog')
       end
 
-      context 'base_path' do
-        it "prepends a slash to base_path" do
-          Patch.configure { |c| c.base_path = 'v4/dog' }
-          expect(Patch::Configuration.default.base_path).to eq('/v4/dog')
-        end
-
-        it "doesn't prepend a slash if one is already there" do
-          Patch.configure { |c| c.base_path = '/v4/dog' }
-          expect(Patch::Configuration.default.base_path).to eq('/v4/dog')
-        end
-
-        it "ends up as a blank string if nil" do
-          Patch.configure { |c| c.base_path = nil }
-          expect(Patch::Configuration.default.base_path).to eq('')
-        end
+      it "ends up as a blank string if nil" do
+        Patch.configure { |c| c.base_path = nil }
+        expect(Patch::Configuration.default.base_path).to eq('')
       end
     end
   end

data/spec/integration/estimates_spec.rb

@@ -1,31 +1,26 @@
-require 'spec_helper'
-
 RSpec.describe 'Estimates Integration' do
-  it "supports create, retrieve and list" do
-    VCR.use_cassette('estimates') do
-      # Configure the Patch gem
-      Patch.configure do |config|
-        config.access_token = ENV['PATCH_RUBY_API_KEY']
-        config.host = ENV['PATCH_RUBY_HOST']
-      end
-
-      create_estimate_response = Patch::Estimate.create_mass_estimate(mass_g: 100)
-      estimate_id = create_estimate_response.data.id
+  it 'supports create, retrieve and list' do
+    # Configure the Patch gem
+    Patch.configure do |config|
+      config.access_token = ENV['PATCH_RUBY_API_KEY']
+    end
 
-      retrieve_estimate_response = Patch::Estimate.retrieve_estimate(estimate_id)
-      expect(retrieve_estimate_response.data.id).to eq estimate_id
+    create_estimate_response = Patch::Estimate.create_mass_estimate(mass_g: 100)
+    estimate_id = create_estimate_response.data.id
 
-      page_limit = 1
-      next_page = 1
-      estimates = []
+    retrieve_estimate_response = Patch::Estimate.retrieve_estimate(estimate_id)
+    expect(retrieve_estimate_response.data.id).to eq estimate_id
 
-      while !next_page.nil? && next_page <= page_limit
-        retrieve_estimates_response = Patch::Estimate.retrieve_estimates(page: next_page)
-        next_page = retrieve_estimates_response.meta.next_page
-        estimates += retrieve_estimates_response.data
-      end
+    page_limit = 1
+    next_page = 1
+    estimates = []
 
-      expect(estimates.length).not_to be_zero
+    while !next_page.nil? && next_page <= page_limit
+      retrieve_estimates_response = Patch::Estimate.retrieve_estimates(page: next_page)
+      next_page = retrieve_estimates_response.meta.next_page
+      estimates += retrieve_estimates_response.data
     end
+
+    expect(estimates.length).not_to be_zero
   end
 end

data/spec/integration/orders_spec.rb

@@ -1,53 +1,41 @@
-require 'spec_helper'
-
 RSpec.describe 'Orders Integration' do
-  it "supports create, place, cancel, retrieve and list" do
-    VCR.use_cassette('orders') do
-      # Configure the Patch gem
-      Patch.configure do |config|
-        config.access_token = ENV['PATCH_RUBY_API_KEY']
-        config.host = ENV['PATCH_RUBY_HOST']
-      end
-
-      create_order_response = Patch::Order.create_order(mass_g: 100)
-      order_id = create_order_response.data.id
-
-      retrieve_order_response = Patch::Order.retrieve_order(order_id)
-      expect(retrieve_order_response.data.id).to eq order_id
-
-      # place_order_response = Patch::Order.place_order(order_id)
-      # expect(place_order_response.data.state).to eq 'placed'
+  before do
+    Patch.configure do |config|
+      config.access_token = ENV['PATCH_RUBY_API_KEY']
+    end
+  end
 
-      # place_order_response = Patch::Order.cancel_order(order_id)
-      # expect(place_order_response.data.state).to eq 'cancelled'
+  it 'supports create, place, cancel, retrieve and list' do
+    create_order_response = Patch::Order.create_order(mass_g: 100)
+    order_id = create_order_response.data.id
 
-      page_limit = 1
-      next_page = 1
-      orders = []
+    retrieve_order_response = Patch::Order.retrieve_order(order_id)
+    expect(retrieve_order_response.data.id).to eq order_id
 
-      while !next_page.nil? && next_page <= page_limit
-        retrieve_orders_response = Patch::Order.retrieve_orders(page: next_page)
-        next_page = retrieve_orders_response.meta.next_page
-        orders += retrieve_orders_response.data
-      end
+    page_limit = 1
+    next_page = 1
+    orders = []
 
-      expect(orders.length).not_to be_zero
+    while !next_page.nil? && next_page <= page_limit
+      retrieve_orders_response = Patch::Order.retrieve_orders(page: next_page)
+      next_page = retrieve_orders_response.meta.next_page
+      orders += retrieve_orders_response.data
     end
+
+    expect(orders.length).not_to be_zero
   end
 
-  it "supports place and cancel for order created via an estimate" do
-    VCR.use_cassette('estimate_orders') do
-      create_estimate_to_place_response = Patch::Estimate.create_mass_estimate(mass_g: 100)
-      order_to_place_id = create_estimate_to_place_response.data.order.id
+  it 'supports place and cancel for orders created via an estimate' do
+    create_estimate_to_place_response = Patch::Estimate.create_mass_estimate(mass_g: 100)
+    order_to_place_id = create_estimate_to_place_response.data.order.id
 
-      place_order_response = Patch::Order.place_order(order_to_place_id)
-      expect(place_order_response.data.state).to eq 'placed'
+    place_order_response = Patch::Order.place_order(order_to_place_id)
+    expect(place_order_response.data.state).to eq 'placed'
 
-      create_estimate_to_cancel_response = Patch::Estimate.create_mass_estimate(mass_g: 100)
-      order_to_cancel_id = create_estimate_to_cancel_response.data.order.id
+    create_estimate_to_cancel_response = Patch::Estimate.create_mass_estimate(mass_g: 100)
+    order_to_cancel_id = create_estimate_to_cancel_response.data.order.id
 
-      cancel_order_response = Patch::Order.cancel_order(order_to_cancel_id)
-      expect(cancel_order_response.data.state).to eq 'cancelled'
-    end
+    cancel_order_response = Patch::Order.cancel_order(order_to_cancel_id)
+    expect(cancel_order_response.data.state).to eq 'cancelled'
   end
 end

data/spec/integration/preferences_spec.rb

@@ -1,40 +1,34 @@
-require 'spec_helper'
-
 RSpec.describe 'Preferences Integration' do
-  it "supports create, delete, retrieve and list" do
-    VCR.use_cassette('preferences') do
-      # Configure the Patch gem
-      Patch.configure do |config|
-        config.access_token = ENV['PATCH_RUBY_API_KEY']
-        config.host = ENV['PATCH_RUBY_HOST']
-      end
+  before do
+    Patch.configure do |config|
+      config.access_token = ENV['PATCH_RUBY_API_KEY']
+    end
+  end
 
-      retrieve_projects_response = Patch::Project.retrieve_projects
-      expect(retrieve_projects_response.data.length).not_to be_zero
-      project_id = retrieve_projects_response.data.first.id
+  it 'supports create, delete, retrieve and list' do
+    retrieve_projects_response = Patch::Project.retrieve_projects
+    expect(retrieve_projects_response.data.length).not_to be_zero
+    project_id = retrieve_projects_response.data.first.id
 
-      create_preference_response = Patch::Preference.create_preference(project_id: project_id)
-      preference_id = create_preference_response.data.id
+    create_preference_response = Patch::Preference.create_preference(project_id: project_id)
+    preference_id = create_preference_response.data.id
 
-      retrieve_preference_response = Patch::Preference.retrieve_preference(preference_id)
-      expect(retrieve_preference_response.data.id).to eq preference_id
+    retrieve_preference_response = Patch::Preference.retrieve_preference(preference_id)
+    expect(retrieve_preference_response.data.id).to eq preference_id
 
-      # START receive_preferences
-      page_limit = 1
-      next_page = 1
-      preferences = []
+    page_limit = 1
+    next_page = 1
+    preferences = []
 
-      while !next_page.nil? && next_page <= page_limit
-        retrieve_preferences_response = Patch::Preference.retrieve_preferences(page: next_page)
-        next_page = retrieve_preferences_response.meta.next_page
-        preferences += retrieve_preferences_response.data
-      end
+    while !next_page.nil? && next_page <= page_limit
+      retrieve_preferences_response = Patch::Preference.retrieve_preferences(page: next_page)
+      next_page = retrieve_preferences_response.meta.next_page
+      preferences += retrieve_preferences_response.data
+    end
 
-      expect(preferences.length).not_to be_zero
-      # END receive_preferences
+    expect(preferences.length).not_to be_zero
 
-      delete_preference_response = Patch::Preference.delete_preference(preference_id)
-      expect(delete_preference_response.data.id).to eq preference_id
-    end
+    delete_preference_response = Patch::Preference.delete_preference(preference_id)
+    expect(delete_preference_response.data.id).to eq preference_id
   end
 end

data/spec/integration/projects_spec.rb

@@ -1,31 +1,24 @@
-require 'spec_helper'
-
 RSpec.describe 'Projects Integration' do
-  it "supports retrieve and list" do
-    VCR.use_cassette('projects') do
-      # Configure the Patch gem
-      Patch.configure do |config|
-        config.access_token = ENV['PATCH_RUBY_API_KEY']
-        config.host = ENV['PATCH_RUBY_HOST']
-      end
+  Patch.configure do |config|
+    config.access_token = ENV['PATCH_RUBY_API_KEY']
+  end
 
-      # START receive_projects
-      page_limit = 1
-      next_page = 1
-      projects = []
+  it 'supports retrieve and list' do
+    page_limit = 1
+    next_page = 1
+    projects = []
 
-      while !next_page.nil? && next_page <= page_limit
-        retrieve_projects_response = Patch::Project.retrieve_projects(page: next_page)
-        next_page = retrieve_projects_response.meta.next_page
-        projects += retrieve_projects_response.data
-      end
+    while !next_page.nil? && next_page <= page_limit
+      retrieve_projects_response = Patch::Project.retrieve_projects(page: next_page)
+      next_page = retrieve_projects_response.meta.next_page
+      projects += retrieve_projects_response.data
+    end
 
-      expect(projects.length).not_to be_zero
-      project_id = retrieve_projects_response.data.first.id
-      # END receive_projects
+    expect(projects.length).not_to be_zero
+    project_id = retrieve_projects_response.data.first.id
+    # END receive_projects
 
-      retrieve_project_response = Patch::Project.retrieve_project(project_id)
-      expect(retrieve_project_response.data.id).to eq project_id
-    end
+    retrieve_project_response = Patch::Project.retrieve_project(project_id)
+    expect(retrieve_project_response.data.id).to eq project_id
   end
 end