aws-ses 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/CHANGELOG

@@ -0,0 +1,6 @@
+head:
+- Initial creation that supports:
+
+* addresses.list
+* addresses.verify(email)
+* addresses.delete(email)

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+  gem "rcov", ">= 0"
+  gem 'flexmock', '~> 0.8.11'
+end
+
+gem 'xml-simple'
+gem 'builder'
+gem 'mime-types'

data/Gemfile.lock

@@ -0,0 +1,28 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    builder (3.0.0)
+    flexmock (0.8.11)
+    git (1.2.5)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    mime-types (1.16)
+    rake (0.8.7)
+    rcov (0.9.9)
+    shoulda (2.11.3)
+    xml-simple (1.0.13)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  builder
+  bundler (~> 1.0.0)
+  flexmock (~> 0.8.11)
+  jeweler (~> 1.5.2)
+  mime-types
+  rcov
+  shoulda
+  xml-simple

data/LICENSE

@@ -0,0 +1,20 @@
+
+Copyright (c) 2011 Drew V. Blas <drew.blas@gmail.com>
+Copyright (c) 2006-2009 Marcel Molina Jr. <marcel@vernix.org>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in the
+Software without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,47 @@
+= AWS::SES
+
+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.
+
+
+= Addresses
+
+AWS::SES::Addresses provides for:
+* Listing verified e-mail addresses
+* Adding new e-mail addresses to verify
+* Deleting verified e-mail addresses
+
+
+== Contributing to aws-ses
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Drew Blas. See LICENSE for further details.
+
+== Thanks
+
+Special thanks to Marcel Molina Jr. for his creation of AWS::S3 which I used portions of to get things working.

data/README.erb

@@ -0,0 +1,25 @@
+= AWS::SES
+
+<%= docs_for['AWS::SES'] %>
+
+= Addresses
+
+<%= docs_for['AWS::SES::Addresses'] %>
+
+== Contributing to aws-ses
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Drew Blas. See LICENSE for further details.
+
+== Thanks
+
+Special thanks to Marcel Molina Jr. for his creation of AWS::S3 which I used portions of to get things working.

data/Rakefile

@@ -0,0 +1,85 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'erb'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "aws-ses"
+  gem.homepage = "http://github.com/drewblas/aws-ses"
+  gem.license = "MIT"
+  gem.summary = %Q{Client library for Amazon's Simple Email Service's REST API}
+  gem.description = gem.summary
+  gem.email = "drew.blas@gmail.com"
+  gem.authors = ["Drew Blas", 'Marcel Molina Jr.']
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+  gem.add_dependency 'xml-simple'
+  gem.add_dependency 'builder'
+  gem.add_dependency 'mime-types'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+require File.dirname(__FILE__) + '/lib/aws/ses'
+
+namespace :doc do
+  Rake::RDocTask.new do |rdoc|  
+    rdoc.rdoc_dir = 'doc'  
+    version = File.exist?('VERSION') ? File.read('VERSION') : ""
+    rdoc.title    = "AWS::SES -- Support for Amazon SES's REST api #{version}"  
+    rdoc.options << '--line-numbers' << '--inline-source'
+    rdoc.rdoc_files.include('README')
+    rdoc.rdoc_files.include('COPYING')
+    rdoc.rdoc_files.include('lib/**/*.rb')
+  end
+  
+  task :rdoc => 'doc:readme'
+  
+  task :refresh => :rerdoc do
+    system 'open doc/index.html'
+  end
+
+  task :readme do
+    require 'support/rdoc/code_info'
+    RDoc::CodeInfo.parse('lib/**/*.rb')
+    
+    strip_comments = lambda {|comment| comment.gsub(/^# ?/, '')}
+    docs_for       = lambda do |location| 
+      info = RDoc::CodeInfo.for(location)
+      raise RuntimeError, "Couldn't find documentation for `#{location}'" unless info
+      strip_comments[info.comment]
+    end
+    
+    open('README', 'w') do |file|
+      file.write ERB.new(IO.read('README.erb')).result(binding)
+    end
+  end
+end

data/TODO

@@ -0,0 +1,2 @@
+* Implement the rest of the API
+* Use a better XML parser (and be consistent)

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/aws/ses.rb

@@ -0,0 +1,22 @@
+%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/extensions'
+
+require 'ses/base'
+require 'ses/response'
+require 'ses/exceptions'
+require 'ses/version'
+require 'ses/addresses'

data/lib/aws/ses/addresses.rb

@@ -0,0 +1,61 @@
+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
+    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['VerifiedEmailAddresses']
+          [members['member']].flatten
+        else
+          []
+        end
+      end
+    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,213 @@
+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'
+    
+    # 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   
+      
+      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
+      # @return [Object] the object.
+      def initialize( options = {} )
+
+        options = { :access_key_id => "",
+                    :secret_access_key => "",
+                    :use_ssl => true,
+                    :server => DEFAULT_HOST,
+                    :path => "/",
+                    :proxy_server => nil
+                    }.merge(options)
+
+        @server = options[:server]
+        @proxy_server = options[:proxy_server]
+        @use_ssl = options[:use_ssl]
+        @path = options[:path]
+
+        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
+      
+      def connection
+        @http
+      end
+      
+      # Make the connection to AWS EC2 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 = {})
+
+        connection.start do
+          # remove any keys that have nil or empty values
+          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 = Net::HTTP::Post.new(@path)
+          req.content_type = 'application/x-www-form-urlencoded'
+          req['X-Amzn-Authorization'] = get_aws_auth_param(timestamp.httpdate, @secret_access_key)
+          req['Date'] = timestamp.httpdate
+          req['User-Agent'] = "github-aws-ses-ruby-gem"
+
+          response = connection.request(req, query)
+
+          # Make a call to see if we need to throw an error based on the response given by EC2
+          # All error classes are defined in EC2/exceptions.rb
+          aws_error?(response)
+          
+          response_class = AWS::SES.const_get( "#{action}Response" )
+          return response_class.new(action, response)
+        end
+
+      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
+
+      # Raises the appropriate error if the specified Net::HTTPResponse object
+      # contains an AWS error; returns +false+ otherwise.
+      def aws_error?(response)
+        # return false if we got a HTTP 200 code,
+        # otherwise there is some type of error (40x,50x) and
+        # we should try to raise an appropriate exception
+        # from one of our exception classes defined in
+        # exceptions.rb
+        return false if response.is_a?(Net::HTTPSuccess)
+
+        raise AWS::Error, "Unexpected server error. response.body is: #{response.body}" if response.is_a?(Net::HTTPServerError)
+
+        # parse the XML document so we can walk through it
+        doc = REXML::Document.new(response.body)
+
+        # Check that the Error element is in the place we would expect.
+        # and if not raise a generic error exception
+        unless doc.root.elements['Error'].name == 'Error'
+          raise Error, "Unexpected error format. response.body is: #{response.body}"
+        end
+
+        # An valid error response looks like this:
+        # <?xml version="1.0"?><Response><Errors><Error><Code>InvalidParameterCombination</Code><Message>Unknown parameter: foo</Message></Error></Errors><RequestID>291cef62-3e86-414b-900e-17246eccfae8</RequestID></Response>
+        # AWS throws some exception codes that look like Error.SubError.  Since we can't name classes this way
+        # we need to strip out the '.' in the error 'Code' and we name the error exceptions with this
+        # non '.' name as well.
+        error_code    = doc.root.elements['Error'].elements['Code'].text.gsub('.', '')
+        error_message = doc.root.elements['Error'].elements['Message'].text
+
+        # Raise one of our specific error classes if it exists.
+        # otherwise, throw a generic EC2 Error with a few details.
+        if AWS.const_defined?(error_code)
+          raise AWS.const_get(error_code), error_message
+        else
+          raise AWS::Error, error_message
+        end
+
+      end
+         
+      class << self
+        
+        
+      end # class methods
+    end # class Base
+  end # Module SES
+end # Module AWS