slack-ruby-client 0.9.0 → 0.11.0

data/bin/commands/groups.rb

@@ -2,8 +2,8 @@
 
 desc "Get info on your team's private channels."
 command 'groups' do |g|
-  g.desc 'This method archives a private channel.'
-  g.long_desc %( This method archives a private channel. )
+  g.desc 'Archives a private channel.'
+  g.long_desc %( Archives a private channel. )
   g.command 'archive' do |c|
     c.flag 'channel', desc: 'Private channel to archive.'
     c.action do |_global_options, options, _args|
@@ -11,17 +11,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method closes a private channel.'
-  g.long_desc %( This method closes a private channel. )
-  g.command 'close' do |c|
-    c.flag 'channel', desc: 'Private channel to close.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_close(options))
-    end
-  end
-
-  g.desc 'This method creates a private channel.'
-  g.long_desc %( This method creates a private channel. )
+  g.desc 'Creates a private channel.'
+  g.long_desc %( Creates a private channel. )
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of private channel to create.'
     c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
@@ -30,8 +21,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method takes an existing private channel and performs the following steps:'
-  g.long_desc %( This method takes an existing private channel and performs the following steps: )
+  g.desc 'Clones and archives a private channel.'
+  g.long_desc %( Clones and archives a private channel. )
   g.command 'createChild' do |c|
     c.flag 'channel', desc: 'Private channel to clone and archive.'
     c.action do |_global_options, options, _args|
@@ -39,30 +30,40 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method returns a portion of messages/events from the specified private channel.'
-  g.long_desc %( This method returns a portion of messages/events from the specified private channel. To read the entire history for a private channel, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
+  g.desc 'Fetches history of messages and events from a private channel.'
+  g.long_desc %( Fetches history of messages and events from a private channel. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Private 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.groups_history(options))
     end
   end
 
-  g.desc 'This method returns information about a private channel.'
-  g.long_desc %( This method returns information about a private channel. )
+  g.desc 'This method returns the ID of a group.'
+  g.long_desc %( This method returns the ID of a group. )
+  g.command 'id' do |c|
+    c.flag 'channel', desc: 'Group channel to get ID for, prefixed with #.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_id(options))
+    end
+  end
+
+  g.desc 'Gets information about a private channel.'
+  g.long_desc %( Gets information about a private channel. )
   g.command 'info' do |c|
     c.flag 'channel', desc: 'Private channel to get info on.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this group. Defaults to false.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.groups_info(options))
     end
   end
 
-  g.desc 'This method is used to invite a user to a private channel. The calling user must be a member of the private channel.'
-  g.long_desc %( This method is used to invite a user to a private channel. The calling user must be a member of the private channel. )
+  g.desc 'Invites a user to a private channel.'
+  g.long_desc %( Invites a user to a private channel. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'Private channel to invite user to.'
     c.flag 'user', desc: 'User to invite.'
@@ -71,8 +72,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method allows a user to remove another member from a private channel.'
-  g.long_desc %( This method allows a user to remove another member from a private channel. )
+  g.desc 'Removes a user from a private channel.'
+  g.long_desc %( Removes a user from a private channel. )
   g.command 'kick' do |c|
     c.flag 'channel', desc: 'Private channel to remove user from.'
     c.flag 'user', desc: 'User to remove from private channel.'
@@ -81,8 +82,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method is used to leave a private channel.'
-  g.long_desc %( This method is used to leave a private channel. )
+  g.desc 'Leaves a private channel.'
+  g.long_desc %( Leaves a private channel. )
   g.command 'leave' do |c|
     c.flag 'channel', desc: 'Private channel to leave.'
     c.action do |_global_options, options, _args|
@@ -90,17 +91,18 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method returns a list of private channels in the team that the caller is in and archived groups that the caller was in.'
-  g.long_desc %( This method returns a list of private channels in the team that the caller is in and archived groups that the caller was in. The list of (non-deactivated) members in each private channel is also returned. )
+  g.desc 'Lists private channels that the calling user has access to.'
+  g.long_desc %( Lists private channels that the calling user has access to. )
   g.command 'list' do |c|
     c.flag 'exclude_archived', desc: "Don't return archived private channels."
+    c.flag 'exclude_members', desc: 'Exclude the members from each group.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.groups_list(options))
     end
   end
 
-  g.desc 'This method moves the read cursor in a private channel.'
-  g.long_desc %( This method moves the read cursor in a private channel. )
+  g.desc 'Sets the read cursor in a private channel.'
+  g.long_desc %( Sets the read cursor in a private channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Private channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -109,8 +111,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method opens a private channel.'
-  g.long_desc %( This method opens a private channel. )
+  g.desc 'Opens a private channel.'
+  g.long_desc %( Opens a private channel. )
   g.command 'open' do |c|
     c.flag 'channel', desc: 'Private channel to open.'
     c.action do |_global_options, options, _args|
@@ -118,8 +120,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method renames a private channel.'
-  g.long_desc %( This method renames a private channel. )
+  g.desc 'Renames a private channel.'
+  g.long_desc %( Renames a private channel. )
   g.command 'rename' do |c|
     c.flag 'channel', desc: 'Private channel to rename.'
     c.flag 'name', desc: 'New name for private channel.'
@@ -129,8 +131,8 @@ command 'groups' 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 private channel'
+  g.long_desc %( Retrieve a thread of messages posted to a private channel )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Private channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
@@ -139,8 +141,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.'
-  g.long_desc %( This method is used to change the purpose of a private channel. The calling user must be a member of the private channel. )
+  g.desc 'Sets the purpose for a private channel.'
+  g.long_desc %( Sets the purpose for a private channel. )
   g.command 'setPurpose' do |c|
     c.flag 'channel', desc: 'Private channel to set the purpose of.'
     c.flag 'purpose', desc: 'The new purpose.'
@@ -149,8 +151,8 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method is used to change the topic of a private channel. The calling user must be a member of the private channel.'
-  g.long_desc %( This method is used to change the topic of a private channel. The calling user must be a member of the private channel. )
+  g.desc 'Sets the topic for a private channel.'
+  g.long_desc %( Sets the topic for a private channel. )
   g.command 'setTopic' do |c|
     c.flag 'channel', desc: 'Private channel to set the topic of.'
     c.flag 'topic', desc: 'The new topic.'
@@ -159,21 +161,12 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method unarchives a private channel.'
-  g.long_desc %( This method unarchives a private channel. )
+  g.desc 'Unarchives a private channel.'
+  g.long_desc %( Unarchives a private channel. )
   g.command 'unarchive' do |c|
     c.flag 'channel', desc: 'Private channel to unarchive.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.groups_unarchive(options))
     end
   end
-
-  g.desc 'This method returns the ID of a group.'
-  g.long_desc %( This method returns the ID of a group. )
-  g.command 'id' do |c|
-    c.flag 'channel', desc: 'Group channel to get ID for, prefixed with #.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_id(options))
-    end
-  end
 end

data/bin/commands/im.rb

@@ -2,8 +2,8 @@
 
 desc 'Get info on your direct messages.'
 command 'im' do |g|
-  g.desc 'This method closes a direct message channel.'
-  g.long_desc %( This method closes a direct message channel. )
+  g.desc 'Close a direct message channel.'
+  g.long_desc %( Close a direct message channel. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'Direct message channel to close.'
     c.action do |_global_options, options, _args|
@@ -11,29 +11,31 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'This method returns a portion of messages/events from the specified direct message channel.'
-  g.long_desc %( This method returns a portion of messages/events from the specified direct message channel. To read the entire history for a direct message channel, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
+  g.desc 'Fetches history of messages and events from direct message channel.'
+  g.long_desc %( Fetches history of messages and events from direct message channel. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Direct message 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.im_history(options))
     end
   end
 
-  g.desc 'This method returns a list of all im channels that the user has.'
-  g.long_desc %( This method returns a list of all im channels that the user has. )
+  g.desc 'Lists direct message channels for the calling user.'
+  g.long_desc %( Lists direct message channels for the calling user. )
   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. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.im_list(options))
     end
   end
 
-  g.desc 'This method moves the read cursor in a direct message channel.'
-  g.long_desc %( This method moves the read cursor in a direct message channel. )
+  g.desc 'Sets the read cursor in a direct message channel.'
+  g.long_desc %( Sets the read cursor in a direct message channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Direct message channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -42,18 +44,19 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'This method opens a direct message channel with another member of your Slack team.'
-  g.long_desc %( This method opens a direct message channel with another member of your Slack team. )
+  g.desc 'Opens a direct message channel.'
+  g.long_desc %( Opens a direct message channel. )
   g.command 'open' do |c|
     c.flag 'user', desc: 'User to open a direct message channel with.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this im. Defaults to false.'
     c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.im_open(options))
     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 direct message conversation'
+  g.long_desc %( Retrieve a thread of messages posted to a direct message conversation )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Direct message channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."

data/bin/commands/migration.rb

@@ -0,0 +1,14 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Migration methods.'
+command 'migration' do |g|
+  g.desc 'For Enterprise Grid workspaces, map local user IDs to global user IDs'
+  g.long_desc %( For Enterprise Grid workspaces, map local user IDs to global user IDs )
+  g.command 'exchange' do |c|
+    c.flag 'users', desc: 'A comma-separated list of user ids, up to 400 per request.'
+    c.flag 'to_old', desc: 'Specify true to convert W global user IDs to workspace-specific U IDs. Defaults to false.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.migration_exchange(options))
+    end
+  end
+end

data/bin/commands/mpim.rb

@@ -2,8 +2,8 @@
 
 desc 'Get info on your multiparty direct messages.'
 command 'mpim' do |g|
-  g.desc 'This method closes a multiparty direct message channel.'
-  g.long_desc %( This method closes a multiparty direct message channel. )
+  g.desc 'Closes a multiparty direct message channel.'
+  g.long_desc %( Closes a multiparty direct message channel. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'MPIM to close.'
     c.action do |_global_options, options, _args|
@@ -11,29 +11,29 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'This method returns a portion of messages/events from the specified multiparty direct message channel.'
-  g.long_desc %( This method returns a portion of messages/events from the specified multiparty direct message channel. To read the entire history for a multiparty direct message, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
+  g.desc 'Fetches history of messages and events from a multiparty direct message.'
+  g.long_desc %( Fetches history of messages and events from a multiparty direct message. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Multiparty direct message 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.mpim_history(options))
     end
   end
 
-  g.desc 'This method returns a list of all multiparty direct message channels that the user has.'
-  g.long_desc %( This method returns a list of all multiparty direct message channels that the user has. )
+  g.desc 'Lists multiparty direct message channels for the calling user.'
+  g.long_desc %( Lists multiparty direct message channels for the calling user. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.mpim_list(options))
     end
   end
 
-  g.desc 'This method moves the read cursor in a multiparty direct message channel.'
-  g.long_desc %( This method moves the read cursor in a multiparty direct message channel. )
+  g.desc 'Sets the read cursor in a multiparty direct message channel.'
+  g.long_desc %( Sets the read cursor in a multiparty direct message channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'multiparty direct message channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -51,8 +51,8 @@ command 'mpim' 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 direct message conversation from a multiparty direct message.'
+  g.long_desc %( Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message. )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Multiparty direct message channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."

data/bin/commands/oauth.rb

@@ -2,8 +2,8 @@
 
 desc 'Oauth methods.'
 command 'oauth' do |g|
-  g.desc 'This method allows you to exchange a temporary OAuth code for an API access token.'
-  g.long_desc %( This method allows you to exchange a temporary OAuth code for an API access token. This is used as part of the OAuth authentication flow. )
+  g.desc 'Exchanges a temporary OAuth code for an API token.'
+  g.long_desc %( Exchanges a temporary OAuth code for an API token. )
   g.command 'access' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'
@@ -13,4 +13,17 @@ command 'oauth' do |g|
       puts JSON.dump($client.oauth_access(options))
     end
   end
+
+  g.desc 'Exchanges a temporary OAuth verifier code for a workspace token.'
+  g.long_desc %( Exchanges a temporary OAuth verifier code for a workspace token. )
+  g.command 'token' do |c|
+    c.flag 'client_id', desc: 'Issued when you created your application.'
+    c.flag 'client_secret', desc: 'Issued when you created your application.'
+    c.flag 'code', desc: 'The code param returned via the OAuth callback.'
+    c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
+    c.flag 'single_channel', desc: 'Request the user to add your app only to a single channel.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.oauth_token(options))
+    end
+  end
 end

data/bin/commands/pins.rb

@@ -2,8 +2,8 @@
 
 desc 'Pins methods.'
 command 'pins' do |g|
-  g.desc 'This method pins an item (file, file comment, channel message, or group message) to a particular channel.'
-  g.long_desc %( This method pins an item (file, file comment, channel message, or group message) to a particular channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
+  g.desc 'Pins an item to a channel.'
+  g.long_desc %( Pins an item to a channel. )
   g.command 'add' do |c|
     c.flag 'channel', desc: 'Channel to pin the item in.'
     c.flag 'file', desc: 'File to pin.'
@@ -14,8 +14,8 @@ command 'pins' do |g|
     end
   end
 
-  g.desc 'This method lists the items pinned to a channel.'
-  g.long_desc %( This method lists the items pinned to a channel. )
+  g.desc 'Lists items pinned to a channel.'
+  g.long_desc %( Lists items pinned to a channel. )
   g.command 'list' do |c|
     c.flag 'channel', desc: 'Channel to get pinned items for.'
     c.action do |_global_options, options, _args|
@@ -23,8 +23,8 @@ command 'pins' do |g|
     end
   end
 
-  g.desc 'This method un-pins an item (file, file comment, channel message, or group message) from a channel.'
-  g.long_desc %( This method un-pins an item (file, file comment, channel message, or group message) from a channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
+  g.desc 'Un-pins an item from a channel.'
+  g.long_desc %( Un-pins an item from a channel. )
   g.command 'remove' do |c|
     c.flag 'channel', desc: 'Channel where the item is pinned to.'
     c.flag 'file', desc: 'File to un-pin.'

data/bin/commands/reactions.rb

@@ -2,49 +2,49 @@
 
 desc 'Reactions methods.'
 command 'reactions' do |g|
-  g.desc 'This method adds a reaction (emoji) to an item (file, file comment, channel message, group message, or direct message).'
-  g.long_desc %( This method adds a reaction (emoji) to an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified. )
+  g.desc 'Adds a reaction to an item.'
+  g.long_desc %( Adds a reaction to an item. )
   g.command 'add' do |c|
     c.flag 'name', desc: 'Reaction (emoji) name.'
+    c.flag 'channel', desc: 'Channel where the message to add reaction to was posted.'
     c.flag 'file', desc: 'File to add reaction to.'
     c.flag 'file_comment', desc: 'File comment to add reaction to.'
-    c.flag 'channel', desc: 'Channel where the message to add reaction to was posted.'
     c.flag 'timestamp', desc: 'Timestamp of the message to add reaction to.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_add(options))
     end
   end
 
-  g.desc 'This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message).'
-  g.long_desc %( This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message). )
+  g.desc 'Gets reactions for an item.'
+  g.long_desc %( Gets reactions for an item. )
   g.command 'get' do |c|
+    c.flag 'channel', desc: 'Channel where the message to get reactions for was posted.'
     c.flag 'file', desc: 'File to get reactions for.'
     c.flag 'file_comment', desc: 'File comment to get reactions for.'
-    c.flag 'channel', desc: 'Channel where the message to get reactions for was posted.'
-    c.flag 'timestamp', desc: 'Timestamp of the message to get reactions for.'
     c.flag 'full', desc: 'If true always return the complete reaction list.'
+    c.flag 'timestamp', desc: 'Timestamp of the message to get reactions for.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_get(options))
     end
   end
 
-  g.desc 'This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user.'
-  g.long_desc %( This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user. )
+  g.desc 'Lists reactions made by a user.'
+  g.long_desc %( Lists reactions made by a user. )
   g.command 'list' do |c|
-    c.flag 'user', desc: 'Show reactions made by this user. Defaults to the authed user.'
     c.flag 'full', desc: 'If true always return the complete reaction list.'
+    c.flag 'user', desc: 'Show reactions made by this user. Defaults to the authed user.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_list(options))
     end
   end
 
-  g.desc 'This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message).'
-  g.long_desc %( This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified. )
+  g.desc 'Removes a reaction from an item.'
+  g.long_desc %( Removes a reaction from an item. )
   g.command 'remove' do |c|
     c.flag 'name', desc: 'Reaction (emoji) name.'
+    c.flag 'channel', desc: 'Channel where the message to remove reaction from was posted.'
     c.flag 'file', desc: 'File to remove reaction from.'
     c.flag 'file_comment', desc: 'File comment to remove reaction from.'
-    c.flag 'channel', desc: 'Channel where the message to remove reaction from was posted.'
     c.flag 'timestamp', desc: 'Timestamp of the message to remove reaction from.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_remove(options))

data/bin/commands/reminders.rb

@@ -2,8 +2,8 @@
 
 desc 'Reminders methods.'
 command 'reminders' do |g|
-  g.desc 'This method creates a reminder.'
-  g.long_desc %( This method creates a reminder. )
+  g.desc 'Creates a reminder.'
+  g.long_desc %( Creates a reminder. )
   g.command 'add' do |c|
     c.flag 'text', desc: 'The content of the reminder.'
     c.flag 'time', desc: 'When this reminder should happen: the Unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description (Ex. "in 15 minutes," or "every Thursday").'
@@ -13,8 +13,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method completes a reminder.'
-  g.long_desc %( This method completes a reminder. )
+  g.desc 'Marks a reminder as complete.'
+  g.long_desc %( Marks a reminder as complete. )
   g.command 'complete' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder to be marked as complete.'
     c.action do |_global_options, options, _args|
@@ -22,8 +22,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method deletes a reminder.'
-  g.long_desc %( This method deletes a reminder. )
+  g.desc 'Deletes a reminder.'
+  g.long_desc %( Deletes a reminder. )
   g.command 'delete' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder.'
     c.action do |_global_options, options, _args|
@@ -31,8 +31,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method returns information about a reminder.'
-  g.long_desc %( This method returns information about a reminder. )
+  g.desc 'Gets information about a reminder.'
+  g.long_desc %( Gets information about a reminder. )
   g.command 'info' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder.'
     c.action do |_global_options, options, _args|
@@ -40,8 +40,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method lists all reminders created by or for a given user.'
-  g.long_desc %( This method lists all reminders created by or for a given user. )
+  g.desc 'Lists all reminders created by or for a given user.'
+  g.long_desc %( Lists all reminders created by or for a given user. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reminders_list(options))

data/bin/commands/rtm.rb

@@ -2,21 +2,24 @@
 
 desc 'Rtm methods.'
 command 'rtm' do |g|
-  g.desc 'This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket.'
-  g.long_desc %( This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket. )
+  g.desc 'Starts a Real Time Messaging session.'
+  g.long_desc %( Starts a Real Time Messaging session. )
   g.command 'connect' do |c|
+    c.flag 'batch_presence_aware', desc: 'Only deliver presence events when requested by subscription. See presence subscriptions.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.rtm_connect(options))
     end
   end
 
-  g.desc 'This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket.'
-  g.long_desc %( This method begins a Real Time Messaging API session and reserves your application a specific URL with which to connect via websocket. )
+  g.desc 'Starts a Real Time Messaging session.'
+  g.long_desc %( Starts a Real Time Messaging session. )
   g.command 'start' do |c|
-    c.flag 'simple_latest', desc: 'Return timestamp only for latest message object of each channel (improves performance).'
-    c.flag 'no_unreads', desc: 'Skip unread counts for each channel (improves performance).'
+    c.flag 'batch_presence_aware', desc: 'Only deliver presence events when requested by subscription. See presence subscriptions.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for users and channels. Defaults to false.'
     c.flag 'mpim_aware', desc: 'Returns MPIMs to the client in the API response.'
     c.flag 'no_latest', desc: 'Exclude latest timestamps for channels, groups, mpims, and ims. Automatically sets no_unreads to 1.'
+    c.flag 'no_unreads', desc: 'Skip unread counts for each channel (improves performance).'
+    c.flag 'simple_latest', desc: 'Return timestamp only for latest message object of each channel (improves performance).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.rtm_start(options))
     end

data/bin/commands/search.rb

@@ -2,37 +2,37 @@
 
 desc "Search your team's files and messages."
 command 'search' do |g|
-  g.desc 'This method allows users and applications to search both messages and files in a single call.'
-  g.long_desc %( This method allows users and applications to search both messages and files in a single call. )
+  g.desc 'Searches for messages and files matching a query.'
+  g.long_desc %( Searches for messages and files matching a query. )
   g.command 'all' do |c|
     c.flag 'query', desc: 'Search query. May contains booleans, etc.'
+    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.flag 'sort', desc: 'Return matches sorted by either score or timestamp.'
     c.flag 'sort_dir', desc: 'Change sort direction to ascending (asc) or descending (desc).'
-    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.search_all(options))
     end
   end
 
-  g.desc 'This method returns files matching a search query.'
-  g.long_desc %( This method returns files matching a search query. )
+  g.desc 'Searches for files matching a query.'
+  g.long_desc %( Searches for files matching a query. )
   g.command 'files' do |c|
     c.flag 'query', desc: 'Search query. May contain booleans, etc.'
+    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.flag 'sort', desc: 'Return matches sorted by either score or timestamp.'
     c.flag 'sort_dir', desc: 'Change sort direction to ascending (asc) or descending (desc).'
-    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.search_files(options))
     end
   end
 
-  g.desc 'This method returns messages matching a search query.'
-  g.long_desc %( This method returns messages matching a search query. )
+  g.desc 'Searches for messages matching a query.'
+  g.long_desc %( Searches for messages matching a query. )
   g.command 'messages' do |c|
     c.flag 'query', desc: 'Search query. May contains booleans, etc.'
+    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.flag 'sort', desc: 'Return matches sorted by either score or timestamp.'
     c.flag 'sort_dir', desc: 'Change sort direction to ascending (asc) or descending (desc).'
-    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.search_messages(options))
     end