sendgrid_toolkit 1.0.7 → 1.1.0

data/README.md

@@ -10,6 +10,7 @@ SendgridToolkit provides a class for interacting with each of the following Send
 
   - Bounces
   - InvalidEmails
+  - Mail
   - SpamReports
   - Statistics
   - Unsubscribes
@@ -108,6 +109,21 @@ If you believe a once-invalid email address is now valid and would like Sendgrid
 
     invalid_emails.delete :email => "email@address.of.invalid.to.delete"
 
+Mail Module
+-----------
+
+The Mail module lets you send email via the web API.
+
+- - -
+
+Call `:send_email` (chosen to avoid conflicts with Object:send) with the standard parameters:
+
+    SendgridToolkit::Mail.new(api_user, api_key).send_email :to => "user@domain.com", :from => "recipient@domain.com", :subject => "Some Subject", :text => "Some text"
+
+The complete set of "x-smtpapi" options are also supported. You can use them like:
+
+  SendgridToolkit::Mail.new(api_user, api_key).send_email :to => "user@domain.com", :from => "recipient@domain.com", :subject => "Some Subject", :text => "Some text", "x-smtpapi" => {:category => "Retention"}
+
 SpamReports Module
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.0.7
+1.1.0

data/lib/sendgrid_toolkit.rb

@@ -8,6 +8,7 @@ require 'sendgrid_toolkit/unsubscribes'
 require 'sendgrid_toolkit/spam_reports'
 require 'sendgrid_toolkit/bounces'
 require 'sendgrid_toolkit/invalid_emails'
+require 'sendgrid_toolkit/mail'
 
 module SendgridToolkit
   BASE_URI = "sendgrid.com/api"

data/lib/sendgrid_toolkit/mail.rb

@@ -0,0 +1,9 @@
+module SendgridToolkit
+  class Mail < AbstractSendgridClient
+    def send_mail(options = {})
+      response = api_post('mail', 'send', options)
+      raise(SendEmailError, "SendMail API refused to send email: #{response["errors"].inspect}") if response["message"] == "error"
+      response
+    end
+  end
+end

data/lib/sendgrid_toolkit/sendgrid_error.rb

@@ -4,6 +4,7 @@ module SendgridToolkit
   class NoAPIUserSpecified < StandardError; end
   class UnsubscribeEmailAlreadyExists < StandardError; end
   class UnsubscribeEmailDoesNotExist < StandardError; end
+  class SendEmailError < StandardError; end
   class EmailDoesNotExist < StandardError; end
   class SendgridServerError < StandardError; end
   class APIError < StandardError; end

data/sendgrid_toolkit.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "sendgrid_toolkit"
-  s.version = "1.0.7"
+  s.version = "1.1.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Robby Grossman"]
@@ -29,6 +29,7 @@ Gem::Specification.new do |s|
     "lib/sendgrid_toolkit/bounces.rb",
     "lib/sendgrid_toolkit/common.rb",
     "lib/sendgrid_toolkit/invalid_emails.rb",
+    "lib/sendgrid_toolkit/mail.rb",
     "lib/sendgrid_toolkit/sendgrid_error.rb",
     "lib/sendgrid_toolkit/spam_reports.rb",
     "lib/sendgrid_toolkit/statistics.rb",
@@ -39,6 +40,7 @@ Gem::Specification.new do |s|
     "spec/lib/sendgrid_toolkit/bounces_spec.rb",
     "spec/lib/sendgrid_toolkit/common_spec.rb",
     "spec/lib/sendgrid_toolkit/invalid_emails_spec.rb",
+    "spec/lib/sendgrid_toolkit/mail_spec.rb",
     "spec/lib/sendgrid_toolkit/spam_reports_spec.rb",
     "spec/lib/sendgrid_toolkit/statistics_spec.rb",
     "spec/lib/sendgrid_toolkit/unsubscribes_spec.rb",

data/spec/lib/sendgrid_toolkit/mail_spec.rb

@@ -0,0 +1,17 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../../helper")
+
+describe SendgridToolkit::Mail do
+  before do
+    FakeWeb.clean_registry
+    @obj = SendgridToolkit::Mail.new("fakeuser", "fakepass")
+  end
+  
+  describe "#send" do
+    it "raises error when sendgrid returns an error" do
+      FakeWeb.register_uri(:post, %r|https://sendgrid\.com/api/mail\.send\.json\?|, :body => '{"message": "error", "errors": ["Missing destination email"]}')
+      lambda {
+        response = @obj.send_mail :from => "testing@fiverr.com", :subject => "Subject", :text => "Text", "x-smtpapi" => {:category => "Testing", :to => ["elad@fiverr.com"]}
+      }.should raise_error SendgridToolkit::SendEmailError
+    end
+  end  
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sendgrid_toolkit
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2011-11-01 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
-  requirement: &70243631139020 !ruby/object:Gem::Requirement
+  requirement: &70223621474660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 0.7.6
   type: :runtime
   prerelease: false
-  version_requirements: *70243631139020
+  version_requirements: *70223621474660
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70243631138360 !ruby/object:Gem::Requirement
+  requirement: &70223621472980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *70243631138360
+  version_requirements: *70223621472980
 - !ruby/object:Gem::Dependency
   name: fakeweb
-  requirement: &70243631137700 !ruby/object:Gem::Requirement
+  requirement: &70223621461680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 1.3.0
   type: :development
   prerelease: false
-  version_requirements: *70243631137700
+  version_requirements: *70223621461680
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &70243631137040 !ruby/object:Gem::Requirement
+  requirement: &70223621460080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *70243631137040
+  version_requirements: *70223621460080
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70243631136380 !ruby/object:Gem::Requirement
+  requirement: &70223621457860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,7 +65,7 @@ dependencies:
         version: 2.7.0
   type: :development
   prerelease: false
-  version_requirements: *70243631136380
+  version_requirements: *70223621457860
 description: A Ruby wrapper and utility library for communicating with the Sendgrid
   API.
 email: robby@freerobby.com
@@ -87,6 +87,7 @@ files:
 - lib/sendgrid_toolkit/bounces.rb
 - lib/sendgrid_toolkit/common.rb
 - lib/sendgrid_toolkit/invalid_emails.rb
+- lib/sendgrid_toolkit/mail.rb
 - lib/sendgrid_toolkit/sendgrid_error.rb
 - lib/sendgrid_toolkit/spam_reports.rb
 - lib/sendgrid_toolkit/statistics.rb
@@ -97,6 +98,7 @@ files:
 - spec/lib/sendgrid_toolkit/bounces_spec.rb
 - spec/lib/sendgrid_toolkit/common_spec.rb
 - spec/lib/sendgrid_toolkit/invalid_emails_spec.rb
+- spec/lib/sendgrid_toolkit/mail_spec.rb
 - spec/lib/sendgrid_toolkit/spam_reports_spec.rb
 - spec/lib/sendgrid_toolkit/statistics_spec.rb
 - spec/lib/sendgrid_toolkit/unsubscribes_spec.rb
@@ -117,7 +119,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4321633947475345142
+      hash: -3253025820181550713
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: