fog 0.9.0 → 0.10.0

data/lib/fog/aws/requests/sns/unsubscribe.rb

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/unsubscribe'
+
+        # Delete a subscription
+        #
+        # ==== Parameters
+        # * arn<~String> - Arn of subscription to delete
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_Unsubscribe.html
+        #
+
+        def unsubscribe(arn)
+          request({
+            'Action'          => 'Unsubscribe',
+            'SubscriptionArn' => arn,
+            :parser           => Fog::Parsers::AWS::SNS::Unsubscribe.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/change_message_visibility.rb

@@ -0,0 +1,33 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/basic'
+
+        # Change visibility timeout for a message
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue for message to update
+        # * receipt_handle<~String> - Token from previous recieve message
+        # * visibility_timeout<~Integer> - New visibility timeout in 0..43200
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryChangeMessageVisibility.html
+        #
+
+        def change_message_visibility(queue_url, receipt_handle, visibility_timeout)
+          request({
+            'Action'            => 'ChangeMessageVisibility',
+            'ReceiptHandle'     => receipt_handle,
+            'VisibilityTimeout' => visibility_timeout,
+            :parser             => Fog::Parsers::AWS::SQS::Basic.new,
+            :path               => path_from_queue_url(queue_url)
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/create_queue.rb

@@ -0,0 +1,31 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/create_queue'
+
+        # Create a queue
+        #
+        # ==== Parameters
+        # * name<~String> - Name of queue to create
+        # * options<~Hash>:
+        #   * DefaultVisibilityTimeout<~String> - Time, in seconds, to hide a message after it has been received, in 0..43200, defaults to 30
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryCreateQueue.html
+        #
+
+        def create_queue(name, options = {})
+          request({
+            'Action'    => 'CreateQueue',
+            'QueueName' => name,
+            :parser     => Fog::Parsers::AWS::SQS::CreateQueue.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/delete_message.rb

@@ -0,0 +1,31 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/basic'
+
+        # Delete a message from a queue
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue to delete message from
+        # * receipt_handle<~String> - Token from previous recieve message
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryDeleteMessage.html
+        #
+
+        def delete_message(queue_url, receipt_handle)
+          request({
+            'Action'        => 'DeleteMessage',
+            'ReceiptHandle' => receipt_handle,
+            :parser         => Fog::Parsers::AWS::SQS::Basic.new,
+            :path           => path_from_queue_url(queue_url),
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/delete_queue.rb

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/basic'
+
+        # Delete a queue
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue to delete
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryDeleteQueue.html
+        #
+
+        def delete_queue(queue_url)
+          request({
+            'Action' => 'DeleteQueue',
+            :parser  => Fog::Parsers::AWS::SQS::Basic.new,
+            :path    => path_from_queue_url(queue_url),
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/get_queue_attributes.rb

@@ -0,0 +1,31 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/get_queue_attributes'
+
+        # Get attributes of a queue
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue to get attributes for
+        # * attribute_name<~Array> - Name of attribute to return, in ['All', 'ApproximateNumberOfMessages', 'ApproximateNumberOfMessagesNotVisible', 'CreatedTimestamp', 'LastModifiedTimestamp', 'MaximumMessageSize', 'MessageRetentionPeriod', 'Policy', 'QueueArn', 'VisibilityTimeout']
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryGetQueueAttributes.html
+        #
+
+        def get_queue_attributes(queue_url, attribute_name)
+          request({
+            'Action'        => 'GetQueueAttributes',
+            'AttributeName' => attribute_name,
+            :path           => path_from_queue_url(queue_url),
+            :parser         => Fog::Parsers::AWS::SQS::GetQueueAttributes.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/list_queues.rb

@@ -0,0 +1,28 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/list_queues'
+
+        # List queues
+        #
+        # ==== Parameters
+        # * options<~Hash>:
+        #   * QueueNamePrefix<~String> - String used to filter results to only those with matching prefixes
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryListQueues.html
+        #
+
+        def list_queues(options = {})
+          request({
+            'Action' => 'ListQueues',
+            :parser  => Fog::Parsers::AWS::SQS::ListQueues.new
+          }.merge!(options))
+        end
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/receive_message.rb

@@ -0,0 +1,34 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/receive_message'
+
+        # Get a message from a queue (marks it as unavailable temporarily, but does not remove from queue, see delete_message)
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue to get message from
+        # * options<~Hash>:
+        #   * Attributes<~Array> - List of attributes to return, in ['All', 'ApproximateFirstReceiveTimestamp', 'ApproximateReceiveCount', 'SenderId', 'SentTimestamp'], defaults to 'All'
+        #   * MaxNumberOfMessages<~Integer> - Maximum number of messages to return, defaults to 1
+        #   * VisibilityTimeout<~Integer> - Duration, in seconds, to hide message from other receives. In 0..43200, defaults to visibility timeout for queue
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QueryReceiveMessage.html
+        #
+
+        def receive_message(queue_url, options = {})
+          request({
+            'Action'        => 'ReceiveMessage',
+            'AttributeName' => 'All',
+            :path           => path_from_queue_url(queue_url),
+            :parser         => Fog::Parsers::AWS::SQS::ReceiveMessage.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/send_message.rb

@@ -0,0 +1,31 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/send_message'
+
+        # Add a message to a queue
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue to add message to
+        # * message<~String> - Message to add to queue
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QuerySendMessage.html
+        #
+
+        def send_message(queue_url, message)
+          request({
+            'Action'      => 'SendMessage',
+            'MessageBody' => message,
+            :path         => path_from_queue_url(queue_url),
+            :parser       => Fog::Parsers::AWS::SQS::SendMessage.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/sqs/set_queue_attributes.rb

@@ -0,0 +1,33 @@
+module Fog
+  module AWS
+    class SQS
+      class Real
+
+        require 'fog/aws/parsers/sqs/basic'
+
+        # Get attributes of a queue
+        #
+        # ==== Parameters
+        # * queue_url<~String> - Url of queue to get attributes for
+        # * attribute_name<~String> - Name of attribute to set, keys in ['MaximumMessageSize', 'MessageRetentionPeriod', 'Policy', 'VisibilityTimeout']
+        # * attribute_value<~String> - Value to set for attribute
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AWSSimpleQueueService/latest/APIReference/Query_QuerySetQueueAttributes.html
+        #
+
+        def set_queue_attributes(queue_url, attribute_name, attribute_value)
+          request({
+            'Action'          => 'SetQueueAttributes',
+            'Attribute.Name'  => attribute_name,
+            'Attribute.Value' => attribute_value,
+            :path             => path_from_queue_url(queue_url),
+            :parser           => Fog::Parsers::AWS::SQS::Basic.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/sns.rb

@@ -0,0 +1,112 @@
+module Fog
+  module AWS
+    class SNS < Fog::Service
+
+      requires :aws_access_key_id, :aws_secret_access_key
+      recognizes :host, :path, :port, :scheme, :persistent
+
+      request_path 'fog/aws/requests/sns'
+      request :add_permission
+      request :confirm_subscription
+      request :create_topic
+      request :delete_topic
+      request :get_topic_attributes
+      request :list_subscriptions
+      request :list_subscriptions_by_topic
+      request :list_topics
+      request :publish
+      request :remove_permission
+      request :set_topic_attributes
+      request :subscribe
+      request :unsubscribe
+
+      class Mock
+
+        def initialize(options={})
+        end
+
+      end
+
+      class Real
+
+        # Initialize connection to SNS
+        #
+        # ==== Notes
+        # options parameter must include values for :aws_access_key_id and
+        # :aws_secret_access_key in order to create a connection
+        #
+        # ==== Examples
+        #   sns = SNS.new(
+        #    :aws_access_key_id => your_aws_access_key_id,
+        #    :aws_secret_access_key => your_aws_secret_access_key
+        #   )
+        #
+        # ==== Parameters
+        # * options<~Hash> - config arguments for connection.  Defaults to {}.
+        #
+        # ==== Returns
+        # * SNS object with connection to AWS.
+        def initialize(options={})
+          require 'multi_json'
+          @aws_access_key_id      = options[:aws_access_key_id]
+          @aws_secret_access_key  = options[:aws_secret_access_key]
+          @hmac       = Fog::HMAC.new('sha256', @aws_secret_access_key)
+
+          options[:region] ||= 'us-east-1'
+          @host = options[:host] || case options[:region]
+          when 'ap-southeast-1'
+            'sns.ap-southeast-1.amazonaws.com'
+          when 'eu-west-1'
+            'sns.eu-west-1.amazonaws.com'
+          when 'us-east-1'
+            'sns.us-east-1.amazonaws.com'
+          when 'us-west-1'
+            'sns.us-west-1.amazonaws.com'
+          else
+            raise ArgumentError, "Unknown region: #{options[:region].inspect}"
+          end
+
+          @path       = options[:path]      || '/'
+          @port       = options[:port]      || 443
+          @scheme     = options[:scheme]    || 'https'
+          @connection = Fog::Connection.new("#{@scheme}://#{@host}:#{@port}#{@path}", options[:persistent])
+        end
+
+        def reload
+          @connection.reset
+        end
+
+        private
+
+        def request(params)
+          idempotent  = params.delete(:idempotent)
+          parser      = params.delete(:parser)
+
+          body = AWS.signed_params(
+            params,
+            {
+              :aws_access_key_id  => @aws_access_key_id,
+              :hmac               => @hmac,
+              :host               => @host,
+              :path               => @path,
+              :port               => @port
+            }
+          )
+
+          response = @connection.request({
+            :body       => body,
+            :expects    => 200,
+            :idempotent => idempotent,
+            :headers    => { 'Content-Type' => 'application/x-www-form-urlencoded' },
+            :host       => @host,
+            :method     => 'POST',
+            :parser     => parser
+          })
+
+          response
+        end
+
+      end
+    end
+  end
+end

data/lib/fog/aws/sqs.rb

@@ -0,0 +1,115 @@
+module Fog
+  module AWS
+    class SQS < Fog::Service
+
+      requires :aws_access_key_id, :aws_secret_access_key
+      recognizes :region, :host, :path, :port, :scheme, :persistent
+
+      request_path 'fog/aws/requests/sqs'
+      request :change_message_visibility
+      request :create_queue
+      request :delete_message
+      request :delete_queue
+      request :get_queue_attributes
+      request :list_queues
+      request :receive_message
+      request :send_message
+      request :set_queue_attributes
+
+      class Mock
+
+        def initialize(options={})
+        end
+
+      end
+
+      class Real
+
+        # Initialize connection to SQS
+        #
+        # ==== Notes
+        # options parameter must include values for :aws_access_key_id and
+        # :aws_secret_access_key in order to create a connection
+        #
+        # ==== Examples
+        #   sqs = SQS.new(
+        #    :aws_access_key_id => your_aws_access_key_id,
+        #    :aws_secret_access_key => your_aws_secret_access_key
+        #   )
+        #
+        # ==== Parameters
+        # * options<~Hash> - config arguments for connection.  Defaults to {}.
+        #   * region<~String> - optional region to use, in ['eu-west-1', 'us-east-1', 'us-west-1', 'ap-southeast-1']
+        #
+        # ==== Returns
+        # * SQS object with connection to AWS.
+        def initialize(options={})
+          @aws_access_key_id      = options[:aws_access_key_id]
+          @aws_secret_access_key  = options[:aws_secret_access_key]
+          @hmac = Fog::HMAC.new('sha256', @aws_secret_access_key)
+          options[:region] ||= 'us-east-1'
+          @host = options[:host] || case options[:region]
+          when 'ap-southeast-1'
+            'ap-southeast-1.queue.amazonaws.com'
+          when 'eu-west-1'
+            'eu-west-1.queue.amazonaws.com'
+          when 'us-east-1'
+            'queue.amazonaws.com'
+          when 'us-west-1'
+            'us-west-1.queue.amazonaws.com'
+          else
+            raise ArgumentError, "Unknown region: #{options[:region].inspect}"
+          end
+          @path       = options[:path]      || '/'
+          @port       = options[:port]      || 443
+          @scheme     = options[:scheme]    || 'https'
+          @connection = Fog::Connection.new("#{@scheme}://#{@host}:#{@port}#{@path}", options[:persistent])
+        end
+
+        def reload
+          @connection.reset
+        end
+
+        private
+
+        def path_from_queue_url(queue_url)
+          queue_url.split('.com', 2).last
+        end
+
+        def request(params)
+          idempotent  = params.delete(:idempotent)
+          parser      = params.delete(:parser)
+          path        = params.delete(:path)
+
+          body = AWS.signed_params(
+            params,
+            {
+              :aws_access_key_id  => @aws_access_key_id,
+              :hmac               => @hmac,
+              :host               => @host,
+              :path               => path || @path,
+              :port               => @port,
+              :version            => '2009-02-01'
+            }
+          )
+
+          args = {
+            :body       => body,
+            :expects    => 200,
+            :idempotent => idempotent,
+            :headers    => { 'Content-Type' => 'application/x-www-form-urlencoded' },
+            :host       => @host,
+            :method     => 'POST',
+            :parser     => parser
+          }
+          args.merge!(:path => path) if path
+
+          response = @connection.request(args)
+
+          response
+        end
+
+      end
+    end
+  end
+end