slack-ruby-client 0.4.0 → 0.5.0

data/bin/commands/chat.rb

@@ -0,0 +1,47 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.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.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_delete(options))
+    end
+  end
+
+  g.desc 'This method posts a message to a public channel, private group, or IM channel.'
+  g.long_desc %( This method posts a message to a public channel, private group, or IM 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.'
+    c.flag 'username', desc: 'Name of bot.'
+    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot.'
+    c.flag 'parse', desc: 'Change how messages are treated. See below.'
+    c.flag 'link_names', desc: 'Find and link channel names and usernames.'
+    c.flag 'attachments', desc: 'Structured message attachments.'
+    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 'icon_url', desc: 'URL to an image to use as the icon for this message.'
+    c.flag 'icon_emoji', desc: 'emoji to use as the icon for this message. Overrides icon_url.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_postMessage(options))
+    end
+  end
+
+  g.desc 'This method updates a message in a channel.'
+  g.long_desc %( This method updates a message in a channel. )
+  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. See below.'
+    c.flag 'link_names', desc: 'Find and link channel names and usernames.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.chat_update(options))
+    end
+  end
+end

data/bin/commands/emoji.rb

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

data/bin/commands/files.rb

@@ -0,0 +1,61 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.command 'delete' do |c|
+    c.flag 'file', desc: 'ID of file to delete.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.files_delete(options))
+    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.command 'info' do |c|
+    c.flag 'file', desc: 'File to fetch info for.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.files_info(options))
+    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.command 'list' do |c|
+    c.flag 'user', desc: 'Filter files created by a single user.'
+    c.flag 'ts_from', desc: 'Filter files created after this timestamp (inclusive).'
+    c.flag 'ts_to', desc: 'Filter files created before this timestamp (inclusive).'
+    c.flag 'types', desc: 'Filter files by type:
+
+all - All files
+posts - Posts
+snippets - Snippets
+images - Image files
+gdocs - Google docs
+zips - Zip files
+pdfs - PDF files
+
+
+You can pass multiple values in the types argument, like types=posts,snippets.The default value is all, which does not filter the list.
+.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.files_list(options))
+    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.command 'upload' do |c|
+    c.flag 'file', desc: 'File contents via multipart/form-data.'
+    c.flag 'content', desc: 'File contents via a POST var.'
+    c.flag 'filetype', desc: 'Slack-internal file type identifier.'
+    c.flag 'filename', desc: 'Filename of file.'
+    c.flag 'title', desc: 'Title of file.'
+    c.flag 'initial_comment', desc: 'Initial comment to add to file.'
+    c.flag 'channels', desc: 'Comma separated list of channels to share the file into.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.files_upload(options))
+    end
+  end
+end

data/bin/commands/groups.rb

@@ -0,0 +1,158 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+desc "Get info on your team's private groups."
+command 'groups' do |g|
+  g.desc 'This method archives a private group.'
+  g.long_desc %( This method archives a private group. )
+  g.command 'archive' do |c|
+    c.flag 'channel', desc: 'Private group to archive.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_archive(options))
+    end
+  end
+
+  g.desc 'This method closes a private group.'
+  g.long_desc %( This method closes a private group. )
+  g.command 'close' do |c|
+    c.flag 'channel', desc: 'Group 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 group.'
+  g.long_desc %( This method creates a private group. )
+  g.command 'create' do |c|
+    c.flag 'name', desc: 'Name of group to create.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_create(options))
+    end
+  end
+
+  g.desc 'This method takes an existing private group and performs the following steps:'
+  g.long_desc %( This method takes an existing private group and performs the following steps: )
+  g.command 'createChild' do |c|
+    c.flag 'channel', desc: 'Group to clone and archive.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_createChild(options))
+    end
+  end
+
+  g.desc 'This method returns a portion of messages/events from the specified private group.'
+  g.long_desc %( This method returns a portion of messages/events from the specified private group. To read the entire history for a group, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
+  g.command 'history' do |c|
+    c.flag 'channel', desc: 'Group to fetch history for.'
+    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 group.'
+  g.long_desc %( This method returns information about a private group. )
+  g.command 'info' do |c|
+    c.flag 'channel', desc: 'Group to get info on.'
+    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 group. The calling user must be a member of the group.'
+  g.long_desc %( This method is used to invite a user to a private group. The calling user must be a member of the group. )
+  g.command 'invite' do |c|
+    c.flag 'channel', desc: 'Private group to invite user to.'
+    c.flag 'user', desc: 'User to invite.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_invite(options))
+    end
+  end
+
+  g.desc 'This method allows a user to remove another member from a private group.'
+  g.long_desc %( This method allows a user to remove another member from a private group. )
+  g.command 'kick' do |c|
+    c.flag 'channel', desc: 'Group to remove user from.'
+    c.flag 'user', desc: 'User to remove from group.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_kick(options))
+    end
+  end
+
+  g.desc 'This method is used to leave a private group.'
+  g.long_desc %( This method is used to leave a private group. )
+  g.command 'leave' do |c|
+    c.flag 'channel', desc: 'Group to leave.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_leave(options))
+    end
+  end
+
+  g.desc 'This method returns a list of groups 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 groups in the team that the caller is in and archived groups that the caller was in. The list of (non-deactivated) members in each group is also returned. )
+  g.command 'list' do |c|
+    c.flag 'exclude_archived', desc: "Don't return archived groups."
+    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 group.'
+  g.long_desc %( This method moves the read cursor in a private group. )
+  g.command 'mark' do |c|
+    c.flag 'channel', desc: 'Group to set reading cursor in.'
+    c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_mark(options))
+    end
+  end
+
+  g.desc 'This method opens a private group.'
+  g.long_desc %( This method opens a private group. )
+  g.command 'open' do |c|
+    c.flag 'channel', desc: 'Group to open.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_open(options))
+    end
+  end
+
+  g.desc 'This method renames a private group.'
+  g.long_desc %( This method renames a private group. )
+  g.command 'rename' do |c|
+    c.flag 'channel', desc: 'Group to rename.'
+    c.flag 'name', desc: 'New name for group.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_rename(options))
+    end
+  end
+
+  g.desc 'This method is used to change the purpose of a private group. The calling user must be a member of the private group.'
+  g.long_desc %( This method is used to change the purpose of a private group. The calling user must be a member of the private group. )
+  g.command 'setPurpose' do |c|
+    c.flag 'channel', desc: 'Private group to set the purpose of.'
+    c.flag 'purpose', desc: 'The new purpose.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_setPurpose(options))
+    end
+  end
+
+  g.desc 'This method is used to change the topic of a private group. The calling user must be a member of the private group.'
+  g.long_desc %( This method is used to change the topic of a private group. The calling user must be a member of the private group. )
+  g.command 'setTopic' do |c|
+    c.flag 'channel', desc: 'Private group to set the topic of.'
+    c.flag 'topic', desc: 'The new topic.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_setTopic(options))
+    end
+  end
+
+  g.desc 'This method unarchives a private group.'
+  g.long_desc %( This method unarchives a private group. )
+  g.command 'unarchive' do |c|
+    c.flag 'channel', desc: 'Group to unarchive.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.groups_unarchive(options))
+    end
+  end
+end

data/bin/commands/im.rb

@@ -0,0 +1,53 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.command 'close' do |c|
+    c.flag 'channel', desc: 'Direct message channel to close.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.im_close(options))
+    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.command 'history' do |c|
+    c.flag 'channel', desc: 'Direct message channel to fetch history for.'
+    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.command 'list' do |c|
+    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.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.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.im_mark(options))
+    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.command 'open' do |c|
+    c.flag 'user', desc: 'User to open a direct message channel with.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.im_open(options))
+    end
+  end
+end

data/bin/commands/mpim.rb

@@ -0,0 +1,53 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.command 'close' do |c|
+    c.flag 'channel', desc: 'MPIM to close.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.mpim_close(options))
+    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.command 'history' do |c|
+    c.flag 'channel', desc: 'Multiparty direct message to fetch history for.'
+    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.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.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.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.mpim_mark(options))
+    end
+  end
+
+  g.desc 'This method opens a multiparty direct message.'
+  g.long_desc %( This method opens a multiparty direct message. )
+  g.command 'open' do |c|
+    c.flag 'users', desc: 'Comma separated lists of users.  The ordering of the users is preserved whenever a MPIM group is returned.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.mpim_open(options))
+    end
+  end
+end

data/bin/commands/oauth.rb

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

data/bin/commands/pins.rb

@@ -0,0 +1,37 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.command 'add' do |c|
+    c.flag 'channel', desc: 'Channel to pin the item in.'
+    c.flag 'file', desc: 'File to pin.'
+    c.flag 'file_comment', desc: 'File comment to pin.'
+    c.flag 'timestamp', desc: 'Timestamp of the message to pin.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.pins_add(options))
+    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.command 'list' do |c|
+    c.flag 'channel', desc: 'Channel to get pinned items for.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.pins_list(options))
+    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.command 'remove' do |c|
+    c.flag 'channel', desc: 'Channel where the item is pinned to.'
+    c.flag 'file', desc: 'File to un-pin.'
+    c.flag 'file_comment', desc: 'File comment to un-pin.'
+    c.flag 'timestamp', desc: 'Timestamp of the message to un-pin.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.pins_remove(options))
+    end
+  end
+end

data/bin/commands/reactions.rb

@@ -0,0 +1,53 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.command 'add' do |c|
+    c.flag 'name', desc: 'Reaction (emoji) name.'
+    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.command 'get' do |c|
+    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.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.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.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.command 'remove' do |c|
+    c.flag 'name', desc: 'Reaction (emoji) name.'
+    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))
+    end
+  end
+end