aitch 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color --order random --format documentation

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+script: "bundle exec rspec"
+
+rvm:
+  - 2.0.0
+  - 1.9.3
+
+gemfile:
+  - Gemfile
+
+notifications:
+  email:
+    - fnando.vieira@gmail.com

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Nando Vieira
+
+MIT License
+
+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.md

@@ -0,0 +1,141 @@
+# Aitch
+
+[![Build Status](https://travis-ci.org/fnando/aitch.png)](https://travis-ci.org/fnando/aitch)
+
+[![CodeClimate](https://codeclimate.com/github/fnando/aitch.png)](https://codeclimate.com/github/fnando/aitch/)
+
+[![RubyGems](https://badge.fury.io/rb/aitch.png)](https://rubygems.org/gems/aitch)
+
+A simple HTTP client.
+
+Features:
+
+* Supports Gzip|Deflate response
+* Automatically parses JSON and XML responses
+* Automatically follows redirect
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'aitch'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install aitch
+
+## Usage
+
+### Configuration
+
+These are the default settings:
+
+```ruby
+Aitch.configure do |config|
+  # Set request timeout.
+  config.timeout = 5
+
+  # Set default headers.
+  config.default_headers = {}
+
+  # Set follow redirect.
+  config.follow_redirect = true
+
+  # Set redirection limit.
+  config.redirect_limit = 5
+
+  # Set the user agent.
+  config.user_agent = "Aitch/0.0.1 (http://rubygems.org/gems/aitch)"
+
+  # Set the logger.
+  config.logger = nil
+
+  # Set the JSON parser.
+  config.json_parser = JSON
+
+  # Set the XML parser.
+  config.xml_parser = Aitch::XMLParser
+end
+```
+
+### Requests
+
+Performing requests:
+
+```ruby
+response = Aitch.get("http://example.org", params, headers)
+           Aitch.post("http://example.org", params, headers)
+           Aitch.put("http://example.org", params, headers)
+           Aitch.patch("http://example.org", params, headers)
+           Aitch.delete("http://example.org", params, headers)
+           Aitch.options("http://example.org", params, headers)
+           Aitch.trace("http://example.org", params, headers)
+           Aitch.head("http://example.org", params, headers)
+```
+
+### Response
+
+The response object:
+
+```ruby
+response.html?
+response.xml?
+response.json?
+response.content_type
+response.headers
+response.location
+response.success?         # status >= 200 && status <= 399
+response.redirect?        # status 3xx
+response.error?           # status 4xx or 5xx
+response.error            # response error
+response.body             # returned body
+response.data             # JSON or XML payload
+```
+
+### Following redirects
+
+The configuration:
+
+```ruby
+Aitch.configure do |config|
+  config.follow_redirect = true
+  config.redirect_limit = 10
+end
+```
+
+The request:
+
+```ruby
+Aitch.get("http://example.org")
+```
+
+If the redirect limit is exceeded, then the `Aitch::TooManyRedirectsError` exception
+is raised.
+
+### Basic auth
+
+Setting basic auth credentials:
+
+```ruby
+Aitch.get("http://restrict.example.org/", {}, {}, user: "john", password: "test")
+```
+
+### Setting custom headers
+
+```ruby
+Aitch.get("http://example.org", {}, {"User-Agent" => "MyBot/1.0.0"})
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

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

data/aitch.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'aitch/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "aitch"
+  spec.version       = Aitch::VERSION
+  spec.authors       = ["Nando Vieira"]
+  spec.email         = ["fnando.vieira@gmail.com"]
+  spec.description   = "A simple HTTP client"
+  spec.summary       = spec.description
+  spec.homepage      = "http://rubygems.org/gems/aitch"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "pry-meta"
+  spec.add_development_dependency "test_notifier"
+  spec.add_development_dependency "fakeweb"
+  spec.add_development_dependency "nokogiri"
+end

data/lib/aitch.rb

@@ -0,0 +1,47 @@
+require "net/https"
+require "forwardable"
+require "json"
+require "zlib"
+
+require "aitch/configuration"
+require "aitch/errors"
+require "aitch/request"
+require "aitch/redirect"
+require "aitch/response"
+require "aitch/response/errors"
+require "aitch/response/body"
+require "aitch/xml_parser"
+require "aitch/version"
+
+module Aitch
+  extend self
+
+  def execute(method, url, args = {}, headers = {}, options = {})
+    Request.new(method, url, args, headers, options).perform
+  end
+
+  def execute!(*args)
+    response = execute(*args)
+    raise response.error if response.error?
+    response
+  end
+
+  %w[
+    get
+    post
+    put
+    patch
+    delete
+    options
+    trace
+    head
+  ].each do |method_name|
+    define_method(method_name) do |url, args = {}, headers = {}, options = {}|
+      execute(method_name, url, args, headers, options)
+    end
+
+    define_method("#{method_name}!") do |url, args = {}, headers = {}, options = {}|
+      execute!(method_name, url, args, headers, options)
+    end
+  end
+end

data/lib/aitch/configuration.rb

@@ -0,0 +1,48 @@
+module Aitch
+  class Configuration
+    # Set proxy.
+    attr_accessor :proxy
+
+    # Set request timeout.
+    attr_accessor :timeout
+
+    # Set default headers.
+    attr_accessor :default_headers
+
+    # Set follow redirect.
+    attr_accessor :follow_redirect
+
+    # Set redirection limit.
+    attr_accessor :redirect_limit
+
+    # Set the user agent.
+    attr_accessor :user_agent
+
+    # Set the logger.
+    attr_accessor :logger
+
+    # Set the JSON parser.
+    attr_accessor :json_parser
+
+    # Set the XML parser.
+    attr_accessor :xml_parser
+
+    def initialize
+      @timeout = 10
+      @redirect_limit = 5
+      @follow_redirect = true
+      @user_agent = "Aitch/#{Aitch::VERSION} (http://rubygems.org/gems/aitch)"
+      @default_headers = {}
+      @json_parser = JSON
+      @xml_parser = XMLParser
+    end
+  end
+
+  def self.configure(&block)
+    yield configuration
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+end

data/lib/aitch/errors.rb

@@ -0,0 +1,41 @@
+module Aitch
+  InvalidURIError        = Class.new(StandardError)
+  InvalidHTTPMethodError = Class.new(StandardError)
+  RequestTimeoutError    = Class.new(StandardError)
+  TooManyRedirectsError  = Class.new(StandardError)
+
+  ResponseError                      = Class.new(StandardError)
+  BadRequestError                    = Class.new(ResponseError)
+  UnauthorizedError                  = Class.new(ResponseError)
+  PaymentRequiredError               = Class.new(ResponseError)
+  ForbiddenError                     = Class.new(ResponseError)
+  NotFoundError                      = Class.new(ResponseError)
+  MethodNotAllowedError              = Class.new(ResponseError)
+  NotAcceptableError                 = Class.new(ResponseError)
+  ProxyAuthenticationRequiredError   = Class.new(ResponseError)
+  RequestTimeOutError                = Class.new(ResponseError)
+  ConflictError                      = Class.new(ResponseError)
+  GoneError                          = Class.new(ResponseError)
+  LengthRequiredError                = Class.new(ResponseError)
+  PreconditionFailedError            = Class.new(ResponseError)
+  RequestEntityTooLargeError         = Class.new(ResponseError)
+  RequestURITooLongError             = Class.new(ResponseError)
+  UnsupportedMediaTypeError          = Class.new(ResponseError)
+  RequestedRangeNotSatisfiableError  = Class.new(ResponseError)
+  ExpectationFailedError             = Class.new(ResponseError)
+  UnprocessableEntityError           = Class.new(ResponseError)
+  LockedError                        = Class.new(ResponseError)
+  FailedDependencyError              = Class.new(ResponseError)
+  UpgradeRequiredError               = Class.new(ResponseError)
+  PreconditionRequiredError          = Class.new(ResponseError)
+  TooManyRequestsError               = Class.new(ResponseError)
+  RequestHeaderFieldsTooLargeError   = Class.new(ResponseError)
+  InternalServerErrorError           = Class.new(ResponseError)
+  NotImplementedError                = Class.new(ResponseError)
+  BadGatewayError                    = Class.new(ResponseError)
+  ServiceUnavailableError            = Class.new(ResponseError)
+  GatewayTimeOutError                = Class.new(ResponseError)
+  VersionNotSupportedError           = Class.new(ResponseError)
+  InsufficientStorageError           = Class.new(ResponseError)
+  NetworkAuthenticationRequiredError = Class.new(ResponseError)
+end

data/lib/aitch/redirect.rb

@@ -0,0 +1,20 @@
+module Aitch
+  class Redirect
+    def initialize
+      @tries = 1
+      @max_tries = Aitch.configuration.redirect_limit
+    end
+
+    def followed!
+      @tries += 1
+    end
+
+    def follow?(response)
+      enabled? && response.redirect? && @tries < @max_tries
+    end
+
+    def enabled?
+      Aitch.configuration.follow_redirect
+    end
+  end
+end

data/lib/aitch/request.rb

@@ -0,0 +1,105 @@
+module Aitch
+  class Request
+    def initialize(request_method, url, args = {}, headers = {}, options = {})
+      @request_method = request_method
+      @url = url
+      @args = args
+      @headers = headers
+      @options = options
+    end
+
+    def perform
+      response = Response.new(client.request(request))
+      redirect = Redirect.new
+
+      while redirect.follow?(response)
+        redirect.followed!
+        response = Aitch.get(response.location)
+      end
+
+      raise TooManyRedirectsError if redirect.enabled? && response.redirect?
+
+      response
+    rescue timeout_exception
+      raise RequestTimeoutError
+    end
+
+    def request
+      @request ||= http_method_class.new(File.join("/", uri.path)).tap do |request|
+        set_body(request)
+        set_user_agent(request)
+        set_gzip(request)
+        set_headers(request)
+        set_credentials(request)
+      end
+    end
+
+    def client
+      @client ||= Net::HTTP.new(uri.host, uri.port).tap do |client|
+        set_https(client)
+        set_timeout(client)
+        set_logger(client)
+      end
+    end
+
+    def uri
+      @uri ||= URI.parse(@url)
+    rescue URI::InvalidURIError
+      raise InvalidURIError
+    end
+
+    def http_method_class
+      Net::HTTP.const_get(@request_method.to_s.capitalize)
+    rescue NameError
+      raise InvalidHTTPMethodError, "unexpected HTTP verb: #{@request_method.inspect}"
+    end
+
+    private
+    def set_body(request)
+      if @args.respond_to?(:to_h)
+        request.form_data = @args.to_h
+      elsif @args.kind_of?(Hash)
+        request.form_data = @args
+      else
+        request.body = @args.to_s
+      end
+    end
+
+    def set_headers(request)
+      all_headers = Aitch.configuration.default_headers.merge(@headers)
+      all_headers.each do |name, value|
+        request[name.to_s] = value.to_s
+      end
+    end
+
+    def set_credentials(request)
+      request.basic_auth(@options[:user], @options[:password]) if @options[:user]
+    end
+
+    def set_https(client)
+      client.use_ssl = uri.scheme == "https"
+      client.verify_mode = OpenSSL::SSL::VERIFY_PEER
+    end
+
+    def set_timeout(client)
+      client.read_timeout = Aitch.configuration.timeout
+    end
+
+    def set_logger(client)
+      logger = Aitch.configuration.logger
+      client.set_debug_output(logger) if logger
+    end
+
+    def set_user_agent(request)
+      request["User-Agent"] = Aitch.configuration.user_agent
+    end
+
+    def set_gzip(request)
+      request["Accept-Encoding"] = "gzip,deflate"
+    end
+
+    def timeout_exception
+      defined?(Net::ReadTimeout) ? Net::ReadTimeout : Timeout::Error
+    end
+  end
+end

data/lib/aitch/response.rb

@@ -0,0 +1,74 @@
+module Aitch
+  class Response
+    extend Forwardable
+
+    def_delegators :@http_response, :content_type
+
+    def initialize(http_response)
+      @http_response = http_response
+    end
+
+    def code
+      @http_response.code.to_i
+    end
+
+    def body
+      @body ||= Body.new(@http_response).to_s
+    end
+
+    def success?
+      code >= 200 && code <= 399
+    end
+
+    def redirect?
+      code >= 300 && code <= 399
+    end
+
+    def error?
+      code >= 400 && code <= 599
+    end
+
+    def error
+      error? && ERRORS.fetch(code)
+    end
+
+    def json?
+      content_type =~ /json/
+    end
+
+    def xml?
+      content_type =~ /xml/
+    end
+
+    def html?
+      content_type =~ /html/
+    end
+
+    def data
+      if json?
+        Aitch.configuration.json_parser.load(body)
+      elsif xml?
+        Aitch.configuration.xml_parser.load(body)
+      else
+        body
+      end
+    end
+
+    def headers
+      @headers ||= {}.tap do |headers|
+        @http_response.each_header do |name, value|
+          headers[name.gsub(/^x-/, "")] = value
+        end
+      end
+    end
+
+    def method_missing(name, *args, &block)
+      return headers[name.to_s] if headers.key?(name.to_s)
+      super
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      headers.key?(name.to_s)
+    end
+  end
+end

data/lib/aitch/response/body.rb

@@ -0,0 +1,29 @@
+module Aitch
+  class Response
+    class Body
+      def initialize(response)
+        @response = response
+        @body = response.body
+        @encoding = @response["content-encoding"]
+      end
+
+      def gzip?
+        @encoding == "gzip"
+      end
+
+      def deflate?
+        @encoding == "deflate"
+      end
+
+      def to_s
+        if gzip?
+          Zlib::GzipReader.new(StringIO.new(@body)).read
+        elsif deflate?
+          Zlib::Inflate.inflate(@body)
+        else
+          @body
+        end
+      end
+    end
+  end
+end

data/lib/aitch/response/errors.rb

@@ -0,0 +1,39 @@
+module Aitch
+  class Response
+    ERRORS = {
+      400 => BadRequestError,
+      401 => UnauthorizedError,
+      402 => PaymentRequiredError,
+      403 => ForbiddenError,
+      404 => NotFoundError,
+      405 => MethodNotAllowedError,
+      406 => NotAcceptableError,
+      407 => ProxyAuthenticationRequiredError,
+      408 => RequestTimeOutError,
+      409 => ConflictError,
+      410 => GoneError,
+      411 => LengthRequiredError,
+      412 => PreconditionFailedError,
+      413 => RequestEntityTooLargeError,
+      414 => RequestURITooLongError,
+      415 => UnsupportedMediaTypeError,
+      416 => RequestedRangeNotSatisfiableError,
+      417 => ExpectationFailedError,
+      422 => UnprocessableEntityError,
+      423 => LockedError,
+      424 => FailedDependencyError,
+      426 => UpgradeRequiredError,
+      428 => PreconditionRequiredError,
+      429 => TooManyRequestsError,
+      431 => RequestHeaderFieldsTooLargeError,
+      500 => InternalServerErrorError,
+      501 => NotImplementedError,
+      502 => BadGatewayError,
+      503 => ServiceUnavailableError,
+      504 => GatewayTimeOutError,
+      505 => VersionNotSupportedError,
+      507 => InsufficientStorageError,
+      511 => NetworkAuthenticationRequiredError
+    }
+  end
+end

data/lib/aitch/version.rb

@@ -0,0 +1,3 @@
+module Aitch
+  VERSION = "0.1.0"
+end

data/lib/aitch/xml_parser.rb

@@ -0,0 +1,7 @@
+module Aitch
+  module XMLParser
+    def self.load(source)
+      Nokogiri::XML(source.to_s)
+    end
+  end
+end

data/spec/aitch/aitch_spec.rb

@@ -0,0 +1,62 @@
+require "spec_helper"
+
+describe Aitch do
+  context "request methods" do
+    it { should respond_to(:get) }
+    it { should respond_to(:get!) }
+    it { should respond_to(:post) }
+    it { should respond_to(:post!) }
+    it { should respond_to(:put) }
+    it { should respond_to(:put!) }
+    it { should respond_to(:patch) }
+    it { should respond_to(:patch!) }
+    it { should respond_to(:delete) }
+    it { should respond_to(:delete!) }
+    it { should respond_to(:head) }
+    it { should respond_to(:head!) }
+    it { should respond_to(:options) }
+    it { should respond_to(:options!) }
+    it { should respond_to(:trace) }
+    it { should respond_to(:trace!) }
+    it { should respond_to(:execute) }
+    it { should respond_to(:execute!) }
+  end
+
+  describe "#execute" do
+    let(:request) { mock.as_null_object }
+
+    it "delegates to Request" do
+      Aitch::Request
+        .should_receive(:new)
+        .with("METHOD", "URL", "ARGS", "HEADERS", "OPTIONS")
+        .and_return(request)
+
+      Aitch.execute("METHOD", "URL", "ARGS", "HEADERS", "OPTIONS")
+    end
+
+    it "performs request" do
+      Aitch::Request.stub new: request
+      request.should_receive(:perform)
+
+      Aitch.execute("METHOD", "URL")
+    end
+  end
+
+  describe "#execute!" do
+    it "returns response when successful" do
+      response = stub(error?: false)
+      Aitch::Request.any_instance.stub perform: response
+
+      expect(Aitch.execute!("METHOD", "URL")).to eql(response)
+    end
+
+    it "raises when has errors" do
+      response = stub(error?: true, error: "ERROR")
+      Aitch::Request.any_instance.stub perform: response
+
+      expect {
+        Aitch.execute!("METHOD", "URL")
+      }.to raise_error("ERROR")
+    end
+  end
+end

data/spec/aitch/configuration_spec.rb

@@ -0,0 +1,33 @@
+require "spec_helper"
+
+describe Aitch::Configuration do
+  it "sets default timeout" do
+    expect(Aitch::Configuration.new.timeout).to eql(10)
+  end
+
+  it "sets default user agent" do
+    user_agent = "Aitch/#{Aitch::VERSION} (http://rubygems.org/gems/aitch)"
+    expect(Aitch::Configuration.new.user_agent).to eql(user_agent)
+  end
+
+  it "sets default maximum redirections" do
+    expect(Aitch::Configuration.new.redirect_limit).to eql(5)
+  end
+
+  it "sets default headers" do
+    expect(Aitch::Configuration.new.default_headers).to eql({})
+  end
+
+  it "sets default XML parser" do
+    expect(Aitch::Configuration.new.xml_parser).to eql(Aitch::XMLParser)
+  end
+
+  it "configures aitch" do
+    Aitch.configure do |config|
+      config.timeout = 15
+    end
+
+    expect(Aitch.configuration.timeout).to eql(15)
+  end
+end
+

data/spec/aitch/request_spec.rb

@@ -0,0 +1,155 @@
+require "spec_helper"
+
+describe Aitch::Request do
+  it "raises with invalid uri" do
+    expect {
+      Aitch::Request.new("post", "\\").uri
+    }.to raise_error(Aitch::InvalidURIError)
+  end
+
+  it "raises on timeout", ruby: 2.0 do
+    request = Aitch::Request.new("post", "http://example.org")
+    request.stub_chain(:client, :request).and_raise(Net::ReadTimeout)
+
+    expect {
+      request.perform
+    }.to raise_error(Aitch::RequestTimeoutError)
+  end
+
+  it "raises on timeout", ruby: 1.9 do
+    request = Aitch::Request.new("post", "http://example.org")
+    request.stub_chain(:client, :request).and_raise(Timeout::Error)
+
+    expect {
+      request.perform
+    }.to raise_error(Aitch::RequestTimeoutError)
+  end
+
+  it "sets user agent" do
+    request = Aitch::Request.new("post", "http://example.org/some/path").request
+    expect(request["User-Agent"]).to eql(Aitch.configuration.user_agent)
+  end
+
+  it "requests gzip encoding" do
+    request = Aitch::Request.new("get", "http://example.org").request
+    expect(request["Accept-Encoding"]).to eql("gzip,deflate")
+  end
+
+  it "sets path" do
+    request = Aitch::Request.new("post", "http://example.org/some/path").request
+    expect(request.path).to eql("/some/path")
+  end
+
+  it "sets request body from hash" do
+    request = Aitch::Request.new("post", "http://example.org/", {a: 1}).request
+    expect(request.body).to eql("a=1")
+  end
+
+  it "sets request body from string" do
+    request = Aitch::Request.new("post", "http://example.org/", "some body").request
+    expect(request.body).to eql("some body")
+  end
+
+  it "sets request body from to_h protocol" do
+    data = stub(to_h: {a: 1})
+    request = Aitch::Request.new("post", "http://example.org/", data).request
+    expect(request.body).to eql("a=1")
+  end
+
+  it "sets request body from to_s protocol" do
+    data = stub(to_s: "some body")
+    request = Aitch::Request.new("post", "http://example.org/", data).request
+
+    expect(request.body).to eql("some body")
+  end
+
+  it "sets default headers" do
+    Aitch.configuration.default_headers = {"HEADER" => "VALUE"}
+    request = Aitch::Request.new("post", "http://example.org/").request
+    expect(request["HEADER"]).to eql("VALUE")
+  end
+
+  it "sets custom headers" do
+    request = Aitch::Request.new("post", "http://example.org/", {}, {"HEADER" => "VALUE"}).request
+    expect(request["HEADER"]).to eql("VALUE")
+  end
+
+  it "sets basic auth credentials" do
+    request = Aitch::Request.new("post", "http://example.org/", {}, {}, {user: "USER", password: "PASS"}).request
+    credentials = Base64.decode64(request["Authorization"].gsub(/Basic /, ""))
+
+    expect(credentials).to eql("USER:PASS")
+  end
+
+  describe "#client" do
+    context "https" do
+      subject(:client) {
+        Aitch::Request.new("get", "https://example.org").client
+      }
+
+      it "sets https" do
+        expect(client.use_ssl?).to be_true
+      end
+
+      it "sets verification mode" do
+        expect(client.verify_mode).to eql(OpenSSL::SSL::VERIFY_PEER)
+      end
+
+      it "sets timeout" do
+        Aitch.configuration.timeout = 20
+        expect(client.read_timeout).to eql(20)
+      end
+    end
+  end
+
+  describe "Request class" do
+    it "raises with invalid method" do
+      expect {
+        Aitch::Request.new("invalid", "URL").request
+      }.to raise_error(Aitch::InvalidHTTPMethodError, %[unexpected HTTP verb: "invalid"])
+    end
+
+    %w[
+      get
+      post
+      put
+      patch
+      delete
+      head
+      options
+      trace
+    ].each do |method|
+      it "instantiates #{method.upcase} method" do
+        request = Aitch::Request.new(method, "URL").request
+        expect(request.class.name).to eql("Net::HTTP::#{method.capitalize}")
+      end
+    end
+  end
+
+  describe "follow redirection" do
+    before { Aitch.configuration.follow_redirect = true }
+
+    it "follows redirect" do
+      Aitch.configuration.redirect_limit = 5
+
+      FakeWeb.register_uri(:get, "http://example.org/", location: "http://example.com/", status: 301)
+      FakeWeb.register_uri(:get, "http://example.com/", body: "Hello")
+
+      response = Aitch.get("http://example.org")
+
+      expect(response).not_to be_redirect
+      expect(response.body).to eql("Hello")
+    end
+
+    it "raises when doing too many redirects" do
+      Aitch.configuration.redirect_limit = 1
+
+      FakeWeb.register_uri(:get, "http://example.org/", location: "http://example.com/", status: 301)
+      FakeWeb.register_uri(:get, "http://example.com/", location: "https://example.com/", status: 301)
+
+      expect {
+        Aitch.get("http://example.org/")
+      }.to raise_error(Aitch::TooManyRedirectsError)
+    end
+  end
+end

data/spec/aitch/response_spec.rb

@@ -0,0 +1,180 @@
+require "spec_helper"
+
+describe Aitch::Response do
+  it "has body" do
+    FakeWeb.register_uri(:get, "http://example.org/", body: "Hello")
+    response = Aitch.get("http://example.org/")
+    expect(response.body).to eql("Hello")
+  end
+
+  it "parses gzip response" do
+    stdio = StringIO.new
+    gzipped = Zlib::GzipWriter.new(stdio)
+    gzipped.write("Hello")
+    gzipped.finish
+
+    FakeWeb.register_uri(:get, "http://example.org/", body: stdio.string, content_encoding: "gzip")
+    response = Aitch.get("http://example.org/")
+
+    expect(response.body).to eql("Hello")
+  end
+
+  it "deflates response" do
+    stdio = StringIO.new
+    deflated = Zlib::Deflate.deflate("Hello")
+
+    FakeWeb.register_uri(:get, "http://example.org/", body: deflated, content_encoding: "deflate")
+    response = Aitch.get("http://example.org/")
+
+    expect(response.body).to eql("Hello")
+  end
+
+  it "returns status code" do
+    FakeWeb.register_uri(:get, "http://example.org/", body: "")
+    response = Aitch.get("http://example.org/")
+    expect(response.code).to eql(200)
+  end
+
+  it "returns content type" do
+    FakeWeb.register_uri(:get, "http://example.org/", content_type: "text/html")
+    response = Aitch.get("http://example.org/")
+    expect(response.content_type).to eql("text/html")
+  end
+
+  it "detects as successful response" do
+    FakeWeb.register_uri(:get, "http://example.org/", content_type: "text/html")
+    response = Aitch.get("http://example.org/")
+    expect(response).to be_success
+  end
+
+  it "returns headers" do
+    FakeWeb.register_uri(:get, "http://example.org/", content_type: "text/html")
+    headers = Aitch.get("http://example.org/").headers
+
+    expect(headers).to be_a(Hash)
+    expect(headers["content-type"]).to eql("text/html")
+  end
+
+  it "normalizes custom headers" do
+    FakeWeb.register_uri(:get, "http://example.org/", "X-Runtime" => "0.003")
+    headers = Aitch.get("http://example.org/").headers
+
+    expect(headers["runtime"]).to eql("0.003")
+  end
+
+  it "maps missing methods to headers" do
+    FakeWeb.register_uri(:get, "http://example.org/", "X-Runtime" => "0.003")
+    response = Aitch.get("http://example.org/")
+
+    expect(response.runtime).to eql("0.003")
+    expect(response).to respond_to(:runtime)
+  end
+
+  context "status 3xx" do
+    before { Aitch.configuration.follow_redirect = false }
+
+    it "has body" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "Hello", status: 301)
+      response = Aitch.get("http://example.org/")
+      expect(response.body).to eql("Hello")
+    end
+
+    it "detects as successful response" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 301)
+      response = Aitch.get("http://example.org/")
+      expect(response).to be_success
+    end
+
+    it "detects as redirect" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 301)
+      response = Aitch.get("http://example.org/")
+      expect(response).to be_redirect
+    end
+
+    it "returns location" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 301, location: "https://example.com/")
+      response = Aitch.get("http://example.org/")
+      expect(response.location).to eql("https://example.com/")
+    end
+  end
+
+  context "status 4xx" do
+    it "detects as error" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 404)
+      response = Aitch.get("http://example.org/")
+
+      expect(response).to be_error
+    end
+
+    it "sets error" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 404)
+      response = Aitch.get("http://example.org/")
+
+      expect(response.error).to eql(Aitch::NotFoundError)
+    end
+  end
+
+  context "status 5xx" do
+    it "detects as error" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 500)
+      response = Aitch.get("http://example.org/")
+
+      expect(response).to be_error
+    end
+
+    it "sets error" do
+      FakeWeb.register_uri(:get, "http://example.org/", status: 500)
+      response = Aitch.get("http://example.org/")
+
+      expect(response.error).to eql(Aitch::InternalServerErrorError)
+    end
+  end
+
+  context "JSON" do
+    it "detects as json" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "[]", content_type: "application/json")
+      response = Aitch.get("http://example.org/")
+
+      expect(response).to be_json
+    end
+
+    it "returns data" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "[1,2,3]", content_type: "application/json")
+      response = Aitch.get("http://example.org/")
+
+      expect(response.data).to eql([1,2,3])
+    end
+  end
+
+  context "HTML" do
+    it "detects as html" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "", content_type: "text/html")
+      response = Aitch.get("http://example.org/")
+
+      expect(response).to be_html
+    end
+
+    it "returns data" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "Hello", content_type: "text/html")
+      response = Aitch.get("http://example.org/")
+
+      expect(response.data).to eql("Hello")
+    end
+  end
+
+  context "XML" do
+    it "detects as xml" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "[]", content_type: "application/xml")
+      response = Aitch.get("http://example.org/")
+
+      expect(response).to be_xml
+    end
+
+    it "returns data" do
+      FakeWeb.register_uri(:get, "http://example.org/", body: "<foo/>", content_type: "application/xml")
+      response = Aitch.get("http://example.org/")
+
+      expect(response.data).to be_a(Nokogiri::XML::Document)
+    end
+  end
+end

data/spec/aitch/xml_parser_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe Aitch::XMLParser do
+  it "instantiates Nokogiri" do
+    Nokogiri
+      .should_receive(:XML)
+      .with("XML")
+
+    Aitch::XMLParser.load("XML")
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require "bundler/setup"
+Bundler.require
+
+require "aitch"
+require "base64"
+require "test_notifier/runner/rspec"
+require "fakeweb"
+require "nokogiri"
+
+FakeWeb.allow_net_connect = false
+
+RSpec.configure do |config|
+  config.filter_run_excluding :ruby => -> version {
+    !(RUBY_VERSION.to_s =~ /^#{version.to_s}/)
+  }
+end

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification
+name: aitch
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Nando Vieira
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-meta
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: test_notifier
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A simple HTTP client
+email:
+- fnando.vieira@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- aitch.gemspec
+- lib/aitch.rb
+- lib/aitch/configuration.rb
+- lib/aitch/errors.rb
+- lib/aitch/redirect.rb
+- lib/aitch/request.rb
+- lib/aitch/response.rb
+- lib/aitch/response/body.rb
+- lib/aitch/response/errors.rb
+- lib/aitch/version.rb
+- lib/aitch/xml_parser.rb
+- spec/aitch/aitch_spec.rb
+- spec/aitch/configuration_spec.rb
+- spec/aitch/request_spec.rb
+- spec/aitch/response_spec.rb
+- spec/aitch/xml_parser_spec.rb
+- spec/spec_helper.rb
+homepage: http://rubygems.org/gems/aitch
+licenses:
+- MIT
+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: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: A simple HTTP client
+test_files:
+- spec/aitch/aitch_spec.rb
+- spec/aitch/configuration_spec.rb
+- spec/aitch/request_spec.rb
+- spec/aitch/response_spec.rb
+- spec/aitch/xml_parser_spec.rb
+- spec/spec_helper.rb