fast-mailer 0.1.0 → 0.2.0

data/README.md

@@ -66,16 +66,30 @@ This will cause FastMailer::SMTP to use FastMailer::MockSMTP rather than Net::SM
 You can then find your sent emails in FastMailer::MockSMTP.deliveries.
 
 
-Coming features
+Parallelisation
 ---------------
 
-* Parallelisation: given a list of mails, or a mail generator, we can spin a number
-of threads up and let them send mail simultaneously. As most of the time is spent
-waiting for the network, this speeds the process up significantly.
+To send a large number of emails, you can use the FastMailer::Mailer class. Create
+it as an SMTP instance, but include an additional option :max_connections. When 
+calling send_all with a mail iterator (any object yielding Mail instances on :next), 
+:max_connections threads will be spawned, sending mail from the generator in parallel.
+
+    emails = [mail_1, mail_2, ..., mail_n]
+    mailer = FastMailer::Mailer.new
+    mailer.send_all emails.to_enum
+
+Note that the generator must not return modified instances of the same object 
+multiple times, since up to :max_connections mails will be processed at the same
+time.
+
+The :send_all call will not return until all mails have been sent. At this point, all
+spawned threads will have stopped.
+
+
+Coming features
+---------------
 
 * Logging: When sending large batches, sometimes things go wrong. If we keep track 
 of which mails have been sent and which have failed, we reduce the risk of finding
 ourselves wondering which of our users have received the message and which we need
 to send to.
-
-* Blacklisting: block addresses so they cannot be sent to.

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/lib/fast-mailer.rb

@@ -2,9 +2,11 @@
 require 'mail'
 require 'hooks'
 
+require 'fast-mailer/exceptions'
 require 'fast-mailer/configuration'
 require 'fast-mailer/smtp'
 require 'fast-mailer/mailer'
+require 'fast-mailer/file_blacklist'
 
 module FastMailer
   

data/lib/fast-mailer/exceptions.rb

@@ -0,0 +1,8 @@
+
+module FastMailer
+  class FastMailerError < ArgumentError
+  end
+  
+  class BlacklistError < FastMailerError
+  end
+end

data/lib/fast-mailer/file_blacklist.rb

@@ -0,0 +1,24 @@
+
+module FastMailer
+  
+  # Simplistic blacklist implementation. Reads a text file with a single
+  # email address per line into memory. Addresses found are considered
+  # blacklisted.
+  class FileBlacklist
+    
+    def initialize(filename)
+      @blacklist = []
+      
+      File.open(filename, 'r:utf-8') do |file|
+        while line = file.gets
+          @blacklist << line.strip
+        end
+      end
+    end
+    
+    def blacklisted?(email)
+      @blacklist.include?(email)
+    end
+    
+  end
+end

data/lib/fast-mailer/smtp.rb

@@ -81,6 +81,15 @@ module FastMailer
         if message.blank?
           raise ArgumentError.new('A encoded content is required to send a message')
         end
+        
+        if @configuration[:blacklist]
+          destinations.each do |email|
+            if @configuration[:blacklist].blacklisted?(email)
+              raise FastMailer::BlacklistError.new(email)
+            end
+          end
+        end
+        
       
         begin
           @smtp.sendmail(message, envelope_from, destinations)

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Erik Hansson
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-01 00:00:00 +02:00
+date: 2010-10-04 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -137,6 +137,8 @@ files:
 - bin/tt
 - bin/unit_diff
 - lib/fast-mailer/configuration.rb
+- lib/fast-mailer/exceptions.rb
+- lib/fast-mailer/file_blacklist.rb
 - lib/fast-mailer/mailer.rb
 - lib/fast-mailer/mock_smtp.rb
 - lib/fast-mailer/smtp.rb