slack-ruby-client 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d6e26bc5f3e7e53c67ece14f51482ba24bfbbd1
-  data.tar.gz: c83f574cf4041f1507c3ffdf9a0716669306ead9
+  metadata.gz: bddd0a87e5708039190f6426332ea467d989f691
+  data.tar.gz: 20b28016a329478c0dfcf1ebfb270c33e7c9e5b7
 SHA512:
-  metadata.gz: 6753176ae587da7add086f67a6d51f9451e4160283ac369bef881743c1930c0b571b048d6c25bc54c8d2347ddf42f32024a46ed1cc93207fee346b55a7dfe8d5
-  data.tar.gz: a1e45d53c9e0e1bb04369f4ad3f94fd7f061d92a0d8f2974fa89861c75a001cbfb7ea5cac63812ea4cab4fe3c7e9e411408731047d1d2be3f259b744b2e24153
+  metadata.gz: 617b369a14e5c896000962d3c917ba05d07af9cffdb6c08891ceb389161ff0f5e2de568601e0460ac99bd1fc1cdcaf7ed91cb6ea647797e00600ef9fad348c7b
+  data.tar.gz: 84bfc168239d0e7699b9f2192a5a1dde2c272a32910cc6867ed8ecb71a0ec83e9d7216a7cef3e3c7f66e67b79b8f5a5e9142f6c1b7a359e205be6e65575d088c

data/.travis.yml

@@ -1,8 +1,8 @@
 rvm:
   - 2.2
   - 2.1
-  - 2.0.0
-  - rbx-2.2.10
+  - 2.0
+  - rbx-2.9
   - jruby-19mode
   - ruby-head
   - jruby-head

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+### 0.5.1 (1/4/2016)
+
+* Added `dnd_teamInfo`, `dnd_setSnooze`, `dnd_info`, `dnd_endSnooze` and `dnd_endDnd` - [@dblock](https://github.com/dblock).
+* The `files_upload` method now requires both `file` and `filename` - [@dblock](https://github.com/dblock).
+
 ### 0.5.0 (12/7/2015)
 
 * Added `usergroups_create`, `usergroups_disable`, `usergroups_enable`, `usergroups_list`, `usergroups_update` and `usergroups_users` to Web API - [@dblock](https://github.com/dblock).

data/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2015 Daniel Doubrovkine, Artsy and Contributors
+Copyright (c) 2015-2016 Daniel Doubrovkine, Artsy and Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -7,13 +7,18 @@ Slack Ruby Client
 
 A Ruby client for the Slack [Web](https://api.slack.com/web) and [RealTime Messaging](https://api.slack.com/rtm) APIs. Comes with a handy command-line client, too.
 
-Writing a bot? Try [slack-ruby-bot](https://github.com/dblock/slack-ruby-bot) instead.
-
 ![](slack.png)
 
+## Useful to Me?
+
+* This piece of the puzzle will help you send messages to Slack via the Web API and send and receive messages via the Real Time API.
+* If you're trying to respond to slash commands, just write a basic web application and use this library to call the Slack Web API.
+* If you're trying to build a Real Time bot, use [slack-ruby-bot](https://github.com/dblock/slack-ruby-bot), which uses this library.
+* If you're trying to roll out a full service with Slack button integration to multiple teams, check out [slack-bot-server](https://github.com/dblock/slack-bot-server), which is built on top of slack-ruby-bot, which uses this library.
+
 ## Stable Release
 
-You're reading the documentation for [stable release, v0.5.0](https://github.com/dblock/slack-ruby-client/blob/v0.5.0/README.md). See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, 0.5.1. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -36,7 +41,7 @@ Run `bundle install`.
 
 ### Create a New Bot Integration
 
-This is something done in Slack, under [integrations](https://artsy.slack.com/services). Create a [new bot](https://artsy.slack.com/services/new/bot), and note its API token.
+This is something done in Slack, under [integrations](https://my.slack.com/services). Create a [new bot](https://my.slack.com/services/new/bot), and note its API token.
 
 ![](screenshots/register-bot.png)
 
@@ -52,24 +57,58 @@ This sets a global default token. You can also pass a token into the initializer
 
 ### Web Client
 
-The Slack Web API allows you to build applications that interact with Slack. For example, send messages with [chat_PostMessage](https://api.slack.com/methods/chat.postMessage).
+The Slack Web API allows you to build applications that interact with Slack.
+
+#### Test Auth
 
 ```ruby
 client = Slack::Web::Client.new
-
 client.auth_test
+```
 
-general_channel = client.channels_list['channels'].detect { |c| c['name'] == 't3' }
+#### Send Messages
 
-client.chat_postMessage(channel: general_channel['id'], text: 'Hello World', as_user: true)
+Send messages with [chat_PostMessage](https://api.slack.com/methods/chat.postMessage).
+
+```ruby
+client.chat_postMessage(channel: '#general', text: 'Hello World', as_user: true)
 ```
 
 See a fully working example in [examples/hi_web](examples/hi_web/hi.rb).
 
 ![](examples/hi_web/hi.gif)
 
+#### List Channels
+
+List channels with [channels_list](https://api.slack.com/methods/channels.list).
+
+```ruby
+channels = client.channels_list['channels']
+
+general_channel = channels.detect { |c| c['name'] == 'general' }
+```
+
+#### Upload a File
+
+Upload a file with [files_upload](https://api.slack.com/methods/files.upload).
+
+```ruby
+client.files_upload(
+  channels: '#general',
+  as_user: true,
+  file: Faraday::UploadIO.new('/path/to/avatar.jpg', 'image/jpeg'),
+  title: 'My Avatar',
+  filename: 'avatar.jpg',
+  initial_comment: 'Attached a selfie.'
+)
+```
+
+#### Other
+
 Refer to the [Slack Web API Method Reference](https://api.slack.com/methods) for the list of all available functions.
 
+#### Web Client Options
+
 You can configure the Web client either globally or via the initializer.
 
 ```ruby
@@ -276,6 +315,6 @@ See [CONTRIBUTING](CONTRIBUTING.md).
 
 ## Copyright and License
 
-Copyright (c) 2015, [Daniel Doubrovkine](https://twitter.com/dblockdotorg), [Artsy](https://www.artsy.net) and [Contributors](CHANGELOG.md).
+Copyright (c) 2015-2016, [Daniel Doubrovkine](https://twitter.com/dblockdotorg), [Artsy](https://www.artsy.net) and [Contributors](CHANGELOG.md).
 
 This project is licensed under the [MIT License](LICENSE.md).

data/Rakefile

@@ -11,9 +11,13 @@ RSpec::Core::RakeTask.new(:spec) do |spec|
   spec.pattern = FileList['spec/**/*_spec.rb']
 end
 
-require 'rubocop/rake_task'
-RuboCop::RakeTask.new
+if RUBY_ENGINE == 'rbx'
+  task default: [:spec]
+else
+  require 'rubocop/rake_task'
+  RuboCop::RakeTask.new
 
-task default: [:rubocop, :spec]
+  task default: [:rubocop, :spec]
+end
 
 load 'slack/web/api/tasks/generate.rake'

data/bin/commands.rb

@@ -4,6 +4,7 @@ require 'commands/api'
 require 'commands/auth'
 require 'commands/channels'
 require 'commands/chat'
+require 'commands/dnd'
 require 'commands/emoji'
 require 'commands/files'
 require 'commands/groups'

data/bin/commands/channels.rb

@@ -80,8 +80,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'
-  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. The number of (non-deactivated) members in each channel is also returned. )
+  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.command 'list' do |c|
     c.flag 'exclude_archived', desc: "Don't return archived channels."
     c.action do |_global_options, options, _args|

data/bin/commands/dnd.rb

@@ -0,0 +1,47 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+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.command 'endDnd' do |c|
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.dnd_endDnd(options))
+    end
+  end
+
+  g.desc "Ends the current user's snooze mode immediately."
+  g.long_desc %( Ends the current user's snooze mode immediately. )
+  g.command 'endSnooze' do |c|
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.dnd_endSnooze(options))
+    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.command 'info' do |c|
+    c.flag 'user', desc: 'User to fetch status for (defaults to current user).'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.dnd_info(options))
+    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.command 'setSnooze' do |c|
+    c.flag 'num_minutes', desc: 'Number of minutes, from now, to snooze until.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.dnd_setSnooze(options))
+    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.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|
+      puts JSON.dump($client.dnd_teamInfo(options))
+    end
+  end
+end

data/bin/commands/files.rb

@@ -53,7 +53,7 @@ You can pass multiple values in the types argument, like types=posts,snippets.Th
     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.flag 'channels', desc: 'Comma-separated list of channel names or IDs where the file will be shared.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_upload(options))
     end

data/bin/commands/groups.rb

@@ -1,47 +1,47 @@
 # This file was auto-generated by lib/slack/web/api/tasks/generate.rake
 
-desc "Get info on your team's private groups."
+desc "Get info on your team's private channels."
 command 'groups' do |g|
-  g.desc 'This method archives a private group.'
-  g.long_desc %( This method archives a private group. )
+  g.desc 'This method archives a private channel.'
+  g.long_desc %( This method archives a private channel. )
   g.command 'archive' do |c|
-    c.flag 'channel', desc: 'Private group to archive.'
+    c.flag 'channel', desc: 'Private channel 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.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: 'Group to close.'
+    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 group.'
-  g.long_desc %( This method creates a private group. )
+  g.desc 'This method creates a private channel.'
+  g.long_desc %( This method creates a private channel. )
   g.command 'create' do |c|
-    c.flag 'name', desc: 'Name of group to create.'
+    c.flag 'name', desc: 'Name of private channel 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.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.command 'createChild' do |c|
-    c.flag 'channel', desc: 'Group to clone and archive.'
+    c.flag 'channel', desc: 'Private channel 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.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.command 'history' do |c|
-    c.flag 'channel', desc: 'Group to fetch history for.'
+    c.flag 'channel', desc: 'Private 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.'
@@ -51,106 +51,106 @@ command 'groups' do |g|
     end
   end
 
-  g.desc 'This method returns information about a private group.'
-  g.long_desc %( This method returns information about a private group. )
+  g.desc 'This method returns information about a private channel.'
+  g.long_desc %( This method returns information about a private channel. )
   g.command 'info' do |c|
-    c.flag 'channel', desc: 'Group to get info on.'
+    c.flag 'channel', desc: 'Private channel 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.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.command 'invite' do |c|
-    c.flag 'channel', desc: 'Private group to invite user to.'
+    c.flag 'channel', desc: 'Private channel 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.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.command 'kick' do |c|
-    c.flag 'channel', desc: 'Group to remove user from.'
-    c.flag 'user', desc: 'User to remove from group.'
+    c.flag 'channel', desc: 'Private channel to remove user from.'
+    c.flag 'user', desc: 'User to remove from private channel.'
     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.desc 'This method is used to leave a private channel.'
+  g.long_desc %( This method is used to leave a private channel. )
   g.command 'leave' do |c|
-    c.flag 'channel', desc: 'Group to leave.'
+    c.flag 'channel', desc: 'Private channel 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.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.command 'list' do |c|
-    c.flag 'exclude_archived', desc: "Don't return archived groups."
+    c.flag 'exclude_archived', desc: "Don't return archived private channels."
     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.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.command 'mark' do |c|
-    c.flag 'channel', desc: 'Group to set reading cursor in.'
+    c.flag 'channel', desc: 'Private 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.groups_mark(options))
     end
   end
 
-  g.desc 'This method opens a private group.'
-  g.long_desc %( This method opens a private group. )
+  g.desc 'This method opens a private channel.'
+  g.long_desc %( This method opens a private channel. )
   g.command 'open' do |c|
-    c.flag 'channel', desc: 'Group to open.'
+    c.flag 'channel', desc: 'Private channel 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.desc 'This method renames a private channel.'
+  g.long_desc %( This method renames a private channel. )
   g.command 'rename' do |c|
-    c.flag 'channel', desc: 'Group to rename.'
-    c.flag 'name', desc: 'New name for group.'
+    c.flag 'channel', desc: 'Private channel to rename.'
+    c.flag 'name', desc: 'New name for private channel.'
     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.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.command 'setPurpose' do |c|
-    c.flag 'channel', desc: 'Private group to set the purpose of.'
+    c.flag 'channel', desc: 'Private channel 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.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.command 'setTopic' do |c|
-    c.flag 'channel', desc: 'Private group to set the topic of.'
+    c.flag 'channel', desc: 'Private channel 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.desc 'This method unarchives a private channel.'
+  g.long_desc %( This method unarchives a private channel. )
   g.command 'unarchive' do |c|
-    c.flag 'channel', desc: 'Group to unarchive.'
+    c.flag 'channel', desc: 'Private channel to unarchive.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.groups_unarchive(options))
     end

data/bin/commands/team.rb

@@ -22,7 +22,7 @@ command 'team' do |g|
   g.long_desc %( This method lists the integration activity logs for a team, including when integrations are added, modified and removed. This method can only be called by Admins. )
   g.command 'integrationLogs' do |c|
     c.flag 'service_id', desc: 'Filter logs to this service. Defaults to all logs.'
-    c.flag 'app_id', desc: 'Filter logs to this API application. Defaults to all logs.'
+    c.flag 'app_id', desc: 'Filter logs to this Slack app. Defaults to all logs.'
     c.flag 'user', desc: "Filter logs generated by this user's actions. Defaults to all logs."
     c.flag 'change_type', desc: 'Filter logs with this change type. Defaults to all logs.'
     c.action do |_global_options, options, _args|

data/lib/slack/version.rb

@@ -1,3 +1,3 @@
 module Slack
-  VERSION = '0.5.0'
+  VERSION = '0.5.1'
 end

data/lib/slack/web/api/endpoints.rb

@@ -4,6 +4,7 @@ require 'slack/web/api/endpoints/api'
 require 'slack/web/api/endpoints/auth'
 require 'slack/web/api/endpoints/channels'
 require 'slack/web/api/endpoints/chat'
+require 'slack/web/api/endpoints/dnd'
 require 'slack/web/api/endpoints/emoji'
 require 'slack/web/api/endpoints/files'
 require 'slack/web/api/endpoints/groups'
@@ -27,6 +28,7 @@ module Slack
         include Auth
         include Channels
         include Chat
+        include Dnd
         include Emoji
         include Files
         include Groups

data/lib/slack/web/api/endpoints/channels.rb

@@ -119,9 +119,7 @@ module Slack
           end
 
           #
-          # 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. The number of (non-deactivated) members in each channel
-          # is also returned.
+          # 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.
           #
           # @option options [Object] :exclude_archived
           #   Don't return archived channels.

data/lib/slack/web/api/endpoints/dnd.rb

@@ -0,0 +1,63 @@
+# This file was auto-generated by lib/slack/web/api/tasks/generate.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Dnd
+          #
+          # Ends the user's currently scheduled Do Not Disturb session immediately.
+          #
+          # @see https://api.slack.com/methods/dnd.endDnd
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.endDnd.json
+          def dnd_endDnd(options = {})
+            post('dnd.endDnd', options)
+          end
+
+          #
+          # Ends the current user's snooze mode immediately.
+          #
+          # @see https://api.slack.com/methods/dnd.endSnooze
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.endSnooze.json
+          def dnd_endSnooze(options = {})
+            post('dnd.endSnooze', options)
+          end
+
+          #
+          # Provides information about a user's current Do Not Disturb settings.
+          #
+          # @option options [user] :user
+          #   User to fetch status for (defaults to current user).
+          # @see https://api.slack.com/methods/dnd.info
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.info.json
+          def dnd_info(options = {})
+            post('dnd.info', options)
+          end
+
+          #
+          # 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.
+          #
+          # @option options [Object] :num_minutes
+          #   Number of minutes, from now, to snooze until.
+          # @see https://api.slack.com/methods/dnd.setSnooze
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.setSnooze.json
+          def dnd_setSnooze(options = {})
+            throw ArgumentError.new('Required arguments :num_minutes missing') if options[:num_minutes].nil?
+            post('dnd.setSnooze', options)
+          end
+
+          #
+          # Provides information about the current Do Not Disturb settings for users of a Slack team.
+          #
+          # @option options [Object] :users
+          #   Comma-separated list of users to fetch Do Not Disturb status for.
+          # @see https://api.slack.com/methods/dnd.teamInfo
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.teamInfo.json
+          def dnd_teamInfo(options = {})
+            post('dnd.teamInfo', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/files.rb

@@ -74,10 +74,12 @@ module Slack
           # @option options [Object] :initial_comment
           #   Initial comment to add to file.
           # @option options [Object] :channels
-          #   Comma separated list of channels to share the file into.
+          #   Comma-separated list of channel names or IDs where the file will be shared.
           # @see https://api.slack.com/methods/files.upload
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.upload.json
           def files_upload(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            throw ArgumentError.new('Required arguments :filename missing') if options[:filename].nil?
             post('files.upload', options)
           end
         end

data/lib/slack/web/api/endpoints/groups.rb

@@ -6,10 +6,10 @@ module Slack
       module Endpoints
         module Groups
           #
-          # This method archives a private group.
+          # This method archives a private channel.
           #
           # @option options [group] :channel
-          #   Private group to archive.
+          #   Private channel to archive.
           # @see https://api.slack.com/methods/groups.archive
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.archive.json
           def groups_archive(options = {})
@@ -18,10 +18,10 @@ module Slack
           end
 
           #
-          # This method closes a private group.
+          # This method closes a private channel.
           #
           # @option options [group] :channel
-          #   Group to close.
+          #   Private channel to close.
           # @see https://api.slack.com/methods/groups.close
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.close.json
           def groups_close(options = {})
@@ -30,10 +30,10 @@ module Slack
           end
 
           #
-          # This method creates a private group.
+          # This method creates a private channel.
           #
           # @option options [Object] :name
-          #   Name of group to create.
+          #   Name of private channel to create.
           # @see https://api.slack.com/methods/groups.create
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.create.json
           def groups_create(options = {})
@@ -42,10 +42,10 @@ module Slack
           end
 
           #
-          # This method takes an existing private group and performs the following steps:
+          # This method takes an existing private channel and performs the following steps:
           #
           # @option options [group] :channel
-          #   Group to clone and archive.
+          #   Private channel to clone and archive.
           # @see https://api.slack.com/methods/groups.createChild
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.createChild.json
           def groups_createChild(options = {})
@@ -54,12 +54,12 @@ module Slack
           end
 
           #
-          # 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
+          # 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.
           #
           # @option options [group] :channel
-          #   Group to fetch history for.
+          #   Private channel to fetch history for.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
           # @option options [timestamp] :oldest
@@ -76,10 +76,10 @@ module Slack
           end
 
           #
-          # This method returns information about a private group.
+          # This method returns information about a private channel.
           #
           # @option options [group] :channel
-          #   Group to get info on.
+          #   Private channel to get info on.
           # @see https://api.slack.com/methods/groups.info
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.info.json
           def groups_info(options = {})
@@ -88,10 +88,10 @@ module Slack
           end
 
           #
-          # This method is used to invite a user to a private group. The calling user must be a member of the group.
+          # This method is used to invite a user to a private channel. The calling user must be a member of the private channel.
           #
           # @option options [group] :channel
-          #   Private group to invite user to.
+          #   Private channel to invite user to.
           # @option options [user] :user
           #   User to invite.
           # @see https://api.slack.com/methods/groups.invite
@@ -103,12 +103,12 @@ module Slack
           end
 
           #
-          # This method allows a user to remove another member from a private group.
+          # This method allows a user to remove another member from a private channel.
           #
           # @option options [group] :channel
-          #   Group to remove user from.
+          #   Private channel to remove user from.
           # @option options [user] :user
-          #   User to remove from group.
+          #   User to remove from private channel.
           # @see https://api.slack.com/methods/groups.kick
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.kick.json
           def groups_kick(options = {})
@@ -118,10 +118,10 @@ module Slack
           end
 
           #
-          # This method is used to leave a private group.
+          # This method is used to leave a private channel.
           #
           # @option options [group] :channel
-          #   Group to leave.
+          #   Private channel to leave.
           # @see https://api.slack.com/methods/groups.leave
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.leave.json
           def groups_leave(options = {})
@@ -130,11 +130,11 @@ module Slack
           end
 
           #
-          # 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.
+          # 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.
           #
           # @option options [Object] :exclude_archived
-          #   Don't return archived groups.
+          #   Don't return archived private channels.
           # @see https://api.slack.com/methods/groups.list
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.list.json
           def groups_list(options = {})
@@ -142,10 +142,10 @@ module Slack
           end
 
           #
-          # This method moves the read cursor in a private group.
+          # This method moves the read cursor in a private channel.
           #
           # @option options [group] :channel
-          #   Group to set reading cursor in.
+          #   Private channel to set reading cursor in.
           # @option options [timestamp] :ts
           #   Timestamp of the most recently seen message.
           # @see https://api.slack.com/methods/groups.mark
@@ -157,10 +157,10 @@ module Slack
           end
 
           #
-          # This method opens a private group.
+          # This method opens a private channel.
           #
           # @option options [group] :channel
-          #   Group to open.
+          #   Private channel to open.
           # @see https://api.slack.com/methods/groups.open
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.open.json
           def groups_open(options = {})
@@ -169,12 +169,12 @@ module Slack
           end
 
           #
-          # This method renames a private group.
+          # This method renames a private channel.
           #
           # @option options [group] :channel
-          #   Group to rename.
+          #   Private channel to rename.
           # @option options [Object] :name
-          #   New name for group.
+          #   New name for private channel.
           # @see https://api.slack.com/methods/groups.rename
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.rename.json
           def groups_rename(options = {})
@@ -184,10 +184,10 @@ module Slack
           end
 
           #
-          # This method is used to change the purpose of a private group. The calling user must be a member of the private group.
+          # This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.
           #
           # @option options [group] :channel
-          #   Private group to set the purpose of.
+          #   Private channel to set the purpose of.
           # @option options [Object] :purpose
           #   The new purpose.
           # @see https://api.slack.com/methods/groups.setPurpose
@@ -199,10 +199,10 @@ module Slack
           end
 
           #
-          # This method is used to change the topic of a private group. The calling user must be a member of the private group.
+          # This method is used to change the topic of a private channel. The calling user must be a member of the private channel.
           #
           # @option options [group] :channel
-          #   Private group to set the topic of.
+          #   Private channel to set the topic of.
           # @option options [Object] :topic
           #   The new topic.
           # @see https://api.slack.com/methods/groups.setTopic
@@ -214,10 +214,10 @@ module Slack
           end
 
           #
-          # This method unarchives a private group.
+          # This method unarchives a private channel.
           #
           # @option options [group] :channel
-          #   Group to unarchive.
+          #   Private channel to unarchive.
           # @see https://api.slack.com/methods/groups.unarchive
           # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.unarchive.json
           def groups_unarchive(options = {})

data/lib/slack/web/api/endpoints/team.rb

@@ -29,7 +29,7 @@ module Slack
           # @option options [Object] :service_id
           #   Filter logs to this service. Defaults to all logs.
           # @option options [Object] :app_id
-          #   Filter logs to this API application. Defaults to all logs.
+          #   Filter logs to this Slack app. Defaults to all logs.
           # @option options [user] :user
           #   Filter logs generated by this user's actions. Defaults to all logs.
           # @option options [Object] :change_type

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-client
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Daniel Doubrovkine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-12-07 00:00:00.000000000 Z
+date: 2016-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -204,6 +204,7 @@ files:
 - bin/commands/auth.rb
 - bin/commands/channels.rb
 - bin/commands/chat.rb
+- bin/commands/dnd.rb
 - bin/commands/emoji.rb
 - bin/commands/files.rb
 - bin/commands/groups.rb
@@ -251,6 +252,7 @@ files:
 - lib/slack/web/api/endpoints/auth.rb
 - lib/slack/web/api/endpoints/channels.rb
 - lib/slack/web/api/endpoints/chat.rb
+- lib/slack/web/api/endpoints/dnd.rb
 - lib/slack/web/api/endpoints/emoji.rb
 - lib/slack/web/api/endpoints/files.rb
 - lib/slack/web/api/endpoints/groups.rb