Module: Net::IMAP::ResponseParser::Patterns

Relationships & Source Files
Namespace Children
Modules: `CharClassSubtraction`, `RFC3629`, `RFC5234`
Super Chains via Extension / Inclusion / Inheritance
Instance Chain: self, `RFC3629`, `RFC5234`
Defined in:	lib/net/imap/response_parser.rb

Constant Summary

ASTRING_CHAR = Internal use only
# File 'lib/net/imap/response_parser.rb', line 181
```
CHAR - ASTRING_SPECIALS
```
ASTRING_CHARS = Internal use only
# File 'lib/net/imap/response_parser.rb', line 185
```
/#{ASTRING_CHAR}+/n
```
ASTRING_SPECIALS = Internal use only
# File 'lib/net/imap/response_parser.rb', line 179
```
/[(){ \x00-\x1f\x7f%*"\\]/n
```
ATOM = Internal use only
# File 'lib/net/imap/response_parser.rb', line 184
```
/#{ATOM_CHAR}+/n
```
ATOMISH = Internal use only
# File 'lib/net/imap/response_parser.rb', line 186
```
/#{ATOM_CHAR    - /[\[]/ }+/
```
ATOM_CHAR = Internal use only
# File 'lib/net/imap/response_parser.rb', line 182
```
CHAR - ATOM_SPECIALS
```
ATOM_SPECIALS = Internal use only
atomish = 1*<any ATOM-CHAR except “[”>
```
; We use "atomish" for msg-att and section, in order
; to simplify "BODY[HEADER.FIELDS (foo bar)]".
```
atom-specials = “(” / “)” / “{” / SP / CTL / list-wildcards /
```
quoted-specials / resp-specials
```
ATOM-CHAR = <any CHAR except atom-specials> atom = 1*ATOM-CHAR ASTRING-CHAR = ATOM-CHAR / resp-specials tag = 1*<any ASTRING-CHAR except “+”>
# File 'lib/net/imap/response_parser.rb', line 178
```
/[(){ \x00-\x1f\x7f%*"\\\]]/n
```
CHAR8 = Internal use only
CHAR8 = %x01-ff
```
; any OCTET except NUL, %x00
```
# File 'lib/net/imap/response_parser.rb', line 158
```
/[\x01-\xff]/n
```
CODE_TEXT = Internal use only
# File 'lib/net/imap/response_parser.rb', line 194
```
/#{CODE_TEXT_CHAR}+/n
```
CODE_TEXT_CHAR = Internal use only

resp-text-code = … / atom [SP 1*<any TEXT-CHAR except “]”>]

# File 'lib/net/imap/response_parser.rb', line 193
```
TEXT_CHAR - RESP_SPECIALS
```

FLAG = Internal use only

flag = “Answered” / “Flagged” / “Deleted” /

"\Seen" / "\Draft" / flag-keyword / flag-extension
  ; Does not include "\Recent"

flag-extension = “" atom

; Future expansion.  Client implementations
; MUST accept flag-extension flags.  Server
; implementations MUST NOT generate
; flag-extension flags except as defined by
; a future Standard or Standards Track
; revisions of this specification.

flag-keyword = “$MDNSent” / “$Forwarded” / “$Junk” /

"$NotJunk" / "$Phishing" / atom

flag-perm = flag / “*”

Not checking for max one mbx-list-sflag in the parser.

mbx-list-oflag = “Noinferiors” / child-mbox-flag /

"\Subscribed" / "\Remote" / flag-extension
 ; Other flags; multiple from this list are
 ; possible per LIST response, but each flag
 ; can only appear once per LIST response

mbx-list-sflag = “NonExistent” / “Noselect” / “Marked” /

"\Unmarked"
 ; Selectability flags; only one per LIST response

child-mbox-flag = “HasChildren” / “HasNoChildren”

; attributes for the CHILDREN return option, at most
; one possible per LIST response

# File 'lib/net/imap/response_parser.rb', line 224

/\\?#{ATOM}/n

FLAG_EXTENSION = Internal use only
# File 'lib/net/imap/response_parser.rb', line 225
```
/\\#{ATOM}/n
```
FLAG_KEYWORD = Internal use only
# File 'lib/net/imap/response_parser.rb', line 226
```
ATOM
```
FLAG_LIST = Internal use only
flag-list = “(” [flag *(SP flag)] “)” resp-text-code =/ “PERMANENTFLAGS” SP
```
"(" [flag-perm *(SP flag-perm)] ")"
```
mbx-list-flags = *(mbx-list-oflag SP) mbx-list-sflag
```
*(SP mbx-list-oflag) /
mbx-list-oflag *(SP mbx-list-oflag)
```
(Not checking for max one mbx-list-sflag in the parser.)
# File 'lib/net/imap/response_parser.rb', line 237
```
/\G$(#{FLAG     }(?:#{SP}#{FLAG     })*|)$/ni
```
FLAG_PERM = Internal use only
# File 'lib/net/imap/response_parser.rb', line 227
```
Regexp.union(FLAG, "\\*")
```
FLAG_PERM_LIST = Internal use only
# File 'lib/net/imap/response_parser.rb', line 238
```
/\G$(#{FLAG_PERM}(?:#{SP}#{FLAG_PERM})*|)$/ni
```
LIST_WILDCARDS = Internal use only

list-wildcards = “%” / “*”

# File 'lib/net/imap/response_parser.rb', line 161
```
/[%*]/n
```

LITERAL = Internal use only

RFC3501:

literal          = "{" number "}" CRLF *CHAR8
                     ; Number represents the number of CHAR8s

RFC9051:

literal          = "{" number64 ["+"] "}" CRLF *CHAR8
                     ; <number64> represents the number of CHAR8s.
                     ; A non-synchronizing literal is distinguished
                     ; from a synchronizing literal by the presence of
                     ; "+" before the closing "}".
                     ; Non-synchronizing literals are not allowed when
                     ; sent from server to the client.

# File 'lib/net/imap/response_parser.rb', line 357

/\{(\d+)\}\r\n/n

LITERAL8 = Internal use only

RFC3516 (BINARY):

literal8         =   "~{" number "}" CRLF *OCTET
                     ; <number> represents the number of OCTETs
                     ; in the response string.

RFC9051:

literal8         =  "~{" number64 "}" CRLF *OCTET
                     ; <number64> represents the number of OCTETs
                     ; in the response string.

# File 'lib/net/imap/response_parser.rb', line 367

/~\{(\d+)\}\r\n/n

MBX_FLAG = Internal use only
# File 'lib/net/imap/response_parser.rb', line 228
```
FLAG_EXTENSION
```
MBX_LIST_FLAGS = Internal use only
# File 'lib/net/imap/response_parser.rb', line 239
```
/\G  (#{MBX_FLAG }(?:#{SP}#{MBX_FLAG })*)   /nix
```
NZ_NUMBER = Internal use only
nz-number = digit-nz *DIGIT
```
; Non-zero unsigned 32-bit integer
; (0 < n < 4,294,967,296)
```
# File 'lib/net/imap/response_parser.rb', line 281
```
/[1-9]\d*/n
```
PARTIAL_RANGE = Internal use only

partial-range = partial-range-first / partial-range-last

# File 'lib/net/imap/response_parser.rb', line 343
```
Regexp.union(PARTIAL_RANGE_FIRST,
PARTIAL_RANGE_LAST)
```

PARTIAL_RANGE_FIRST = Internal use only

partial-range-first = nz-number “:” nz-number

;; Request to search from oldest (lowest UIDs) to
;; more recent messages.
;; A range 500:400 is the same as 400:500.
;; This is similar to <seq-range> from [RFC3501]
;; but cannot contain "*".

# File 'lib/net/imap/response_parser.rb', line 334

/\A(#{NZ_NUMBER}):(#{NZ_NUMBER})\z/n

PARTIAL_RANGE_LAST = Internal use only

partial-range-last = MINUS nz-number “:” MINUS nz-number

;; Request to search from newest (highest UIDs) to
;; oldest messages.
;; A range -500:-400 is the same as -400:-500.

# File 'lib/net/imap/response_parser.rb', line 340

/\A(-#{NZ_NUMBER}):(-#{NZ_NUMBER})\z/n

QUIRKY_FLAG = Internal use only

Gmail allows SP and “]” in flags.……

# File 'lib/net/imap/response_parser.rb', line 242
```
Regexp.union(/\\?#{ASTRING_CHARS}/n, "\\*")
```
QUIRKY_FLAGS_LIST = Internal use only
# File 'lib/net/imap/response_parser.rb', line 243
```
/\G$(   [^)]*   )$/nx
```
QUOTED_CHAR_esc = Internal use only
# File 'lib/net/imap/response_parser.rb', line 254
```
/\\#{QUOTED_SPECIALS}/n
```
QUOTED_CHAR_rev1 = Internal use only
# File 'lib/net/imap/response_parser.rb', line 255
```
Regexp.union(QUOTED_CHAR_safe, QUOTED_CHAR_esc)
```
QUOTED_CHAR_rev2 = Internal use only
# File 'lib/net/imap/response_parser.rb', line 256
```
Regexp.union(QUOTED_CHAR_rev1,
UTF8_2, UTF8_3, UTF8_4)
```

QUOTED_CHAR_safe = Internal use only

RFC3501:

QUOTED-CHAR   = <any TEXT-CHAR except quoted-specials> /
                "\" quoted-specials

RFC9051:

QUOTED-CHAR   = <any TEXT-CHAR except quoted-specials> /
                "\" quoted-specials / UTF8-2 / UTF8-3 / UTF8-4

RFC3501 & RFC9051:

quoted          = DQUOTE *QUOTED-CHAR DQUOTE

# File 'lib/net/imap/response_parser.rb', line 253

TEXT_CHAR - QUOTED_SPECIALS

QUOTED_SPECIALS = Internal use only

quoted-specials = DQUOTE / “"

# File 'lib/net/imap/response_parser.rb', line 163
```
/["\\]/n
```
QUOTED_rev1 = Internal use only
# File 'lib/net/imap/response_parser.rb', line 258
```
/"(#{QUOTED_CHAR_rev1}*)"/n
```
QUOTED_rev2 = Internal use only
# File 'lib/net/imap/response_parser.rb', line 259
```
/"(#{QUOTED_CHAR_rev2}*)"/n
```
RESP_SPECIALS = Internal use only

resp-specials = “]”

# File 'lib/net/imap/response_parser.rb', line 165
```
/[\]]/n
```
SEQUENCE_SET = Internal use only
# File 'lib/net/imap/response_parser.rb', line 325
```
/#{SEQUENCE_SET_ITEM}(?:,#{SEQUENCE_SET_ITEM})*/n
```

SEQUENCE_SET_ITEM = Internal use only

sequence-set = (seq-number / seq-range) [“,” sequence-set]

; set of seq-number values, regardless of order.
; Servers MAY coalesce overlaps and/or execute
; the sequence in any order.
; Example: a message sequence number set of
; 2,4:7,9,12:* for a mailbox with 15 messages is
; equivalent to 2,4,5,6,7,9,12,13,14,15
; Example: a message sequence number set of
; *:4,5:7 for a mailbox with 10 messages is
; equivalent to 10,9,8,7,6,5,4,5,6,7 and MAY
; be reordered and overlap coalesced to be
; 4,5,6,7,8,9,10.

# File 'lib/net/imap/response_parser.rb', line 324

/#{SEQ_NUMBER}|#{SEQ_RANGE}/n

SEQUENCE_SET_STR = Internal use only
# File 'lib/net/imap/response_parser.rb', line 326
```
/\A#{SEQUENCE_SET}\z/n
```

SEQ_NUMBER = Internal use only

seq-number = nz-number / “*”

; message sequence number (COPY, FETCH, STORE
; commands) or unique identifier (UID COPY,
; UID FETCH, UID STORE commands).
; * represents the largest number in use.  In
; the case of message sequence numbers, it is
; the number of messages in a non-empty mailbox.
; In the case of unique identifiers, it is the
; unique identifier of the last message in the
; mailbox or, if the mailbox is empty, the
; mailbox's current UIDNEXT value.
; The server should respond with a tagged BAD
; response to a command that uses a message
; sequence number greater than the number of
; messages in the selected mailbox.  This
; includes "*" if the selected mailbox is empty.

# File 'lib/net/imap/response_parser.rb', line 299

/#{NZ_NUMBER}|\*/n

SEQ_RANGE = Internal use only

seq-range = seq-number “:” seq-number

; two seq-number values and all values between
; these two regardless of order.
; Example: 2:4 and 4:2 are equivalent and
; indicate values 2, 3, and 4.
; Example: a unique identifier sequence range of
; 3291:* includes the UID of the last message in
; the mailbox, even if that value is less than
; 3291.

# File 'lib/net/imap/response_parser.rb', line 310

/#{SEQ_NUMBER}:#{SEQ_NUMBER}/n

TAG = Internal use only
# File 'lib/net/imap/response_parser.rb', line 187
```
/#{ASTRING_CHAR - /[+]/  }+/
```
TAGGED_EXT_LABEL = Internal use only
tagged-ext-label = tagged-label-fchar *tagged-label-char
```
; Is a valid RFC 3501 "atom".
```
# File 'lib/net/imap/response_parser.rb', line 276
```
/#{TAGGED_LABEL_FCHAR}#{TAGGED_LABEL_CHAR}*/n
```
TAGGED_LABEL_CHAR = Internal use only

tagged-label-char = tagged-label-fchar / DIGIT / “:”

# File 'lib/net/imap/response_parser.rb', line 273
```
/[a-zA-Z\-_.0-9:]*/n
```
TAGGED_LABEL_FCHAR = Internal use only

tagged-label-fchar = ALPHA / “-” / “_” / “.”

# File 'lib/net/imap/response_parser.rb', line 271
```
/[a-zA-Z\-_.]/n
```
TEXT_CHAR = Internal use only

TEXT-CHAR = <any CHAR except CR and LF>

# File 'lib/net/imap/response_parser.rb', line 190
```
CHAR - /[\r\n]/
```

TEXT_rev1 = Internal use only

RFC3501:

text          = 1*TEXT-CHAR

RFC9051:

text          = 1*(TEXT-CHAR / UTF8-2 / UTF8-3 / UTF8-4)
                  ; Non-ASCII text can only be returned
                  ; after ENABLE IMAP4rev2 command

# File 'lib/net/imap/response_parser.rb', line 267

/#{TEXT_CHAR}+/

TEXT_rev2 = Internal use only
# File 'lib/net/imap/response_parser.rb', line 268
```
/#{Regexp.union TEXT_CHAR, UTF8_2, UTF8_3, UTF8_4}+/
```

`RFC5234` - Included

ALPHA, CHAR, CRLF, CTL, DIGIT, DQUOTE, HEXDIG, OCTET, SP

`RFC3629` - Included

UTF8_1, UTF8_2, UTF8_3, UTF8_4, UTF8_CHAR, UTF8_OCTETS, UTF8_TAIL

Class Method Summary

.unescape_quoted(quoted) mod_func Internal use only
.unescape_quoted!(quoted) mod_func Internal use only

Class Method Details

.unescape_quoted(quoted) (mod_func)

This method is for internal use only.

[ GitHub ]

# File 'lib/net/imap/response_parser.rb', line 377


def unescape_quoted(quoted)
  quoted
    &.gsub(/\\(#{QUOTED_SPECIALS})/n, "\\1")
    &.force_encoding("UTF-8")
end

.unescape_quoted!(quoted) (mod_func)

This method is for internal use only.

[ GitHub ]

# File 'lib/net/imap/response_parser.rb', line 371


def unescape_quoted!(quoted)
  quoted
    &.gsub!(/\\(#{QUOTED_SPECIALS})/n, "\\1")
    &.force_encoding("UTF-8")
end

Module: Net::IMAP::ResponseParser::Patterns

Constant Summary

RFC5234 - Included

RFC3629 - Included

Class Method Summary

Class Method Details

.unescape_quoted(quoted) (mod_func)

.unescape_quoted!(quoted) (mod_func)

`RFC5234` - Included

`RFC3629` - Included