# \[ANN\] gmailer-0.0.8 released
**URL:** https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587
**Category:** ruby-talk
**Created:** [3 September 2005 10:05 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587 "2005-09-03T10:05:18Z")
**Posts on this page:** 9
**Page:** 1
### Author:  [@Park\_Heesob3](https://rubytalk.org/u/Park_Heesob3)
#### Post date: [3 September 2005 10:05 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/1 "2005-09-03T10:05:18Z")
GMailer 0.0.8 Released
> **···**
>
> =======================
>
> This is the 0.0.8 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?
> ---------------------------
>
> Rename is\_connected method to connected?
> Add support for the new feature 'Send mail as'. If you have multiple
> verified
> "Send mail as:" email addresses, you can choose one 'From:' email address.
> Refer to [http://gmail.google.com/support/bin/answer.py?answer=20616](http://gmail.google.com/support/bin/answer.py?answer=20616)
> Thanks Daniel Schierbeck and Michel Martens!
>
> How to use GMailer?
> -----------------------
> Sample usage:
>
> GMailer.connect(name,pwd) do |g|
> #fetch
> g.fetch(:label=\>"my\_label") {|s|
> puts "Total # of conversations of my\_label = " + s.box\_total.to\_s
> }
>
> #get contact
> g.fetch(:contact=\>"freq").each do |item|
> puts "Name: #{item['name']} Email: #{item['email']}"
> end
>
> #send message
> # 'From' default gmail.com account
> g.send(
> :to =\> "who@what.com, my\_friend@his\_company.com, god@heaven.org"
> :cc =\> "foo@bar.com"
> :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 =\> "verified@email.com",
> :to =\> "who@what.com, my\_friend@his\_company.com, god@heaven.org"
> :cc =\> "foo@bar.com"
> :subject =\> "Hello There!",
> :body =\> "Hi...\n\nBlah blah blah~~...",
> :files =\> ["./my\_pic.jpg", "./my\_cv.txt"])
>
> # update\_preference
> g.update\_preference(:max\_page\_size=\>50,
> :keyboard\_shortcuts=\>true,
> :indicators=\>true,
> :display\_language=\>'en',
> :signature=\>'This is a signature',
> :reply\_to=\>'return@foo.bar',
> :snippets=\>true,
> :display\_name=\>'Display Name')
>
> # get preference
> pref = g.preference
> puts "Display language:#{pref['display\_language']}, Max 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.not\_spam(msgid)
>
> #move a message to trash
> g.trash\_in(msgid)
>
> #move a message from trash to inbox
> g.trash\_out(msgid)
>
> #delete a trash message forever
> g.delete\_trash(msgid)
>
> #delete a spam message forever
> g.delete\_spam(msgid)
>
> #get labels
> labels = g.labels
>
> #get messages
> g.messages(:label=\>labels[0]).each {|m|
> puts "Subject: #{m['subject']} / Snippet: #{m['snippet']}" if m['new?']
> }
>
> #get inbox messages
> g.messages(:standard=\>'inbox').each {|m|
> puts "Subject: #{m['subject']} / Snippet: #{m['snippet']}" if m['new?']
> }
>
> end
>
> Project:: [http://rubyforge.org/projects/gmailutils/](http://rubyforge.org/projects/gmailutils/)
> Bugs:: [http://rubyforge.org/tracker/?group\_id=869](http://rubyforge.org/tracker/?group_id=869)
> Document:: [http://rubyforge.org/docman/?group\_id=869](http://rubyforge.org/docman/?group_id=869)
> Download:: [http://rubyforge.org/frs/?group\_id=869](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](http://rubyforge.org/frs/?group_id=869)
> and run install.rb
>
> Cheers,
>
> Park Heesob
---
### Author:  [@Daniel\_Schierbeck](https://rubytalk.org/u/Daniel_Schierbeck)
#### Post date: [3 September 2005 15:16 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/2 "2005-09-03T15:16:26Z")
Sweeeeeeeeet!
Cheers,
Daniel
---
### Author:  [@Daniel\_Schierbeck](https://rubytalk.org/u/Daniel_Schierbeck)
#### Post date: [3 September 2005 17:26 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/3 "2005-09-03T17:26:26Z")
One thing that would be cool is a more advanced API. Something along the lines of this:
Module GMailer
# the main class.
class Connection
# returns the messages that match the filters
# or all messages if no filter is provided
def messages (filters = {}); end
# returns all labels
def labels; end
# returns the label that has the name "name"
# as a Label object
def label (name); end
# etc etc
end
# a list of messages. should be sortable and searchable.
class MessageList; end
# a single message
class Message
attr\_reader :subject, :body, :to, :from, :date
# applies a label to the message.
# can take either a string or a Label object as argument
def apply\_label (label); end
def remove\_label; end
def archive; end
def unarchive; end
def archived?; end
def mark\_read; end
def mark\_unread; end
def read?; end
def report\_spam; end
def report\_not\_spam; end
def spam?; end
def trash; end
def untrash; end
# etc etc
end
class Label
# you get the picture
end
def connect (\*args, &block)
Connection.new(\*args, &block)
end
end
GMailer::connect(username, password) do |gmail|
gmail.messages(:unread).each do |msg|
puts "subject: " + msg.subject
puts "from: " + msg.from
end
end
---
### Author:  [@David\_Teare](https://rubytalk.org/u/David_Teare)
#### Post date: [3 September 2005 17:32 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/4 "2005-09-03T17:32:31Z")
Thanks for sharing this as a GEM.
I am having some troubles getting it to work. I installed gmailer v0.8 but I can't figure out how to "require" it. Am I missing something obvious?
$ gem list | grep gmail
gmailer (0.0.8)
$ ruby --version
ruby 1.8.2 (2004-12-25) [powerpc-darwin7.8.0]
$ gem --version
0.8.10
$ irb
irb(main):001:0\> require "GMail"
LoadError: No such file to load -- GMail
from (irb):1:in `require'
from (irb):1
irb(main):002:0\> require "GMailer"
LoadError: No such file to load -- GMailer
from (irb):2:in `require'
from (irb):2
irb(main):003:0\> require "gmailer"
LoadError: No such file to load -- gmailer
from (irb):3:in `require'
from (irb):3
> **···**
>
> On 3-Sep-05, at 6:05 AM, Park Heesob wrote:
>
> > # GMailer 0.0.8 Released
> >
> > This is the 0.0.8 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?
> > ---------------------------
> >
> > Rename is\_connected method to connected?
> > Add support for the new feature 'Send mail as'. If you have multiple
> > verified
> > "Send mail as:" email addresses, you can choose one 'From:' email address.
> > Refer to [http://gmail.google.com/support/bin/answer.py?answer=20616](http://gmail.google.com/support/bin/answer.py?answer=20616)
> > Thanks Daniel Schierbeck and Michel Martens!
> >
> > How to use GMailer?
> > -----------------------
> > Sample usage:
> >
> > GMailer.connect(name,pwd) do |g|
> > #fetch
> > g.fetch(:label=\>"my\_label") {|s|
> > puts "Total # of conversations of my\_label = " + s.box\_total.to\_s
> > }
> >
> > #get contact
> > g.fetch(:contact=\>"freq").each do |item|
> > puts "Name: #{item['name']} Email: #{item['email']}"
> > end
> >
> > #send message
> > # 'From' default gmail.com account
> > g.send(
> > :to =\> "who@what.com, my\_friend@his\_company.com, god@heaven.org"
> > :cc =\> "foo@bar.com"
> > :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 =\> "verified@email.com",
> > :to =\> "who@what.com, my\_friend@his\_company.com, god@heaven.org"
> > :cc =\> "foo@bar.com"
> > :subject =\> "Hello There!",
> > :body =\> "Hi...\n\nBlah blah blah~~...",
> > :files =\> ["./my\_pic.jpg", "./my\_cv.txt"])
> >
> > # update\_preference
> > g.update\_preference(:max\_page\_size=\>50,
> > :keyboard\_shortcuts=\>true,
> > :indicators=\>true,
> > :display\_language=\>'en',
> > :signature=\>'This is a signature',
> > :reply\_to=\>'return@foo.bar',
> > :snippets=\>true,
> > :display\_name=\>'Display Name')
> >
> > # get preference
> > pref = g.preference
> > puts "Display language:#{pref['display\_language']}, Max 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.not\_spam(msgid)
> >
> > #move a message to trash
> > g.trash\_in(msgid)
> >
> > #move a message from trash to inbox
> > g.trash\_out(msgid)
> >
> > #delete a trash message forever
> > g.delete\_trash(msgid)
> >
> > #delete a spam message forever
> > g.delete\_spam(msgid)
> >
> > #get labels
> > labels = g.labels
> >
> > #get messages
> > g.messages(:label=\>labels[0]).each {|m|
> > puts "Subject: #{m['subject']} / Snippet: #{m['snippet']}" if m['new?']
> > }
> >
> > #get inbox messages
> > g.messages(:standard=\>'inbox').each {|m|
> > puts "Subject: #{m['subject']} / Snippet: #{m['snippet']}" if m['new?']
> > }
> >
> > end
> >
> > Project:: [http://rubyforge.org/projects/gmailutils/](http://rubyforge.org/projects/gmailutils/)
> > Bugs:: [http://rubyforge.org/tracker/?group\_id=869](http://rubyforge.org/tracker/?group_id=869)
> > Document:: [http://rubyforge.org/docman/?group\_id=869](http://rubyforge.org/docman/?group_id=869)
> > Download:: [http://rubyforge.org/frs/?group\_id=869](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](http://rubyforge.org/frs/?group_id=869)
> > and run install.rb
> >
> > Cheers,
> >
> > Park Heesob
---
### Author:  [@David\_Teare](https://rubytalk.org/u/David_Teare)
#### Post date: [3 September 2005 17:34 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/5 "2005-09-03T17:34:45Z")
+1 for this feature. Can we see it in version 0.0.9? 😉
> **···**
>
> On 3-Sep-05, at 1:26 PM, Daniel Schierbeck wrote:
>
> > GMailer::connect(username, password) do |gmail|
> > gmail.messages(:unread).each do |msg|
> > puts "subject: " + msg.subject
> > puts "from: " + msg.from
> > end
---
### Author:  [@Daniel\_Schierbeck](https://rubytalk.org/u/Daniel_Schierbeck)
#### Post date: [3 September 2005 17:41 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/6 "2005-09-03T17:41:26Z")
That should of course be
....
def GMailer.connect (...)
....
---
### Author:  [@Mark\_Hubbart1](https://rubytalk.org/u/Mark_Hubbart1)
#### Post date: [3 September 2005 18:14 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/7 "2005-09-03T18:14:09Z")
> Thanks for sharing this as a GEM.
>
> I am having some troubles getting it to work. I installed gmailer
> v0.8 but I can't figure out how to "require" it. Am I missing
> something obvious?
>
> $ gem list | grep gmail
> gmailer (0.0.8)
> $ ruby --version
> ruby 1.8.2 (2004-12-25) [powerpc-darwin7.8.0]
> $ gem --version
> 0.8.10
>
> $ irb
> irb(main):001:0\> require "GMail"
> LoadError: No such file to load -- GMail
> from (irb):1:in `require'
> from (irb):1
> irb(main):002:0\> require "GMailer"
> LoadError: No such file to load -- GMailer
> from (irb):2:in `require'
> from (irb):2
> irb(main):003:0\> require "gmailer"
> LoadError: No such file to load -- gmailer
> from (irb):3:in `require'
> from (irb):3
perhaps try:
\>\> require 'rubygems'
\>\> require\_gem 'gmailer'
cheers,
Mark
> **···**
>
> On 9/3/05, David Teare \ wrote:
---
### Author:  [@Park\_Heesob1](https://rubytalk.org/u/Park_Heesob1)
#### Post date: [3 September 2005 23:46 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/8 "2005-09-03T23:46:32Z")
Hi,
> From: Daniel Schierbeck \
> Reply-To: ruby-talk@ruby-lang.org
> To: ruby-talk@ruby-lang.org (ruby-talk ML)
> Subject: Re: [ANN] gmailer-0.0.8 released
> Date: Sun, 4 Sep 2005 02:26:26 +0900
>
> One thing that would be cool is a more advanced API. Something along the lines of this:
>
> Module GMailer
> # the main class.
> class Connection
> # returns the messages that match the filters
> # or all messages if no filter is provided
> def messages (filters = {}); end
>
> # returns all labels
> def labels; end
>
> # returns the label that has the name "name"
> # as a Label object
> def label (name); end
>
> # etc etc
> end
>
> # a list of messages. should be sortable and searchable.
> class MessageList; end
>
> # a single message
> class Message
> attr\_reader :subject, :body, :to, :from, :date
>
> # applies a label to the message.
> # can take either a string or a Label object as argument
> def apply\_label (label); end
>
> def remove\_label; end
>
> def archive; end
>
> def unarchive; end
>
> def archived?; end
>
> def mark\_read; end
>
> def mark\_unread; end
>
> def read?; end
>
> def report\_spam; end
>
> def report\_not\_spam; end
>
> def spam?; end
>
> def trash; end
>
> def untrash; end
>
> # etc etc
> end
>
> class Label
> # you get the picture
> end
>
> def connect (\*args, &block)
> Connection.new(\*args, &block)
> end
> end
>
> GMailer::connect(username, password) do |gmail|
> gmail.messages(:unread).each do |msg|
> puts "subject: " + msg.subject
> puts "from: " + msg.from
> end
> end
Thanks for suggestions.
I will try to satisfy you in the next release.🙂
In the mean time, you can use this for fetching each message content:
g.messages(:standard=\>'all').each {|m|
puts "ID: #{m['id']} Subject: #{m['subject']} / Snippet: #{m['snippet']}"
g.fetch(:conversation=\>m['id']).conv.each {|c|
puts "From: #{c['sender']} #{c['sender\_email']}"
puts "Subject: #{c['subject']}"
puts "Full Message Body: #{c['body']}"
}
}
Regards,
Park Heesob
---
### Author:  [@David\_Teare](https://rubytalk.org/u/David_Teare)
#### Post date: [3 September 2005 18:54 UTC](https://rubytalk.org/t/ann-gmailer-0-0-8-released/20587/9 "2005-09-03T18:54:44Z")
The require\_gem seemed to work (it returned true), but I still had the error below. No worries though, I just downloaded the rb code and included it directly - it works great now!
NameError: uninitialized constant GMailer
from (irb):9
> **···**
>
> On 3-Sep-05, at 2:14 PM, Mark Hubbart wrote:
>
> > On 9/3/05, David Teare \ wrote:
> >
> > > Thanks for sharing this as a GEM.
> > >
> > > I am having some troubles getting it to work. I installed gmailer
> > > v0.8 but I can't figure out how to "require" it. Am I missing
> > > something obvious?
> > >
> > > $ gem list | grep gmail
> > > gmailer (0.0.8)
> > > $ ruby --version
> > > ruby 1.8.2 (2004-12-25) [powerpc-darwin7.8.0]
> > > $ gem --version
> > > 0.8.10
> > >
> > > $ irb
> > > irb(main):001:0\> require "GMail"
> > > LoadError: No such file to load -- GMail
> > > from (irb):1:in `require'
> > > from (irb):1
> > > irb(main):002:0\> require "GMailer"
> > > LoadError: No such file to load -- GMailer
> > > from (irb):2:in `require'
> > > from (irb):2
> > > irb(main):003:0\> require "gmailer"
> > > LoadError: No such file to load -- gmailer
> > > from (irb):3:in `require'
> > > from (irb):3
> >
> > perhaps try:
> >
> > > > require 'rubygems'
> > > > require\_gem 'gmailer'
> >
> > cheers,
> > Mark