mail 2.2.9 → 2.2.9.1

data/CHANGELOG.rdoc

@@ -1,3 +1,11 @@
+== Mon Nov 15 13:04:41 UTC 2010 Mikel Lindsaar <mikel@rubyx.com>
+
+* Add find_and_delete convenience method for consistency with POP3, document delete_after_find option (Donald Ball)
+* Documenting the openssl_verify_mode setting (Donald Ball)
+* Added ruby-1.8.6 back into the list of tested platforms (Donald Ball)
+* Relax i18n dependency until we remove active support requirement
+* Version Bump to 2.2.9.1 to include new i18n dependency
+
 == Tue Oct 26 07:14:36 UTC 2010 Mikel Lindsaar <mikel@rubyx.com>
 
 * Version Bump to 2.2.9 and tag

data/README.rdoc

@@ -29,6 +29,7 @@ Mail is tested and works on the following platforms:
 
 * jruby-1.4.0 [ [x86_64-java] ]
 * ree-1.8.7-2010.01 [ x86_64 ]
+* ruby-1.8.6-p399 [ x86_64 ]
 * ruby-1.8.7-p249 [ x86_64 ]
 * ruby-1.9.1-head [ x86_64 ] (10 April 2010)
 * ruby-1.9.2-head [ x86_64 ] (10 April 2010)

data/lib/VERSION

@@ -1,4 +1,4 @@
 patch:9
 major:2
-build:
+build:1
 minor:2

data/lib/mail/network/delivery_methods/smtp.rb

@@ -34,6 +34,18 @@ module Mail
   #                              :enable_starttls_auto => true  }
   #   end
   #
+  # === Certificate verification
+  #
+  # When using TLS, some mail servers provide certificates that are self-signed
+  # or whose names do not exactly match the hostname given in the address.
+  # OpenSSL will reject these by default. The best remedy is to use the correct
+  # hostname or update the certificate authorities trusted by your ruby. If
+  # that isn't possible, you can control this behavior with
+  # an :openssl_verify_mode setting. Its value may be either an OpenSSL
+  # verify mode constant (OpenSSL::SSL::VERIFY_NONE), or a string containing
+  # the name of an OpenSSL verify mode (none, peer, client_once,
+  # fail_if_no_peer_cert).
+  #
   # === Others 
   # 
   # Feel free to send me other examples that were tricky

data/lib/mail/network/retriever_methods/imap.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 module Mail
-  # The IMAP retriever allows to get the last, first or all emails from a POP3 server.
+  # The IMAP retriever allows to get the last, first or all emails from a IMAP server.
   # Each email retrieved (RFC2822) is given as an instance of +Message+.
   #
   # While being retrieved, emails can be yielded if a block is given.
@@ -94,7 +94,7 @@ module Mail
       find(options, &block)
     end
     
-    # Find emails in a POP3 mailbox. Without any options, the 10 last received emails are returned.
+    # Find emails in a IMAP mailbox. Without any options, the 10 last received emails are returned.
     #
     # Possible options:
     #   mailbox: mailbox to search the email(s) in. The default is 'INBOX'.
@@ -102,6 +102,8 @@ module Mail
     #   order:   order of emails returned. Possible values are :asc or :desc. Default value is :asc.
     #   count:   number of emails to retrieve. The default value is 10. A value of 1 returns an
     #            instance of Message, not an array of Message instances.
+    #   delete_after_find: flag for whether to delete each retreived email after find. Default
+    #           is false. Use #find_and_delete if you would like this to default to true.
     #
     def find(options={}, &block)
       options = validate_options(options)
@@ -137,6 +139,23 @@ module Mail
       end
     end
 
+    # Find emails in a IMAP mailbox, and then deletes them. Without any options, the 
+    # five last received emails are returned.
+    #
+    # Possible options:
+    #   what:  last or first emails. The default is :first.
+    #   order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.
+    #   count: number of emails to retrieve. The default value is 10. A value of 1 returns an
+    #          instance of Message, not an array of Message instances.
+    #   delete_after_find: flag for whether to delete each retreived email after find. Default
+    #           is true. Use #find_and_delete if you would like this to default to false.
+    #
+    def find_and_delete(options = {}, &block)
+      options ||= {}
+      options[:delete_after_find] ||= true
+      find(options, &block)      
+    end 
+
     # Delete all emails from a IMAP mailbox
     def delete_all(mailbox='INBOX')
       mailbox ||= 'INBOX'

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification 
 name: mail
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 89
   prerelease: false
   segments: 
   - 2
   - 2
   - 9
-  version: 2.2.9
+  - 1
+  version: 2.2.9.1
 platform: ruby
 authors: 
 - Mikel Lindsaar
@@ -15,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-26 00:00:00 +11:00
+date: 2010-11-16 00:00:00 +11:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -71,7 +72,7 @@ dependencies:
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
         hash: 13
         segments: