P
Park Heesob
GMailer 0.0.9 Released
=======================
This is the 0.0.9 release of GMailer by Park Heesob.
This is a class library for interface to Google's webmail service.
What is GMailer?
-----------------
GMailer can fetch mails, save attachements, get cotact lists, invite someone
or send message with file attachments. It provides edit methods for labels,
preferece settings, starring and archiving message.
What's new in this release?
---------------------------
Fix fetch message body bug
Fix encode, decode bug
Rename some methods like trash_in -> trash, trash_out -> untrash
Add new class for messagelist and message.
Add support for the new feature show origianl.
Thanks Daniel Schierbeck and blair christensen!
How to use GMailer?
-----------------------
Sample usage:
require 'gmailer'
GMailer.connect(name,pwd) do |g|
#fetch
g.messageslabel=>"my_label") do |ml|
puts "Total # of conversations of my_label = " + ml.total.to_s
end
#get contact
g.fetchcontact=>"freq").each do |item|
puts "Name: #{item['name']} Email: #{item['email']}"
end
#send message
# 'From' default gmail.com account
g.send(
:to => "(e-mail address removed), my_friend@his_company.com, (e-mail address removed)",
:cc => "(e-mail address removed)",
:subject => "Hello There!",
:body => "Hi...\n\nBlah blah blah~~...",
:files => ["./my_pic.jpg", "./my_cv.txt"])
# multiple verified email addresses and choose one 'From:' email address
g.send(
:from => "(e-mail address removed)",
:to => "(e-mail address removed), my_friend@his_company.com, (e-mail address removed)",
:cc => "(e-mail address removed)",
:subject => "Hello There!",
:body => "Hi...\n\nBlah blah blah~~...",
:files => ["./my_pic.jpg", "./my_cv.txt"])
# update_preference
g.update_preferencemax_page_size=>50,
:keyboard_shortcuts=>true,
:indicators=>true,
:display_language=>'en',
:signature=>'This is a signature',
:reply_to=>'(e-mail address removed)',
:snippets=>true,
:display_name=>'Display Name')
# get preference
pref = g.preference
puts "Language:#{pref['display_language']}, Page
Size:#{pref['max_page_size']}"
#creating new labels
g.create_label('label_name')
#renaming existing labels
g.rename_label('label_name','renamed_label')
#deleting labels
g.delete_label('label_name')
#applying a label to a message
g.apply_label(msgid,'label_name')
#removing a label from a message
g.remove_label(msgid,'label_name')
#apply star to a message
g.apply_star(msgid)
#remove star from a message
g.remove_star(msgid)
#archive a message
g.archive(msgid)
#unarchive a message
g.unarchive(msgid)
#mark a message as read
g.mark_read(msgid)
#mark a message as unread
g.mark_unread(msgid)
#report a message as not spam
g.report_spam(msgid)
#report a message as not spam
g.report_not_spam(msgid)
#move a message to trash
g.trash(msgid)
#move a message from trash to inbox
g.untrash(msgid)
#delete a trash message forever
g.delete_trash(msgid)
#delete a spam message forever
g.delete_spam(msgid)
#delete a message forever
g.delete_message(msgid)
#show original message
g.show original(msgid)
#get labels
labels = g.labels
#get messages
g.messageslabel=>labels[0]).each {|m|
puts "Subject: #{m.subject} / Snippet: #{m.snippet}"
}
#get inbox messages
g.messagesstandard=>'inbox').each {|m|
puts "Subject: #{m.subject} / Snippet: #{m.snippet}"
}
# fetch with filter :read or :star
g.messagesstandard=>'all',:read=>false).each {|msg|
# operations on the message
msg.apply_star
msg.apply_label(label)
msg.trash
puts "subject: " + msg.subject
puts "from: " + msg.sender
puts msg.body
puts msg.original
}
end
Project:: http://rubyforge.org/projects/gmailutils/
Bugs:: http://rubyforge.org/tracker/?group_id=869
Document:: http://rubyforge.org/docman/?group_id=869
Download:: http://rubyforge.org/frs/?group_id=869
How do I get GMailer?
----------------------
If you have RubyGems installed:
$ sudo gem install gmailer # in *NIX
Or not, download the latest release from
http://rubyforge.org/frs/?group_id=869
and run install.rb
Regards,
Park Heesob
=======================
This is the 0.0.9 release of GMailer by Park Heesob.
This is a class library for interface to Google's webmail service.
What is GMailer?
-----------------
GMailer can fetch mails, save attachements, get cotact lists, invite someone
or send message with file attachments. It provides edit methods for labels,
preferece settings, starring and archiving message.
What's new in this release?
---------------------------
Fix fetch message body bug
Fix encode, decode bug
Rename some methods like trash_in -> trash, trash_out -> untrash
Add new class for messagelist and message.
Add support for the new feature show origianl.
Thanks Daniel Schierbeck and blair christensen!
How to use GMailer?
-----------------------
Sample usage:
require 'gmailer'
GMailer.connect(name,pwd) do |g|
#fetch
g.messageslabel=>"my_label") do |ml|
puts "Total # of conversations of my_label = " + ml.total.to_s
end
#get contact
g.fetchcontact=>"freq").each do |item|
puts "Name: #{item['name']} Email: #{item['email']}"
end
#send message
# 'From' default gmail.com account
g.send(
:to => "(e-mail address removed), my_friend@his_company.com, (e-mail address removed)",
:cc => "(e-mail address removed)",
:subject => "Hello There!",
:body => "Hi...\n\nBlah blah blah~~...",
:files => ["./my_pic.jpg", "./my_cv.txt"])
# multiple verified email addresses and choose one 'From:' email address
g.send(
:from => "(e-mail address removed)",
:to => "(e-mail address removed), my_friend@his_company.com, (e-mail address removed)",
:cc => "(e-mail address removed)",
:subject => "Hello There!",
:body => "Hi...\n\nBlah blah blah~~...",
:files => ["./my_pic.jpg", "./my_cv.txt"])
# update_preference
g.update_preferencemax_page_size=>50,
:keyboard_shortcuts=>true,
:indicators=>true,
:display_language=>'en',
:signature=>'This is a signature',
:reply_to=>'(e-mail address removed)',
:snippets=>true,
:display_name=>'Display Name')
# get preference
pref = g.preference
puts "Language:#{pref['display_language']}, Page
Size:#{pref['max_page_size']}"
#creating new labels
g.create_label('label_name')
#renaming existing labels
g.rename_label('label_name','renamed_label')
#deleting labels
g.delete_label('label_name')
#applying a label to a message
g.apply_label(msgid,'label_name')
#removing a label from a message
g.remove_label(msgid,'label_name')
#apply star to a message
g.apply_star(msgid)
#remove star from a message
g.remove_star(msgid)
#archive a message
g.archive(msgid)
#unarchive a message
g.unarchive(msgid)
#mark a message as read
g.mark_read(msgid)
#mark a message as unread
g.mark_unread(msgid)
#report a message as not spam
g.report_spam(msgid)
#report a message as not spam
g.report_not_spam(msgid)
#move a message to trash
g.trash(msgid)
#move a message from trash to inbox
g.untrash(msgid)
#delete a trash message forever
g.delete_trash(msgid)
#delete a spam message forever
g.delete_spam(msgid)
#delete a message forever
g.delete_message(msgid)
#show original message
g.show original(msgid)
#get labels
labels = g.labels
#get messages
g.messageslabel=>labels[0]).each {|m|
puts "Subject: #{m.subject} / Snippet: #{m.snippet}"
}
#get inbox messages
g.messagesstandard=>'inbox').each {|m|
puts "Subject: #{m.subject} / Snippet: #{m.snippet}"
}
# fetch with filter :read or :star
g.messagesstandard=>'all',:read=>false).each {|msg|
# operations on the message
msg.apply_star
msg.apply_label(label)
msg.trash
puts "subject: " + msg.subject
puts "from: " + msg.sender
puts msg.body
puts msg.original
}
end
Project:: http://rubyforge.org/projects/gmailutils/
Bugs:: http://rubyforge.org/tracker/?group_id=869
Document:: http://rubyforge.org/docman/?group_id=869
Download:: http://rubyforge.org/frs/?group_id=869
How do I get GMailer?
----------------------
If you have RubyGems installed:
$ sudo gem install gmailer # in *NIX
gem install gmailer # in Windows
Or not, download the latest release from
http://rubyforge.org/frs/?group_id=869
and run install.rb
Regards,
Park Heesob