rtx-api 0.4.3 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e0b63f758c0c2bca1e1d6746d9b046c7a8d39bdc
-  data.tar.gz: 57790164cc08bfdd07d12e8a60a01eb0b2daf605
+SHA256:
+  metadata.gz: f814c532170891e526790baba2601785abab70e68d528d205636193ef0307eec
+  data.tar.gz: 1d95ed32188e0b5adb877df739508ef8e42308656b62df1ee4fec660d5fb17d5
 SHA512:
-  metadata.gz: 8bdbccc1be110d39ac17238786d4c6612a2d21a678a3122677cf206caa329e2783029cc4b50d95ded4fe06555bb01951b68ba713824981eea2c6a5fe2f7a71ac
-  data.tar.gz: 83cb2bf41ed17f9d8afa9c072be126d4b23221c0b689081e058a3b9d0e435cdaebab82d47f795bd27e85542d574dbad8f994c1179ac75910730770d9f5231f05
+  metadata.gz: 57841fbfd405bbcda5f12c04b120720b1a4e9808c403cb160e1c5dc636475e263823bb769af66f7a3ae74acbbd0a767d8612d6fcaed76d00ac2f1aad17593bd7
+  data.tar.gz: a9e930cce3c9654c32e6944ff0e5872a8a97494f6e4dcc12210bc79f67379791a5e347587358dedfa56b011d7f06a2dd63382386f71b2c2029609335e544386d

data/README.md

@@ -18,6 +18,18 @@ By adding `RTX_USER_EMAIL` and `RTX_USER_PASSWORD` to your environment variables
 
 If you using a different url for for the RTX API, you can set the `RTX_API_URL` environment variable to use the appropriate one.
 
+## Testing locally
+
+In order to test changes to your gem without having to release, you can update the Gemfile to point to the local version of the Gem
+
+    gem 'rtx-api', require: 'rtx/api', path: '../rtx-api-client-ruby'
+
+## Releasing new version
+
+Bump the version of the gem within `./lib/rtx/api/version.rb` based on the changes you've made. Once your changes have been merged into master, you can release updated version of your gem. In order to release, you will need to be an owner of the RubyGems project and need to have your API credentials setup in your bash profile. Once complete, run the following command release command. 
+
+    bundle exec rake release
+
 ## Usage
 
 The client is lazily loaded, which means it will not authenticate until you make your initial request. Once the request is performed, we'll store the information for future requests. You will want to use the same instance of the client to perform all of your requests.

data/lib/rtx/api.rb

@@ -8,6 +8,7 @@ require "rtx/api/client"
 # resources
 require "rtx/api/resources"
 require "rtx/api/collection"
+require "rtx/api/collection_v2"
 
 # errors
 require "rtx/api/errors/client_error"

data/lib/rtx/api/client.rb

@@ -59,6 +59,10 @@ module RTX
           if args.size > 0
             attrs = args.last.is_a?(Hash) ? args.pop : {}
           end
+
+          # Use V2 Collection if prefixed with V2
+          return RTX::API::CollectionV2.new(self, method, attrs) if method.to_s.start_with?('v2_')
+
           RTX::API::Collection.new(self, method, attrs)
         end
       end

data/lib/rtx/api/collection_v2.rb

@@ -0,0 +1,130 @@
+module RTX
+  module API
+    class CollectionV2
+      attr_accessor :client, :resource_name, :response, :options
+
+      def initialize(client, resource_name, attrs = {})
+        @client = client
+        @resource_name = resource_name.to_sym
+        @options = symbolize_hash(attrs)
+        @response = {}
+      end
+
+      # Chainable method that allows you to set the per page number of the collection for your request
+      def per_page(num)
+        clear if !num.nil?
+        @options[:per_page] = num
+        self
+      end
+
+      # Returns all data associated with the existing response
+      def data
+        client.authenticate if !client.authenticated?
+        collection if !has_response?
+        response[:data]
+      end
+
+      # Returns the paging information about the current response
+      def paging
+        client.authenticate if !client.authenticated?
+        collection if !has_response?
+        response[:paging]
+      end
+
+      # For moving forward one page with the collection
+      def next
+        if has_next?
+          next_page(after_token)
+        end
+        self
+      end
+
+      # For moving backward one page with the collection
+      def prev
+        if has_previous?
+          previous_page(before_token)
+        end
+        self
+      end
+
+      # Responds true if the collection has another page ahead of it
+      def has_next?
+        !after_token.nil?
+      end
+
+      # Responds true if the collection has a previous one
+      def has_previous?
+        !before_token.nil?
+      end
+
+      # Allows you to loop through all of the pages and retrieve the records
+      def all_pages(&block)
+        loop do
+          # Return first page
+          block.call(data)
+
+          # No need to continue if all data is retrieved
+          break unless has_next?
+
+          # Navigate to the next page
+          self.next
+        end
+      end
+
+      # Allows you to loop through all of the resources within the pages specified and retrieve the records
+      def all_resources(&block)
+        all_pages do |page|
+          page.each do |resource|
+            block.call(resource)
+          end
+        end
+      end
+
+      protected
+
+      # Chainable method that allows you to get the next page for a given after token
+      def next_page(after_token)
+        clear
+        @options[:after] = after_token
+        self
+      end
+
+      # Chainable method that allows you to get the previous page for a given before token
+      def previous_page(before_token)
+        clear
+        @options[:before] = before_token
+        self
+      end
+
+      def after_token
+        return nil if paging.nil?
+        return nil if paging[:cursors].nil?
+
+        paging[:cursors][:after]
+      end
+
+      def before_token
+        return nil if paging.nil?
+        return nil if paging[:cursors].nil?
+
+        paging[:cursors][:before]
+      end
+
+      def clear
+        @response = {}
+      end
+
+      def collection
+        @response = client.collection(resource_name, options)
+      end
+
+      def has_response?
+        response != {}
+      end
+
+      def symbolize_hash(hash)
+        Hash[hash.map{|(key,value)| [key.to_sym,value]}]
+      end
+    end
+  end
+end

data/lib/rtx/api/resources.rb

@@ -40,7 +40,9 @@ module RTX
           urls: 'urls',
           users: 'users',
           user_types: 'user_types',
-          whitelabels: 'whitelabels'
+          whitelabels: 'whitelabels',
+          v2_reviews: 'v2/reviews',
+          v2_reviews_csv: 'v2/reviews_csv'
         }.freeze
       end
       # rubocop:enable Metrics/MethodLength

data/lib/rtx/api/version.rb

@@ -2,6 +2,6 @@
 
 module RTX
   module API
-    VERSION = '0.4.3'
+    VERSION = '0.5.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtx-api
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.5.0
 platform: ruby
 authors:
 - Review Trackers Engineering
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-01 00:00:00.000000000 Z
+date: 2020-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -83,6 +83,7 @@ files:
 - lib/rtx/api.rb
 - lib/rtx/api/client.rb
 - lib/rtx/api/collection.rb
+- lib/rtx/api/collection_v2.rb
 - lib/rtx/api/errors/authentication_error.rb
 - lib/rtx/api/errors/client_error.rb
 - lib/rtx/api/errors/invalid_resource_error.rb
@@ -110,8 +111,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 3.1.1
 signing_key: 
 specification_version: 4
 summary: Ruby Client for the Review Trackers RTX API.