slack-api-wrapper 0.0.6 → 0.1.0

data/lib/slack/web/im.rb

@@ -7,7 +7,7 @@ module Slack
     # Get info on your direct messages.
     module Im
       # Endpoint scope
-      SCOPE = "im"
+      SCOPE = 'im'
 
       # Close a direct message channel.
       #
@@ -17,10 +17,10 @@ module Slack
       #   Direct message channel to close.
       #
       # @see https://api.slack.com/methods/im.close
-      def im_close(params={})
-        raise ArgumentError.new("Required arguments 'channel' missing") if params['channel'].nil?
-        response = @session.do_get "#{SCOPE}.close", params
-        Slack::parse_response(response)
+      def im_close(params = {})
+        fail ArgumentError, "Required arguments 'channel' missing" if params['channel'].nil?
+        response = @session.do_post "#{SCOPE}.close", params
+        Slack.parse_response(response)
       end
 
       # Fetches history of messages and events from direct message channel.
@@ -39,10 +39,10 @@ module Slack
       #   Number of messages to return, between 1 and 1000.
       #
       # @see https://api.slack.com/methods/im.history
-      def im_history(params={})
-        raise ArgumentError.new("Required arguments 'channel' missing") if params['channel'].nil?
-        response = @session.do_get "#{SCOPE}.history", params
-        Slack::parse_response(response)
+      def im_history(params = {})
+        fail ArgumentError, "Required arguments 'channel' missing" if params['channel'].nil?
+        response = @session.do_post "#{SCOPE}.history", params
+        Slack.parse_response(response)
       end
 
       # Lists direct message channels for the calling user.
@@ -51,9 +51,9 @@ module Slack
       #   API call arguments
       #
       # @see https://api.slack.com/methods/im.list
-      def im_list(params={})
-        response = @session.do_get "#{SCOPE}.list", params
-        Slack::parse_response(response)
+      def im_list(params = {})
+        response = @session.do_post "#{SCOPE}.list", params
+        Slack.parse_response(response)
       end
 
       # Sets the read cursor in a direct message channel.
@@ -66,11 +66,11 @@ module Slack
       #   Timestamp of the most recently seen message.
       #
       # @see https://api.slack.com/methods/im.mark
-      def im_mark(params={})
-        raise ArgumentError.new("Required arguments 'channel' missing") if params['channel'].nil?
-        raise ArgumentError.new("Required arguments 'ts' missing") if params['ts'].nil?
-        response = @session.do_get "#{SCOPE}.mark", params
-        Slack::parse_response(response)
+      def im_mark(params = {})
+        fail ArgumentError, "Required arguments 'channel' missing" if params['channel'].nil?
+        fail ArgumentError, "Required arguments 'ts' missing" if params['ts'].nil?
+        response = @session.do_post "#{SCOPE}.mark", params
+        Slack.parse_response(response)
       end
 
       # Opens a direct message channel.
@@ -81,12 +81,11 @@ module Slack
       #   User to open a direct message channel with.
       #
       # @see https://api.slack.com/methods/im.open
-      def im_open(params={})
-        raise ArgumentError.new("Required arguments 'user' missing") if params['user'].nil?
-        response = @session.do_get "#{SCOPE}.open", params
-        Slack::parse_response(response)
+      def im_open(params = {})
+        fail ArgumentError, "Required arguments 'user' missing" if params['user'].nil?
+        response = @session.do_post "#{SCOPE}.open", params
+        Slack.parse_response(response)
       end
-
     end
   end
 end

data/lib/slack/web/pins.rb

@@ -0,0 +1,65 @@
+module Slack
+  module Web
+    # Module for the pins methods.
+    module Pins
+      # Endpoint scope
+      SCOPE = 'pins'
+
+      # This method pins an item (file, file comment, channel message,
+      # or group message) to a particular channel.
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'channel'
+      #  	Channel to pin the item in.
+      # @option params [Object] 'file'
+      #   File to pin.
+      # @option params [Object] 'file_comment'
+      #   File comment to pin.
+      # @option params [Object] 'timestamp'
+      #   Timestamp of the message to pin.
+      #
+      # @see https://api.slack.com/methods/pins.add
+      def pins_add(params = {})
+        fail ArgumentError, "Required arguments 'channel' missing" if params['channel'].nil?
+        response = @session.do_post "#{SCOPE}.add", params
+        Slack.parse_response(response)
+      end
+
+      # This method lists the items pinned to a channel.
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'channel'
+      #  	Channel to get pinned items for.
+      #
+      # @see https://api.slack.com/methods/pins.list
+      def pins_list(params = {})
+        fail ArgumentError, "Required arguments 'channel' missing" if params['channel'].nil?
+        response = @session.do_post "#{SCOPE}.list", params
+        Slack.parse_response(response)
+      end
+
+      # This method un-pins an item (file, file comment, channel message,
+      # or group message) from a channel.
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'channel'
+      #  	Channel to pin the item in.
+      # @option params [Object] 'file'
+      #   File to pin.
+      # @option params [Object] 'file_comment'
+      #   File comment to pin.
+      # @option params [Object] 'timestamp'
+      #   Timestamp of the message to pin.
+      #
+      # @see https://api.slack.com/methods/pins.remove
+      def pins_remove(params = {})
+        fail ArgumentError, "Required arguments 'channel' missing" if params['channel'].nil?
+        response = @session.do_post "#{SCOPE}.remove", params
+        Slack.parse_response(response)
+      end
+    end
+  end
+end

data/lib/slack/web/reactions.rb

@@ -0,0 +1,97 @@
+module Slack
+  module Web
+    # Module for the ractions methods.
+    module Reactions
+      # Endpoint scope
+      SCOPE = 'reactions'
+
+      # This method adds a reaction (emoji) to an item
+      # (file, file comment, channel message, group message, or direct message).
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'name'
+      #  	Reaction (emoji) name.
+      # @option params [Object] 'file'
+      #   File to add reaction to.
+      # @option params [Object] 'file_comment'
+      #   File comment to add reaction to.
+      # @option params [Object] 'channel'
+      #  	Channel where the message to add reaction to was posted.
+      # @option params [Object] 'timestamp'
+      #   Timestamp of the message to add reaction to.
+      #
+      # @see https://api.slack.com/methods/reactions.add
+      def reactions_add(params = {})
+        fail ArgumentError, "Required arguments 'name' missing" if params['name'].nil?
+        response = @session.do_post "#{SCOPE}.add", params
+        Slack.parse_response(response)
+      end
+
+      # This method returns a list of all reactions for a single item
+      # (file, file comment, channel message, group message, or direct message).
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'file'
+      #   File to get reactions for.
+      # @option params [Object] 'file_comment'
+      #   File comment to get reactions for.
+      # @option params [Object] 'channel'
+      #  	Channel where the message to get reactions for was posted.
+      # @option params [Object] 'timestamp'
+      #   Timestamp of the message to get reactions for.
+      # @option params [Object] 'full'
+      #   If true always return the complete reaction list.
+      #
+      # @see https://api.slack.com/methods/reactions.get
+      def reactions_get(params = {})
+        response = @session.do_post "#{SCOPE}.add", params
+        Slack.parse_response(response)
+      end
+
+      # This method returns a list of all items (file, file comment,
+      # channel message, group message, or direct message) reacted to by a user.
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'user'
+      #  	Show reactions made by this user. Defaults to the authed user.
+      # @option params [Object] 'full'
+      #   If true always return the complete reaction list.
+      # @option params [Object] 'count'
+      #   Number of items to return per page.
+      # @option params [Object] 'page'
+      #   Page number of results to return.
+      #
+      # @see https://api.slack.com/methods/reactions.list
+      def reactions_list(params = {})
+        response = @session.do_post "#{SCOPE}.list", params
+        Slack.parse_response(response)
+      end
+
+      # This method removes a reaction (emoji) from an item (file, file comment,
+      # channel message, group message, or direct message)
+      #
+      # @param [Hash] params
+      #   API call arguments
+      # @option params [Object] 'name'
+      #  	Reaction (emoji) name.
+      # @option params [Object] 'file'
+      #   File to remove reaction from.
+      # @option params [Object] 'file_comment'
+      #   File comment to remove reaction from.
+      # @option params [Object] 'channel'
+      #  	Channel where the message to remove reaction from was posted.
+      # @option params [Object] 'timestamp'
+      #   Timestamp of the message to remove reaction from.
+      #
+      # @see https://api.slack.com/methods/reactions.remove
+      def reactions_remove(params = {})
+        fail ArgumentError, "Required arguments 'name' missing" if params['name'].nil?
+        response = @session.do_post "#{SCOPE}.remove", params
+        Slack.parse_response(response)
+      end
+    end
+  end
+end

data/lib/slack/web/search.rb

@@ -7,19 +7,19 @@ module Slack
     # Search your team's files and messages.
     module Search
       # Endpoint scope
-      SCOPE = "search"
+      SCOPE = 'search'
 
       # Searches for messages and files matching a query.
       #
       # @param [Hash] params
       #   API call arguments
-      # @option options [Object] 'query'
+      # @option params [Object] 'query'
       #   Search query. May contains booleans, etc.
-      # @option options [Object] 'sort'
+      # @option params [Object] 'sort'
       #   Return matches sorted by either `score` or `timestamp`.
-      # @option options [Object] 'sort_dir'
+      # @option params [Object] 'sort_dir'
       #   Change sort direction to ascending (`asc`) or descending (`desc`).
-      # @option options [Object] 'highlight'
+      # @option params [Object] 'highlight'
       #   Pass a value of `1` to enable query highlight markers.
       # @option params [Object] 'count'
       #   Number of items to return per page.
@@ -27,10 +27,10 @@ module Slack
       #   Page number of results to return.
       #
       # @see https://api.slack.com/methods/search.all
-      def search_all(params={})
-        raise ArgumentError.new("Required arguments 'query' missing") if params['query'].nil?
-        response = @session.do_get "#{SCOPE}.all", params
-        Slack::parse_response(response)
+      def search_all(params = {})
+        fail ArgumentError, "Required arguments 'query' missing" if params['query'].nil?
+        response = @session.do_post "#{SCOPE}.all", params
+        Slack.parse_response(response)
       end
 
       # Searches for files matching a query.
@@ -51,10 +51,10 @@ module Slack
       #   Page number of results to return.
       #
       # @see https://api.slack.com/methods/search.files
-      def search_files(params={})
-        raise ArgumentError.new("Required arguments 'query' missing") if params['query'].nil?
-        response = @session.do_get "#{SCOPE}.files", params
-        Slack::parse_response(response)
+      def search_files(params = {})
+        fail ArgumentError, "Required arguments 'query' missing" if params['query'].nil?
+        response = @session.do_post "#{SCOPE}.files", params
+        Slack.parse_response(response)
       end
 
       # Searches for messages matching a query.
@@ -75,12 +75,11 @@ module Slack
       #   Page number of results to return.
       #
       # @see https://api.slack.com/methods/search.messages
-      def search_messages(params={})
-        raise ArgumentError.new("Required arguments 'query' missing") if params['query'].nil?
-        response = @session.do_get "#{SCOPE}.messages", params
-        Slack::parse_response(response)
+      def search_messages(params = {})
+        fail ArgumentError, "Required arguments 'query' missing" if params['query'].nil?
+        response = @session.do_post "#{SCOPE}.messages", params
+        Slack.parse_response(response)
       end
-
     end
   end
 end

data/lib/slack/web/stars.rb

@@ -6,7 +6,7 @@ module Slack
     # Module for the stars methods.
     module Stars
       # Endpoint scope
-      SCOPE = "stars"
+      SCOPE = 'stars'
 
       # Lists stars for a user.
       #
@@ -20,11 +20,10 @@ module Slack
       #   Page number of results to return.
       #
       # @see https://api.slack.com/methods/stars.list
-      def stars_list(params={})
-        response = @session.do_get "#{SCOPE}.list", params
-        Slack::parse_response(response)
+      def stars_list(params = {})
+        response = @session.do_post "#{SCOPE}.list", params
+        Slack.parse_response(response)
       end
-
     end
   end
 end

data/lib/slack/web/team.rb

@@ -6,7 +6,7 @@ module Slack
     # Module for the teams methods.
     module Team
       # Endpoint scope
-      SCOPE = "team"
+      SCOPE = 'team'
 
       # Gets the access logs for a team.
       #
@@ -18,11 +18,19 @@ module Slack
       #   Page number of results to return.
       #
       # @see https://api.slack.com/methods/team.access_logs
-      def team_access_logs(params={})
-        response = @session.do_get "#{SCOPE}.accessLogs", params
-        Slack::parse_response(response)
+      def team_access_logs(params = {})
+        response = @session.do_post "#{SCOPE}.accessLogs", params
+        Slack.parse_response(response)
       end
 
+      # This method provides information about your team.
+      #
+      # @param [Hash] params
+      #   API call arguments
+      def team_info(params = {})
+        response = @session.do_post "#{SCOPE}.info", params
+        Slack.parse_response(response)
+      end
     end
   end
 end

data/lib/slack/web/users.rb

@@ -7,34 +7,34 @@ module Slack
     # Get info on members of your Slack team.
     module Users
       # Endpoint scope
-      SCOPE = "users"
+      SCOPE = 'users'
 
       # Gets user presence information.
       #
       # @param [Hash] params
       #   API call arguments
-      # @option options [user] 'user'
+      # @option params [user] 'user'
       #   User to get presence info on. Defaults to the authed user.
       #
       # @see https://api.slack.com/methods/users.messages
-      def users_get_presence(params={})
-        raise ArgumentError.new("Required arguments :user missing") if params['user'].nil?
-        response = @session.do_get "#{SCOPE}.getPresence", params
-        Slack::parse_response(response)
+      def users_get_presence(params = {})
+        fail ArgumentError, "Required arguments 'user' missing" if params['user'].nil?
+        response = @session.do_post "#{SCOPE}.getPresence", params
+        Slack.parse_response(response)
       end
 
       # Gets information about a user.
       #
       # @param [Hash] params
       #   API call arguments
-      # @option options [user] 'user'
+      # @option params [user] 'user'
       #   User to get info on
       #
       # @see https://api.slack.com/methods/users.info
-      def users_info(params={})
-        raise ArgumentError.new("Required arguments 'user' missing") if params['user'].nil?
-        response = @session.do_get "#{SCOPE}.info", params
-        Slack::parse_response(response)
+      def users_info(params = {})
+        fail ArgumentError, "Required arguments 'user' missing" if params['user'].nil?
+        response = @session.do_post "#{SCOPE}.info", params
+        Slack.parse_response(response)
       end
 
       # Lists all users in a Slack team.
@@ -43,9 +43,9 @@ module Slack
       #   API call arguments
       #
       # @see https://api.slack.com/methods/users.list
-      def users_list(params={})
-        response = @session.do_get "#{SCOPE}.list", params
-        Slack::parse_response(response)
+      def users_list(params = {})
+        response = @session.do_post "#{SCOPE}.list", params
+        Slack.parse_response(response)
       end
 
       # Marks a user as active.
@@ -54,25 +54,24 @@ module Slack
       #   API call arguments
       #
       # @see https://api.slack.com/methods/users.setActive
-      def users_set_active(params={})
-        response = @session.do_get "#{SCOPE}.setActive", params
-        Slack::parse_response(response)
+      def users_set_active(params = {})
+        response = @session.do_post "#{SCOPE}.setActive", params
+        Slack.parse_response(response)
       end
 
       # Manually sets user presence.
       #
       # @param [Hash] params
       #   API call arguments
-      # @option options [Object] 'presence'
+      # @option params [Object] 'presence'
       #   Either `auto` or `away`
       #
       # @see https://api.slack.com/methods/users.setPresence
-      def users_set_presence(params={})
-        raise ArgumentError.new("Required arguments 'presence' missing") if params['presence'].nil?
-        response = @session.do_get "#{SCOPE}.setPresence", params
-        Slack::parse_response(response)
+      def users_set_presence(params = {})
+        fail ArgumentError, "Required arguments 'presence' missing" if params['presence'].nil?
+        response = @session.do_post "#{SCOPE}.setPresence", params
+        Slack.parse_response(response)
       end
-
     end
   end
 end