https://github.com/ruby/net-imap

Ruby client api for Internet Message Access Protocol
https://github.com/ruby/net-imap

Keywords

hacktoberfest ruby

Keywords from Contributors

repl webrick rubygems bigdecimal debugger debugging-tool documentation-tool lalr-parser-generator parser-generator activerecord

Last synced: about 7 hours ago
JSON representation

Repository metadata

Ruby client api for Internet Message Access Protocol

Host: GitHub
URL: https://github.com/ruby/net-imap
Owner: ruby
License: other
Created: 2020-02-13T07:27:42.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2025-11-29T20:44:48.000Z (10 days ago)
Last Synced: 2025-12-05T18:49:55.001Z (5 days ago)
Topics: hacktoberfest, ruby
Language: Ruby
Homepage: https://ruby.github.io/net-imap
Size: 1.89 MB
Stars: 94
Watchers: 35
Forks: 34
Open Issues: 54
Releases: 56
Metadata Files:
- Readme: README.md
- License: COPYING

Net::IMAP

Net::IMAP implements Internet Message Access Protocol (IMAP) client
functionality. The protocol is described in
RFC3501,
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          => 993
imap.tls_verified? => true
case imap.greeting.name
in /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"]).each do |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')
if imap.list('Mail/', 'sent-apr03').empty?
  imap.create('Mail/sent-apr03')
end
imap.search(["BEFORE", "30-Apr-2003", "SINCE", "1-Apr-2003"]).each do |message_id|
  if imap.capable?(:move) || imap.capable?(:IMAP4rev2)
    imap.move(message_id, "Mail/sent-apr03")
  else
    imap.copy(message_id, "Mail/sent-apr03")
    imap.store(message_id, "+FLAGS", [:Deleted])
  end
end
imap.expunge

Development

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

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

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/net-imap.

Owner metadata

Name: The Ruby Programming Language
Login: ruby
Email: info@ruby-lang.org
Kind: organization
Description: Repositories related to the Ruby Programming language
Website: https://www.ruby-lang.org/
Location: Matsue, Japan
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/210414?v=4
Repositories: 171
Last ynced at: 2023-04-09T03:40:20.875Z
Profile URL: https://github.com/ruby

GitHub Events

Total

Create event: 177
Issues event: 23
Release event: 16
Watch event: 27
Delete event: 156
Issue comment event: 88
Push event: 449
Pull request review event: 34
Pull request review comment event: 18
Pull request event: 288
Fork event: 4

Last Year

Create event: 155
Issues event: 23
Release event: 13
Watch event: 22
Delete event: 142
Issue comment event: 79
Push event: 406
Pull request review event: 26
Pull request review comment event: 13
Pull request event: 257
Fork event: 4

Committers metadata

Last synced: 8 days ago

Total Commits: 998
Total Committers: 44
Avg Commits per committer: 22.682
Development Distribution Score (DDS): 0.349

Commits in past year: 260
Committers in past year: 6
Avg Commits per committer in past year: 43.333
Development Distribution Score (DDS) in past year: 0.085

Name	Email	Commits
nicholas a. evans	n**k@r**v	650
Shugo Maeda	s**o@r**g	129
Hiroshi SHIBATA	h**t@r**g	42
dependabot[bot]	4****]	38
Nobuyoshi Nakada	n**u@r**g	25
Kazuhiro NISHIYAMA	zn@m****m	12
matz	m**z@b**e	8
akr	a**r@b**e	7
Stefan Hoffmann	s**3@g**m	6
Avdi Grimm	a****i	5
shyouhei	s**i@b**e	5
knu	k**u@b**e	5
Arnt Gulbrandsen	a**t@g**o	5
normal	n**l@b**e	4
Yusuke Endoh	m**e@r**g	4
naruse	n**e@b**e	4
gsinclair	g**r@b**e	4
Damir Gainetdinov	d**v@z**m	3
Sarah Sunday	3****y	3
drbrain	d**n@b**e	3
usa	u**a@b**e	3
ko1	k**1@b**e	3
Bijan Rahnema	b**n@s**m	2
Jeremy Evans	c**e@j**t	2
Vít Ondruch	v**h@r**m	2
marcandre	m**e@b**e	2
svn	s**n@b**e	2
taku0	m**b@t**g	2
gotoyuzo	g**o@b**e	2
Takashi Kokubun	t**n@g**m	2
and 14 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 92
Total pull requests: 557
Average time to close issues: 8 months
Average time to close pull requests: 14 days
Total issue authors: 27
Total pull request authors: 16
Average comments per issue: 1.77
Average comments per pull request: 0.4
Merged pull request: 493
Bot issues: 1
Bot pull requests: 45

Past year issues: 14
Past year pull requests: 263
Past year average time to close issues: 1 day
Past year average time to close pull requests: 1 day
Past year issue authors: 11
Past year pull request authors: 5
Past year average comments per issue: 3.64
Past year average comments per pull request: 0.14
Past year merged pull request: 229
Past year bot issues: 0
Past year bot pull requests: 17

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ruby/net-imap

Top Issue Authors

nevans (63)
stanley90 (2)
Neustradamus (2)
hsbt (2)
rhenium (1)
xiaoge1001 (1)
sos4nt (1)
hoffi (1)
dependabot[bot] (1)
joelmoss (1)
Eguthrie3214 (1)
voxik (1)
denzelem (1)
shugo (1)
abhayranjan7 (1)

Top Pull Request Authors

nevans (475)
dependabot[bot] (45)
hsbt (13)
taku0 (4)
shugo (4)
avdi (2)
sorah (2)
arnt (2)
nobu (2)
gaynetdinov (2)
debasishbsws (1)
petergoldstein (1)
ssunday (1)
mark-young-atg (1)
hoffi (1)

Top Issue Labels

IMAP4rev2 (23)
SASL :lock: (11)
IMAP4rev1 (8)
bug (2)
backport (1)
help wanted (1)
dependencies (1)
enhancement (1)

Top Pull Request Labels

enhancement (63)
documentation (55)
dependencies (52)
backport (41)
bug (40)
tests-only (37)
SASL :lock: (35)
IMAP4rev2 (17)
github_actions (12)
IMAP4rev1 (11)
breaking-change (8)
v0.5 (1)

Package metadata

Total packages: 19
Total downloads:
- rubygems: 547,823,737 total
Total docker downloads: 6,625,985,594
Total dependent packages: 22 (may contain duplicates)
Total dependent repositories: 33,570 (may contain duplicates)
Total versions: 214
Total maintainers: 5
Total advisories: 4

rubygems.org: net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Documentation: http://www.rubydoc.info/gems/net-imap/
Licenses: Ruby,BSD-2-Clause
Latest release: 0.5.12 (published 2 months ago)
Last Synced: 2025-12-08T01:11:17.896Z (2 days ago)
Versions: 56
Dependent Packages: 22
Dependent Repositories: 33,570
Downloads: 273,981,881 Total
Docker Downloads: 3,312,992,797
Rankings:
- Docker downloads count: 0.031%
- Dependent repos count: 0.182%
- Downloads: 0.221%
- Dependent packages count: 1.094%
- Average: 2.534%
- Forks count: 5.39%
- Stargazers count: 8.287%
Maintainers (4)
- hsbt
- naruse
- shugo
- nevans
Advisories:
- net-imap rubygem vulnerable to possible DoS by memory exhaustion
- Possible DoS by memory exhaustion in net-imap

proxy.golang.org: github.com/ruby/net-imap

Homepage:
Documentation: https://pkg.go.dev/github.com/ruby/net-imap#section-documentation
Licenses: other
Latest release: v0.5.12 (published 2 months ago)
Last Synced: 2025-12-06T23:01:59.030Z (3 days ago)
Versions: 54
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Forks count: 4.774%
- Stargazers count: 6.595%
- Average: 7.937%
- Dependent packages count: 9.576%
- Dependent repos count: 10.802%

alpine-v3.18: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.3.4.1-r0 (published over 1 year ago)
Last Synced: 2025-12-06T23:02:08.997Z (3 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 11.476%
- Forks count: 21.565%
- Stargazers count: 24.338%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.18: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.3.4.1-r0 (published over 1 year ago)
Last Synced: 2025-12-07T06:08:24.809Z (3 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 11.476%
- Forks count: 21.565%
- Stargazers count: 24.338%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.16: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.2.4-r0 (published over 1 year ago)
Last Synced: 2025-12-06T23:02:04.444Z (3 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 15.537%
- Forks count: 16.306%
- Stargazers count: 18.53%
- Dependent packages count: 27.311%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.16: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.2.4-r0 (published over 1 year ago)
Last Synced: 2025-12-06T23:02:05.539Z (3 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 15.537%
- Forks count: 16.306%
- Stargazers count: 18.53%
- Dependent packages count: 27.311%
Maintainers (1)
- jakub@jirutka.cz

alpine-edge: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.5.8-r0 (published 7 months ago)
Last Synced: 2025-12-06T05:00:59.269Z (4 days ago)
Versions: 8
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 14.641%
- Average: 15.775%
- Forks count: 22.441%
- Stargazers count: 26.018%
Maintainers (1)
- jakub@jirutka.cz

alpine-edge: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.5.8-r0 (published 7 months ago)
Last Synced: 2025-12-06T23:02:18.713Z (3 days ago)
Versions: 8
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 14.641%
- Average: 15.775%
- Forks count: 22.441%
- Stargazers count: 26.018%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.17: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.2.4-r0 (published over 1 year ago)
Last Synced: 2025-12-03T03:27:25.545Z (7 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 17.185%
- Forks count: 19.395%
- Stargazers count: 22.089%
- Dependent packages count: 27.254%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.17: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.2.4-r0 (published over 1 year ago)
Last Synced: 2025-12-06T23:02:06.517Z (3 days ago)
Versions: 2
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Average: 17.185%
- Forks count: 19.395%
- Stargazers count: 22.089%
- Dependent packages count: 27.254%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.19: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.3.9-r0 (published 8 months ago)
Last Synced: 2025-11-20T06:21:11.937Z (20 days ago)
Versions: 3
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.22: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.5.8-r0 (published 7 months ago)
Last Synced: 2025-12-06T23:02:13.215Z (3 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

gem.coop: net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Documentation: http://www.rubydoc.info/gems/net-imap/
Licenses: Ruby,BSD-2-Clause
Latest release: 0.5.12 (published 2 months ago)
Last Synced: 2025-12-06T23:01:57.062Z (3 days ago)
Versions: 56
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 273,841,856 Total
Docker Downloads: 3,312,992,797
Rankings:
- Downloads: 0.0%
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (4)
- naruse
- shugo
- hsbt
- nevans
Advisories:
- Possible DoS by memory exhaustion in net-imap
- net-imap rubygem vulnerable to possible DoS by memory exhaustion

alpine-v3.21: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.4.22-r0 (published 18 days ago)
Last Synced: 2025-12-08T18:17:44.527Z (1 day ago)
Versions: 3
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.22: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.5.8-r0 (published 7 months ago)
Last Synced: 2025-12-06T23:02:07.602Z (3 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.21: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.4.22-r0 (published 18 days ago)
Last Synced: 2025-12-08T19:05:45.723Z (1 day ago)
Versions: 3
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.20: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.4.22-r0 (published 18 days ago)
Last Synced: 2025-12-08T18:19:59.782Z (1 day ago)
Versions: 3
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.20: ruby-net-imap-doc

Ruby client api for Internet Message Access Protocol (ri docs)

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.4.22-r0 (published 18 days ago)
Last Synced: 2025-12-08T18:19:59.802Z (1 day ago)
Versions: 3
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

alpine-v3.19: ruby-net-imap

Ruby client api for Internet Message Access Protocol

Homepage: https://github.com/ruby/net-imap
Licenses: BSD-2-Clause AND Ruby
Latest release: 0.3.9-r0 (published 8 months ago)
Last Synced: 2025-12-06T23:02:10.200Z (3 days ago)
Versions: 3
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 100%
Maintainers (1)
- jakub@jirutka.cz

Dependencies

.github/workflows/test.yml actions

actions/checkout v3 composite
ruby/setup-ruby v1 composite

Gemfile rubygems

rake >= 0
rdoc >= 0
test-unit >= 0

net-imap.gemspec rubygems

digest >= 0 development
strscan >= 0 development
date >= 0
net-protocol >= 0

.github/workflows/pages.yml actions

actions/checkout v5 composite
actions/configure-pages v5 composite
actions/deploy-pages v4 composite
actions/upload-pages-artifact v4 composite
ruby/setup-ruby v1 composite

.github/workflows/push_gem.yml actions

actions/checkout v5 composite
ruby/setup-ruby v1 composite
rubygems/release-gem v1 composite
step-security/harden-runner 95d9a5deda9de15063e7595e9719c11c38c90ae2 composite

Score: 31.475109703102433

https://github.com/ruby/net-imap

Keywords

Keywords from Contributors

Repository metadata

README.md

Net::IMAP

Installation

Usage

Connect with TLS to port 993

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

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

Development

Contributing

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

rubygems.org: net-imap

proxy.golang.org: github.com/ruby/net-imap

alpine-v3.18: ruby-net-imap

alpine-v3.18: ruby-net-imap-doc

alpine-v3.16: ruby-net-imap-doc

alpine-v3.16: ruby-net-imap

alpine-edge: ruby-net-imap

alpine-edge: ruby-net-imap-doc

alpine-v3.17: ruby-net-imap

alpine-v3.17: ruby-net-imap-doc

alpine-v3.19: ruby-net-imap-doc

alpine-v3.22: ruby-net-imap-doc

gem.coop: net-imap

alpine-v3.21: ruby-net-imap

alpine-v3.22: ruby-net-imap

alpine-v3.21: ruby-net-imap-doc

alpine-v3.20: ruby-net-imap

alpine-v3.20: ruby-net-imap-doc

alpine-v3.19: ruby-net-imap

Dependencies