aws-sdk-v1 1.52.0

data/lib/aws/simple_email_service/client.rb

@@ -0,0 +1,37 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SimpleEmailService
+
+    # Client class for Amazon Simple E-mail Service (SES).
+    class Client < Core::QueryClient
+
+      API_VERSION = '2010-12-01'
+
+      signature_version :Version4, 'ses'
+
+      REGION_US_E1 = 'email.us-east-1.amazonaws.com'
+
+      # @api private
+      CACHEABLE_REQUESTS = Set[]
+
+    end
+
+    class Client::V20101201 < Client
+
+      define_client_methods('2010-12-01')
+
+    end
+  end
+end

data/lib/aws/simple_email_service/config.rb

@@ -0,0 +1,18 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+AWS::Core::Configuration.module_eval do
+
+  add_service 'SimpleEmailService', 'simple_email_service', 'email'
+
+end

data/lib/aws/simple_email_service/email_address_collection.rb

@@ -0,0 +1,69 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SimpleEmailService
+
+    # Helps you manage your verified SimpleEmailService email addresses.
+    # @note This class is deprecated. Please use
+    #   {SimpleEmailService#identities} instead.
+    class EmailAddressCollection
+
+      include Core::Model
+      include Enumerable
+
+      # Requests for an email address to be verified.  An email will be
+      # sent to the given `email_address` with a link to click.  Once
+      # the link has been followed the `email_address` will be verified.
+      #
+      # @param [String] email_address The email address to verify.
+      # @return [nil]
+      # @note This method is deprecated.
+      def verify email_address
+        client.verify_email_address(:email_address => email_address)
+        nil
+      end
+      alias_method :create, :verify
+
+      # @param [String] email_address An email address to remove from the list
+      #   of verified email addresses.  Useful for cleanup as there is a 100
+      #   email address limit.
+      # @return [nil]
+      # @note This method is deprecated.
+      def delete email_address
+        client.delete_verified_email_address(:email_address => email_address)
+        nil
+      end
+
+      # @note This method is deprecated.
+      def include?
+        # this is so jruby can detect that verified? is an alias
+        super
+      end
+      alias_method :verified?, :include?
+
+      # Yields each verified email address as a string.
+      # @return [nil]
+      #   yielded.
+      # @note This method is deprecated.
+      def each &block
+        response = client.list_verified_email_addresses({})
+        response.verified_email_addresses.each do |email_address|
+          yield(email_address)
+        end
+        nil
+      end
+
+    end
+  end
+end

data/lib/aws/simple_email_service/errors.rb

@@ -0,0 +1,22 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SimpleEmailService
+    module Errors
+
+      extend Core::LazyErrorClasses
+
+    end
+  end
+end

data/lib/aws/simple_email_service/identity.rb

@@ -0,0 +1,230 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SimpleEmailService
+
+    # @attr_reader [String] verification_status
+    #
+    # @attr_reader [String,nil] verification_token
+    #
+    # @attr [String] bounce_topic_arn
+    #
+    # @attr [String] complaint_topic_arn
+    #
+    # @attr [Boolean] forwarding_enabled When `false`, complaint and bounce
+    #   notifications will not be forwarded via email.  Can only be set to
+    #   `false` when there is both a `bounce_topic` and `complaint_topic`.
+    #
+    # @attr [Boolean] dkim_enabled When set to `true`, Easy DKIM signing will
+    #   be enabled for email sent from this identity.
+    #
+    # @attr_reader [Array<String>] dkim_tokens Returns a set of DNS records,
+    #   or tokens, that must be published in the domain name's DNS to
+    #   complete the DKIM verification process.  Call {#verify_dkim} if this
+    #   returns an empty list.
+    #
+    # @attr_reader [String] dkim_verification_status
+    #
+    class Identity < Core::Resource
+
+      # @api private
+      def initialize email_address_or_domain, options = {}
+        @identity = email_address_or_domain
+        super
+      end
+
+      # @return [String] Returns the email address or domain name for
+      #   this identity.
+      attr_reader :identity
+
+      attribute :verification_status
+
+      attribute :verification_token, :static => true
+
+      mutable_attribute :dkim_enabled, :alias => :dkim_enabled?
+
+      attribute :dkim_tokens
+
+      attribute :dkim_verification_status
+
+      mutable_attribute :delivery_topic_arn, :from => :delivery_topic
+
+      mutable_attribute :bounce_topic_arn, :from => :bounce_topic
+
+      mutable_attribute :complaint_topic_arn, :from => :complaint_topic
+
+      mutable_attribute :forwarding_enabled
+
+      alias_method :forwarding_enabled?, :forwarding_enabled
+
+      provider(:get_identity_verification_attributes) do |provider|
+        provider.provides :verification_token
+        provider.provides :verification_status
+        provider.find{|resp| resp[:verification_attributes][identity] }
+      end
+
+      provider(:get_identity_notification_attributes) do |provider|
+        provider.provides :delivery_topic_arn
+        provider.provides :bounce_topic_arn
+        provider.provides :complaint_topic_arn
+        provider.provides :forwarding_enabled
+        provider.find{|resp| resp[:notification_attributes][identity] }
+      end
+
+      provider(:get_identity_dkim_attributes) do |provider|
+        provider.provides :dkim_enabled
+        provider.provides :dkim_verification_status
+        provider.provides :dkim_tokens
+        provider.find{|resp| resp[:dkim_attributes][identity] }
+      end
+
+      # @return [Array<String>] Returns an array of DKIM tokens.
+      def verify_dkim
+        if domain?
+          resp = client.verify_domain_dkim(:domain => identity)
+          resp[:dkim_tokens]
+        else
+          raise "unable to verify dkim for an email address"
+        end
+      end
+
+      # @param [String,SNS::Topic] topic The topic (ARN string or topic
+      #   object) that delivery notifications should be published to.
+      def delivery_topic= topic
+        arn = topic.respond_to?(:arn) ? topic.arn : topic
+        self.delivery_topic_arn = arn
+      end
+
+      # @return [SNS::Topic,nil]
+      def delivery_topic
+        if arn = delivery_topic_arn
+          SNS::Topic.new(arn, :config => config)
+        end
+      end
+
+      # @param [String,SNS::Topic] topic The topic (ARN string or topic
+      #   object) that bounce notifications should be published to.
+      def bounce_topic= topic
+        arn = topic.respond_to?(:arn) ? topic.arn : topic
+        self.bounce_topic_arn = arn
+      end
+
+      # @return [SNS::Topic,nil]
+      def bounce_topic
+        if arn = bounce_topic_arn
+          SNS::Topic.new(arn, :config => config)
+        end
+      end
+
+      # @param [String,SNS::Topic] topic The topic (ARN string or topic
+      #   object) that complaint notifications should be published to.
+      def complaint_topic= topic
+        arn = topic.respond_to?(:arn) ? topic.arn : topic
+        self.complaint_topic_arn = arn
+      end
+
+      # @return [SNS::Topic,nil]
+      def complaint_topic
+        if arn = complaint_topic_arn
+          SNS::Topic.new(arn, :config => config)
+        end
+      end
+
+      # @return [Boolean] Returns `true` if this {Identity} represents an
+      #   email address.
+      def email_address?
+        identity.match(/@/) ? true : false
+      end
+
+      # @return [Boolean] Returns `true` if this {Identity} represents a
+      #   domain.
+      def domain?
+        !email_address?
+      end
+
+      # @return [Boolean] Returns `true` if this email address/domain has
+      #   been verified.
+      def verified?
+        verification_status == 'Success'
+      end
+
+      # @return [Boolean] Returns `true` if verification for this email
+      #   address/domain is still pending.
+      def pending?
+        verification_status == 'Pending'
+      end
+
+      # Deletes the current identity.
+      # @return [nil]
+      def delete
+        client.delete_identity(:identity => identity)
+        nil
+      end
+
+      # @return [Boolean] Returns true if the identity exists.
+      def exists?
+        options = { :identities => [identity] }
+        resp = client.get_identity_verification_attributes(options)
+        !!resp[:verification_attributes][identity]
+      end
+
+      protected
+
+      def resource_identifiers
+        [[:identity, identity]]
+      end
+
+      def get_resource attr
+
+        method_name =
+          case attr.name.to_s
+          when /dkim/         then :get_identity_dkim_attributes
+          when /verification/ then :get_identity_verification_attributes
+          else                     :get_identity_notification_attributes
+          end
+
+        client.send(method_name, :identities => [identity])
+
+      end
+
+      def update_resource attr, value
+        client_opts = {}
+        client_opts[:identity] = identity
+        case attr.name
+        when :delivery_topic_arn
+            method = :set_identity_notification_topic
+            client_opts[:notification_type] = 'Delivery'
+            client_opts[:sns_topic] = value if value
+        when :bounce_topic_arn
+          method = :set_identity_notification_topic
+          client_opts[:notification_type] = 'Bounce'
+          client_opts[:sns_topic] = value if value
+        when :complaint_topic_arn
+          method = :set_identity_notification_topic
+          client_opts[:notification_type] = 'Complaint'
+          client_opts[:sns_topic] = value if value
+        when :forwarding_enabled
+          method = :set_identity_feedback_forwarding_enabled
+          client_opts[:forwarding_enabled] = value
+        when :dkim_enabled
+          method = :set_identity_dkim_enabled
+          client_opts[:dkim_enabled] = value
+        else raise "unhandled attribute: #{attr.name}"
+        end
+        client.send(method, client_opts)
+      end
+
+    end
+  end
+end

data/lib/aws/simple_email_service/identity_collection.rb

@@ -0,0 +1,81 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SimpleEmailService
+    class IdentityCollection
+
+      include Core::Collection::WithLimitAndNextToken
+
+      # @api private
+      def initialize options = {}
+        @type = options[:type]
+        super
+      end
+
+      # Request verification for an email address or a domain.
+      # @param [String] email_or_domain
+      # @return [Identity] Returns an {Identity} object.  Identities for
+      #   domains will have a #verification_token.
+      def verify email_or_domain
+
+        resp = email_or_domain =~ /@/ ?
+          client.verify_email_identity(:email_address => email_or_domain) :
+          client.verify_domain_identity(:domain => email_or_domain)
+
+        Identity.new(email_or_domain,
+          :verification_token => resp.data[:verification_token],
+          :config => config)
+
+      end
+      alias_method :create, :verify
+
+      # @param [String] email_or_domain
+      # @return [DomainIdentity,EmailIdentity] Returns an {Identity} with
+      #   the given email address or domain name.
+      def [] email_or_domain
+        Identity.new(email_or_domain, :config => config)
+      end
+
+      # @return [IdentityCollection] Returns a collection that only
+      #   enumerates email addresses.
+      def email_addresses
+        self.class.new(:type => 'EmailAddress', :config => config)
+      end
+
+      # @return [IdentityCollection] Returns a collection that only
+      #   enumerates domains.
+      def domains
+        self.class.new(:type => 'Domain', :config => config)
+      end
+
+      protected
+
+      def _each_item next_token, limit, options = {}, &block
+
+        options[:max_items] = limit if limit
+        options[:next_token] = next_token if next_token
+        options[:identity_type] = @type if @type
+
+        resp = client.list_identities(options)
+        resp.data[:identities].each do |identity|
+          yield(self[identity])
+        end
+
+        resp.data[:next_token]
+
+      end
+
+    end
+  end
+end