larch 1.1.0.dev.20091206 → 1.1.0.dev.20100120

data/HISTORY

@@ -12,6 +12,9 @@ Version 1.1.0 (git)
     command-line, Larch will use the options in that section for the session;
     otherwise it will use the options in the "default" section. See the README
     for more details.
+  * Added experimental support for Yahoo! Mail IMAP when connecting to
+    imap.mail.yahoo.com or imap-ssl.mail.yahoo.com. See the README for caveats
+    and known issues.
   * Folders are now copied recursively by default.
   * Progress information is now displayed regularly while scanning large
     mailboxes.

data/README.rdoc

@@ -213,6 +213,10 @@ servers:
 * Gmail
 * Microsoft Exchange 2003
 
+The following servers are known to work, but with caveats:
+
+* Yahoo! Mail
+
 The following servers do not work well with Larch:
 
 * BlitzMail - Buggy server implementation; fails to properly quote or escape
@@ -258,6 +262,35 @@ such as "  folder  ". Gmail does not. When copying folders to Gmail, Larch will
 automatically remove leading and trailing whitespace in folder names to prevent
 errors.
 
+=== Yahoo! Mail Quirks
+
+Yahoo! doesn't officially support IMAP access for general usage, but Larch is
+able to connect to imap.mail.yahoo.com and imap-ssl.mail.yahoo.com by using a
+fairly well-known trick. That said, as with anything tricky, there are caveats.
+
+==== No hierarchical folders
+
+Similar to Gmail, Yahoo!'s IMAP gateway doesn't allow hierarchical (nested)
+folders. If you try to copy a folder hierarchy to Yahoo!, it will work, but
+you'll end up with a set of folders named "folder" and "folder.subfolder"
+rather than seeing "subfolder" as an actual subfolder of "folder".
+
+==== No custom flags
+
+Yahoo! Mail IMAP doesn't appear to support custom message flags, such as the
+labels and junk/not junk flags used by Thunderbird. When transferring messages
+with custom flags to a Yahoo! Mail IMAP account, the custom flags will be lost.
+Also, Larch's <tt>sync-flags</tt> option will not work correctly if you have
+messages with custom flags.
+
+==== Here there be dragons
+
+Larch's support for Yahoo! Mail is very new and very lightly tested. Given its
+newness and the fact that Yahoo!'s IMAP gateway isn't official, there are likely
+to be other quirks we're not yet aware of. There's also no guarantee that Yahoo!
+won't shut down its IMAP gateway, deprecate the trick Larch uses to connect, or
+just outright block Larch. Use at your own risk.
+
 == Known Issues
 
 * Larch uses Ruby's Net::IMAP standard library for all IMAP operations. While

data/lib/larch/imap.rb

@@ -64,8 +64,10 @@ class IMAP
 
     @conn      = nil
     @mailboxes = {}
+
     @quirks    = {
-      :gmail => false
+      :gmail => false,
+      :yahoo => false
     }
 
     @db_account = Database::Account.find_or_create(
@@ -99,7 +101,7 @@ class IMAP
 
   # Gets the server's mailbox hierarchy delimiter.
   def delim
-    @delim ||= safely { @conn.list('', '')[0].delim }
+    @delim ||= safely { @conn.list('', '')[0].delim || '.'}
   end
 
   # Closes the IMAP connection if one is currently open.
@@ -258,6 +260,10 @@ class IMAP
     if @conn.greeting.data.text =~ /^Gimap ready/
       @quirks[:gmail] = true
       debug "looks like Gmail"
+
+    elsif host =~ /^imap(?:-ssl)?\.mail\.yahoo\.com$/
+      @quirks[:yahoo] = true
+      debug "looks like Yahoo! Mail"
     end
   end
 
@@ -312,6 +318,12 @@ class IMAP
 
         check_quirks
 
+        # If this is Yahoo! Mail, we have to send a special command before
+        # it'll let us authenticate.
+        if @quirks[:yahoo]
+          @conn.instance_eval { send_command('ID ("guid" "1")') }
+        end
+
         auth_methods = ['PLAIN']
         tried        = []
         capability   = @conn.capability
@@ -362,7 +374,7 @@ class IMAP
       name = Net::IMAP.decode_utf7(mb.name)
       name = 'INBOX' if name.downcase == 'inbox'
 
-      @mailboxes[name] ||= Mailbox.new(self, name, mb.delim,
+      @mailboxes[name] ||= Mailbox.new(self, name, mb.delim || '.',
           subscribed.any?{|s| s.name == mb.name}, mb.attr)
     end
 

data/lib/larch/imap/mailbox.rb

@@ -438,6 +438,7 @@ class Mailbox
 
     @imap.safely do
       begin
+        @imap.conn.close unless @state == :closed
         @state = :closed
 
         debug "examining mailbox"
@@ -466,6 +467,7 @@ class Mailbox
 
     @imap.safely do
       begin
+        @imap.conn.close unless @state == :closed
         @state = :closed
 
         debug "selecting mailbox"

data/lib/larch/version.rb

@@ -1,6 +1,6 @@
 module Larch
   APP_NAME      = 'Larch'
-  APP_VERSION   = '1.1.0.dev.20091206'
+  APP_VERSION   = '1.1.0.dev.20100120'
   APP_AUTHOR    = 'Ryan Grove'
   APP_EMAIL     = 'ryan@wonko.com'
   APP_URL       = 'http://github.com/rgrove/larch/'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: larch
 version: !ruby/object:Gem::Version 
-  version: 1.1.0.dev.20091206
+  version: 1.1.0.dev.20100120
 platform: ruby
 authors: 
 - Ryan Grove
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-06 00:00:00 -08:00
+date: 2010-01-20 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,7 +30,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 3.6.0
+        version: "3.8"
     version: 
 - !ruby/object:Gem::Dependency 
   name: sqlite3-ruby