diff --git a/ChangeLog b/ChangeLog index 9af75f0b22..778d9d37b6 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Tue Dec 7 17:03:16 2010 Shugo Maeda + + * lib/net/imap.rb (xlist): supported the XLIST command, which is an + extension by Apple and Google. patch by Geoff Youngs. + [ruby-core:33521] + Tue Dec 7 08:00:44 2010 Nobuyoshi Nakada * configure.in, win32/Makefile.sub (WERRORFLAG): flag to treat diff --git a/lib/net/imap.rb b/lib/net/imap.rb index c3dda46606..dd0d6b42b7 100644 --- a/lib/net/imap.rb +++ b/lib/net/imap.rb @@ -528,6 +528,38 @@ module Net end end + # Sends a XLIST command, and returns a subset of names from + # the complete set of all names available to the client. + # +refname+ provides a context (for instance, a base directory + # in a directory-based mailbox hierarchy). +mailbox+ specifies + # a mailbox or (via wildcards) mailboxes under that context. + # Two wildcards may be used in +mailbox+: '*', which matches + # all characters *including* the hierarchy delimiter (for instance, + # '/' on a UNIX-hosted directory-based mailbox hierarchy); and '%', + # which matches all characters *except* the hierarchy delimiter. + # + # If +refname+ is empty, +mailbox+ is used directly to determine + # which mailboxes to match. If +mailbox+ is empty, the root + # name of +refname+ and the hierarchy delimiter are returned. + # + # The XLIST command is like the LIST command except that the flags + # returned refer to the function of the folder/mailbox, e.g. :Sent + # + # The return value is an array of +Net::IMAP::MailboxList+. For example: + # + # imap.create("foo/bar") + # imap.create("foo/baz") + # p imap.xlist("", "foo/%") + # #=> [#, \\ + # #, \\ + # #] + def xlist(refname, mailbox) + synchronize do + send_command("XLIST", refname, mailbox) + return @responses.delete("XLIST") + end + end + # Sends the GETQUOTAROOT command along with specified +mailbox+. # This command is generally available to both admin and user. # If mailbox exists, returns an array containing objects of @@ -2071,7 +2103,7 @@ module Net return response_cond when /\A(?:FLAGS)\z/ni return flags_response - when /\A(?:LIST|LSUB)\z/ni + when /\A(?:LIST|LSUB|XLIST)\z/ni return list_response when /\A(?:QUOTA)\z/ni return getquota_response diff --git a/test/net/imap/test_imap_response_parser.rb b/test/net/imap/test_imap_response_parser.rb index f106e4a61d..fca71e2436 100644 --- a/test/net/imap/test_imap_response_parser.rb +++ b/test/net/imap/test_imap_response_parser.rb @@ -56,6 +56,15 @@ EOF end end + def test_flag_xlist_inbox + parser = Net::IMAP::ResponseParser.new + response = parser.parse(<