azure 0.1.1 → 0.5.0

data/lib/azure/blobs/blob.rb

@@ -1,360 +0,0 @@
-require "nokogiri"
-require "uri"
-require "azure/error"
-require "azure/blobs"
-require "azure/blobs/uri"
-require "digest/sha1"
-
-module Azure
-  module Blobs
-    class Blob
-      include ErrorHandler
-
-      # List of valid property names.
-      PROPERTIES = [
-        "content-length",
-        "content-type",
-        "content-md5",
-        "content-encoding",
-        "content-language",
-        "cache-control",
-        "last-modified",
-        "etag",
-        "x-ms-lease-status",
-        "x-ms-lease-time",
-        "x-ms-lease-id",
-        "x-ms-blob-sequence-number",
-        "x-ms-snapshot"
-      ].freeze
-
-      # Public: Get/Set the container where this blob belongs.
-      attr_accessor :container
-
-      # Public: Get the name of the blob.
-      attr :name
-
-      # Public: Get the Properties of the blob.
-      #
-      # Following are *Optional*
-      # - "x-ms-blob-cache-control"    Modifies the cache control string for the blob.
-      # - "x-ms-blob-content-type"     Sets the blob’s content type.
-      # - "x-ms-blob-content-md5"      Sets the blob's MD5 hash.
-      # - "x-ms-blob-content-encoding" Sets the blob's content encoding.
-      # - "x-ms-blob-content-languag"  Sets the blob's content language.
-      #
-      # Following may be *Required*
-      # - "x-ms-lease-id"              Required if the blob has an active lease.
-      #
-      # Following properties only apply to Page Blobs.
-      # - Optional "x-ms-blob-content-length" 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.
-      #
-      # - "x-ms-sequence-number-action" Optional, but required if the x-ms-blob-sequence-number
-      #   header is set for the request. Posible values: {max, update, increment}
-      #
-      # - "x-ms-blob-sequence-number" Optional, but required if the x-ms-sequence-number-action
-      #   property is set to max or update.
-      #
-      # See http://msdn.microsoft.com/en-us/library/windowsazure/ee691966.
-      attr :properties
-
-      # Public: Get the Metadata of the blob.
-      attr :metadata
-
-      # Public: Get the Content of the blob.
-      attr :content
-
-      # Public: Initialize a blob from an XML node as returned from an API
-      # response.
-      #
-      # container - A instance of Azure::Blobs::Container
-      # node      - A Nokogiri::Node.
-      #
-      # Returns a Blob.
-      def self.from_node(node)
-        name = (node % "Name").text
-
-        properties = (node / "Properties *").each_with_object({}) do |no, props|
-          props[no.name] = no.text
-        end
-
-        metadata = (node / "Metadata *").each_with_object({}) do |no, meta|
-          meta[no.name] = no.text
-        end
-
-        container_name = (node / "Url").text.split("/")[-2..-2].first
-        container = Azure::Blobs::Container.new(container_name)
-
-        new(name, container) do |blob|
-          blob.metadata.replace(metadata)
-          blob.properties.replace(properties)
-          yield blob if block_given?
-        end
-      end
-
-      # Public: Instantiate a blob from an error object.
-      #
-      # error - An Azure::Error.
-      #
-      # Returns a Table.
-      def self.from_error(error)
-        new(nil, nil, nil) do |blob|
-          blob.error = error
-        end
-      end
-
-      # Public: Initialize a Blob.
-      #
-      # name       - A String with the name of the Blob.
-      # container  - An Azure::Blobs::Container instance.
-      # content    - The content of this Blob.
-      # service    - The Blobs service to perform external calls.
-      def initialize(name, container=nil, content=nil, service=Azure::Blobs)
-        @name = name
-        @container = container
-        @content = content
-        @properties = {}
-        @metadata = {}
-        @service = service
-        yield self if block_given?
-      end
-
-      # Public: The url of this blob.
-      #
-      # Returns a URI.
-      def url
-        Blobs::URI.blob(container.name, name)
-      end
-
-      # Public: Check equality between blobs. Two blobs are equal if they have
-      # the same name and belong to the same container.
-      #
-      # other - A Blob.
-      #
-      # Returns true|false.
-      def ==(other)
-        !container.nil? && container == other.container && name == other.name
-      end
-
-      # Public: Delete this blob from the storage service. If the operation is
-      # unsuccessful this invalidates the blob.
-      #
-      # Returns true|false to indicate success.
-      def delete
-        @service.delete_blob(self)
-      end
-
-      # Public: Force a reload of this blob's metadata from the service.
-      #
-      # Returns the Hash of metadata.
-      def load_metadata!
-        @service.load_blob_metadata(self)
-      end
-
-      # Public: Put the current blob's metadata into the storage service.
-      #
-      # Returns true|false to indicate success.
-      def save_metadata!
-        @service.save_blob_metadata(self)
-      end
-
-      # Public: Extracts metadata from a hash containing HTTP headers (so
-      # "x-ms-meta-Name" => "Foo" is extracted as "Name" => "Foo"). This
-      # replaces the metadata of this container.
-      #
-      # hash - A hash of String => String with HTTP header values.
-      #
-      # Returns a Hash with the extracted metadata.
-      def extract_metadata(hash)
-        new_metadata = hash.each_with_object({}) do |(k,v), hash|
-          if key = k[/^x-ms-meta-(?<key>.*)?/, :key]
-            hash[key] = v
-          end
-        end
-
-        metadata.replace(new_metadata)
-      end
-
-      # Public: Put the current blob's properties into the storage service.
-      #
-      # headers - A Hash with user defined headers for this operation.
-      #
-      # Returns true|false to indicate success.
-      def save_properties!(headers={})
-        @service.save_blob_properties(self, headers)
-      end
-
-      # Public: Force a reload of this blob's properties from the server.
-      #
-      # headers - A Hash with user defined headers for this operation.
-      #
-      # Returns the Hash of properties.
-      def load_properties!(headers={})
-        @service.load_blob_properties(self, headers)
-      end
-
-      # Public: Extracts properties from a hash containing HTTP headers. This
-      # replaces the properties of this container. Any headers that are
-      # contained in `PROPERTIES` are extracted.
-      #
-      # hash - A hash of String => String with HTTP header values.
-      #
-      # Returns a Hash with the extracted properties.
-      def extract_properties(hash)
-        new_properties = hash.select do |key, _|
-          PROPERTIES.include?(key)
-        end
-        new_properties.merge!("x-ms-lease-id" => lease_id) if lease_id
-        properties.replace(new_properties)
-      end
-
-      # Public: Generate a Shared Access Signature that can be used to provide
-      # anonymous access to this blob.
-      #
-      # permissions - A String with the permissions you want to grant on this
-      #               blob. Might contain any of "r", "w", "d", or "l" *in this
-      #               order*.
-      # to          - Either a Date, Time or duration in seconds.
-      # from        - A Date or Time (if `to` is a duration in seconds, then
-      #               this is ignored).
-      # id          - An identifier (optional).
-      # clock       - Dependency on Time for calculations (optional).
-      # signature   - Dependency on SharedAccessSignature (optional).
-      #
-      # Examples:
-      #
-      #   # Valid for 10 minutes.
-      #   blob.shared_access_signature("r", 10.minutes)
-      #
-      #   # Read until Christmas 2012.
-      #   blob.shared_access_signature("r", Date.new(2012, 12, 25))
-      #
-      #   # Associate this signature with an access control policy:
-      #   blob.shared_access_signature("r", 10.minutes, "policy-id")
-      #
-      # Returns a URL for this resource that includes the SAS.
-      def shared_access_signature(permissions, to, from=nil, id=nil, clock=Time, signature=SharedAccessSignature)
-        if to.respond_to?(:to_int)
-          id, to, from = from, clock.now.utc + to, clock.now.utc
-        end
-
-        signature.new(permissions, from, to, id).url(self)
-      end
-
-      # Public: String identifying which type of resource this is (used to
-      # generate shared access signatures).
-      #
-      # Returns the string "b".
-      def resource_type
-        "b"
-      end
-
-      # Public: Creates a snapshot of this Blob.
-      #
-      # metadata  - A Hash representing blob metadata as :name => value. (optional)
-      #
-      # Returns an instance of Azure::Blobs::Snapshot.
-      def create_snapshot(metadata={})
-        Azure::Blobs.create_snapshot(self, metadata)
-      end
-
-      # Public: Get the lease_id from blob properties.
-      def lease_id
-        properties["x-ms-lease-id"]
-      end
-    end
-
-    class Snapshot < Blob
-      # Public: Return the datetime value for x-ms-snapshot property.
-      def id
-        properties["x-ms-snapshot"]
-      end
-
-      # Public: Delete this snapshot.
-      def delete
-        @service.delete_snapshot(self)
-      end
-
-      # Public: Acquire a Lease ID for this blob.
-      #
-      # http://msdn.microsoft.com/en-us/library/windowsazure/ee691972
-      def acquire_lease(service=Azure::Blobs)
-        service.lease(@blob, :acquire)
-      end
-
-      # Public: Renew Lease ID for this blob.
-      #
-      # http://msdn.microsoft.com/en-us/library/windowsazure/ee691972
-      def renew_lease(service=Azure::Blobs)
-        service.lease(@blob, :renew)
-      end
-
-      # Public: Release Lease ID for this blob.
-      #
-      # http://msdn.microsoft.com/en-us/library/windowsazure/ee691972
-      def release_lease(service=Azure::Blobs)
-        service.lease(@blob, :release)
-      end
-
-      # Public: Break Lease ID for this blob.
-      #
-      # http://msdn.microsoft.com/en-us/library/windowsazure/ee691972
-      def break_lease(service=Azure::Blobs)
-        service.lease(@blob, :break)
-      end
-    end
-
-    class BlockBlob < Blob
-
-      attr :content_type
-
-      # Public: Upload a file to this BlockBlob, override content if exist.
-      # Blob metadata and properties will be sent as well to preserve them.
-      #
-      # filename_or_stream - IO or String representing the resource on the filesystem.
-      # content_type       - String representing the content-type of the uploaded blob. (optional)
-      # byte_partition     - Optional. Integer representing the size of the chunks to be uploaded. (optional)
-      #
-      # Returns boolean indicating success.
-      def update(filename_or_stream, content_type=nil, byte_partition=nil, service=Azure::Blobs)
-
-        stream = filename_or_stream.is_a?(String) ? File.open(filename_or_stream) : filename_or_stream
-
-        @content_type = content_type ||= "application/octet-stream"
-
-        block_ids = service.update_block_blob_content(self, stream, byte_partition)
-
-        if block_ids.any? && service.put_block_list(self, block_ids)
-          stream.rewind
-          @content = stream.read
-          true
-        else
-          false
-        end
-      end
-    end
-
-    class PageBlob < Blob
-      # Public: Write Range of pages.
-      def update_range(start_byte, end_byte, stream)
-        if Azure::Blobs.update_page_range(self, start_byte, end_byte, stream)
-          @content = stream
-          true
-        else
-          false
-        end
-      end
-
-      # Public: Clear Range of pages.
-      def clear_range(start_byte, end_byte)
-        Azure::Blobs.clear_page_range(self, start_byte, end_byte)
-      end
-
-      # Public: Get Range of pages.
-      def get_range(start_byte=nil, end_byte=nil)
-        Azure::Blobs.get_page_range(self, start_byte, end_byte)
-      end
-    end
-  end
-end

data/lib/azure/blobs/container.rb

@@ -1,209 +0,0 @@
-require "nokogiri"
-require "uri"
-require "azure/error"
-require "azure/blobs"
-require "azure/blobs/uri"
-require "azure/blobs/shared_access_signature"
-
-module Azure
-  module Blobs
-    class Container
-      include ErrorHandler
-
-      # Public: Indicates the both the information of the container and of its
-      # blobs is accessible by an anonymous request.
-      CONTAINER = :container
-
-      # Public: Indicates the blobs in this container can be accessed by an
-      # anonymous request, but not the information in the container.
-      BLOB = :blob
-
-      # Public: Indicates neither this container nor any of its blobs can be
-      # accessed by an anonymous request.
-      PRIVATE = :private
-
-      # Public: Get the name of the container.
-      attr :name
-
-      # Public: Get the URI of the container.
-      attr :url
-
-      # Public: Get/Set the User defined Metadata of the container.
-      attr :metadata
-
-      # Public: Get the Properties of the container.
-      attr :properties
-
-      # Public: Get the current container visibility for anonymous requests. See
-      # the x-ms-blob-public-access header on:
-      #
-      # http://msdn.microsoft.com/en-us/library/windowsazure/dd179468
-      attr_accessor :visibility
-
-      # Convert the value of a x-ms-blob-public-access header to one of our
-      # visibility constants.
-      #
-      # header_value - A string or nil.
-      #
-      # Returns either PRIVATE, BLOB, or CONTAINER.
-      def self.visibility(header_value)
-        case header_value
-        when "container", "true"
-          CONTAINER
-        when "blob"
-          BLOB
-        else
-          PRIVATE
-        end
-      end
-
-      # Public: Initialize a container from an XML node as returned from an API
-      # response.
-      #
-      # node - A Nokogiri::Node.
-      #
-      # Returns a Container.
-      def self.from_node(node)
-        name = (node % "Name").text
-        url  = URI((node % "Url").text)
-
-        metadata = (node / "Metadata *").each_with_object({}) do |n, metadata|
-          metadata[n.name] = n.text
-        end
-
-        properties = (node / "Properties *").each_with_object({}) do |n, props|
-          props[n.name] = n.text
-        end
-
-        new(name, url) do |container|
-          container.properties.replace(properties)
-          container.metadata.replace(metadata)
-        end
-      end
-
-      # Public: Initialize an invalid container from an erroneous response.
-      #
-      # error - An Azure::Error.
-      #
-      # Returns a Container.
-      def self.from_error(error)
-        container = new(nil, nil)
-        container.error = error
-        container
-      end
-
-      # Public: Initialize a Container.
-      #
-      # name    - A String with the name of the Container.
-      # url     - The URI that represents this container (optional).
-      # service - The Blobs service to perform external calls.
-      #
-      # Yields self (optional).
-      def initialize(name, url=Blobs::URI.container(name), service=Azure::Blobs)
-        @name = name
-        @url = url
-        @metadata = {}
-        @properties = {}
-        @service = service
-        yield self if block_given?
-      end
-
-      # Public: List the blobs inside this container.
-      #
-      # Returns an Array of Blobs.
-      def blobs
-        @service.blobs(self)
-      end
-
-      # Public: Check equality between containers. Two containers are equal if
-      # they have equal names.
-      #
-      # other - A Container.
-      #
-      # Returns true|false.
-      def ==(other)
-        name == other.name
-      end
-
-      # Public: Force a reload of this containers metadata from the server.
-      #
-      # Returns the Hash of metadata.
-      def load_metadata!
-        @service.load_container_metadata(self)
-      end
-
-      # Public: Put the current container's metadata into the storage service.
-      #
-      # Returns true|false to indicate success.
-      def save_metadata!
-        @service.save_container_metadata(self)
-      end
-
-      # Public: Extracts metadata from a hash containing HTTP headers (so
-      # "x-ms-meta-Name" => "Foo" is extracted as "Name" => "Foo"). This
-      # replaces the metadata of this container.
-      #
-      # hash - A hash of String => String with HTTP header values.
-      #
-      # Returns a Hash with the extracted metadata.
-      def extract_metadata(hash)
-        new_metadata = hash.each_with_object({}) do |(k,v), hash|
-          if key = k[/^x-ms-meta-(?<key>.*)?/, :key]
-            hash[key] = v
-          end
-        end
-
-        metadata.replace(new_metadata)
-      end
-
-      # Public: Generate a Shared Access Signature that can be used to provide
-      # anonymous access to this container.
-      #
-      # permissions - A String with the permissions you want to grant on this
-      #               container. Might contain any of "r", "w", "d", or "l" *in
-      #               this order*.
-      # to          - Either a Date, Time or duration in seconds.
-      # from        - A Date or Time (if `to` is a duration in seconds, then
-      #               this is ignored).
-      # id          - An identifier (optional).
-      # clock       - Dependency on Time for calculations (optional).
-      # signature   - Dependency on SharedAccessSignature (optional).
-      #
-      # Examples:
-      #
-      #   # Valid for 10 minutes.
-      #   container.shared_access_signature("r", 10.minutes)
-      #
-      #   # Read until Christmas 2012.
-      #   container.shared_access_signature("r", Date.new(2012, 12, 25))
-      #
-      #   # Associate this signature with an access control policy:
-      #   container.shared_access_signature("r", 10.minutes, "policy-id")
-      #
-      # Returns a URL for this resource that includes the SAS.
-      def shared_access_signature(permissions, to, from=nil, id=nil, clock=Time, signature=SharedAccessSignature)
-        if to.respond_to?(:to_int)
-          id, to, from = from, clock.now.utc + to, clock.now.utc
-        end
-
-        signature.new(permissions, from, to, id).url(self)
-      end
-
-      # Public: Delete this container from the storage service. If the operation
-      # fails this returns false and sets self.error.
-      #
-      # Returns true|false to indicate success.
-      def delete
-        @service.delete_container(self)
-      end
-
-      # Public: String identifying which type of resource this is (used to
-      # generate shared access signatures).
-      #
-      # Returns the string "c".
-      def resource_type
-        "c"
-      end
-    end
-  end
-end