slack-ruby-client 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c27d0774e9e56d2188bf8e9aea953b86821a9156
-  data.tar.gz: d4ca8180bcc3d643e5dcc0b326975086831df51f
+  metadata.gz: fcd1ef609f08b50f10e18a4c6fead723a0479638
+  data.tar.gz: 3740c747309c53870894ff627b5101149881e379
 SHA512:
-  metadata.gz: '0395ba1c14c66f1f3360c71a9bb294fd33ed88775de08c933e6cb7c23aa47485a864e151a3dd41354debd266cd9d9fa1ba80d0c5260afb5f62b60c46c1784a4c'
-  data.tar.gz: bbe81ee65b8358950dc946791bb72c8e8e3c84ce6ac52fe73a9a66c2f70073394153d604fce446b3eff3590b94ff87a4236a5d447522c8e0e10af4dd54daeddd
+  metadata.gz: ff1a0e156c5cd597c7a785dd5c740bea559fb86f83c5955e218a37e4fd827dc7335456f907fbc30ea3d89654c0a4ea154acc3afb3328a014de4a7a9a7877faf5
+  data.tar.gz: 9b62c200399f30be7df84c19da02d52a29585713b7ce0e7cc9ed3b0d97ccc9a19e4f51add07605b7a713988f482ce5f6ed15e27c6b50112718c97e9dfee62778

data/.travis.yml

@@ -6,8 +6,7 @@ rvm:
   - 2.2
   - 2.1
   - 2.0
-  - rbx-2
-  - jruby-19mode
+  - 2.3.4
   - ruby-head
   - jruby-head
 
@@ -20,15 +19,9 @@ matrix:
       env: CONCURRENCY=celluloid-io
     - rvm: 2.4.1
       env: CONCURRENCY=faye-websocket
-    - rvm: 2.3.4
-      env: CONCURRENCY=celluloid-io
-    - rvm: 2.3.4
-      env: CONCURRENCY=faye-websocket
   allow_failures:
     - rvm: ruby-head
     - rvm: jruby-head
-    - rvm: jruby-19mode
-    - rvm: rbx-2
 
 git:
   submodules: false

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+### 0.9.1 (8/24/2017)
+
+* [#158](https://github.com/slack-ruby/slack-ruby-client/issues/158): Updated to latest slack-api-ref; Updated chat.3.update patch to reflect argument reordering; Added chat.4.postEphemeral patch to apply the attachments JSON fix (whitespace last line of diff matters! ;-) - [@alexagranov](https://github.com/alexagranov).
+
 ### 0.9.0 (8/6/2017)
 
 * [#146](https://github.com/slack-ruby/slack-ruby-client/issues/146): Fix: `undefined method running?` and `ThreadError: Target thread must not be current thread` with `Celluloid::IO` - [@dblock](https://github.com/dblock).

data/README.md

@@ -18,7 +18,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web) and [RealTime Messa
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-client, 0.9.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 

data/bin/commands.rb

@@ -1,6 +1,7 @@
 # This file was auto-generated by lib/tasks/web.rake
 
 require 'commands/api'
+require 'commands/apps_permissions'
 require 'commands/auth'
 require 'commands/bots'
 require 'commands/channels'

data/bin/commands/api.rb

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

data/bin/commands/apps_permissions.rb

@@ -0,0 +1,22 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+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.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.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.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_permissions_request(options))
+    end
+  end
+end

data/bin/commands/auth.rb

@@ -2,8 +2,8 @@
 
 desc 'Auth methods.'
 command 'auth' do |g|
-  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.desc 'Revokes a token.'
+  g.long_desc %( Revokes a token. )
   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|
@@ -11,8 +11,8 @@ command 'auth' do |g|
     end
   end
 
-  g.desc 'This method checks authentication and tells you who you are.'
-  g.long_desc %( This method checks authentication and tells you who you are. )
+  g.desc 'Checks authentication & identity.'
+  g.long_desc %( Checks authentication & identity. )
   g.command 'test' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.auth_test(options))

data/bin/commands/bots.rb

@@ -2,8 +2,8 @@
 
 desc 'Bots methods.'
 command 'bots' do |g|
-  g.desc 'This method returns information about a bot user.'
-  g.long_desc %( This method returns information about a bot user. )
+  g.desc 'Gets information about a bot user.'
+  g.long_desc %( Gets information about a bot user. )
   g.command 'info' do |c|
     c.flag 'bot', desc: 'Bot user to get info on.'
     c.action do |_global_options, options, _args|

data/bin/commands/channels.rb

@@ -2,8 +2,8 @@
 
 desc "Get info on your team's Slack channels, create or archive channels, invite users, set the topic and purpose, and mark a channel as read."
 command 'channels' do |g|
-  g.desc 'This method archives a channel.'
-  g.long_desc %( This method archives a channel. )
+  g.desc 'Archives a channel.'
+  g.long_desc %( Archives a channel. )
   g.command 'archive' do |c|
     c.flag 'channel', desc: 'Channel to archive.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method is used to create a channel.'
-  g.long_desc %( This method is used to create a channel. )
+  g.desc 'Creates a channel.'
+  g.long_desc %( Creates a channel. )
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of channel to create.'
     c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
@@ -21,21 +21,21 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method returns a portion of message events from the specified channel.'
-  g.long_desc %( This method returns a portion of message events from the specified channel. )
+  g.desc 'Fetches history of messages and events from a channel.'
+  g.long_desc %( Fetches history of messages and events from a channel. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Channel to fetch history for.'
+    c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
     c.flag 'latest', desc: 'End of time range of messages to include in results.'
     c.flag 'oldest', desc: 'Start of time range of messages to include in results.'
-    c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
     c.flag 'unreads', desc: 'Include unread_count_display in the output?.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.channels_history(options))
     end
   end
 
-  g.desc 'This method returns information about a team channel.'
-  g.long_desc %( This method returns information about a team channel. )
+  g.desc 'Gets information about a channel.'
+  g.long_desc %( Gets information about a channel. )
   g.command 'info' do |c|
     c.flag 'channel', desc: 'Channel to get info on.'
     c.action do |_global_options, options, _args|
@@ -43,8 +43,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method is used to invite a user to a channel. The calling user must be a member of the channel.'
-  g.long_desc %( This method is used to invite a user to a channel. The calling user must be a member of the channel. )
+  g.desc 'Invites a user to a channel.'
+  g.long_desc %( Invites a user to a channel. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'Channel to invite user to.'
     c.flag 'user', desc: 'User to invite to channel.'
@@ -53,8 +53,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method is used to join a channel. If the channel does not exist, it is'
-  g.long_desc %( This method is used to join a channel. If the channel does not exist, it is created. )
+  g.desc 'Joins a channel, creating it if needed.'
+  g.long_desc %( Joins a channel, creating it if needed. )
   g.command 'join' do |c|
     c.flag 'name', desc: 'Name of channel to join.'
     c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
@@ -63,8 +63,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method allows a user to remove another member from a team channel.'
-  g.long_desc %( This method allows a user to remove another member from a team channel. )
+  g.desc 'Removes a user from a channel.'
+  g.long_desc %( Removes a user from a channel. )
   g.command 'kick' do |c|
     c.flag 'channel', desc: 'Channel to remove user from.'
     c.flag 'user', desc: 'User to remove from channel.'
@@ -73,8 +73,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method is used to leave a channel.'
-  g.long_desc %( This method is used to leave a channel. )
+  g.desc 'Leaves a channel.'
+  g.long_desc %( Leaves a channel. )
   g.command 'leave' do |c|
     c.flag 'channel', desc: 'Channel to leave.'
     c.action do |_global_options, options, _args|
@@ -82,8 +82,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method returns a list of all channels in the team. This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels. The number of (non-deactivated) members in each channel is also returned.'
-  g.long_desc %( This method returns a list of all channels in the team. This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels. The number of (non-deactivated) members in each channel is also returned. )
+  g.desc 'Lists all channels in a Slack team.'
+  g.long_desc %( Lists all channels in a Slack team. )
   g.command 'list' do |c|
     c.flag 'exclude_archived', desc: 'Exclude archived channels from the list.'
     c.flag 'exclude_members', desc: 'Exclude the members collection from each channel.'
@@ -92,8 +92,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method moves the read cursor in a channel.'
-  g.long_desc %( This method moves the read cursor in a channel. )
+  g.desc 'Sets the read cursor in a channel.'
+  g.long_desc %( Sets the read cursor in a channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -102,8 +102,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method renames a team channel.'
-  g.long_desc %( This method renames a team channel. )
+  g.desc 'Renames a channel.'
+  g.long_desc %( Renames a channel. )
   g.command 'rename' do |c|
     c.flag 'channel', desc: 'Channel to rename.'
     c.flag 'name', desc: 'New name for channel.'
@@ -113,8 +113,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
-  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.desc 'Retrieve a thread of messages posted to a channel'
+  g.long_desc %( Retrieve a thread of messages posted to a channel )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
@@ -123,8 +123,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method is used to change the purpose of a channel. The calling user must be a member of the channel.'
-  g.long_desc %( This method is used to change the purpose of a channel. The calling user must be a member of the channel. )
+  g.desc 'Sets the purpose for a channel.'
+  g.long_desc %( Sets the purpose for a channel. )
   g.command 'setPurpose' do |c|
     c.flag 'channel', desc: 'Channel to set the purpose of.'
     c.flag 'purpose', desc: 'The new purpose.'
@@ -133,8 +133,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method is used to change the topic of a channel. The calling user must be a member of the channel.'
-  g.long_desc %( This method is used to change the topic of a channel. The calling user must be a member of the channel. )
+  g.desc 'Sets the topic for a channel.'
+  g.long_desc %( Sets the topic for a channel. )
   g.command 'setTopic' do |c|
     c.flag 'channel', desc: 'Channel to set the topic of.'
     c.flag 'topic', desc: 'The new topic.'
@@ -143,8 +143,8 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'This method unarchives a channel. The calling user is added to the channel.'
-  g.long_desc %( This method unarchives a channel. The calling user is added to the channel. )
+  g.desc 'Unarchives a channel.'
+  g.long_desc %( Unarchives a channel. )
   g.command 'unarchive' do |c|
     c.flag 'channel', desc: 'Channel to unarchive.'
     c.action do |_global_options, options, _args|

data/bin/commands/chat.rb

@@ -2,19 +2,19 @@
 
 desc 'Post chat messages to Slack.'
 command 'chat' do |g|
-  g.desc 'This method deletes a message from a channel.'
-  g.long_desc %( This method deletes a message from a channel. )
+  g.desc 'Deletes a message.'
+  g.long_desc %( Deletes a message. )
   g.command 'delete' do |c|
-    c.flag 'ts', desc: 'Timestamp of the message to be deleted.'
     c.flag 'channel', desc: 'Channel containing the message to be deleted.'
+    c.flag 'ts', desc: 'Timestamp of the message to be deleted.'
     c.flag 'as_user', desc: 'Pass true to delete the message as the authed user. Bot users in this context are considered authed users.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_delete(options))
     end
   end
 
-  g.desc 'This method sends a me message to a channel from the calling user.'
-  g.long_desc %( This method sends a me message to a channel from the calling user. )
+  g.desc 'Share a me message into a channel.'
+  g.long_desc %( Share a me message into a channel. )
   g.command 'meMessage' do |c|
     c.flag 'channel', desc: 'Channel to send message to. Can be a public channel, private group or IM channel. Can be an encoded ID, or a name.'
     c.flag 'text', desc: 'Text of the message to send.'
@@ -23,49 +23,66 @@ command 'chat' do |g|
     end
   end
 
-  g.desc 'This method posts a message to a public channel, private channel, or direct message/IM channel.'
-  g.long_desc %( This method posts a message to a public channel, private channel, or direct message/IM channel. )
+  g.desc 'Sends an ephemeral message to a user in a channel.'
+  g.long_desc %( Sends an ephemeral message to a user in a channel. )
+  g.command 'postEphemeral' do |c|
+    c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
+    c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead."
+    c.flag 'user', desc: 'id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.'
+    c.flag 'as_user', desc: 'Pass true to post the message as the authed bot. Defaults to false.'
+    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
+    c.flag 'link_names', desc: 'Find and link channel names and usernames.'
+    c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_postEphemeral(options))
+    end
+  end
+
+  g.desc 'Sends a message to a channel.'
+  g.long_desc %( Sends a message to a channel. )
   g.command 'postMessage' do |c|
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
     c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead."
-    c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
+    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.'
+    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
+    c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
+    c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
     c.flag 'link_names', desc: 'Find and link channel names and usernames.'
-    c.flag 'attachments', desc: 'Structured message attachments.'
+    c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
+    c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
+    c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
     c.flag 'unfurl_links', desc: 'Pass true to enable unfurling of primarily text-based content.'
     c.flag 'unfurl_media', desc: 'Pass false to disable unfurling of media content.'
     c.flag 'username', desc: "Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below."
-    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.'
-    c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
-    c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
-    c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
-    c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_postMessage(options))
     end
   end
 
-  g.desc 'This method attaches Slack app unfurl behavior to a specified and relevant message. A user token is required as this method does not support bot user tokens.'
-  g.long_desc %( This method attaches Slack app unfurl behavior to a specified and relevant message. A user token is required as this method does not support bot user tokens. )
+  g.desc 'Provide custom unfurl behavior for user-posted URLs'
+  g.long_desc %( Provide custom unfurl behavior for user-posted URLs )
   g.command 'unfurl' do |c|
     c.flag 'channel', desc: 'Channel ID of the message.'
     c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to.'
-    c.flag 'unfurls', desc: 'JSON mapping a set of URLs from the message to their unfurl attachments.'
+    c.flag 'unfurls', desc: 'URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl message attachments.'
+    c.flag 'user_auth_message', desc: 'Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
     c.flag 'user_auth_required', desc: 'Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.'
+    c.flag 'user_auth_url', desc: 'Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_unfurl(options))
     end
   end
 
-  g.desc 'This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently.'
-  g.long_desc %( This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently. )
+  g.desc 'Updates a message.'
+  g.long_desc %( Updates a message. )
   g.command 'update' do |c|
-    c.flag 'ts', desc: 'Timestamp of the message to be updated.'
     c.flag 'channel', desc: 'Channel containing the message to be updated.'
     c.flag 'text', desc: 'New text for the message, using the default formatting rules.'
-    c.flag 'attachments', desc: 'Structured message attachments.'
-    c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.'
-    c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. This parameter should be used in conjunction with parse. To set link_names to 1, specify a parse mode of full.'
+    c.flag 'ts', desc: 'Timestamp of the message to be updated.'
     c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
+    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
+    c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. This parameter should be used in conjunction with parse. To set link_names to 1, specify a parse mode of full.'
+    c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_update(options))
     end

data/bin/commands/dnd.rb

@@ -2,8 +2,8 @@
 
 desc 'Adjust and view Do Not Disturb settings for team members.'
 command 'dnd' do |g|
-  g.desc "Ends the user's currently scheduled Do Not Disturb session immediately."
-  g.long_desc %( Ends the user's currently scheduled Do Not Disturb session immediately. )
+  g.desc "Ends the current user's Do Not Disturb session immediately."
+  g.long_desc %( Ends the current user's Do Not Disturb session immediately. )
   g.command 'endDnd' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.dnd_endDnd(options))
@@ -18,8 +18,8 @@ command 'dnd' do |g|
     end
   end
 
-  g.desc "Provides information about a user's current Do Not Disturb settings."
-  g.long_desc %( Provides information about a user's current Do Not Disturb settings. )
+  g.desc "Retrieves a user's current Do Not Disturb status."
+  g.long_desc %( Retrieves a user's current Do Not Disturb status. )
   g.command 'info' do |c|
     c.flag 'user', desc: 'User to fetch status for (defaults to current user).'
     c.action do |_global_options, options, _args|
@@ -27,8 +27,8 @@ command 'dnd' do |g|
     end
   end
 
-  g.desc "Adjusts the snooze duration for a user's Do Not Disturb settings. If a snooze session is not already active for the user, invoking this method will begin one for the specified duration."
-  g.long_desc %( Adjusts the snooze duration for a user's Do Not Disturb settings. If a snooze session is not already active for the user, invoking this method will begin one for the specified duration. )
+  g.desc 'Turns on Do Not Disturb mode for the current user, or changes its duration.'
+  g.long_desc %( Turns on Do Not Disturb mode for the current user, or changes its duration. )
   g.command 'setSnooze' do |c|
     c.flag 'num_minutes', desc: 'Number of minutes, from now, to snooze until.'
     c.action do |_global_options, options, _args|
@@ -36,8 +36,8 @@ command 'dnd' do |g|
     end
   end
 
-  g.desc 'Provides information about the current Do Not Disturb settings for users of a Slack team.'
-  g.long_desc %( Provides information about the current Do Not Disturb settings for users of a Slack team. )
+  g.desc 'Retrieves the Do Not Disturb status for users on a team.'
+  g.long_desc %( Retrieves the Do Not Disturb status for users on a team. )
   g.command 'teamInfo' do |c|
     c.flag 'users', desc: 'Comma-separated list of users to fetch Do Not Disturb status for.'
     c.action do |_global_options, options, _args|