net-imap 0.2.2 → 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of net-imap might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/.github/workflows/test.yml +1 -1
- data/Rakefile +7 -0
- data/lib/net/imap/authenticators/cram_md5.rb +1 -1
- data/lib/net/imap/command_data.rb +2 -0
- data/lib/net/imap/data_encoding.rb +59 -0
- data/lib/net/imap/errors.rb +59 -0
- data/lib/net/imap/flags.rb +192 -34
- data/lib/net/imap/response_parser.rb +3 -7
- data/lib/net/imap.rb +7 -119
- data/net-imap.gemspec +2 -2
- metadata +5 -6
- data/bin/console +0 -14
- data/bin/setup +0 -8
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 9ea332e9eb05f1d978f8071be747359ef37109b6250b63d2d7681ca13464447b
|
4
|
+
data.tar.gz: 0f38117a229089826b847185734cc558d8c81410c4db67cc4b2e9c07218a339b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 39b06bd45b38bcb822e9a693ba6c7182bbf11c87f55805ab8a2e36fa357e53a2a6ac209eb348b37e3b56aa5c8dadb616570613f6b9f132249a7b94bb3a349073
|
7
|
+
data.tar.gz: 59af9d5f203bb10bc5a4851718945d314827deae445468752d1bd5b5e93e250f054076cc8d6cb68edfce7a289db87597277ac8facc0e208556c7ea553d564bb8
|
data/.github/workflows/test.yml
CHANGED
data/Rakefile
CHANGED
@@ -7,4 +7,11 @@ Rake::TestTask.new(:test) do |t|
|
|
7
7
|
t.test_files = FileList["test/**/test_*.rb"]
|
8
8
|
end
|
9
9
|
|
10
|
+
task :sync_tool do
|
11
|
+
require 'fileutils'
|
12
|
+
FileUtils.cp "../ruby/tool/lib/core_assertions.rb", "./test/lib"
|
13
|
+
FileUtils.cp "../ruby/tool/lib/envutil.rb", "./test/lib"
|
14
|
+
FileUtils.cp "../ruby/tool/lib/find_executable.rb", "./test/lib"
|
15
|
+
end
|
16
|
+
|
10
17
|
task :default => :test
|
@@ -1,5 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
+
require_relative "errors"
|
4
|
+
|
3
5
|
module Net
|
4
6
|
class IMAP < Protocol
|
5
7
|
|
@@ -43,5 +45,62 @@ module Net
|
|
43
45
|
return time.strftime('%d-%b-%Y %H:%M %z')
|
44
46
|
end
|
45
47
|
|
48
|
+
# Common validators of number and nz_number types
|
49
|
+
module NumValidator # :nodoc
|
50
|
+
module_function
|
51
|
+
|
52
|
+
# Check is passed argument valid 'number' in RFC 3501 terminology
|
53
|
+
def valid_number?(num)
|
54
|
+
# [RFC 3501]
|
55
|
+
# number = 1*DIGIT
|
56
|
+
# ; Unsigned 32-bit integer
|
57
|
+
# ; (0 <= n < 4,294,967,296)
|
58
|
+
num >= 0 && num < 4294967296
|
59
|
+
end
|
60
|
+
|
61
|
+
# Check is passed argument valid 'nz_number' in RFC 3501 terminology
|
62
|
+
def valid_nz_number?(num)
|
63
|
+
# [RFC 3501]
|
64
|
+
# nz-number = digit-nz *DIGIT
|
65
|
+
# ; Non-zero unsigned 32-bit integer
|
66
|
+
# ; (0 < n < 4,294,967,296)
|
67
|
+
num != 0 && valid_number?(num)
|
68
|
+
end
|
69
|
+
|
70
|
+
# Check is passed argument valid 'mod_sequence_value' in RFC 4551 terminology
|
71
|
+
def valid_mod_sequence_value?(num)
|
72
|
+
# mod-sequence-value = 1*DIGIT
|
73
|
+
# ; Positive unsigned 64-bit integer
|
74
|
+
# ; (mod-sequence)
|
75
|
+
# ; (1 <= n < 18,446,744,073,709,551,615)
|
76
|
+
num >= 1 && num < 18446744073709551615
|
77
|
+
end
|
78
|
+
|
79
|
+
# Ensure argument is 'number' or raise DataFormatError
|
80
|
+
def ensure_number(num)
|
81
|
+
return if valid_number?(num)
|
82
|
+
|
83
|
+
msg = "number must be unsigned 32-bit integer: #{num}"
|
84
|
+
raise DataFormatError, msg
|
85
|
+
end
|
86
|
+
|
87
|
+
# Ensure argument is 'nz_number' or raise DataFormatError
|
88
|
+
def ensure_nz_number(num)
|
89
|
+
return if valid_nz_number?(num)
|
90
|
+
|
91
|
+
msg = "nz_number must be non-zero unsigned 32-bit integer: #{num}"
|
92
|
+
raise DataFormatError, msg
|
93
|
+
end
|
94
|
+
|
95
|
+
# Ensure argument is 'mod_sequence_value' or raise DataFormatError
|
96
|
+
def ensure_mod_sequence_value(num)
|
97
|
+
return if valid_mod_sequence_value?(num)
|
98
|
+
|
99
|
+
msg = "mod_sequence_value must be unsigned 64-bit integer: #{num}"
|
100
|
+
raise DataFormatError, msg
|
101
|
+
end
|
102
|
+
|
103
|
+
end
|
104
|
+
|
46
105
|
end
|
47
106
|
end
|
@@ -0,0 +1,59 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Net
|
4
|
+
class IMAP < Protocol
|
5
|
+
|
6
|
+
# Superclass of IMAP errors.
|
7
|
+
class Error < StandardError
|
8
|
+
end
|
9
|
+
|
10
|
+
# Error raised when data is in the incorrect format.
|
11
|
+
class DataFormatError < Error
|
12
|
+
end
|
13
|
+
|
14
|
+
# Error raised when a response from the server is non-parseable.
|
15
|
+
class ResponseParseError < Error
|
16
|
+
end
|
17
|
+
|
18
|
+
# Superclass of all errors used to encapsulate "fail" responses
|
19
|
+
# from the server.
|
20
|
+
class ResponseError < Error
|
21
|
+
|
22
|
+
# The response that caused this error
|
23
|
+
attr_accessor :response
|
24
|
+
|
25
|
+
def initialize(response)
|
26
|
+
@response = response
|
27
|
+
|
28
|
+
super @response.data.text
|
29
|
+
end
|
30
|
+
|
31
|
+
end
|
32
|
+
|
33
|
+
# Error raised upon a "NO" response from the server, indicating
|
34
|
+
# that the client command could not be completed successfully.
|
35
|
+
class NoResponseError < ResponseError
|
36
|
+
end
|
37
|
+
|
38
|
+
# Error raised upon a "BAD" response from the server, indicating
|
39
|
+
# that the client command violated the IMAP protocol, or an internal
|
40
|
+
# server failure has occurred.
|
41
|
+
class BadResponseError < ResponseError
|
42
|
+
end
|
43
|
+
|
44
|
+
# Error raised upon a "BYE" response from the server, indicating
|
45
|
+
# that the client is not being allowed to login, or has been timed
|
46
|
+
# out due to inactivity.
|
47
|
+
class ByeResponseError < ResponseError
|
48
|
+
end
|
49
|
+
|
50
|
+
# Error raised upon an unknown response from the server.
|
51
|
+
class UnknownResponseError < ResponseError
|
52
|
+
end
|
53
|
+
|
54
|
+
RESPONSE_ERRORS = Hash.new(ResponseError)
|
55
|
+
RESPONSE_ERRORS["NO"] = NoResponseError
|
56
|
+
RESPONSE_ERRORS["BAD"] = BadResponseError
|
57
|
+
|
58
|
+
end
|
59
|
+
end
|
data/lib/net/imap/flags.rb
CHANGED
@@ -3,74 +3,232 @@
|
|
3
3
|
module Net
|
4
4
|
class IMAP < Protocol
|
5
5
|
|
6
|
-
#
|
6
|
+
# -------------------------------------------------------------------------
|
7
|
+
# :section: Message Flags: system flags
|
7
8
|
#
|
8
|
-
#
|
9
|
+
# A message has a list of zero or more named tokens, known as "flags",
|
10
|
+
# associated with it. A flag is set by its addition to this list and is
|
11
|
+
# cleared by its removal. There are two types of flags in IMAP4rev2: system
|
12
|
+
# flags and keywords. A flag of either type can be permanent or
|
13
|
+
# session-only.
|
14
|
+
#
|
15
|
+
# A "system flag" is a message flag name that is predefined in the IMAP
|
16
|
+
# specification and begins with "\". +Net::IMAP+ returns all system flags
|
17
|
+
# as symbols, without the "\" prefix.
|
18
|
+
#
|
19
|
+
# The descriptions here were copied from the IMAP4rev2 specification:
|
20
|
+
# [RFC-9051 § 2.3.2](https://www.rfc-editor.org/rfc/rfc9051.html#section-2.3.2)
|
21
|
+
#
|
22
|
+
# See [RFC-3501 § 2.3.2](https://www.rfc-editor.org/rfc/rfc3501.html#section-2.3.2)
|
23
|
+
# for a description of the flags message attribute and system flag semantics
|
24
|
+
# in IMAP4rev1.
|
25
|
+
# -------------------------------------------------------------------------
|
26
|
+
|
27
|
+
# Flag indicating a message has been read.
|
9
28
|
SEEN = :Seen
|
10
29
|
|
11
|
-
# :category: Message Flags
|
12
|
-
#
|
13
30
|
# Flag indicating a message has been answered.
|
14
31
|
ANSWERED = :Answered
|
15
32
|
|
16
|
-
#
|
17
|
-
#
|
18
|
-
# Flag indicating a message has been flagged for special or urgent
|
33
|
+
# A message flag indicating a message has been flagged for special or urgent
|
19
34
|
# attention.
|
35
|
+
#
|
36
|
+
# Also a mailbox special use attribute, which indicates that this mailbox
|
37
|
+
# presents all messages marked in some way as "important". When this
|
38
|
+
# special use is supported, it is likely to represent a virtual mailbox
|
39
|
+
# collecting messages (from other mailboxes) that are marked with the
|
40
|
+
# "\Flagged" message flag.
|
20
41
|
FLAGGED = :Flagged
|
21
42
|
|
22
|
-
# :category: Message Flags
|
23
|
-
#
|
24
43
|
# Flag indicating a message has been marked for deletion. This
|
25
44
|
# will occur when the mailbox is closed or expunged.
|
26
45
|
DELETED = :Deleted
|
27
46
|
|
28
|
-
# :category: Message Flags
|
29
|
-
#
|
30
47
|
# Flag indicating a message is only a draft or work-in-progress version.
|
31
48
|
DRAFT = :Draft
|
32
49
|
|
33
|
-
# :category: Message Flags
|
34
|
-
#
|
35
50
|
# Flag indicating that the message is "recent," meaning that this
|
36
51
|
# session is the first session in which the client has been notified
|
37
52
|
# of this message.
|
53
|
+
#
|
54
|
+
# This flag was defined by
|
55
|
+
# IMAP4rev1 [RFC-3501](https://www.rfc-editor.org/rfc/rfc3501.html),
|
56
|
+
# and has been deprecated by
|
57
|
+
# IMAP4rev2 [RFC-9051](https://www.rfc-editor.org/rfc/rfc9051.html).
|
38
58
|
RECENT = :Recent
|
39
59
|
|
40
|
-
#
|
60
|
+
# -------------------------------------------------------------------------
|
61
|
+
# :section: Mailbox Name Attributes, Base attributes
|
62
|
+
# Mailbox name attributes will be returned in LIST responses. Base
|
63
|
+
# attributes must be returned according to the server's capabilities.
|
41
64
|
#
|
42
|
-
#
|
43
|
-
#
|
44
|
-
|
65
|
+
# IMAP4 specifies that all mailbox name attributes, including future
|
66
|
+
# extensions, begin with "\". +Net::IMAP+ returns all mailbox attributes as
|
67
|
+
# symbols, without the "\" prefix.
|
68
|
+
#
|
69
|
+
# The descriptions here were copied from the IMAP4rev2 specification:
|
70
|
+
# [RFC9051 § 7.3.1](https://www.rfc-editor.org/rfc/rfc9051.html#section-7.3.1).
|
71
|
+
#
|
72
|
+
# Other mailbox name attributes can be found in the [IANA IMAP Mailbox Name
|
73
|
+
# Attributes registry](https://www.iana.org/assignments/imap-mailbox-name-attributes/imap-mailbox-name-attributes.xhtml)].
|
74
|
+
# -------------------------------------------------------------------------
|
75
|
+
|
76
|
+
# The "\NonExistent" attribute indicates that a mailbox name does not refer
|
77
|
+
# to an existing mailbox. Note that this attribute is not meaningful by
|
78
|
+
# itself, as mailbox names that match the canonical LIST pattern but don't
|
79
|
+
# exist must not be returned unless one of the two conditions listed below
|
80
|
+
# is also satisfied:
|
81
|
+
#
|
82
|
+
# 1. The mailbox name also satisfies the selection criteria (for example,
|
83
|
+
# it is subscribed and the "SUBSCRIBED" selection option has been
|
84
|
+
# specified).
|
85
|
+
#
|
86
|
+
# 2. "RECURSIVEMATCH" has been specified, and the mailbox name has at least
|
87
|
+
# one descendant mailbox name that does not match the LIST pattern and
|
88
|
+
# does match the selection criteria.
|
89
|
+
#
|
90
|
+
# In practice, this means that the "\NonExistent" attribute is usually
|
91
|
+
# returned with one or more of "\Subscribed", "\Remote", "\HasChildren", or
|
92
|
+
# the CHILDINFO extended data item.
|
93
|
+
#
|
94
|
+
# The client must treat the presence of the \NonExistent attribute as if the
|
95
|
+
# \NoSelect attribute was also sent by the server
|
96
|
+
NONEXISTENT = :NonExistent
|
45
97
|
|
46
|
-
#
|
98
|
+
# Mailbox attribute indicating it is not possible for any child levels of
|
99
|
+
# hierarchy to exist under this name; no child levels exist now and none can
|
100
|
+
# be created in the future children.
|
47
101
|
#
|
48
|
-
#
|
102
|
+
# The client must treat the presence of the \NoInferiors attribute as if the
|
103
|
+
# \HasNoChildren attribute was also sent by the server
|
104
|
+
NOINFERIORS = :Noinferiors
|
105
|
+
|
106
|
+
# Mailbox attribute indicating it is not possible to use this name as a
|
107
|
+
# selectable mailbox.
|
49
108
|
NOSELECT = :Noselect
|
50
109
|
|
51
|
-
#
|
110
|
+
# The presence of this attribute indicates that the mailbox has child
|
111
|
+
# mailboxes. A server SHOULD NOT set this attribute if there are child
|
112
|
+
# mailboxes and the user does not have permission to access any of them. In
|
113
|
+
# this case, \HasNoChildren SHOULD be used. In many cases, however, a server
|
114
|
+
# may not be able to efficiently compute whether a user has access to any
|
115
|
+
# child mailboxes. Note that even though the \HasChildren attribute for a
|
116
|
+
# mailbox must be correct at the time of processing the mailbox, a client
|
117
|
+
# must be prepared to deal with a situation when a mailbox is marked with
|
118
|
+
# the \HasChildren attribute, but no child mailbox appears in the response
|
119
|
+
# to the LIST command. This might happen, for example, due to child
|
120
|
+
# mailboxes being deleted or made inaccessible to the user (using access
|
121
|
+
# control) by another client before the server is able to list them.
|
122
|
+
#
|
123
|
+
# It is an error for the server to return both a \HasChildren and a
|
124
|
+
# \HasNoChildren attribute in the same LIST response. A client that
|
125
|
+
# encounters a LIST response with both \HasChildren and \HasNoChildren
|
126
|
+
# attributes present should act as if both are absent in the LIST response.
|
127
|
+
HAS_CHILDREN = :HasChildren
|
128
|
+
|
129
|
+
# The presence of this attribute indicates that the mailbox has NO child
|
130
|
+
# mailboxes that are accessible to the currently authenticated user.
|
52
131
|
#
|
53
|
-
#
|
54
|
-
#
|
55
|
-
#
|
132
|
+
# It is an error for the server to return both a \HasChildren and a
|
133
|
+
# \HasNoChildren attribute in the same LIST response. A client that
|
134
|
+
# encounters a LIST response with both \HasChildren and \HasNoChildren
|
135
|
+
# attributes present should act as if both are absent in the LIST response.
|
136
|
+
#
|
137
|
+
# Note: the \HasNoChildren attribute should not be confused with the
|
138
|
+
# \NoInferiors attribute, which indicates that no child mailboxes exist now
|
139
|
+
# and none can be created in the future.
|
140
|
+
HAS_NO_CHILDREN = :HasNoChildren
|
141
|
+
|
142
|
+
# The mailbox has been marked "interesting" by the server; the mailbox
|
143
|
+
# probably contains messages that have been added since the last time the
|
144
|
+
# mailbox was selected.
|
145
|
+
#
|
146
|
+
# If it is not feasible for the server to determine whether or not the
|
147
|
+
# mailbox is "interesting", the server SHOULD NOT send either \Marked or
|
148
|
+
# \Unmarked. The server MUST NOT send more than one of \Marked, \Unmarked,
|
149
|
+
# and \Noselect for a single mailbox, and it MAY send none of these.
|
56
150
|
MARKED = :Marked
|
57
151
|
|
58
|
-
#
|
152
|
+
# The mailbox does not contain any additional messages since the last time
|
153
|
+
# the mailbox was selected.
|
59
154
|
#
|
60
|
-
#
|
155
|
+
# If it is not feasible for the server to determine whether or not the
|
156
|
+
# mailbox is "interesting", the server SHOULD NOT send either \Marked or
|
157
|
+
# \Unmarked. The server MUST NOT send more than one of \Marked, \Unmarked,
|
158
|
+
# and \Noselect for a single mailbox, and it MAY send none of these.
|
61
159
|
UNMARKED = :Unmarked
|
62
160
|
|
63
|
-
|
161
|
+
# The mailbox name was subscribed to using the SUBSCRIBE command.
|
162
|
+
SUBSCRIBED = :Subscribed
|
163
|
+
|
164
|
+
# The mailbox is a remote mailbox.
|
165
|
+
REMOTE = :Remove
|
166
|
+
|
167
|
+
# -------------------------------------------------------------------------
|
168
|
+
# :section: Mailbox Name Attributes, Special Use
|
169
|
+
# Mailbox name attributes will be returned in LIST responses. In addition
|
170
|
+
# to the base mailbox name attributes defined above, an IMAP server MAY also
|
171
|
+
# include any or all of the following attributes that denote "role" (or
|
172
|
+
# "special-use") of a mailbox. These attributes are included along with base
|
173
|
+
# attributes defined above. A given mailbox may have none, one, or more than
|
174
|
+
# one of these attributes. In some cases, a special use is advice to a
|
175
|
+
# client about what to put in that mailbox. In other cases, it's advice to a
|
176
|
+
# client about what to expect to find there.
|
177
|
+
#
|
178
|
+
# IMAP4 specifies that all mailbox name attributes, including future
|
179
|
+
# extensions, begin with "\". +Net::IMAP+ returns all mailbox attributes as
|
180
|
+
# symbols, without the "\" prefix.
|
181
|
+
#
|
182
|
+
# The descriptions here were copied from the IMAP4rev2 specification:
|
183
|
+
# [RFC-9051 § 7.3.1](https://www.rfc-editor.org/rfc/rfc9051.html#section-7.3.1).
|
184
|
+
#
|
185
|
+
# Other mailbox name attributes can be found in the [IANA IMAP Mailbox Name
|
186
|
+
# Attributes registry](https://www.iana.org/assignments/imap-mailbox-name-attributes/imap-mailbox-name-attributes.xhtml)].
|
187
|
+
# -------------------------------------------------------------------------
|
188
|
+
|
189
|
+
# Mailbox attribute indicating that this mailbox presents all messages in
|
190
|
+
# the user's message store. Implementations MAY omit some messages, such as,
|
191
|
+
# perhaps, those in \Trash and \Junk. When this special use is supported, it
|
192
|
+
# is almost certain to represent a virtual mailbox
|
193
|
+
ALL = :All
|
194
|
+
|
195
|
+
# Mailbox attribute indicating that this mailbox is used to archive
|
196
|
+
# messages. The meaning of an "archival" mailbox is server dependent;
|
197
|
+
# typically, it will be used to get messages out of the inbox, or otherwise
|
198
|
+
# keep them out of the user's way, while still making them accessible
|
199
|
+
ARCHIVE = :Archive
|
200
|
+
|
201
|
+
# Mailbox attribute indicating that this mailbox is used to hold draft
|
202
|
+
# messages -- typically, messages that are being composed but have not yet
|
203
|
+
# been sent. In some server implementations, this might be a virtual
|
204
|
+
# mailbox, containing messages from other mailboxes that are marked with the
|
205
|
+
# "\Draft" message flag. Alternatively, this might just be advice that a
|
206
|
+
# client put drafts here
|
207
|
+
DRAFTS = :Drafts
|
208
|
+
|
209
|
+
# FLAGGED is defined with the system flags section.
|
210
|
+
|
211
|
+
# Mailbox attribute indicating that this mailbox is where messages deemed to
|
212
|
+
# be junk mail are held. Some server implementations might put messages here
|
213
|
+
# automatically. Alternatively, this might just be advice to a client-side
|
214
|
+
# spam filter.
|
215
|
+
JUNK = :Junk
|
64
216
|
|
65
|
-
#
|
66
|
-
|
67
|
-
|
68
|
-
|
217
|
+
# Mailbox attribute indicating that this mailbox is used to hold copies of
|
218
|
+
# messages that have been sent. Some server implementations might put
|
219
|
+
# messages here automatically. Alternatively, this might just be advice that
|
220
|
+
# a client save sent messages here.
|
221
|
+
SENT = :Sent
|
69
222
|
|
70
|
-
#
|
71
|
-
|
72
|
-
|
73
|
-
|
223
|
+
# Mailbox attribute indicating that this mailbox is used to hold messages
|
224
|
+
# that have been deleted or marked for deletion. In some server
|
225
|
+
# implementations, this might be a virtual mailbox, containing messages from
|
226
|
+
# other mailboxes that are marked with the "\Deleted" message flag.
|
227
|
+
# Alternatively, this might just be advice that a client that chooses not to
|
228
|
+
# use the IMAP "\Deleted" model should use as its trash location. In server
|
229
|
+
# implementations that strictly expect the IMAP "\Deleted" model, this
|
230
|
+
# special use is likely not to be supported.
|
231
|
+
TRASH = :Trash
|
74
232
|
|
75
233
|
end
|
76
234
|
end
|
@@ -1,5 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
|
3
|
+
require_relative "errors"
|
4
|
+
|
3
5
|
module Net
|
4
6
|
class IMAP < Protocol
|
5
7
|
|
@@ -9,7 +11,6 @@ module Net
|
|
9
11
|
@pos = nil
|
10
12
|
@lex_state = nil
|
11
13
|
@token = nil
|
12
|
-
@flag_symbols = {}
|
13
14
|
end
|
14
15
|
|
15
16
|
def parse(str)
|
@@ -1212,12 +1213,7 @@ module Net
|
|
1212
1213
|
if atom
|
1213
1214
|
atom
|
1214
1215
|
else
|
1215
|
-
|
1216
|
-
@flag_symbols[symbol] = true
|
1217
|
-
if @flag_symbols.length > IMAP.max_flag_count
|
1218
|
-
raise FlagCountError, "number of flag symbols exceeded"
|
1219
|
-
end
|
1220
|
-
symbol
|
1216
|
+
flag.capitalize.intern
|
1221
1217
|
end
|
1222
1218
|
}
|
1223
1219
|
else
|
data/lib/net/imap.rb
CHANGED
@@ -13,7 +13,6 @@
|
|
13
13
|
# See Net::IMAP for documentation.
|
14
14
|
#
|
15
15
|
|
16
|
-
|
17
16
|
require "socket"
|
18
17
|
require "monitor"
|
19
18
|
require 'net/protocol'
|
@@ -22,12 +21,6 @@ begin
|
|
22
21
|
rescue LoadError
|
23
22
|
end
|
24
23
|
|
25
|
-
require_relative "imap/command_data"
|
26
|
-
require_relative "imap/data_encoding"
|
27
|
-
require_relative "imap/flags"
|
28
|
-
require_relative "imap/response_data"
|
29
|
-
require_relative "imap/response_parser"
|
30
|
-
|
31
24
|
module Net
|
32
25
|
|
33
26
|
#
|
@@ -227,7 +220,7 @@ module Net
|
|
227
220
|
# Unicode", RFC-2152[https://tools.ietf.org/html/rfc2152], May 1997.
|
228
221
|
#
|
229
222
|
class IMAP < Protocol
|
230
|
-
VERSION = "0.2.
|
223
|
+
VERSION = "0.2.4"
|
231
224
|
|
232
225
|
include MonitorMixin
|
233
226
|
if defined?(OpenSSL::SSL)
|
@@ -1462,118 +1455,13 @@ module Net
|
|
1462
1455
|
end
|
1463
1456
|
end
|
1464
1457
|
|
1465
|
-
# Common validators of number and nz_number types
|
1466
|
-
module NumValidator # :nodoc
|
1467
|
-
class << self
|
1468
|
-
# Check is passed argument valid 'number' in RFC 3501 terminology
|
1469
|
-
def valid_number?(num)
|
1470
|
-
# [RFC 3501]
|
1471
|
-
# number = 1*DIGIT
|
1472
|
-
# ; Unsigned 32-bit integer
|
1473
|
-
# ; (0 <= n < 4,294,967,296)
|
1474
|
-
num >= 0 && num < 4294967296
|
1475
|
-
end
|
1476
|
-
|
1477
|
-
# Check is passed argument valid 'nz_number' in RFC 3501 terminology
|
1478
|
-
def valid_nz_number?(num)
|
1479
|
-
# [RFC 3501]
|
1480
|
-
# nz-number = digit-nz *DIGIT
|
1481
|
-
# ; Non-zero unsigned 32-bit integer
|
1482
|
-
# ; (0 < n < 4,294,967,296)
|
1483
|
-
num != 0 && valid_number?(num)
|
1484
|
-
end
|
1485
|
-
|
1486
|
-
# Check is passed argument valid 'mod_sequence_value' in RFC 4551 terminology
|
1487
|
-
def valid_mod_sequence_value?(num)
|
1488
|
-
# mod-sequence-value = 1*DIGIT
|
1489
|
-
# ; Positive unsigned 64-bit integer
|
1490
|
-
# ; (mod-sequence)
|
1491
|
-
# ; (1 <= n < 18,446,744,073,709,551,615)
|
1492
|
-
num >= 1 && num < 18446744073709551615
|
1493
|
-
end
|
1494
|
-
|
1495
|
-
# Ensure argument is 'number' or raise DataFormatError
|
1496
|
-
def ensure_number(num)
|
1497
|
-
return if valid_number?(num)
|
1498
|
-
|
1499
|
-
msg = "number must be unsigned 32-bit integer: #{num}"
|
1500
|
-
raise DataFormatError, msg
|
1501
|
-
end
|
1502
|
-
|
1503
|
-
# Ensure argument is 'nz_number' or raise DataFormatError
|
1504
|
-
def ensure_nz_number(num)
|
1505
|
-
return if valid_nz_number?(num)
|
1506
|
-
|
1507
|
-
msg = "nz_number must be non-zero unsigned 32-bit integer: #{num}"
|
1508
|
-
raise DataFormatError, msg
|
1509
|
-
end
|
1510
|
-
|
1511
|
-
# Ensure argument is 'mod_sequence_value' or raise DataFormatError
|
1512
|
-
def ensure_mod_sequence_value(num)
|
1513
|
-
return if valid_mod_sequence_value?(num)
|
1514
|
-
|
1515
|
-
msg = "mod_sequence_value must be unsigned 64-bit integer: #{num}"
|
1516
|
-
raise DataFormatError, msg
|
1517
|
-
end
|
1518
|
-
end
|
1519
|
-
end
|
1520
|
-
|
1521
|
-
# Superclass of IMAP errors.
|
1522
|
-
class Error < StandardError
|
1523
|
-
end
|
1524
|
-
|
1525
|
-
# Error raised when data is in the incorrect format.
|
1526
|
-
class DataFormatError < Error
|
1527
|
-
end
|
1528
|
-
|
1529
|
-
# Error raised when a response from the server is non-parseable.
|
1530
|
-
class ResponseParseError < Error
|
1531
|
-
end
|
1532
|
-
|
1533
|
-
# Superclass of all errors used to encapsulate "fail" responses
|
1534
|
-
# from the server.
|
1535
|
-
class ResponseError < Error
|
1536
|
-
|
1537
|
-
# The response that caused this error
|
1538
|
-
attr_accessor :response
|
1539
|
-
|
1540
|
-
def initialize(response)
|
1541
|
-
@response = response
|
1542
|
-
|
1543
|
-
super @response.data.text
|
1544
|
-
end
|
1545
|
-
|
1546
|
-
end
|
1547
|
-
|
1548
|
-
# Error raised upon a "NO" response from the server, indicating
|
1549
|
-
# that the client command could not be completed successfully.
|
1550
|
-
class NoResponseError < ResponseError
|
1551
|
-
end
|
1552
|
-
|
1553
|
-
# Error raised upon a "BAD" response from the server, indicating
|
1554
|
-
# that the client command violated the IMAP protocol, or an internal
|
1555
|
-
# server failure has occurred.
|
1556
|
-
class BadResponseError < ResponseError
|
1557
|
-
end
|
1558
|
-
|
1559
|
-
# Error raised upon a "BYE" response from the server, indicating
|
1560
|
-
# that the client is not being allowed to login, or has been timed
|
1561
|
-
# out due to inactivity.
|
1562
|
-
class ByeResponseError < ResponseError
|
1563
|
-
end
|
1564
|
-
|
1565
|
-
# Error raised upon an unknown response from the server.
|
1566
|
-
class UnknownResponseError < ResponseError
|
1567
|
-
end
|
1568
|
-
|
1569
|
-
RESPONSE_ERRORS = Hash.new(ResponseError)
|
1570
|
-
RESPONSE_ERRORS["NO"] = NoResponseError
|
1571
|
-
RESPONSE_ERRORS["BAD"] = BadResponseError
|
1572
|
-
|
1573
|
-
# Error raised when too many flags are interned to symbols.
|
1574
|
-
class FlagCountError < Error
|
1575
|
-
end
|
1576
1458
|
end
|
1577
1459
|
end
|
1578
1460
|
|
1461
|
+
require_relative "imap/errors"
|
1462
|
+
require_relative "imap/command_data"
|
1463
|
+
require_relative "imap/data_encoding"
|
1464
|
+
require_relative "imap/flags"
|
1465
|
+
require_relative "imap/response_data"
|
1466
|
+
require_relative "imap/response_parser"
|
1579
1467
|
require_relative "imap/authenticators"
|
data/net-imap.gemspec
CHANGED
@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
|
|
16
16
|
spec.summary = %q{Ruby client api for Internet Message Access Protocol}
|
17
17
|
spec.description = %q{Ruby client api for Internet Message Access Protocol}
|
18
18
|
spec.homepage = "https://github.com/ruby/net-imap"
|
19
|
-
spec.required_ruby_version = Gem::Requirement.new(">= 2.
|
19
|
+
spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
|
20
20
|
spec.licenses = ["Ruby", "BSD-2-Clause"]
|
21
21
|
|
22
22
|
spec.metadata["homepage_uri"] = spec.homepage
|
@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
|
|
25
25
|
# Specify which files should be added to the gem when it is released.
|
26
26
|
# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
|
27
27
|
spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
|
28
|
-
`git ls-files -z 2>/dev/null`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
|
28
|
+
`git ls-files -z 2>/dev/null`.split("\x0").reject { |f| f.match(%r{^(bin|test|spec|features)/}) }
|
29
29
|
end
|
30
30
|
spec.bindir = "exe"
|
31
31
|
spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: net-imap
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.2.
|
4
|
+
version: 0.2.4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Shugo Maeda
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2024-01-05 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: net-protocol
|
@@ -65,8 +65,6 @@ files:
|
|
65
65
|
- LICENSE.txt
|
66
66
|
- README.md
|
67
67
|
- Rakefile
|
68
|
-
- bin/console
|
69
|
-
- bin/setup
|
70
68
|
- lib/net/imap.rb
|
71
69
|
- lib/net/imap/authenticators.rb
|
72
70
|
- lib/net/imap/authenticators/cram_md5.rb
|
@@ -75,6 +73,7 @@ files:
|
|
75
73
|
- lib/net/imap/authenticators/plain.rb
|
76
74
|
- lib/net/imap/command_data.rb
|
77
75
|
- lib/net/imap/data_encoding.rb
|
76
|
+
- lib/net/imap/errors.rb
|
78
77
|
- lib/net/imap/flags.rb
|
79
78
|
- lib/net/imap/response_data.rb
|
80
79
|
- lib/net/imap/response_parser.rb
|
@@ -94,14 +93,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
94
93
|
requirements:
|
95
94
|
- - ">="
|
96
95
|
- !ruby/object:Gem::Version
|
97
|
-
version: 2.
|
96
|
+
version: 2.6.0
|
98
97
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
99
98
|
requirements:
|
100
99
|
- - ">="
|
101
100
|
- !ruby/object:Gem::Version
|
102
101
|
version: '0'
|
103
102
|
requirements: []
|
104
|
-
rubygems_version: 3.3.
|
103
|
+
rubygems_version: 3.3.27
|
105
104
|
signing_key:
|
106
105
|
specification_version: 4
|
107
106
|
summary: Ruby client api for Internet Message Access Protocol
|
data/bin/console
DELETED
@@ -1,14 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
|
3
|
-
require "bundler/setup"
|
4
|
-
require "net/imap"
|
5
|
-
|
6
|
-
# You can add fixtures and/or initialization code here to make experimenting
|
7
|
-
# with your gem easier. You can also use a different console, if you like.
|
8
|
-
|
9
|
-
# (If you use this, don't forget to add pry to your Gemfile!)
|
10
|
-
# require "pry"
|
11
|
-
# Pry.start
|
12
|
-
|
13
|
-
require "irb"
|
14
|
-
IRB.start(__FILE__)
|