azure 0.1.1 → 0.5.0

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

@@ -1,59 +0,0 @@
-module Azure
-  module Core
-    module Utils
-      # Convenience module to build query strings.
-      module String
-        # The following methods have been borrowed (stolen?) from ActiveSupport
-
-        # By default, +camelize+ converts strings to UpperCamelCase. If the argument to +camelize+
-        # is set to <tt>:lower</tt> then +camelize+ produces lowerCamelCase.
-        #
-        # +camelize+ will also convert '/' to '::' which is useful for converting paths to namespaces.
-        #
-        # Examples:
-        #   "active_model".camelize                # => "ActiveModel"
-        #   "active_model".camelize(:lower)        # => "activeModel"
-        #   "active_model/errors".camelize         # => "ActiveModel::Errors"
-        #   "active_model/errors".camelize(:lower) # => "activeModel::Errors"
-        #
-        # As a rule of thumb you can think of +camelize+ as the inverse of +underscore+,
-        # though there are cases where that does not hold:
-        #
-        #   "SSLError".underscore.camelize # => "SslError"
-        def camelize(term, uppercase_first_letter = true)
-          string = term.to_s
-          acronyms = {}
-          if uppercase_first_letter
-            string = string.sub(/^[a-z\d]*/) { acronyms[$&] || $&.capitalize }
-          else
-            string = string.sub(/^(?:(?=a)b(?=\b|[A-Z_])|\w)/) { $&.downcase }
-          end
-          string.gsub(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{acronyms[$2] || $2.capitalize}" }.gsub('/', '::')
-        end
-
-        # Makes an underscored, lowercase form from the expression in the string.
-        #
-        # Changes '::' to '/' to convert namespaces to paths.
-        #
-        # Examples:
-        #   "ActiveModel".underscore         # => "active_model"
-        #   "ActiveModel::Errors".underscore # => "active_model/errors"
-        #
-        # As a rule of thumb you can think of +underscore+ as the inverse of +camelize+,
-        # though there are cases where that does not hold:
-        #
-        #   "SSLError".underscore.camelize # => "SslError"
-        def underscore(camel_cased_word)
-          word = camel_cased_word.to_s.dup
-          word.gsub!(/::/, '/')
-          word.gsub!(/(?:([A-Za-z\d])|^)((?=a)b)(?=\b|[^a-z])/) { "#{$1}#{$1 && '_'}#{$2.downcase}" }
-          word.gsub!(/([A-Z\d]+)([A-Z][a-z])/,'\1_\2')
-          word.gsub!(/([a-z\d])([A-Z])/,'\1_\2')
-          word.tr!("-", "_")
-          word.downcase!
-          word
-        end
-      end
-    end
-  end
-end

data/lib/azure/error.rb

@@ -1,72 +0,0 @@
-require "xml"
-
-module Azure
-  # Public: Superclass for errors generated from this library, so people can
-  # just rescue this for generic error handling.
-  class Error < StandardError; end
-
-  # Public: FileUploadError
-  class FileUploadError < ::Azure::Error; end
-
-  # Public: Class for handling all HTTP response errors.
-  class HTTPError < ::Azure::Error
-    # Public: The HTTP status code of this error.
-    #
-    # Returns a Fixnum.
-    attr :code
-
-    # Public: The type of error, as described by the Azure documentation.
-    #
-    # Returns a String.
-    attr :type
-
-    # Public: The English description of this error.
-    #
-    # Returns a String.
-    attr :description
-
-    # Public: Initialize an error.
-    #
-    # http_response - An Azure::Response.
-    def initialize(http_response)
-      @http_response = http_response
-      @code = http_response.code
-      parse_response
-      super("#{type} (#{code}): #{description}")
-    end
-
-    # Extract the relevant information from the response's body. If the response
-    # body is not an XML, we return an 'Unknown' error with the entire body as
-    # the description.
-    #
-    # Returns nothing.
-    def parse_response
-      if @http_response.body.include?("<")
-        document = XML::Parser.string(@http_response.body).parse
-
-        # FIXME: For some reason document.find_first("code") (or "//code", etc.)
-        # and document.find_first("message") return nil, while this works. It
-        # makes no sense that this works and that doesn't. Oh well.
-        document.root.children.each do |child|
-          @type = child.content if child.name == "code"
-          @description = child.content if child.name == "message"
-        end
-      else
-        @type = "Unknown"
-        @description = @http_response.body.strip
-      end
-    end
-  end
-
-  # Public: Mixin that gives a few convenience methods for handling errors in
-  # domain objects.
-  module ErrorHandler
-    # Public: Get/Set the current error in this object.
-    attr_accessor :error
-
-    # Public: Check if this object doesn't have any errors.
-    def valid?
-      error.nil?
-    end
-  end
-end

data/lib/azure/queues.rb

@@ -1,272 +0,0 @@
-require "nokogiri"
-require "azure/queues/service"
-require "azure/queues/queue"
-require "azure/queues/message"
-require "azure/queues/service_properties"
-require "azure/queues/uri"
-
-module Azure
-  module Queues
-    # Public: This operation gets the properties of a storage account’s Queue Service.
-    # If the operation is unsuccessful the resulting object will have the error
-    # accessible through the #error method.
-    #
-    # options - Options for this query (default: {}):
-    #           :timeout  - (optional) timeout for the request in seconds
-    # service - The backend service to implement this (optional).
-    #
-    # Returns an Azure::Queues::ServiceProperties object
-    def self.get_service_properties(options = {}, service=Azure::Queues::Services::GetServiceProperties.new)
-      response = service.call(options)
-
-      if response.success?
-        result = Nokogiri::XML(response.body)
-        node = result.xpath('//StorageServiceProperties').first
-        ServiceProperties.from_node(node)
-      else
-        ServiceProperties.from_error(response.error)
-      end
-    end
-
-    # Public: This operation sets the properties of a storage account’s Queue Service.
-    # If the operation is unsuccessful the resulting object will have the error
-    # accessible through the #error method.
-    #
-    # properties  - an Azure::Queues::ServiceProperties object
-    # options     - Options for this query (default: {}):
-    #               :timeout  - (optional) timeout for the request in seconds
-    # service     - The backend service to implement this (optional).
-    #
-    # Returns an Azure::Queues::ServiceProperties object
-    def self.set_service_properties(properties, options = {}, service=Azure::Queues::Services::SetServiceProperties.new)
-      response = service.call(properties, options)
-      properties.error = response.error unless response.success?
-      response.success?
-    end
-
-    # Public: This operation lists all of the queues in a given storage account.
-    # GET http://myaccount.queue.core.windows.net?comp=list
-    #
-    # options - Options for this query (default: {}):
-    #           :prefix           - Filters the results to return only queues with names that begin with the specified prefix.
-    #           :marker           - A string value that identifies the portion of the list to be returned with the next list operation.
-    #           :maxresults       - Specifies the maximum number of queues to return
-    #           :include_metadata - Include this parameter to specify that the container's metadata be returned as part of the response body.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns an Array of Query elements.
-    def self.all(options = {}, service=Azure::Queues::Services::ListQueues.new)
-      response = service.call(options)
-
-      if response.success?
-        result = Nokogiri::XML(response.body)
-        result.xpath('//Queues/Queue').map {|node| Queue.from_node(node) }
-      else
-        []
-      end
-    end
-
-    # Public: Try to create a new queue. If the operation is unsuccessful,
-    # the resulting Queue object will have the error accessible through the
-    # #error method.
-    #
-    # name     - The name of the container.
-    # metadata - User defined metadata for this container (optional).
-    # service  - The backend service to implement this (optional).
-    #
-    # Returns a Queue.
-    def self.create(name, metadata={}, service=Azure::Queues::Services::CreateQueue.new)
-      response = service.call(name, metadata)
-
-      if response.success?
-        Queue.new(name)
-      else
-        Queue.from_error(response.error)
-      end
-    end
-
-    # Public: Delete a Queue from the server. If the delete operation fails,
-    # the queue is invalidated. Otherwise it's frozen.
-    #
-    # queue   - An Azure::Queues::Queue.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns true|false to indicate success.
-    def self.delete(queue, service=Azure::Queues::Services::DeleteQueue.new)
-      response = service.call(queue.name)
-
-      if response.success?
-        queue.freeze
-      else
-        queue.error = response.error
-      end
-
-      response.success?
-    end
-
-    # Public: Obtain the queue metadata. This updates the queue and
-    # changes the metadata internally if successful. If the operation fails, the
-    # queue's metadata does not change, and the queue is invalidated.
-    #
-    # queue   - An Azure::Queues::Queue.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns a Hash.
-    def self.load_metadata(queue, service=Azure::Queues::Services::GetMetadata.new)
-      response = service.call(queue.name)
-
-      if response.success?
-        queue.extract_metadata(response.headers)
-      else
-        queue.error = response.error
-        {}
-      end
-    end
-
-    # Public: Save the current metadata of a queue in the storage service.
-    # If the operation fails, the queue is invalidated.
-    #
-    # queue   - An Azure::Queues::Queue.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns true|false to indicate success.
-    def self.save_metadata(queue, service=Azure::Queues::Services::SetMetadata.new)
-      response = service.call(queue.name, queue.metadata)
-      queue.error = response.error unless response.success?
-      response.success?
-    end
-
-    ## MESSAGES
-
-    # Public: Try to add a new message to the back of the message queue. If the
-    # operation is unsuccessful, the message is invalidated.
-    #
-    # queue   - An Azure::Queues::Queue.
-    # message - An Azure::Queues::Message.
-    # options - A Hash of options for this operation.
-    #           :visibilitytimeout - Time in seconds until the message becomes
-    #                                visible in the queue (default: 0).
-    #           :messagettl        - Time-to-live interval for the message in
-    #                                seconds. Can go up to 7 days (the
-    #                                default).
-    # service - The backend service to implement this (optional).
-    #
-    # Returns the message.
-    def self.put_message(queue, message, options = {}, service=Azure::Queues::Services::PutMessage.new)
-      response = service.call(queue.name, message.text, options)
-
-      if response.success?
-        message.queue = queue
-      else
-        message.error = response.error
-      end
-
-      message
-    end
-
-    # Public: Get one or more messages from the front of the queue.
-    #
-    # FIXME: Handle errors.
-    #
-    # queue   - An Azure::Queues::Queue.
-    # options - A Hash of options for this operation (optional):
-    #           :visibilitytimeout - Update the returned messages'
-    #                                visibilitytimeout to this number (at least
-    #                                1, the default).
-    #           :numofmessages     - A number between 1 and 32 of messages to
-    #                                return (default: 1).
-    # service - The backend service to implement this (optional).
-    #
-    # Returns an Array of Messages.
-    def self.get_messages(queue, options = {}, service = Azure::Queues::Services::GetMessages.new)
-      response = service.call(queue.name, options)
-
-      # FIXME: need error handling
-      document = Nokogiri::XML(response.body)
-      (document / "//QueueMessagesList/QueueMessage").map do |node|
-        Message.from_node(node) { |m| m.queue = queue }
-      end
-    end
-
-    # Public: Peek at one or more messages from the front of the queue.
-    #
-    # queue   - The message queue
-    # options - A Hash of options for this operation (optional):
-    #           :numofmessages - A number between 1 and 32 of messages to return
-    #                            (default: 1).
-    # service - The backend service to implement this (optional).
-    #
-    # Returns an Array of Messages.
-    def self.peek_messages(queue, options = {}, service = Azure::Queues::Services::PeekMessages.new)
-      response = service.call(queue.name, options)
-
-      # FIXME: need error handling
-      document = Nokogiri::XML(response.body)
-      (document / "//QueueMessagesList/QueueMessage").map do |node|
-        Message.from_node(node) { |m| m.queue = queue }
-      end
-    end
-
-    # Public: Delete the specified message from the queue. If the operation
-    # fails, the message is invalidated.
-    #
-    # message - An Azure::Queues::Message.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns true|false to indicate success.
-    def self.delete_message(message, service = Azure::Queues::Services::DeleteMessage.new)
-      response = service.call(
-        message.queue.name,
-        message.id,
-        message.pop_receipt
-      )
-
-      if response.success?
-        message.freeze
-      else
-        message.error = response.error
-      end
-
-      response.success?
-    end
-
-    # Public: Delete all messages from the queue. If the operation fails, the
-    # queue is invalidated.
-    #
-    # queue   - The message queue.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns true|false to indicate success.
-    def self.clear_messages(queue, service = Azure::Queues::Services::ClearMessages.new)
-      response = service.call(queue.name)
-      queue.error = response.error unless response.success?
-      response.success?
-    end
-
-    # Public: Update the specified message. If the operation fails, the message
-    # is invalidated.
-    #
-    # message - An Azure::Queues::Message.
-    # service - The backend service to implement this (optional).
-    #
-    # Returns true|false to indicate success.
-    def self.update_message(message, service=Azure::Queues::Services::UpdateMessage.new)
-      response = service.call(
-        message.queue.name,
-        message.id,
-        message.text,
-        message.visibility_timeout,
-        message.pop_receipt
-      )
-
-      if response.success?
-        message.time_next_visible = response.headers['x-ms-time-next-visible']
-        message.pop_receipt       = response.headers['x-ms-popreceipt']
-      else
-        message.error = response.error
-      end
-
-      response.success?
-    end
-  end
-end

data/lib/azure/queues/message.rb

@@ -1,174 +0,0 @@
-require "azure/queues"
-require "azure/queues/uri"
-require "azure/error"
-require "uri"
-require "time"
-
-module Azure
-  module Queues
-    # Public: Representation of a Message in a message queue.
-    class Message
-      include Azure::ErrorHandler
-
-      # The message queue for this message
-      #
-      # Returns a Azure::Queues::Queue object
-      attr_accessor :queue
-
-      # MessageId
-      # GUID value that identifies the message in the queue
-      #
-      # returns a String
-      attr_accessor :id
-
-      # InsertionTime
-      # UTC value formatted as described in RFC 1123
-      #
-      # Returns a String
-      attr_accessor :insertion_time
-
-      # ExpirationTime
-      # UTC value formatted as described in RFC 1123
-      #
-      # Returns a String
-      attr_accessor :expiration_time
-
-      # TimeNextVisible
-      # UTC value formatted as described in RFC 1123
-      #
-      # Returns a String
-      attr_accessor :time_next_visible
-
-      # PopReceipt
-      #
-      # Returns a String
-      attr_accessor :pop_receipt
-
-      # DequeueCount
-      # Has a value of 1 the first time the message is dequeued. This value is incremented each time the message is subsequently dequeued.
-      #
-      # Returns an Integer
-      attr_accessor :dequeue_count
-
-      # MessageText
-      #
-      # Returns a String
-      attr_accessor :text
-
-      # Amount of time in seconds the message remains invisible for GET
-      # operations.
-      #
-      # Returns an Integer.
-      attr_accessor :visibility_timeout
-
-      # Amount of seconds until this message expires.
-      #
-      # Returns an Integer.
-      attr_accessor :ttl
-
-      # Public: Instantiate a message from an XML entry.
-      #
-      # entry - An XML::Node element.
-      #
-      # Returns a Message.
-      def self.from_node(node)
-        pop_receipt       = (node % "PopReceipt")
-        time_next_visible = (node % "TimeNextVisible")
-        text              = (node % "MessageText").text
-
-        new(text) do |m|
-          m.id                = (node % "MessageId").text
-          m.insertion_time    = Time.parse((node % "InsertionTime").text)
-          m.expiration_time   = Time.parse((node % "ExpirationTime").text)
-          m.dequeue_count     = (node % "DequeueCount").text.to_i
-          m.pop_receipt       = pop_receipt && pop_receipt.text
-          m.time_next_visible = time_next_visible && Time.parse(time_next_visible.text)
-          yield m if block_given?
-        end
-      end
-
-      # Public: Instantiate a message from an error object.
-      #
-      # error - An Azure::Error.
-      #
-      # Returns a Message.
-      def self.from_error(error)
-        message = new(nil)
-        message.error = error
-        message
-      end
-
-      # Public: Attempt to convert an object into a Message. If the object can't
-      # be converted, we return nil.
-      #
-      # object - An object that might be converted into a Message.
-      #
-      # Returns a Message or nil.
-      def self.try_convert(object)
-        if object.respond_to?(:to_message)
-          object.to_message
-        elsif object.respond_to?(:to_str)
-          new(object.to_str)
-        end
-      end
-
-      # Public: Initialize the message.
-      #
-      # text    - The message text
-      # service - The Queue service to perform external calls.
-      def initialize(text, service=Azure::Queues)
-        @text = text
-        @visibility_timeout = 0
-        @ttl = 7 * 24 * 3600 # one week
-        @service = service
-        yield self if block_given?
-      end
-
-      # Public: Compare two messages to see if they are the same.
-      #
-      # other - A Message.
-      #
-      # Returns true|false.
-      def ==(other)
-        id == other.id
-      end
-
-      # Public: Deletes this message from the message queue.
-      #
-      # Returns true|false to indicate success.
-      def delete
-        @service.delete_message(self)
-      end
-
-      # Public: Updates this message with a new visibility timeout and new text
-      # if modified.
-      #
-      # Returns true|false to indicate success.
-      def update!
-        @service.update_message(self)
-      end
-
-      # Public: Turn this object into an Azure::Queues::Message. This is here
-      # just so we can use Message.try_convert and Message().
-      #
-      # Returns self.
-      def to_message
-        self
-      end
-    end
-
-    module ::Kernel
-      # Attempt to convert an object into a Message, or fail if the conversion
-      # can't be done.
-      #
-      # object - An object that might be converted into a message.
-      #
-      # Returns a Message.
-      # Raises ArgumentError if the object can't be converted into a Message.
-      def Message(object)
-        Message.try_convert(object) ||
-          raise(ArgumentError, "invalid value for Message(): #{object.inspect}")
-      end
-    end
-  end
-end