slack-ruby-client 0.9.0 → 0.11.0

data/bin/commands/chat.rb

@@ -2,19 +2,40 @@
 
 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 'Execute a slash command in a public channel (undocumented)'
+  g.long_desc %( Execute a slash command in a public channel )
+  g.command 'command' do |c|
+    c.flag 'channel', desc: 'Channel to execute the command in.'
+    c.flag 'command', desc: 'Slash command to be executed. Leading backslash is required.'
+    c.flag 'text', desc: 'Additional parameters provided to the slash command.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_command(options))
+    end
+  end
+
+  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 'as_user', desc: 'Pass true to delete the message as the authed user. Bot users in this context are considered authed users.'
+    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 with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.'
     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 'Retrieve a permalink URL for a specific extant message'
+  g.long_desc %( Retrieve a permalink URL for a specific extant message )
+  g.command 'getPermalink' do |c|
+    c.flag 'channel', desc: 'The ID of the conversation or channel containing the message.'
+    c.flag 'message_ts', desc: "A message's ts value, uniquely identifying it within a channel."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_getPermalink(options))
+    end
+  end
+
+  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 +44,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 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting attachments."
+    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. This field is required when not presenting text.'
+    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/conversations.rb

@@ -0,0 +1,178 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+desc "Interface with all kinds of conversations the same way, whether they're public or private channels, direct messages, or otherwise."
+command 'conversations' do |g|
+  g.desc 'Archives a conversation.'
+  g.long_desc %( Archives a conversation. )
+  g.command 'archive' do |c|
+    c.flag 'channel', desc: 'ID of conversation to archive.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_archive(options))
+    end
+  end
+
+  g.desc 'Closes a direct message or multi-person direct message.'
+  g.long_desc %( Closes a direct message or multi-person direct message. )
+  g.command 'close' do |c|
+    c.flag 'channel', desc: 'Conversation to close.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_close(options))
+    end
+  end
+
+  g.desc 'Initiates a public or private channel-based conversation'
+  g.long_desc %( Initiates a public or private channel-based conversation )
+  g.command 'create' do |c|
+    c.flag 'name', desc: 'Name of the public or private channel to create.'
+    c.flag 'is_private', desc: 'Create a private channel instead of a public one.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_create(options))
+    end
+  end
+
+  g.desc "Fetches a conversation's history of messages and events."
+  g.long_desc %( Fetches a conversation's history of messages and events. )
+  g.command 'history' do |c|
+    c.flag 'channel', desc: 'Conversation ID to fetch history for.'
+    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 'latest', desc: 'End of time range of messages to include in results.'
+    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.flag 'oldest', desc: 'Start of time range of messages to include in results.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_history(options))
+    end
+  end
+
+  g.desc 'Retrieve information about a conversation.'
+  g.long_desc %( Retrieve information about a conversation. )
+  g.command 'info' do |c|
+    c.flag 'channel', desc: 'Conversation ID to learn more about.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this conversation. Defaults to false.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_info(options))
+    end
+  end
+
+  g.desc 'Invites users to a channel.'
+  g.long_desc %( Invites users to a channel. )
+  g.command 'invite' do |c|
+    c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
+    c.flag 'users', desc: 'A comma separated list of user IDs. Up to 30 users may be listed.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_invite(options))
+    end
+  end
+
+  g.desc 'Joins an existing conversation.'
+  g.long_desc %( Joins an existing conversation. )
+  g.command 'join' do |c|
+    c.flag 'channel', desc: 'ID of conversation to join.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_join(options))
+    end
+  end
+
+  g.desc 'Removes a user from a conversation.'
+  g.long_desc %( Removes a user from a conversation. )
+  g.command 'kick' do |c|
+    c.flag 'channel', desc: 'ID of conversation to remove user from.'
+    c.flag 'user', desc: 'User ID to be removed.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_kick(options))
+    end
+  end
+
+  g.desc 'Leaves a conversation.'
+  g.long_desc %( Leaves a conversation. )
+  g.command 'leave' do |c|
+    c.flag 'channel', desc: 'Conversation to leave.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_leave(options))
+    end
+  end
+
+  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 '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 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
+    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 list hasn't been reached. Must be an integer no larger than 1000."
+    c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_list(options))
+    end
+  end
+
+  g.desc 'Retrieve members of a conversation.'
+  g.long_desc %( Retrieve members of a conversation. )
+  g.command 'members' do |c|
+    c.flag 'channel', desc: 'ID of the conversation to retrieve members for.'
+    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.conversations_members(options))
+    end
+  end
+
+  g.desc 'Opens or resumes a direct message or multi-person direct message.'
+  g.long_desc %( Opens or resumes a direct message or multi-person direct message. )
+  g.command 'open' do |c|
+    c.flag 'channel', desc: "Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead."
+    c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
+    c.flag 'users', desc: 'Comma separated lists of users. If only one user is included, this creates a 1:1 DM.  The ordering of the users is preserved whenever a multi-person direct message is returned. Supply a channel when not supplying users.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_open(options))
+    end
+  end
+
+  g.desc 'Renames a conversation.'
+  g.long_desc %( Renames a conversation. )
+  g.command 'rename' do |c|
+    c.flag 'channel', desc: 'ID of conversation to rename.'
+    c.flag 'name', desc: 'New name for conversation.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_rename(options))
+    end
+  end
+
+  g.desc 'Retrieve a thread of messages posted to a conversation'
+  g.long_desc %( Retrieve a thread of messages posted to a conversation )
+  g.command 'replies' do |c|
+    c.flag 'channel', desc: 'Conversation ID to fetch thread from.'
+    c.flag 'ts', desc: "Unique identifier of a thread's parent message."
+    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.conversations_replies(options))
+    end
+  end
+
+  g.desc 'Sets the purpose for a conversation.'
+  g.long_desc %( Sets the purpose for a conversation. )
+  g.command 'setPurpose' do |c|
+    c.flag 'channel', desc: 'Conversation to set the purpose of.'
+    c.flag 'purpose', desc: 'A new, specialer purpose.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_setPurpose(options))
+    end
+  end
+
+  g.desc 'Sets the topic for a conversation.'
+  g.long_desc %( Sets the topic for a conversation. )
+  g.command 'setTopic' do |c|
+    c.flag 'channel', desc: 'Conversation to set the topic of.'
+    c.flag 'topic', desc: 'The new topic string. Does not support formatting or linkification.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_setTopic(options))
+    end
+  end
+
+  g.desc 'Reverses conversation archival.'
+  g.long_desc %( Reverses conversation archival. )
+  g.command 'unarchive' do |c|
+    c.flag 'channel', desc: 'ID of conversation to unarchive.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_unarchive(options))
+    end
+  end
+end

data/bin/commands/dialog.rb

@@ -0,0 +1,14 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Dialog methods.'
+command 'dialog' do |g|
+  g.desc 'Open a dialog with a user'
+  g.long_desc %( Open a dialog with a user )
+  g.command 'open' do |c|
+    c.flag 'dialog', desc: 'The dialog definition. This must be a JSON-encoded string.'
+    c.flag 'trigger_id', desc: 'Exchange a trigger to post to the user.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.dialog_open(options))
+    end
+  end
+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|

data/bin/commands/emoji.rb

@@ -2,8 +2,8 @@
 
 desc 'Emoji methods.'
 command 'emoji' do |g|
-  g.desc 'This method lists the custom emoji for a team.'
-  g.long_desc %( This method lists the custom emoji for a team. )
+  g.desc 'Lists custom emoji for a team.'
+  g.long_desc %( Lists custom emoji for a team. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.emoji_list(options))

data/bin/commands/files.rb

@@ -2,8 +2,8 @@
 
 desc 'Get info on files uploaded to Slack, upload new files to Slack.'
 command 'files' do |g|
-  g.desc 'This method deletes a file from your team.'
-  g.long_desc %( This method deletes a file from your team. )
+  g.desc 'Deletes a file.'
+  g.long_desc %( Deletes a file. )
   g.command 'delete' do |c|
     c.flag 'file', desc: 'ID of file to delete.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,19 @@ command 'files' do |g|
     end
   end
 
-  g.desc 'This method returns information about a file in your team.'
-  g.long_desc %( This method returns information about a file in your team. )
+  g.desc 'Change the properties of a file (undocumented)'
+  g.long_desc %( Change the properties of a file )
+  g.command 'edit' do |c|
+    c.flag 'file', desc: 'ID of the file to be edited'
+    c.flag 'title', desc: 'New title of the file'
+    c.flag 'filetype', desc: 'New filetype of the file. See https://api.slack.com/types/file#file_types for a list of all supported types.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.files_edit(options))
+    end
+  end
+
+  g.desc 'Gets information about a team file.'
+  g.long_desc %( Gets information about a team file. )
   g.command 'info' do |c|
     c.flag 'file', desc: 'Specify a file by providing its ID.'
     c.action do |_global_options, options, _args|
@@ -20,10 +31,9 @@ command 'files' do |g|
     end
   end
 
-  g.desc 'This method returns a list of files within the team. It can be filtered and sliced in various ways.'
-  g.long_desc %( This method returns a list of files within the team. It can be filtered and sliced in various ways. )
+  g.desc 'Lists & filters team files.'
+  g.long_desc %( Lists & filters team files. )
   g.command 'list' do |c|
-    c.flag 'user', desc: 'Filter files created by a single user.'
     c.flag 'channel', desc: 'Filter files appearing in a specific channel, indicated by its ID.'
     c.flag 'ts_from', desc: 'Filter files created after this timestamp (inclusive).'
     c.flag 'ts_to', desc: 'Filter files created before this timestamp (inclusive).'
@@ -40,13 +50,14 @@ pdfs - PDF files
 
 You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.
 .'
+    c.flag 'user', desc: 'Filter files created by a single user.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_list(options))
     end
   end
 
-  g.desc 'This method disables public/external sharing for a file.'
-  g.long_desc %( This method disables public/external sharing for a file. )
+  g.desc 'Revokes public/external sharing access for a file'
+  g.long_desc %( Revokes public/external sharing access for a file )
   g.command 'revokePublicURL' do |c|
     c.flag 'file', desc: 'File to revoke.'
     c.action do |_global_options, options, _args|
@@ -54,8 +65,18 @@ You can pass multiple values in the types argument, like types=spaces,snippets.T
     end
   end
 
-  g.desc 'This method enables public/external sharing for a file.'
-  g.long_desc %( This method enables public/external sharing for a file. )
+  g.desc 'Share an existing file in a channel (undocumented)'
+  g.long_desc %( Share an existing file in a channel )
+  g.command 'share' do |c|
+    c.flag 'file', desc: 'ID of the file to be shared'
+    c.flag 'channel', desc: 'Channel to share the file in. Works with both public (channel ID) and private channels (group ID).'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.files_share(options))
+    end
+  end
+
+  g.desc 'Enables a file for public/external sharing.'
+  g.long_desc %( Enables a file for public/external sharing. )
   g.command 'sharedPublicURL' do |c|
     c.flag 'file', desc: 'File to share.'
     c.action do |_global_options, options, _args|
@@ -63,16 +84,16 @@ You can pass multiple values in the types argument, like types=spaces,snippets.T
     end
   end
 
-  g.desc 'This method allows you to create or upload an existing file.'
-  g.long_desc %( This method allows you to create or upload an existing file. )
+  g.desc 'Uploads or creates a file.'
+  g.long_desc %( Uploads or creates a file. )
   g.command 'upload' do |c|
-    c.flag 'file', desc: 'File contents via multipart/form-data. If omitting this parameter, you must submit content.'
+    c.flag 'channels', desc: 'Comma-separated list of channel names or IDs where the file will be shared.'
     c.flag 'content', desc: 'File contents via a POST variable. If omitting this parameter, you must provide a file.'
-    c.flag 'filetype', desc: 'A file type identifier.'
+    c.flag 'file', desc: 'File contents via multipart/form-data. If omitting this parameter, you must submit content.'
     c.flag 'filename', desc: 'Filename of file.'
-    c.flag 'title', desc: 'Title of file.'
+    c.flag 'filetype', desc: 'A file type identifier.'
     c.flag 'initial_comment', desc: 'Initial comment to add to file.'
-    c.flag 'channels', desc: 'Comma-separated list of channel names or IDs where the file will be shared.'
+    c.flag 'title', desc: 'Title of file.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_upload(options))
     end

data/bin/commands/files_comments.rb

@@ -5,15 +5,15 @@ command 'files_comments' do |g|
   g.desc 'Add a comment to an existing file.'
   g.long_desc %( Add a comment to an existing file. )
   g.command 'add' do |c|
-    c.flag 'file', desc: 'File to add a comment to.'
     c.flag 'comment', desc: 'Text of the comment to add.'
+    c.flag 'file', desc: 'File to add a comment to.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_comments_add(options))
     end
   end
 
-  g.desc 'Delete an existing comment on a file. Only the original author of the comment or a Team Administrator may delete a file comment.'
-  g.long_desc %( Delete an existing comment on a file. Only the original author of the comment or a Team Administrator may delete a file comment. )
+  g.desc 'Deletes an existing comment on a file.'
+  g.long_desc %( Deletes an existing comment on a file. )
   g.command 'delete' do |c|
     c.flag 'file', desc: 'File to delete a comment from.'
     c.flag 'id', desc: 'The comment to delete.'
@@ -22,12 +22,12 @@ command 'files_comments' do |g|
     end
   end
 
-  g.desc 'Edit an existing comment on a file. Only the user who created a comment may make edits. Teams may configure a limited time window during which file comment edits are allowed.'
-  g.long_desc %( Edit an existing comment on a file. Only the user who created a comment may make edits. Teams may configure a limited time window during which file comment edits are allowed. )
+  g.desc 'Edit an existing file comment.'
+  g.long_desc %( Edit an existing file comment. )
   g.command 'edit' do |c|
+    c.flag 'comment', desc: 'Text of the comment to edit.'
     c.flag 'file', desc: 'File containing the comment to edit.'
     c.flag 'id', desc: 'The comment to edit.'
-    c.flag 'comment', desc: 'Text of the comment to edit.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_comments_edit(options))
     end