savon 0.7.9 → 0.8.0.beta.1

data/.autotest

@@ -1,5 +0,0 @@
-Autotest.add_hook(:initialize) do |at|
-  at.clear_mappings
-  at.add_mapping(%r%^spec/savon/.*_spec.rb$%) { |filename, _| filename }
-  at.add_mapping(%r%^lib/(.*)\.rb$%) { |_, m| ["spec/#{m[1]}_spec.rb"] }
-end

data/CHANGELOG

@@ -1,176 +0,0 @@
-== 0.7.9 (2010-06-14)
-  * Fix for issue #53 (DateTime.to_soap_value assumes UTC).
-
-== 0.7.8 (2010-05-09)
-  * Fixed gemspec to include missing files (*.yml, *.gz, .autotest and spec/spec.opts) in the gem.
-
-== 0.7.7 (2010-05-09)
-  * SOAP requests now start with a proper XML declaration.
-  * Added support for gzipped requests and responses (http://github.com/lucascs). While gzipped SOAP
-    responses are decoded automatically, you have to manually instruct Savon to gzip SOAP requests:
-
-      client = Savon::Client.new "http://example.com/UserService?wsdl", :gzip => true
-
-  * Fix for issue #51. Added the :soap_endpoint option to Savon::Client.new which let's you specify a SOAP
-    endpoint per client instance:
-
-    client = Savon::Client.new "http://example.com/UserService?wsdl",
-      :soap_endpoint => "http://localhost/UserService"
-
-  * Fix for issue #50. Savon still escapes special characters in SOAP request Hash values, but you can now
-    append an exclamation mark to Hash keys specifying that it's value should not be escaped.
-
-== 0.7.6 (2010-03-21)
-  * Moved documentation from the Github Wiki to the actual class files and established a much nicer
-    documentation combining examples and implementation (using Hanna) at: http://savon.rubiii.com
-  * Added Savon::Client#call as a workaround for dispatching calls to SOAP actions  named after
-	  existing methods. Fix for issue #48.
-  * Add support for specifying attributes for duplicate tags (via Hash values as Arrays). Fix for issue #45.
-  * Fix for issue #41 (Escape special characters (e.g. &) for XML requests).
-  * Fix for issue #39 and #49. Added Savon::SOAP#xml which let's you specify completely custom SOAP request XML.
-
-== 0.7.5 (2010-02-19)
-  * Fix for issue #34 (soap_actions returns empty for wsdl12).
-  * Fix for issue #36 (Custom WSDL actions broken).
-  * Added feature requested in issue #35 (Setting an attribute on an element?).
-  * Changed the key for specifying the order of tags from :@inorder to :order!
-
-== 0.7.4 (2010-02-02)
-  * Fix for issue #33 (undefined method 'start_with?').
-
-== 0.7.3 (2010-01-31)
-  * Added support for Geotrust-style WSDL documents (Julian Kornberger <github.corny@digineo.de>).
-  * Make HTTP requests include path and query only. This was breaking requests via proxy as scheme and host
-    were repeated (Adrian Mugnolo <adrian@mugnolo.com>)
-  * Avoid warning on 1.8.7 and 1.9.1 (Adrian Mugnolo <adrian@mugnolo.com>).
-  * Fix for issue #29 (WSSE Created Bug?). Default to UTC to xs:dateTime value for WSSE authentication.
-  * Fix for issue #28 (Undefined Method ssl? on URI::Generic).
-  * Fix for issue #27 (http content-type defaults to utf-8). The Content-Type now defaults to UTF-8.
-  * Modification to allow assignment of an Array with an input name and an optional Hash of values to soap.input.
-    Patches issue #30 (stanleydrew <andrewmbenton@gmail.com>).
-  * Fix for issue #25 (header-tag should not be sent if not set).
-
-== 0.7.2 (2010-01-17)
-  * Exposed the Net::HTTP response (added by Kevin Ingolfsland). Use the "http" accessor (response.http) on your
-    Savon::Response to access the Net::HTTP response object.
-  * Fix for issue #21 (savon is stripping ?SOAP off the end of WSDL locations).
-  * Fix for issue #22 (REXML::ParseException parsing 401 Unauthorized response body).
-  * Fix for issue #19 (Unable to set attribute in name-spaced WSSE password element).
-  * Added support for global header and namespaces. See issue #9 (Setting headers and namespaces).
-
-== 0.7.1 (2010-01-10)
-  * The Hash of HTTP headers for SOAP calls is now public via Savon::Request#headers.
-    Patch for: http://github.com/rubiii/savon/issues/#issue/8
-
-== 0.7.0 (2010-01-09)
-  This version comes with several changes to the public API!
-  Pay attention to the following list and read the updated Wiki: http://wiki.github.com/rubiii/savon
-
-  * Changed how Savon::WSDL can be disabled. Instead of disabling the WSDL globally/per request via two
-    different methods, you now simply append an exclamation mark (!) to your SOAP call: client.get_all_users!
-    Make sure you know what you're doing because when the WSDL is disabled, Savon does not know about which
-    SOAP actions are valid and just dispatches everything.
-  * The Net::HTTP object used by Savon::Request to retrieve WSDL documents and execute SOAP calls is now public.
-    While this makes the library even more flexible, it also comes with two major changes:
-    * SSL client authentication needs to be defined directly on the Net::HTTP object:
-      client.request.http.client_cert = ...
-      I added a shortcut method for setting all options through a Hash similar to the previous implementation:
-      client.request.http.ssl_client_auth :client_cert => ...
-    * Open and read timeouts also need to be set on the Net::HTTP object:
-      client.request.http.open_timeout = 30
-      client.request.http.read_timeout = 30
-    * Please refer to the Net::HTTP documentation for more details:
-      http://www.ruby-doc.org/stdlib/libdoc/net/http/rdoc/index.html
-  * Thanks to JulianMorrison, Savon now supports HTTP basic authentication:
-    client.request.http.basic_auth "username", "password"
-  * Julian also added a way to explicitly specify the order of Hash keys and values, so you should now be able
-    to work with services requiring a specific order of input parameters while still using Hash input.
-    For example: client.find_user { |soap| soap.body = { :name => "Lucy", :id => 666, :@inorder => [:id, :name] } }
-  * Savon::Response#to_hash now returns the content inside of "soap:Body" instead of trying to go one level
-    deeper and return it's content. The previous implementation only worked when the "soap:Body" element
-    contained a single child. See: http://github.com/rubiii/savon/issues#issue/17
-  * Added Savon::SOAP#namespace as a shortcut for setting the "xmlns:wsdl" namespace.
-    Usage example: soap.namespace = "http://example.com"
-
-== 0.6.8 (2010-01-01)
-  * Improved specifications for various kinds of WSDL documents.
-  * Added support for SOAP endpoints which are different than the WSDL endpoint of a service.
-  * Changed how SOAP actions and inputs are retrieved from the WSDL documents. This might break a few existing
-    implementations, but makes Savon work well with even more services. If this change breaks your implementation,
-    please take a look at the +action+ and +input+ methods of the Savon::SOAP object.
-    One specific problem I know of is working with the createsend WSDL and its namespaced actions.
-    To make it work, call the SOAP action without namespace and specify the input manually:
-    client.get_api_key { |soap| soap.input = "User.GetApiKey" }
-
-== 0.6.7 (2009-12-18)
-  * Implemented support for a proxy server. The proxy URI can be set through an optional Hash of options passed
-    to instantiating Savon::Client (Dave Woodward <dave@futuremint.com>)
-  * Implemented support for SSL client authentication. Settings can be set through an optional Hash of arguments
-    passed to instantiating Savon::Client (colonhyphenp)
-  * Patch for issue #10 (Problem with operation tags without a namespace).
-
-== 0.6.6 (2009-12-14)
-  * Default to use the name of the SOAP action (the method called in a client) in lowerCamelCase for SOAP action
-    and input when Savon::WSDL is disabled. You still need to specify soap.action and maybe soap.input in case
-    your SOAP actions are named any different.
-
-== 0.6.5 (2009-12-13)
-  * Added an open_timeout method to Savon::Request.
-
-== 0.6.4 (2009-12-13)
-  * Refactored specs to be less unit-like.
-  * Added a getter for the Savon::Request to Savon::Client and a read_timeout setter for HTTP requests.
-  * wsdl.soap_actions now returns an Array of SOAP actions. For the previous "mapping" please use wsdl.operations.
-  * Replaced WSDL document with stream parsing.
-
-    Benchmarks (1000 SOAP calls):
-
-           user        system     total       real
-    0.6.4  72.180000   8.280000   80.460000   (750.799011)
-    0.6.3  192.900000  19.630000  212.530000  (914.031865)
-
-== 0.6.3 (2009-12-11)
-  * Removing 2 ruby deprecation warnings for parenthesized arguments. (Dave Woodward <dave@futuremint.com>)
-  * Added global and per request options for disabling Savon::WSDL.
-
-    Benchmarks (1000 SOAP calls):
-
-                   user        system     total       real
-    WSDL           192.900000  19.630000  212.530000  (914.031865)
-    disabled WSDL  5.680000    1.340000   7.020000    (298.265318)
-
-  * Improved XPath expressions for parsing the WSDL document.
-
-    Benchmarks (1000 SOAP calls):
-
-           user        system     total       real
-    0.6.3  192.900000  19.630000  212.530000  (914.031865)
-    0.6.2  574.720000  78.380000  653.100000  (1387.778539)
-
-== 0.6.2 (2009-12-06)
-  * Added support for changing the name of the SOAP input node.
-  * Added a CHANGELOG.
-
-== 0.6.1 (2009-12-06)
-  * Fixed a problem with WSSE credentials, where every request contained a WSSE authentication header.
-
-== 0.6.0 (2009-12-06)
-  * method_missing now yields the SOAP and WSSE objects to a given block.
-  * The response_process (which previously was a block passed to method_missing) was replaced by Savon::Response.
-  * Improved SOAP action handling (another problem that came up with issue #1).
-
-== 0.5.3 (2009-11-30)
-  * Patch for issue #2 (NoMethodError: undefined method `invalid!' for Savon::WSDL)
-
-== 0.5.2 (2009-11-30)
-  * Patch for issue #1 (Calls fail if api methods have periods in them)
-
-== 0.5.1 (2009-11-29)
-  * Optimized default response process.
-  * Added WSSE settings via defaults.
-  * Added SOAP fault and HTTP error handling.
-  * Improved documentation
-  * Added specs
-
-== 0.5.0 (2009-11-29)
-  * Complete rewrite.

data/README.rdoc

@@ -1,64 +0,0 @@
-= Savon
-
-==== Heavy metal Ruby SOAP client library
-
-{Documentation}[http://savon.rubiii.com] | {Metrics}[http://getcaliper.com/caliper/project?repo=git://github.com/rubiii/savon.git]
-
-== Installation
-
-  $ gem install savon
-
-Savon expects you to be familiar with SOAP, WSDL and tools like soapUI.
-
-== Instantiate a client
-
-Instantiate Savon::Client, passing in the WSDL of your service.
-
-  client = Savon::Client.new "http://example.com/UserService?wsdl"
-
-For production, it is highly recommended to not use Savon::WSDL. Information on {how to disable the WSDL}[http://savon.rubiii.com/docs/latest/classes/Savon/WSDL.html].
-
-== Calling a SOAP action
-
-Assuming your service applies to the defaults, you can now call any available SOAP action.
-
-  response = client.get_all_users
-
-Savon lets you call SOAP actions using snake_case, because even though they will propably be written in lowerCamelCase or CamelCase, it just feels much more natural.
-
-== The WSDL object
-
-Savon::WSDL represents the WSDL of your service, including information like the namespace URI and available SOAP actions.
-
-  client.wsdl.soap_actions
-  => [:get_all_users, :get_user_by_id, :user_magic]
-
-== The SOAP object
-
-Savon::SOAP represents the SOAP request. Pass a block to your SOAP call and the SOAP object is passed to it as the first argument. The object allows setting the SOAP version, header, body and namespaces per request.
-
-  response = client.get_user_by_id { |soap| soap.body = { :id => 666 } }
-
-== The WSSE object
-
-Savon::WSSE represents WSSE authentication. Pass a block to your SOAP call and the WSSE object is passed to it as the second argument. The object allows setting the WSSE username, password and whether to use digest authentication.
-
-  response = client.get_user_by_id do |soap, wsse|
-    wsse.username = "gorilla"
-    wsse.password = "secret"
-    soap.body = { :id => 666 }
-  end
-
-== The Response object
-
-Savon::Response represents the HTTP and SOAP response. It contains and raises errors in case of an HTTP error or SOAP fault (unless disabled). Also you can get the response as XML (for parsing it with an XML library) or translated into a Hash.
-
-== HTTP errors and SOAP faults
-
-Savon raises a Savon::SOAPFault in case of a SOAP fault and a Savon::HTTPError in case of an HTTP error.
-More information: {Errors}[http://savon.rubiii.com/docs/latest/classes/Savon/Response.html]
-
-== Logging
-
-Savon logs each request and response to STDOUT. But there are a couple of options to change the default behavior.
-More information: {Logging}[http://savon.rubiii.com/docs/latest/classes/Savon/Request.html]

data/lib/savon/core_ext.rb

@@ -1,8 +0,0 @@
-require "savon/core_ext/object"
-require "savon/core_ext/string"
-require "savon/core_ext/symbol"
-require "savon/core_ext/datetime"
-require "savon/core_ext/array"
-require "savon/core_ext/hash"
-require "savon/core_ext/uri"
-require "savon/core_ext/net_http"

data/lib/savon/core_ext/net_http.rb

@@ -1,19 +0,0 @@
-module Net
-  class HTTP
-
-    # Sets the endpoint +address+ and +port+.
-    def endpoint(address, port)
-      @address, @port = address, port
-    end
-
-    # Convenience method for setting SSL client authentication through a Hash of +options+.
-    def ssl_client_auth(options)
-      self.use_ssl = true
-      self.cert = options[:cert] if options[:cert]
-      self.key = options[:key] if options[:key]
-      self.ca_file = options[:ca_file] if options[:ca_file]
-      self.verify_mode = options[:verify_mode] if options[:verify_mode]
-    end
-
-  end
-end

data/lib/savon/core_ext/uri.rb

@@ -1,10 +0,0 @@
-module URI
-  class Generic
-
-    # Returns whether the URI hints to SSL.
-    def ssl?
-      !@scheme ? nil : @scheme.starts_with?("https")
-    end
-
-  end
-end

data/lib/savon/logger.rb

@@ -1,56 +0,0 @@
-module Savon
-
-  # = Savon::Logger
-  #
-  # Savon::Logger can be mixed into classes to provide logging behavior.
-  #
-  # By default, the Logger mixin uses {Ruby's Logger}[http://ruby-doc.org/stdlib/libdoc/logger/rdoc/]
-  # from the standard library, a log level of :debug and is pointing to STDOUT.
-  module Logger
-
-    module ClassMethods
-
-      # Sets whether to log.
-      def log=(log)
-        @log = log
-      end
-
-      # Returns whether to log. Defaults to +true+.
-      def log?
-        @log != false
-      end
-
-      # Sets the logger.
-      def logger=(logger)
-        @logger = logger
-      end
-
-      # Returns the logger. Defaults to an instance of +Logger+ writing to STDOUT.
-      def logger
-        @logger ||= ::Logger.new STDOUT
-      end
-
-      # Sets the log level.
-      def log_level=(log_level)
-        @log_level = log_level
-      end
-
-      # Returns the log level. Defaults to +debug+.
-      def log_level
-        @log_level ||= :debug
-      end
-
-    end
-
-    # Extends the class including this module with its ClassMethods.
-    def self.included(base)
-      base.extend ClassMethods
-    end
-
-    # Logs a given +message+.
-    def log(message)
-      self.class.logger.send self.class.log_level, message if self.class.log?
-    end
-
-  end
-end

data/lib/savon/request.rb

@@ -1,138 +0,0 @@
-module Savon
-
-  # = Savon::Request
-  #
-  # Savon::Request handles both WSDL and SOAP requests.
-  #
-  # == The Net::HTTP object
-  #
-  # You can access the Net::HTTP object used for both WSDL and SOAP requests via:
-  #
-  #   client.request.http
-  #
-  # Here's an example of how to set open and read timeouts on the Net::HTTP object.
-  #
-  #   client.request.http.open_timeout = 30
-  #   client.request.http.read_timeout = 30
-  #
-  # Please refer to the {Net::HTTP documentation}[http://ruby-doc.org/stdlib/libdoc/net/http/rdoc/]
-  # for more information.
-  #
-  # == HTTP basic authentication
-  #
-  # Setting credentials for HTTP basic authentication:
-  #
-  #   client.request.basic_auth "username", "password"
-  #
-  # == SSL client authentication
-  #
-  # You can use the methods provided by Net::HTTP to set SSL client authentication or use a shortcut:
-  #
-  #   client.request.http.ssl_client_auth(
-  #     :cert => OpenSSL::X509::Certificate.new(File.read("client_cert.pem")),
-  #     :key => OpenSSL::PKey::RSA.new(File.read("client_key.pem"), "password if one exists"),
-  #     :ca_file => "cacert.pem",
-  #     :verify_mode => OpenSSL::SSL::VERIFY_PEER
-  #   )
-  #
-  # == HTTP headers
-  #
-  # There's an accessor for the Hash of HTTP headers sent with any SOAP call:
-  #
-  #   client.request.headers["custom"] = "header"
-  class Request
-    include Logger
-
-    # Content-Types by SOAP version.
-    ContentType = { 1 => "text/xml;charset=UTF-8", 2 => "application/soap+xml;charset=UTF-8" }
-
-    # Expects a WSDL or SOAP +endpoint+ and accepts a custom +proxy+ address.
-    def initialize(endpoint, options = {})
-      @endpoint = URI endpoint
-      @proxy = URI options[:proxy] || ""
-      headers["Accept-encoding"] = "gzip,deflate" if options[:gzip]
-    end
-
-    # Returns the endpoint URI.
-    attr_reader :endpoint
-
-    # Returns the proxy URI.
-    attr_reader :proxy
-
-    # Returns the HTTP headers for a SOAP request.
-    def headers
-      @headers ||= {}
-    end
-
-    # Sets the HTTP headers for a SOAP request.
-    def headers=(headers)
-      @headers = headers if headers.kind_of? Hash
-    end
-
-    # Sets the +username+ and +password+ for HTTP basic authentication.
-    def basic_auth(username, password)
-      @basic_auth = [username, password]
-    end
-
-    # Retrieves WSDL document and returns the Net::HTTP response.
-    def wsdl
-      log "Retrieving WSDL from: #{@endpoint}"
-      http.endpoint @endpoint.host, @endpoint.port
-      http.use_ssl = @endpoint.ssl?
-      http.start { |h| h.request request(:wsdl) }
-    end
-
-    # Executes a SOAP request using a given Savon::SOAP instance and returns the Net::HTTP response.
-    def soap(soap)
-      @soap = soap
-      http.endpoint @soap.endpoint.host, @soap.endpoint.port
-      http.use_ssl = @soap.endpoint.ssl?
-
-      log_request
-      @response = http.start do |h|
-        h.request request(:soap) { |request| request.body = @soap.to_xml }
-      end
-      log_response
-      @response
-    end
-
-    # Returns the Net::HTTP object.
-    def http
-      @http ||= Net::HTTP::Proxy(@proxy.host, @proxy.port).new @endpoint.host, @endpoint.port
-    end
-
-  private
-
-    # Logs the SOAP request.
-    def log_request
-      log "SOAP request: #{@soap.endpoint}"
-      log soap_headers.merge(headers).map { |key, value| "#{key}: #{value}" }.join(", ")
-      log @soap.to_xml
-    end
-
-    # Logs the SOAP response.
-    def log_response
-      log "SOAP response (status #{@response.code}):"
-      log @response.body
-    end
-
-    # Returns a Net::HTTP request for a given +type+. Yields the request to an optional block.
-    def request(type)
-      request = case type
-        when :wsdl then Net::HTTP::Get.new @endpoint.request_uri
-        when :soap then Net::HTTP::Post.new @soap.endpoint.request_uri, soap_headers.merge(headers)
-      end
-
-      request.basic_auth(*@basic_auth) if @basic_auth
-      yield request if block_given?
-      request
-    end
-
-    # Returns a Hash containing the SOAP headers for an HTTP request.
-    def soap_headers
-      { "Content-Type" => ContentType[@soap.version], "SOAPAction" => @soap.action }
-    end
-
-  end
-end
-