fog 0.9.0 → 0.10.0

data/lib/fog/aws/requests/simpledb/get_attributes.rb

@@ -13,11 +13,13 @@ module Fog
         # * item_name<~String> - Name of the item.  May use any UTF-8 characters valid
         #   in xml.  Control characters and sequences not allowed in xml are not
         #   valid.  Can be up to 1024 bytes long.
-        # * attributes<~Array> - Attributes to return from the item.  Defaults to
-        #   {}, which will return all attributes. Attribute names and values may use
-        #   any UTF-8 characters valid in xml. Control characters and sequences not 
-        #   allowed in xml are not valid.  Each name and value can be up to 1024
-        #   bytes long.
+        # * options<~Hash>:
+        #   * AttributeName<~Array> - Attributes to return from the item.  Defaults to
+        #     {}, which will return all attributes. Attribute names and values may use
+        #     any UTF-8 characters valid in xml. Control characters and sequences not
+        #     allowed in xml are not valid.  Each name and value can be up to 1024
+        #     bytes long.
+        #    * ConsistentRead<~Boolean> - When set to true, ensures most recent data is returned. Defaults to false.
         #
         # ==== Returns
         # * response<~Excon::Response>:
@@ -25,28 +27,38 @@ module Fog
         #     * 'Attributes' - list of attribute name/values for the item
         #     * 'BoxUsage'
         #     * 'RequestId'
-        def get_attributes(domain_name, item_name, attributes = {})
-          
+        def get_attributes(domain_name, item_name, options = {})
+          if options.is_a?(Array)
+            Formatador.display_line("[yellow][WARN] get_attributes with array attributes param is deprecated, use 'AttributeName' => attributes) instead[/] [light_black](#{caller.first})[/]")
+            options = {'AttributeName' => options}
+          end
+          options['AttributeName'] ||= []
           request({
-            'Action'      => 'GetAttributes',
-            'DomainName'  => domain_name,
-            'ItemName'    => item_name,
-            :idempotent   => true,
-            :parser       => Fog::Parsers::AWS::SimpleDB::GetAttributes.new(@nil_string)
-          }.merge!(encode_attribute_names(attributes)))
+            'Action'          => 'GetAttributes',
+            'ConsistentRead'  => !!options['ConsistentRead'],
+            'DomainName'      => domain_name,
+            'ItemName'        => item_name,
+            :idempotent       => true,
+            :parser           => Fog::Parsers::AWS::SimpleDB::GetAttributes.new(@nil_string)
+          }.merge!(encode_attribute_names(options['AttributeName'])))
         end
 
       end
 
       class Mock
 
-        def get_attributes(domain_name, item_name, attributes = nil)
+        def get_attributes(domain_name, item_name, options = {})
+          if options.is_a?(Array)
+            Formatador.display_line("[yellow][WARN] get_attributes with array attributes param is deprecated, use 'AttributeName' => attributes) instead[/] [light_black](#{caller.first})[/]")
+            options['AttributeName'] ||= options if options.is_a?(Array)
+          end
+          options['AttributeName'] ||= []
           response = Excon::Response.new
           if self.data[:domains][domain_name]
             object = {}
-            if attributes
-              for attribute in attributes
-                if self.data[:domains][domain_name][item_name] && self.data[:domains][domain_name][item_name]
+            if !options['AttributeName'].empty?
+              for attribute in options['AttributeName']
+                if self.data[:domains][domain_name].has_key?(item_name) && self.data[:domains][domain_name][item_name].has_key?(attribute)
                   object[attribute] = self.data[:domains][domain_name][item_name][attribute]
                 end
               end

data/lib/fog/aws/requests/simpledb/select.rb

@@ -9,7 +9,9 @@ module Fog
         #
         # ==== Parameters
         # * select_expression<~String> - Expression to query domain with.
-        # * next_token<~String> - Offset token to start list, defaults to nil.
+        # * options<~Hash>:
+        #   * ConsistentRead<~Boolean> - When set to true, ensures most recent data is returned. Defaults to false.
+        #   * NextToken<~String> - Offset token to start list, defaults to nil.
         #
         # ==== Returns
         # * response<~Excon::Response>:
@@ -19,10 +21,16 @@ module Fog
         #     * 'Items'<~Hash> - list of attribute name/values for the items formatted as 
         #       { 'item_name' => { 'attribute_name' => ['attribute_value'] }}
         #     * 'NextToken'<~String> - offset to start with if there are are more domains to list
-        def select(select_expression, next_token = nil)
+        def select(select_expression, options = {})
+          if options.is_a?(String)
+            Formatador.display_line("[yellow][WARN] get_attributes with string next_token param is deprecated, use 'AttributeName' => attributes) instead[/] [light_black](#{caller.first})[/]")
+            options = {'NextToken' => options}
+          end
+          options['NextToken'] ||= nil
           request(
             'Action'            => 'Select',
-            'NextToken'         => next_token,
+            'ConsistentRead'    => !!options['ConsistentRead'],
+            'NextToken'         => options['NextToken'],
             'SelectExpression'  => select_expression,
             :idempotent         => true,
             :parser             => Fog::Parsers::AWS::SimpleDB::Select.new(@nil_string)

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

@@ -0,0 +1,26 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/add_permission'
+
+        def add_permission(options = {})
+          request({
+            'Action'  => 'AddPermission',
+            :parser   => Fog::Parsers::AWS::SNS::AddPermission.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def add_permission(options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/confirm_subscription'
+
+        # Confirm a subscription
+        #
+        # ==== Parameters
+        # * arn<~String> - Arn of topic to confirm subscription to
+        # * token<~String> - Token sent to endpoint during subscribe action
+        # * options<~Hash>:
+        #   * AuthenticateOnUnsubscribe<~Boolean> - whether or not unsubscription should be authenticated, defaults to false
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_ConfirmSubscription.html
+        #
+
+        def confirm_subscription(arn, token, options = {})
+          request({
+            'Action'    => 'ConfirmSubscription',
+            'Token'     => token,
+            'TopicArn'  => arn,
+            :parser     => Fog::Parsers::AWS::SNS::ConfirmSubscription.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/create_topic'
+
+        # Create a topic
+        #
+        # ==== Parameters
+        # * name<~String> - Name of topic to create
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_CreateTopic.html
+        #
+
+        def create_topic(name)
+          request({
+            'Action'  => 'CreateTopic',
+            'Name'    => name,
+            :parser   => Fog::Parsers::AWS::SNS::CreateTopic.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

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

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

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

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/get_topic_attributes'
+
+        # Get attributes of a topic
+        #
+        # ==== Parameters
+        # * arn<~Hash>: The Arn of the topic to get attributes for
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_GetTopicAttributes.html
+        #
+
+        def get_topic_attributes(arn)
+          request({
+            'Action'    => 'GetTopicAttributes',
+            'TopicArn'  => arn,
+            :parser     => Fog::Parsers::AWS::SNS::GetTopicAttributes.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/list_subscriptions'
+
+        # List subscriptions
+        #
+        # ==== Parameters
+        # * options<~Hash>:
+        #   * 'NextToken'<~String> - Token returned from previous request, used for pagination
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_ListSubscriptions.html
+        #
+
+        def list_subscriptions(options = {})
+          request({
+            'Action' => 'ListSubscriptions',
+            :parser  => Fog::Parsers::AWS::SNS::ListSubscriptions.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/list_subscriptions'
+
+        # List subscriptions for a topic
+        #
+        # ==== Parameters
+        # * arn<~String> - Arn of topic to list subscriptions for
+        # * options<~Hash>:
+        #   * 'NextToken'<~String> - Token returned from previous request, used for pagination
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_ListSubscriptionsByTopic.html
+        #
+
+        def list_subscriptions_by_topic(arn, options = {})
+          request({
+            'Action'    => 'ListSubscriptionsByTopic',
+            'TopicArn'  => arn,
+            :parser     => Fog::Parsers::AWS::SNS::ListSubscriptions.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/list_topics'
+
+        # List topics
+        #
+        # ==== Parameters
+        # * options<~Hash>:
+        #   * 'NextToken'<~String> - Token returned from previous request, used for pagination
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_ListTopics.html
+        #
+
+        def list_topics(options = {})
+          request({
+            'Action'  => 'ListTopics',
+            :parser   => Fog::Parsers::AWS::SNS::ListTopics.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/publish'
+
+        # Send a message to a topic
+        #
+        # ==== Parameters
+        # * arn<~String> - Arn of topic to send message to
+        # * message<~String> - Message to send to topic
+        # * options<~Hash>:
+        #   * MessageStructure<~String> - message structure, in ['json']
+        #   * Subject<~String> - value to use for subject when delivering by email
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_Publish.html
+        #
+
+        def publish(arn, message, options = {})
+          request({
+            'Action'    => 'Publish',
+            'Message'   => message,
+            'TopicArn'  => arn,
+            :parser     => Fog::Parsers::AWS::SNS::Publish.new
+          }.merge!(options))
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/remove_permission'
+
+        def remove_permission(options = {})
+          request({
+            'Action'  => 'RemovePermission',
+            :parser   => Fog::Parsers::AWS::SNS::RemovePermission.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def remove_permission(options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/set_topic_attributes'
+
+        # Set attributes of a topic
+        #
+        # ==== Parameters
+        # * arn<~Hash> - The Arn of the topic to get attributes for
+        # * attribute_name<~String> - Name of attribute to set, in ['DisplayName', 'Policy']
+        # * attribute_value<~String> - Value to set attribute to
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_SetTopicAttributes.html
+        #
+
+        def set_topic_attributes(arn, attribute_name, attribute_value)
+          request({
+            'Action'          => 'SetTopicAttributes',
+            'AttributeName'   => attribute_name,
+            'AttributeValue'  => attribute_value,
+            'TopicArn'        => arn,
+            :parser     => Fog::Parsers::AWS::SNS::SetTopicAttributes.new
+          })
+        end
+
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Fog
+  module AWS
+    class SNS
+      class Real
+
+        require 'fog/aws/parsers/sns/subscribe'
+
+        # Create a subscription
+        #
+        # ==== Parameters
+        # * arn<~String> - Arn of topic to subscribe to
+        # * endpoint<~String> - Endpoint to notify
+        # * protocol<~String> - Protocol to notify endpoint with, in ['email', 'email-json', 'http', 'https', 'sqs']
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/sns/latest/api/API_Subscribe.html
+        #
+
+        def subscribe(arn, endpoint, protocol)
+          request({
+            'Action'    => 'Subscribe',
+            'Endpoint'  => endpoint,
+            'Protocol'  => protocol,
+            'TopicArn'  => arn,
+            :parser     => Fog::Parsers::AWS::SNS::Subscribe.new
+          })
+        end
+
+      end
+
+    end
+  end
+end