zipfinder 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in zipfinder.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1 @@
+== ZipFinder.me

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/zipfinder.rb

@@ -0,0 +1,31 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+require 'ostruct'
+require "forwardable"
+require 'json'
+require 'restclient'
+require 'logger'
+require "zipfinder/version"
+require "zipfinder/loggable"
+require "zipfinder/response_handler"
+require "zipfinder/rest_client_adapter"
+require "zipfinder/exceptions"
+require "zipfinder/client"
+
+module ZipFinder
+  BASE_URL = 'http://zipfinder.me/zipcode'
+  class << self
+    attr_accessor :logger
+  end
+
+  def self.configure
+    yield self
+  end
+end
+
+ZipFinder.configure do |config|
+  config.logger = Logger.new(STDOUT)
+  config.logger.level = Logger::ERROR
+end
+
+

data/lib/zipfinder/client.rb

@@ -0,0 +1,27 @@
+module ZipFinder
+  class Client
+    extend Forwardable
+    attr_accessor :http_adapter, :response_handler
+
+    def self.get(zipcode)
+      ZipFinder::Client.new.get(zipcode)
+    end
+
+    def initialize(http_adapter = RestClientAdapter, response_handler = ResponseHandler.new)
+      @http_adapter = http_adapter
+      @response_handler = response_handler
+    end
+
+    def get(zipcode)
+      url = build_url(zipcode)
+      response = http_adapter.http_get(url)
+      response_handler.process(response)
+    end
+
+    private
+
+    def build_url(zipcode)
+      "#{ZipFinder::BASE_URL}/#{zipcode}"
+    end
+  end
+end

data/lib/zipfinder/exceptions.rb

@@ -0,0 +1,7 @@
+module ZipFinder
+  class RequestFailedError < StandardError
+  end
+
+  class ServiceNotAvailableError < StandardError
+  end
+end

data/lib/zipfinder/loggable.rb

@@ -0,0 +1,9 @@
+module ZipFinder
+  module Loggable
+    private
+
+    def log(message, logger = ZipFinder.logger)
+      logger << "#{message}\n" if logger
+    end
+  end
+end

data/lib/zipfinder/response_handler.rb

@@ -0,0 +1,19 @@
+module ZipFinder
+  class ResponseHandler
+    include Loggable
+    attr_accessor :json_adapter
+
+    def initialize(json_adapter = JSON)
+      @json_adapter = json_adapter
+    end
+
+    def process(response)
+      if response.status == 200
+        json_adapter.parse response.body
+      else
+        log "ZipFinder::RequestFailedError : #{response.message}"
+        raise RequestFailedError, response.message
+      end
+    end
+  end
+end

data/lib/zipfinder/rest_client_adapter.rb

@@ -0,0 +1,11 @@
+module ZipFinder
+  class RestClientAdapter
+    def self.http_get url, headers = {}
+      response = RestClient.get(url, headers)
+      OpenStruct.new(:status => response.code, :body => response.body)
+
+    rescue RestClient::Exception, Errno::EINVAL, Errno::ECONNRESET, Errno::ECONNREFUSED, EOFError => e
+      raise ServiceNotAvailableError, e.message
+    end
+  end
+end

data/lib/zipfinder/version.rb

@@ -0,0 +1,3 @@
+module Zipfinder
+  VERSION = "0.0.1"
+end

data/spec/client_spec.rb

@@ -0,0 +1,29 @@
+require File.dirname(__FILE__) + "/spec_helper"
+
+describe ZipFinder::Client do
+  let(:zipcode) { "37713172" }
+  let(:url) { "#{ZipFinder::BASE_URL}/#{zipcode}" }
+
+  it "calls the get method in a instance passing the zipcode" do
+    ZipFinder::Client.any_instance.should_receive(:get).with(zipcode)
+    ZipFinder::Client.get(zipcode)
+  end
+
+  describe ".get" do
+    it "executes the http call" do
+      http_adapter = mock
+      response_handler = stub(:process => nil)
+      subject = ZipFinder::Client.new(http_adapter, response_handler)
+      http_adapter.should_receive(:http_get).with(url)
+      subject.get(zipcode)
+    end
+
+    it "handles the request response" do
+      http_adapter = stub(:http_get => :response)
+      response_handler = mock
+      subject = ZipFinder::Client.new(http_adapter, response_handler)
+      response_handler.should_receive(:process).with(:response).and_return(:result)
+      subject.get(zipcode).should == :result
+    end
+  end
+end

data/spec/response_handler_spec.rb

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + "/spec_helper"
+
+describe ZipFinder::ResponseHandler do
+  let(:json_adapter) { mock('json_adapter') }
+  subject { ZipFinder::ResponseHandler.new(json_adapter) }
+  let(:valid_response) {OpenStruct.new(:status => 200, :body => :body)}
+  let(:invalid_response) {OpenStruct.new(:status => 404, :body => :body)}
+
+  describe "#process" do
+    it "parses the body response" do
+      json_adapter.should_receive(:parse).with valid_response.body
+      subject.process(valid_response)
+    end
+
+    it "raises a RequestFailedError" do
+      expect {
+        subject.process(invalid_response)
+      }.to raise_error ZipFinder::RequestFailedError
+    end
+  end
+end

data/spec/rest_client_adapter_spec.rb

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + "/spec_helper"
+
+describe ZipFinder::RestClientAdapter do
+  subject { ZipFinder::RestClientAdapter }
+  let(:response) { OpenStruct.new(:code => 200, :body => :body) }
+
+  describe "#http_get" do
+    it "delegates to RestClient and return a custom Struct" do
+      expected = OpenStruct.new(:status => response.code, :body => response.body)
+      RestClient.should_receive(:get).with(:url, {}).and_return(response)
+      subject.http_get(:url, {}).should == expected
+    end
+
+    it "raises a ServiceNotAvailableError" do
+      RestClient.should_receive(:get).and_raise RestClient::Exception
+      expect {
+        subject.http_get(:url, {})
+      }.to raise_error(ZipFinder::ServiceNotAvailableError)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+$:.unshift File.dirname(__FILE__) + "../lib"
+require "rubygems"
+require "zipfinder"
+require "rspec"
+
+ZipFinder.configure do |config|
+  config.logger = nil
+end

data/zipfinder.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "zipfinder/version"
+
+Gem::Specification.new do |s|
+  s.name        = "zipfinder"
+  s.version     = Zipfinder::VERSION
+  s.authors     = ["Rinaldi Fonseca"]
+  s.email       = ["rinaldifonseca@gmail.com"]
+  s.homepage    = "http://zipfinder.me"
+  s.summary     = %q{A wrapper for ZipFinder.me Service}
+  s.description = %q{A wrapper for ZipFinder.me Service}
+
+  s.rubyforge_project = "zipfinder"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+  s.add_dependency "rest-client"
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: zipfinder
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Rinaldi Fonseca
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-20 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70115444827780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70115444827780
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: &70115444827240 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70115444827240
+description: A wrapper for ZipFinder.me Service
+email:
+- rinaldifonseca@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/zipfinder.rb
+- lib/zipfinder/client.rb
+- lib/zipfinder/exceptions.rb
+- lib/zipfinder/loggable.rb
+- lib/zipfinder/response_handler.rb
+- lib/zipfinder/rest_client_adapter.rb
+- lib/zipfinder/version.rb
+- spec/client_spec.rb
+- spec/response_handler_spec.rb
+- spec/rest_client_adapter_spec.rb
+- spec/spec_helper.rb
+- zipfinder.gemspec
+homepage: http://zipfinder.me
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+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: zipfinder
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A wrapper for ZipFinder.me Service
+test_files:
+- spec/client_spec.rb
+- spec/response_handler_spec.rb
+- spec/rest_client_adapter_spec.rb
+- spec/spec_helper.rb