disqussion 0.0.6 → 0.0.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9c6b3f1e4ce9f81d2e9a1bf2e343f5f622147ae7
+  data.tar.gz: 952c2da042a96d690b0c722471acf572ec18827d
+SHA512:
+  metadata.gz: d36b58e15f48613c7533e36d969c92b884af2e288032cc6a2ca6fbecdd8733f5d797f94af1939f8ab90ae77cc5e4db707da16c5a4f99d27e03b8d4b5e8c08e7e
+  data.tar.gz: 56673b96b2860477a2dc04beeda91612f4f1adb59b12b296cfac3303a3408ee4bbc2f5bbe9371efa3cc4efeb8e622d5e0bf012a2dfb585472ad4a054441fbb8f

data/Gemfile

@@ -1,4 +1,4 @@
-source :gemcutter
+source 'https://rubygems.org'
 
 gem 'jruby-openssl', :platforms => :jruby
 gem 'rake'
@@ -10,10 +10,10 @@ group :development do
 end
 
 group :test do
-  gem 'json', :platforms => :ruby_18
+  gem 'json', :platforms => [:ruby_18, :jruby]
   gem 'rspec', '>= 2.11'
   gem 'simplecov'
   gem 'webmock'
 end
 
-gemspec
+gemspec

data/Gemfile.lock

@@ -1,18 +1,18 @@
 PATH
   remote: .
   specs:
-    disqussion (0.0.6)
+    disqussion (0.0.7)
       faraday (~> 0.8)
       faraday_middleware (>= 0.9)
-      hashie (~> 1.2)
+      hashie (~> 2.0)
       multi_json (~> 1.5)
       rash (~> 0.3)
 
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
-    addressable (2.3.2)
-    coderay (1.0.8)
+    addressable (2.3.5)
+    coderay (1.0.9)
     columnize (0.3.6)
     crack (0.3.2)
     debugger (1.2.4)
@@ -21,27 +21,27 @@ GEM
       debugger-ruby_core_source (~> 1.1.7)
     debugger-linecache (1.1.2)
       debugger-ruby_core_source (>= 1.1.1)
-    debugger-ruby_core_source (1.1.7)
+    debugger-ruby_core_source (1.1.9)
     diff-lcs (1.1.3)
-    faraday (0.8.4)
-      multipart-post (~> 1.1)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
     faraday_middleware (0.9.0)
       faraday (>= 0.7.4, < 0.9)
-    hashie (1.2.0)
+    hashie (2.0.5)
     json (1.7.6)
-    method_source (0.8.1)
+    method_source (0.8.2)
     multi_json (1.5.0)
-    multipart-post (1.1.5)
-    pry (0.9.11.4)
+    multipart-post (1.2.0)
+    pry (0.9.12.2)
       coderay (~> 1.0.5)
       method_source (~> 0.8)
       slop (~> 3.4)
     pry-debugger (0.2.1)
       debugger (~> 1.2.0)
       pry (~> 0.9.10)
-    rake (10.0.3)
-    rash (0.3.2)
-      hashie (~> 1.2.0)
+    rake (10.1.0)
+    rash (0.4.0)
+      hashie (~> 2.0.0)
     rspec (2.12.0)
       rspec-core (~> 2.12.0)
       rspec-expectations (~> 2.12.0)
@@ -54,11 +54,11 @@ GEM
       multi_json (~> 1.0)
       simplecov-html (~> 0.7.1)
     simplecov-html (0.7.1)
-    slop (3.4.3)
+    slop (3.4.6)
     webmock (1.9.0)
       addressable (>= 2.2.7)
       crack (>= 0.1.7)
-    yard (0.8.3)
+    yard (0.8.7)
 
 PLATFORMS
   ruby

data/README.mkd

@@ -18,7 +18,32 @@ Add it to the [apps](http://github.com/jeremyvdw/disqussion/wiki/apps) wiki!
 
 Continuous Integration
 ----------------------
-[![Build Status](http://travis-ci.org/jeremyvdw/disqussion.png)](http://travis-ci.org/jeremyvdw/disqussion)
+[![Build Status](https://travis-ci.org/jeremyvdw/disqussion.png)](http://travis-ci.org/jeremyvdw/disqussion)
+[![Dependency Status](https://gemnasium.com/jeremyvdw/disqussion.png)](https://gemnasium.com/jeremyvdw/disqussion)
+
+
+What's in 0.0.7?
+----------------------
+* Added list of forum moderators (@shabankarumba)
+* Added list of popular hreads, create threads (@shabankarumba)
+* Added list and details of reactions (@shabankarumba)
+* Added hierarchal tree of a post, list of the most popular posts and informations on a post (@shabankarumba)
+* Added list of users a user is being followed by and users a user is following, list of forums a user has been active on recenty (@shabankarumba)
+* Added set of threads given a list of ids (@shabankarumba)
+* Added list of threads sorted by hotness (@shabankarumba)
+* Added check username availability (@shabankarumba)
+* Added list of most active users (@m0dd3r)
+
+What's in 0.0.6?
+----------------------
+* Added subscribe and unsubscribe API calls (@wbrady)
+* List users activity and list users active threads (@shabankarumba)
+* Updated dependencies
+
+What's in 0.0.5?
+----------------------
+
+* Fixes conflicts with the `twitter` gem (@mathieuravaux).
 
 What's in 0.0.4?
 ----------------
@@ -76,7 +101,7 @@ explicitly require a JSON library. We recommend [yajl-ruby](http://github.com/br
 
 Usage Examples
 --------------
-``` ruby
+```ruby
 require "rubygems"
 require "disqussion"
 
@@ -89,7 +114,7 @@ end
 
 # Get an application's usage details
 puts Disqussion::Client.applications.listUsage("the88")
-
+```
 
 Contributing
 ------------
@@ -137,5 +162,4 @@ This gem is based on the work by John Nunemaker, Wynn Netherland, Erik Michaels-
 
 Copyright
 ---------
-Copyright (c) 2011 Jérémy Van de Wyngaert.
-See [LICENSE](https://github.com/jeremyvdw/disqussion/blob/master/LICENSE.mkd) for details.
+See [LICENSE](https://github.com/jeremyvdw/disqussion/blob/master/LICENSE.mkd) for details.

data/disqussion.gemspec

@@ -2,7 +2,7 @@
 require File.expand_path('../lib/disqussion/version', __FILE__)
 
 Gem::Specification.new do |spec|
-  spec.add_dependency('hashie', '~> 1.2')
+  spec.add_dependency('hashie', '~> 2.0')
   spec.add_dependency('faraday', '~> 0.8')
   spec.add_dependency('faraday_middleware', '>= 0.9')
   spec.add_dependency('multi_json', '~> 1.5')

data/lib/disqussion/client/forums.rb

@@ -61,6 +61,44 @@ module Disqussion
       options[:forum] = args.first
       response = get('forums/listCategories', options)
     end
+
+    # Returns a list of Moderators for the forum
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param forum [String] Forum ID (aka short name).
+    # @return [Hashie::Rash] Details on the requested list of moderators.
+    # @example Return list of moderators within forum 'the88'
+    #   Disqussion::Client.forums.listModerators("the88")
+    # @see: http://disqus.com/api/3.0/forums/listModerators.json
+    def listModerators(*args)
+    	options = args.last.is_a?(Hash) ? args.pop : {}
+    	options[:forum] = args.first
+    	response = get('forums/listModerators', options)
+    end
+
+    # Returns a list of the most active users for the 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 requested list of most active users.
+    # @param options [Hash] A customizable set of options.
+    # @option options [Integer] :cursor. Defaults to null
+    # @option options [Integer] :limit. Defaults to 25. Maximum value of 100
+    # @option options [String] :order. Defaults to "asc". Choices: asc, desc
+    # @example Return list of most active users within forum 'the88'
+    #   Disqussion::Client.forums.listMostActiveUsers("the88")
+    # @see: http://disqus.com/api/3.0/forums/listMostActiveUsers.json
+    def listMostActiveUsers(*args)
+    	options = args.last.is_a?(Hash) ? args.pop : {}
+    	options[:forum] = args.first
+    	response = get('forums/listMostActiveUsers', options)
+    end
     
     # Returns a list of users active within a forum ordered by most likes received.
     # @accessibility: public key, secret key
@@ -156,4 +194,4 @@ module Disqussion
       response = get('forums/listUsers', options)
     end
   end
-end
+end

data/lib/disqussion/client/posts.rb

@@ -61,6 +61,26 @@ module Disqussion
       options[:post] = args.first
       response = get('posts/details', options)
     end
+
+    # Returns the hierarchal tree of a post (all parents).
+    # @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.
+    # @option options [Integer] :depth. Defaults to 10. Minimum value of 1 and maximum value of 10. 
+    # @return [Hashie::Rash] hierarchal tree of a post (all parents).
+    # @example Return hierarchal tree for post 193673
+    #   Disqussion::Client.posts.getContext(193673)
+    # @see: http://disqus.com/api/3.0/posts/getContext.json
+    def getContext(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:post] = args.first
+      response = get('posts/getContext', options)
+    end
     
     # Highlights a post.
     # @accessibility: public key, secret key
@@ -105,6 +125,32 @@ module Disqussion
       options = args.last.is_a?(Hash) ? args.pop : {}
       response = get('posts/list', options)
     end
+
+
+    # Returns a list of the most popular posts
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @option options [String] :category. Defaults to null
+    # @option options [String] :interval. Defaults to "7d". Choices: 1h, 6h, 12h, 1d, 3d, 7d, 30d, 60d, 90d
+    # @option options [Array, String] :thread allow multiple. Defaults to null. Looks up a thread by ID
+    # @option options [String] :forum. Defaults to null. Defaults to all forums you moderate. Use :all to retrieve all forums.
+    # @option options [Datetime, Timestamp] :since. Unix timestamp (or ISO datetime standard). Defaults to null(Deprecated)
+    # @option options [Integer, String] :related. Allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum, thread
+    # @option options [Integer] :limit. Defaults to 25. Maximum value of 100
+    # @option options [Integer] :offset. Defaults to 0
+    # @option options [String] :query, Defualts to null
+    # @option options [String, Array] :include. Allows multiple. Defaults to ["approved"]. Choices: unapproved, approved, spam, deleted, flagged
+    # @option options [String] :order. Defaults to "popular". Choices: popular, best
+    # @example list popular posts with forum bobross
+    #   Disqussion::Client.posts.listPopular("bobross")
+    # @see: http://disqus.com/api/3.0/posts/listPopular.json
+    def listPopular(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('posts/listPopular', options)
+    end
     
     # Deletes the requested post(s).
     # @accessibility: public key, secret key
@@ -190,6 +236,29 @@ module Disqussion
       options[:post] = args.first
       response = post('posts/unhighlight', options)
     end
+
+    # Updates information on a post.
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param post [Integer] Looks up a post by ID.    
+    # @param message [String] String of the message
+    # @return [Hashie::Rash] Updated information on the post.
+    # @example Message for post ID 12345678
+    #   Disqussion::Client.posts.update(12345678,"Hello")
+    # @see: http://disqus.com/api/3.0/posts/update.json
+    def update(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      if args.length == 2
+        options.merge!(:post => args[0])
+        options.merge!(:message => args[1])
+        response = post('posts/update', options)
+      else
+        puts "#{Kernel.caller.first}: posts.update expects 2 arguments: post ID and message"
+      end
+    end
     
     # Register a vote for a post.
     # @accessibility: public key, secret key

data/lib/disqussion/client/reactions.rb

@@ -1,5 +1,29 @@
 module Disqussion
   class Reactions < Client
+
+    # Returns reaction details
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param reaction [Integer] Looks up a reaction by ID.    
+    # @param forum [String] Looks up a forum by ID (aka shortname). 
+    # @return [Hashie::Rash] Reaction of the forum.
+    # @example Message for post ID 12345678
+    #   Disqussion::Client.reactions.detail(12345678,"Hello")
+    # @see: http://disqus.com/api/3.0/reactions/details.json
+    def details(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      if args.length == 2
+        options.merge!(:reaction => args[0])
+        options.merge!(:forum => args[1])
+        response = get('reactions/details', options)
+      else
+        puts "#{Kernel.caller.first}: Reactions.details expects 2 arguments: reaction and forum"
+      end
+    end
+
     # Returns ??
     # @accessibility: public key, secret key
     # @methods: GET
@@ -37,6 +61,28 @@ module Disqussion
       options = args.last.is_a?(Hash) ? args.pop : {}
       response = get('reactions/ips', options)
     end
+
+    # Returns a list of reactions 
+    # @accessibility: public key, secret key
+    # @methods: POST,GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false
+    # @param forum [String] Looks up a forum by ID (aka shortname).
+    # @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] :related. Defaults to []
+    # @option options [String] :order. Defaults to "asc". Choices: asc, desc
+    # @return [Hashie::Rash] Reaction of the forum.
+    # @example Message for post ID 12345678
+    #   Disqussion::Client.reactions.detail(12345678,"Hello")
+    # @see: http://disqus.com/api/3.0/reactions/details.json
+    def list(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:forum] = args.first
+      response = get('reactions/list', options)
+    end 
     
     # Returns ??
     # @accessibility: public key, secret key

data/lib/disqussion/client/threads.rb

@@ -1,5 +1,35 @@
 module Disqussion
   class Threads < Client
+  	
+  	# Creates a thread
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param forum [String] Looks up a forum by ID (aka forum shortname).
+    # @param title [String] Title of the the new thread
+    # @return [Hashie::Rash] New thread is created.
+    # @option options [Integer] :category. Defaults to null
+    # @option options [String] :url. Defaults to null. URL (defined by RFC 3986). Maximum length of 500
+    # @option options [Integer] :date. Defaults to null. Unix timestamp (or ISO datetime standard)
+    # @option options [String] :message Defaults to null
+    # @option options [Integer] :identifier. Defaults to null. Maximum length of 300
+    # @option options [String] :slug. Defaults to null. Alpha-numeric slug. Maximum length of 200
+    # @example Create thread "Hello World"
+    #   Disqussion::Client.threads.create("bobross","Hello World")
+    # @see: http://disqus.com/api/3.0/threads/create.json
+    def create(*args)
+    	options = args.last.is_a?(Hash) ? args.pop : {}
+    	if args.length == 2 
+    		options.merge!(:forum => args[0])
+    		options.merge!(:title => args[1])
+    	 	response = post('threads/create', options)
+      else
+        puts "#{Kernel.caller.first}: threads.create expects 2 arguments: forum name (aka forum short name) and title for the thread"
+      end
+    end
+    
     # Closes a thread
     # @accessibility: public key, secret key
     # @methods: POST
@@ -88,6 +118,50 @@ module Disqussion
       response = get('threads/listMostLiked', options)
     end
 
+    # BETA
+    # Returns a list of threads sorted by hotness (date and likes).
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] List of the hottest threads sorted by hotness.
+    # @option options [Integer] :category. Looks up a category by ID. Defualts to null.
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name)
+    # @option options [String, Integer]  :author. 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] :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 list of hottest threads of the forum specified
+    #   Disqussion::Client.threadslistHot(:forum => "cnn")
+    # @see: http://disqus.com/api/3.0/threads/listHot.json
+    def listHot(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      response = get('threads/listHot', options)
+    end
+
+    # Returns a list of threads sorted by number of posts made since "interval". 
+    # If you are using both "category" and "forum" parameters, the forum of the category must match that as the parameter value for "forum".
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp, rss
+    # @authenticated: false
+    # @limited: false
+    # @return [Hashie::Rash] List of the most popular threads which have had the most posts in an interval.
+    # @option options [Integer] :category. Looks up a category by ID. Defualts to null.
+    # @option options [String] :interval. Defaults to "7d". Choices: 1h, 6h, 12h, 1d, 3d, 7d, 30d, 60d, 90d
+    # @option options [String] :forum. Defaults to null. Looks up a forum by ID (aka short name)
+    # @option options [String, Array] :related allows multiple. Defaults to []. You may specify relations to include with your response. Choices: forum
+    # @option options [Integer] :limit. Defaults to 25. Maximum length of 100
+    # @option options [Boolean] :with_top_post. Defaults to false
+    # @example Return list of the most populat threads in a given interval
+    #   Disqussion::Client.threadslistPopular(:forum => "bobross")
+    # @see: http://disqus.com/api/3.0/threads/listPopular.json
+    def listPopular(*args)
+    	options = args.last.is_a?(Hash) ? args.pop : {}
+    	response = get('threads/listPopular', options)
+    end 
+
     # Returns a list of posts within a thread.
     # @accessibility: public key, secret key
     # @methods: GET
@@ -172,6 +246,24 @@ module Disqussion
       response = post('threads/restore', options)
     end
 
+    # Returns an unsorted set of threads given a list of ids.
+    # @accessibility: public key, secret key
+    # @methods: GET
+    # @format: json, jsonp
+    # @authenticated: false
+    # @limited: false 
+    # @option options [String] :related. 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 Set thread 12345678
+    #   Disqussion::Client.threads.set(12345678)
+    # @see: http://disqus.com/api/3.0/threads/set.json
+    def set(*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/set', options)
+    end
+
     def subscribe(*args)
       options = args.last.is_a?(Hash) ? args.pop : {}
       response = post('threads/subscribe', options)
@@ -182,6 +274,30 @@ module Disqussion
       response = post('threads/unsubscribe', options)
     end
 
+    # Updates a thread
+    # @accessibility: public key, secret key
+    # @methods: POST
+    # @format: json, jsonp
+    # @authenticated: true
+    # @limited: false
+    # @param thread [Integer] Looks up by Thread ID
+    # @return [Hashie::Rash] Updates a thread.
+    # @option options [Integer] :category. Defaults to null
+    # @option options [String] :forum. Looks up a forum by ID (aka forum shortname)
+    # @option options [String] :title. Defaults to null. Maximum length of 200
+    # @option options [String] :url. Defaults to null. URL (defined by RFC 3986). Maximum length of 500
+    # @option options [Integer] :date. Defaults to null. Unix timestamp (or ISO datetime standard)
+    # @option options [String] :message Defaults to null
+    # @option options [Integer] :identifier. Defaults to null. Maximum length of 300
+    # @option options [String] :slug. Defaults to null. Alpha-numeric slug. Maximum length of 200
+    # @example Updates thread 1
+    #   Disqussion::Client.threads.update(1,"bobross","Hello World")
+    # @see: http://disqus.com/api/3.0/threads/update.json
+	# def update(*args)
+	#    options = args.last.is_a?(Hash) ? args.pop : {}
+	#    response = post('threads/update', options)
+	# end
+
     # Register a vote on a thread.
     # @accessibility: public key, secret key
     # @methods: POST