disqussion 0.0.6 → 0.0.7

data/lib/disqussion/client/users.rb

@@ -1,5 +1,22 @@
 module Disqussion
   class Users < Client
+    # Updates username for the user, fails if username does not meet requirements, or is taken by another user 
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param username [String] A Disqus username. Defaults to null. Minimum length of 3 and Maximum length of 30
+    # @example Updates username for the user for 'the88' to 'saxonbeat'
+    #   Disqussion::Client.users.checkusername(:username => 'saxonbeat')
+    # @see: http://disqus.com/api/3.0/users/checkUsername.json
+    def checkUsername(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:username] = args.first
+      response = post('users/checkUsername', options)
+    end
+
+
     # Returns details of a user
     # @accessibility: public key, secret key
     # @methods: GET
@@ -86,7 +103,7 @@ module Disqussion
     
     # BETA
     # Returns a list of various activity types made by the user.
-     # @accessibility: public key, secret key
+    # @accessibility: public key, secret key
     # @methods: GET
     # @format: json, jsonp
     # @authenticated: false
@@ -98,7 +115,6 @@ module Disqussion
     # @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 [] :query. Defaults to null
     # @option options [String, Array] :include. Allows multiple. Defaults to ["user", "replies", "following" ]. Choices: user, replies, following
     # @option options [String] :anon_user. Defaults to null. Looks up an anonymous user by unique hash.
     # @example Return a list of active threads user 1234 has been active on
@@ -111,14 +127,44 @@ module Disqussion
     
     # BETA
     # Returns a list of users a user is being followed by.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: true
+    # @return [Hashie::Rash] Details on the users the user is being followed by.
+    # @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 "asc". Choices: asc, desc
+    # @example  Return a list of users the user is currently being followed by
+    #   Disqussion::Client.users.listFollowers(:user => 1234)
+    # @see: http://disqus.com/api/3.0/users/listFollowers.json 
     def listFollowers(*args)
-      
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('users/listFollowers', options)      
     end
     
     # BETA
     # Returns a list of users a user is following.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: true
+    # @return [Hashie::Rash] Details on the users the user is following.
+    # @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 "asc". Choices: asc, desc
+    # @example  Return a list of users the user is currently following
+    #   Disqussion::Client.users.listFollowing(:user => 1234)
+    # @see: http://disqus.com/api/3.0/users/listFollowing.json 
     def listFollowing(*args)
-      
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('users/listFollowing', options) 
     end
     
     # Returns a list of forums a user owns.
@@ -144,8 +190,20 @@ module Disqussion
     
     # BETA
     # Returns a list of forums a user has been active on recenty, sorted by the user's activity.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: true
+    # @return [Hashie::Rash] Details on the users list of forums they have been most active on recently.
+    # @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.
+    # @example Return a list of the forums the user has been most active on recently.
+    #   Disqussion::Client.users.listMostActiveForums(:user => 1234)
+    # @see: http://disqus.com/api/3.0/users/listMostActiveForums.json 
     def listMostActiveForums(*args)
-      
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('users/listMostActiveForums', options)
     end
     
     # Returns a list of posts made by the user.

data/lib/disqussion/version.rb

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

data/spec/disqussion/client/forums_spec.rb

@@ -6,6 +6,19 @@ describe Disqussion::Forums do
       before do
         @client = Disqussion::Client.forums
       end
+
+      describe ".addModerator" do
+        before do
+          stub_post("forums/addModerator.json", :body => { :user => "boom", :forum => "the88"}).
+            to_return(:body => fixture("forums/addModerator.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        xit "adds a moderator to a forum" do
+          @client.addModerator("boom", "the88")
+          a_post("forums/addModerator.json", :body => { :user => "boom", :forum => "the88"}).
+            should have_been_made
+          end
+        end
       
       describe ".create" do
         before do
@@ -32,6 +45,32 @@ describe Disqussion::Forums do
             should have_been_made
         end
       end
+
+      describe ".listModerators" do
+        before do 
+          stub_get("forums/listModerators.json", :query => { :forum => "the88" }).
+            to_return(:body => fixture("forums/listModerators.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "returns a list of moderators of the forum" do
+          @client.listModerators("the88")
+          a_get("forums/listModerators.json", :query => { :forum => "the88" }).
+            should have_been_made
+        end
+      end
+
+      describe ".listMostActiveUsers" do 
+        before do
+          stub_get("forums/listMostActiveUsers.json", :query => { :forum => "the88" }).
+            to_return(:body => fixture("forums/listMostActiveUsers.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "returns a list of the most active users on a forum" do
+          @client.listMostActiveUsers("the88")
+          a_get("forums/listMostActiveUsers.json", :query => { :forum => "the88" }).
+            should have_been_made
+        end
+      end
       
       describe ".listMostLikedUsers" do
         before do
@@ -99,4 +138,4 @@ describe Disqussion::Forums do
       end
     end
   end
-end
+end

data/spec/disqussion/client/posts_spec.rb

@@ -47,7 +47,16 @@ describe Disqussion::Posts do
       end
       
       describe ".getContext" do
-        pending
+        before do 
+          stub_get("posts/getContext.json", :query => { :post => "3" }).
+            to_return(:body => fixture("posts/getContext.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "Returns the hierarchal tree of a post (all parents)" do
+          @client.getContext(3)
+          a_get("posts/getContext.json", :query => { :post => "3" }).
+            should have_been_made
+        end
       end
       
       describe ".highlight" do
@@ -77,7 +86,16 @@ describe Disqussion::Posts do
       end
       
       describe ".listPopular" do
-        pending
+        before do
+          stub_get("posts/listPopular.json", :query => { :forum => "bobross"}).
+            to_return(:body => fixture("posts/listPopular.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "Returns a list of posts ordered by the number of likes recently." do
+          @client.listPopular(:forum => "bobross")
+          a_get("posts/listPopular.json", :query => { :forum => "bobross" }).
+            should have_been_made
+        end
       end
       
       describe ".remove" do
@@ -144,7 +162,20 @@ describe Disqussion::Posts do
             should have_been_made
         end
       end
-      
+
+      describe ".update" do
+        before do
+          stub_post("posts/update.json", :body => { :post => "12345678", :message => "Hello"}).
+            to_return(:body => fixture("posts/update.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "Updates information on a post" do
+          @client.update(12345678, "Hello")
+          a_post("posts/update.json", :body => { :post => "12345678", :message => "Hello"}).
+            should have_been_made
+        end
+      end
+
       describe ".vote" do
         before do
           stub_post("posts/vote.json", :body => { :vote => "1", :post => "199088808" }).

data/spec/disqussion/client/reactions_spec.rb

@@ -6,6 +6,19 @@ describe Disqussion::Reactions do
       before do
         @client = Disqussion::Client.reactions
       end
+
+      describe ".details" do
+        before do
+          stub_get("reactions/details.json", :query => { }).
+            to_return(:body => fixture("reactions/details.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        xit "returns reaction details" do
+          @client.details()
+          a_get("reactions/details.json", :query => { }).
+            should have_been_made
+        end
+      end
       
       describe ".domains" do
         before do
@@ -32,6 +45,19 @@ describe Disqussion::Reactions do
             should have_been_made
         end
       end
+
+      describe ".list" do
+        before do
+          stub_get("reactions/list.json", :query => {:forum => "the88"}).
+            to_return(:body => fixture("reactions/list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "returns a list of reactions for a forum" do
+          @client.list("the88")
+          a_get("reactions/list.json", :query => {:forum => "the88" }).
+            should have_been_made
+        end
+      end
       
       describe ".threads" do
         before do

data/spec/disqussion/client/threads_spec.rb

@@ -6,6 +6,19 @@ describe Disqussion::Threads do
       before do
         @client = Disqussion::Client.threads
       end
+
+      describe ".create" do
+        before do
+          stub_post("threads/create.json", :body => { :forum => "bobross", :title => "Hello World" }).
+            to_return(:body => fixture("threads/create.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          end
+
+        it "creates a new thread" do
+          @client.create("bobross","Hello World")
+          a_post("threads/create.json", :body => { :forum => "bobross", :title => "Hello World" }).
+            should have_been_made
+        end
+      end
       
       describe ".close" do
         before do
@@ -51,7 +64,16 @@ describe Disqussion::Threads do
       end
       
       describe ".listHot" do
-        pending
+        before do 
+          stub_get("threads/listHot.json", :query => { :forum => "cnn" }).
+            to_return(:body => fixture("threads/listHot.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        it "returns a list of hot threads of a forum" do
+          @client.listHot(:forum => "cnn")
+          a_get("threads/listHot.json", :query => { :forum => "cnn" }).
+            should have_been_made
+        end
       end
       
       describe ".listMostLiked" do
@@ -68,7 +90,16 @@ describe Disqussion::Threads do
       end
       
       describe ".listPopular" do
-        pending
+        before do 
+          stub_get("threads/listPopular.json", :query => {:forum => "facebook" }).
+            to_return(:body => fixture("threads/listPopular.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          end
+
+          it "returns a list of the most popular posts in a interval" do
+            @client.listPopular(:forum => "facebook")
+            a_get("threads/listPopular.json", :query => { :forum => "facebook"}).
+              should have_been_made
+          end
       end
       
       describe ".listPosts" do
@@ -126,9 +157,42 @@ describe Disqussion::Threads do
             should have_been_made
         end
       end
-      
+
+      describe ".set" do
+        it "get the correct resource" do
+          stub_get("threads/set.json", :query => { :thread => "12345678" }).
+            to_return(:body => fixture("threads/set.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.set(12345678)
+          
+          a_get("threads/set.json", :query => { :thread => "12345678"}).should have_been_made
+        end
+      end
+
+      describe ".subscribe" do
+        before do 
+          stub_post("threads/subscribe.json", :body => { :thread => "12345678" }).
+            to_return(:body => fixture("threads/subscribe.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        xit "subscribes to thread" do
+          @client.subscribe(12345678)
+          a_post("threads/subscribe.json", :body => { :thread => "12345678"}).
+            should have_been_made
+        end
+      end
+
       describe ".update" do
-        pending
+        before do
+          stub_post("threads/update.json", :body => { :thread => "1", :title => "Hello World" }).
+            to_return(:body => fixture("threads/update.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        end
+
+        xit "updates a thread" do
+          @client.update(1, "Hello World")
+          a_post("threads/update.json", :body => { :thread => "1", :title => "Hello World" }).
+            should have_been_made
+        end
       end
       
       describe ".vote" do

data/spec/disqussion/client/users_spec.rb

@@ -6,6 +6,17 @@ describe Disqussion::Users do
       before do
         @client = Disqussion::Client.users
       end
+
+      describe ".checkUsername" do
+        it "checks username" do
+          stub_post("users/checkUsername.json", :body => {:username => "saxonbeat"}).
+            to_return(:body => fixture("users/checkUsername.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.checkUsername("saxonbeat")
+
+          a_post("users/checkUsername.json", :body => {:username => "saxonbeat"}).should have_been_made
+        end
+      end
       
       describe ".details" do
         it "get the correct resource" do
@@ -63,15 +74,29 @@ describe Disqussion::Users do
       end
       
       describe ".listFollowers" do
-        pending
+        it "gets a list of users followers." do
+          stub_get("users/listFollowers.json", :query  => { :user => "1234"}).
+            to_return(:body => fixture("users/listFollowers.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.listFollowers(:user => 1234)
+
+          a_get("users/listFollowers.json", :query => { :user => "1234"}).should have_been_made
+        end
       end
       
       describe ".listFollowing" do
-        pending
+        it "gets a list of users the user is following on Disqus." do
+          stub_get("users/listFollowing.json", :query  => { :user => "1"}).
+            to_return(:body => fixture("users/listFollowing.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.listFollowing(:user => 1)
+
+          a_get("users/listFollowing.json", :query => { :user => "1"}).should have_been_made
+        end
       end
       
       describe ".listForums" do
-        it "get list of users forums." do
+        it "gets 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"})
           
@@ -82,7 +107,14 @@ describe Disqussion::Users do
       end
       
       describe "listMostActiveForums" do
-        pending
+        it "gets list of forums the user is most active on" do
+          stub_get("users/listMostActiveForums.json", :query => { :user => "1" }).
+            to_return(:body => fixture("users/listMostActiveForums.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+          
+          @client.listMostActiveForums(:user => 1)
+          
+          a_get("users/listMostActiveForums.json", :query => { :user => "1"}).should have_been_made
+        end
       end
       
       describe ".listPosts" do

data/spec/fixtures/forums/listModerators.json

@@ -0,0 +1,39 @@
+{
+  "code": 0,
+  "response": [
+    {
+      "id": "630382",
+      "forum": "the88",
+      "user": {
+        "username": "the88",
+        "about": "",
+        "name": "the88",
+        "url": "",
+        "isAnonymous": false,
+        "rep": 1.232862,
+        "isFollowing": false,
+        "isFollowedBy": false,
+        "profileUrl": "http://disqus.com/the88/",
+        "emailHash": "bb59f077c9689d923dd856c31dba3098",
+        "reputation": 1.232862,
+        "location": "",
+        "isPrimary": true,
+        "joinedAt": "2010-12-28T23:00:03",
+        "id": "6138058",
+        "avatar": {
+          "small": {
+            "permalink": "http://disqus.com/api/users/avatars/the88.jpg",
+            "cache": "http://mediacdn.disqus.com/1361595726/images/noavatar32.png"
+          },
+          "isCustom": false,
+          "permalink": "http://disqus.com/api/users/avatars/the88.jpg",
+          "cache": "http://mediacdn.disqus.com/1361595726/images/noavatar92.png",
+          "large": {
+            "permalink": "http://disqus.com/api/users/avatars/the88.jpg",
+            "cache": "http://mediacdn.disqus.com/1361595726/images/noavatar92.png"
+          }
+        }
+      }
+    }
+  ]
+}