savon 0.6.1 → 0.6.2

data/CHANGELOG

@@ -0,0 +1,33 @@
+== 0.6.2 (2009-12-06)
+* 1 minor improvement
+  * Support for changing the name of the SOAP input node.
+  * Added a CHANGELOG.
+
+== 0.6.1 (2009-12-06)
+* 1 minor patch
+  * Fixed a problem with WSSE credentials, where every request contained a WSSE authentication header.
+
+== 0.6.0 (2009-12-06)
+* 3 major improvements
+  * 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 the Savon::Response object.
+  * Improved SOAP action handling (another problem that came up with Issue #1).
+
+== 0.5.3 (2009-11-30)
+* 1 minor patch
+  * Fix for Issue #2 (NoMethodError: undefined method `invalid!' for Savon::WSDL)
+
+== 0.5.2 (2009-11-30)
+* 1 minor patch
+  * Patch for Issue #1 (Calls fail if api methods have periods in them)
+
+== 0.5.1 (2009-11-29)
+* 3 improvements
+  * Optimized default response process.
+  * Added WSSE settings via defaults.
+  * Added SOAP fault and HTTP error handling.
+  * Documentation
+  * Specs
+
+== 0.5.0 (2009-11-29)
+* Complete rewrite.

data/README.textile

@@ -1,52 +1,45 @@
-h2. Savon
+h1. Savon
 
-p. Savon can be installed as a gem via:
+h4. Heavy metal Ruby SOAP client library
 
 bc. $ gem install savon
 
-h4. Dependencies
+p. Savon expects you to be familiar with SOAP, WSDL and tools like soapUI.
 
-bc. builder >= 2.1.2
-crack >= 0.1.4
-
-h2. Warning
-
-p. To use this heavy metal library, you should be familiar with SOAP, WSDL and tools like soapUI.
-
-h2. Instantiate Savon::Client
+h3. Instantiate a client
 
 p. Instantiate Savon::Client, passing in the WSDL of your service.
 
 bc. client = Savon::Client.new "http://example.com/UserService?wsdl"
 
-h2. The WSDL
+h3. Calling a SOAP action
 
-p. You can find out about the SOAP actions available on the webservice by using the WSDL object.
+p. Assuming your service applies to the "Defaults":http://wiki.github.com/rubiii/savon/defaults, you can now call any available SOAP action.
 
-bc. client.wsdl.soap_actions.keys
-=> [:get_all_users, :get_user_by_id, :user_magic]
+bc. response = client.get_all_users
 
-p. Find out more about the "WSDL":http://wiki.github.com/rubiii/savon/wsdl object.
+p. 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.
 
-h2. Calling a SOAP action
+h3. The WSDL object
 
-p. Now, assuming your service applies to the default "Options":http://wiki.github.com/rubiii/savon/options, you can just call any available SOAP action.
+p. Savon::WSDL represents the WSDL of your service, including information like the namespace URI and available SOAP actions.
 
-bc. response = client.get_all_users
+bc. client.wsdl.soap_actions.keys
+=> [:get_all_users, :get_user_by_id, :user_magic]
 
-p. 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.
+p. More information: "WSDL":http://wiki.github.com/rubiii/savon/wsdl
 
-h2. The SOAP object
+h3. The SOAP object
 
-p. Pass a block to the SOAP request which expects a single variable and Savon will hand you the SOAP object to specify various SOAP-related options.
+p. 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.
 
 bc. response = client.get_user_by_id { |soap| soap.body = { :id => 666 } }
 
-p. Learn more about the "SOAP":http://wiki.github.com/rubiii/savon/soap object.
+p. More information: "SOAP":http://wiki.github.com/rubiii/savon/soap
 
-h2. The WSSE object
+h3. The WSSE object
 
-p. Pass a block to the SOAP request which expects two variables and Savon will yield the SOAP and WSSE objects.
+p. 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.
 
 bc. response = client.get_user_by_id do |soap, wsse|
   wsse.username = "gorilla"
@@ -54,24 +47,24 @@ bc. response = client.get_user_by_id do |soap, wsse|
   soap.body = { :id => 666 }
 end
 
-p. Learn more about the "WSSE":http://wiki.github.com/rubiii/savon/wsse object.
-
-h2. The response
-
-p. The response is wrapped in an object to give you various options of handling it. Take a look at the "Response":http://wiki.github.com/rubiii/savon/response for more information.
+p. More information: "WSSE":http://wiki.github.com/rubiii/savon/wsse
 
-h2. HTTP errors and SOAP faults
+h3. The Response object
 
-p. Savon raises a Savon::SOAPFault in case of a SOAP fault and a Savon::HTTPError in case of an HTTP error. More information about "Errors":http://wiki.github.com/rubiii/savon/errors.
+p. 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.
+More information: "Response":http://wiki.github.com/rubiii/savon/response
 
-h2. Logging
+h3. HTTP errors and SOAP faults
 
-p. By default Savon logs each request and response to STDOUT. Specifying your own logger is as easy as it gets:
+p. 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://wiki.github.com/rubiii/savon/errors
 
-bc. Savon::Request.logger = RAILS_DEFAULT_LOGGER
+h3. Logging
 
-Read more about "Logging":http://wiki.github.com/rubiii/savon/logging.
+p. Savon logs each request and response to STDOUT. But there are a couple of options to change the default behaviour.
+More information: "Logging":http://wiki.github.com/rubiii/savon/logging
 
-h2. RDoc and Wiki
+h3. Documentation
 
-p. Further information: "Wiki":http://wiki.github.com/rubiii/savon and "RDoc":http://rdoc.info/projects/rubiii/savon
+p. Wiki: "wiki.github.com/rubiii/savon":http://wiki.github.com/rubiii/savon
+RDoc: "rdoc.info/projects/rubiii/savon":http://rdoc.info/projects/rubiii/savon

data/VERSION

@@ -1 +1 @@
-0.6.1
+0.6.2

data/lib/savon/soap.rb

@@ -41,6 +41,9 @@ module Savon
     # Accessor for the SOAP action.
     attr_accessor :action
 
+    # Accessor for the SOAP input.
+    attr_writer :input
+
     # Sets the SOAP header. Expected to be a Hash that can be translated
     # to XML via Hash.to_soap_xml or any other Object responding to to_s.
     attr_writer :header

data/spec/savon/soap_spec.rb

@@ -60,6 +60,12 @@ describe Savon::SOAP do
     end
   end
 
+  describe "input" do
+    it "sets the name of the SOAP input node" do
+      @soap.input = "FindUserRequest"
+    end
+  end
+
   describe "header" do
     it "is an accessor for the SOAP header" do
       @soap.header.should be_a Hash
@@ -137,4 +143,4 @@ describe Savon::SOAP do
     end
   end
 
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: savon
 version: !ruby/object:Gem::Version 
-  version: 0.6.1
+  version: 0.6.2
 platform: ruby
 authors: 
 - Daniel Harrington
@@ -71,6 +71,7 @@ extensions: []
 extra_rdoc_files: 
 - README.textile
 files: 
+- CHANGELOG
 - README.textile
 - Rakefile
 - VERSION