module Nimbu::Connection

Constants

ALLOWED_OPTIONS

Public Instance Methods

caching?() click to toggle source
# File lib/nimbu-api/connection.rb, line 57
def caching?
  !@connection.nil?
end
clear_cache() click to toggle source
# File lib/nimbu-api/connection.rb, line 53
def clear_cache
  @connection = nil
end
connection(options={}) click to toggle source

Returns a Fraday::Connection object

# File lib/nimbu-api/connection.rb, line 76
def connection(options={})
  conn_options = default_options(options).keep_if {|k,_| ALLOWED_OPTIONS.include? k }
  clear_cache unless options.empty?
  puts "OPTIONS:#{conn_options.inspect}" if ENV['DEBUG']

  Faraday.new(conn_options.merge(:builder => stack(options)))
end
default_middleware(options={}) click to toggle source

Default middleware stack that uses default adapter as specified at configuration stage.

# File lib/nimbu-api/connection.rb, line 26
def default_middleware(options={})
  Proc.new do |builder|
    unless options[:with_attachments]
      builder.use Nimbu::Request::Json
    end
    builder.use Faraday::Request::Multipart
    builder.use Faraday::Request::UrlEncoded
    builder.use Nimbu::Request::OAuth2, oauth_token if oauth_token?
    builder.use Nimbu::Request::BasicAuth, authentication if basic_authed?
    builder.use Nimbu::Request::UserAgent
    builder.use Nimbu::Request::SiteHeader, subdomain
    builder.use Nimbu::Request::ContentLocale, content_locale

    builder.use Faraday::Response::Logger if ENV['DEBUG']
    builder.use Nimbu::Response::RaiseError
    unless options[:raw]
      builder.use Nimbu::Response::Mashify
      builder.use Nimbu::Response::Json
    end
    builder.adapter adapter
  end
end
default_options(options={}) click to toggle source
# File lib/nimbu-api/connection.rb, line 16
def default_options(options={})
  {
    :ssl => options.fetch(:ssl) { ssl },
    :url => options.fetch(:endpoint) { Nimbu.endpoint }
  }.merge(options)
end
stack(options={}, &block) click to toggle source

Exposes middleware builder to facilitate custom stacks and easy addition of new extensions such as cache adapter.

# File lib/nimbu-api/connection.rb, line 64
def stack(options={}, &block)
  @stack ||= begin
    if block_given?
      Faraday::RackBuilder.new(&block)
    else
      Faraday::RackBuilder.new(&default_middleware(options))
    end
  end
end