azure 0.1.1 → 0.5.0

data/lib/azure/blobs/uri.rb

@@ -1,60 +0,0 @@
-require "azure/configuration"
-require "uri"
-
-module Azure
-  module Blobs
-    module URI
-      # Public: Generate the URI for the collection of containers.
-      #
-      # query - A Hash of key => value query parameters.
-      # host  - The host of the API.
-      #
-      # Returns a URI.
-      def self.containers(query={}, host=Azure.config.blob_host)
-        query = { "comp" => "list" }.merge(query)
-        uri = join(host, "/")
-        uri.query = ::URI.encode_www_form(query)
-        uri
-      end
-
-      # Public: Generate the URI for a specific container.
-      #
-      # name  - The container name. If this is a URI, we just return this.
-      # query - A Hash of key => value query parameters.
-      # host  - The host of the API.
-      #
-      # Returns a URI.
-      def self.container(name, query={}, host=Azure.config.blob_host)
-        return name if name.kind_of? ::URI
-        query = { "restype" => "container" }.merge(query)
-        uri = join(host, name)
-        uri.query = ::URI.encode_www_form(query)
-        uri
-      end
-
-      # Public: Generate the URI for a specific Blob.
-      #
-      # container_name - String representing the name of the container.
-      # blob_name      - String representing the name of the blob.
-      # query          - A Hash of key => value query parameters.
-      # host           - The host of the API.
-      #
-      # Returns a URI.
-      def self.blob(container_name, blob_name, query={}, host=Azure.config.blob_host)
-        uri = join(host, File.join(container_name, blob_name))
-        uri.query = ::URI.encode_www_form(query)
-        uri
-      end
-
-      # Utility method to generate the URI.
-      #
-      # host - A String with the URI's host.
-      # path - A String with the URI's path.
-      #
-      # Returns a URI.
-      def self.join(host, path)
-        ::URI.parse(File.join(host, path))
-      end
-    end
-  end
-end

data/lib/azure/configuration.rb

@@ -1,121 +0,0 @@
-require "singleton"
-
-module Azure
-  # Public: Sugar to configure the services in a neatly wrapped DSL.
-  #
-  # Yields the Azure::Configuration instance.
-  #
-  # Example:
-  #
-  #   Azure.configure do |config|
-  #     config.account_name = ENV["AZURE_ACCOUNT_NAME"]
-  #   end
-  #
-  # Returns nothing.
-  def self.configure
-    yield config
-  end
-
-  # Public: Access the service configuration.
-  #
-  # Returns the Azure::Configuration instance.
-  def self.config
-    Configuration.instance
-  end
-
-  # Singleton that keeps the configuration of the system.
-  class Configuration
-    include Singleton
-
-    # Public: Get/Set the Access Key for this service.
-    attr_accessor :access_key
-
-    # Public: Get/Set the Account Name for this service.
-    attr_accessor :account_name
-
-    # # Public: Get/Set the Access Control Namespace for this service.
-    # attr_accessor :acs_namespace
-
-    # Public: Get/Set the Service Bus Access Key (Issuer Secret) for this service.
-    attr_accessor :sb_access_key
-
-    # Public: Get/Set the Service Bus Issuer for this service.
-    attr_accessor :sb_issuer
-
-    # Public: Get/Set the ACS namespace for this service.
-    attr_accessor :acs_namespace
-
-    # Public: Set the host for the Table service. Only set this if you want
-    # something custom (like, for example, to point this to a LocalStorage
-    # emulator). This should be the complete host, including http:// at the
-    # start. When using the emulator, make sure to include your account name at
-    # the end.
-    #
-    # Example:
-    #
-    #   config.table_host = "http://127.0.0.1:10002/devstoreaccount1"
-    attr_writer :table_host
-
-    # Public: Get the host for this service. If you set something using #host=,
-    # then we use that. Else we default to Windows Azure's default hosts, based
-    # on your account name.
-    def table_host
-      @table_host || default_host(:table)
-    end
-
-    # Public: Set the host for the Blob service. Only set this if you want
-    # something custom (like, for example, to point this to a LocalStorage
-    # emulator). This should be the complete host, including http:// at the
-    # start. When using the emulator, make sure to include your account name at
-    # the end.
-    #
-    # Example:
-    #
-    #   config.blob_host = "http://127.0.0.1:10000/devstoreaccount1"
-    attr_writer :blob_host
-
-    # Public: Get the host for this service. If you set something using #host=,
-    # then we use that. Else we default to Windows Azure's default hosts, based
-    # on your account name.
-    def blob_host
-      @blob_host || default_host(:blob)
-    end
-
-    # Public: Set the host for the Queue service. Only set this if you want
-    # something custom (like, for example, to point this to a LocalStorage
-    # emulator). This should be the complete host, including http:// at the
-    # start. When using the emulator, make sure to include your account name at
-    # the end.
-    #
-    # Example:
-    #
-    #   config.queue_host = "http://127.0.0.1:10001/devstoreaccount1"
-    attr_writer :queue_host
-
-    # Public: Get the host for this service. If you set something using #host=,
-    # then we use that. Else we default to Windows Azure's default hosts, based
-    # on your account name.
-    def queue_host
-      @queue_host || default_host(:queue)
-    end
-
-    # Public: Get the host for the ACS service.
-    def acs_host
-      "https://#{acs_namespace}-sb.accesscontrol.windows.net"
-    end
-
-    # Public: Get the host for the Service Bus service.
-    def service_bus_host
-      "https://#{acs_namespace}.servicebus.windows.net"
-    end
-
-    # Calculate the default host for a given service in the cloud.
-    #
-    # service - One of :table, :blob, :queue, etc.
-    #
-    # Returns a String with the hostname, including your account name.
-    def default_host(service)
-      "http://#{account_name}.#{service}.core.windows.net"
-    end
-  end
-end

data/lib/azure/core/collection.rb

@@ -1,118 +0,0 @@
-require "delegate"
-
-module Azure
-  module Core
-    # A collection serves two functions: it is an array of models, and at the
-    # same time serves as a proxy to certain services for the models in the
-    # array.
-    #
-    # A Collection belongs to a "parent" object; for example, a collection
-    # of mesages belongs to a queue.
-    #
-    # Examples
-    #
-    #   # Get the collection
-    #   queue.messages
-    #
-    #   # Create a new message
-    #   queue.messages.create("message text")
-    #
-    #   # Fetch a single message
-    #   message = queue.messages["some-message-id"]
-    #
-    #   # Work with the messages
-    #   queue.messages.each { |msg| ... }
-    class Collection < DelegateClass(Array)
-      include Azure::ErrorHandler
-
-      # Public: Initialize the collection.
-      #
-      # parent      - The object that owns this collection.
-      # as          - The name of the relationship between the collection's
-      #               items and the parent.
-      # model_class - The class of the model this collection represents.
-      # service     - The service that implements remote calls.
-      def initialize(parent, as, model_class, service)
-        @parent = parent
-        @as = as
-        @model_class = model_class
-        @service = service
-      end
-
-      # Public: Load the underlying collection from the server.
-      #
-      # Returns self.
-      def load!
-        collection = @service.all(@parent)
-        collection.each { |el| set_parent(el) }
-        __setobj__(collection)
-        self
-      end
-
-      # Public: Create a new model in this collection.
-      #
-      # *args - Any arguments that the model's constructor takes.
-      #
-      # Yields the model before being created for modification.
-      #
-      # Returns an instance of the model.
-      def create(*args, &block)
-        model = @model_class.new(*args, &block)
-        set_parent(model)
-        @service.create(model)
-      end
-
-      # Public: Fetch a model by its identifier(s).
-      #
-      # *ids - The identifier(s) of the model.
-      #
-      # Returns an instance of the model when it's a valid identifier.
-      # Returns nil when no model matches the identifier.
-      def [](*ids)
-        fetch(*ids) { nil }
-      end
-
-      # Public: Find a model by its identifier(s). If no model matches the
-      # provided identifier(s), execute the given block, or raise ArgumentError.
-      #
-      # *ids - The identifier(s) of the model.
-      #
-      # Yields the error returned by the server in case the model wasn't found.
-      #
-      # Returns an instance of the model.
-      # Raises ArgumentError if the model isn't found and no block is given.
-      def fetch(*ids, &block)
-        block ||= -> { raise ArgumentError, "can't find #{@model_class} identified by #{id.inspect}" }
-        model = @service.fetch(@parent, *ids)
-        model.valid? ? model : block.call(model.error)
-      end
-
-      # Internal: Get the underlying collection to which we delegate. If the
-      # collection wasn't already loaded, it loads it from the server.
-      #
-      # Returns an Array.
-      def __getobj__
-        load! unless defined?(@__delegated_list)
-        @__delegated_list
-      end
-
-      # Internal: Change the underlying collection to which we delegate.
-      #
-      # collection - An Array.
-      #
-      # Returns the collection.
-      def __setobj__(collection)
-        @__delegated_list = collection
-      end
-
-      # Internal: Change the parent object of the given model.
-      #
-      # object - A model in this collection.
-      #
-      # Returns the parent.
-      def set_parent(object)
-        object.send("#{@as}=", @parent)
-      end
-    end
-  end
-end

data/lib/azure/core/signer.rb

@@ -1,32 +0,0 @@
-require "openssl"
-require "base64"
-require "azure/configuration"
-
-module Azure
-  module Core
-    # Public: Utility class to sign strings with HMAC-256 and then encode the
-    # signed string using Base64.
-    class Signer
-      # The Azure account's access key.
-      attr :access_key
-
-      # Public: Initialize the Signer.
-      #
-      # access_key - The Azure access_key encoded in Base64. Defaults to the one
-      #              in the global configuration.
-      def initialize(access_key=Azure.config.access_key)
-        @access_key = Base64.strict_decode64(access_key)
-      end
-
-      # Public: Generate an HMAC signature.
-      #
-      # body - The string to sign.
-      #
-      # Returns a Base64 String signed with HMAC.
-      def sign(body)
-        signed = OpenSSL::HMAC.digest("sha256", access_key, body)
-        Base64.strict_encode64(signed)
-      end
-    end
-  end
-end

data/lib/azure/core/utils/queryable.rb

@@ -1,74 +0,0 @@
-require "uri"
-
-module Azure
-  module Core
-    module Utils
-      # Convenience module to build query strings.
-      module Queryable
-        # Public: Build a query from a options hash.
-        #
-        # options - A hash of options.
-        #           :partition_key - Only get entities with this PartitionKey
-        #                            (optional, but :row_key must also be
-        #                            included).
-        #           :row_key       - Only get entities with this RowKey
-        #                            (optional, but :partition_key must also
-        #                            be included).
-        #           :select        - An array with property names. Only these
-        #                            properties are provided from the
-        #                            returned returned set of entities.
-        #           :filter        - A string to filter results.
-        #           :top           - Returns only the top n results from the set.
-        #           :skip          - Skips the first n results from the set.
-        #
-        # Returns a query string
-        def build_query(options)
-          select = options.fetch(:select, nil)
-          select = "$select=#{select.join(",")}" if select
-
-          filter = options.fetch(:filter, nil)
-          filter = "$filter=#{filter}" if filter
-
-          top = options.fetch(:top, nil)
-          top = "$top=#{top}" if top
-
-          skip = options.fetch(:skip, nil)
-          skip = "$skip=#{skip}" if skip
-
-          next_partition_key = options.fetch("NextPartitionKey", nil)
-          next_partition_key = "NextPartitionKey=#{next_partition_key}" if next_partition_key
-
-          next_row_key = options.fetch("NextRowKey", nil)
-          next_row_key = "NextRowKey=#{next_row_key}" if next_row_key
-
-          next_table_name = options.fetch("NextTableName", nil)
-          next_table_name = "NextTableName=#{next_table_name}" if next_table_name
-
-          query = [next_table_name, next_partition_key, next_row_key,
-              select, filter, top, skip].compact.join("&")
-
-          query != "" ? ::URI.encode(query) : nil
-        end
-
-        # Public: Build a Hash with translated keys from a options hash.
-        #
-        # options - A hash of options.
-        #           :top    - Returns only the top n results from the set.
-        #           :skip   - Skips the first n results from the set.
-        #
-        # Returns a query string
-        def translate_options_hash(options)
-          hash = {}
-
-          skip = options.fetch(:skip, nil)
-          hash["$skip"] = skip if skip
-
-          top = options.fetch(:top, nil)
-          hash["$top"] = top if top
-
-          hash
-        end
-      end
-    end
-  end
-end

data/lib/azure/core/utils/storage_service_properties.rb

@@ -1,83 +0,0 @@
-require 'nokogiri'
-
-module Azure
-  module Core
-    module Utils
-      class StorageServiceProperties
-
-        REQUIRED_ELEMENTS = {
-          "Version" => true,
-          "Delete" => true,
-          "Read" => true,
-          "Write" => true,
-          "Enabled" => true,
-          "RetentionPolicy / Enabled" => true,
-          "RetentionPolicy / Days" => true,
-          "IncludeAPIs" => "Metrics"
-        }
-
-        def self.hash_to_xml(hash)
-          doc = Nokogiri::XML::Document.new
-          doc.encoding = "utf-8"
-          root = Nokogiri::XML::Node.new("StorageServiceProperties", doc)
-          iterate_hash(hash, root, doc)
-          doc << root
-          validate(doc)
-          doc
-        end
-
-        def self.hash_to_xml_string(hash)
-          hash_to_xml(hash).to_xml
-        end
-
-        def self.xml_string_to_hash(xml)
-          doc = Nokogiri::XML.parse(xml)
-          iterate_node(doc)["StorageServiceProperties"]
-        end
-
-        private
-
-        def self.iterate_node(node)
-          node.children.each_with_object({}) do |node, hash|
-
-            next if !node.element?
-
-            if node.children.size == 1
-              hash[node.name] = node.text
-            else
-              hash[node.name] = iterate_node(node)
-            end
-          end
-        end
-
-        def self.iterate_hash(hash, root, doc)
-          hash.each do |key, value|
-            if value.is_a?(Hash)
-              node = Nokogiri::XML::Node.new(key, doc)
-              iterate_hash(value, node, doc)
-              root << node
-            else
-              node = Nokogiri::XML::Node.new(key, doc)
-              node.content = value
-              root << node
-            end
-          end
-        end
-
-        def self.validate(doc)
-          missing_keys = []
-
-          REQUIRED_ELEMENTS.each do |key,value|
-            if value == true
-              missing_keys << key if (doc / key).empty?
-            elsif (doc / value).empty? || (doc / key).empty?
-              missing_keys << key
-            end
-          end
-
-          raise StandardError, "StorageServicePropertiesMissing", missing_keys if !missing_keys.empty?
-        end
-      end
-    end
-  end
-end