waz-storage 1.3.1 → 1.3.2

data/lib/waz/storage/base.rb

@@ -1,70 +1,70 @@
-module WAZ
-	module Storage
-    # This class is used to handle a general connection with Windows Azure Storage Account and it 
-    # should be used at least once on the application bootstrap or configuration file.
-    # 
-    # The usage is pretty simple as it's depicted on the following sample
-    #  WAZ::Storage::establish_connection!(:account_name => "my_account_name", 
-    #                                      :access_key => "your_base64_key", 
-    #                                      :use_ssl => false)
-    #
-		class Base
-			class << self
-				# Sets the basic configuration parameters to use the API on the current context
-				# required parameters are :account_name, :access_key. 
-        #
-				# All other parameters are optional.
-				def establish_connection!(options = {})
-					raise InvalidOption, :account_name unless options.keys.include? :account_name 
-					raise InvalidOption, :access_key if !options.keys.include? :use_sas_auth_only unless options.keys.include? :access_key 
-  				        raise InvalidOption, :use_sas_auth_only if !options.keys.include? :access_key unless options.keys.include? :use_sas_auth_only 
- 					raise InvalidOption, :sharedaccesssignature if !options.keys.include? :access_key unless options.keys.include? :sharedaccesssignature and options.keys.include? :use_sas_auth_only
-  				        options[:use_ssl] = false unless options.keys.include? :use_ssl
-					(@connections ||= []) << options
-				end
-				
-        # Block Syntax
-        #
-        #  Pushes the named repository onto the context-stack,
-        #  yields a new session, and pops the context-stack.
-        #
-        #  This helps you set contextual operations like in the following sample
-        #  
-        #  Base.establish_connection(options) do
-        #   # do some operations on the given context
-        #  end
-        #  
-        #  The context is restored to the previous one (what you configured on establish_connection!)
-        #  or nil.
-        #
-        # Non-Block Syntax
-        #
-        #  Behaves exactly as establish_connection!
-				def establish_connection(options = {}) # :yields: current_context
-			    establish_connection!(options)
-			    if (block_given?)
-  				  begin 
-  				    return yield
-  				  ensure
-  				    @connections.pop() if connected?
-  				  end
-  				end
-				end
-				
-				# Returns the default connection (last set) parameters. It will raise an exception WAZ::Storage::NotConnected
-				# when there's no connection information registered.
-				def default_connection
-          raise NotConnected unless connected?
-					return @connections.last
-				end
-				
-				# Returns a value indicating whether the current connection information has been set or not.
-				def connected?
-					return false if (@connections.nil?)
-					return false if (@connections.empty?)
-					return true
-				end
-			end
-		end
-	end
-end
+module WAZ
+	module Storage
+    # This class is used to handle a general connection with Windows Azure Storage Account and it 
+    # should be used at least once on the application bootstrap or configuration file.
+    # 
+    # The usage is pretty simple as it's depicted on the following sample
+    #  WAZ::Storage::establish_connection!(:account_name => "my_account_name", 
+    #                                      :access_key => "your_base64_key", 
+    #                                      :use_ssl => false)
+    #
+		class Base
+			class << self
+				# Sets the basic configuration parameters to use the API on the current context
+				# required parameters are :account_name, :access_key. 
+        #
+				# All other parameters are optional.
+				def establish_connection!(options = {})
+					raise InvalidOption, :account_name unless options.keys.include? :account_name 
+					raise InvalidOption, :access_key if !options.keys.include? :use_sas_auth_only unless options.keys.include? :access_key 
+  				        raise InvalidOption, :use_sas_auth_only if !options.keys.include? :access_key unless options.keys.include? :use_sas_auth_only 
+ 					raise InvalidOption, :sharedaccesssignature if !options.keys.include? :access_key unless options.keys.include? :sharedaccesssignature and options.keys.include? :use_sas_auth_only
+  				        options[:use_ssl] = false unless options.keys.include? :use_ssl
+					(@connections ||= []) << options
+				end
+				
+        # Block Syntax
+        #
+        #  Pushes the named repository onto the context-stack,
+        #  yields a new session, and pops the context-stack.
+        #
+        #  This helps you set contextual operations like in the following sample
+        #  
+        #  Base.establish_connection(options) do
+        #   # do some operations on the given context
+        #  end
+        #  
+        #  The context is restored to the previous one (what you configured on establish_connection!)
+        #  or nil.
+        #
+        # Non-Block Syntax
+        #
+        #  Behaves exactly as establish_connection!
+				def establish_connection(options = {}) # :yields: current_context
+			    establish_connection!(options)
+			    if (block_given?)
+  				  begin 
+  				    return yield
+  				  ensure
+  				    @connections.pop() if connected?
+  				  end
+  				end
+				end
+				
+				# Returns the default connection (last set) parameters. It will raise an exception WAZ::Storage::NotConnected
+				# when there's no connection information registered.
+				def default_connection
+          raise NotConnected unless connected?
+					return @connections.last
+				end
+				
+				# Returns a value indicating whether the current connection information has been set or not.
+				def connected?
+					return false if (@connections.nil?)
+					return false if (@connections.empty?)
+					return true
+				end
+			end
+		end
+	end
+end

data/lib/waz/storage/core_service.rb

@@ -113,7 +113,8 @@ module WAZ
       # Generates a Windows Azure Storage call, it internally calls url generation method
       # and the request generation message.
       def execute(verb, path, query = {}, headers = {}, payload = nil)
-		url = generate_request_uri(URI.encode(path), query)
+        escaped_path = path.split("/").map{ | part | CGI.escape(part) }.join("/")
+        url = generate_request_uri(escaped_path, query)
         request = generate_request(verb, url, headers, payload)
         request.execute()
       end

data/lib/waz/storage/exceptions.rb

@@ -1,33 +1,33 @@
-module WAZ
-  module Storage
-    # This class is the base exception from where all the exceptions raised from this API 
-    # inherit from. If you want to handle an exception that your code may throw and you don't
-    # know which specific type you should handle, handle this type of exception.
-    class StorageException < StandardError
-    end
-    
-    # This exception raises whenever a required parameter for initializing any class isn't provided. From
-    # WAZ::Storage::Base up to WAZ::Queues::Queue all of them use this exception.
-    class InvalidOption < StorageException
-      def initialize(missing_option)
-        super("You did not provide one of the required parameters. Please provide the #{missing_option}.")
-      end
-    end
-    
-    # This exception is raised when the user tries to perform an operation on any Storage API class
-    # without previously specificying the connection options.
-    class NotConnected < StorageException
-      def initialize
-        super("You should establish connection before using the services, the connection configuration is required.")
-      end
-    end
-    
-    # This exception if raised when the value given for an argument doesn't fall into the permitted values. For example
-    # if values on the blocklisttype aren't [all|uncommitted|committed]
-    class InvalidParameterValue < StorageException
-      def initialize(args = {})
-        super("The value supplied for the parameter #{args[:name]} is invalid. Permitted values are #{args[:values].join(',')}")
-      end
-    end
-  end
-end
+module WAZ
+  module Storage
+    # This class is the base exception from where all the exceptions raised from this API 
+    # inherit from. If you want to handle an exception that your code may throw and you don't
+    # know which specific type you should handle, handle this type of exception.
+    class StorageException < StandardError
+    end
+    
+    # This exception raises whenever a required parameter for initializing any class isn't provided. From
+    # WAZ::Storage::Base up to WAZ::Queues::Queue all of them use this exception.
+    class InvalidOption < StorageException
+      def initialize(missing_option)
+        super("You did not provide one of the required parameters. Please provide the #{missing_option}.")
+      end
+    end
+    
+    # This exception is raised when the user tries to perform an operation on any Storage API class
+    # without previously specificying the connection options.
+    class NotConnected < StorageException
+      def initialize
+        super("You should establish connection before using the services, the connection configuration is required.")
+      end
+    end
+    
+    # This exception if raised when the value given for an argument doesn't fall into the permitted values. For example
+    # if values on the blocklisttype aren't [all|uncommitted|committed]
+    class InvalidParameterValue < StorageException
+      def initialize(args = {})
+        super("The value supplied for the parameter #{args[:name]} is invalid. Permitted values are #{args[:values].join(',')}")
+      end
+    end
+  end
+end

data/lib/waz/storage/validation_rules.rb

@@ -1,26 +1,26 @@
-module WAZ
-  module Storage
-    class ValidationRules
-      class << self
-        # Validates that the Container/Queue name given matches with the requirements of Windows Azure. 
-        #
-        # -Container/Queue names must start with a letter or number, and can contain only letters, numbers, and the dash (-) character.
-        # -Every dash (-) character must be immediately preceded and followed by a letter or number.
-        # -All letters in a container name must be lowercase.
-        # -Container/Queue names must be from 3 through 63 characters long.
-        def valid_name?(name)
-          name =~ /^[a-z0-9][a-z0-9\-]{1,}[^-]$/ && name.length < 64
-        end
-
-        # Validates that the Table name given matches with the requirements of Windows Azure. 
-        #
-        # -Table names must start with at least one lower / upper character.
-        # -Table names can have character or any digit starting from the second position.
-        # -Table names must be from 3 through 63 characters long.
-        def valid_table_name?(name)
-          name =~ /^([a-z]|[A-Z]){1}([a-z]|[A-Z]|\d){2,62}$/
-        end
-      end
-    end
-  end
+module WAZ
+  module Storage
+    class ValidationRules
+      class << self
+        # Validates that the Container/Queue name given matches with the requirements of Windows Azure. 
+        #
+        # -Container/Queue names must start with a letter or number, and can contain only letters, numbers, and the dash (-) character.
+        # -Every dash (-) character must be immediately preceded and followed by a letter or number.
+        # -All letters in a container name must be lowercase.
+        # -Container/Queue names must be from 3 through 63 characters long.
+        def valid_name?(name)
+          name =~ /^[a-z0-9][a-z0-9\-]{1,}[^-]$/ && name.length < 64
+        end
+
+        # Validates that the Table name given matches with the requirements of Windows Azure. 
+        #
+        # -Table names must start with at least one lower / upper character.
+        # -Table names can have character or any digit starting from the second position.
+        # -Table names must be from 3 through 63 characters long.
+        def valid_table_name?(name)
+          name =~ /^([a-z]|[A-Z]){1}([a-z]|[A-Z]|\d){2,62}$/
+        end
+      end
+    end
+  end
 end

data/lib/waz/tables/edm_type_helper.rb

@@ -1,45 +1,45 @@
-module WAZ
-  module Tables
-    class EdmTypeHelper
-      class << self
-        def parse_from(item)
-          return nil if !item.attributes['m:null'].nil? and item.attributes['m:null'] == 'true'
-          case item.attributes['m:type']
-            when 'Edm.Int16', 'Edm.Int32', 'Edm.Int64'
-              item.text.to_i
-            when 'Edm.Single', 'Edm.Double'
-              item.text.to_f
-            when 'Edm.Boolean'
-              item.text == 'true'
-            when 'Edm.DateTime'
-              Time.parse(item.text)
-            when 'Edm.Binary'
-              StringIO.new(Base64.decode64(item.text))
-            else
-              item.text
-          end
-        end
-      
-        def parse_to(item)
-          case item.class.name
-            when 'String'
-              [item, 'Edm.String']
-            when 'Fixnum'
-              [item, 'Edm.Int32']
-            when 'Float'
-              [item, 'Edm.Double']
-            when 'TrueClass', 'FalseClass'          
-              [item, 'Edm.Boolean']
-            when 'Time'
-              [item.iso8601, 'Edm.DateTime']
-            when 'File', 'StringIO'
-              item.pos = 0
-              [Base64.encode64(item.read), 'Edm.Binary']
-            else
-              [item, 'Edm.String']
-          end
-        end
-      end
-    end
-  end
+module WAZ
+  module Tables
+    class EdmTypeHelper
+      class << self
+        def parse_from(item)
+          return nil if !item.attributes['m:null'].nil? and item.attributes['m:null'] == 'true'
+          case item.attributes['m:type']
+            when 'Edm.Int16', 'Edm.Int32', 'Edm.Int64'
+              item.text.to_i
+            when 'Edm.Single', 'Edm.Double'
+              item.text.to_f
+            when 'Edm.Boolean'
+              item.text == 'true'
+            when 'Edm.DateTime'
+              Time.parse(item.text)
+            when 'Edm.Binary'
+              StringIO.new(Base64.decode64(item.text))
+            else
+              item.text
+          end
+        end
+      
+        def parse_to(item)
+          case item.class.name
+            when 'String'
+              [item, 'Edm.String']
+            when 'Fixnum'
+              [item, 'Edm.Int32']
+            when 'Float'
+              [item, 'Edm.Double']
+            when 'TrueClass', 'FalseClass'          
+              [item, 'Edm.Boolean']
+            when 'Time'
+              [item.iso8601, 'Edm.DateTime']
+            when 'File', 'StringIO'
+              item.pos = 0
+              [Base64.encode64(item.read), 'Edm.Binary']
+            else
+              [item, 'Edm.String']
+          end
+        end
+      end
+    end
+  end
 end

data/lib/waz/tables/exceptions.rb

@@ -1,45 +1,45 @@
-module WAZ
-  module Tables
-    # This exception is raised while trying to create table that already exists.
-    class TableAlreadyExists < WAZ::Storage::StorageException
-      def initialize(name)
-        super("The table #{name} already exists on your account.")
-      end
-    end
-
-    # This exception is raised while trying to delete an unexisting table.    
-    class TableDoesNotExist < WAZ::Storage::StorageException
-      def initialize(name)
-        super("The specified table #{name} does not exist.")
-      end
-    end
-    
-    # This exception is raised when an invalid table name is provided.
-    class InvalidTableName < WAZ::Storage::StorageException
-      def initialize(name)
-        super("The table name #{name} is invalid, it must start with at least one lower/upper characted, must be from 3 through 63 characters long and can have character or any digit starting from the second position")
-      end
-    end
-    
-    # This exception is raised when provided more than the 252 properties allowed by the Rest API.
-    class TooManyProperties < WAZ::Storage::StorageException
-      def initialize(total)
-        super("The entity contains more properties than allowed (252). The entity has #{total} properties.")
-      end
-    end
-
-    # This exception is raised when the specified entity already exists.
-    class EntityAlreadyExists < WAZ::Storage::StorageException
-      def initialize(row_key)
-        super("The specified entity already exists. RowKey: #{row_key}")
-      end
-    end
-    
-    # This exception is raised while trying to delete an unexisting entity.    
-    class EntityDoesNotExist < WAZ::Storage::StorageException
-      def initialize(key)
-        super("The specified entity with #{key} does not exist.")
-      end
-    end
-  end
+module WAZ
+  module Tables
+    # This exception is raised while trying to create table that already exists.
+    class TableAlreadyExists < WAZ::Storage::StorageException
+      def initialize(name)
+        super("The table #{name} already exists on your account.")
+      end
+    end
+
+    # This exception is raised while trying to delete an unexisting table.    
+    class TableDoesNotExist < WAZ::Storage::StorageException
+      def initialize(name)
+        super("The specified table #{name} does not exist.")
+      end
+    end
+    
+    # This exception is raised when an invalid table name is provided.
+    class InvalidTableName < WAZ::Storage::StorageException
+      def initialize(name)
+        super("The table name #{name} is invalid, it must start with at least one lower/upper characted, must be from 3 through 63 characters long and can have character or any digit starting from the second position")
+      end
+    end
+    
+    # This exception is raised when provided more than the 252 properties allowed by the Rest API.
+    class TooManyProperties < WAZ::Storage::StorageException
+      def initialize(total)
+        super("The entity contains more properties than allowed (252). The entity has #{total} properties.")
+      end
+    end
+
+    # This exception is raised when the specified entity already exists.
+    class EntityAlreadyExists < WAZ::Storage::StorageException
+      def initialize(row_key)
+        super("The specified entity already exists. RowKey: #{row_key}")
+      end
+    end
+    
+    # This exception is raised while trying to delete an unexisting entity.    
+    class EntityDoesNotExist < WAZ::Storage::StorageException
+      def initialize(key)
+        super("The specified entity with #{key} does not exist.")
+      end
+    end
+  end
 end