rufus-verbs 0.4 → 0.5

data/README.txt

@@ -7,12 +7,14 @@
 
 It wraps a certain number of techniques that make it a decent tool for manipulating web resources.
 
+Head and Options are supported as well.
+
 
 == features
 
 currently :
 
-* follows redirections
+* follows redirections (disable with :noredir => true)
 * automatically adds _method={post|put} in the request parameters with the option :fake_put => true
 * HTTPS aware ('verify none' by default)
 * HTTP basic authentication
@@ -87,6 +89,14 @@ using get(), post(), put() and delete() directly
     delete "http://resta.farian.server:7080/inventory/tools/0"
         # I don't need that hammer anymore
 
+    ms = options "http://resta.farian.server:7080/inventory/tools"
+    p ms
+        # should yield something like [ :get, :head, :post ]
+
+    res = head "http://resta.farian.server:7080/inventory/tools"
+        # same as get() but only the response headers will be returned
+        # not the response body.
+
 
 Using get() and co via an EndPoint to share common options for a set of requests
 

data/lib/rufus/verbs.rb

@@ -70,5 +70,21 @@ module Rufus::Verbs
 
         EndPoint.request :delete, args
     end
+
+    #
+    # HEAD
+    #
+    def head (*args)
+
+        EndPoint.request :head, args
+    end
+
+    #
+    # OPTIONS
+    #
+    def options (*args)
+
+        EndPoint.request :options, args
+    end
 end
 

data/lib/rufus/verbs/endpoint.rb

@@ -111,6 +111,16 @@ module Verbs
             request :delete, args
         end
 
+        def head (*args)
+
+            request :head, args
+        end
+
+        def options (*args)
+
+            request :options, args
+        end
+
         #
         # This is the method called by the module methods verbs.
         #
@@ -179,6 +189,8 @@ module Verbs
 
             res = handle_response method, res, opts
 
+            return parse_options(res) if method == :options
+
             return res.body if o(opts, :body)
 
             res
@@ -525,6 +537,27 @@ module Verbs
                 res
             end
 
+            #
+            # Returns an array of symbols, like for example
+            #
+            #     [ :get, :post ]
+            #
+            # obtained by parsing the 'Allow' response header.
+            #
+            # This method is used to provide the result of an OPTIONS
+            # HTTP method.
+            #
+            def parse_options (res)
+
+                s = res['Allow']
+
+                return [] unless s
+
+                s.split(",").collect do |m|
+                    m.strip.downcase.to_sym
+                end
+            end
+
             #
             # Returns true if the current request has authentication
             # going on.

data/lib/rufus/verbs/version.rb

@@ -39,7 +39,7 @@ module Verbs
     #
     # The version of this rufus-verbs [gem]
     #
-    VERSION = '0.4'
+    VERSION = '0.5'
 end
 end
 

data/test/simple_test.rb

@@ -80,4 +80,23 @@ class SimpleTest < Test::Unit::TestCase
         r = get "http://rufus.rubyforge.org"
         assert_kind_of Net::HTTPOK, r
     end
+
+    #
+    # HEAD
+    #
+    def test_4
+
+        res = head "http://localhost:7777/items"
+        assert_equal 200, res.code.to_i
+        assert_nil res.body
+    end
+
+    #
+    # OPTIONS
+    #
+    def test_5
+
+        r = options "http://localhost:7777/items"
+        assert_equal [ :delete, :get, :head, :options, :post, :put], r
+    end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rufus-verbs
 version: !ruby/object:Gem::Version 
-  version: "0.4"
+  version: "0.5"
 platform: ruby
 authors: 
 - John Mettraux
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-01-28 00:00:00 +09:00
+date: 2008-02-01 00:00:00 +09:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency