azure 0.0.0 → 0.1.0

data/lib/azure/service_bus/queues/uri.rb

@@ -0,0 +1,80 @@
+require "azure/configuration"
+require "uri"
+
+module Azure
+  module ServiceBus
+    module Queues
+      module URI
+        # Public: Generate the URI for a given queue.
+        #
+        # queue_name - The name of the queue.
+        # host       - The host of the API.
+        #
+        # Returns a URI.
+        def self.queue(name, host=Azure.config.service_bus_host)
+          generate(host, name)
+        end
+
+        # Public: generate the URI for the queues collection.
+        #
+        # options - Options for this query (default: {}):
+        #           :skip - Integer: number of entries to skip
+        #           :top  - Integer: number of entries to retrieve
+        # host    - The host of the API.
+        #
+        # Returns a URI.
+        def self.collection(options={}, host=Azure.config.service_bus_host)
+          generate(host, "$Resources/Queues", options)
+        end
+
+        # Public: generate the URI for the given queues's messages
+        #
+        # queue_name  - The queue name
+        # host        - The host of the API.
+        #
+        # Returns a URI.
+        def self.messages(queue_name, host=Azure.config.service_bus_host)
+          generate(host, "#{queue_name}/messages")
+        end
+
+        # Public: generate the URI for the given queues's head
+        #
+        # queue_name  - The queue name
+        # options     - Options for this query (optional, default: {})
+        # host        - The host of the API.
+        #
+        # Returns a URI.
+        def self.messages_head(queue_name, options={}, host=Azure.config.service_bus_host)
+          generate(host, "#{queue_name}/messages/head", options)
+        end
+
+        # Public: generate the URI to operate on the given message in the given queue
+        #
+        # queue_name  - The queue name
+        # seq_number  - The message's sequence_number
+        # lock_token  - The message's lock_token
+        # host        - The host of the API (optional).
+        #
+        # Returns a URI.
+        def self.message(queue_name, seq_number, lock_token, host=Azure.config.service_bus_host)
+          generate(host, "#{queue_name}/messages/#{seq_number}/#{lock_token}")
+        end
+
+        #TODO: we need to move this method to other module to be mixedin here
+        #
+        # Utility method to generate the URI.
+        #
+        # host  - A String with the URI's host.
+        # path  - A String with the URI's path.
+        # query - A simple Hash with query parameters (default: {}).
+        #
+        # Returns a URI.
+        def self.generate(host, path, query={})
+          uri = ::URI.parse(File.join(host, path))
+          uri.query = ::URI.encode_www_form(query) unless query.empty?
+          uri
+        end
+      end
+    end
+  end
+end

data/lib/azure/service_bus/rules.rb

@@ -0,0 +1,110 @@
+require 'azure/service_bus/rules/rule'
+require 'azure/service_bus/rules/service'
+require 'nokogiri'
+
+module Azure
+  module ServiceBus
+    module Rules
+
+      # Public: Create a New Rule. Invalidates the Rule if the operation fails.
+      #
+      # subscription - An instance of Azure::ServiceBus::Subscriptions::Subscription.
+      # name         - String representing the name of the new rule.
+      # filter       - A Hash representing `filter` option.
+      #
+      #               Example:
+      #
+      #               {"SqlFilterExpression" => {
+      #                 "SqlExpression" => "MyProperty='XYZ'"
+      #               }}
+      #
+      #               Becomes:
+      #
+      #               <Filter i:type="SqlFilterExpression">
+      #                 <SqlExpression>MyProperty='XYZ'</SqlExpression>
+      #               </Filter>
+      #
+      # action       - A Hash representing `action` option.
+      #
+      #               Example:
+      #
+      #               {"SqlFilterAction" => {
+      #                 "SqlExpression" => "set MyProperty2 = 'ABC'"
+      #               }}
+      #
+      #               Becomes:
+      #
+      #               <Action i:type="SqlFilterAction">
+      #                 <SqlExpression>set MyProperty2 = 'ABC'</SqlExpression>
+      #               </Action>
+      #
+      # Returns An instance of Azure::ServiceBus::Rules::Rule.
+      def self.create(subscription, name, filter=nil, action=nil, service=Services::Create.new)
+        response = service.call(subscription.topic.name, subscription.name, name, filter, action)
+
+        if response.success?
+          document = Nokogiri::XML(response.body).remove_namespaces!
+          Rule.from_document(document, subscription)
+        else
+          rule = Rule.new(name)
+          rule.error = response.error
+        end
+      end
+
+      # Public: Delete Rule.
+      #
+      # rule - An instance of Azure::ServiceBus::Rules::Rule.
+      #
+      # Returns boolean indicating success. Invalidate rule if operation fails.
+      def self.delete(rule, service=Services::Delete.new)
+        response = service.call(rule.subscription.topic.name, rule.subscription.name, rule.name)
+
+        if response.success?
+          rule.freeze
+        else
+          rule.error = response.error
+        end
+
+        response.success?
+      end
+
+      # Public: Get Rule.
+      #
+      # subscription - An instance of Subscription.
+      # name         - String representing the name of the Rule.
+      #
+      # Returns an instance of Rule. Invalidated if operation fails.
+      def self.get(subscription, name, service=Services::GetRule.new)
+        response = service.call(subscription.topic.name, subscription.name, name)
+
+        if response.success?
+          document = Nokogiri::XML(response.body).remove_namespaces!
+          Rule.from_document(document, subscription)
+        else
+          rule = Rule.new(name)
+          rule.error = response.error
+        end
+      end
+
+      # Public: List Rules in a given subscription.
+      #
+      # subscription - An instance of Subscription.
+      #
+      # Returns an Array of Rules.
+      def self.all(subscription, service=Services::ListRules.new)
+        response = service.call(subscription.topic.name, subscription.name)
+
+        rules = []
+
+        if response.success?
+          document = Nokogiri::XML(response.body).remove_namespaces!
+          (document / "entry").each do |node|
+            rules << Rule.from_document(node, subscription)
+          end
+        end
+
+        rules
+      end
+    end
+  end
+end

data/lib/azure/service_bus/rules/rule.rb

@@ -0,0 +1,97 @@
+require "azure/error"
+require "nokogiri"
+
+module Azure
+  module ServiceBus
+    module Rules
+      class Rule
+        include Azure::ErrorHandler
+
+        # Get the Rule's name.
+        attr :name
+
+        # Get Rule Subscription.
+        attr :subscription
+
+        # Get/Set filter hash.
+        attr_accessor :filter
+
+        # Get/Set action hash.
+        attr_accessor :action
+
+        # Public: Initialize Rule from a XML document.
+        #
+        # doc - An instance of Nokogiri::XML::Document.
+        #
+        # Returns an instance of Rule.
+        def self.from_document(doc, subscription)
+
+          name = (doc % "title").text
+
+          elements = ["Filter", "Action"]
+
+          elements.map! do |element_name|
+            node = (doc % element_name)
+            hash = {}
+            key = node["type"]
+            hash[key] = {}
+            node.children.each do |child|
+              hash[key][child.name] = child.content
+            end
+            hash
+          end
+
+          filter = elements.first
+          action = elements.last
+
+          new(name, subscription, filter, action)
+        end
+
+        # Public: Initialize Rule object.
+        #
+        # name   -  String representing the name of the Rule.
+        # filter - A Hash representing `filter` option.
+        #
+        #          Example:
+        #
+        #          {"SqlFilterExpression" => {
+        #            "SqlExpression" => "MyProperty='XYZ'"
+        #          }}
+        #
+        #          Becomes:
+        #
+        #          <Filter i:type="SqlFilterExpression">
+        #            <SqlExpression>MyProperty='XYZ'</SqlExpression>
+        #          </Filter>
+        #
+        # action - A Hash representing `action` option.
+        #
+        #          Example:
+        #
+        #          {"SqlFilterAction" => {
+        #            "SqlExpression" => "set MyProperty2 = 'ABC'"
+        #          }}
+        #
+        #          Becomes:
+        #
+        #          <Action i:type="SqlFilterAction">
+        #            <SqlExpression>set MyProperty2 = 'ABC'</SqlExpression>
+        #          </Action>
+        def initialize(name, subscription=nil, filter={}, action={})
+          @name = name
+          @subscription = subscription
+          @filter = filter
+          @action = action
+          yield self if block_given?
+        end
+
+        # Public: Deletes the Rule.
+        #
+        # Returns Boolean indicating success.
+        def delete(service=Azure::ServiceBus::Rules)
+          service.delete(self)
+        end
+      end
+    end
+  end
+end

data/lib/azure/service_bus/rules/service.rb

@@ -0,0 +1,122 @@
+require "azure/service_bus/rules/uri"
+require "nokogiri"
+
+module Azure
+  module ServiceBus
+    module Rules
+      class Service < Core::Service
+        def initialize(signer=Azure::ServiceBus::Auth::Wrap.new)
+          super(signer, Azure::ServiceBus::Auth::Authorizer.new)
+        end
+      end
+
+      module Services
+        # Public: Create Rule.
+        #
+        # topic_name        - String representing the name of the Topic.
+        # subscription_name - String representing the name of the Subscription.
+        # rule_name         - String representing the name of the Rule.
+        # filter            - A Hash representing `filter` option. (optional)
+        #
+        #                       Example:
+        #
+        #                       {"SqlFilterExpression" => {
+        #                         "SqlExpression" => "MyProperty='XYZ'"
+        #                       }}
+        #
+        #                       Becomes:
+        #
+        #                       <Filter i:type="SqlFilterExpression">
+        #                         <SqlExpression>MyProperty='XYZ'</SqlExpression>
+        #                       </Filter>
+        #
+        # action            - A Hash representing `action` option. (optional)
+        #
+        #                     Example:
+        #
+        #                     {"SqlFilterAction" => {
+        #                       "SqlExpression" => "set MyProperty2 = 'ABC'"
+        #                     }}
+        #
+        #                     Becomes:
+        #
+        #                     <Action i:type="SqlFilterAction">
+        #                       <SqlExpression>set MyProperty2 = 'ABC'</SqlExpression>
+        #                     </Action>  - String representing the name of the new Rule.
+        class Create < Service
+          def call(topic_name, subscription_name, rule_name, filter=nil, action=nil)
+            uri = URI.rule(topic_name, subscription_name, rule_name)
+
+            doc = Nokogiri::XML::Builder.new do |xml|
+              xml.entry(:xmlns => 'http://www.w3.org/2005/Atom') {
+                xml.content(:type => 'application/xml') {
+                  xml.RuleDescription('xmlns' => 'http://schemas.microsoft.com/netservices/2010/10/servicebus/connect',
+                                      'xmlns:i' => 'http://www.w3.org/2001/XMLSchema-instance') do |rule|
+
+                    # FIXME: Abstract this two.
+                    unless filter.nil?
+                      rule.Filter("i:type" => filter.keys.first) do |filter_node|
+                        filter[filter.keys.first].each do |k,v|
+                          filter_node.send(k, v)
+                        end
+                      end
+                    end
+
+                    unless action.nil?
+                      rule.Action("i:type" => action.keys.first) do |action_node|
+                        action[action.keys.first].each do |k,v|
+                          action_node.send(k, v)
+                        end
+                      end
+                    end
+                  end
+                }
+              }
+            end
+
+            super(:put, uri, doc.to_xml) do |request|
+              request.headers["Content-Type"] = "application/atom+xml;type=entry;charset=utf-8"
+              request.headers.delete("Content-MD5")
+            end
+          end
+        end
+
+        # Delete a Rule.
+        #
+        # topic_name        - String representing the name of the Topic.
+        # subscription_name - String representing the name of the Subscription.
+        # rule_name         - String representing the name of the Rule.
+        class Delete < Service
+          def call(topic_name, subscription_name, rule_name)
+            uri = URI.rule(topic_name, subscription_name, rule_name)
+            super(:delete, uri)
+          end
+        end
+
+        # Get a Rule.
+        #
+        # topic_name        - String representing the name of the Topic.
+        # subscription_name - String representing the name of the Subscription.
+        # rule_name         - String representing the name of the Rule.
+        class GetRule < Service
+          def call(topic_name, subscription_name, rule_name)
+            uri = URI.rule(topic_name, subscription_name, rule_name)
+            super(:get, uri)
+          end
+        end
+
+        # List Rules.
+        #
+        # topic_name        - String representing the name of the Topic.
+        # subscription_name - String representing the name of the Subscription.
+        class ListRules < Service
+          def call(topic_name, subscription_name)
+            uri = URI.collection(topic_name, subscription_name)
+            super(:get, uri)
+          end
+        end
+      end
+    end
+  end
+end
+

data/lib/azure/service_bus/rules/uri.rb

@@ -0,0 +1,39 @@
+require "azure/configuration"
+require "uri"
+
+module Azure
+  module ServiceBus
+    module Rules
+      module URI
+        # Public: Generate the URI for a given rule.
+        #
+        # topic_name        - String representing the name of the Topic.
+        # subscription_name - String representing the name of the Subscription.
+        # rule_name         - String representing the name of the new Rule.
+        #
+        # Returns a URI.
+        def self.rule(topic_name, subscription_name, rule_name, host=Azure.config.service_bus_host)
+          path = "#{topic_name}/subscriptions/#{subscription_name}/rules/#{rule_name}"
+          generate(host, path)
+        end
+
+        # Public: Generate the URI for a collection of rules.
+        #
+        # topic_name        - String representing the name of the Topic.
+        # subscription_name - String representing the name of the Subscription.
+        #
+        # Returns a URI.
+        def self.collection(topic_name, subscription_name, host=Azure.config.service_bus_host)
+          path = "#{topic_name}/subscriptions/#{subscription_name}/rules"
+          generate(host, path)
+        end
+
+        def self.generate(host, path, query={})
+          uri = ::URI.parse(File.join(host, path))
+          uri.query = ::URI.encode_www_form(query) unless query.empty?
+          uri
+        end
+      end
+    end
+  end
+end