troelskn-handsoap 0.2.9 → 0.3.0

data/README.markdown

@@ -5,7 +5,7 @@ Install
 ---
 
     gem sources -a http://gems.github.com
-    sudo gem install troelskn-handsoap curb
+    sudo gem install troelskn-handsoap curb nokogiri
 
 What
 ---
@@ -13,6 +13,8 @@ Handsoap is a library for creating SOAP clients in Ruby.
 
 [Watch a tutorial](http://www.vimeo.com/4813848), showing how to use Handsoap. The final application can be found at: [http://github.com/troelskn/handsoap-example/tree/master](http://github.com/troelskn/handsoap-example/tree/master)
 
+API docs are at [http://rdoc.info/projects/troelskn/handsoap](http://rdoc.info/projects/troelskn/handsoap)
+
 ![Handsoap](http://ny-image0.etsy.com/il_430xN.68558416.jpg)
 
 Why
@@ -68,6 +70,11 @@ The protocol also contains a large and unwieldy specification of how to do the (
 
 Handsoap only supports RPC-style SOAP. This seems to be the most common style. It's probably possible to add support for Document-style with little effort, but until I see the need I'm not going there.
 
+API documnetation
+---
+
+In addition to this guide, there's autogenerated API documentation available at [http://rdoc.info/projects/troelskn/handsoap](http://rdoc.info/projects/troelskn/handsoap)
+
 The toolbox
 ---
 
@@ -75,7 +82,7 @@ The Handsoap toolbox consists of the following components.
 
 Handsoap can use either [curb](http://curb.rubyforge.org/) or [httpclient](http://dev.ctor.org/http-access2) for HTTP-connectivity. The former is recommended, and default, but for portability you might choose the latter. You usually don't need to interact at the HTTP-level, but if you do (for example, if you have to use SSL), you can.
 
-For parsing XML, Handsoap uses [Nokogiri](http://github.com/tenderlove/nokogiri/tree/master). While this may become optional in the future, the dependency is a bit tighter. The XML-parser is used internally in Handsoap, as well as by the code that maps from SOAP to Ruby (The code you're writing). Nokogiri is very fast (being based om libxml) and has a polished and stable api.
+For parsing XML, Handsoap defaults to use [Nokogiri](http://github.com/tenderlove/nokogiri/tree/master). Handsoap has an abstraction layer, so that you can switch between REXML, Nokogiri and ruby-libxml. Besides providing portability between these parsers, Handsop also gives some helper functions that are meaningful when parsing SOAP envelopes.
 
 There is also a library for generating XML, which you'll use when mapping from Ruby to SOAP. It's quite similar to [Builder](http://builder.rubyforge.org/), but is tailored towards being used for writing SOAP-messages. The name of this library is `XmlMason` and it is included/part of Handsoap.
 
@@ -101,7 +108,7 @@ Recommendations
 
 7. Write Ruby-code (using XmlMason) to generate a request that is similar to the example from soapUI. (In your copy+paste buffer)
 
-8. Write Ruby-code to parse the response (a Nokogiri XML-document) into Ruby data types.
+8. Write Ruby-code to parse the response (an XML-document) into Ruby data types.
 
 9. Write an integration test to verify that your method works as expected. You can use soapUI to [generate a mock-service](http://www.soapui.org/userguide/mock/getting_started.html).
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
+:minor: 3
+:patch: 0
 :major: 0
-:minor: 2
-:patch: 9

data/lib/handsoap/compiler.rb

@@ -1,41 +1,43 @@
 # -*- coding: utf-8 -*-
 module Handsoap
-    class CodeWriter
+  # Used internally to generate Ruby source code
+  class CodeWriter #:nodoc: all
 
-      def initialize
-        @buffer = ""
-        @indentation = 0
-      end
+    def initialize
+      @buffer = ""
+      @indentation = 0
+    end
 
-      def begin(text)
-        puts(text)
-        indent
-      end
+    def begin(text)
+      puts(text)
+      indent
+    end
 
-      def end(str = "end")
-        unindent
-        puts(str)
-      end
+    def end(str = "end")
+      unindent
+      puts(str)
+    end
 
-      def puts(text = "")
-        @buffer << text.gsub(/^(.*)$/, ("  " * @indentation) + "\\1")
-        @buffer << "\n" # unless @buffer.match(/\n$/)
-      end
+    def puts(text = "")
+      @buffer << text.gsub(/^(.*)$/, ("  " * @indentation) + "\\1")
+      @buffer << "\n" # unless @buffer.match(/\n$/)
+    end
 
-      def indent
-        @indentation = @indentation + 1
-      end
+    def indent
+      @indentation = @indentation + 1
+    end
 
-      def unindent
-        @indentation = @indentation - 1
-      end
+    def unindent
+      @indentation = @indentation - 1
+    end
 
-      def to_s
-        @buffer
-      end
+    def to_s
+      @buffer
     end
+  end
 
-  class Compiler
+  # Used internally by the generator to generate a Service stub.
+  class Compiler #:nodoc: all
 
     def initialize(wsdl, basename = nil)
       @wsdl = wsdl

data/lib/handsoap/parser.rb

@@ -5,7 +5,10 @@ require 'uri'
 require 'nokogiri'
 
 module Handsoap
-  module Parser
+  # Classes for parsing a WSDL.
+  #
+  # Used internally by the generator.
+  module Parser #:nodoc: all
     class Interface
       attr_accessor :name, :operations
 

data/lib/handsoap/service.rb

@@ -1,35 +1,7 @@
 # -*- coding: utf-8 -*-
-require 'rubygems'
-require 'nokogiri'
 require 'time'
 require 'handsoap/xml_mason'
-
-# Nokogiri doesn't have a way of getting plain strings out,
-# so this monkeypatch adds that capability ..
-module Utf8StringPatch
-  def to_utf8
-    # HTMLEntities.decode_entities(self.serialize(:encoding => 'UTF-8'))
-    if Gem.loaded_specs['nokogiri'].version >= Gem::Version.new('1.3.0')
-      self.serialize(:encoding => 'UTF-8').gsub('&lt;', '<').gsub('&gt;', '>').gsub('&quot;', '"').gsub('&apos;', "'").gsub('&amp;', '&')
-    else
-      self.serialize('UTF-8').gsub('&lt;', '<').gsub('&gt;', '>').gsub('&quot;', '"').gsub('&apos;', "'").gsub('&amp;', '&')
-    end
-  end
-end
-
-module Nokogiri
-  module XML
-    class Text
-      include Utf8StringPatch
-    end
-    class Nodeset
-      include Utf8StringPatch
-    end
-    class Attr
-      include Utf8StringPatch
-    end
-  end
-end
+require 'handsoap/xml_query_front'
 
 module Handsoap
 
@@ -44,6 +16,14 @@ module Handsoap
     return driver
   end
 
+  def self.xml_query_driver
+    @xml_query_driver || (self.xml_query_driver = :nokogiri)
+  end
+
+  def self.xml_query_driver=(driver)
+    @xml_query_driver = Handsoap::XmlQueryFront.load_driver!(driver)
+  end
+
   SOAP_NAMESPACE = { 1 => 'http://schemas.xmlsoap.org/soap/envelope/', 2 => 'http://www.w3.org/2001/12/soap-encoding' }
 
   class Response
@@ -58,8 +38,11 @@ module Handsoap
     end
     def document
       if @document == :lazy
-        doc = Nokogiri::XML(@http_body)
-        @document = (doc && doc.root && doc.errors.empty?) ? doc : nil
+        begin
+          @document = Handsoap::XmlQueryFront.parse_string(@http_body, Handsoap.xml_query_driver)
+        rescue Handsoap::XmlQueryFront::ParseError => ex
+          @document = nil
+        end
       end
       return @document
     end
@@ -160,7 +143,18 @@ module Handsoap
         super
       end
     end
-    def invoke(action, options = { :soap_action => :auto }, &block)
+    # Creates an XML document and sends it over HTTP.
+    #
+    # +action+ is the QName of the rootnode of the envelope.
+    #
+    # +options+ currently takes one option +:soap_action+, which can be one of:
+    #
+    # :auto sends a SOAPAction http header, deduced from the action name. (This is the default)
+    #
+    # +String+ sends a SOAPAction http header.
+    #
+    # +nil+ sends no SOAPAction http header.
+    def invoke(action, options = { :soap_action => :auto }, &block) # :yields: Handsoap::XmlMason::Element
       if action
         if options.kind_of? String
           options = { :soap_action => options }
@@ -179,13 +173,21 @@ module Handsoap
         dispatch(doc, options[:soap_action])
       end
     end
+    # Hook that is called before the message is dispatched.
+    #
+    # You can override this to provide filtering and logging.
     def on_before_dispatch
     end
+    # Hook that is called if the dispatch returns a +Fault+.
+    #
+    # Default behaviour is to raise the Fault, but you can override this to provide logging and more fine-grained handling faults.
     def on_fault(fault)
       raise fault
     end
     private
     # Helper to serialize a node into a ruby string
+    #
+    # *deprecated*. Use Handsoap::XmlQueryFront::BaseDriver#to_s
     def xml_to_str(node, xquery = nil)
       n = xquery ? node.xpath(xquery, ns).first : node
       return if n.nil?
@@ -193,6 +195,8 @@ module Handsoap
     end
     alias_method :xml_to_s, :xml_to_str
     # Helper to serialize a node into a ruby integer
+    #
+    # *deprecated*. Use Handsoap::XmlQueryFront::BaseDriver#to_i
     def xml_to_int(node, xquery = nil)
       n = xquery ? node.xpath(xquery, ns).first : node
       return if n.nil?
@@ -200,6 +204,8 @@ module Handsoap
     end
     alias_method :xml_to_i, :xml_to_int
     # Helper to serialize a node into a ruby float
+    #
+    # *deprecated*. Use Handsoap::XmlQueryFront::BaseDriver#to_f
     def xml_to_float(node, xquery = nil)
       n = xquery ? node.xpath(xquery, ns).first : node
       return if n.nil?
@@ -207,18 +213,22 @@ module Handsoap
     end
     alias_method :xml_to_f, :xml_to_float
     # Helper to serialize a node into a ruby boolean
+    #
+    # *deprecated*. Use Handsoap::XmlQueryFront::BaseDriver#to_boolean
     def xml_to_bool(node, xquery = nil)
       n = xquery ? node.xpath(xquery, ns).first : node
       return if n.nil?
       n.to_s == "true"
     end
     # Helper to serialize a node into a ruby Time object
+    #
+    # *deprecated*. Use Handsoap::XmlQueryFront::BaseDriver#to_date
     def xml_to_date(node, xquery = nil)
       n = xquery ? node.xpath(xquery, ns).first : node
       return if n.nil?
       Time.iso8601(n.to_s)
     end
-    def debug(message = nil)
+    def debug(message = nil) #:nodoc:
       if @@logger
         if message
           @@logger.puts(message)
@@ -228,8 +238,9 @@ module Handsoap
         end
       end
     end
+    # Takes care of the HTTP level dispatch.
     def dispatch(doc, action)
-      on_before_dispatch()
+      on_before_dispatch
       headers = {
         "Content-Type" => "#{self.class.request_content_type};charset=UTF-8"
       }
@@ -273,7 +284,8 @@ module Handsoap
       end
       return soap_response
     end
-    def make_envelope
+    # Creates a standard SOAP envelope and yields the +Body+ element.
+    def make_envelope # :yields: Handsoap::XmlMason::Element
       doc = XmlMason::Document.new do |doc|
         doc.alias 'env', self.class.envelope_namespace
         doc.add "env:Envelope" do |env|
@@ -292,11 +304,11 @@ module Handsoap
   def self.pretty_format_envelope(xml_string)
     if /^<.*:Envelope/.match(xml_string)
       begin
-        doc = Nokogiri::XML(xml_string)
+        doc = Handsoap::XmlQueryFront.parse_string(xml_string, Handsoap.xml_query_driver)
       rescue Exception => ex
         return "Formatting failed: " + ex.to_s
       end
-      return doc.to_s
+      return doc.to_xml
       # return "\n\e[1;33m" + doc.to_s + "\e[0m"
     end
     return xml_string

data/lib/handsoap/xml_mason.rb

@@ -2,28 +2,44 @@
 
 module Handsoap
 
+  # XmlMason is a simple XML builder.
   module XmlMason
 
-    HTML_ESCAPE = { '&' => '&amp;', '"' => '&quot;', '>' => '&gt;', '<' => '&lt;' }
+    XML_ESCAPE = { '&' => '&amp;', '"' => '&quot;', '>' => '&gt;', '<' => '&lt;' }
 
-    def self.html_escape(s)
-      s.to_s.gsub(/[&"><]/) { |special| HTML_ESCAPE[special] }
+    def self.xml_escape(s)
+      s.to_s.gsub(/[&"><]/) { |special| XML_ESCAPE[special] }
     end
 
     class Node
       def initialize
         @namespaces = {}
       end
-      def add(node_name, value = nil, *flags)
+      def add(node_name, value = nil, *flags) # :yields: Handsoap::XmlMason::Element
         prefix, name = parse_ns(node_name)
         node = append_child Element.new(self, prefix, name, value, flags)
         if block_given?
           yield node
         end
       end
+      # Registers a prefix for a namespace.
+      #
+      # You must register a namespace, before you can refer it.
       def alias(prefix, namespaces)
         @namespaces[prefix] = namespaces
       end
+      # Finds the first element whos +node_name+ equals +name+
+      #
+      # Doesn't regard namespaces/prefixes.
+      def find(name)
+        raise NotImplementedError.new
+      end
+      # Finds all elements whos +node_name+ equals +name+
+      #
+      # Doesn't regard namespaces/prefixes.
+      def find_all(name)
+        raise NotImplementedError.new
+      end
       def parse_ns(name)
         matches = name.match /^([^:]+):(.*)$/
         if matches
@@ -36,7 +52,7 @@ module Handsoap
     end
 
     class Document < Node
-      def initialize
+      def initialize # :yields: Document
         super
         @document_element = nil
         if block_given?
@@ -74,7 +90,7 @@ module Handsoap
         @text = text
       end
       def to_s(indentation = '')
-        XmlMason.html_escape(@text)
+        XmlMason.xml_escape(@text)
       end
     end
 
@@ -85,7 +101,7 @@ module Handsoap
     end
 
     class Element < Node
-      def initialize(parent, prefix, node_name, value = nil, flags = [])
+      def initialize(parent, prefix, node_name, value = nil, flags = []) # :yields: Handsoap::XmlMason::Element
         super()
 #         if prefix.to_s == ""
 #           raise "missing prefix"
@@ -102,12 +118,17 @@ module Handsoap
           yield self
         end
       end
+      # Returns the document that this element belongs to, or self if this is the document.
       def document
         @parent.respond_to?(:document) ? @parent.document : @parent
       end
+      # Returns the qname (prefix:nodename)
       def full_name
         @prefix.nil? ? @node_name : (@prefix + ":" + @node_name)
       end
+      # Adds a child node.
+      #
+      # You usually won't need to call this method, but will rather use +add+
       def append_child(node)
         if value_node?
           raise "Element already has a text value. Can't add nodes"
@@ -115,6 +136,11 @@ module Handsoap
         @children << node
         return node
       end
+      # Sets the inner text of this element.
+      #
+      # By default the string is escaped, but you can pass the flag :raw to inject XML.
+      #
+      # You usually won't need to call this method, but will rather use +add+
       def set_value(value, *flags)
         if @children.length > 0
           raise "Element already has children. Can't set value"
@@ -125,6 +151,7 @@ module Handsoap
           @children = [TextNode.new(value)]
         end
       end
+      # Sets the value of an attribute.
       def set_attr(name, value)
         full_name = parse_ns(name).join(":")
         @attributes[name] = value
@@ -171,8 +198,8 @@ module Handsoap
         if @prefix && (not defines_namespace?(@prefix))
           set_attr "xmlns:#{@prefix}", get_namespace(@prefix)
         end
-        name = XmlMason.html_escape(full_name)
-        attr = (@attributes.any? ? (" " + @attributes.map { |key, value| XmlMason.html_escape(key) + '="' + XmlMason.html_escape(value) + '"' }.join(" ")) : "")
+        name = XmlMason.xml_escape(full_name)
+        attr = (@attributes.any? ? (" " + @attributes.map { |key, value| XmlMason.xml_escape(key) + '="' + XmlMason.xml_escape(value) + '"' }.join(" ")) : "")
         if @children.any?
           if value_node?
             children = @children[0].to_s(indentation + "  ")

data/lib/handsoap/xml_query_front.rb

@@ -0,0 +1,249 @@
+# -*- coding: utf-8 -*-
+module Handsoap
+  #
+  # A simple frontend for parsing XML document with Xpath.
+  #
+  # This provides a unified interface for multiple xpath-capable dom-parsers,
+  # allowing seamless switching between the underlying implementations.
+  #
+  # A document is loaded using the function Handsoap::XmlQueryFront.parse_string, passing
+  # the xml source string and a driver, which can (currently) be one of:
+  #
+  #   :rexml
+  #   :nokogiri
+  #   :libxml
+  #
+  # The resulting object is a wrapper, of the type Handsoap::XmlQueryFront::BaseDriver.
+  #
+  module XmlQueryFront
+
+    # This error is raised if the document didn't parse
+    class ParseError < RuntimeError; end
+
+    # Loads requirements for a driver.
+    #
+    # This function is implicitly called by +parse_string+.
+    def self.load_driver!(driver)
+      if driver == :rexml
+        require 'rexml/document'
+      elsif driver == :nokogiri
+        require 'nokogiri'
+      elsif driver == :libxml
+        require 'libxml'
+      else
+        raise "Unknown driver #{driver}"
+      end
+      return driver
+    end
+
+    # Returns a wrapped XML parser, using the requested driver.
+    #
+    # +driver+ can be one of the following:
+    #   :rexml
+    #   :nokogiri
+    #   :libxml
+    def self.parse_string(xml_string, driver)
+      load_driver!(driver)
+      if driver == :rexml
+        doc = REXML::Document.new(xml_string)
+        raise ParseError.new if doc.root.nil?
+        XmlQueryFront::REXMLDriver.new(doc)
+      elsif driver == :nokogiri
+        doc = Nokogiri::XML(xml_string)
+        raise ParseError.new unless (doc && doc.root && doc.errors.empty?)
+        XmlQueryFront::NokogiriDriver.new(doc)
+      elsif driver == :libxml
+        begin
+          LibXML::XML::Error.set_handler &LibXML::XML::Error::QUIET_HANDLER
+          doc = XmlQueryFront::LibXMLDriver.new(LibXML::XML::Parser.string(xml_string).parse)
+        rescue ArgumentError, LibXML::XML::Error => ex
+          raise ParseError.new
+        end
+      end
+    end
+
+    # Wraps the underlying (native) xml driver, and provides a uniform interface.
+    module BaseDriver
+      def initialize(element, namespaces = {})
+        @element = element
+        @namespaces = namespaces
+      end
+      # Registers a prefix to refer to a namespace.
+      #
+      # You can either register a nemspace with this function or pass it explicitly to the +xpath+ method.
+      def add_namespace(prefix, uri)
+        @namespaces[prefix] = uri
+      end
+      # Checks that an xpath-query doesn't refer to any undefined prefixes in +ns+
+      def assert_prefixes!(expression, ns)
+        expression.scan(/([a-zA-Z_][a-zA-Z0-9_.-]*):[^:]+/).map{|m| m[0] }.each do |prefix|
+          raise "Undefined prefix '#{prefix}'" if ns[prefix].nil?
+        end
+      end
+      # Returns the value of the element as an integer.
+      #
+      # See +to_s+
+      def to_i
+        t = self.to_s
+        return if t.nil?
+        t.to_i
+      end
+      # Returns the value of the element as a float.
+      #
+      # See +to_s+
+      def to_f
+        t = self.to_s
+        return if t.nil?
+        t.to_f
+      end
+      # Returns the value of the element as an boolean.
+      #
+      # See +to_s+
+      def to_boolean
+        t = self.to_s
+        return if t.nil?
+        t.downcase == 'true'
+      end
+      # Returns the value of the element as a ruby Time object.
+      #
+      # See +to_s+
+      def to_date
+        t = self.to_s
+        return if t.nil?
+        Time.iso8601(t)
+      end
+      # Returns the underlying native element.
+      #
+      # You shouldn't need to use this, since doing so would void portability.
+      def native_element
+        @element
+      end
+      # Returns the node name of the current element.
+      def node_name
+        raise NotImplementedError.new
+      end
+      # Queries the document with XPath, relative to the current element.
+      #
+      # +ns+ Should be a Hash of prefix => namespace
+      #
+      # Returns an Array of wrapped elements.
+      #
+      # See add_namespace
+      def xpath(expression, ns = nil)
+        raise NotImplementedError.new
+      end
+      # Returns the inner text content of this element, or the value (if it's an attr or textnode).
+      #
+      # The output is a UTF-8 encoded string, without xml-entities.
+      def to_s
+        raise NotImplementedError.new
+      end
+      # Returns the outer XML for this element.
+      def to_xml
+        raise NotImplementedError.new
+      end
+      # Alias for +xpath+
+      def /(expression)
+        self.xpath(expression)
+      end
+    end
+
+    # Driver for +libxml+.
+    #
+    # http://libxml.rubyforge.org/
+    class LibXMLDriver
+      include BaseDriver
+      def node_name
+        @element.name
+      end
+      def xpath(expression, ns = nil)
+        ns = {} if ns.nil?
+        ns = @namespaces.merge(ns)
+        assert_prefixes!(expression, ns)
+        @element.find(expression, ns.map{|k,v| "#{k}:#{v}" }).to_a.map{|node| LibXMLDriver.new(node, ns) }
+      end
+      def to_xml
+        @element.to_s
+      end
+      def to_s
+        if @element.kind_of? LibXML::XML::Attr
+          @element.value
+        else
+          @element.content
+        end
+      end
+    end
+
+    # Driver for +REXML+
+    #
+    # http://www.germane-software.com/software/rexml/
+    class REXMLDriver
+      include BaseDriver
+      def node_name
+        @element.name
+      end
+      def xpath(expression, ns = nil)
+        ns = {} if ns.nil?
+        ns = @namespaces.merge(ns)
+        assert_prefixes!(expression, ns)
+        REXML::XPath.match(@element, expression, ns).map{|node| REXMLDriver.new(node, ns) }
+      end
+      def to_xml
+        require 'rexml/formatters/pretty'
+        formatter = REXML::Formatters::Pretty.new
+        out = String.new
+        formatter.write(@element, out)
+        out
+      end
+      def to_s
+        if @element.kind_of? REXML::Attribute
+          @element.value
+        else
+          @element.text
+        end
+      end
+    end
+
+    # Driver for +Nokogiri+
+    #
+    # http://nokogiri.rubyforge.org/nokogiri/
+    class NokogiriDriver
+      include BaseDriver
+      def node_name
+        @element.name
+      end
+      def self.serialize_args #:nodoc:
+        @serialize_args ||= if Gem.loaded_specs['nokogiri'].version >= Gem::Version.new('1.3.0')
+                              { :encoding => 'UTF-8' }
+                            else
+                              'UTF-8'
+                            end
+      end
+      def xpath(expression, ns = nil)
+        ns = {} if ns.nil?
+        ns = @namespaces.merge(ns)
+        assert_prefixes!(expression, ns)
+        @element.xpath(expression, ns).map{|node| NokogiriDriver.new(node, ns) }
+      end
+      def to_xml
+        @element.serialize(NokogiriDriver.serialize_args)
+      end
+      def to_s
+        if @element.kind_of?(Nokogiri::XML::Text) || @element.kind_of?(Nokogiri::XML::CDATA)
+          element = @element
+        elsif @element.kind_of?(Nokogiri::XML::Attr)
+          return @element.value
+        else
+          element = @element.children.first
+        end
+        return if element.nil?
+        # This looks messy because it is .. Nokogiri's interface is in a flux
+        if element.kind_of?(Nokogiri::XML::CDATA)
+          element.serialize(NokogiriDriver.serialize_args).gsub(/^<!\[CDATA\[/, "").gsub(/\]\]>$/, "")
+        else
+          element.serialize(NokogiriDriver.serialize_args).gsub('&lt;', '<').gsub('&gt;', '>').gsub('&quot;', '"').gsub('&apos;', "'").gsub('&amp;', '&')
+        end
+      end
+    end
+  end
+end

data/lib/handsoap.rb

@@ -1,3 +1,4 @@
 # -*- coding: utf-8 -*-
 require 'handsoap/xml_mason'
+require 'handsoap/xml_query_front'
 require 'handsoap/service'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: troelskn-handsoap
 version: !ruby/object:Gem::Version 
-  version: 0.2.9
+  version: 0.3.0
 platform: ruby
 authors: 
 - Troels Knak-Nielsen
@@ -9,19 +9,10 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-06-17 00:00:00 -07:00
+date: 2009-06-23 00:00:00 -07:00
 default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: nokogiri
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.2.3
-    version: 
+dependencies: []
+
 description: Handsoap is a library for creating SOAP clients in Ruby
 email: troelskn@gmail.com
 executables: []
@@ -41,6 +32,7 @@ files:
 - lib/handsoap/parser.rb
 - lib/handsoap/service.rb
 - lib/handsoap/xml_mason.rb
+- lib/handsoap/xml_query_front.rb
 has_rdoc: true
 homepage: http://github.com/troelskn/handsoap
 post_install_message: 
@@ -60,8 +52,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version 
       version: "0"
   version: 
-requirements: []
-
+requirements: 
+- |-
+  You need to install either "curb" or "httpclient", using one of:
+      gem install curb
+      gem install httpclient
+- It is recommended that you install either "nokogiri" or "libxml-ruby"
 rubyforge_project: 
 rubygems_version: 1.2.0
 signing_key: