tuktuk 0.5.0 → 0.5.1

data/README.md

@@ -9,6 +9,9 @@ response status codes -- like bounces, 5xx -- within your application.
 
 Plus, it supports DKIM out of the box.
 
+Delivering mail
+---------------
+
 ``` ruby
 require 'tuktuk'
 
@@ -36,7 +39,14 @@ else
 end
 ```
 
-With Tuktuk, you can also deliver multiple messages at once. Depending on the max_workers config parameter, Tuktuk will either connect sequentially to the target MX servers, or do it in parallel by spawning threads. You need to pass an array of emails, and you'll receive an array of [response, email] elements, just as above.
+Delivering multiple
+-------------------
+
+With Tuktuk, you can also deliver multiple messages at once. Depending on the `max_workers` config parameter, Tuktuk will either connect sequentially to the target domain's MX servers, or do it in parallel by spawning threads. 
+
+Tuktuk will try to send all emails targeted for a specific domain on the same SMTP session. If a MX server is not responding -- or times out in the middle --, Tuktuk will try to deliver the remaining messages to next MX server, and so on.
+
+To #deliver_many, you need to pass an array of messages, and you'll receive an array of [response, email] elements, just as above.
 
 ``` ruby
 messages = [ { ... }, { ... }, { ... }, { ... } ] # array of messages
@@ -54,6 +64,9 @@ result.each do |response, email|
 end
 ```
 
+Options & DKIM
+--------------
+
 Now, if you want to enable DKIM (and you should):
 
 ``` ruby

data/lib/tuktuk/bounce.rb

@@ -1,3 +1,5 @@
+module Tuktuk
+
 class Bounce < RuntimeError
 
   HARD_BOUNCE_CODES = [
@@ -29,4 +31,6 @@ class Bounce < RuntimeError
 end
 
 class HardBounce < Bounce; end
-class SoftBounce < Bounce; end
+class SoftBounce < Bounce; end
+
+end

data/lib/tuktuk/cache.rb

@@ -1,3 +1,5 @@
+module Tuktuk
+
 class Cache
 
   attr_reader :store, :max_keys
@@ -26,3 +28,5 @@ class Cache
   end
 
 end
+
+end

data/lib/tuktuk/dns.rb

@@ -4,6 +4,8 @@ rescue
   require 'net/dns/resolve'
 end
 
+module Tuktuk
+
 module DNS
 
   class << self
@@ -37,3 +39,5 @@ module DNS
   end
 
 end
+
+end

data/lib/tuktuk/package.rb

@@ -4,6 +4,8 @@ class Mail::Message
   attr_accessor :array_index
 end
 
+module Tuktuk 
+
 module Package
 
   class << self
@@ -60,3 +62,5 @@ module Package
   end
 
 end
+
+end

data/lib/tuktuk/tuktuk.rb

@@ -3,6 +3,8 @@ require 'dkim'
 require 'logger'
 require 'work_queue'
 
+module Tuktuk; end
+
 %w(package cache dns bounce).each { |lib| require "tuktuk/#{lib}" }
 require 'tuktuk/version' unless defined?(Tuktuk::VERSION)
 

data/lib/tuktuk/version.rb

@@ -1,7 +1,7 @@
 module Tuktuk
   MAJOR = 0
   MINOR = 5
-  PATCH = 0
+  PATCH = 1
 
   VERSION = [MAJOR, MINOR, PATCH].join('.')
 end

data/spec/deliver_spec.rb

@@ -69,10 +69,10 @@ describe 'deliver many' do
 				@emails = [email, email, email]
 
 				@success = mock('Net::SMTP::Response')
-				@soft_email_bounce = SoftBounce.new('503 Sender already specified')
-				@hard_email_bounce = HardBounce.new('505 Mailbox not found')
-				@soft_server_bounce = SoftBounce.new('Be back in a sec')
-				@hard_server_bounce = HardBounce.new('No MX records found.')
+				@soft_email_bounce  = Tuktuk::SoftBounce.new('503 Sender already specified')
+				@hard_email_bounce  = Tuktuk::HardBounce.new('505 Mailbox not found')
+				@soft_server_bounce = Tuktuk::SoftBounce.new('Be back in a sec')
+				@hard_server_bounce = Tuktuk::HardBounce.new('No MX records found.')
 			end
 
 			describe 'when domain exists' do
@@ -185,8 +185,8 @@ describe 'deliver many' do
 							it 'should not mark first email as bounced' do
 								Tuktuk.should_receive(:send_many_now).and_return([@first], [], [])
 								responses = Tuktuk.send(:lookup_and_deliver_by_domain, 'domain.com', @emails)
-								responses[1][0].should be_a(Bounce) if responses[1]
-								responses[0][0].should_not be_a(Bounce)
+								responses[1][0].should be_a(Tuktuk::Bounce) if responses[1]
+								responses[0][0].should_not be_a(Tuktuk::Bounce)
 							end
 							
 						end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tuktuk
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-24 00:00:00.000000000 Z
+date: 2013-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler