disqussed 0.0.2

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea/*
+.rvmrc
+.DS_Store
+!.gitkeep
+.jhw-cache

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in disqussed.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Michael Carey
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,84 @@
+# Disqussed
+
+A simple wrapper around the Disqus V3 API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'disqussed'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install disqussed
+
+## Configuration
+
+Edit lib/disqussed.rb and add your api_key and access_token. These can be found on the application page for your app
+by going to http://disqus.com/api/applications and choosing your application.
+
+## Usage
+
+### Threads
+
+#### Create
+
+Required - forum, title
+
+Options - none
+
+    Disqussed::Threads.create(forum, title)
+
+#### Details
+
+Required - thread
+
+Options - none
+
+    Disqussed::Threads.details(thread)
+
+#### Post Count
+
+Required - thread
+
+Options - none
+
+    Disqussed::Threads.post_count(thread)
+
+
+#### Remove
+
+Required - thread
+
+Options - none
+
+    Disqussed::Threads.remove(thread)
+
+### Posts
+
+#### Create
+
+Required - message
+
+Options - thread, author_email, author_name,
+
+    Disqussed::Post.create("message", { :thread => thread }).
+
+#### List
+
+Required - none
+Options - category, thread, forum, since, related, limit, offset, include, order
+
+    Disqussed::Post.list({ :thread => thread })
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/disqussed.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/disqussed/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Michael Carey"]
+  gem.email         = ["mcarey@stippleit.com"]
+  gem.description   = %q{Lightweight wrapper around the Disqus V3 API}
+  gem.summary       = %q{Disqus V3 API Wrapper}
+  gem.homepage      = ""
+
+  gem.add_dependency "httparty"
+  gem.add_dependency "oj"
+  gem.add_dependency "multi_json"
+  gem.add_dependency "activesupport"
+
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency "vcr"
+  gem.add_development_dependency "fakeweb"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "disqussed"
+  gem.require_paths = ["lib"]
+  gem.version       = Disqussed::VERSION
+end

data/lib/disqussed.rb

@@ -0,0 +1,19 @@
+require 'disqussed/version'
+require 'disqussed/api'
+require 'disqussed/threads'
+require 'disqussed/posts'
+require 'active_support/core_ext/hash'
+
+module Disqussed
+  @defaults = {
+    :api_key => "",
+    :secret_key => "", # only required if sso is set to true
+    :forum => "",
+    :access_token => "",
+    :sso => false
+  }
+
+  def self.defaults
+    @defaults
+  end
+end

data/lib/disqussed/api.rb

@@ -0,0 +1,44 @@
+require 'httparty'
+require 'digest/sha1'
+
+module Disqussed
+  class Api
+    ROOT = 'https://disqus.com/api'
+    API_VERSION = '3.0'
+
+    class << self
+      def request(method, endpoint, action, opts = {}, authenticate_as_self = false, user = {})
+        throw "Missing API Key" if Disqussed::defaults[:api_key].nil?
+
+        opts[:api_key] = Disqussed::defaults[:api_key]
+        opts[:api_secret] = Disqussed::defaults[:secret_key]
+
+        if authenticate_as_self
+          opts[:access_token] = Disqussed::defaults[:access_token]
+        elsif Disqussed::defaults[:sso]
+          throw "Missing API Secret" if Disqussed::defaults[:secret_key].nil?
+
+          user.slice!(:id, :username, :email, :avatar, :url)
+
+          opts[:remote_auth] = remote_auth_s3(user)
+        end
+
+        if method === "post"
+          HTTParty.post([ROOT, API_VERSION, endpoint, action + '.json'].join('/'), { :body => opts })
+        elsif method === "get"
+          HTTParty.get([ROOT, API_VERSION, endpoint, action + '.json'].join('/'), { :query => opts })
+        end
+      end
+
+      def remote_auth_s3(data)
+        digest = OpenSSL::Digest::Digest.new('sha1')
+        data = Base64.urlsafe_encode64(MultiJson.dump(data))
+        timestamp = Time.now.to_i
+
+        sha1 = OpenSSL::HMAC.hexdigest(digest, Disqussed::defaults[:secret_key], "#{data} #{timestamp}")
+
+        "#{data} #{sha1} #{timestamp}"
+      end
+    end
+  end
+end

data/lib/disqussed/posts.rb

@@ -0,0 +1,23 @@
+module Disqussed
+  class Posts
+    ENDPOINT = 'posts'
+
+    class << self
+      def create(message = nil, opts = {}, user = {})
+        opts[:message] = message
+
+        opts.slice!(:thread, :author_email, :author_name, :message, :forum)
+
+        Disqussed::Api.request('post', ENDPOINT, 'create', opts, false, user)
+      end
+
+      def list(opts = {})
+        opts.slice!(:category, :thread, :forum, :since,
+          :related, :limit, :offset, :include, :order
+        )
+
+        Disqussed::Api.request('get', ENDPOINT, 'list', opts, false)
+      end
+    end
+  end
+end

data/lib/disqussed/threads.rb

@@ -0,0 +1,64 @@
+module Disqussed
+  class Threads
+    ENDPOINT = 'threads'
+
+    class << self
+      def create(forum = nil, title = nil, opts = {})
+        opts[:forum] = forum ? forum : Disqussed::defaults[:forum]
+        opts[:title] = title
+
+        opts.slice!(:forum, :title, :identifier, :slug)
+
+        Disqussed::Api.request('post', ENDPOINT, 'create', opts, true)
+      end
+
+      def details(thread = nil)
+        opts = {}
+        opts[:thread] = thread
+
+        opts.slice!(:thread)
+
+        Disqussed::Api.request('get', ENDPOINT, 'details', opts, true)
+      end
+
+      def get_thread_id_by_ident(identifier, opts = {})
+        opts[:forum] = opts[:forum] ? opts[:forum] : Disqussed::defaults[:forum]
+
+        opts.slice!(:forum)
+
+        opts["thread:ident"] = identifier
+        Disqussed::Api.request('get', ENDPOINT, 'details', opts, true)
+      end
+
+      def post_count(thread = nil)
+        opts = {}
+        opts[:thread] = thread
+
+        opts.slice!(:thread)
+
+        details = Disqussed::Api.request('get', ENDPOINT, 'details', opts, true)
+
+        details["response"]["posts"]
+      end
+
+      def remove(thread = nil)
+        opts = {}
+        opts[:thread] = thread
+
+        opts.slice!(:thread)
+
+        Disqussed::Api.request('post', ENDPOINT, 'remove', opts, true)
+      end
+
+      def remove_thread_by_ident(identifier, opts = {})
+        opts[:forum] = opts[:forum] ? opts[:forum] : Disqussed::defaults[:forum]
+
+        opts.slice!(:forum)
+
+        opts["thread:ident"] = identifier
+        Disqussed::Api.request('post', ENDPOINT, 'remove', opts, true)
+      end
+
+    end
+  end
+end

data/lib/disqussed/version.rb

@@ -0,0 +1,3 @@
+module Disqussed
+  VERSION = "0.0.2"
+end

data/spec/disqussed/api_spec.rb

@@ -0,0 +1,90 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe Disqussed::Api do
+  before :each do
+    Disqussed::defaults[:sso] = false
+  end
+
+  describe "post" do
+    it "builds a simple Disqus Post Request" do
+      HTTParty
+        .should_receive(:post)
+        .with("https://disqus.com/api/3.0/endpoint/action.json",
+              :body => { :api_key => Disqussed::defaults[:api_key],
+                         :api_secret => Disqussed::defaults[:secret_key] })
+
+      Disqussed::Api.request('post', 'endpoint', 'action')
+    end
+
+    it "passes on options" do
+      HTTParty
+        .should_receive(:post)
+        .with("https://disqus.com/api/3.0/endpoint/action.json",
+              :body => { :api_key => Disqussed::defaults[:api_key],
+                         :api_secret => Disqussed::defaults[:secret_key],
+                         :pants => "none" })
+
+      Disqussed::Api.request('post', 'endpoint', 'action', { :pants => "none" })
+    end
+
+    it "authenticates as the access_token user" do
+      HTTParty
+        .should_receive(:post)
+        .with("https://disqus.com/api/3.0/endpoint/action.json",
+              :body => { :api_key => Disqussed::defaults[:api_key],
+                         :api_secret => Disqussed::defaults[:secret_key],
+                         :access_token => Disqussed::defaults[:access_token] })
+
+      Disqussed::Api.request('post', 'endpoint', 'action', {}, true)
+    end
+  end
+
+  describe "get" do
+    it "builds a simple Disqus Get Request" do
+      HTTParty
+        .should_receive(:get)
+        .with("https://disqus.com/api/3.0/endpoint/action.json",
+              :query => { :api_key => Disqussed::defaults[:api_key],
+                          :api_secret => Disqussed::defaults[:secret_key] })
+
+      Disqussed::Api.request('get', 'endpoint', 'action')
+    end
+
+    it "passes on options" do
+      HTTParty
+        .should_receive(:get)
+        .with("https://disqus.com/api/3.0/endpoint/action.json",
+              :query => { :api_key => Disqussed::defaults[:api_key],
+                          :api_secret => Disqussed::defaults[:secret_key],
+                          :pants => "none" })
+
+      Disqussed::Api.request('get', 'endpoint', 'action', { :pants => "none" })
+    end
+
+    it "authenticates as the access_token user" do
+      HTTParty
+        .should_receive(:get)
+        .with("https://disqus.com/api/3.0/endpoint/action.json",
+              :query => { :api_key => Disqussed::defaults[:api_key],
+                          :api_secret => Disqussed::defaults[:secret_key],
+                          :access_token => Disqussed::defaults[:access_token] })
+
+      Disqussed::Api.request('get', 'endpoint', 'action', {}, true)
+    end
+  end
+
+  describe "remote_auth_s3" do
+    before :each do
+      @unix_timestamp = 1347468657
+      Time.any_instance.stub(:to_i).and_return(@unix_timestamp)
+    end
+
+    it "generates an auth string" do
+      data = { :id => 1234, :username => "shlappy", :email => "test@stipple-test.com", :avatar => "linkified", :url => "fanks" }
+      encoded = "eyJpZCI6MTIzNCwidXNlcm5hbWUiOiJzaGxhcHB5IiwiZW1haWwiOiJ0ZXN0QHN0aXBwbGUtdGVzdC5jb20iLCJhdmF0YXIiOiJsaW5raWZpZWQiLCJ1cmwiOiJmYW5rcyJ9"
+      sha1 = "5d75f738e7c1c6da7359f9870a06d2d12406b1ec"
+
+      Disqussed::Api.remote_auth_s3(data).should == "#{encoded} #{sha1} #@unix_timestamp"
+    end
+  end
+end

data/spec/disqussed/posts_spec.rb

@@ -0,0 +1,114 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'spec_helper'))
+
+describe Disqussed::Posts do
+  before :each do
+    Disqussed::defaults[:sso] = true
+
+    @user = { :username => "Tester", :id => "1", :email => "test_account1@stipple.com" }
+    @user2 = { :username => "Tester 2", :id => "2", :email => "test_account2@stipple.com" }
+  end
+
+  describe "create" do
+    describe "failure" do
+      context "no message" do
+        use_vcr_cassette
+
+        before :each do
+          @resp = Disqussed::Posts.create
+        end
+
+        it "returns with a 400 HTTP status code" do
+          @resp.code.should == 400
+        end
+
+        it "returns with a response code 2" do
+          @resp['code'].should == 2
+        end
+      end
+
+      context "no thread" do
+        use_vcr_cassette
+
+        before :each do
+          @resp = Disqussed::Posts.create("missing thread", {}, @user)
+        end
+
+        it "returns with a 400 HTTP status code" do
+          @resp.code.should == 400
+        end
+
+        it "returns with a response code 2" do
+          @resp['code'].should == 2
+        end
+      end
+
+      context "no privileges" do
+        use_vcr_cassette
+
+        before :each do
+          @resp = Disqussed::Posts.create("no privileges", { :thread => "808" })
+        end
+
+        it "returns with a 400 HTTP status code" do
+          @resp.code.should == 400
+        end
+
+        it "returns with a response code 2" do
+          @resp['code'].should == 2
+        end
+      end
+    end
+
+    context "success" do
+      use_vcr_cassette
+
+      before :each do
+        @thread = Disqussed::Threads.create(nil, Time.now.to_f)
+        @resp = Disqussed::Posts.create(SecureRandom.hex(10), { :thread => @thread['response']['id'] }, @user)
+      end
+
+      it "returns with a 200 HTTP Status code" do
+        @resp.code.should == 200
+      end
+    end
+  end
+
+  describe "list" do
+    describe "success" do
+      context "all thread posts" do
+        use_vcr_cassette :match_requests_on => [:host, :path]
+
+        before :each do
+          @resp = Disqussed::Posts.list
+        end
+
+        it "returns a list of posts" do
+          @resp['response'].should_not be_empty
+        end
+
+        it "returns with a 200 HTTP status code" do
+          @resp.code.should == 200
+        end
+      end
+
+      context "specific thread posts" do
+        use_vcr_cassette :match_requests_on => [:host, :path]
+
+        before :each do
+          @thread = Disqussed::Threads.create(Disqussed::defaults[:forum], Time.now.to_f)
+          Disqussed::Posts.create("test", { :thread => @thread['response']['id'] }, @user)
+          Disqussed::Posts.create("test 2", { :thread => @thread['response']['id'] }, @user2)
+          @resp = Disqussed::Posts.list({:forum => Disqussed::defaults[:forum], :thread => @thread['response']['id']})
+        end
+
+        it "returns a list of posts" do
+          @resp['response'].should_not be_empty
+        end
+
+        it "returns with a 200 HTTP status code" do
+          @resp.code.should == 200
+        end
+      end
+    end
+  end
+end