axtro-aws-ses 0.4.4

data/TODO

@@ -0,0 +1,3 @@
+* Use a better XML parser (and be consistent)
+* Rename Base to something else (probably Mailer):  Nothing else actually inherits from Base, so that is a very poor naming convention.  I intend to change it in the future
+* Integer responses should probably be cast to ints instead of left as strings

data/VERSION

@@ -0,0 +1 @@
+0.4.4

data/aws-ses.gemspec

@@ -0,0 +1,102 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{aws-ses}
+  s.version = "0.4.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Drew Blas", "Marcel Molina Jr."]
+  s.date = %q{2011-06-23}
+  s.description = %q{Client library for Amazon's Simple Email Service's REST API}
+  s.email = %q{drew.blas@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.erb",
+    "README.rdoc",
+    "TODO"
+  ]
+  s.files = [
+    ".document",
+    "CHANGELOG",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.erb",
+    "README.rdoc",
+    "Rakefile",
+    "TODO",
+    "VERSION",
+    "aws-ses.gemspec",
+    "lib/aws/actionmailer/ses_extension.rb",
+    "lib/aws/ses.rb",
+    "lib/aws/ses/addresses.rb",
+    "lib/aws/ses/base.rb",
+    "lib/aws/ses/extensions.rb",
+    "lib/aws/ses/info.rb",
+    "lib/aws/ses/response.rb",
+    "lib/aws/ses/send_email.rb",
+    "lib/aws/ses/version.rb",
+    "test/address_test.rb",
+    "test/base_test.rb",
+    "test/extensions_test.rb",
+    "test/fixtures.rb",
+    "test/helper.rb",
+    "test/info_test.rb",
+    "test/mocks/fake_response.rb",
+    "test/response_test.rb",
+    "test/send_email_test.rb"
+  ]
+  s.homepage = %q{http://github.com/drewblas/aws-ses}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.5.2}
+  s.summary = %q{Client library for Amazon's Simple Email Service's REST API}
+  s.test_files = [
+    "test/address_test.rb",
+    "test/base_test.rb",
+    "test/extensions_test.rb",
+    "test/fixtures.rb",
+    "test/helper.rb",
+    "test/info_test.rb",
+    "test/mocks/fake_response.rb",
+    "test/response_test.rb",
+    "test/send_email_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<xml-simple>, [">= 0"])
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_runtime_dependency(%q<mime-types>, [">= 0"])
+      s.add_development_dependency(%q<shoulda-context>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<flexmock>, ["~> 0.8.11"])
+    else
+      s.add_dependency(%q<xml-simple>, [">= 0"])
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<mime-types>, [">= 0"])
+      s.add_dependency(%q<shoulda-context>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<flexmock>, ["~> 0.8.11"])
+    end
+  else
+    s.add_dependency(%q<xml-simple>, [">= 0"])
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<mime-types>, [">= 0"])
+    s.add_dependency(%q<shoulda-context>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<flexmock>, ["~> 0.8.11"])
+  end
+end
+

data/axtro-aws-ses.gemspec

@@ -0,0 +1,104 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{axtro-aws-ses}
+  s.version = "0.4.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Drew Blas", "Marcel Molina Jr."]
+  s.date = %q{2011-10-31}
+  s.description = %q{Client library for Amazon's Simple Email Service's REST API}
+  s.email = %q{drew.blas@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.erb",
+    "README.rdoc",
+    "TODO"
+  ]
+  s.files = [
+    ".document",
+    "CHANGELOG",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README.erb",
+    "README.rdoc",
+    "Rakefile",
+    "TODO",
+    "VERSION",
+    "aws-ses.gemspec",
+    "axtro-aws-ses.gemspec",
+    "lib/aws/actionmailer/ses_extension.rb",
+    "lib/aws/ses.rb",
+    "lib/aws/ses/addresses.rb",
+    "lib/aws/ses/base.rb",
+    "lib/aws/ses/expirable_memoize.rb",
+    "lib/aws/ses/info.rb",
+    "lib/aws/ses/response.rb",
+    "lib/aws/ses/send_email.rb",
+    "lib/aws/ses/version.rb",
+    "test/address_test.rb",
+    "test/base_test.rb",
+    "test/expirable_memoize_test.rb",
+    "test/fixtures.rb",
+    "test/helper.rb",
+    "test/info_test.rb",
+    "test/mocks/fake_response.rb",
+    "test/response_test.rb",
+    "test/send_email_test.rb"
+  ]
+  s.homepage = %q{http://github.com/axtro/aws-ses}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Client library for Amazon's Simple Email Service's REST API}
+  s.test_files = [
+    "test/address_test.rb",
+    "test/base_test.rb",
+    "test/expirable_memoize_test.rb",
+    "test/fixtures.rb",
+    "test/helper.rb",
+    "test/info_test.rb",
+    "test/mocks/fake_response.rb",
+    "test/response_test.rb",
+    "test/send_email_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<xml-simple>, [">= 0"])
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_runtime_dependency(%q<mime-types>, [">= 0"])
+      s.add_development_dependency(%q<shoulda-context>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<flexmock>, ["~> 0.8.11"])
+    else
+      s.add_dependency(%q<xml-simple>, [">= 0"])
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<mime-types>, [">= 0"])
+      s.add_dependency(%q<shoulda-context>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<flexmock>, ["~> 0.8.11"])
+    end
+  else
+    s.add_dependency(%q<xml-simple>, [">= 0"])
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<mime-types>, [">= 0"])
+    s.add_dependency(%q<shoulda-context>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<flexmock>, ["~> 0.8.11"])
+  end
+end
+

data/lib/aws/actionmailer/ses_extension.rb

@@ -0,0 +1,19 @@
+# A quick little extension to use this lib with with rails 2.3.X
+# To use it, in your environment.rb or some_environment.rb you simply set
+#
+# config.after_initialize do
+#  ActionMailer::Base.delivery_method = :amazon_ses
+#  ActionMailer::Base.custom_amazon_ses_mailer = AWS::SES::Base.new(:secret_access_key => S3_CONFIG[:secret_access_key], :access_key_id => S3_CONFIG[:access_key_id])
+# end
+            
+module ActionMailer
+  class Base
+    cattr_accessor :custom_amazon_ses_mailer
+    
+    def perform_delivery_amazon_ses(mail)
+      raise 'AWS::SES::Base has not been intitialized.' unless @@custom_amazon_ses_mailer
+      @@custom_amazon_ses_mailer.deliver!(mail)
+    end
+
+  end
+end

data/lib/aws/ses.rb

@@ -0,0 +1,29 @@
+%w[ base64 cgi openssl digest/sha1 net/https net/http rexml/document time ostruct].each { |f| require f }
+
+begin
+  require 'URI' unless defined? URI
+rescue Exception => e
+  # nothing
+end
+
+begin
+  require 'xmlsimple' unless defined? XmlSimple
+rescue Exception => e
+  require 'xml-simple' unless defined? XmlSimple
+end
+
+$:.unshift(File.dirname(__FILE__))
+
+require 'ses/expirable_memoize'
+
+require 'ses/response'
+require 'ses/send_email'
+require 'ses/info'
+require 'ses/base'
+require 'ses/version'
+require 'ses/addresses'
+
+if defined?(Rails)
+  major, minor = Rails.version.split('.')
+  require 'actionmailer/ses_extension' if major == '2' && minor == '3'
+end

data/lib/aws/ses/addresses.rb

@@ -0,0 +1,75 @@
+module AWS
+  module SES
+    # AWS::SES::Addresses provides for:
+    # * Listing verified e-mail addresses
+    # * Adding new e-mail addresses to verify
+    # * Deleting verified e-mail addresses
+    #
+    # You can access these methods as follows:
+    #
+    #   ses = AWS::SES::Base.new( ... connection info ... )
+    #
+    #   # Get a list of verified addresses
+    #   ses.addresses.list.result
+    #
+    #   # Add a new e-mail address to verify
+    #   ses.addresses.verify('jon@example.com')
+    #
+    #   # Delete an e-mail address
+    #   ses.addresses.delete('jon@example.com')
+    class Addresses < Base
+      def initialize(ses)
+        @ses = ses
+      end
+
+      # List all verified e-mail addresses
+      # 
+      # Usage:
+      # ses.addresses.list.result
+      # =>
+      # ['email1@example.com', email2@example.com']
+      def list
+        @ses.request('ListVerifiedEmailAddresses')
+      end
+      
+      def verify(email)
+        @ses.request('VerifyEmailAddress',
+          'EmailAddress' => email
+        )
+      end
+      
+      def delete(email)
+        @ses.request('DeleteVerifiedEmailAddress',
+          'EmailAddress' => email
+        )
+      end
+    end
+    
+    class ListVerifiedEmailAddressesResponse < AWS::SES::Response
+      def result
+        if members = parsed['ListVerifiedEmailAddressesResult']['VerifiedEmailAddresses']
+          [members['member']].flatten
+        else
+          []
+        end
+      end
+      memoized :result
+    end
+    
+    class VerifyEmailAddressResponse < AWS::SES::Response
+    end
+    
+    class DeleteVerifiedEmailAddressResponse < AWS::SES::Response
+      def result
+        success?
+      end
+    end
+    
+    class Base
+      def addresses
+        @addresses ||= Addresses.new(self)
+      end
+    end
+    
+  end
+end

data/lib/aws/ses/base.rb

@@ -0,0 +1,176 @@
+module AWS #:nodoc:
+  # AWS::SES is a Ruby library for Amazon's Simple Email Service's REST API (http://aws.amazon.com/ses).
+  # 
+  # == Getting started
+  # 
+  # To get started you need to require 'aws/ses':
+  # 
+  #   % irb -rubygems
+  #   irb(main):001:0> require 'aws/ses'
+  #   # => true
+  # 
+  # Before you can do anything, you must establish a connection using Base.new.  A basic connection would look something like this:
+  # 
+  #   ses = AWS::SES::Base.new(
+  #     :access_key_id     => 'abc', 
+  #     :secret_access_key => '123'
+  #   )
+  # 
+  # The minimum connection options that you must specify are your access key id and your secret access key.
+  module SES
+    
+    API_VERSION = '2010-12-01'
+    
+    DEFAULT_HOST = 'email.us-east-1.amazonaws.com'
+    
+    USER_AGENT = 'github-aws-ses-ruby-gem'
+    
+    # Encodes the given string with the secret_access_key by taking the
+    # hmac-sha1 sum, and then base64 encoding it.  Optionally, it will also
+    # url encode the result of that to protect the string if it's going to
+    # be used as a query string parameter.
+    #
+    # @param [String] secret_access_key the user's secret access key for signing.
+    # @param [String] str the string to be hashed and encoded.
+    # @param [Boolean] urlencode whether or not to url encode the result., true or false
+    # @return [String] the signed and encoded string.
+    def SES.encode(secret_access_key, str, urlencode=true)
+      digest = OpenSSL::Digest::Digest.new('sha256')
+      b64_hmac =
+        Base64.encode64(
+          OpenSSL::HMAC.digest(digest, secret_access_key, str)).gsub("\n","")
+
+      if urlencode
+        return CGI::escape(b64_hmac)
+      else
+        return b64_hmac
+      end
+    end
+    
+    # Generates the HTTP Header String that Amazon looks for
+    # 
+    # @param [String] key the AWS Access Key ID
+    # @param [String] alg the algorithm used for the signature
+    # @param [String] sig the signature itself
+    def SES.authorization_header(key, alg, sig)
+      "AWS3-HTTPS AWSAccessKeyId=#{key}, Algorithm=#{alg}, Signature=#{sig}"
+    end
+    
+    # AWS::SES::Base is the abstract super class of all classes who make requests against SES
+    class Base   
+      include SendEmail
+      include Info
+      
+      attr_reader :use_ssl, :server, :proxy_server, :port
+
+      # @option options [String] :access_key_id ("") The user's AWS Access Key ID
+      # @option options [String] :secret_access_key ("") The user's AWS Secret Access Key
+      # @option options [Boolean] :use_ssl (true) Connect using SSL?
+      # @option options [String] :server ("email.us-east-1.amazonaws.com") The server API endpoint host
+      # @option options [String] :proxy_server (nil) An HTTP proxy server FQDN
+      # @option options [String] :user_agent ("github-aws-ses-ruby-gem") The HTTP User-Agent header value
+      # @return [Object] the object.
+      def initialize( options = {} )
+
+        options = { :access_key_id => "",
+                    :secret_access_key => "",
+                    :use_ssl => true,
+                    :server => DEFAULT_HOST,
+                    :path => "/",
+                    :user_agent => USER_AGENT,
+                    :proxy_server => nil
+                    }.merge(options)
+
+        @server = options[:server]
+        @proxy_server = options[:proxy_server]
+        @use_ssl = options[:use_ssl]
+        @path = options[:path]
+        @user_agent = options[:user_agent]
+
+        raise ArgumentError, "No :access_key_id provided" if options[:access_key_id].nil? || options[:access_key_id].empty?
+        raise ArgumentError, "No :secret_access_key provided" if options[:secret_access_key].nil? || options[:secret_access_key].empty?
+        raise ArgumentError, "No :use_ssl value provided" if options[:use_ssl].nil?
+        raise ArgumentError, "Invalid :use_ssl value provided, only 'true' or 'false' allowed" unless options[:use_ssl] == true || options[:use_ssl] == false
+        raise ArgumentError, "No :server provided" if options[:server].nil? || options[:server].empty?
+
+        if options[:port]
+          # user-specified port
+          @port = options[:port]
+        elsif @use_ssl
+          # https
+          @port = 443
+        else
+          # http
+          @port = 80
+        end
+
+        @access_key_id = options[:access_key_id]
+        @secret_access_key = options[:secret_access_key]
+
+        # Use proxy server if defined
+        # Based on patch by Mathias Dalheimer.  20070217
+        proxy = @proxy_server ? URI.parse(@proxy_server) : OpenStruct.new
+        @http = Net::HTTP::Proxy( proxy.host,
+                                  proxy.port,
+                                  proxy.user,
+                                  proxy.password).new(options[:server], @port)
+
+        @http.use_ssl = @use_ssl
+
+        # Don't verify the SSL certificates.  Avoids SSL Cert warning in log on every GET.
+        @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+      end
+      
+      attr_accessor :settings
+      
+      def connection
+        @http
+      end
+      
+      # Make the connection to AWS passing in our request.  
+      # allow us to have a one line call in each method which will do all of the work
+      # in making the actual request to AWS.
+      def request(action, params = {})
+        # Use a copy so that we don't modify the caller's Hash, remove any keys that have nil or empty values
+        params = params.reject { |key, value| value.nil? or value.empty?}
+        
+        timestamp = Time.now.getutc
+
+        params.merge!( {"Action" => action,
+                        "SignatureVersion" => "2",
+                        "SignatureMethod" => 'HmacSHA256',
+                        "AWSAccessKeyId" => @access_key_id,
+                        "Version" => API_VERSION,
+                        "Timestamp" => timestamp.iso8601 } )
+
+        query = params.sort.collect do |param|
+          CGI::escape(param[0]) + "=" + CGI::escape(param[1])
+        end.join("&")
+
+        req = {}
+
+        req['X-Amzn-Authorization'] = get_aws_auth_param(timestamp.httpdate, @secret_access_key)
+        req['Date'] = timestamp.httpdate
+        req['User-Agent'] = @user_agent 
+
+        response = connection.post(@path, query, req)
+        
+        response_class = AWS::SES.const_get( "#{action}Response" )
+        result = response_class.new(action, response)
+        
+        if result.error?
+          raise ResponseError.new(result)
+        end
+        
+        result
+      end
+
+      # Set the Authorization header using AWS signed header authentication
+      def get_aws_auth_param(timestamp, secret_access_key)
+        encoded_canonical = SES.encode(secret_access_key, timestamp, false)
+        SES.authorization_header(@access_key_id, 'HmacSHA256', encoded_canonical)
+      end
+    end # class Base
+  end # Module SES
+end # Module AWS