gabrielengel/ruby-gmail.md

## ruby-gmail.md

      
    Raw
  

              ruby-gmail.md
            
          
    Require gmail

require 'gmail'

Start an authenticated gmail session

Gmail.new(username, password) do |gmail|
  # ...do things...
end

Working with lists/mailboxes

Gmail.new(username, password) do 
  in('inbox')
  count # => 100

  search('is:unread')
  count # => 60

  search('is:read')
  count # => 40

  search('before:2010-02-20 after:2010-03-20')
  search('on:2010-04-15')
  search('from:myfriend@gmail.com')
  search('to:myfriend@gmail.com')
  search('is:read from:myboss@gmail.com "you are a great employee"')

  peek = true

  in('Urgent')
  count
end

Working with an email object

Gmail.new(username, password) do
  in('inbox')

  mails.each do |mail|
    mail.read!
    mail.unread!
    mail.archive!
    mail.delete!
    mail.spam!

    mail.move_to('label')
    mail.add_to('label')

    mail.files.each do |file|
      file = File.new('/tmp' + file.filename, "w+")
      file << file.decoded
      file.close
    end
  end
end

Working with labels

Gmail.new(username, password) do
  labels
  # => ['[Gmail] Inbox', '[Gmail] Sent', 'Family', 'BillsToPay', ...]
  labels.add('BotsSpam')
  labels.remove('BillsToPay')
end

Writing e-mails

Gmail.new(username, password) do
  compose do
    to "friend@gmail.com"
    text.body = "Hello"
    html.body = "Cool!"
    html.content_type = 'text/html; charset=UTF-8'
    attach '/tmp/some_image.jpg'
    inline '/tmp/some_other_image.jpg' # Exists today?
  end
end