smartsheet 1.3.0 → 2.77.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfdb074b34d136b1e899f676f8cf8807e32bdd662d69bdc5386a8ffe7cfb0f58
-  data.tar.gz: cda02013bf2ea4e3ffa64d4aed6d5b113e0c272cf905e37a28d963584b7b975c
+  metadata.gz: eae914214c09e89c42b784bae587d674d5c2773c8f23a55a5514cf2e5bf89141
+  data.tar.gz: a0494874786cea9674006c2253b9e5b61442c8f07ef861a253570fb33ad1d365
 SHA512:
-  metadata.gz: 07c7a7f66f6b3fe1b5e3bcc18c79eb99fb61462c1cf2b66284398cd24629dd96e97442d9507fa4b1142d22b807983be0d5c9e730e236b6d93b9f4c8decefe49d
-  data.tar.gz: ff81233acec8c754515b60adfa38d9e435ab4669973488e9c20a855f13bfbd1d594a7e2c9f7a3f87d605028186b55ed6a75c83c8b021e1bdb425dcd0d336844d
+  metadata.gz: 48a942ed00e9f71795c17931e4d02cb01b17e2ea9c025d61f13cd9b5b73b4e841b1b73f55c3ef890948579db17a0897f327376d902ae2ee35f5fb2a46e5b484c
+  data.tar.gz: b8193db2c5ee289df790636ac06b437bc2c60c2849caf4acfbfe774d319cad3988a006c12e0b6cd0d41f4925acbcb76006d9291641513d9fbcc945bc08c8510c

data/.travis.yml

@@ -6,8 +6,10 @@ rvm:
 before_install:
   - git clone https://github.com/smartsheet-platform/smartsheet-sdk-tests.git
   - smartsheet-sdk-tests/travis_scripts/install_wiremock.sh
+  - gem uninstall -v '>= 2' -i $(rvm gemdir)@global -ax bundler || true
   - gem install bundler -v 1.15.4
 
+
 script:
   - smartsheet-sdk-tests/travis_scripts/start_wiremock.sh
   - rake test

data/ADVANCED.md

@@ -0,0 +1,79 @@
+# Advanced Topics for the Smartsheet SDK for Ruby
+
+## Event Reporting
+The following sample demonstrates best practices for consuming the event stream returned from the Smartsheet Event Reporting feature. 
+
+The sample uses the `smartsheet_client.events.get` method to request lists of events from the stream. The first request sets the `since` parameter with the point in time (i.e. event occurrence datetime) in the stream from which to start consuming events. The `since` parameter can be set with a datetime value that is either formatted as ISO 8601 (e.g. 2010-01-01T00:00:00Z) or as UNIX epoch (in which case the `numeric_dates` parameter must also be set to `True`. By default the `numeric_dates` parameter is set to `False`).
+
+To consume the next list of events after the initial list of events is returned, set the `stream_position` parameter with the `next_stream_position` attribute obtained from the previous request and don't set the `since` parameter with any values. This is because when using the `get` method, either the `since` parameter or the `stream_position` parameter should be set, but never both. 
+
+Note that the `more_available` attribute in a response indicates whether more events are immediately available for consumption. If events aren't immediately available, they may still be generating so subsequent requests should keep using the same `stream_position` value until the next list of events is retrieved.
+
+Many events have additional information available as a part of the event. That information can be accessed from the data stored in the `additional_details` attribute. Information about the additional details provided can be found [here](https://smartsheet-platform.github.io/api-docs/?ruby#event-reporting).
+
+
+```Ruby
+require 'smartsheet'
+require 'time'
+require 'date'
+require 'pp'
+
+# Initialize the client - use your access token here
+$smartsheet_client = Smartsheet::Client.new(token: '1234')
+# The `client` variable now contains access to all of the APIs
+
+today = (DateTime.now)
+date_week_ago = (today - 7).to_time.utc.iso8601 
+
+
+def get_events(params)
+    result = $smartsheet_client.events.get(params: params)
+    # pp result
+    print_new_sheet_events(result[:data])
+
+    more_events_available = result[:more_available]
+    next_stream_position = result[:next_stream_position]
+    get_next_stream_of_events(more_events_available, next_stream_position)
+end 
+
+# Subsequent calls require the streamPosition property
+def get_next_stream_of_events(more_events_available, next_stream_position)
+    params = {
+        stream_position: next_stream_position,
+        max_count: 1
+    }
+
+    if more_events_available 
+        get_events(params);
+    end
+end 
+
+# This example is looking specifically for new sheet events
+def print_new_sheet_events(data)
+    data.each do |value|
+        # Find all created sheets
+        if value[:object_type] == "SHEET" && value[:action] == "CREATE"
+            pp value
+        end
+        
+    end
+end 
+
+
+begin
+    params = {
+        since: date_week_ago,
+        max_count: 1
+    }
+
+    # The first call to the events reporting API
+    # requires the since query parameter.
+    # If you pass in an UNIX epoch date, numericDates must be true
+    get_events(params)
+
+rescue Smartsheet::ApiError => e
+  puts "Error Code: #{e.error_code}"
+  puts "Message: #{e.message}"
+  puts "Ref Id: #{e.ref_id}"
+end
+```

data/CHANGELOG.md

@@ -6,6 +6,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+## [2.77.0] - 2019-05-08
+- Added events endpoint to retrieve events that are occurring in your Smartsheet plan.
+
 ## [1.3.0] - 2019-02-11
 - Added constant for smartsheetgov 
 - Updated documentation regarding the usage of base_url to clarify how clients can access smartsheetgov

data/README.md

@@ -222,11 +222,19 @@ response = smartsheet.request(
 )
 ```
 
+## Advanced Topics
+For details about more advanced features, see [Advanced Topics](ADVANCED.md).
+
 ## Contributing
 
 If you would like to contribute a change to the SDK, please fork a branch and then submit a pull request.
 [More info here.](https://help.github.com/articles/using-pull-requests)
 
+## Version Numbers
+Starting from the v2.77.0 release, Smartsheet SDKs will use a new versioning strategy. Since all users are on the Smartsheet API 2.0, the SDK version numbers will start with 2. The 2nd number will be an internal reference number. The 3rd number is for incremental changes. 
+
+For example, v2.77.0 means that you are using our 2.0 version of the API, the API is synched internally to a tag of 77, and then if there are numbers after the last decimal, that will indicate a minor change.
+
 ## Support
 
 If you have any questions or issues with this SDK please post on [Stack Overflow using the tag "smartsheet-api"](http://stackoverflow.com/questions/tagged/smartsheet-api) or contact us directly at api@smartsheet.com.

data/lib/smartsheet/client.rb

@@ -7,6 +7,7 @@ require 'smartsheet/api/request_logger'
 require 'smartsheet/general_request'
 
 require 'smartsheet/endpoints/contacts/contacts'
+require 'smartsheet/endpoints/events/events'
 require 'smartsheet/endpoints/favorites/favorites'
 require 'smartsheet/endpoints/folders/folders'
 require 'smartsheet/endpoints/groups/groups'
@@ -64,7 +65,7 @@ module Smartsheet
     include GeneralRequest
     include Smartsheet::Constants
 
-    attr_reader :contacts, :favorites, :folders, :groups, :home, :reports, :search, :server_info,
+    attr_reader :contacts, :events, :favorites, :folders, :groups, :home, :reports, :search, :server_info,
                 :sheets, :sights, :templates, :token, :update_requests, :users, :webhooks,
                 :workspaces
 
@@ -159,6 +160,7 @@ module Smartsheet
 
     def build_categories
       @contacts = Contacts.new(client)
+      @events = Events.new(client)
       @favorites = Favorites.new(client)
       @folders = Folders.new(client)
       @groups = Groups.new(client)

data/lib/smartsheet/constants.rb

@@ -1,6 +1,6 @@
 module Smartsheet
   module Constants
-    VERSION = '1.3.0'.freeze
+    VERSION = '2.77.0'.freeze
 
     USER_AGENT = 'smartsheet-ruby-sdk'.freeze
     API_URL = 'https://api.smartsheet.com/2.0'.freeze

data/lib/smartsheet/endpoints/events/events.rb

@@ -0,0 +1,21 @@
+module Smartsheet
+  # Events Endpoints
+  # @see https://smartsheet-platform.github.io/api-docs/?ruby#event-reporting API Events Docs
+  class Events
+    attr_reader :client
+    private :client
+
+    def initialize(client)
+      @client = client
+    end
+  
+    def get(params: {}, header_overrides: {})
+      endpoint_spec = Smartsheet::API::EndpointSpec.new(:get, ['events'])
+      request_spec = Smartsheet::API::RequestSpec.new(
+          header_overrides: header_overrides,
+          params: params
+      )
+      client.make_request(endpoint_spec, request_spec)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartsheet
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 2.77.0
 platform: ruby
 authors:
 - Smartsheet
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-19 00:00:00.000000000 Z
+date: 2019-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -260,6 +260,7 @@ files:
 - ".rubocop.yml"
 - ".travis.yml"
 - ".yardopts"
+- ADVANCED.md
 - CHANGELOG.md
 - Gemfile
 - LICENSE
@@ -287,6 +288,7 @@ files:
 - lib/smartsheet/client.rb
 - lib/smartsheet/constants.rb
 - lib/smartsheet/endpoints/contacts/contacts.rb
+- lib/smartsheet/endpoints/events/events.rb
 - lib/smartsheet/endpoints/favorites/favorites.rb
 - lib/smartsheet/endpoints/folders/folders.rb
 - lib/smartsheet/endpoints/groups/groups.rb