vertebrae 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cacba90d6b51ff109cb06354b8a02a9c85aa3634
+  data.tar.gz: 29bbd9175d2b97240f28fe2d4d7e5907be7202cf
+SHA512:
+  metadata.gz: a6bc54a6d292c80f8f9d34d8cfbbebd8c0b5d2d82ccd61485cdd4c602e1b254781c7c22efc03893c4137490b57eed44dd8c30aca743ededf64532857bcb0f1e0
+  data.tar.gz: 406fca22dcddbb196a7c95b2d7ac44c98f427df9f6326b6079cff9431d67d80753f15c66256216da622422cce50a8425bf09b45f2eca8e957c4f10c74c911eb4

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/.ruby-gemset

@@ -0,0 +1 @@
+vertebrae

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p247

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+
+gem 'activesupport'
+gem 'faraday'
+gem 'faraday_middleware'
+gem 'hashie'
+
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec"
+  gem "bundler"
+  gem "jeweler", "~> 1.8.4"
+end

data/Gemfile.lock

@@ -0,0 +1,80 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    addressable (2.3.5)
+    atomic (1.1.10)
+    builder (3.2.2)
+    diff-lcs (1.2.4)
+    faraday (0.8.7)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.9.0)
+      faraday (>= 0.7.4, < 0.9)
+    git (1.2.5)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.19)
+    httpauth (0.2.0)
+    i18n (0.6.4)
+    jeweler (1.8.6)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.0)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    minitest (4.7.5)
+    multi_json (1.7.7)
+    multi_xml (0.5.4)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.2)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.1)
+    thread_safe (0.1.0)
+      atomic
+    tzinfo (0.3.37)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  bundler
+  faraday
+  faraday_middleware
+  hashie
+  jeweler (~> 1.8.4)
+  rspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 ControlShift Ltd.
+
+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.rdoc

@@ -0,0 +1,19 @@
+= vertebrae
+
+Description goes here.
+
+== Contributing to vertebrae
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 Nathan Woodhull. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "vertebrae"
+  gem.homepage = "http://github.com/controlshift/vertebrae"
+  gem.license = "MIT"
+  gem.summary = %Q{API Client Infrastructure}
+  gem.description = %Q{A set of low level infrastructure and reusable code for building API clients}
+  gem.email = "nathan@controlshiftlabs.com"
+  gem.authors = ["Nathan Woodhull"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "vertebrae #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/api.rb

@@ -0,0 +1,155 @@
+module Vertebrae
+  class API
+
+    include Connection
+    include Request
+    include Authorization
+
+    attr_reader *Configuration.keys
+
+    attr_accessor :current_options
+
+    # Callback to update current configuration options
+    class_eval do
+      Configuration.keys.each do |key|
+        define_method "#{key}=" do |arg|
+          self.instance_variable_set("@#{key}", arg)
+          self.current_options.merge!({:"#{key}" => arg})
+        end
+      end
+    end
+
+    # Create new API
+    #
+    def initialize(options={}, &block)
+      setup(options)
+      yield_or_eval(&block) if block_given?
+    end
+
+
+    def yield_or_eval(&block)
+      return unless block
+      block.arity > 0 ? yield(self) : self.instance_eval(&block)
+    end
+
+    # Configure options and process basic authorization
+    #
+    def setup(options={})
+      options = Vertebrae.options.merge(options)
+      self.current_options = options
+      Configuration.keys.each do |key|
+        send("#{key}=", options[key])
+      end
+      process_basic_auth(options[:basic_auth])
+    end
+
+    # Extract login and password from basic_auth parameter
+    #
+    def process_basic_auth(auth)
+      case auth
+        when String
+          self.username, self.password = auth.split(':', 2)
+        when Hash
+          self.username = auth[:username]
+          self.password = auth[:password]
+      end
+    end
+
+    # Responds to attribute query or attribute clear
+    def method_missing(method, *args, &block) # :nodoc:
+      case method.to_s
+        when /^(.*)\?$/
+          return !!self.send($1.to_s)
+        when /^clear_(.*)$/
+          self.send("#{$1.to_s}=", nil)
+        else
+          super
+      end
+    end
+
+    # Acts as setter and getter for api requests arguments parsing.
+    #
+    # Returns Arguments instance.
+    #
+    def arguments(args=(not_set = true), options={}, &block)
+      if not_set
+        @arguments
+      else
+        @arguments = Arguments.new(self, options).parse(*args, &block)
+      end
+    end
+
+    # Scope for passing request required arguments.
+    #
+    def with(args)
+      case args
+        when Hash
+          set args
+        when /.*\/.*/i
+          user, repo = args.split('/')
+          set :user => user, :repo => repo
+        else
+          ::Kernel.raise ArgumentError, 'This api does not support passed in arguments'
+      end
+    end
+
+    # Set an option to a given value
+    def set(option, value=(not_set=true), ignore_setter=false, &block)
+      raise ArgumentError, 'value not set' if block and !not_set
+      return self if !not_set and value.nil?
+
+      if not_set
+        set_options option
+        return self
+      end
+
+      if respond_to?("#{option}=") and not ignore_setter
+        return __send__("#{option}=", value)
+      end
+
+      define_accessors option, value
+      self
+    end
+
+    private
+
+    def extract_id_from_response(resp)
+      extract_id_from_location(resp.response.headers["location"])
+    end
+
+    def extract_id_from_location(location)
+      location.scan(/\/(\d+)\/$/).first.first
+    end
+
+    # Set multiple options
+    #
+    def set_options(options)
+      unless options.respond_to?(:each)
+        raise ArgumentError, 'cannot iterate over value'
+      end
+      options.each { |key, value| set(key, value) }
+    end
+
+    def define_accessors(option, value)
+      setter = proc { |val|  set option, val, true }
+      getter = proc { value }
+
+      define_singleton_method("#{option}=", setter) if setter
+      define_singleton_method(option, getter) if getter
+    end
+
+    # Dynamically define a method for setting request option
+    #
+    def define_singleton_method(method_name, content=Proc.new)
+      (class << self; self; end).class_eval do
+        undef_method(method_name) if method_defined?(method_name)
+        if String === content
+          class_eval("def #{method_name}() #{content}; end")
+        else
+          define_method(method_name, &content)
+        end
+      end
+    end
+
+  end
+end

data/lib/authorization.rb

@@ -0,0 +1,17 @@
+module Vertebrae
+  module Authorization
+
+    # Check whether authentication credentials are present
+    def authenticated?
+      (username? && password?)
+    end
+
+    def basic_auth
+      "#{username}:#{password}"
+    end
+
+    def authentication
+      { :basic_auth => basic_auth }
+    end
+  end # Authorization
+end

data/lib/configuration.rb

@@ -0,0 +1,105 @@
+module Vertebrae
+  module Configuration
+    include Vertebrae::Constants
+
+
+    VALID_OPTIONS_KEYS = [
+        :adapter,
+        :prefix,
+        :ssl,
+        :mime_type,
+        :user_agent,
+        :host,
+        :username,
+        :password,
+        :connection_options,
+    ].freeze
+
+    # Other adapters are :typhoeus, :patron, :em_synchrony, :excon, :test
+    DEFAULT_ADAPTER = :net_http
+
+    # The default SSL configuration
+    DEFAULT_SSL = {}
+
+    # By default the <tt>Accept</tt> header will make a request for <tt>JSON</tt>
+    DEFAULT_MIME_TYPE = :json
+
+    # The value sent in the http header for 'User-Agent' if none is set
+    DEFAULT_USER_AGENT = "Vertebrae REST Gem".freeze
+
+    # by default do not set a host. this is specific to AK instance
+    DEFAULT_HOST = nil
+
+    # The api endpoint used to connect to AK if none is set
+    DEFAULT_PREFIX = '/'.freeze
+
+    # By default, don't set a user ame
+    DEFAULT_USERNAME = nil
+
+    # By default, don't set a user password
+    DEFAULT_PASSWORD = nil
+
+    # By default uses the Faraday connection options if none is set
+    DEFAULT_CONNECTION_OPTIONS = {}
+
+
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    # Convenience method to allow for global setting of configuration options
+    def configure
+      yield self
+    end
+
+    def self.extended(base)
+      base.reset!
+    end
+
+    class << self
+      def keys
+        VALID_OPTIONS_KEYS
+      end
+    end
+
+
+    def faraday_options(ops)
+      {
+          :headers => {
+              ACCEPT           => "application/json;q=0.1",
+              ACCEPT_CHARSET   => "utf-8",
+              USER_AGENT       => user_agent,
+              CONTENT_TYPE     => 'application/json'
+          },
+          :ssl => ops.fetch(:ssl) { ssl },
+          :url => ops.fetch(:endpoint) { self.endpoint(ops) }
+      }.merge(options)
+    end
+
+    def endpoint(ops)
+      h = ops[:host]   ? ops[:host]   : self.host
+      p = ops[:prefix] ? ops[:prefix] : self.prefix
+
+      "https://#{h}#{p}"
+    end
+
+    def options
+      options = {}
+      VALID_OPTIONS_KEYS.each { |k| options[k] = send(k) }
+      options
+    end
+
+    # Reset configuration options to their defaults
+    #
+    def reset!
+      self.adapter            = DEFAULT_ADAPTER
+      self.prefix             = DEFAULT_PREFIX
+      self.ssl                = DEFAULT_SSL
+      self.mime_type          = DEFAULT_MIME_TYPE
+      self.user_agent         = DEFAULT_USER_AGENT
+      self.host               = DEFAULT_HOST
+      self.username           = DEFAULT_USERNAME
+      self.password           = DEFAULT_PASSWORD
+      self.connection_options = DEFAULT_CONNECTION_OPTIONS
+      self
+    end
+  end # Configuration
+end

data/lib/connection.rb

@@ -0,0 +1,80 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'request/basic_auth'
+require 'response/raise_error'
+
+module Vertebrae
+  module Connection
+
+    extend self
+    include Vertebrae::Constants
+
+    ALLOWED_OPTIONS = [
+        :headers,
+        :url,
+        :params,
+        :request,
+        :ssl
+    ].freeze
+
+    def default_options(options={})
+      Vertebrae.faraday_options(options)
+    end
+
+    # Default middleware stack that uses default adapter as specified at
+    # configuration stage.
+    #
+    def default_middleware(options={})
+      Proc.new do |builder|
+        builder.use Faraday::Request::Multipart
+        builder.use Faraday::Request::UrlEncoded
+        builder.use Vertebrae::Request::BasicAuth, authentication if authenticated?
+
+        builder.use Faraday::Response::Logger if ENV['DEBUG']
+        unless options[:raw]
+          builder.use FaradayMiddleware::Mashify
+          builder.use FaradayMiddleware::ParseJson
+        end
+        builder.use Vertebrae::Response::RaiseError
+        builder.adapter adapter
+      end
+    end
+
+    @connection = nil
+
+    @stack = nil
+
+    def clear_cache
+      @connection = nil
+    end
+
+    def caching?
+      !@connection.nil?
+    end
+
+    # Exposes middleware builder to facilitate custom stacks and easy
+    # addition of new extensions such as cache adapter.
+    #
+    def stack(options={}, &block)
+      @stack ||= begin
+        if block_given?
+          Faraday::Builder.new(&block)
+        else
+          Faraday::Builder.new(&default_middleware(options))
+        end
+      end
+    end
+
+    # Returns a Fraday::Connection object
+    #
+    def connection(options={})
+      conn_options = default_options(options)
+      clear_cache unless options.empty?
+      Vertebrae.logger.debug "OPTIONS:#{conn_options.inspect}"
+
+      @connection ||= Faraday.new(conn_options.merge(:builder => stack(options)))
+    end
+
+
+  end
+end

data/lib/constants.rb

@@ -0,0 +1,31 @@
+module Vertebrae
+  module Constants
+    extend self
+
+    # Response headers
+    RATELIMIT_REMAINING = 'X-RateLimit-Remaining'.freeze
+
+    RATELIMIT_LIMIT = 'X-RateLimit-Limit'.freeze
+
+    CONTENT_TYPE = 'Content-Type'.freeze
+
+    CONTENT_LENGTH = 'content-length'.freeze
+
+    CACHE_CONTROL = 'cache-control'.freeze
+
+    ETAG = 'ETag'.freeze
+
+    SERVER = 'Server'.freeze
+
+    DATE = 'Date'.freeze
+
+    LOCATION = 'Location'.freeze
+
+    USER_AGENT = 'User-Agent'.freeze
+
+    ACCEPT = 'Accept'.freeze
+
+    ACCEPT_CHARSET = 'Accept-Charset'.freeze
+
+  end # Constants
+end

data/lib/core_ext/array.rb

@@ -0,0 +1,5 @@
+class Array
+  def extract_options!
+    last.is_a?(::Hash) ? pop : {}
+  end
+end

data/lib/railties.rb

@@ -0,0 +1,7 @@
+module Vertebrae
+  class Railties < ::Rails::Railtie
+    initializer 'Rails logger' do
+      Vertebrae.logger = Rails.logger
+    end
+  end
+end

data/lib/request/basic_auth.rb

@@ -0,0 +1,26 @@
+module Vertebrae
+  module Request
+    class BasicAuth < Faraday::Middleware
+      dependency 'base64'
+
+      def call(env)
+        env[:request_headers].merge!('Authorization' => "Basic #{@auth}\"")
+
+        @app.call env
+      end
+
+      def initialize(app, *args)
+        @app = app
+        credentials = ""
+        options = args.extract_options!
+        if options.has_key? :username
+          credentials = "#{options[:username]}:#{options[:password]}"
+        elsif options.has_key? :basic_auth
+          credentials = "#{options[:basic_auth]}"
+        end
+        @auth = Base64.encode64(credentials)
+        @auth.gsub!("\n", "")
+      end
+    end # BasicAuth
+  end
+end

data/lib/response/raise_error.rb

@@ -0,0 +1,19 @@
+module Vertebrae
+  module Response
+    class RaiseError < Faraday::Response::Middleware
+
+      def on_complete(response)
+        status_code = response[:status].to_i
+        if (500...600).include? status_code
+          raise Exception.new(error_message(response))
+        end
+      end
+
+      def error_message(response)
+        "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:status]} \n\n #{response[:body] if response[:body]}"
+      end
+    end
+
+    class NotFound < Exception ; end
+  end # Response::RaiseError
+end

data/lib/vertebrae.rb

@@ -0,0 +1,40 @@
+require 'constants'
+require 'configuration'
+require 'connection'
+require 'authorization'
+require 'api'
+
+
+require 'active_support/all'
+require 'vertebrae/railties' if defined? Rails
+
+
+module Vertebrae
+  extend Configuration
+
+
+  def logger
+    @@logger ||= Logger.new(STDOUT)
+  end
+
+  def logger=(logger)
+    @@logger = logger
+  end
+
+  # implement this in your api
+  #
+  def new(options = {}, &block)
+    raise "implement me!"
+  end
+
+  def method_missing(method, *args, &block)
+    return super unless new.respond_to?(method)
+    new.send(method, *args, &block)
+  end
+
+  def respond_to?(method, include_private = false)
+    new.respond_to?(method, include_private) || super(method, include_private)
+  end
+
+
+end

data/spec/api_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe Vertebrae::API do
+
+  subject { described_class.new(options) }
+
+  it { described_class.included_modules.should include Vertebrae::Authorization }
+  it { described_class.included_modules.should include Vertebrae::Connection }
+  it { described_class.included_modules.should include Vertebrae::Request }
+
+
+  describe '#extract_id_from_location' do
+    let(:options) { {} }
+    it "should extract the id" do
+      subject.send(:extract_id_from_location, "https://roboticdogs.actionkit.com/rest/v1/importpage/1093/").should == "1093"
+    end
+  end
+
+
+  context 'process_basic_auth' do
+    let(:options) { { :basic_auth => 'login:password' } }
+
+    its(:username) { should eq 'login' }
+
+    its(:password) { should eq 'password' }
+
+    its(:basic_auth) { should eq 'login:password' }
+  end
+
+  describe 'dummy' do
+    describe 'should delegate to the client class' do
+      specify{ Dummy.new.should respond_to(:api)  }
+      specify{ Dummy.should respond_to(:api) }
+    end
+  end
+end

data/spec/authorization_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Vertebrae::Authorization do
+  let(:options) { {} }
+
+  subject(:vb) { Dummy.new options }
+
+  after do
+    reset_authentication_for vb
+  end
+
+  context ".authenticated?" do
+    it { should respond_to(:authenticated?) }
+  end
+
+  context "authentication" do
+
+    context 'username & password' do
+      let(:options) { { :username => 'vb', :password => 'pass' } }
+
+      it "should return hash with username & password params" do
+        vb.basic_auth.should == "#{options[:username]}:#{options[:password]}"
+      end
+    end
+  end
+end # authentication

data/spec/configuration_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Vertebrae::Configuration do
+  let(:klass) {
+    ::Class.new do
+      extend Vertebrae::Configuration
+    end
+  }
+
+  subject { klass }
+
+  its(:adapter) { should == described_class::DEFAULT_ADAPTER }
+
+  its(:ssl) { should == described_class::DEFAULT_SSL }
+
+  its(:ssl) { should be_a Hash }
+
+  its(:user_agent) { should == described_class::DEFAULT_USER_AGENT }
+
+  its(:connection_options) { should be_a Hash }
+
+  its(:connection_options) { should be_empty }
+
+  its(:username) { should == described_class::DEFAULT_USERNAME }
+
+  its(:password) { should == described_class::DEFAULT_PASSWORD }
+
+  describe ".configure" do
+    it { should respond_to :configure }
+
+    described_class.keys.each do |key|
+      it "should set the #{key}" do
+        subject.configure do |config|
+          config.send("#{key}=", key)
+          subject.send(key).should == key
+        end
+      end
+    end
+  end
+
+end

data/spec/dummy/client.rb

@@ -0,0 +1,7 @@
+module Dummy
+  class Client < Vertebrae::API
+    def api(options={}, &block)
+      @api ||= Vertebrae::API.new(current_options.merge(options), &block)
+    end
+  end
+end

data/spec/dummy/dummy.rb

@@ -0,0 +1,8 @@
+module Dummy
+  extend Vertebrae
+  class << self
+    def new(options = {}, &block)
+      Dummy::Client.new(options, &block)
+    end
+  end
+end

data/spec/logger_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe 'logging' do
+  it "should have a logger" do
+    Dummy.respond_to?(:logger).should be_true
+  end
+
+  it "should be able to log debug methods" do
+    Dummy.logger.respond_to?(:debug).should be_true
+  end
+
+  it "should be settable" do
+    Dummy.respond_to?(:logger=).should be_true
+    log = double()
+    Dummy.logger = log
+    Dummy.logger.should == log
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'vertebrae'
+require 'dummy/dummy'
+require 'dummy/client'
+
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end
+
+
+def reset_authentication_for(object)
+  ['username', 'password'].each do |item|
+    Vertebrae.send("#{item}=", nil)
+    object.send("#{item}=", nil)
+  end
+end

data/vertebrae.gemspec

@@ -0,0 +1,85 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "vertebrae"
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Nathan Woodhull"]
+  s.date = "2013-07-12"
+  s.description = "A set of low level infrastructure and reusable code for building API clients"
+  s.email = "nathan@controlshiftlabs.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    ".ruby-gemset",
+    ".ruby-version",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/api.rb",
+    "lib/authorization.rb",
+    "lib/configuration.rb",
+    "lib/connection.rb",
+    "lib/constants.rb",
+    "lib/core_ext/array.rb",
+    "lib/railties.rb",
+    "lib/request/basic_auth.rb",
+    "lib/response/raise_error.rb",
+    "lib/vertebrae.rb",
+    "spec/api_spec.rb",
+    "spec/authorization_spec.rb",
+    "spec/configuration_spec.rb",
+    "spec/dummy/client.rb",
+    "spec/dummy/dummy.rb",
+    "spec/logger_spec.rb",
+    "spec/spec_helper.rb",
+    "vertebrae.gemspec"
+  ]
+  s.homepage = "http://github.com/controlshift/vertebrae"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.0.4"
+  s.summary = "API Client Infrastructure"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<faraday>, [">= 0"])
+      s.add_runtime_dependency(%q<faraday_middleware>, [">= 0"])
+      s.add_runtime_dependency(%q<hashie>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<faraday>, [">= 0"])
+      s.add_dependency(%q<faraday_middleware>, [">= 0"])
+      s.add_dependency(%q<hashie>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<faraday>, [">= 0"])
+    s.add_dependency(%q<faraday_middleware>, [">= 0"])
+    s.add_dependency(%q<hashie>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+  end
+end
+

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: vertebrae
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nathan Woodhull
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+description: A set of low level infrastructure and reusable code for building API
+  clients
+email: nathan@controlshiftlabs.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- .ruby-gemset
+- .ruby-version
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/api.rb
+- lib/authorization.rb
+- lib/configuration.rb
+- lib/connection.rb
+- lib/constants.rb
+- lib/core_ext/array.rb
+- lib/railties.rb
+- lib/request/basic_auth.rb
+- lib/response/raise_error.rb
+- lib/vertebrae.rb
+- spec/api_spec.rb
+- spec/authorization_spec.rb
+- spec/configuration_spec.rb
+- spec/dummy/client.rb
+- spec/dummy/dummy.rb
+- spec/logger_spec.rb
+- spec/spec_helper.rb
+- vertebrae.gemspec
+homepage: http://github.com/controlshift/vertebrae
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.4
+signing_key: 
+specification_version: 4
+summary: API Client Infrastructure
+test_files: []