Add more advanced label functions and searching.

[geoffyoungs]

In GMail

• Fix #labels on non-gmail branded accounts - stop assuming that the "[Gmail]" hierachy exists
• Add #imap_xlist
  • Monkey patches XLIST support into Net::IMAP if it's missing.
  • Caches result until a new label is created or imap_xlist! is called
• Add #inbox_label, #allmail_label, #spam_label, #trash_label, #drafts_label, #important_label, #starred_label
  • Uses XLIST to identify function of standard folders
• Add #allmail, #spam, #trash, #drafts, #important, #starred, #sent
  • Short cuts to known mailboxes, similar to #inbox
• Add #normal_labels
  • Returns list of "normal" labels - ie. not sent, etc.

• Add #label_of_type(type)

  • Looks up known mailbox

  In GMail::Mailbox

• In #emails

  • Add support for additional all IMAP search keywords via hash params to #emails().
  • Throw runtime error for unknown keys
  • Add support for :fetch => true parameter to fetch the bodies of all the emails returned by the search.

  In GMail::Message

• Add #message_id
  • UIDs are different for the same message across different folders, so Message-ID header is the test for uniqueness
• Add #has_label?(name)
  • Indicates whether message has given label applied
• Add #archived?, #starred?, #sent?, #important?
  • Shortcuts to check whether the message has been archived, starred etc.
• Add #labels - returns list of labels applied to message
  • Search all known folders for messages with this message-id
• Add #remove_label(label) - deletes message from given mailbox/label
  • ie. delete message from named folder
• Add #loaded? - indicates whether message body has been loaded
• Add #set_body(str) - sets the message content to given string

[adimircolen]

geoffyoungs Do you can help me test on branch adimircolen-master ? RakeFile on line gem.add_dependency('mime', '>= 0.1') is nessesary or not ? Thanks you

[geoffyoungs]

Hi admircolen - I'm not sure whether that's need?

I've only been looking at read/search functionality rather than packaging concerns - I just want the ability to write code for a cron job like:

gmail.label('Errors').
emails(:before => 3.days.ago, :after => 1.week.ago).
with_label(gmail.inbox_label).each do |message|
  message.archive!
end

and thus get the delayed filters that gmail hasn't implemented...

[adimircolen]

I put this version as a release, we have few tests in gem. We need more tests.

[geoffyoungs]

AFAICT the mime gem isn't required - I've removed that line from the gmail/message.rb

And I've made the current set of tests work again - although I haven't got around to writing any new tests yet.

I've also added a Gemfile so we can use bundler to check that local gems aren't being pulled in by mistake.

[geoffyoungs]

Ok - there are some more fixes and additional tests for the search functionality.

[Ken-g6]

@geoffyoungs ,

I'm using your branch of ruby-gmail, mainly for the advanced searching features. For instance, I want to be able to search emails by subject. The problem is it doesn't seem to be working.

To summarize, I use:

params={'subject'=>'A word or phrase'}
gmail = Gmail.new(username, password)
email = gmail.inbox.emails(params).to_a.last

And I expect that email will be the last email that had 'A word or phrase' in the subject. But it seems to be returning the last email with anything in the subject.

I would have left this in your branch's issues; but you don't seem to have that enabled.

[myobie]

This is a very large set of commits and I don't think I can pull these in, I'm sorry. After I get all the other issues closed, I may come back to this.

[hoverlover]

I am needing to search a mailbox for emails from OR to a specific address. This PR seems like it would do that. Are there any plans to pull this in?

[myobie]

I did not plan to pull this in since it's so untested and so many changes all at once. The focus of the project now is not on adding features to the current version but on organizing for a rewrite.