sunstone 0.1.0 → 1.0.0

data/lib/sunstone/connection.rb

@@ -0,0 +1,337 @@
+require 'uri'
+require 'net/http'
+require 'net/https'
+
+# # _Sunstone_ is a low-level API. It provides basic HTTP #get, #post, #put, and
+# # #delete calls to the Sunstone Server. It can also provides basic error
+# # checking of responses.
+module Sunstone
+  class Connection
+    
+    # Set the User-Agent of the client. Will be joined with other User-Agent info
+    attr_writer :user_agent
+    attr_accessor :api_key, :host, :port, :use_ssl
+    
+    # Initialize a connection a Sunstone API server.
+    #
+    # Options:
+    #
+    # * <tt>:site</tt> - An optional url used to set the protocol, host, port,
+    #   and api_key
+    # * <tt>:host</tt> - The default is to connect to 127.0.0.1.
+    # * <tt>:port</tt> - Defaults to 80.
+    # * <tt>:use_ssl</tt> - Defaults to false.
+    # * <tt>:api_key</tt> - An optional token to send in the `Api-Key` header
+    def initialize(config)
+      if config[:site]
+        uri = URI.parse(config.delete(:site))
+        config[:api_key] ||= (uri.user ? CGI.unescape(uri.user) : nil)
+        config[:host]    ||= uri.host
+        config[:port]    ||= uri.port
+        config[:use_ssl] ||= (uri.scheme == 'https')
+      end
+      
+      [:api_key, :host, :port, :use_ssl, :user_agent].each do |key|
+        self.send(:"#{key}=", config[key])
+      end
+      
+      @connection = Net::HTTP.new(host, port)
+      @connection.use_ssl = use_ssl
+    end
+    
+    # Ping the Sunstone. If everything is configured and operating correctly
+    # <tt>"pong"</tt> will be returned. Otherwise and Sunstone::Exception should be
+    # thrown.
+    #
+    #  #!ruby
+    #  Sunstone.ping # => "pong"
+    #
+    #  Sunstone.ping # raises Sunstone::Exception::ServiceUnavailable if a 503 is returned
+    def ping
+      get('/ping').body
+    end
+
+    # Returns the User-Agent of the client. Defaults to:
+    # "sunstone-ruby/SUNSTONE_VERSION RUBY_VERSION-pPATCH_LEVEL PLATFORM"
+    def user_agent
+      [
+        @user_agent,
+        "Sunstone/#{Sunstone::VERSION}",
+        "Ruby/#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL}",
+        RUBY_PLATFORM
+      ].compact.join(' ')
+    end
+   
+    # Sends a Net::HTTPRequest to the server. The headers returned from
+    # Sunestone#headers are automatically added to the request. The appropriate
+    # error is raised if the response is not in the 200..299 range.
+    #
+    # Paramaters::
+    #
+    # * +request+ - A Net::HTTPRequest to send to the server
+    # * +body+ - Optional, a String, IO Object, or a Ruby object which is 
+    #            converted into JSON and sent as the body
+    # * +block+ - An optional block to call with the +Net::HTTPResponse+ object.
+    #
+    # Return Value::
+    #
+    #  Returns the return value of the <tt>&block</tt> if given, otherwise the
+    #  response object (a Net::HTTPResponse)
+    #
+    # Examples:
+    #
+    #  #!ruby
+    #  Sunstone.send_request(#<Net::HTTP::Get>) # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.send_request(#<Net::HTTP::Get @path="/404">) # => raises Sunstone::Exception::NotFound
+    #
+    #  # this will still raise an exception if the response_code is not valid
+    #  # and the block will not be called
+    #  Sunstone.send_request(#<Net::HTTP::Get>) do |response|
+    #    # ...
+    #  end
+    #
+    #  # The following example shows how to stream a response:
+    #  Sunstone.send_request(#<Net::HTTP::Get>) do |response|
+    #    response.read_body do |chunk|
+    #      io.write(chunk)
+    #    end
+    #  end
+    def send_request(request, body=nil, &block)
+      request_headers.each { |k, v| request[k] = v }
+    
+      if body.is_a?(IO)
+        request['Transfer-Encoding'] = 'chunked'
+        request.body_stream =  body
+      elsif body.is_a?(String)
+        request.body = body
+      elsif body
+        request.body = Wankel.encode(body)
+      end
+    
+      return_value = nil
+      @connection.request(request) do |response|
+      
+        if response['X-42Floors-API-Version-Deprecated']
+          logger.warn("DEPRECATION WARNING: API v#{API_VERSION} is being phased out")
+        end
+      
+        validate_response_code(response)
+      
+        # Get the cookies
+        response.each_header do |key, value|
+          if key.downcase == 'set-cookie' && Thread.current[:sunstone_cookie_store]
+            Thread.current[:sunstone_cookie_store].set_cookie("#{site}#{request.path}", value)
+          end
+        end
+      
+        if block_given?
+          return_value =yield(response)
+        else
+          return_value =response
+        end
+      end
+
+    
+      return_value
+    end
+    
+    # Send a GET request to +path+ on the Sunstone Server via +Sunstone#send_request+.
+    # See +Sunstone#send_request+ for more details on how the response is handled.
+    #
+    # Paramaters::
+    #
+    # * +path+ - The +path+ on the server to GET to.
+    # * +params+ - Either a String, Hash, or Ruby Object that responds to
+    #              #to_param. Appended on the URL as query params
+    # * +block+ - An optional block to call with the +Net::HTTPResponse+ object.
+    #
+    # Return Value::
+    #
+    #  See +Sunstone#send_request+
+    #
+    # Examples:
+    #
+    #  #!ruby
+    #  Sunstone.get('/example') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.get('/example', 'query=stuff') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.get('/example', {:query => 'stuff'}) # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.get('/404') # => raises Sunstone::Exception::NotFound
+    #
+    #  Sunstone.get('/act') do |response|
+    #    # ...
+    #  end
+    def get(path, params='', &block)
+      params ||= ''
+      request = Net::HTTP::Get.new(path + '?' + params.to_param)
+    
+      send_request(request, nil, &block)
+    end
+    
+    # Send a POST request to +path+ on the Sunstone Server via +Sunstone#send_request+.
+    # See +Sunstone#send_request+ for more details on how the response is handled.
+    #
+    # Paramaters::
+    #
+    # * +path+ - The +path+ on the server to POST to.
+    # * +body+ - Optional, See +Sunstone#send_request+.
+    # * +block+ - Optional, See +Sunstone#send_request+
+    #
+    # Return Value::
+    #
+    #  See +Sunstone#send_request+
+    #
+    # Examples:
+    #
+    #  #!ruby
+    #  Sunstone.post('/example') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.post('/example', 'body') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.post('/example', #<IO Object>) # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.post('/example', {:example => 'data'}) # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.post('/404') # => raises Sunstone::Exception::NotFound
+    #
+    #  Sunstone.post('/act') do |response|
+    #    # ...
+    #  end
+    def post(path, body=nil, &block)
+      request = Net::HTTP::Post.new(path)
+    
+      send_request(request, body, &block)
+    end
+    
+    # Send a PUT request to +path+ on the Sunstone Server via +Sunstone#send_request+.
+    # See +Sunstone#send_request+ for more details on how the response is handled.
+    #
+    # Paramaters::
+    #
+    # * +path+ - The +path+ on the server to POST to.
+    # * +body+ - Optional, See +Sunstone#send_request+.
+    # * +block+ - Optional, See +Sunstone#send_request+
+    #
+    # Return Value::
+    #
+    #  See +Sunstone#send_request+
+    #
+    # Examples:
+    #
+    #  #!ruby
+    #  Sunstone.put('/example') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.put('/example', 'body') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.put('/example', #<IO Object>) # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.put('/example', {:example => 'data'}) # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.put('/404') # => raises Sunstone::Exception::NotFound
+    #
+    #  Sunstone.put('/act') do |response|
+    #    # ...
+    #  end
+    def put(path, body=nil, *valid_response_codes, &block)
+      request = Net::HTTP::Put.new(path)
+    
+      send_request(request, body, &block)
+    end
+  
+    # Send a DELETE request to +path+ on the Sunstone Server via +Sunstone#send_request+.
+    # See +Sunstone#send_request+ for more details on how the response is handled
+    #
+    # Paramaters::
+    #
+    # * +path+ - The +path+ on the server to POST to.
+    # * +block+ - Optional, See +Sunstone#send_request+
+    #
+    # Return Value::
+    #
+    #  See +Sunstone#send_request+
+    #
+    # Examples:
+    #
+    #  #!ruby
+    #  Sunstone.delete('/example') # => #<Net::HTTP::Response>
+    #
+    #  Sunstone.delete('/404') # => raises Sunstone::Exception::NotFound
+    #
+    #  Sunstone.delete('/act') do |response|
+    #    # ...
+    #  end
+    def delete(path, &block)
+      request = Net::HTTP::Delete.new(path)
+    
+      send_request(request, nil, &block)
+    end
+
+    def server_config
+      @server_config ||= Wankel.parse(get('/config').body, :symbolize_keys => true)
+    end
+    
+    private
+    
+    def request_headers
+      headers = {
+        'Content-Type'            => 'application/json',
+        'User-Agent'              => user_agent,
+        'Api-Version' => '0.1.0'
+      }
+    
+      headers['Api-Key'] = api_key if api_key
+    
+      headers
+    end
+
+    # Raise an Sunstone::Exception based on the response_code, unless the response_code
+    # is include in the valid_response_codes Array
+    #
+    # Paramaters::
+    #
+    # * +response+ - The Net::HTTP::Response object
+    #
+    # Return Value::
+    #
+    #  If an exception is not raised the +response+ is returned
+    #
+    # Examples:
+    #
+    #  #!ruby
+    #  Sunstone.validate_response_code(<Net::HTTP::Response @code=200>) # => <Net::HTTP::Response @code=200>
+    #
+    #  Sunstone.validate_response_code(<Net::HTTP::Response @code=404>) # => raises Sunstone::Exception::NotFound
+    #
+    #  Sunstone.validate_response_code(<Net::HTTP::Response @code=500>) # => raises Sunstone::Exception
+    def validate_response_code(response)
+      code = response.code.to_i
+    
+      if !(200..299).include?(code)
+        case code
+        when 400
+          raise Sunstone::Exception::BadRequest, response
+        when 401
+          raise Sunstone::Exception::Unauthorized, response
+        when 404
+          raise Sunstone::Exception::NotFound, response
+        when 410
+          raise Sunstone::Exception::Gone, response
+        when 422
+          raise Sunstone::Exception::ApiVersionUnsupported, response
+        when 503
+          raise Sunstone::Exception::ServiceUnavailable, response
+        when 301
+          raise Sunstone::Exception::MovedPermanently, response
+        when 300..599
+          raise Sunstone::Exception, response
+        else
+          raise Sunstone::Exception, response
+        end
+      end
+    end
+    
+  end
+end

data/sunstone.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = "sunstone"
-  s.version     = '0.1.0'
+  s.version     = '1.0.0'
   s.authors     = ["Jon Bracy"]
   s.email       = ["jonbracy@gmail.com"]
   s.homepage    = "http://sunstonerb.com"
@@ -28,7 +28,8 @@ Gem::Specification.new do |s|
   # Runtime
   s.add_runtime_dependency 'wankel'
   s.add_runtime_dependency 'cookie_store'
+  s.add_runtime_dependency 'arel'
   s.add_runtime_dependency 'activesupport'
   s.add_runtime_dependency 'activemodel'
-  s.add_runtime_dependency 'connection_pool'
+  s.add_runtime_dependency 'activerecord'
 end

data/test/sunstone/connection_test.rb

@@ -0,0 +1,319 @@
+require 'test_helper'
+
+class Sunstone::ConnectionTest < Minitest::Test
+
+  # ::new =====================================================================
+  test "setting the site sets the api_key" do
+    connection = Sunstone::Connection.new(:site => 'https://my_api_key@localhost')
+    assert_equal('my_api_key', connection.api_key)
+  end
+
+  test "setting the site sets the host" do
+    connection = Sunstone::Connection.new(:site => 'https://my_api_key@example.com')
+    assert_equal('example.com', connection.host)
+  end
+
+  test "setting the site sets the port" do
+    connection = Sunstone::Connection.new(:site => 'http://my_api_key@localhost')
+    assert_equal(80, connection.port)
+
+    connection = Sunstone::Connection.new(:site => 'https://my_api_key@localhost')
+    assert_equal(443, connection.port)
+    
+    connection = Sunstone::Connection.new(:site => 'https://my_api_key@localhost:4321')
+    assert_equal(4321, connection.port)
+  end
+
+  test "setting the site sets the use_ssl option" do
+    connection = Sunstone::Connection.new(:site => 'http://my_api_key@localhost')
+    assert_equal(false, connection.use_ssl)
+    
+    connection = Sunstone::Connection.new(:site => 'https://my_api_key@localhost')
+    assert_equal(true, connection.use_ssl)
+  end
+  
+  test "setting the user_agent appends it to the User-Agent" do
+    connection = Sunstone::Connection.new(:site => 'http://my_api_key@localhost')
+    assert_equal("Sunstone/#{Sunstone::VERSION} Ruby/#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL} #{RUBY_PLATFORM}", connection.user_agent)
+    
+    connection = Sunstone::Connection.new(:site => 'http://my_api_key@localhost', :user_agent => "MyGem/3.14")
+    assert_equal("MyGem/3.14 Sunstone/#{Sunstone::VERSION} Ruby/#{RUBY_VERSION}-p#{RUBY_PATCHLEVEL} #{RUBY_PLATFORM}", connection.user_agent)
+  end
+
+  #send_request =============================================================
+
+  test '#send_request(#<Net::HTTPRequest>)' do
+    stub_request(:get, "http://testhost.com/test").to_return(:body => "get")
+    
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    assert_equal('get', connection.send_request(Net::HTTP::Get.new('/test')).body)
+  end
+
+  test '#send_request(#<Net::HTTPRequest>, body) with string body' do
+    stub_request(:post, "http://testhost.com/test").with(:body => '{"key":"value"}').to_return(:body => "post")
+
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    assert_equal('post', connection.send_request(Net::HTTP::Post.new('/test'), '{"key":"value"}').body)
+  end
+
+  test '#send_request(#<Net::HTTPRequest>, body) with IO body' do
+    stub_request(:post, "http://testhost.com/test").with { |request|
+      request.headers['Transfer-Encoding'] == "chunked" && request.body == '{"key":"value"}'
+    }.to_return(:body => "post")
+
+    rd, wr = IO.pipe
+    wr.write('{"key":"value"}')
+    wr.close
+
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    assert_equal('post', connection.send_request(Net::HTTP::Post.new('/test'), rd).body)
+  end
+
+  test '#send_request(#<Net::HTTPRequest>, body) with Ruby Object body' do
+    stub_request(:post, "http://testhost.com/test").with(:body => '{"key":"value"}').to_return(:body => "post")
+
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    assert_equal('post', connection.send_request(Net::HTTP::Post.new('/test'), {:key => 'value'}).body)
+  end
+
+  test '#send_request(#<Net::HTTPRequest>) raises Sunstone::Exceptions on non-200 responses' do
+    stub_request(:get, "http://testhost.com/400").to_return(:status => 400)
+    stub_request(:get, "http://testhost.com/401").to_return(:status => 401)
+    stub_request(:get, "http://testhost.com/404").to_return(:status => 404)
+    stub_request(:get, "http://testhost.com/410").to_return(:status => 410)
+    stub_request(:get, "http://testhost.com/422").to_return(:status => 422)
+    stub_request(:get, "http://testhost.com/450").to_return(:status => 450)
+    stub_request(:get, "http://testhost.com/503").to_return(:status => 503)
+    stub_request(:get, "http://testhost.com/550").to_return(:status => 550)
+
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    assert_raises(Sunstone::Exception::BadRequest)   { connection.send_request(Net::HTTP::Get.new('/400')) }
+    assert_raises(Sunstone::Exception::Unauthorized) { connection.send_request(Net::HTTP::Get.new('/401')) }
+    assert_raises(Sunstone::Exception::NotFound)     { connection.send_request(Net::HTTP::Get.new('/404')) }
+    assert_raises(Sunstone::Exception::Gone)         { connection.send_request(Net::HTTP::Get.new('/410')) }
+    assert_raises(Sunstone::Exception::ApiVersionUnsupported) { connection.send_request(Net::HTTP::Get.new('/422')) }
+    assert_raises(Sunstone::Exception)               { connection.send_request(Net::HTTP::Get.new('/450')) }
+    assert_raises(Sunstone::Exception::ServiceUnavailable)    { connection.send_request(Net::HTTP::Get.new('/503')) }
+    assert_raises(Sunstone::Exception)               { connection.send_request(Net::HTTP::Get.new('/550')) }
+  end
+
+  test '#send_request(#<Net::HTTPRequest>, &block) returns value returned from &block' do
+    stub_request(:get, "http://testhost.com/test").to_return(:body => 'get')
+
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    value = connection.send_request(Net::HTTP::Get.new('/test')) do |response|
+      3215
+    end
+
+    assert_equal 3215, value
+  end
+
+  test '#send_request(#<Net::HTTPRequest>, &block)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/test").to_return(:body => 'get')
+
+    connection.send_request(Net::HTTP::Get.new('/test')) do |response|
+      assert_equal 'get', response.body
+    end
+
+    # make sure block is not called when not in valid_response_codes
+    stub_request(:get, "http://testhost.com/test").to_return(:status => 401, :body => 'get')
+
+    assert_raises(Sunstone::Exception::Unauthorized) {
+      connection.send_request(Net::HTTP::Get.new('/test')) do |response|
+        raise Sunstone::Exception, 'Should not get here'
+      end
+    }
+  end
+
+  test '#send_request(#<Net::HTTPRequest>, &block) with block reading chunks' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    
+    rd, wr = IO.pipe
+    rd = Net::BufferedIO.new(rd)
+    wr.write(<<-DATA.gsub(/^ +/, '').gsub(/\n/, "\r\n"))
+      HTTP/1.1 200 OK
+      Content-Length: 5
+
+      hello
+    DATA
+
+    res = Net::HTTPResponse.read_new(rd)
+    mock_connection = mock('connection')
+    mock_connection.stubs(:request).yields(res)
+    connection.instance_variable_set(:@connection, mock_connection)
+
+    res.reading_body(rd, true) do
+      connection.send_request(Net::HTTP::Get.new('/test')) do |response|
+        response.read_body do |chunk|
+          assert_equal('hello', chunk)
+        end
+      end
+    end
+  end
+  #
+  # test '#send_request(#<Net::HTTPRequest) adds cookies to the cookie store if present' do
+  #   store = CookieStore::HashStore.new
+  #   stub_request(:get, "http://testhost.com/test").to_return(:body => 'get', :headers => {'Set-Cookie' => 'foo=bar; Max-Age=3600'})
+  #
+  #   Sunstone.with_cookie_store(store) do
+  #     Sunstone.send_request(Net::HTTP::Get.new('/test'))
+  #   end
+  #
+  #   assert_equal 1, store.instance_variable_get(:@domains).size
+  #   assert_equal 1, store.instance_variable_get(:@domains)['testhost.com'].size
+  #   assert_equal 1, store.instance_variable_get(:@domains)['testhost.com']['/test'].size
+  #   assert_equal 'bar', store.instance_variable_get(:@domains)['testhost.com']['/test']['foo'].value
+  # end
+  #
+  # test '#send_request(#<Net::HTTPRequest>) includes the headers' do
+  #   stub_request(:get, "http://testhost.com/test").with(:headers => {
+  #     'Api-Key'      => 'test_api_key',
+  #     'Content-Type' => 'application/json',
+  #     'User-Agent'   => Sunstone.user_agent
+  #   }).to_return(:body => "get")
+  #
+  #   assert_equal('get', Sunstone.send_request(Net::HTTP::Get.new('/test')).body)
+  #
+  #   # Test without api key
+  #   Sunstone.site = "http://testhost.com"
+  #   stub_request(:get, "http://testhost.com/test").with(:headers => {
+  #     'Content-Type'=>'application/json',
+  #     'User-Agent'=>'Sunstone/0.1 Ruby/2.1.1-p76 x86_64-darwin13.0'
+  #   }).to_return(:body => "get")
+  #
+  #   assert_equal('get', Sunstone.send_request(Net::HTTP::Get.new('/test')).body)
+  # end
+  
+  #
+  # # Sunstone.with_cookie_store ================================================
+  #
+  # test '#with_cookie_store(store, &block) sets the cookie-store' do
+  #   assert_nil Thread.current[:sunstone_cookie_store]
+  #   Sunstone.with_cookie_store('my_store') do
+  #     assert_equal 'my_store', Thread.current[:sunstone_cookie_store]
+  #   end
+  #   assert_nil Thread.current[:sunstone_cookie_store]
+  # end
+
+  # Sunstone.get ==============================================================
+
+  test '#get(path)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/test").to_return(:body => "get")
+
+    assert_equal('get', connection.get('/test').body)
+  end
+
+  test '#get(path, params) with params as string' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/test").with(:query => {'key' => 'value'}).to_return(:body => "get")
+
+    assert_equal 'get', connection.get('/test', 'key=value').body
+  end
+
+  test '#get(path, params) with params as hash' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/test").with(:query => {'key' => 'value'}).to_return(:body => "get")
+
+    assert_equal 'get', connection.get('/test', {:key => 'value'}).body
+  end
+
+  test '#get(path, &block)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/test").to_return(:body => 'get')
+
+    connection.get('/test') do |response|
+      assert_equal 'get', response.body
+    end
+  end
+
+  # Sunstone.post =============================================================
+
+  test '#post(path)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:post, "http://testhost.com/test").to_return(:body => "post")
+
+    assert_equal('post', connection.post('/test').body)
+  end
+
+  test '#post(path, body)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:post, "http://testhost.com/test").with(:body => 'body').to_return(:body => "post")
+
+    assert_equal('post', connection.post('/test', 'body').body)
+  end
+
+  test '#post(path, &block)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:post, "http://testhost.com/test").to_return(:body => 'post')
+
+    connection.post('/test') do |response|
+      assert_equal 'post', response.body
+    end
+  end
+
+  # Sunstone.put ==============================================================
+
+  test '#put(path)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:put, "http://testhost.com/test").to_return(:body => "put")
+
+    assert_equal('put', connection.put('/test').body)
+  end
+
+  test '#put(path, body)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:put, "http://testhost.com/test").with(:body => 'body').to_return(:body => "put")
+
+    assert_equal('put', connection.put('/test', 'body').body)
+  end
+
+  test '#put(path, &block)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:put, "http://testhost.com/test").to_return(:body => 'put')
+
+    connection.put('/test') do |response|
+      assert_equal 'put', response.body
+    end
+  end
+
+  # Sunstone.delete ===========================================================
+
+  test '#delete' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:delete, "http://testhost.com/test").to_return(:body => "delete")
+
+    assert_equal('delete', connection.delete('/test').body)
+  end
+
+  test '#delete(path, &block)' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:delete, "http://testhost.com/test").to_return(:body => 'delete')
+
+    connection.delete('/test') do |response|
+      assert_equal 'delete', response.body
+    end
+  end
+
+  # #ping =====================================================================
+
+  test '#ping' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/ping").to_return(:body => 'pong')
+
+    assert_equal( 'pong', connection.ping )
+  end
+
+  # #server_config ===========================================================
+
+  test '#config' do
+    connection = Sunstone::Connection.new(:site => "http://test_api_key@testhost.com")
+    stub_request(:get, "http://testhost.com/config").to_return(:body => '{"server": "configs"}')
+
+    assert_equal( {:server => "configs"}, connection.server_config )
+  end
+
+
+
+end