savon 0.6.0 → 0.6.1

data/README.textile

@@ -15,15 +15,15 @@ p. To use this heavy metal library, you should be familiar with SOAP, WSDL and t
 
 h2. Instantiate Savon::Client
 
-p. Instantiate a new instance of Savon::Client, passing in the WSDL of your service.
+p. Instantiate Savon::Client, passing in the WSDL of your service.
 
-bc. proxy = Savon::Client.new "http://example.com/UserService?wsdl"
+bc. client = Savon::Client.new "http://example.com/UserService?wsdl"
 
 h2. The WSDL
 
 p. You can find out about the SOAP actions available on the webservice by using the WSDL object.
 
-bc. proxy.wsdl.soap_actions
+bc. client.wsdl.soap_actions.keys
 => [:get_all_users, :get_user_by_id, :user_magic]
 
 p. Find out more about the "WSDL":http://wiki.github.com/rubiii/savon/wsdl object.
@@ -32,24 +32,33 @@ h2. Calling a SOAP action
 
 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.
 
-bc. response = proxy.get_all_users
+bc. response = client.get_all_users
 
 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. Parameters
+h2. The SOAP object
 
-p. Specifying parameters for the SOAP service, can be done by simply passing a Hash to the SOAP action.
+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.
 
-bc. response = proxy.get_user_by_id :id => 666
+bc. response = client.get_user_by_id { |soap| soap.body = { :id => 666 } }
 
-p. Learn more about [[Parameters]].
+p. Learn more about the "SOAP":http://wiki.github.com/rubiii/savon/soap object.
 
-h2. The response
+h2. The WSSE object
+
+p. Pass a block to the SOAP request which expects two variables and Savon will yield the SOAP and WSSE objects.
+
+bc. response = client.get_user_by_id do |soap, wsse|
+  wsse.username = "gorilla"
+  wsse.password = "secret"
+  soap.body = { :id => 666 }
+end
 
-p. By default, the SOAP response is translated into a Hash. Take a look at the "Options":http://wiki.github.com/rubiii/savon/options for more information.
+p. Learn more about the "WSSE":http://wiki.github.com/rubiii/savon/wsse object.
+
+h2. The response
 
-bc. proxy.get_user_by_id :id => 666
-=> { :user_response => { :id => "666", :username => "gorilla" } }
+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.
 
 h2. HTTP errors and SOAP faults
 

data/VERSION

@@ -1 +1 @@
-0.6.0
+0.6.1

data/lib/savon/wsse.rb

@@ -12,10 +12,10 @@ module Savon
     WSUNamespace = "http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
 
     # Default WSSE username.
-    @username = ""
+    @username = nil
 
     # Default WSSE password.
-    @password = ""
+    @password = nil
 
     # Default for whether to use WSSE digest.
     @digest = false
@@ -28,6 +28,7 @@ module Savon
       # Sets the default WSSE username.
       def username=(username)
         @username = username.to_s if username.respond_to? :to_s
+        @username = nil if username.nil?
       end
 
       # Returns the default WSSE password.
@@ -36,6 +37,7 @@ module Savon
       # Sets the default WSSE password.
       def password=(password)
         @password = password.to_s if password.respond_to? :to_s
+        @password = nil if password.nil?
       end
 
       # Sets whether to use WSSE digest by default.
@@ -51,6 +53,7 @@ module Savon
     # Sets the WSSE username.
     def username=(username)
       @username = username.to_s if username.respond_to? :to_s
+      @username = nil if username.nil?
     end
 
     # Returns the WSSE username. Defaults to the global default.
@@ -61,6 +64,7 @@ module Savon
     # Sets the WSSE password.
     def password=(password)
       @password = password.to_s if password.respond_to? :to_s
+      @password = nil if password.nil?
     end
 
     # Returns the WSSE password. Defaults to the global default.

data/spec/savon/wsse_spec.rb

@@ -2,9 +2,12 @@ require "spec_helper"
 
 describe Savon::WSSE do
   before do
+    Savon::WSSE.username = nil
+    Savon::WSSE.password = nil
+    Savon::WSSE.digest = false
+
     @wsse = Savon::WSSE.new
-    @username = "gorilla"
-    @password = "secret"
+    @username, @password = "gorilla", "secret"
   end
 
   describe "WSENamespace" do
@@ -22,28 +25,24 @@ describe Savon::WSSE do
   end
 
   describe "@username" do
-    it "defaults to an empty String" do
-      Savon::WSSE.username.should be_a String
-      Savon::WSSE.username.should be_empty
+    it "defaults to nil" do
+      Savon::WSSE.username.should be_nil
     end
 
     it "has accessor methods" do
       Savon::WSSE.username = "gorilla"
       Savon::WSSE.username.should == "gorilla"
-      Savon::WSSE.username = ""
     end
   end
 
   describe "@password" do
-    it "defaults to an empty String" do
-      Savon::WSSE.password.should be_a String
-      Savon::WSSE.password.should be_empty
+    it "defaults to nil" do
+      Savon::WSSE.password.should be_nil
     end
 
     it "has accessor methods" do
       Savon::WSSE.password = "secret"
       Savon::WSSE.password.should == "secret"
-      Savon::WSSE.password = ""
     end
   end
 
@@ -55,33 +54,28 @@ describe Savon::WSSE do
     it "has accessor methods" do
       Savon::WSSE.digest = true
       Savon::WSSE.digest?.should == true
-      Savon::WSSE.digest = false
     end
   end
 
   describe "username" do
-    it "defaults to an empty String" do
-      @wsse.username.should be_a String
-      @wsse.username.should be_empty
+    it "defaults to nil" do
+      @wsse.username.should be_nil
     end
 
     it "has accessor methods" do
       @wsse.username = "gorilla"
       @wsse.username.should == "gorilla"
-      @wsse.username = nil
     end
   end
 
   describe "password" do
-    it "defaults to an empty String" do
-      @wsse.password.should be_a String
-      @wsse.password.should be_empty
+    it "defaults to nil" do
+      @wsse.password.should be_nil
     end
 
     it "has accessor methods" do
       @wsse.password = "secret"
       @wsse.password.should == "secret"
-      @wsse.password = nil
     end
   end
 
@@ -93,7 +87,6 @@ describe Savon::WSSE do
     it "has accessor methods" do
       @wsse.digest = true
       @wsse.digest?.should == true
-      @wsse.digest = false
     end
   end
 
@@ -117,9 +110,6 @@ describe Savon::WSSE do
         header.should include_security_namespaces
         header.should include @username
         header.should include @password
-
-        Savon::WSSE.username = ""
-        Savon::WSSE.password = ""
       end
     end
 
@@ -155,4 +145,4 @@ describe Savon::WSSE do
     end
   end
 
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: savon
 version: !ruby/object:Gem::Version 
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors: 
 - Daniel Harrington