smoodit 0.0.1

data/lib/smoodit/request.rb

@@ -0,0 +1,25 @@
+module Smoodit
+  # Defines HTTP request methods
+  module Request
+    # Perform an HTTP request
+    def request(method, path, options={}, raw=false)
+      response = connection(raw).send(method) do |request|
+        case method
+        when :get, :delete
+          request.url(formatted_path(path), options)
+        when :post, :put
+          request.path = formatted_path(path)
+          request.body = options unless options.empty?
+        end
+      end
+      
+      return raw ? response : response.body, response.status
+    end
+    
+    private
+
+    def formatted_path(path)
+      path
+    end
+  end
+end

data/lib/smoodit/version.rb

@@ -0,0 +1,4 @@
+module Smoodit
+  # The version of the gem
+  VERSION = '0.0.1'.freeze unless defined?(::Smoodit::VERSION)
+end

data/lib/smoodit.rb

@@ -0,0 +1,21 @@
+require File.expand_path('../smoodit/error', __FILE__)
+require File.expand_path('../smoodit/configuration', __FILE__)
+require File.expand_path('../smoodit/api', __FILE__)
+require File.expand_path('../smoodit/client', __FILE__)
+
+module Smoodit
+  extend Configuration
+
+  # Alias for Smoodit::Client.new
+  #
+  # @return [Smoodit::Client]
+  def self.client(options={})
+    Smoodit::Client.new(options)
+  end
+
+  # Delegate to Smoodit::Client
+  def self.method_missing(method, *args, &block)
+    #return super unless client.respond_to?(method)
+    client.send(method, *args, &block)
+  end
+end

data/smoodit.gemspec

@@ -0,0 +1,44 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/smoodit/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.add_development_dependency('bundler', '~> 1.0')
+  s.add_development_dependency('json', '~> 1.4')
+  s.add_development_dependency('nokogiri', '~> 1.4')
+  s.add_development_dependency('maruku', '~> 0.6')
+  s.add_development_dependency('rake', '~> 0.8')
+  s.add_development_dependency('rspec', '~> 2.4')
+  s.add_development_dependency('simplecov', '~> 0.3')
+  s.add_development_dependency('webmock', '~> 1.6')
+  s.add_development_dependency('yard', '~> 0.6')
+  s.add_development_dependency('ZenTest', '~> 4.4')
+  s.add_runtime_dependency('hashie', '~> 1.0.0')
+  s.add_runtime_dependency('faraday', '~> 0.5.4')
+  s.add_runtime_dependency('faraday_middleware', '~> 0.3.1')
+  s.add_runtime_dependency('jruby-openssl', '~> 0.7.2') if RUBY_PLATFORM == 'java'
+  s.add_runtime_dependency('multi_json', '~> 0.0.5')
+  s.add_runtime_dependency('multi_xml', '~> 0.2.0')
+  s.add_runtime_dependency('simple_oauth', '~> 0.1.3')
+  s.authors = ["Giovanni Cappellotto"]
+  s.description = %q{A Ruby wrapper for the Smood it REST API}
+  s.post_install_message =<<eos
+********************************************************************************
+
+  Follow @smoodit on Twitter for announcements, updates, and news.
+  http://twitter.com/smoodit
+
+********************************************************************************
+eos
+  s.email = ['gcappellotto@smood.it']
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.files = `git ls-files`.split("\n")
+  s.homepage = 'https://github.com/potomak/smoodit'
+  s.name = 'smoodit'
+  s.platform = Gem::Platform::RUBY
+  s.require_paths = ['lib']
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.6') if s.respond_to? :required_rubygems_version=
+  s.rubyforge_project = s.name
+  s.summary = %q{Ruby wrapper for the Smood it API}
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.version = Smoodit::VERSION.dup
+end

data/spec/faraday/response_spec.rb

@@ -0,0 +1,31 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Faraday::Response do
+  before do
+    @client = Smoodit::Client.new
+  end
+
+  {
+    400 => Smoodit::BadRequest,
+    401 => Smoodit::Unauthorized,
+    403 => Smoodit::Forbidden,
+    404 => Smoodit::NotFound,
+    406 => Smoodit::NotAcceptable,
+    500 => Smoodit::InternalServerError,
+    502 => Smoodit::BadGateway,
+    503 => Smoodit::ServiceUnavailable,
+  }.each do |status, exception|
+    context "when HTTP status is #{status}" do
+
+      before do
+        stub_get('users/171').to_return(:status => status)
+      end
+
+      it "should raise #{exception.name} error" do
+        lambda do
+          @client.users(171) {|user| user}
+        end.should raise_error(exception)
+      end
+    end
+  end
+end

data/spec/fixtures/user_john.js

@@ -0,0 +1,7 @@
+{
+    "avatar": "http://example.com/avatar.png",
+    "web": "http://example.com",
+    "username": "john",
+    "name": "John Doe",
+    "id": 1
+}

data/spec/smoodit/api_spec.rb

@@ -0,0 +1,68 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Smoodit::API do
+  before do
+    @keys = Smoodit::Configuration::VALID_OPTIONS_KEYS
+  end
+
+  context "with module configuration" do
+
+    before do
+      Smoodit.configure do |config|
+        @keys.each do |key|
+          config.send("#{key}=", key)
+        end
+      end
+    end
+
+    after do
+      Smoodit.reset
+    end
+
+    it "should inherit module configuration" do
+      api = Smoodit::API.new
+      @keys.each do |key|
+        api.send(key).should == key
+      end
+    end
+
+    context "with class configuration" do
+
+      before do
+        @configuration = {
+          :consumer_key => 'CK',
+          :consumer_secret => 'CS',
+          :oauth_token => 'OT',
+          :oauth_token_secret => 'OS',
+          :adapter => :typhoeus,
+          :endpoint => 'http://tumblr.com/',
+          :format => :xml,
+          :proxy => 'http://giovanni:secret@proxy.example.com:8080',
+          :user_agent => 'Custom User Agent',
+        }
+      end
+
+      context "during initialization"
+
+        it "should override module configuration" do
+          api = Smoodit::API.new(@configuration)
+          @keys.each do |key|
+            api.send(key).should == @configuration[key]
+          end
+        end
+
+      context "after initilization" do
+
+        it "should override module configuration after initialization" do
+          api = Smoodit::API.new
+          @configuration.each do |key, value|
+            api.send("#{key}=", value)
+          end
+          @keys.each do |key|
+            api.send(key).should == @configuration[key]
+          end
+        end
+      end
+    end
+  end
+end

data/spec/smoodit/client_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+describe Smoodit::Client do
+  it "should connect using the endpoint configuration" do
+    client = Smoodit::Client.new
+    endpoint = URI.parse(client.api_endpoint)
+    connection = client.send(:connection).build_url(nil).to_s
+    connection.should == endpoint.to_s
+  end
+end

data/spec/smoodit_spec.rb

@@ -0,0 +1,228 @@
+require File.expand_path('../spec_helper', __FILE__)
+
+describe Smoodit do
+  after do
+    Smoodit.reset
+  end
+
+  context "when delegating to a client" do
+    before do
+      stub_get("john").
+        to_return(:body => fixture("user_john.js"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+
+    it "should get the correct resource" do
+      Smoodit.john {|user| user}
+      a_get("john").
+        should have_been_made
+    end
+
+    it "should return the same results as a client" do
+      class_obj = nil
+      client_obj = nil
+    
+      Smoodit.john {|user| class_obj = user}
+      Smoodit::Client.new.john {|user| client_obj = user}
+    
+      class_obj.should == client_obj
+    end
+  end
+  
+  context "when making a request to" do
+    # https://github.com/smoodit/api/wiki/User-profile
+    # https://github.com/smoodit/api/wiki/Your-profile
+    ["john", "profile"].each do |member|
+      describe "GET #{member}" do
+        before do
+          stub_get(member)
+          
+          @request = Smoodit.send(member) {|r| r}
+        end
+
+        it "should use '#{member}' request path" do
+          @request.proxy.path.should == member
+        end
+        
+        it "should use GET request verb" do
+          @request.proxy.verb.should == :get
+        end
+      end
+    end
+    
+    # https://github.com/smoodit/api/wiki/Followers
+    # https://github.com/smoodit/api/wiki/Following
+    # https://github.com/smoodit/api/wiki/User-smoods
+    ["followers", "following", "smoods"].each do |member|
+      describe "GET john/#{member}" do
+        before do
+          stub_get("john/#{member}")
+          
+          @request = Smoodit.john.send(member) {|r| r}
+        end
+
+        it "should use 'john/#{member}' request path" do
+          @request.proxy.path.should == "john/#{member}"
+        end
+        
+        it "should use GET request verb" do
+          @request.proxy.verb.should == :get
+        end
+      end
+    end
+    
+    # https://github.com/smoodit/api/wiki/Your-smoods
+    describe "GET profile/smoods" do
+      before do
+        stub_get("profile/smoods")
+        
+        @request = Smoodit.profile.smoods {|r| r}
+      end
+
+      it "should use 'profile/smoods' request path" do
+        @request.proxy.path.should == "profile/smoods"
+      end
+      
+      it "should use GET request verb" do
+        @request.proxy.verb.should == :get
+      end
+    end
+    
+    # https://github.com/smoodit/api/wiki/Follow-user
+    # https://github.com/smoodit/api/wiki/Unfollow-user
+    ["follow", "unfollow"].each do |member|
+      describe "POST users/123/#{member}" do
+        before do
+          stub_post("users/123/#{member}")
+      
+          @request = Smoodit.users(123).send(member).post {|r| r}
+        end
+    
+        it "should use 'users/123/#{member}' request path" do
+          @request.proxy.path.should == "users/123/#{member}"
+        end
+    
+        it "should use POST request verb" do
+          @request.proxy.verb.should == :post
+        end
+      end
+    end
+    
+    # https://github.com/smoodit/api/wiki/Create-new-smood
+    describe "POST smoods" do
+      before do
+        stub_post("smoods")
+        
+        Smoodit.configure do |config|
+          config.format = :test
+        end
+      
+        @options = {
+          :smood => {
+            :mood => :anger
+          }
+        }
+        
+        @request = Smoodit.smoods.post(@options) {|r| r}
+      end
+    
+      it "should use 'smoods' request path" do
+        @request.proxy.path.should == "smoods"
+      end
+    
+      it "should use POST request verb" do
+        @request.proxy.verb.should == :post
+      end
+    
+      it "should include new smood parameters into request" do
+        @request.proxy.options.should == @options
+      end
+    end
+    
+    # https://github.com/smoodit/api/wiki/Delete-smood
+    describe "DELETE smoods/123" do
+      before do
+        stub_delete("smoods/123")
+      
+        @request = Smoodit.smoods(123).delete {|r| r}
+      end
+    
+      it "should use 'smoods/123' request path" do
+        @request.proxy.path.should == "smoods/123"
+      end
+    
+      it "should use DELETE request verb" do
+        @request.proxy.verb.should == :delete
+      end
+    end
+  end
+
+  describe ".client" do
+    it "should be a Smoodit::Client" do
+      Smoodit.client.should be_a Smoodit::Client
+    end
+  end
+
+  describe ".adapter" do
+    it "should return the default adapter" do
+      Smoodit.adapter.should == Smoodit::Configuration::DEFAULT_ADAPTER
+    end
+  end
+
+  describe ".adapter=" do
+    it "should set the adapter" do
+      Smoodit.adapter = :typhoeus
+      Smoodit.adapter.should == :typhoeus
+    end
+  end
+
+  describe ".endpoint" do
+    it "should return the default endpoint" do
+      Smoodit.endpoint.should == Smoodit::Configuration::DEFAULT_ENDPOINT
+    end
+  end
+
+  describe ".endpoint=" do
+    it "should set the endpoint" do
+      Smoodit.endpoint = 'http://tumblr.com/'
+      Smoodit.endpoint.should == 'http://tumblr.com/'
+    end
+  end
+
+  describe ".format" do
+    it "should return the default format" do
+      Smoodit.format.should == Smoodit::Configuration::DEFAULT_FORMAT
+    end
+  end
+
+  describe ".format=" do
+    it "should set the format" do
+      Smoodit.format = 'xml'
+      Smoodit.format.should == 'xml'
+    end
+  end
+
+  describe ".user_agent" do
+    it "should return the default user agent" do
+      Smoodit.user_agent.should == Smoodit::Configuration::DEFAULT_USER_AGENT
+    end
+  end
+
+  describe ".user_agent=" do
+    it "should set the user_agent" do
+      Smoodit.user_agent = 'Custom User Agent'
+      Smoodit.user_agent.should == 'Custom User Agent'
+    end
+  end
+
+  describe ".configure" do
+    Smoodit::Configuration::VALID_OPTIONS_KEYS.each do |key|
+
+      it "should set the #{key}" do
+        Smoodit.configure do |config|
+          config.send("#{key}=", key)
+          Smoodit.send(key).should == key
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,54 @@
+require 'simplecov'
+SimpleCov.start do
+  add_group 'Smoodit', 'lib/smoodit'
+  add_group 'Faraday Middleware', 'lib/faraday'
+  add_group 'Specs', 'spec'
+end
+
+require File.expand_path('../../lib/smoodit', __FILE__)
+
+require 'rspec'
+require 'webmock/rspec'
+RSpec.configure do |config|
+  config.include WebMock::API
+end
+
+def a_delete(path)
+  a_request(:delete, Smoodit.endpoint + path)
+end
+
+def a_get(path)
+  a_request(:get, Smoodit.endpoint + path)
+end
+
+def a_post(path)
+  a_request(:post, Smoodit.endpoint + path)
+end
+
+def a_put(path)
+  a_request(:put, Smoodit.endpoint + path)
+end
+
+def stub_delete(path)
+  stub_request(:delete, Smoodit.endpoint + path)
+end
+
+def stub_get(path)
+  stub_request(:get, Smoodit.endpoint + path)
+end
+
+def stub_post(path)
+  stub_request(:post, Smoodit.endpoint + path)
+end
+
+def stub_put(path)
+  stub_request(:put, Smoodit.endpoint + path)
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end