azure-storage 0.10.0.preview

data/lib/azure/storage/blob/page.rb

@@ -0,0 +1,380 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require 'azure/storage/blob/blob'
+
+module Azure::Storage
+  module Blob
+    # Public: Creates a new page blob. Note that calling create_page_blob to create a page
+    # blob only initializes the blob. To add content to a page blob, call put_blob_pages method.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +length+                     - Integer. Specifies the maximum size for the page blob, up to 1 TB. 
+    #                                  The page blob size must be aligned to a 512-byte boundary.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:transactional_md5+         - String. An MD5 hash of the blob content. This hash is used to verify the integrity of the blob during transport. 
+    #                                  When this header is specified, the storage service checks the hash that has arrived with the one that was sent. 
+    #                                  If the two hashes do not match, the operation will fail with error code 400 (Bad Request).
+    # * +:content_type+              - String. Content type for the blob. Will be saved with blob.
+    # * +:content_encoding+          - String. Content encoding for the blob. Will be saved with blob.
+    # * +:content_language+          - String. Content language for the blob. Will be saved with blob.
+    # * +:content_md5+               - String. Content MD5 for the blob. Will be saved with blob.
+    # * +:cache_control+             - String. Cache control for the blob. Will be saved with blob.
+    # * +:content_disposition+       - String. Conveys additional information about how to process the response payload, 
+    #                                  and also can be used to attach additional metadata
+    # * +:metadata+                  - Hash. Custom metadata values to store with the blob.
+    # * +:sequence_number+           - Integer. The sequence number is a user-controlled value that you can use to track requests. 
+    #                                  The value of the sequence number must be between 0 and 2^63 - 1.The default value is 0.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to create a new blob 
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to create a new blob 
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to create a new blob 
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to create a new blob 
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179451.aspx
+    #
+    # Returns a Blob
+    def create_page_blob(container, blob, length, options={})
+      query = { }
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = StorageService.service_properties_headers
+
+      # set x-ms-blob-type to PageBlob
+      StorageService.with_header headers, 'x-ms-blob-type', 'PageBlob'
+
+      # ensure content-length is 0 and x-ms-blob-content-length is the blob length
+      StorageService.with_header headers, 'Content-Length', 0.to_s
+      StorageService.with_header headers, 'x-ms-blob-content-length', length.to_s
+
+      # set x-ms-sequence-number from options (or default to 0)
+      StorageService.with_header headers, 'x-ms-sequence-number', (options[:sequence_number] || 0).to_s
+
+      # set the rest of the optional headers
+      StorageService.with_header headers, 'Content-MD5', options[:transactional_md5]
+      StorageService.with_header headers, 'x-ms-blob-content-type', options[:content_type]
+      StorageService.with_header headers, 'x-ms-blob-content-encoding', options[:content_encoding]
+      StorageService.with_header headers, 'x-ms-blob-content-language', options[:content_language]
+      StorageService.with_header headers, 'x-ms-blob-content-md5', options[:content_md5]
+      StorageService.with_header headers, 'x-ms-blob-cache-control', options[:cache_control]
+      StorageService.with_header headers, 'x-ms-blob-content-disposition', options[:content_disposition]
+
+      StorageService.add_metadata_to_headers options[:metadata], headers
+      add_blob_conditional_headers options, headers
+
+      # call PutBlob with empty body
+      response = call(:put, uri, nil, headers)
+
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob
+
+      result
+    end
+    
+    # Public: Creates a range of pages in a page blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. Name of container
+    # * +blob+                       - String. Name of blob
+    # * +start_range+                - Integer. Position of first byte of first page
+    # * +end_range+                  - Integer. Position of last byte of of last page
+    # * +content+                    - IO or String. Content to write. Length in bytes should equal end_range - start_range
+    # * +options+                    - Hash. A collection of options.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:if_sequence_number_le+     - Integer. If the blob's sequence number is less than or equal to the specified value, the request proceeds; 
+    #                                  otherwise it fails with the SequenceNumberConditionNotMet error (HTTP status code 412 - Precondition Failed).
+    # * +:if_sequence_number_lt+     - Integer. If the blob's sequence number is less than the specified value, the request proceeds; 
+    #                                  otherwise it fails with SequenceNumberConditionNotMet error (HTTP status code 412 - Precondition Failed).
+    # * +:if_sequence_number_eq+     - Integer. If the blob's sequence number is equal to the specified value, the request proceeds; 
+    #                                  otherwise it fails with SequenceNumberConditionNotMet error (HTTP status code 412 - Precondition Failed).
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to write the page only if 
+    #                                  the blob has been modified since the specified date/time. If the blob has not been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to write the page only if 
+    #                                  the blob has not been modified since the specified date/time. If the blob has been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to write the page only if 
+    #                                  the blob's ETag value matches the value specified. If the values do not match, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to write the page only if 
+    #                                  the blob's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # 
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691975.aspx
+    #
+    # Returns Blob
+    def put_blob_pages(container, blob, start_range, end_range, content, options={})
+      query = { 'comp' => 'page' }
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+      headers = StorageService.service_properties_headers
+      StorageService.with_header headers, 'x-ms-range', "bytes=#{start_range}-#{end_range}"
+      StorageService.with_header headers, 'x-ms-page-write', 'update'
+
+      # clear default content type
+      StorageService.with_header headers, 'Content-Type', ''
+
+      # set optional headers
+      unless options.empty?
+        add_blob_conditional_headers options, headers
+      end
+
+      response = call(:put, uri, content, headers)
+
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob
+
+      result
+    end
+
+    # Public: Clears a range of pages from the blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. Name of container.
+    # * +blob+                       - String. Name of blob.
+    # * +start_range+                - Integer. Position of first byte of first page.
+    # * +end_range+                  - Integer. Position of last byte of of last page.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to clear the page only if 
+    #                                  the blob has been modified since the specified date/time. If the blob has not been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to clear the page only if 
+    #                                  the blob has not been modified since the specified date/time. If the blob has been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to clear the page only if 
+    #                                  the blob's ETag value matches the value specified. If the values do not match, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to clear the page only if 
+    #                                  the blob's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691975.aspx
+    #
+    # Returns Blob
+    def clear_blob_pages(container, blob, start_range, end_range, options={})
+      query = { 'comp' => 'page' }
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = StorageService.service_properties_headers
+      StorageService.with_header headers, 'x-ms-range', "bytes=#{start_range}-#{end_range}"
+      StorageService.with_header headers, 'x-ms-page-write', 'clear'
+
+      # clear default content type
+      StorageService.with_header headers, 'Content-Type', ''
+      
+      # set optional headers
+      unless options.empty?
+        add_blob_conditional_headers options, headers
+      end
+
+      response = call(:put, uri, nil, headers)
+
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob
+
+      result
+    end
+    
+    # Public: Returns a list of active page ranges for a page blob. Active page ranges are
+    # those that have been populated with data.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:start_range+               - Integer. Position of first byte of first page. (optional)
+    # * +:end_range+                 - Integer. Position of last byte of of last page. (optional)
+    # * +:snapshot+                  - String. An opaque DateTime value that specifies the blob snapshot to
+    #                                  retrieve information from. (optional)
+    # * +:timeout+                   - Integer. A timeout in seconds.
+     # * +:if_modified_since+        - String. A DateTime value. Specify this conditional header to list the pages only if 
+    #                                  the blob has been modified since the specified date/time. If the blob has not been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to list the pages only if 
+    #                                  the blob has not been modified since the specified date/time. If the blob has been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to list the pages only if 
+    #                                  the blob's ETag value matches the value specified. If the values do not match, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to list the pages only if 
+    #                                  the blob's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691973.aspx
+    #
+    # Returns a list of page ranges in the format [ [start, end], [start, end], ... ]
+    #
+    #   eg. [ [0, 511], [512, 1024], ... ]
+    #
+    def list_page_blob_ranges(container, blob, options={})
+      query = {'comp' => 'pagelist'}
+      query.update({'snapshot' => options[:snapshot]}) if options[:snapshot]
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      options[:start_range] = 0 if options[:end_range] and not options[:start_range]
+
+      headers = StorageService.service_properties_headers
+      StorageService.with_header headers, 'x-ms-range', "bytes=#{options[:start_range]}-#{options[:end_range]}" if options[:start_range]
+      add_blob_conditional_headers options, headers
+      
+      response = call(:get, uri, nil, headers)
+
+      pagelist = Serialization.page_list_from_xml(response.body)
+      pagelist
+    end
+    
+    # Public: Resizes a page blob to the specified size.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +size+                       - String. The blob size. Resizes a page blob to the specified size. 
+    #                                  If the specified value is less than the current size of the blob, 
+    #                                  then all pages above the specified value are cleared.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to set the blob properties
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to set the blob properties
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691966.aspx
+    #
+    # Returns nil on success.
+    def resize_page_blob(container, blob, size, options={})
+      options = { :content_length => size }.merge(options)
+      set_blob_properties container, blob, options
+    end
+    
+    # Public: Sets a page blob's sequence number.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +action+                     - Symbol. Indicates how the service should modify the sequence
+    #                                  number for the blob. Required if :sequence_number is used. This property
+    #                                  applies to page blobs only.
+    #
+    #                                  Specify one of the following options for this property:
+    #
+    #     * +:max+                       - Sets the sequence number to be the higher of the value included with
+    #                                      the request and the value currently stored for the blob.
+    #     * +:update+                    - Sets the sequence number to the value included with the request.
+    #     * +:increment+                 - Increments the value of the sequence number by 1. If specifying this
+    #                                      option, do not include the sequence_number option; doing so will return
+    #                                      status code 400 (Bad Request).
+    #
+    # * +number+                     - Integer. Sets the blob's sequence number. The sequence number is a
+    #                                  user-controlled property that you can use to track requests and manage concurrency
+    #                                  issues. Required if the 'action' parameter is set to :max or :update.
+    #                                  This property applies to page blobs only.
+    #
+    #                                  Use this together with the 'action' parameter to update the blob's sequence
+    #                                  number, either to the specified value or to the higher of the values specified with
+    #                                  the request or currently stored with the blob.
+    #
+    #                                  This header should not be specified if the 'action' parameter is set to :increment;
+    #                                  in this case the service automatically increments the sequence number by one.
+    #
+    #                                  To set the sequence number to a value of your choosing, this property must be specified
+    #                                  together with the 'action' parameter
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to set the blob properties
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to set the blob properties
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691966.aspx
+    #
+    # Returns nil on success.
+    def set_sequence_number(container, blob, action, number, options={})
+      options = { :sequence_number_action => action, :sequence_number => number }.merge(options)
+      set_blob_properties container, blob, options
+    end
+  end
+end

data/lib/azure/storage/blob/serialization.rb

@@ -0,0 +1,297 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require 'azure/storage/service/serialization'
+
+require 'azure/storage/blob/container'
+require 'azure/storage/blob/blob'
+require 'azure/storage/blob/block'
+
+require 'base64'
+
+module Azure::Storage
+  module Blob
+    module Serialization
+      include Azure::Storage::Service::Serialization
+
+      def self.container_enumeration_results_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("EnumerationResults", xml)
+
+        results = enumeration_results_from_xml(xml, Azure::Service::EnumerationResults.new)
+        
+        return results unless (xml > "Containers").any? && ((xml > "Containers") > "Container").any?
+
+        if xml.Containers.Container.count == 0
+          results.push(container_from_xml(xml.Containers.Container))
+        else
+          xml.Containers.Container.each { |container_node|
+            results.push(container_from_xml(container_node))
+          }
+        end
+
+        results
+      end
+
+      def self.container_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Container", xml)
+
+        Container::Container.new do |container|
+          container.name = xml.Name.text if (xml > "Name").any?
+          container.properties = container_properties_from_xml(xml.Properties) if (xml > "Properties").any?
+          container.metadata = metadata_from_xml(xml.Metadata) if (xml > "Metadata").any?
+        end
+      end
+
+      def self.container_from_headers(headers)
+        Container::Container.new do |container|
+          container.properties = container_properties_from_headers(headers)
+          container.public_access_level = public_access_level_from_headers(headers)
+          container.metadata = metadata_from_headers(headers)
+        end
+      end
+
+      def self.container_properties_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Properties", xml)
+
+        props = {}
+
+        props[:last_modified] = (xml > "Last-Modified").text if (xml > "Last-Modified").any?
+        props[:etag] = xml.Etag.text if (xml > "Etag").any?
+        props[:lease_status] = xml.LeaseStatus.text if (xml > "LeaseStatus").any?
+        props[:lease_state] = xml.LeaseState.text if (xml > "LeaseState").any?
+        props[:lease_duration] = xml.LeaseDuration.text if (xml > "LeaseDuration").any?
+
+        props
+      end
+
+      def self.container_properties_from_headers(headers)
+        props = {}
+
+        props[:last_modified] = headers["Last-Modified"] 
+        props[:etag] = headers["Etag"]
+        props[:lease_status] = headers["x-ms-lease-status"]
+        props[:lease_state] = headers["x-ms-lease-state"]
+        props[:lease_duration] = headers["x-ms-lease-duration"]
+
+        props
+      end
+
+      def self.public_access_level_from_headers(headers)
+        headers["x-ms-blob-public-access"]
+      end
+
+      def self.blob_enumeration_results_from_xml(xml)
+      
+        xml = slopify(xml)
+        expect_node("EnumerationResults", xml)
+
+        results = enumeration_results_from_xml(xml, Azure::Service::EnumerationResults.new)
+
+        return results unless (xml > "Blobs").any?
+
+        if ((xml > "Blobs") > "Blob").any?
+          if xml.Blobs.Blob.count == 0
+            results.push(blob_from_xml(xml.Blobs.Blob))
+          else
+            xml.Blobs.Blob.each { |blob_node|
+              results.push(blob_from_xml(blob_node))
+            }
+          end
+        end
+
+        results
+      end
+      
+      def self.blob_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Blob", xml)
+
+        Blob.new do |blob|
+          blob.name = xml.Name.text if (xml > "Name").any?
+          blob.snapshot = xml.Snapshot.text if (xml > "Snapshot").any?
+
+          blob.properties = blob_properties_from_xml(xml.Properties) if (xml > "Properties").any?
+          blob.metadata = metadata_from_xml(xml.Metadata) if (xml > "Metadata").any?
+        end
+      end
+
+      def self.blob_from_headers(headers)
+        Blob.new do |blob|
+          blob.properties = blob_properties_from_headers(headers)
+          blob.metadata = metadata_from_headers(headers)
+        end
+      end
+
+      def self.blob_properties_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Properties", xml)
+
+        props = {}
+
+        props[:last_modified] = (xml > "Last-Modified").text if (xml > "Last-Modified").any?
+        props[:etag] = xml.Etag.text if (xml > "Etag").any?
+        props[:lease_status] = xml.LeaseStatus.text if (xml > "LeaseStatus").any?
+        props[:lease_state] = xml.LeaseState.text if (xml > "LeaseState").any?
+        props[:lease_duration] = xml.LeaseDuration.text if (xml > "LeaseDuration").any?
+        props[:content_length] = (xml > "Content-Length").text.to_i if (xml > "Content-Length").any?
+        props[:content_type] = (xml > "Content-Type").text if (xml > "Content-Type").any?
+        props[:content_encoding] = (xml > "Content-Encoding").text if (xml > "Content-Encoding").any?
+        props[:content_language] = (xml > "Content-Language").text if (xml > "Content-Language").any?
+        props[:content_md5] = (xml > "Content-MD5").text if (xml > "Content-MD5").any?
+
+        props[:cache_control] = (xml > "Cache-Control").text if (xml > "Cache-Control").any?
+        props[:sequence_number] = (xml > "x-ms-blob-sequence-number").text.to_i if (xml > "x-ms-blob-sequence-number").any?
+        props[:blob_type] = xml.BlobType.text if (xml > "BlobType").any?
+        props[:copy_id] = xml.CopyId.text if (xml > "CopyId").any?
+        props[:copy_status] = xml.CopyStatus.text if (xml > "CopyStatus").any?
+        props[:copy_source] = xml.CopySource.text if (xml > "CopySource").any?
+        props[:copy_progress] = xml.CopyProgress.text if (xml > "CopyProgress").any?
+        props[:copy_completion_time] = xml.CopyCompletionTime.text if (xml > "CopyCompletionTime").any?
+        props[:copy_status_description] = xml.CopyStatusDescription.text if (xml > "CopyStatusDescription").any?
+
+        props
+      end
+
+      def self.blob_properties_from_headers(headers)
+        props = {}
+
+        props[:last_modified] = headers["Last-Modified"]
+        props[:etag] = headers["Etag"]
+        props[:lease_status] = headers["x-ms-lease-status"]
+        props[:lease_state] = headers["x-ms-lease-state"]
+        props[:lease_duration] = headers["x-ms-lease-duration"]
+
+        props[:content_length] = headers["x-ms-blob-content-length"] || headers["Content-Length"]
+        props[:content_length] = props[:content_length].to_i if props[:content_length]
+      
+        props[:content_type] =  headers["x-ms-blob-content-type"] || headers["Content-Type"]
+        props[:content_encoding] = headers["x-ms-blob-content-encoding"] || headers["Content-Encoding"]
+        props[:content_language] = headers["x-ms-blob-content-language"] || headers["Content-Language"]
+        props[:content_disposition] = headers["x-ms-blob-content-disposition"] || headers["Content-Disposition"]
+        props[:content_md5] = headers["x-ms-blob-content-md5"] || headers["Content-MD5"]
+
+        props[:cache_control] = headers["x-ms-blob-cache-control"] || headers["Cache-Control"]
+        props[:sequence_number] = headers["x-ms-blob-sequence-number"].to_i if headers["x-ms-blob-sequence-number"]
+        props[:blob_type] = headers["x-ms-blob-type"]
+
+        props[:copy_id] = headers["x-ms-copy-id"]
+        props[:copy_status] = headers["x-ms-copy-status"]
+        props[:copy_source] = headers["x-ms-copy-source"]
+        props[:copy_progress] = headers["x-ms-copy-progress"]
+        props[:copy_completion_time] = headers["x-ms-copy-completion-time"]
+        props[:copy_status_description] = headers["x-ms-copy-status-description"]
+
+        props[:accept_ranges] = headers["Accept-Ranges"].to_i if headers["Accept-Ranges"]
+        
+        props[:append_offset] = headers["x-ms-blob-append-offset"].to_i if headers["x-ms-blob-append-offset"]
+        props[:committed_count] = headers["x-ms-blob-committed-block-count"].to_i if headers["x-ms-blob-committed-block-count"]
+
+        props
+      end
+
+      def self.block_list_to_xml(block_list)
+        builder = Nokogiri::XML::Builder.new(:encoding => "UTF-8") do |xml|
+          xml.BlockList {
+            block_list.each { |block|
+              encoded_id = Base64.strict_encode64(block[0])
+              case block[1]
+              when :uncommitted
+                xml.Uncommitted encoded_id
+              when :committed
+                xml.Committed encoded_id
+              else
+                xml.Latest encoded_id
+              end
+            }
+          }
+        end
+        builder.to_xml
+      end
+
+      def self.block_list_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("BlockList", xml)
+
+        block_list =  {
+          :committed => [],
+          :uncommitted => []
+        }
+
+        if ((xml > "CommittedBlocks") > "Block").any?
+          if xml.CommittedBlocks.Block.count == 0
+            add_block(:committed, xml.CommittedBlocks.Block, block_list)
+          else
+            xml.CommittedBlocks.Block.each { |block_node|
+              add_block(:committed, block_node, block_list)
+            }
+          end
+        end
+
+        return block_list unless (xml > "UncommittedBlocks")
+
+        if ((xml > "UncommittedBlocks") > "Block").any?
+          if xml.UncommittedBlocks.Block.count == 0
+            add_block(:uncommitted, xml.UncommittedBlocks.Block, block_list)
+          else
+            xml.UncommittedBlocks.Block.each { |block_node|
+              add_block(:uncommitted, block_node, block_list)
+            }
+          end
+        end
+
+        block_list
+      end
+
+      def self.add_block(type, block_node, block_list)
+        block = Block.new do |b|
+          b.name = Base64.strict_decode64(block_node.Name.text) if (block_node > "Name").any?
+          b.size = block_node.Size.text.to_i if (block_node > "Size").any?
+          b.type = type
+        end
+        block_list[type].push block
+      end
+      
+      def self.page_list_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("PageList", xml)
+
+        page_list = []
+
+        return page_list unless (xml > "PageRange").any?
+
+        if xml.PageRange.count == 0
+          page_list.push [xml.PageRange.Start.text.to_i, xml.PageRange.End.text.to_i]
+        else
+          xml.PageRange.each { |page_range|
+            page_list.push [page_range.Start.text.to_i, page_range.End.text.to_i]
+          }
+        end
+
+        page_list
+      end
+    end
+  end
+end