disqussion 0.0.1

data/lib/disqussion/client/posts.rb

@@ -0,0 +1,217 @@
+module Disqussion
+  class Posts < Client
+    # Approves a post.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Array, Integer] allows multiple. Looks up a post by ID. You must be a moderator on the selected post's forum.
+    # @return [Hashie::Rash] Approved post id
+    # @example Approves post with ID 198230
+    #   Disqussion::Client.posts.approve(198230)
+    # @see: http://disqus.com/api/3.0/posts/approve.json
+    def approve(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/approve', options)
+    end
+    
+    # Creates a new post.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param message [String] Message.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :parent Defaults to null. Looks up a post by ID
+    # @option options [Integer] :thread Defaults to null. Looks up a thread by ID
+    # @option options [String] :author_email Defaults to null. Email address (defined by RFC 5322)
+    # @option options [String] :author_name Defaults to null
+    # @option options [String] :state Defaults to null. Choices: unapproved, approved, spam, killed
+    # @option options [String] :author_url Defaults to null. URL (defined by RFC 3986)
+    # @option options [Datetime] :date Defaults to null. Unix timestamp (or ISO datetime standard)
+    # @option options [String] :ip_address Defaults to null. IP address (defined by RFC 5322)
+    # @return [Hashie::Rash] New post infos 
+    # @example Creates a new post 'hello world' in 167820 167820
+    #   Disqussion::Client.posts.create("hello world", :thread => 167820)
+    # @see: http://disqus.com/api/3.0/posts/create.json
+    def create(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:message] = args.first
+      response = post('posts/create', options)
+    end
+    
+    # Returns post details.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param post [Integer] Post ID
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer, String] :related. Allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, thread.
+    # @return [Hashie::Rash] Details on the requested post.
+    # @example Return extended information for post 193673
+    #   Disqussion::Client.posts.details(193673)
+    # @see: http://disqus.com/api/3.0/posts/details.json
+    def details(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = get('posts/details', options)
+    end
+    
+    # Highlights a post.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Array, Integer] allows multiple. Looks up a post by ID.
+    # @return [Hashie::Rash] Highlighted post id
+    # @example Highlights post with ID 198230
+    #   Disqussion::Client.posts.highlight(198230)
+    # @see: http://disqus.com/api/3.0/posts/highlight.json
+    def highlight(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/highlight', options)
+    end
+    
+    # Returns a list of posts ordered by the date created.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @param options [Hash] A customizable set of options.
+    # @option options [Array, String] :category allow multiple. Defaults to null. Looks up a category by ID
+    # @option options [Array, String] :thread allow multiple. Defaults to null. Looks up a thread by ID
+    # @option options [Array, String] :forum allow multiple. Defaults to null. Defaults to all forums you moderate if no other filters are specified. Looks up a forum by ID (aka short name)
+    # @option options [Datetime, Timestamp] :since Defaults to null. Unix timestamp (or ISO datetime standard).
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, thread
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :offset. Defaults to 0. Deprecated: Please see documentation on cursors
+    # @option options [Integer] :query. Defaults to null.
+    # @option options [String, Array] :include allows multiple. Defaults to ["approved"]. Choices: unapproved, approved, spam, deleted, flagged, highlighted
+    # @option options [String] :order. Defaults to "desc". Choices: asc, desc
+    # @return [Hashie::Rash] Returns a list of posts ordered by the date created..
+    # @example Return list of posts for thread 193673
+    #   Disqussion::Client.posts.list(:thread => 193673)
+    # @see: http://disqus.com/api/3.0/posts/list.json
+    def list(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('posts/list', options)
+    end
+    
+    # Deletes the requested post(s).
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Array, Integer] allows multiple. Looks up a post by ID.
+    # @return [Hashie::Rash] Removed post id
+    # @example Deletes post with ID 198230
+    #   Disqussion::Client.posts.remove(198230)
+    # @see: http://disqus.com/api/3.0/posts/remove.json
+    def remove(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/remove', options)
+    end
+    
+    # Reports a post (flagging).
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param post [Integer] Looks up a post by ID.
+    # @return [Hashie::Rash] Reported post id
+    # @example Deletes post with ID 198230
+    #   Disqussion::Client.posts.report(198230)
+    # @see: http://disqus.com/api/3.0/posts/report.json
+    def report(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/report', options)
+    end
+    
+    # Undeletes the requested post(s).
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Array, Integer] allows multiple. Looks up a post by ID.
+    # @return [Hashie::Rash] restored post id
+    # @example Undeletes post with ID 198230
+    #   Disqussion::Client.posts.restore(198230)
+    # @see: http://disqus.com/api/3.0/posts/restore.json
+    def restore(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/restore', options)
+    end
+    
+    # Marks the requested post(s) as spam.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Array, Integer] allows multiple. Looks up a post by ID.
+    # @return [Hashie::Rash] Marked as spam post id
+    # @example Reports as spam post with ID 198230
+    #   Disqussion::Client.posts.spam(198230)
+    # @see: http://disqus.com/api/3.0/posts/spam.json
+    def spam(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/spam', options)
+    end
+    
+    # Unhighlights the requested post(s).
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Array, Integer] allows multiple. Looks up a post by ID.
+    # @return [Hashie::Rash] Unhighlighted post id
+    # @example Unhighlights the requested post(s).
+    #   Disqussion::Client.posts.unhighlight(198230)
+    # @see: http://disqus.com/api/3.0/posts/unhighlight.json
+    def unhighlight(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = post('posts/unhighlight', options)
+    end
+    
+    # Register a vote for a post.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param vote [Integer] Choices: -1, 0, 1
+    # @param post [Integer] Looks up a post by ID.
+    # @return [Hashie::Rash] Details on the post.
+    # @example Vote for post ID 12345678
+    #   Disqussion::Client.posts.vote(1, 12345678)
+    # @see: http://disqus.com/api/3.0/posts/vote.json
+    def vote(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      if args.length == 2
+        options.merge!(:vote => args[0])
+        options.merge!(:post => args[1])
+        response = post('posts/vote', options)
+      else
+        puts "#{Kernel.caller.first}: posts.vote expects 2 arguments: vote([-1..1]), posts ID"
+      end
+    end
+  end
+end

data/lib/disqussion/client/reactions.rb

@@ -0,0 +1,79 @@
+module Disqussion
+  class Reactions < Client
+    # Returns ??
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :page. Defaults to 0.  Maximum length of 10
+    # @option options [Array, String] :forum allow multiple. Defaults to null. Defaults to all forums you moderate if no other filters are specified. Looks up a forum by ID (aka short name)
+    # @return [Hashie::Rash] Returns ??
+    # @example Return ??
+    #   Disqussion::Client.reactions.domains
+    # @see: http://disqus.com/api/3.0/posts/domains.json
+    def domains(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('reactions/domains', options)
+    end
+    
+    # Returns ??
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :page. Defaults to 0.  Maximum length of 10
+    # @option options [Array, String] :forum allow multiple. Defaults to null. Defaults to all forums you moderate if no other filters are specified. Looks up a forum by ID (aka short name)
+    # @return [Hashie::Rash] Returns ??
+    # @example Return ??
+    #   Disqussion::Client.reactions.ips
+    # @see: http://disqus.com/api/3.0/posts/ips.json
+    def ips(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('reactions/ips', options)
+    end
+    
+    # Returns ??
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :page. Defaults to 0.  Maximum length of 10
+    # @option options [Array, String] :forum allow multiple. Defaults to null. Defaults to all forums you moderate if no other filters are specified. Looks up a forum by ID (aka short name)
+    # @return [Hashie::Rash] Returns ??
+    # @example Return ??
+    #   Disqussion::Client.reactions.threads
+    # @see: http://disqus.com/api/3.0/posts/threads.json
+    def threads(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('reactions/threads', options)
+    end
+    
+    # Returns ??
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :page. Defaults to 0.  Maximum length of 10
+    # @option options [Array, String] :forum allow multiple. Defaults to null. Defaults to all forums you moderate if no other filters are specified. Looks up a forum by ID (aka short name)
+    # @return [Hashie::Rash] Returns ??
+    # @example Return ??
+    #   Disqussion::Client.reactions.users
+    # @see: http://disqus.com/api/3.0/posts/users.json
+    def users(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('reactions/users', options)
+    end
+  end
+end

data/lib/disqussion/client/reports.rb

@@ -0,0 +1,4 @@
+module Disqussion
+  class Reports < Client
+  end
+end

data/lib/disqussion/client/threads.rb

@@ -0,0 +1,199 @@
+module Disqussion
+  class Threads < Client
+    # Closes a thread
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param thread [Array, Integer] allows multiple. Looks up a thread by ID. You must be a moderator on the selected thread's forum. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @return [Hashie::Rash] ID of the closed thread.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name). You must be a moderator on the selected forum.
+    # @example Closes thread 12345678
+    #   Disqussion::Client.threads.close(12345678)
+    # @see: http://disqus.com/api/3.0/threads/close.json
+    def close(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      thread = args.first
+      options.merge!(:thread => thread) if ([:ident, :link] & options.keys).empty?
+      response = post('threads/close', options)
+    end
+    
+    # Returns thread details.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] Details on the requested threads.
+    # @param thread [Integer] Looks up a thread by ID. You must be a moderator on the selected thread's forum. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @param options [Hash] A customizable set of options.
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, author, category
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name)
+    # @example Return extended information for forum 'myforum'
+    #   Disqussion::Client.threads.details("mythread")
+    # @see: http://disqus.com/api/3.0/threads/details.json
+    def details(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      thread = args.first
+      options.merge!(:thread => thread) if ([:ident, :link] & options.keys).empty?
+      response = get('threads/details', options)
+    end
+    
+    # Returns a list of threads sorted by the date created.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] List of threads.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :category. Defaults to null
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name)
+    # @option options [Integer] :thread. Defaults to null. Looks up a thread by ID. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @option options [Integer, String] :author. Defaults to null. You may look up a user by username using the 'username' query type.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, author, category
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [String, Array] :include allows multiple. Defaults to ["open", "close"]. Choices: open, closed, killed.
+    # @option options [String] :order. Defaults to "asc". Choices: asc, desc    
+    # @example Return extended information for forum 'myforum'
+    #   Disqussion::Client.threads.list(:forum => "the88")
+    # @see: http://disqus.com/api/3.0/threads/list.json
+    def list(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('threads/list', options)
+    end
+    
+    # Returns a list of threads sorted by number of likes.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] List of the most liked threads.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :category. Defaults to null
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name)
+    # @option options [Integer, String] :author. Defaults to null. You may look up a user by username using the 'username' query type.
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, author, category
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [String, Array] :include allows multiple. Defaults to ["open", "close"]. Choices: open, closed, killed.
+    # @example Return extended information for forum 'myforum'
+    #   Disqussion::Client.threads.listMostLiked()
+    # @see: http://disqus.com/api/3.0/threads/listMostLiked.json
+    def listMostLiked(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('threads/listMostLiked', options)
+    end
+    
+    # Returns a list of posts within a thread.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] List of threads post.
+    # @param thread [Integer] Looks up a thread by ID. You must be a moderator on the selected thread's forum. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @param options [Hash] A customizable set of options.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name)
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :query. Defaults to null.
+    # @option options [String, Array] :include allows multiple. Defaults to ["approved"]. Choices: unapproved, approved, spam, deleted, flagged
+    # @option options [String] :order. Defaults to "desc". Choices: asc, desc
+    # @example Return extended information for forum 'myforum'
+    #   Disqussion::Client.threads.list()
+    # @see: http://disqus.com/api/3.0/threads/listPosts.json
+    def listPosts(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      thread = args.first
+      options.merge!(:thread => thread) if ([:ident, :link] & options.keys).empty?
+      response = get('threads/listPosts', options)
+    end
+    
+    # Opens a thread
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param thread [Array, Integer] allows multiple. Looks up a thread by ID. You must be a moderator on the selected thread's forum. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @return [Hashie::Rash]  ID of the opened thread.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name). You must be a moderator on the selected forum.
+    # @example Opens thread 12345678
+    #   Disqussion::Client.threads.open(12345678)
+    # @see: http://disqus.com/api/3.0/threads/open.json
+    def open(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      thread = args.first
+      options.merge!(:thread => thread) if ([:ident, :link] & options.keys).empty?
+      response = post('threads/open', options)
+    end
+    
+    # Removes a thread
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param thread [Array, Integer] allows multiple. Looks up a thread by ID. You must be a moderator on the selected thread's forum. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @return [Hashie::Rash] ID of the deleted thread.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name). You must be a moderator on the selected forum.
+    # @example Removes thread 12345678
+    #   Disqussion::Client.threads.remove(12345678)
+    # @see: http://disqus.com/api/3.0/threads/remove.json
+    def remove(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      thread = args.first
+      options.merge!(:thread => thread) if ([:ident, :link] & options.keys).empty?
+      response = post('threads/remove', options)
+    end
+    
+    # Restores a thread
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param thread [Array, Integer] allows multiple. Looks up a thread by ID. You must be a moderator on the selected thread's forum. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @return [Hashie::Rash] ID of the restored thread.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name). You must be a moderator on the selected forum.
+    # @example Removes thread 12345678
+    #   Disqussion::Client.threads.restore(12345678)
+    # @see: http://disqus.com/api/3.0/threads/restore.json
+    def restore(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      thread = args.first
+      options.merge!(:thread => thread) if ([:ident, :link] & options.keys).empty?
+      response = post('threads/restore', options)
+    end
+    
+    # Register a vote on a thread.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param thread [Integer] Choices: -1, 0, 1
+    # @param thread [Integer] Looks up a thread by ID. You may pass use the 'ident' or 'link' query types instead of an ID by including 'forum'.
+    # @return [Hashie::Rash] Details on the thread.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name). You must be a moderator on the selected forum.
+    # @example Removes thread 12345678
+    #   Disqussion::Client.threads.vote(1, 12345678)
+    # @see: http://disqus.com/api/3.0/threads/vote.json
+    def vote(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      if args.length == 2
+        options.merge!(:vote => args[0])
+        options.merge!(:thread => args[1]) if ([:ident, :link] & options.keys).empty?
+        response = post('threads/vote', options)
+      else
+        puts "#{Kernel.caller.first}: threads.vote expects 2 arguments: vote([-1..1]), thread (you may pass use the 'ident' or 'link' query types instead of an thread ID by including :forum)"
+      end
+    end
+  end
+end

data/lib/disqussion/client/trends.rb

@@ -0,0 +1,23 @@
+module Disqussion
+  class Trends < Client
+    # Returns a list of trending threads.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @param forum [String] Forum ID (aka short name).
+    # @return [Hashie::Rash] Returns list of trending threads.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, author, category
+    # @option options [Array, String] :forum allows multiple. Defaults to null. Looks up a forum by ID (aka short name)
+    # @example Returns a list of trending threads
+    #   Disqussion::Client.trends.listTreads()
+    # @see: http://disqus.com/api/3.0/trends/listTreads.json
+    def listTreads(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('trends/listTreads', options)
+    end
+  end
+end

data/lib/disqussion/client/users.rb

@@ -0,0 +1,103 @@
+module Disqussion
+  class Users < Client
+    # Returns details of a user
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param user [Integer, String] A Disqus user ID or screen name.
+    # @return [Hashie::Rash] Details on the requested user.
+    # @example Return extended information for 'the88'
+    #   Disqussion::Client.user("the88")
+    #   Disqussion::Client.user(6138058)  # Same as above
+    # @see: http://disqus.com/api/3.0/users/details.json
+    def details(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      user = args.first
+      merge_user_into_options!(user, options)
+      response = get('users/details', options)
+    end
+    
+    # Follow a user
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param target [Integer, String] A Disqus user ID or screen name.
+    # @return [Hashie::Rash] Details on the requested user.
+    # @example Return extended information for 'the88'
+    #   Disqussion::Client.follow("the88")
+    #   Disqussion::Client.follow(6138058)  # Same as above
+    # @see: http://disqus.com/api/3.0/users/details.json
+    def follow(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      target = args.first
+      merge_target_into_options!(target, options)
+      response = post('users/follow', options)
+    end
+    
+    # Returns a list of forums a user has been active on.
+    def listActiveForums
+      
+    end
+    
+    # BETA
+    # Returns a list of threads a user has participated in sorted by last activity.
+    def listActiveThreads
+      
+    end
+    
+    # BETA
+    # Returns a list of various activity types made by the user.
+    def listActivity
+      
+    end
+    
+    # BETA
+    # Returns a list of users a user is being followed by.
+    def listFollowers
+      
+    end
+    
+    # BETA
+    # Returns a list of users a user is following.
+    def listFollowing
+      
+    end
+
+    # Returns a list of forums a user owns.
+    def listForums
+      
+    end
+    
+    # BETA
+    # Returns a list of forums a user has been active on recenty, sorted by the user's activity.
+    def listMostActiveForums
+      
+    end
+    
+    # Returns a list of posts made by the user.
+    def listPosts
+      
+    end
+    
+    # Unfollow a user
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param user [Integer, String] A Disqus user ID or screen name.
+    # @return [Hashie::Rash] Details on the requested user.
+    # @example Return extended information for 'the88'
+    #   Disqussion::Client.unfollow("the88")
+    #   Disqussion::Client.unfollow(6138058)  # Same as above
+    # @see: http://disqus.com/api/3.0/users/details.json
+    def unfollow
+      merge_user_into_options!(user, options)
+      response = post('users/unfollow', options)
+    end
+  end
+end