http_mini 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c14ebc6a6a6761adaf2059bb214850352ecc1192
-  data.tar.gz: d343592b5140e93b5fafda7ffaff3923bd9022ef
+  metadata.gz: 48e061b90be3cf85158f267e7b1c0e1a7b832f18
+  data.tar.gz: 24c7c9e5fcbe4f70197b0eae9de2ac5a329ee6a7
 SHA512:
-  metadata.gz: 37ffe22641095826163b6279fa61b3060d6db430be8decace7bda021ff05eb88fd7f47ee81775443ef000629c368a59a45a9592cf223290befc8bb67a739ad4b
-  data.tar.gz: 244cd5069a0b6ae89a5897cb02167e957a629c0c2758f9f6be2b50e86a8853f899af23ffa450a8cd8c608b16517469639040f22527918c98d753ed7d3afbaca2
+  metadata.gz: e7c985c1165e701977a4a4aa6c2f67f3a923e7c3b02b79e6763d41acbff1ada36f6ce74eb7766c9acfc714019753987fc4bc82bf7609104f0e7f5f0f2986b131
+  data.tar.gz: 64e7046625a0b4a9d4f63f4bb4a5251692a6209b2a6b5d96a5946a3b96ec84fec9a2d44a5fb7c262c7af3a9142006c0b85e0a88518fb328a75d6c341632cd02a

data/README.md

@@ -1,7 +1,7 @@
 # Http mini
 
 A truly minimalist Http client for Ruby. When all you want is
-a one liner to ping or get the response.
+a one liner to ping or get the response from a web server.
 
 ## Install
 
@@ -9,15 +9,31 @@ a one liner to ping or get the response.
 
 ## Usage
 
-    response = HttpMini.new('http://www.google.com').head
-    puts response.code
+    # Sometimes you just need to know if the site is up and running
+    do_something if HttpMini.new('http://www.acme.com').poke
 
-By default, HttpMini ignores errors and will return nil in case of error.
-If you want to raise error, you can set the option on initialization.
-You can also set values for timeouts.
+    # or you want to get the status code
+    puts HttpMini.new('http://www.google.com').head.code
 
-    response = HttpMini.new('http://www.google.com', {ignore_error: false, open_timeout: 5}).get
-    puts response.body
+    # You can also set values for timeouts.
+    puts HttpMini.new('http://www.google.com', {read_timeout: 3, open_timeout: 5}).get.body
+
+    #You can change the url and chain calls
+    http = HttpMini.new('www.apple.com')
+    apple_html = http.get.body
+    ruby_html = http.uri('http://www.ruby-lang.org/en/').get.body
+
+    # or just the path
+    http_request_html = http.path('/stdlib-1.9.3/libdoc/net/http/rdoc/Net/HTTPRequest.html').get.body
+
+## HTTP verbs Support
+
+* HEAD
+* GET
+* POST
+* UPDATE
+* DELETE
+* OPTIONS
 
 ## Author
 

data/lib/http_mini.rb

@@ -3,7 +3,6 @@ require "uri"
 
 class HttpMini
 
-  attr_reader :uri
   attr_accessor :opts
 
   OPEN_TIMEOUT = 2
@@ -11,7 +10,7 @@ class HttpMini
   IGNORE_ERROR = true
 
   def self.VERSION
-    '0.1.1'
+    '0.2.0'
   end
 
   def initialize(url, opts = {})
@@ -20,69 +19,92 @@ class HttpMini
   end
 
   def head
-    request { |http| http.head(path) }
+    request { |http| http.head(full_path) }
   end
 
   def get
-    request { |http| http.get(path) }
+    request { |http| http.get(full_path) }
   end
 
   def post(data)
-    request { |http| http.post(path, data) }
+    request { |http| http.post(full_path, data) }
   end
 
   def put(data)
-    request { |http| http.put(path, data) }
+    request { |http| http.put(full_path, data) }
   end
 
   def delete
-    request { |http| http.delete(path) }
+    request { |http| http.delete(full_path) }
   end
 
   def options
-    request { |http| http.options(path) }
+    request { |http| http.options(full_path) }
   end
 
-  def ping
-    success? head
-  end
-
-  private
-
-  def request
+  def poke
     begin
-      Net::HTTP.start(host, port, :use_ssl => ssl?) {|http| set_timeout(http) and yield(http) }
+      success? head
     rescue Exception => e
       raise e unless ignore_error?
+      false
     end
   end
+  alias_method :ping, :poke
+
+  def uri(uri=nil)
+    uri.nil? ? @uri : (self.uri = uri) and self
+  end
+
+  def host
+    @uri.host || @uri.path.split('/').first
+  end
+
+  def port
+    @uri.port
+  end
+
+  def path(path=nil)
+    path.nil? ? clean_path(@uri.path) : set_path(path)
+  end
+
+  private
 
   def uri=(uri)
-    @uri = URI.parse(uri)
+    @uri = URI.parse(uri) unless uri.nil? || uri.empty?
+  end
+
+  def request
+    Net::HTTP.start(host, port, :use_ssl => ssl?) {|http| set_timeout(http) and yield(http) }
   end
 
   def ssl?
-    uri.scheme == 'https'
+    @uri.scheme == 'https'
   end
 
   def set_timeout(http)
     http.open_timeout, http.read_timeout = timeouts
   end
 
-  def host
-    uri.host || uri.path.split('/').first
+  def full_path
+    @uri.query ? path + '?' + @uri.query : path
   end
 
-  def port
-    uri.port
+  def clean_path(path)
+    default_path remove_host_from_path(path)
+  end
+
+  def default_path(path)
+    path.to_s.empty? ? '/' : path
   end
 
-  def path
-    root? uri.path.gsub(Regexp.new('^' + host), '')
+  def remove_host_from_path(path)
+    path.to_s.gsub Regexp.new('^' + host), ''
   end
 
-  def root?(path)
-    path.empty? ? '/' : path
+  def set_path(path)
+    @uri.path = path
+    self
   end
 
   def timeouts
@@ -102,7 +124,7 @@ class HttpMini
   end
 
   def success?(response)
-    response && response.code.to_i >= 200 && response.code.to_i < 300 ? true : false
+    response && response.code.to_i >= 200 && response.code.to_i < 400
   end
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: http_mini
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Jerome Touffe-Blin
@@ -24,7 +24,7 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: 1.3.0
-description: A minimalist wrapper over Http::Net
+description: A thin wrapper over URI and Http::Net
 email: jtblin@gmail.com
 executables: []
 extensions: []