http-request 1.0.0

data/README

@@ -0,0 +1,6 @@
+HttpRequest
+===========
+
+Simple HTTP client written in Ruby. Intended to be easier to work with then Net/HTTP.
+
+Test on Ruby 1.8.7 and 1.9.2.

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/http_request.rb

@@ -0,0 +1,197 @@
+# +-------------------------------------------------------------------------------+
+# | HttpRequest                                                                   |
+# +-------------------------------------------------------------------------------+
+# | Author: NuLayer Inc. / www.nulayer.com                                        |
+# +-------------------------------------------------------------------------------+
+# | BSD LICENSE                                                                   |
+# | Copyright (c) 2007-2010, NuLayer Inc.                                         |
+# | All rights reserved.                                                          |
+# |                                                                               |
+# | Redistribution and use in source and binary forms, with or without            |
+# | modification, are permitted provided that the following conditions are met:   |
+# |     * Redistributions of source code must retain the above copyright          |
+# |       notice, this list of conditions and the following disclaimer.           |
+# |     * Redistributions in binary form must reproduce the above copyright       |
+# |       notice, this list of conditions and the following disclaimer in the     |
+# |       documentation and/or other materials provided with the distribution.    |
+# |     * Neither the name of the <organization> nor the                          |
+# |       names of its contributors may be used to endorse or promote products    |
+# |       derived from this software without specific prior written permission.   |
+# |                                                                               |
+# | THIS SOFTWARE IS PROVIDED BY NuLayer Inc. "AS IS" AND ANY                     |
+# | EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED     |
+# | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE        |
+# | DISCLAIMED. IN NO EVENT SHALL <copyright holder> BE LIABLE FOR ANY            |
+# | DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES    |
+# | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;  |
+# | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND   |
+# | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT    |
+# | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
+# | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.                  |
+# +-------------------------------------------------------------------------------+
+
+require 'net/http'
+
+class HttpRequest
+  VERSION = '1.0.0'
+
+  class HTTPError < StandardError; end
+  class UnexpectedError < StandardError; end
+  
+  class UnreachableError < HTTPError; end
+  class ConnectionResetError < HTTPError; end
+  class TimeoutError < HTTPError; end
+  class RedirectError < HTTPError; end
+
+  attr_accessor :uri
+  attr_accessor :header
+  attr_accessor :body
+  attr_accessor :status
+
+
+  def self.head(url, options={})
+    http = HttpRequest.new(url)
+    http.head(options)
+  end
+
+  def self.get(url, options={})
+    http = HttpRequest.new(url)
+    http.get(options)
+  end
+
+  def self.user_agent=(user_agent)
+    @user_agent = user_agent
+  end
+
+  def self.user_agent
+    @user_agent 
+  end
+
+
+  def initialize(url)
+    self.uri = url
+  end
+
+  def head(options={})
+    request(:head, options)
+  end
+
+  def get(options={})
+    request(:get, options)
+  end
+
+  def request(type, options={})
+    user_agent     = options[:user_agent] || HttpRequest.user_agent || 'HttpRequest'
+    timeout        = (options[:timeout] || 10).to_i
+    redirect_limit = options[:redirect_limit] || 5
+    output_file    = options[:output_file]
+    content_max    = options[:content_max]
+  
+    # Check if we're in a redirecting loop
+    if redirect_limit == 0
+      raise RedirectError, "HTTP redirect too deep: #{uri.to_s}"
+    end
+  
+    # Prepare the request
+    req_path = uri.path
+    req_path += "?#{uri.query}" if !uri.query.nil?
+  
+    req_klass = (type == :head ? Net::HTTP::Head : Net::HTTP::Get)
+    req = req_klass.new(req_path, { 'User-Agent' => user_agent })
+
+    # HTTP request block
+    @retries = 3
+    begin
+      http = Net::HTTP.new(uri.host, uri.port)
+    
+      http.open_timeout = timeout
+      http.read_timeout = timeout
+    
+      http.start do |http|
+        http.request(req) do |response|
+          # Save the header
+          self.header = response.header
+          self.body   = nil
+      
+          # Restrict downloading of content
+          download_content = true
+          if !content_max.nil? && header['content-length'].to_i > content_max
+            download_content = false
+          end
+      
+          # Get the body
+          if download_content
+            if output_file
+              open(output_file, "w") do |f|
+                response.read_body { |data| f.write(data) }
+              end
+            else
+              self.body = response.read_body
+            end
+          end
+        
+          # Handle URL Redirection
+          if response.kind_of?(Net::HTTPRedirection)
+            update_uri_location(header['location'])
+            request type, options.merge({ :redirect_limit => redirect_limit-1 })
+          end
+        end
+      end
+    rescue ::Errno::ENETUNREACH
+      raise UnreachableError, "network is unreachable: #{uri.to_s}"
+    rescue ::Errno::ECONNRESET, ::Errno::ECONNREFUSED, ::SocketError
+      raise ConnectionResetError, "connection reset by peer: #{uri.to_s}"
+    rescue ::Timeout::Error
+      raise TimeoutError, "connection timed out: #{uri.to_s}"
+    rescue ::Errno::EINTR => ex
+      # Transmission was interrupted, retry the request just once.
+      # This usually occurs because the process received a signal.
+      @retries -= 1
+      if @retries >= 0
+        retry
+      else
+        raise ex
+      end
+    rescue HTTPError => ex
+      # Catch exceptions that may be raised above -- not sure why we have to do this
+      raise ex
+    rescue => ex
+      raise UnexpectedError, "#{ex.inspect} -- #{uri.to_s}"
+    ensure
+      http.finish rescue nil
+      http = nil
+    end
+  
+    return self
+  end
+
+  def header=(header)
+    return if header.nil?
+    @header     = header
+    self.status = header.code.to_i
+  end
+
+  def reset!
+    self.header = nil
+    self.body   = nil
+    self.status = nil
+  end
+
+  def uri=(url)
+    @uri = URI.parse(url)
+    @uri.path = '/' if @uri.path.empty?
+    reset!
+  end
+
+  def update_uri_location(location)
+    if header['location'].to_s[0].to_s.chr == '/'
+      url = "#{uri.scheme}://#{uri.host}"        
+      url += ":#{uri.port}" if uri.port != 80 && uri.port != 443
+      url += location
+    else
+      url = location
+    end
+
+    self.uri = url
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+name: http-request
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Peter Kieltyka
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-21 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Simple HTTP client built with Net/HTTP
+email: 
+- peter.kieltyka@nulayer.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README
+- VERSION
+- lib/http_request.rb
+has_rdoc: true
+homepage: http://nulayer.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Simple HTTP client built with Net/HTTP
+test_files: []
+