disqussion 0.0.2 → 0.0.3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    disqussion (0.0.1)
+    disqussion (0.0.2)
       faraday (~> 0.6.1)
       faraday_middleware (~> 0.6.3)
       hashie (~> 1.0.0)
@@ -29,8 +29,8 @@ GEM
       ruby_core_source (>= 0.1.4)
     maruku (0.6.0)
       syntax (>= 1.0.0)
-    multi_json (1.0.1)
-    multipart-post (1.1.0)
+    multi_json (1.0.2)
+    multipart-post (1.1.1)
     nokogiri (1.4.4)
     rack (1.2.2)
     rake (0.8.7)

data/HISTORY.mkd

@@ -1,5 +1,14 @@
 HISTORY
 =======
+
+0.0.3 - May 18, 2011
+----------------------
+* Added following missing features: Users#listActiveForums, Users#listForums, Users#listPosts, Users#unfollow, Forums#listMostLikedUsers, Forums#listUsers
+
+0.0.2 - May 18, 2011
+----------------------
+* Fixed bug with EventMachine detection in configuration
+
 0.0.1 - May 10, 2011
 ----------------------
 * First release

data/README.mkd

@@ -22,8 +22,10 @@ Continuous Integration
 ----------------------
 [![Build Status](http://travis-ci.org/jeremyvdw/disqussion.png)](http://travis-ci.org/jeremyvdw/disqussion)
 
-What's in 0.1?
-------------------
+What's in 0.0.3?
+----------------
+
+Disqussion currently covers *only* stable Disqus API for: applications, forums, posts, reactions, threads and users features.
 
 The error classes are consistent with [Disqus's documented response codes](http://disqus.com/api/docs/errors/).
 Error details from Disqus API are encapsulated in HTTP response.

data/lib/disqussion/client/forums.rb

@@ -62,10 +62,26 @@ module Disqussion
       response = get('forums/listCategories', options)
     end
     
-    # NOTE: to be implemented
     # Returns a list of users active within a forum ordered by most likes received.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param forum [String] Forum ID (aka short name).
+    # @return [Hashie::Rash] Details on the list of posts.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [String] :order. Defaults to "desc". Choices: asc, desc
+    # @example Return list of most liked users for forum 'myforum'
+    #   Disqussion::Client.forums.listMostLikedUsers("myforum")
     # @see: http://disqus.com/api/3.0/forums/listMostLikedUsers.json
     def listMostLikedUsers(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:forum] = args.first
+      response = get('forums/listMostLikedUsers', options)
     end
     
     # Returns a list of posts within a forum.
@@ -118,5 +134,26 @@ module Disqussion
       response = get('forums/listThreads', options)
     end
     
+    # Returns a list of users active within a forum.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param forum [String] Forum ID (aka short name).
+    # @return [Hashie::Rash] Details on the list of posts.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [String] :order. Defaults to "desc". Choices: asc, desc
+    # @example Return list of active users for forum 'myforum'
+    #   Disqussion::Client.forums.listUsers("myforum")
+    # @see: http://disqus.com/api/3.0/forums/listUsers.json
+    def listUsers(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:forum] = args.first
+      response = get('forums/listUsers', options)
+    end
   end
 end

data/lib/disqussion/client/users.rb

@@ -10,7 +10,7 @@ module Disqussion
     # @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
+    #   Disqussion::Client.user(1234)  # Same as above
     # @see: http://disqus.com/api/3.0/users/details.json
     def details(*args)
       options = args.last.is_a?(Hash) ? args.pop : {}
@@ -29,7 +29,7 @@ module Disqussion
     # @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
+    #   Disqussion::Client.follow(1234)  # Same as above
     # @see: http://disqus.com/api/3.0/users/details.json
     def follow(*args)
       options = args.last.is_a?(Hash) ? args.pop : {}
@@ -39,48 +39,98 @@ module Disqussion
     end
     
     # Returns a list of forums a user has been active on.
-    def listActiveForums
-      
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] Details on the list of posts.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the 'username' query type.
+    # @option options [String] :order. Defaults to "desc". Choices: asc, desc
+    # @example Return a list of forums user 1234 has been active on
+    #   Disqussion::Client.users.listActiveForums(:user => 1234)
+    # @see: http://disqus.com/api/3.0/users/listActiveForums.json
+    def listActiveForums(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('users/listActiveForums', options)
     end
     
     # BETA
     # Returns a list of threads a user has participated in sorted by last activity.
-    def listActiveThreads
+    def listActiveThreads(*args)
       
     end
     
     # BETA
     # Returns a list of various activity types made by the user.
-    def listActivity
+    def listActivity(*args)
       
     end
     
     # BETA
     # Returns a list of users a user is being followed by.
-    def listFollowers
+    def listFollowers(*args)
       
     end
     
     # BETA
     # Returns a list of users a user is following.
-    def listFollowing
+    def listFollowing(*args)
       
     end
-
+    
     # Returns a list of forums a user owns.
-    def listForums
-      
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] Details on the list of forums.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Integer] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the 'username' query type.
+    # @option options [String] :order. Defaults to "desc". Choices: asc, desc
+    # @example Return a list of forums owned by user 1234
+    #   Disqussion::Client.users.listForums(:user => 1234)
+    # @see: http://disqus.com/api/3.0/users/listForums.json
+    def listForums(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('users/listForums', options)
     end
     
     # BETA
     # Returns a list of forums a user has been active on recenty, sorted by the user's activity.
-    def listMostActiveForums
+    def listMostActiveForums(*args)
       
     end
     
     # Returns a list of posts made by the user.
-    def listPosts
-      
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] Details on the list of forums.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null
+    # @option options [Integer, String] :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] :user. Defaults to null. Looks up a user by ID. You may look up a user by username using the 'username' query type.
+    # @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
+    # @example Return a list of user 1234s posts
+    #   Disqussion::Client.users.listPosts(:user => 1234)
+    # @see: http://disqus.com/api/3.0/users/listPosts.json
+    def listPosts(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('users/listPosts', options)
     end
     
     # Unfollow a user
@@ -93,10 +143,12 @@ module Disqussion
     # @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
+    #   Disqussion::Client.unfollow(1234)  # Same as above
     # @see: http://disqus.com/api/3.0/users/details.json
-    def unfollow
-      merge_user_into_options!(user, options)
+    def unfollow(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      target = args.first
+      merge_target_into_options!(target, options)
       response = post('users/unfollow', options)
     end
   end

data/lib/disqussion/version.rb

@@ -1,3 +1,3 @@
 module Disqussion
-  VERSION = '0.0.2'.freeze unless defined?(::Disqussion::VERSION)
+  VERSION = '0.0.3'.freeze unless defined?(::Disqussion::VERSION)
 end

data/spec/disqussion/client/forums_spec.rb

@@ -33,15 +33,15 @@ describe Disqussion::Forums do
         end
       end
       
-      describe ".listPosts" do
+      describe ".listMostLikedUsers" do
         before do
-          stub_get("forums/listPosts.json", :query => { :forum => "the88" }).
-            to_return(:body => fixture("forums/listPosts.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          stub_get("forums/listMostLikedUsers.json", :query => { :forum => "the88" }).
+            to_return(:body => fixture("forums/listMostLikedUsers.json"), :headers => {:content_type => "application/json; charset=utf-8"})
         end
         
-        it "returns details on the requested list of posts." do
-          @client.listPosts("the88")
-          a_get("forums/listPosts.json", :query => { :forum => "the88" }).
+        it "returns details on the requested list of users." do
+          @client.listMostLikedUsers("the88")
+          a_get("forums/listMostLikedUsers.json", :query => { :forum => "the88" }).
             should have_been_made
         end
       end
@@ -59,8 +59,17 @@ describe Disqussion::Forums do
         end
       end
       
-      describe ".listMostLikedUsers" do
-        pending
+      describe ".listPosts" do
+        before do
+          stub_get("forums/listPosts.json", :query => { :forum => "the88" }).
+            to_return(:body => fixture("forums/listPosts.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+        
+        it "returns details on the requested list of posts." do
+          @client.listPosts("the88")
+          a_get("forums/listPosts.json", :query => { :forum => "the88" }).
+            should have_been_made
+        end
       end
       
       describe ".listThreads" do
@@ -75,6 +84,19 @@ describe Disqussion::Forums do
             should have_been_made
         end
       end
+      
+      describe ".listUsers" do
+        before do
+          stub_get("forums/listUsers.json", :query => { :forum => "the88" }).
+            to_return(:body => fixture("forums/listUsers.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+        
+        it "returns details on the requested list of users." do
+          @client.listUsers("the88")
+          a_get("forums/listUsers.json", :query => { :forum => "the88" }).
+            should have_been_made
+        end
+      end
     end
   end
 end

data/spec/disqussion/client/posts_spec.rb

@@ -46,6 +46,10 @@ describe Disqussion::Posts do
         end
       end
       
+      describe ".getContext" do
+        pending
+      end
+      
       describe ".highlight" do
         before do
           stub_post("posts/highlight.json", :body => { :post => "199088808" }).
@@ -72,6 +76,10 @@ describe Disqussion::Posts do
         end
       end
       
+      describe ".listPopular" do
+        pending
+      end
+      
       describe ".remove" do
         before do
           stub_post("posts/remove.json", :body => { :post => "199088808" }).

data/spec/disqussion/client/threads_spec.rb

@@ -46,6 +46,14 @@ describe Disqussion::Threads do
         end
       end
       
+      describe ".listBydate" do
+        pending
+      end
+      
+      describe ".listHot" do
+        pending
+      end
+      
       describe ".listMostLiked" do
         before do
           stub_get("threads/listMostLiked.json", :query => { :forum => "the88" }).
@@ -59,6 +67,10 @@ describe Disqussion::Threads do
         end
       end
       
+      describe ".listPopular" do
+        pending
+      end
+      
       describe ".listPosts" do
         before do
           stub_get("threads/listPosts.json", :query => { :thread => "mythread" }).
@@ -72,6 +84,10 @@ describe Disqussion::Threads do
         end
       end
       
+      describe ".listSimilar" do
+        pending
+      end
+      
       describe ".open" do
         before do
           stub_post("threads/open.json", :body => { :thread => "12345678" }).
@@ -111,6 +127,10 @@ describe Disqussion::Threads do
         end
       end
       
+      describe ".update" do
+        pending
+      end
+      
       describe ".vote" do
         before do
           stub_post("threads/vote.json", :body => { :vote => "1", :thread => "12345678" }).

data/spec/disqussion/client/users_spec.rb

@@ -20,14 +20,79 @@ describe Disqussion::Users do
       
       describe ".follow" do
         it "get the correct resource" do
-          stub_post("users/follow.json", :body => { :target => "12345678" }).
+          stub_post("users/follow.json", :body => { :target => "1234" }).
             to_return(:body => fixture("users/follow.json"), :headers => {:content_type => "application/json; charset=utf-8"})
           
-          @client.follow(12345678)
+          @client.follow(1234)
           
-          a_post("users/follow.json", :body => { :target => "12345678"}).should have_been_made
+          a_post("users/follow.json", :body => { :target => "1234"}).should have_been_made
         end
       end
+      
+      describe ".listActiveForums" do
+        it "get list of forums users has been active on." do
+          stub_get("users/listActiveForums.json", :query => { :user => "1234" }).
+            to_return(:body => fixture("users/listActiveForums.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.listActiveForums(:user => 1234)
+          
+          a_get("users/listActiveForums.json", :query => { :user => "1234"}).should have_been_made
+        end
+      end
+      
+      describe ".listActiveThreads" do
+        pending
+      end
+      
+      describe ".listActivity" do
+        pending
+      end
+      
+      describe ".listFollowers" do
+        pending
+      end
+      
+      describe ".listFollowing" do
+        pending
+      end
+      
+      describe ".listForums" do
+        it "get list of users forums." do
+          stub_get("users/listForums.json", :query => { :user => "1234" }).
+            to_return(:body => fixture("users/listForums.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.listForums(:user => 1234)
+          
+          a_get("users/listForums.json", :query => { :user => "1234"}).should have_been_made
+        end
+      end
+      
+      describe "listMostActiveForums" do
+        pending
+      end
+      
+      describe ".listPosts" do
+        it "get list of users posts." do
+          stub_get("users/listPosts.json", :query => { :user => "191921097" }).
+            to_return(:body => fixture("users/listPosts.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.listPosts(:user => 191921097)
+          
+          a_get("users/listPosts.json", :query => { :user => "191921097"}).should have_been_made
+        end
+      end
+      
+      describe "unfollow" do
+        it "get the correct resource" do
+          stub_post("users/unfollow.json", :body => { :target => "12345678" }).
+            to_return(:body => fixture("users/unfollow.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.unfollow(12345678)
+          
+          a_post("users/unfollow.json", :body => { :target => "12345678"}).should have_been_made
+        end
+      end
+      
     end
   end
 end