Merge pull request #264 from dblock/update-api

rake slack:api:update

Author: dblock

.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2019-04-07 11:03:29 -0400 using RuboCop version 0.61.1.
+# on 2019-04-09 22:16:03 -0500 using RuboCop version 0.61.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -20,12 +20,15 @@ Lint/HandleExceptions:
     - 'spec/slack/real_time/concurrency/celluloid_spec.rb'
     - 'spec/slack/real_time/concurrency/eventmachine_spec.rb'
 
-# Offense count: 1
+# Offense count: 4
 # Configuration parameters: ExpectMatchingDefinition, Regex, IgnoreExecutableScripts, AllowedAcronyms.
 # AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
 Naming/FileName:
   Exclude:
+    - 'bin/commands/chat_scheduledMessages.rb'
     - 'lib/slack-ruby-client.rb'
+    - 'lib/slack/web/api/endpoints/chat_scheduledMessages.rb'
+    - 'spec/slack/web/api/endpoints/chat_scheduledMessages_spec.rb'
 
 # Offense count: 1
 # Configuration parameters: EnforcedStyleForLeadingUnderscores.
@@ -47,7 +50,7 @@ Style/AccessModifierDeclarations:
     - 'lib/slack/real_time/concurrency/eventmachine.rb'
     - 'lib/slack/real_time/socket.rb'
 
-# Offense count: 153
+# Offense count: 154
 # Configuration parameters: AllowedVariables.
 Style/GlobalVars:
   Enabled: false

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 * [#256](https://github.com/slack-ruby/slack-ruby-client/pull/256): Added support for specifying signing secrets on a per-request basis via optional parameters to the `Slack::Events::Request` constructor - [@gabrielmdeal](https://github.com/gabrielmdeal).
 * [#257](https://github.com/slack-ruby/slack-ruby-client/pull/257), [#262](https://github.com/slack-ruby/slack-ruby-client/pull/262): Fixed occasional failures to reconnect - [@ioquatix](https://github.com/ioquatix), [@dblock](https://github.com/dblock).
+* [#264](https://github.com/slack-ruby/slack-ruby-client/pull/264): Added `chat_scheduleMessage`, `chat_deleteScheduledMessage` and `chat_scheduledMessages_list` - [@dblock](https://github.com/dblock).
+* [#264](https://github.com/slack-ruby/slack-ruby-client/pull/264): Removed `files_comments_add` and `files_comments_edit` - [@dblock](https://github.com/dblock).
 * Your contribution here.
 
 ### 0.14.1 (2019/2/26)

bin/commands.rb

@@ -10,6 +10,7 @@
 require 'commands/bots'
 require 'commands/channels'
 require 'commands/chat'
+require 'commands/chat_scheduledMessages'
 require 'commands/conversations'
 require 'commands/dialog'
 require 'commands/dnd'

bin/commands/api.rb

@@ -2,8 +2,8 @@
 
 desc 'Api methods.'
 command 'api' do |g|
-  g.desc 'Checks API calling code.'
-  g.long_desc %( Checks API calling code. )
+  g.desc 'This method helps you test your calling code.'
+  g.long_desc %( This method helps you test your calling code. )
   g.command 'test' do |c|
     c.flag 'error', desc: 'Error response to return.'
     c.flag 'foo', desc: 'example property to return.'

bin/commands/apps.rb

@@ -2,8 +2,8 @@
 
 desc 'Apps methods.'
 command 'apps' do |g|
-  g.desc 'Uninstalls your app from a workspace.'
-  g.long_desc %( Uninstalls your app from a workspace. )
+  g.desc 'This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app.'
+  g.long_desc %( This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app. )
   g.command 'uninstall' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'

bin/commands/apps_permissions.rb

@@ -2,16 +2,16 @@
 
 desc 'AppsPermissions methods.'
 command 'apps_permissions' do |g|
-  g.desc 'Returns list of permissions this app has on a team.'
-  g.long_desc %( Returns list of permissions this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'info' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.apps_permissions_info(options))
     end
   end
 
-  g.desc 'Allows an app to request additional scopes'
-  g.long_desc %( Allows an app to request additional scopes )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'request' do |c|
     c.flag 'scopes', desc: 'A comma separated list of scopes to request for.'
     c.flag 'trigger_id', desc: 'Token used to trigger the permissions API.'

bin/commands/apps_permissions_resources.rb

@@ -2,8 +2,8 @@
 
 desc 'AppsPermissionsResources methods.'
 command 'apps_permissions_resources' do |g|
-  g.desc 'Returns list of resource grants this app has on a team.'
-  g.long_desc %( Returns list of resource grants this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
     c.flag 'limit', desc: 'The maximum number of items to return.'

bin/commands/apps_permissions_scopes.rb

@@ -2,8 +2,8 @@
 
 desc 'AppsPermissionsScopes methods.'
 command 'apps_permissions_scopes' do |g|
-  g.desc 'Returns list of scopes this app has on a team.'
-  g.long_desc %( Returns list of scopes this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.apps_permissions_scopes_list(options))

bin/commands/apps_permissions_users.rb

@@ -2,8 +2,8 @@
 
 desc 'AppsPermissionsUsers methods.'
 command 'apps_permissions_users' do |g|
-  g.desc 'Returns list of user grants and corresponding scopes this app has on a team.'
-  g.long_desc %( Returns list of user grants and corresponding scopes this app has on a team. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
     c.flag 'limit', desc: 'The maximum number of items to return.'
@@ -12,8 +12,8 @@
     end
   end
 
-  g.desc 'Enables an app to trigger a permissions modal to grant an app access to a user access scope.'
-  g.long_desc %( Enables an app to trigger a permissions modal to grant an app access to a user access scope. )
+  g.desc 'This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.'
+  g.long_desc %( This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months. )
   g.command 'request' do |c|
     c.flag 'scopes', desc: 'A comma separated list of user scopes to request for.'
     c.flag 'trigger_id', desc: 'Token used to trigger the request.'

bin/commands/auth.rb

@@ -2,17 +2,17 @@
 
 desc 'Auth methods.'
 command 'auth' do |g|
-  g.desc 'Revokes a token.'
-  g.long_desc %( Revokes a token. )
+  g.desc 'This method revokes an access token. Use it when you no longer need a token. For example, with a Sign In With Slack app, call this to log a user out.'
+  g.long_desc %( This method revokes an access token. Use it when you no longer need a token. For example, with a Sign In With Slack app, call this to log a user out. )
   g.command 'revoke' do |c|
     c.flag 'test', desc: 'Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.auth_revoke(options))
     end
   end
 
-  g.desc 'Checks authentication & identity.'
-  g.long_desc %( Checks authentication & identity. )
+  g.desc 'This method checks authentication and tells "you" who you are, even if you might be a bot.'
+  g.long_desc %( This method checks authentication and tells "you" who you are, even if you might be a bot. )
   g.command 'test' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.auth_test(options))