relax 0.1.3 → 0.2.0

data/lib/relax/client.rb

@@ -0,0 +1,18 @@
+require 'faraday'
+
+module Relax
+  module Client
+    USER_AGENT = "Relax Ruby Gem Client #{Relax::VERSION}"
+
+    def config
+      @config ||= Config.new.configure do |config|
+        config.adapter = Faraday.default_adapter
+        config.user_agent = USER_AGENT
+      end
+    end
+
+    def configure(&block)
+      config.configure(&block)
+    end
+  end
+end

data/lib/relax/config.rb

@@ -0,0 +1,12 @@
+module Relax
+  class Config
+    attr :adapter, true
+    attr :base_uri, true
+    attr :user_agent, true
+
+    def configure
+      yield(self)
+      self
+    end
+  end
+end

data/lib/relax/delegator.rb

@@ -0,0 +1,25 @@
+module Relax
+  module Delegator
+    def self.[](client_method)
+      Module.new do
+        include ClassMethods
+
+        define_method(:client_instance) { send(client_method) }
+      end
+    end
+
+    module ClassMethods
+      def respond_to?(method, include_private=false)
+        super || client_instance.respond_to?(method, include_private)
+      end
+
+      def method_missing(method, *args, &block)
+        if client_instance.respond_to?(method)
+          client_instance.send(method, *args, &block)
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/relax/resource.rb

@@ -0,0 +1,32 @@
+require 'faraday'
+
+module Relax
+  module Resource
+    extend Forwardable
+
+    delegate Faraday::Connection::METHODS => :connection
+    private *Faraday::Connection::METHODS
+
+    def initialize(client, options={})
+      @client = client
+      @options = options
+    end
+
+    def connection(options={})
+      options[:url] ||= config.base_uri
+      options[:headers] ||= {}
+      options[:headers][:user_agent] ||= config.user_agent
+
+      Faraday.new(options) do |builder|
+        yield(builder) if block_given?
+        builder.adapter(config.adapter)
+      end
+    end
+    private :connection
+
+    def config
+      @client.config
+    end
+    private :config
+  end
+end

data/lib/relax/version.rb

@@ -0,0 +1,3 @@
+module Relax
+  VERSION = '0.2.0'
+end

data/relax.gemspec

@@ -0,0 +1,17 @@
+require './lib/relax/version'
+
+Gem::Specification.new do |gem|
+  gem.name = 'relax'
+  gem.version = Relax::VERSION
+  gem.summary = 'A flexible library for creating web service consumers.'
+  gem.homepage = 'http://github.com/tylerhunt/relax'
+  gem.author = 'Tyler Hunt'
+
+  gem.add_dependency 'faraday', '~> 0.8.0'
+  gem.add_development_dependency 'rspec', '~> 2.6'
+
+  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.require_paths = ['lib']
+end

data/spec/relax/client_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Relax::Client do
+  let(:client) { Class.new { include Relax::Client }.new }
+
+  subject { client }
+
+  context '#config' do
+    it 'returns an instance of Relax::Config' do
+      subject.config.should be_a(Relax::Config)
+    end
+
+    it 'memoizes the configuration' do
+      subject.config.should == subject.config
+    end
+
+    context 'defaults' do
+      subject { client.config }
+
+      its(:adapter) { should == Faraday.default_adapter }
+      its(:base_uri) { should be_nil }
+      its(:user_agent) { should == "Relax Ruby Gem Client #{Relax::VERSION}" }
+    end
+  end
+
+  context '#configure' do
+    it 'yields an instance of the configuration' do
+      expect {
+        subject.configure do |config|
+          config.base_uri = 'http://api.example.com/v2'
+        end
+      }.to change(subject.config, :base_uri).to('http://api.example.com/v2')
+    end
+
+    it 'returns the configuration' do
+      subject.configure { }.should == subject.config
+    end
+  end
+end

data/spec/relax/config_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Relax::Config do
+  context '#configure' do
+    it 'yields an instance of the configuration' do
+      expect {
+        subject.configure do |config|
+          config.base_uri = 'http://api.example.com/v2'
+        end
+      }.to change(subject, :base_uri).to('http://api.example.com/v2')
+    end
+
+    it 'returns the configuration' do
+      subject.configure { }.should == subject
+    end
+  end
+end

data/spec/relax/delegator_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Relax::Delegator do
+  let(:client) { Class.new { include Relax::Client } }
+
+  subject do
+    Class.new do
+      extend Relax::Delegator[:client]
+
+      class << self
+        attr :client, true
+      end
+    end
+  end
+
+  before { subject.client = client.new }
+
+  context '.[]' do
+    it 'accepts a client method name and returns a module' do
+      described_class[:client].should be_a(Module)
+    end
+  end
+
+  context 'delegation' do
+    Relax::Client.instance_methods.each do |method|
+      it "delegates .#{method} to the client" do
+        subject.client.should_receive(method)
+        subject.send(method)
+      end
+    end
+  end
+end

data/spec/relax/resource_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+describe Relax::Resource do
+  let(:client) do
+    Class.new do
+      include Relax::Client
+
+      def initialize
+        config.base_uri = 'http://api.example.com/v2'
+      end
+    end.new
+  end
+
+  let(:resource_class) { Class.new { include Relax::Resource } }
+
+  subject { resource_class.new(client) }
+
+  context '.new' do
+    it 'accepts an options hash' do
+      resource_class.new(client, key: :value)
+    end
+  end
+
+  context '#connection' do
+    let(:connection) { subject.send(:connection) }
+
+    it 'returns an instance of Faraday::Connection' do
+      connection.should be_a(Faraday::Connection)
+    end
+
+    it 'uses the configured base URI as the URL' do
+      connection.url_prefix.should == URI.parse(client.config.base_uri)
+    end
+
+    it 'accepts an options hash to be passed to Faraday::Connection' do
+      headers = { user_agent: "#{described_class} Test" }
+      connection = subject.send(:connection, headers: headers)
+      connection.headers['User-Agent'].should == headers[:user_agent]
+    end
+
+    it 'yields a builder to allow the middleware to be customized' do
+      subject.send(:connection) do |builder|
+        builder.use(Faraday::Response::Logger)
+      end.builder.handlers.should include(Faraday::Response::Logger)
+    end
+  end
+
+  context 'connection delegation' do
+    let(:connection) { stub(:connection) }
+
+    before { subject.stub(:connection).and_return(connection) }
+
+    Faraday::Connection::METHODS.each do |method|
+      it "delegates ##{method} to #connection" do
+        connection.should_receive(method)
+        subject.send(method)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,15 +1,11 @@
-$:.push File.join(File.dirname(__FILE__), '..', 'lib')
+require 'relax'
 
-require 'rubygems'
+Dir[File.expand_path('../support/**/*.rb', __FILE__)].each do |file|
+  require(file)
+end
 
-gem 'rspec', '~> 1.2.2'
-require 'spec'
-
-gem 'fakeweb', '~> 1.2.2'
-require 'fakeweb'
-
-require File.join(File.dirname(__FILE__), '..', 'lib', 'relax')
-require File.join(File.dirname(__FILE__), 'services', 'flickr')
-require File.join(File.dirname(__FILE__), 'services', 'custom_parser_service')
-require File.join(File.dirname(__FILE__), 'services', 'parameter_alias_service')
-require File.join(File.dirname(__FILE__), 'services', 'blank_values_service')
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -1,124 +1,103 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: relax
-version: !ruby/object:Gem::Version 
-  version: 0.1.3
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Tyler Hunt
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2009-08-31 00:00:00 -04:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rest-client
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
+date: 2012-05-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: 0.9.2
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: relief
+      - !ruby/object:Gem::Version
+        version: 0.8.0
   type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: 0.0.4
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: jeweler
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: 0.11.0
-    version: 
-- !ruby/object:Gem::Dependency 
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
   name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.2.2
-    version: 
+      - !ruby/object:Gem::Version
+        version: '2.6'
 description: 
-email: tyler@tylerhunt.com
+email: 
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- LICENSE
-- README.rdoc
-files: 
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- CHANGELOG.md
+- Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
-- VERSION.yml
+- examples/delicious.rb
+- examples/flickr.rb
+- examples/vimeo.rb
 - lib/relax.rb
-- lib/relax/action.rb
-- lib/relax/context.rb
-- lib/relax/contextable.rb
-- lib/relax/endpoint.rb
-- lib/relax/instance.rb
-- lib/relax/parameter.rb
-- lib/relax/performer.rb
-- lib/relax/service.rb
-- spec/relax/context_spec.rb
-- spec/relax/endpoint_spec.rb
-- spec/relax/integration_spec.rb
-- spec/relax/service_spec.rb
-- spec/services/blank_values_service.rb
-- spec/services/custom_parser_service.rb
-- spec/services/flickr.rb
-- spec/services/parameter_alias_service.rb
+- lib/relax/client.rb
+- lib/relax/config.rb
+- lib/relax/delegator.rb
+- lib/relax/resource.rb
+- lib/relax/version.rb
+- relax.gemspec
+- spec/relax/client_spec.rb
+- spec/relax/config_spec.rb
+- spec/relax/delegator_spec.rb
+- spec/relax/resource_spec.rb
 - spec/spec_helper.rb
-has_rdoc: true
 homepage: http://github.com/tylerhunt/relax
 licenses: []
-
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: relax
-rubygems_version: 1.3.5
+rubyforge_project: 
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A flexible library for creating web service consumers.
-test_files: 
-- spec/relax/context_spec.rb
-- spec/relax/endpoint_spec.rb
-- spec/relax/integration_spec.rb
-- spec/relax/service_spec.rb
-- spec/services/blank_values_service.rb
-- spec/services/custom_parser_service.rb
-- spec/services/flickr.rb
-- spec/services/parameter_alias_service.rb
+test_files:
+- spec/relax/client_spec.rb
+- spec/relax/config_spec.rb
+- spec/relax/delegator_spec.rb
+- spec/relax/resource_spec.rb
 - spec/spec_helper.rb