procore 0.8.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7654871c3d9bcf462a38bae7694e54444da0ce52f53276b41baa26ae6440dfb2
-  data.tar.gz: 68ba0f550d88869e4eebd382585df01a232b77ba5f0f84361b16da036a52f242
+  metadata.gz: ab6a771f9ecbd227e500591c59381e08e70b1ad3cea2f82e767b4de2d88664b3
+  data.tar.gz: 1159fa494f5d38ce2d0a0fbcbdb465bf6203e8989a96acf3bcceab915ea9dbac
 SHA512:
-  metadata.gz: b52ad7bec7c5c7aa6d6e658a490a72d6f481c6f0c046aa247d58c703698d02170bb3db241ba801362d1bf8969f55e262ccb665ba5bb11d758c6fbccaaa4da429
-  data.tar.gz: bf2b57f7595b6bf9fabdf9b75246700246e6722176d69502b447b2f264c331a326cef613ca10b215bce93a2d0d19821632480b5391bbb2298d8577daa9f10ce9
+  metadata.gz: e1c9f942d9c8223df00bff8c67b366adc85be3224d2a6ef41ee4e345d40cba8cc0ca71fe0361ff094be1ba358d3ad7ead40fc99d36bba8e5edac0dfc19932c57
+  data.tar.gz: afb9275ad4ec9b1396f3f7bed77317eb39b8e6cacf5d82dc77b38e9a934491e439795fe7df432d27fdc337800b7343327f1cb9d7b70c072ed72244bcd41d6a0a

data/.rubocop.yml

@@ -1,5 +1,9 @@
+require: 
+  - rubocop-rails
+  - rubocop-performance
+
 AllCops:
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.4
   Include:
     - '**/Rakefile'
     - '**/config.ru'
@@ -305,7 +309,7 @@ Style/PerlBackrefs:
 Naming/PredicateName:
   Description: 'Check the names of predicate methods.'
   StyleGuide: 'https://github.com/bbatsov/ruby-style-guide#bool-methods-qmark'
-  NamePrefixBlacklist:
+  ForbiddenPrefixes:
     - is_
   Exclude:
     - spec/**/*
@@ -437,7 +441,7 @@ Style/RedundantBegin:
 
 # Layout
 
-Layout/AlignParameters:
+Layout/ParameterAlignment:
   Description: 'Here we check if the parameters on a multi-line method call or definition are aligned.'
   StyleGuide: 'https://github.com/bbatsov/ruby-style-guide#no-double-indent'
   Enabled: false
@@ -505,7 +509,7 @@ Lint/DeprecatedClassMethods:
   Description: 'Check for deprecated class method calls.'
   Enabled: false
 
-Lint/DuplicatedKey:
+Lint/DuplicateHashKey:
   Description: 'Check for duplicate keys in hash literals.'
   Enabled: false
 
@@ -521,7 +525,7 @@ Lint/FormatParameterMismatch:
   Description: 'The number of parameters to format/sprint must match the fields.'
   Enabled: false
 
-Lint/HandleExceptions:
+Lint/SuppressedException:
   Description: "Don't suppress exception."
   StyleGuide: 'https://github.com/bbatsov/ruby-style-guide#dont-hide-exceptions'
   Enabled: false

data/.travis.yml

@@ -3,9 +3,11 @@ rvm:
   - 2.3
   - 2.4
   - 2.5
+  - 2.6
 
 services:
   - redis-server
+  - memcached
 
 before_install:
   - gem update --system

data/CHANGELOG.md

@@ -1,4 +1,87 @@
-## Unreleased
+## 1.0.0 (January 5, 2021)
+
+* Adds support for API versioning
+
+  *Nate Baer*
+
+### Upgrading
+
+As of v1.0.0, this gem now defaults to making requests against Procore's new
+Rest v1.0 resources, instead of the now deprecated `/vapid` namespace. Example:
+
+```ruby
+# Previously makes a request to
+client.get("me")
+=> app.procore.com/vapid/me
+
+# In 1.0.0
+client.get("me")
+=> app.procore.com/rest/v1.0/me
+```
+
+To keep the legacy behavior, set the new `default_version` configuration option.
+Note, that Rest v1.0 is a superset of the Vapid Api - there are no breaking
+changes. The Vapid API will be decommissioned in December 2021.
+
+[Read more here](https://developers.procore.com/documentation/vapid-deprecation)
+
+```ruby
+Procore.configure do |config|
+  ...
+  # Defaults to "v1.0"
+  config.default_version = "vapid"
+  ...
+end
+```
+
+All the request methods (`get`, `post`, `patch`, `put`, `delete`, `sync`) now
+accept an optional version parameter to specify the version at request time.
+
+```ruby
+client.get("me")
+=> https://app.procore.com/rest/v1.0/me
+
+client.get("me", version: "v1.1")
+=> https://app.procore.com/rest/v1.1/me
+
+client.get("me", version: "vapid")
+=> https://app.procore.com/vapid/me
+```
+
+## 0.8.8 (October 17, 2019)
+
+* Expose #sync, a method that enables calling sync-actions
+
+  *Patrick Koperwas*
+
+* Addition of contribution guidelines to README
+
+  *Megan O'Neill*
+
+* Fix TravisCI failures
+
+  *Patrick Koperwas*
+
+## 0.8.7 (April 18, 2019)
+
+* Add api_version to allow calls to procore rest endpoints
+
+  *Shane Means*
+
+## 0.8.6 (May 10, 2018)
+
+* Dalli Store
+
+  *Patrick Koperwas*
+
+* Fix Requestable paths to prevent double slash in URI
+
+    *Megan O'Neill*
+
+## 0.8.5 (May 9, 2018)
+* Rescue Errno::ECONNREFUSED errors and RestClient::ServerBrokeConnection
+
+    *Casey Ochs*
 
 ## 0.8.4 (May 8, 2018)
 

data/README.md

@@ -4,20 +4,24 @@
 
 #### Table of Contents
 - [Installation](#installation)
+- [1.0.0 Release](#1.0.0-release)
 - [Making Requests](#making-requests)
 - [Usage](#usage)
 - [Error Handling](#error-handling)
 - [Pagination](#pagination)
   - [Navigating Through Paginated Results](#navigating-through-paginated-results)
   - [Change Number of Results](#change-number-of-results)
+- [Sync Actions](#sync-actions)
 - [Configuration](#configuration)
 - [Stores](#stores)
   - [Session Store](#session-store)
   - [Redis Store](#redis-store)
+  - [Dalli Store](#dalli-store)
   - [ActiveRecord Store](#activerecord-store)
   - [File Store](#file-store)
   - [Memory Store](#memory-store)
 - [Full Example](#full-example)
+- [Contributing](#contributing)
 
 ## Installation
 
@@ -27,6 +31,11 @@ Add this line to your application's Gemfile:
 gem "procore"
 ```
 
+## 1.0.0 Release
+
+v1.0.0 was released on January 5, 2021, and adds support the new Rest v1.0 API.
+See the CHANGELOG for upgrade instructions.
+
 ## Making Requests
 
 At the core of the gem is the `Client` class. Clients are initialized with a
@@ -38,19 +47,27 @@ Stores automatically manage tokens for you - refreshing, revoking and storage
 are abstracted away to make your code as simple as possible. There are several
 different [types of stores](#stores) available to you.
 
-The Client class exposes `#get`, `#post`, `#put`, `#patch` and `#delete` methods
-to you.
+The Client class exposes `#get`, `#post`, `#put`, `#patch`, `#sync` and
+`#delete` methods to you.
 
 ```ruby
-get(path, query: {})
-post(path, body: {}, options: {})
-put(path, body: {}, options: {})
-patch(path, body: {}, options: {})
-delete(path, query: {})
+   get(path, version: "", query: {})
+  post(path, version: "", body: {}, options: {})
+   put(path, version: "", body: {}, options: {})
+ patch(path, version: "", body: {}, options: {})
+delete(path, version: "", query: {})
+  sync(path, version: "", body: {}, options: {})
 ```
 
-All paths are relative - the gem will handle expanding `client.get("me")` to
-`https://app.procore.com/vapid/me`.
+All paths are relative, the gem will handle expanding them. An API version may
+be specified in the `version:` argument, or the default version is used. The
+default version is `v1.0` unless otherwise configured.
+
+| Example | Requested URL |
+| --- | --- |
+| `client.get("me")` | `https://app.procore.com/rest/v1.0/me` |
+| `client.get("me", version: "v1.1")` | `https://app.procore.com/rest/v1.1/me` |
+| `client.get("me", version: "vapid")` | `https://app.procore.com/vapid/me` |
 
 Example Usage:
 
@@ -68,6 +85,19 @@ companies = client.get("companies")
 companies.first[:name] #=> "Procore Company 1"
 ```
 
+To use Procore's older API Vapid by default, the default version can be set in
+either the Gem's [configuration](https://github.com/procore/ruby-sdk#configuration)
+or the client's `options` hash:
+
+```ruby
+client = Procore::Client.new(
+  ...
+  options {
+    default_version: "vapid"
+  }
+)
+```
+
 ## Usage
 
 The first step is to place the user's token into the store. For this example,
@@ -258,6 +288,49 @@ puts first_page.pagination
 Notice that because `per_page` has been set to 250, there are only two pages of
 results (500 resources / 250 page size = 2 pages).
 
+## Sync Actions
+The Sync action enables batch creation or updates to resources using a single
+call. When using a Sync action, the resources to be created or updated can be
+specified by supplying either an `id` or an `origin_id` in the request body.
+Utilizing the `origin_id` attribute for batch operations is often preferable as
+it allows you to easily link to external systems by maintaining your own list of
+unique resource identifiers outside of Procore.
+
+The caller provides an array of hashes, each hash containing the attributes for
+a single resource. The attribute names in each hash match those used by the
+Create and Update actions for the resource. Attributes for a maximum of 1000
+resources within a collection may be passed with each call. The API will always
+return an HTTP status of 200.
+
+The response body contains two attributes - `entities` and `errors`. The
+attributes for each successfully created or updated resource will appear in the
+entities list. The attributes for each resource will match those returned by the
+Show action. For each resource which could not be created or updated, the
+attributes supplied by the caller are present in the errors list, along with an
+additional errors attribute which provides reasons for the failure.
+
+[Continue reading
+here.](https://developers.procore.com/documentation/using-sync-actions)
+
+Example Usage:
+
+```ruby
+client.sync(
+ "projects/sync",
+ body: {
+   updates: [
+    { id: 1, name: "Update 1" },
+    { id: 2, name: "Update 2" },
+    { id: 3, name: "Update 3" },
+    ...
+    ...
+    { id: 5055, name: "Update 5055" },
+   ]
+ },
+ options: { batch_size: 500, company_id: 1 },
+)
+```
+
 ## Configuration
 
 The Procore Gem exposes a configuration with several options.
@@ -272,6 +345,15 @@ Procore.configure do |config|
   # instead of production.
   config.host = ENV.fetch("PROCORE_BASE_API_PATH", "https://app.procore.com")
 
+  # When using #sync action, sets the default batch size to use for chunking
+  # up a request body. Example: if the size is set to 500, and 2,000 updates
+  # are desired, 4 requests will be made. Note, the maximum size is 1000.
+  config.default_batch_size = 500
+
+  # The default API version to use if none is specified in the request.
+  # Should be either "v1.0" (recommended) or "vapid" (legacy).
+  config.default_version = "v1.0"
+
   # Integer: Number of times to retry a failed API call. Reasons an API call
   # could potentially fail:
   # 1. Service is briefly down or unreachable
@@ -313,6 +395,14 @@ Options: `session`: Instance of a Rails session
 
 For applications that want to keep access tokens in the user's session.
 
+:warning:
+We strongly discourage using the session as a token store since the rails
+session is often logged by default to external apps such as bugsnag etc. Be sure
+you are not logging tokens. There is also the possibility that the rails session
+is using a cookie store which, depending on application settings, could be
+unencrypted. Tokens should not be stored client-side if it can be avoided.
+:warning:
+
 ```ruby
 store = Procore::Auth::Stores::Session.new(session: session)
 ```
@@ -331,6 +421,20 @@ The key will usually be the id of the current user.
 store = Procore::Auth::Stores::Redis.new(redis: Redis.new, key: current_user.id)
 ```
 
+### Dalli Store
+
+Options: `dalli`: Instance of Dalli
+Options: `key`: Unique identifier to an access token
+
+For applications which want to store access tokens in memcached using Dalli.
+There's two required options, `dalli` which is an instance of a Dalli client,
+and `key` which is a unique key which will be used to save / retrieve an access
+token.  The key will usually be the id of the current user.
+
+```ruby
+store = Procore::Auth::Stores::Dalli.new(dalli: Dalli.new, key: current_user.id)
+```
+
 ### ActiveRecord Store
 
 Options: `object`: Instance of an ActiveRecord model.
@@ -410,6 +514,27 @@ class ProjectsController
   end
 end
 ```
+## Contributing
+
+To contribute to the gem, please clone the repo and cut a new branch. In the PR update the changelog with a short explanation of what you've changed, and your name under the "Unreleased" section. Example changelog update:
+
+```markdown
+## Unreleased
+
+* Short sentence of what has changed
+
+    *Your Name*
+```
+
+Please **do not** bump the gem version in your PR. This will be done in a follow up PR by the gem maintainers.
+
+### Tests
+
+To run the specs run the following command:
+```bash
+$ bundle exec rake test
+```
+
 
 ## License
 

data/lib/procore.rb

@@ -7,6 +7,7 @@ require "json"
 require "procore/auth/access_token_credentials"
 require "procore/auth/client_credentials"
 require "procore/auth/stores/active_record"
+require "procore/auth/stores/dalli"
 require "procore/auth/stores/file"
 require "procore/auth/stores/memory"
 require "procore/auth/stores/redis"

data/lib/procore/auth/client_credentials.rb

@@ -29,7 +29,7 @@ module Procore
           raise OAuthError.new(e.description, response: e.response)
         rescue Faraday::ConnectionFailed => e
           raise APIConnectionError.new("Connection Error: #{e.message}")
-        rescue URI::BadURIError
+        rescue URI::BadURIError, URI::InvalidURIError
           raise OAuthError.new(
             "Host is not a valid URI. Check your host option to make sure it "   \
             "is a properly formed url",

data/lib/procore/auth/stores/dalli.rb

@@ -0,0 +1,38 @@
+module Procore
+  module Auth
+    module Stores
+      class Dalli
+        attr_reader :key, :dalli
+        def initialize(key:, dalli:)
+          @key = key
+          @dalli = dalli
+        end
+
+        def save(token)
+          dalli.set(dalli_key, token.to_json)
+        end
+
+        def fetch
+          return unless dalli.get(dalli_key)
+
+          token = JSON.parse(dalli.get(dalli_key))
+          Procore::Auth::Token.new(
+            access_token: token["access_token"],
+            refresh_token: token["refresh_token"],
+            expires_at: token["expires_at"],
+          )
+        end
+
+        def delete
+          dalli.delete(dalli_key)
+        end
+
+        private
+
+        def dalli_key
+          "procore-dalli-#{key}"
+        end
+      end
+    end
+  end
+end

data/lib/procore/client.rb

@@ -41,7 +41,7 @@ module Procore
     private
 
     def base_api_path
-      "#{options[:host]}/vapid"
+      "#{options[:host]}"
     end
 
     # @raise [OAuthError] if the store does not have a token stored in it prior

data/lib/procore/configuration.rb

@@ -32,6 +32,15 @@ module Procore
     # @return [String]
     attr_accessor :host
 
+    # @!attribute [rw] default_version
+    # @note defaults to Defaults::DEFAULT_VERSION
+    #
+    # The default API version to use if none is specified in the request.
+    # Should be either "v1.0" (recommended) or "vapid" (legacy).
+    #
+    # @return [String]
+    attr_accessor :default_version
+
     # @!attribute [rw] logger
     # @note defaults to nil
     #
@@ -77,12 +86,26 @@ module Procore
     # @return [String]
     attr_accessor :user_agent
 
+    # @!attribute [rw] default_batch_size
+    # @note defaults to Defaults::BATCH_SIZE
+    #
+    # When using #sync action, sets the default batch size to use for chunking
+    # up a request body. Example, if the size is set to 500 and 2,000 updates
+    # are desired, 4 requests will be made.
+    #
+    # Note: The maximum size is 1,000
+    #
+    # @return [Integer]
+    attr_accessor :default_batch_size
+
     def initialize
+      @default_batch_size = Procore::Defaults::BATCH_SIZE
       @host = Procore::Defaults::API_ENDPOINT
       @logger = nil
       @max_retries = 1
       @timeout = 1.0
       @user_agent = Procore::Defaults::USER_AGENT
+      @default_version = Procore::Defaults::DEFAULT_VERSION
     end
   end
 end

data/lib/procore/defaults.rb

@@ -9,10 +9,17 @@ module Procore
     # Default User Agent header string
     USER_AGENT = "Procore Ruby Gem #{Procore::VERSION}".freeze
 
+    # Default size to use for batch requests
+    BATCH_SIZE = 500
+
+    # Default API version to use
+    DEFAULT_VERSION = "v1.0"
+
     def self.client_options
       {
         host: Procore.configuration.host,
         user_agent: Procore.configuration.user_agent,
+        default_version: Procore.configuration.default_version,
       }
     end
   end

data/lib/procore/requestable.rb

@@ -1,4 +1,5 @@
 require "rest-client"
+require "procore/errors"
 
 module Procore
   # Module which defines HTTP verbs GET, POST, PUT, PATCH and DELETE. Is
@@ -10,7 +11,15 @@ module Procore
   # @example Using #post:
   #   client.post("projects", name: "New Project")
   module Requestable
+    HTTP_EXCEPTIONS = [
+      Errno::ECONNREFUSED,
+      Errno::ECONNRESET,
+      Procore::OAuthError,
+      RestClient::Exceptions::Timeout,
+      RestClient::ServerBrokeConnection,
+    ].freeze
     # @param path [String] URL path
+    # @param version [String] API version
     # @param query [Hash] Query options to pass along with the request
     # @option options [Hash] :company_id
     #
@@ -18,10 +27,12 @@ module Procore
     #   client.get("my_open_items", query: { per_page: 5, filter: {} })
     #
     # @return [Response]
-    def get(path, query: {}, options: {})
+    def get(path, version: nil, query: {}, options: {})
+      full_path = full_path(path, version)
+
       Util.log_info(
         "API Request Initiated",
-        path: "#{base_api_path}/#{path}",
+        path: full_path,
         method: "GET",
         query: query.to_s,
       )
@@ -29,7 +40,7 @@ module Procore
       with_response_handling do
         RestClient::Request.execute(
           method: :get,
-          url: "#{base_api_path}/#{path}",
+          url: full_path,
           headers: headers(options).merge(params: query),
           timeout: Procore.configuration.timeout,
         )
@@ -37,8 +48,9 @@ module Procore
     end
 
     # @param path [String] URL path
+    # @param version [String] API version
     # @param body [Hash] Body parameters to send with the request
-    # @param options [Hash} Extra request options
+    # @param options [Hash] Extra request options
     # @option options [String] :idempotency_token | :company_id
     #
     # @example Usage
@@ -49,10 +61,12 @@ module Procore
     #   )
     #
     # @return [Response]
-    def post(path, body: {}, options: {})
+    def post(path, version: nil, body: {}, options: {})
+      full_path = full_path(path, version)
+
       Util.log_info(
         "API Request Initiated",
-        path: "#{base_api_path}/#{path}",
+        path: full_path,
         method: "POST",
         body: body.to_s,
       )
@@ -60,7 +74,7 @@ module Procore
       with_response_handling(request_body: body) do
         RestClient::Request.execute(
           method: :post,
-          url: "#{base_api_path}/#{path}",
+          url: full_path,
           payload: payload(body),
           headers: headers(options),
           timeout: Procore.configuration.timeout,
@@ -69,18 +83,21 @@ module Procore
     end
 
     # @param path [String] URL path
+    # @param version [String] API version
     # @param body [Hash] Body parameters to send with the request
-    # @param options [Hash} Extra request options
+    # @param options [Hash] Extra request options
     # @option options [String] :idempotency_token | :company_id
     #
     # @example Usage
     #   client.put("dashboards/1/users", body: [1,2,3], options: { company_id: 1 })
     #
     # @return [Response]
-    def put(path, body: {}, options: {})
+    def put(path, version: nil, body: {}, options: {})
+      full_path = full_path(path, version)
+
       Util.log_info(
         "API Request Initiated",
-        path: "#{base_api_path}/#{path}",
+        path: full_path,
         method: "PUT",
         body: body.to_s,
       )
@@ -88,7 +105,7 @@ module Procore
       with_response_handling(request_body: body) do
         RestClient::Request.execute(
           method: :put,
-          url: "#{base_api_path}/#{path}",
+          url: full_path,
           payload: payload(body),
           headers: headers(options),
           timeout: Procore.configuration.timeout,
@@ -97,8 +114,9 @@ module Procore
     end
 
     # @param path [String] URL path
+    # @param version [String] API version
     # @param body [Hash] Body parameters to send with the request
-    # @param options [Hash} Extra request options
+    # @param options [Hash] Extra request options
     # @option options [String] :idempotency_token | :company_id
     #
     # @example Usage
@@ -109,10 +127,12 @@ module Procore
     #   )
     #
     # @return [Response]
-    def patch(path, body: {}, options: {})
+    def patch(path, version: nil, body: {}, options: {})
+      full_path = full_path(path, version)
+
       Util.log_info(
         "API Request Initiated",
-        path: "#{base_api_path}/#{path}",
+        path: full_path,
         method: "PATCH",
         body: body.to_s,
       )
@@ -120,7 +140,7 @@ module Procore
       with_response_handling(request_body: body) do
         RestClient::Request.execute(
           method: :patch,
-          url: "#{base_api_path}/#{path}",
+          url: full_path,
           payload: payload(body),
           headers: headers(options),
           timeout: Procore.configuration.timeout,
@@ -129,6 +149,73 @@ module Procore
     end
 
     # @param path [String] URL path
+    # @param version [String] API version
+    # @param body [Hash] Body parameters to send with the request
+    # @param options [Hash] Extra request options
+    # @option options [String | Integer] :company_id | :batch_size
+    #
+    # @example Usage
+    #   client.sync(
+    #     "projects/sync",
+    #     body: {
+    #       updates: [
+    #        { id: 1, name: "Update 1" },
+    #        { id: 2, name: "Update 2" },
+    #        { id: 3, name: "Update 3" },
+    #        ...
+    #        ...
+    #        { id: 5055, name: "Update 5055" },
+    #       ]
+    #     },
+    #     options: { batch_size: 500, company_id: 1 },
+    #   )
+    #
+    # @return [Response]
+    def sync(path, version: nil, body: {}, options: {})
+      full_path = full_path(path, version)
+
+      batch_size = options[:batch_size] ||
+        Procore.configuration.default_batch_size
+
+      if batch_size > 1000
+        batch_size = 1000
+      end
+
+      Util.log_info(
+        "API Request Initiated",
+        path: full_path,
+        method: "SYNC",
+        batch_size: batch_size,
+      )
+
+      groups = body[:updates].each_slice(batch_size).to_a
+
+      responses = groups.map do |group|
+        batched_body = body.merge(updates: group)
+        with_response_handling(request_body: batched_body) do
+          RestClient::Request.execute(
+            method: :patch,
+            url: full_path,
+            payload: payload(batched_body),
+            headers: headers(options),
+            timeout: Procore.configuration.timeout,
+          )
+        end
+      end
+
+      Procore::Response.new(
+        body: responses.reduce({}) do |combined, response|
+          combined.deep_merge(response.body) { |_, v1, v2| v1 + v2 }
+        end.to_json,
+        headers: responses.map(&:headers).inject({}, &:deep_merge),
+        code: 200,
+        request: responses.last&.request,
+        request_body: body,
+      )
+    end
+
+    # @param path [String] URL path
+    # @param version [String] API version
     # @param query [Hash] Query options to pass along with the request
     # @option options [String] :company_id
     #
@@ -136,10 +223,12 @@ module Procore
     #   client.delete("users/1", query: {}, options: {})
     #
     # @return [Response]
-    def delete(path, query: {}, options: {})
+    def delete(path, version: nil, query: {}, options: {})
+      full_path = full_path(path, version)
+
       Util.log_info(
         "API Request Initiated",
-        path: "#{base_api_path}/#{path}",
+        path: full_path,
         method: "DELETE",
         headers: headers(options),
         query: query.to_s,
@@ -148,7 +237,7 @@ module Procore
       with_response_handling do
         RestClient::Request.execute(
           method: :delete,
-          url: "#{base_api_path}/#{path}",
+          url: full_path,
           headers: headers.merge(params: query),
           timeout: Procore.configuration.timeout,
         )
@@ -163,7 +252,7 @@ module Procore
 
       begin
         result = yield
-      rescue RestClient::Exceptions::Timeout, Errno::ECONNREFUSED, Procore::OAuthError => e
+      rescue *HTTP_EXCEPTIONS => e
         if retries <= Procore.configuration.max_retries
           retries += 1
           sleep 1.5**retries
@@ -277,5 +366,16 @@ module Procore
     def multipart?(body)
       RestClient::Payload::has_file?(body)
     end
+
+    def full_path(path, version)
+      version ||= options[:default_version]
+      if version == "vapid"
+        File.join(base_api_path, "vapid", path)
+      elsif /\Av\d+\.\d+\z/.match?(version)
+        File.join(base_api_path, "rest", version, path)
+      else
+        raise ArgumentError.new "'#{version}' is an invalid Procore API version"
+      end
+    end
   end
 end

data/lib/procore/response.rb

@@ -72,7 +72,7 @@ module Procore
 
     def parse_pagination
       headers[:link].to_s.split(", ").map(&:strip).reduce({}) do |links, link|
-        url, name = link.match(/vapid\/(.*?)>; rel="(\w+)"/).captures
+        url, name = link.match(/(?:vapid|rest\/.*?)\/(.*?)>; rel="(\w+)"/).captures
         links.merge!(name.to_sym => url)
       end
     end

data/lib/procore/version.rb

@@ -1,3 +1,3 @@
 module Procore
-  VERSION = "0.8.4".freeze
+  VERSION = "1.0.0".freeze
 end

data/procore.gemspec

@@ -25,12 +25,15 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "actionpack"
   spec.add_development_dependency "activerecord"
   spec.add_development_dependency "bundler"
+  spec.add_development_dependency "dalli"
   spec.add_development_dependency "fakefs"
   spec.add_development_dependency "minitest"
   spec.add_development_dependency "pry"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "redis"
   spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "rubocop-performance"
+  spec.add_development_dependency "rubocop-rails"
   spec.add_development_dependency "sqlite3"
   spec.add_development_dependency "webmock"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: procore
 version: !ruby/object:Gem::Version
-  version: 0.8.4
+  version: 1.0.0
 platform: ruby
 authors:
 - Procore Engineering
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-05-08 00:00:00.000000000 Z
+date: 2021-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -52,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: dalli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: fakefs
   requirement: !ruby/object:Gem::Requirement
@@ -136,6 +150,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
@@ -227,6 +269,7 @@ files:
 - lib/procore/auth/access_token_credentials.rb
 - lib/procore/auth/client_credentials.rb
 - lib/procore/auth/stores/active_record.rb
+- lib/procore/auth/stores/dalli.rb
 - lib/procore/auth/stores/file.rb
 - lib/procore/auth/stores/memory.rb
 - lib/procore/auth/stores/redis.rb
@@ -260,8 +303,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Procore Ruby Gem