Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,215 Commits
.github		.github
benchmarks		benchmarks
bin		bin
docs		docs
lib/net		lib/net
rakelib		rakelib
rfcs		rfcs
sample		sample
test		test
.gitignore		.gitignore
.mailmap		.mailmap
BSDL		BSDL
COPYING		COPYING
Gemfile		Gemfile
LICENSE.txt		LICENSE.txt
README.md		README.md
Rakefile		Rakefile
net-imap.gemspec		net-imap.gemspec

Repository files navigation

Net::IMAP

Net::IMAP implements Internet Message Access Protocol (IMAP) clientfunctionality. The protocol is described inRFC3501,RFC9051 and various extensions.

Installation

Add this line to your application's Gemfile:

gem'net-imap'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install net-imap

Usage

Connect with TLS to port 993

imap=Net::IMAP.new('mail.example.com',ssl:true)imap.port=>993imap.tls_verified?=>truecaseimap.greeting.namein/OK/i# The client is connected in the "Not Authenticated" state.imap.authenticate("PLAIN","joe_user","joes_password")in/PREAUTH/i# The client is connected in the "Authenticated" state.end

List sender and subject of all recent messages in the default mailbox

imap.examine('INBOX')imap.search(["RECENT"]).eachdo |message_id|envelope=imap.fetch(message_id,"ENVELOPE")[0].attr["ENVELOPE"]puts"#{envelope.from[0].name}:\t#{envelope.subject}"end

Move all messages from April 2003 from "Mail/sent-mail" to "Mail/sent-apr03"

imap.select('Mail/sent-mail')ifimap.list('Mail/','sent-apr03').empty?imap.create('Mail/sent-apr03')endimap.search(["BEFORE","30-Apr-2003","SINCE","1-Apr-2003"]).eachdo |message_id|ifimap.capable?(:move) ||imap.capable?(:IMAP4rev2)imap.move(message_id,"Mail/sent-apr03")elseimap.copy(message_id,"Mail/sent-apr03")imap.store(message_id,"+FLAGS",[:Deleted])endendimap.expunge

Development

After checking out the repo, runbin/setup to install dependencies. Then, runbundle exec rake test to run the tests. You can also runbin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, runbundle exec rake install. To release a new version, update the version number inversion.rb, and then runbundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the.gem file torubygems.org.