mail 2.6.4 → 2.8.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/README.md +111 -118
- data/lib/mail/attachments_list.rb +11 -10
- data/lib/mail/body.rb +73 -84
- data/lib/mail/check_delivery_params.rb +54 -10
- data/lib/mail/configuration.rb +2 -0
- data/lib/mail/constants.rb +27 -5
- data/lib/mail/elements/address.rb +61 -50
- data/lib/mail/elements/address_list.rb +11 -19
- data/lib/mail/elements/content_disposition_element.rb +9 -16
- data/lib/mail/elements/content_location_element.rb +6 -11
- data/lib/mail/elements/content_transfer_encoding_element.rb +6 -11
- data/lib/mail/elements/content_type_element.rb +16 -23
- data/lib/mail/elements/date_time_element.rb +7 -15
- data/lib/mail/elements/envelope_from_element.rb +22 -23
- data/lib/mail/elements/message_ids_element.rb +18 -13
- data/lib/mail/elements/mime_version_element.rb +7 -15
- data/lib/mail/elements/phrase_list.rb +12 -10
- data/lib/mail/elements/received_element.rb +27 -19
- data/lib/mail/encodings/7bit.rb +9 -14
- data/lib/mail/encodings/8bit.rb +2 -21
- data/lib/mail/encodings/base64.rb +11 -12
- data/lib/mail/encodings/binary.rb +3 -22
- data/lib/mail/encodings/identity.rb +24 -0
- data/lib/mail/encodings/quoted_printable.rb +6 -6
- data/lib/mail/encodings/transfer_encoding.rb +38 -29
- data/lib/mail/encodings/unix_to_unix.rb +3 -1
- data/lib/mail/encodings.rb +81 -54
- data/lib/mail/envelope.rb +11 -14
- data/lib/mail/field.rb +119 -98
- data/lib/mail/field_list.rb +60 -7
- data/lib/mail/fields/bcc_field.rb +34 -52
- data/lib/mail/fields/cc_field.rb +28 -49
- data/lib/mail/fields/comments_field.rb +27 -37
- data/lib/mail/fields/common_address_field.rb +170 -0
- data/lib/mail/fields/common_date_field.rb +58 -0
- data/lib/mail/fields/common_field.rb +77 -0
- data/lib/mail/fields/common_message_id_field.rb +42 -0
- data/lib/mail/fields/content_description_field.rb +7 -14
- data/lib/mail/fields/content_disposition_field.rb +13 -38
- data/lib/mail/fields/content_id_field.rb +24 -51
- data/lib/mail/fields/content_location_field.rb +11 -25
- data/lib/mail/fields/content_transfer_encoding_field.rb +31 -31
- data/lib/mail/fields/content_type_field.rb +50 -80
- data/lib/mail/fields/date_field.rb +23 -52
- data/lib/mail/fields/from_field.rb +28 -49
- data/lib/mail/fields/in_reply_to_field.rb +38 -49
- data/lib/mail/fields/keywords_field.rb +18 -31
- data/lib/mail/fields/message_id_field.rb +25 -71
- data/lib/mail/fields/mime_version_field.rb +19 -30
- data/lib/mail/fields/named_structured_field.rb +11 -0
- data/lib/mail/fields/named_unstructured_field.rb +11 -0
- data/lib/mail/fields/optional_field.rb +9 -7
- data/lib/mail/fields/{common/parameter_hash.rb → parameter_hash.rb} +13 -11
- data/lib/mail/fields/received_field.rb +43 -57
- data/lib/mail/fields/references_field.rb +35 -49
- data/lib/mail/fields/reply_to_field.rb +28 -49
- data/lib/mail/fields/resent_bcc_field.rb +28 -49
- data/lib/mail/fields/resent_cc_field.rb +28 -49
- data/lib/mail/fields/resent_date_field.rb +5 -30
- data/lib/mail/fields/resent_from_field.rb +28 -49
- data/lib/mail/fields/resent_message_id_field.rb +5 -29
- data/lib/mail/fields/resent_sender_field.rb +27 -56
- data/lib/mail/fields/resent_to_field.rb +28 -49
- data/lib/mail/fields/return_path_field.rb +50 -54
- data/lib/mail/fields/sender_field.rb +34 -55
- data/lib/mail/fields/structured_field.rb +3 -30
- data/lib/mail/fields/subject_field.rb +9 -11
- data/lib/mail/fields/to_field.rb +28 -49
- data/lib/mail/fields/unstructured_field.rb +32 -47
- data/lib/mail/header.rb +71 -110
- data/lib/mail/mail.rb +2 -10
- data/lib/mail/matchers/attachment_matchers.rb +15 -0
- data/lib/mail/matchers/has_sent_mail.rb +21 -1
- data/lib/mail/message.rb +113 -117
- data/lib/mail/multibyte/chars.rb +23 -180
- data/lib/mail/multibyte/unicode.rb +10 -10
- data/lib/mail/multibyte/utils.rb +26 -43
- data/lib/mail/multibyte.rb +55 -16
- data/lib/mail/network/delivery_methods/exim.rb +8 -11
- data/lib/mail/network/delivery_methods/file_delivery.rb +13 -16
- data/lib/mail/network/delivery_methods/logger_delivery.rb +34 -0
- data/lib/mail/network/delivery_methods/sendmail.rb +32 -35
- data/lib/mail/network/delivery_methods/smtp.rb +76 -54
- data/lib/mail/network/delivery_methods/smtp_connection.rb +4 -9
- data/lib/mail/network/delivery_methods/test_mailer.rb +8 -9
- data/lib/mail/network/retriever_methods/base.rb +8 -8
- data/lib/mail/network/retriever_methods/imap.rb +20 -7
- data/lib/mail/network/retriever_methods/pop3.rb +5 -3
- data/lib/mail/network/retriever_methods/test_retriever.rb +3 -2
- data/lib/mail/network.rb +1 -0
- data/lib/mail/parser_tools.rb +15 -0
- data/lib/mail/parsers/address_lists_parser.rb +33225 -116
- data/lib/mail/parsers/address_lists_parser.rl +179 -0
- data/lib/mail/parsers/content_disposition_parser.rb +882 -49
- data/lib/mail/parsers/content_disposition_parser.rl +89 -0
- data/lib/mail/parsers/content_location_parser.rb +809 -23
- data/lib/mail/parsers/content_location_parser.rl +78 -0
- data/lib/mail/parsers/content_transfer_encoding_parser.rb +509 -21
- data/lib/mail/parsers/content_transfer_encoding_parser.rl +71 -0
- data/lib/mail/parsers/content_type_parser.rb +1037 -56
- data/lib/mail/parsers/content_type_parser.rl +90 -0
- data/lib/mail/parsers/date_time_parser.rb +877 -25
- data/lib/mail/parsers/date_time_parser.rl +69 -0
- data/lib/mail/parsers/envelope_from_parser.rb +3669 -40
- data/lib/mail/parsers/envelope_from_parser.rl +89 -0
- data/lib/mail/parsers/message_ids_parser.rb +5146 -25
- data/lib/mail/parsers/message_ids_parser.rl +93 -0
- data/lib/mail/parsers/mime_version_parser.rb +497 -26
- data/lib/mail/parsers/mime_version_parser.rl +68 -0
- data/lib/mail/parsers/phrase_lists_parser.rb +870 -22
- data/lib/mail/parsers/phrase_lists_parser.rl +90 -0
- data/lib/mail/parsers/received_parser.rb +8776 -43
- data/lib/mail/parsers/received_parser.rl +91 -0
- data/lib/mail/parsers/rfc2045_content_transfer_encoding.rl +13 -0
- data/lib/mail/parsers/rfc2045_content_type.rl +25 -0
- data/lib/mail/parsers/rfc2045_mime.rl +16 -0
- data/lib/mail/parsers/rfc2183_content_disposition.rl +15 -0
- data/lib/mail/parsers/rfc3629_utf8.rl +19 -0
- data/lib/mail/parsers/rfc5234_abnf_core_rules.rl +22 -0
- data/lib/mail/parsers/rfc5322.rl +74 -0
- data/lib/mail/parsers/rfc5322_address.rl +72 -0
- data/lib/mail/parsers/{ragel/date_time.rl → rfc5322_date_time.rl} +8 -1
- data/lib/mail/parsers/rfc5322_lexical_tokens.rl +60 -0
- data/lib/mail/parsers.rb +11 -25
- data/lib/mail/part.rb +6 -10
- data/lib/mail/parts_list.rb +62 -6
- data/lib/mail/smtp_envelope.rb +57 -0
- data/lib/mail/utilities.rb +357 -74
- data/lib/mail/version.rb +2 -2
- data/lib/mail/yaml.rb +30 -0
- data/lib/mail.rb +5 -35
- metadata +111 -66
- data/CHANGELOG.rdoc +0 -787
- data/CONTRIBUTING.md +0 -60
- data/Dependencies.txt +0 -2
- data/Gemfile +0 -11
- data/Rakefile +0 -29
- data/TODO.rdoc +0 -9
- data/lib/mail/core_extensions/smtp.rb +0 -25
- data/lib/mail/core_extensions/string/access.rb +0 -146
- data/lib/mail/core_extensions/string/multibyte.rb +0 -79
- data/lib/mail/core_extensions/string.rb +0 -21
- data/lib/mail/fields/common/address_container.rb +0 -17
- data/lib/mail/fields/common/common_address.rb +0 -136
- data/lib/mail/fields/common/common_date.rb +0 -36
- data/lib/mail/fields/common/common_field.rb +0 -61
- data/lib/mail/fields/common/common_message_id.rb +0 -49
- data/lib/mail/multibyte/exceptions.rb +0 -9
- data/lib/mail/parsers/ragel/common.rl +0 -185
- data/lib/mail/parsers/ragel/parser_info.rb +0 -61
- data/lib/mail/parsers/ragel/ruby/machines/address_lists_machine.rb +0 -14864
- data/lib/mail/parsers/ragel/ruby/machines/address_lists_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/content_disposition_machine.rb +0 -751
- data/lib/mail/parsers/ragel/ruby/machines/content_disposition_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/content_location_machine.rb +0 -614
- data/lib/mail/parsers/ragel/ruby/machines/content_location_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/content_transfer_encoding_machine.rb +0 -447
- data/lib/mail/parsers/ragel/ruby/machines/content_transfer_encoding_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/content_type_machine.rb +0 -825
- data/lib/mail/parsers/ragel/ruby/machines/content_type_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/date_time_machine.rb +0 -817
- data/lib/mail/parsers/ragel/ruby/machines/date_time_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/envelope_from_machine.rb +0 -2149
- data/lib/mail/parsers/ragel/ruby/machines/envelope_from_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/message_ids_machine.rb +0 -1570
- data/lib/mail/parsers/ragel/ruby/machines/message_ids_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/mime_version_machine.rb +0 -440
- data/lib/mail/parsers/ragel/ruby/machines/mime_version_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/phrase_lists_machine.rb +0 -564
- data/lib/mail/parsers/ragel/ruby/machines/phrase_lists_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/machines/rb_actions.rl +0 -51
- data/lib/mail/parsers/ragel/ruby/machines/received_machine.rb +0 -5144
- data/lib/mail/parsers/ragel/ruby/machines/received_machine.rb.rl +0 -37
- data/lib/mail/parsers/ragel/ruby/parser.rb.rl.erb +0 -37
- data/lib/mail/parsers/ragel/ruby.rb +0 -40
- data/lib/mail/parsers/ragel.rb +0 -18
- data/lib/mail/version_specific/ruby_1_8.rb +0 -126
- data/lib/mail/version_specific/ruby_1_9.rb +0 -223
@@ -1,53 +1,55 @@
|
|
1
1
|
# encoding: utf-8
|
2
2
|
# frozen_string_literal: true
|
3
|
-
require 'mail/fields/
|
3
|
+
require 'mail/fields/named_structured_field'
|
4
|
+
require 'mail/fields/parameter_hash'
|
4
5
|
|
5
6
|
module Mail
|
6
|
-
class ContentTypeField <
|
7
|
+
class ContentTypeField < NamedStructuredField #:nodoc:
|
8
|
+
NAME = 'Content-Type'
|
7
9
|
|
8
|
-
|
9
|
-
|
10
|
+
class << self
|
11
|
+
def singular?
|
12
|
+
true
|
13
|
+
end
|
14
|
+
|
15
|
+
def with_boundary(type)
|
16
|
+
new "#{type}; boundary=#{generate_boundary}"
|
17
|
+
end
|
18
|
+
|
19
|
+
def generate_boundary
|
20
|
+
"--==_mimepart_#{Mail.random_tag}"
|
21
|
+
end
|
22
|
+
end
|
10
23
|
|
11
|
-
def initialize(value = nil, charset =
|
12
|
-
|
13
|
-
if value.class == Array
|
24
|
+
def initialize(value = nil, charset = nil)
|
25
|
+
if value.is_a? Array
|
14
26
|
@main_type = value[0]
|
15
27
|
@sub_type = value[1]
|
16
28
|
@parameters = ParameterHash.new.merge!(value.last)
|
17
29
|
else
|
18
30
|
@main_type = nil
|
19
31
|
@sub_type = nil
|
20
|
-
|
21
|
-
value = strip_field(FIELD_NAME, value)
|
32
|
+
value = value.to_s
|
22
33
|
end
|
23
|
-
value = ensure_filename_quoted(value)
|
24
|
-
super(CAPITALIZED_FIELD, value, charset)
|
25
|
-
self.parse
|
26
|
-
self
|
27
|
-
end
|
28
34
|
|
29
|
-
|
30
|
-
unless Utilities.blank?(val)
|
31
|
-
self.value = val
|
32
|
-
@element = nil
|
33
|
-
element
|
34
|
-
end
|
35
|
+
super ensure_filename_quoted(value), charset
|
35
36
|
end
|
36
37
|
|
37
38
|
def element
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
39
|
+
@element ||=
|
40
|
+
begin
|
41
|
+
Mail::ContentTypeElement.new(value)
|
42
|
+
rescue Mail::Field::ParseError
|
43
|
+
attempt_to_clean
|
44
|
+
end
|
43
45
|
end
|
44
46
|
|
45
47
|
def attempt_to_clean
|
46
48
|
# Sanitize the value, handle special cases
|
47
|
-
|
48
|
-
rescue
|
49
|
+
Mail::ContentTypeElement.new(sanitize(value))
|
50
|
+
rescue Mail::Field::ParseError
|
49
51
|
# All else fails, just get the MIME media type
|
50
|
-
|
52
|
+
Mail::ContentTypeElement.new(get_mime_type(value))
|
51
53
|
end
|
52
54
|
|
53
55
|
def main_type
|
@@ -61,31 +63,22 @@ module Mail
|
|
61
63
|
def string
|
62
64
|
"#{main_type}/#{sub_type}"
|
63
65
|
end
|
66
|
+
alias_method :content_type, :string
|
64
67
|
|
65
68
|
def default
|
66
69
|
decoded
|
67
70
|
end
|
68
71
|
|
69
|
-
alias :content_type :string
|
70
|
-
|
71
72
|
def parameters
|
72
|
-
unless @parameters
|
73
|
+
unless defined? @parameters
|
73
74
|
@parameters = ParameterHash.new
|
74
75
|
element.parameters.each { |p| @parameters.merge!(p) }
|
75
76
|
end
|
76
77
|
@parameters
|
77
78
|
end
|
78
79
|
|
79
|
-
def ContentTypeField.with_boundary(type)
|
80
|
-
new("#{type}; boundary=#{generate_boundary}")
|
81
|
-
end
|
82
|
-
|
83
|
-
def ContentTypeField.generate_boundary
|
84
|
-
"--==_mimepart_#{Mail.random_tag}"
|
85
|
-
end
|
86
|
-
|
87
80
|
def value
|
88
|
-
if @value.
|
81
|
+
if @value.is_a? Array
|
89
82
|
"#{@main_type}/#{@sub_type}; #{stringify(parameters)}"
|
90
83
|
else
|
91
84
|
@value
|
@@ -97,34 +90,17 @@ module Mail
|
|
97
90
|
end
|
98
91
|
|
99
92
|
def filename
|
100
|
-
|
101
|
-
when parameters['filename']
|
102
|
-
@filename = parameters['filename']
|
103
|
-
when parameters['name']
|
104
|
-
@filename = parameters['name']
|
105
|
-
else
|
106
|
-
@filename = nil
|
107
|
-
end
|
108
|
-
@filename
|
93
|
+
@filename ||= parameters['filename'] || parameters['name']
|
109
94
|
end
|
110
95
|
|
111
|
-
# TODO: Fix this up
|
112
96
|
def encoded
|
113
|
-
if parameters.length > 0
|
114
|
-
|
115
|
-
else
|
116
|
-
p = ""
|
117
|
-
end
|
118
|
-
"#{CAPITALIZED_FIELD}: #{content_type}#{p}\r\n"
|
97
|
+
p = ";\r\n\s#{parameters.encoded}" if parameters && parameters.length > 0
|
98
|
+
"#{name}: #{content_type}#{p}\r\n"
|
119
99
|
end
|
120
100
|
|
121
101
|
def decoded
|
122
|
-
if parameters.length > 0
|
123
|
-
|
124
|
-
else
|
125
|
-
p = ""
|
126
|
-
end
|
127
|
-
"#{content_type}" + p
|
102
|
+
p = "; #{parameters.decoded}" if parameters && parameters.length > 0
|
103
|
+
"#{content_type}#{p}"
|
128
104
|
end
|
129
105
|
|
130
106
|
private
|
@@ -140,30 +116,24 @@ module Mail
|
|
140
116
|
|
141
117
|
# Various special cases from random emails found that I am not going to change
|
142
118
|
# the parser for
|
143
|
-
def
|
144
|
-
|
119
|
+
def sanitize(val)
|
145
120
|
# TODO: check if there are cases where whitespace is not a separator
|
146
121
|
val = val.
|
147
122
|
gsub(/\s*=\s*/,'='). # remove whitespaces around equal sign
|
148
|
-
|
149
|
-
squeeze(';').
|
150
|
-
gsub(';', '; '). #use '; ' as a separator (or EOL)
|
123
|
+
gsub(/[; ]+/, '; '). #use '; ' as a separator (or EOL)
|
151
124
|
gsub(/;\s*$/,'') #remove trailing to keep examples below
|
152
125
|
|
153
|
-
if val =~ /(boundary=(\S*))/i
|
154
|
-
val = "#{$`.downcase}
|
126
|
+
if val =~ /((boundary|name|filename)=(\S*))/i
|
127
|
+
val = "#{$`.downcase}#{$2}=#{$3}#{$'.downcase}"
|
155
128
|
else
|
156
129
|
val.downcase!
|
157
130
|
end
|
158
131
|
|
159
132
|
case
|
160
|
-
when val.chomp =~ /^\s*([\w\-]+)\/([\w\-]+)\s*;;+(.*)$/i
|
161
|
-
# Handles 'text/plain;; format="flowed"' (double semi colon)
|
162
|
-
"#{$1}/#{$2}; #{$3}"
|
163
133
|
when val.chomp =~ /^\s*([\w\-]+)\/([\w\-]+)\s*;\s?(ISO[\w\-]+)$/i
|
164
134
|
# Microsoft helper:
|
165
135
|
# Handles 'type/subtype;ISO-8559-1'
|
166
|
-
"#{$1}/#{$2}; charset=#{quote_atom($3)}"
|
136
|
+
"#{$1}/#{$2}; charset=#{Utilities.quote_atom($3)}"
|
167
137
|
when val.chomp =~ /^text;?$/i
|
168
138
|
# Handles 'text;' and 'text'
|
169
139
|
"text/plain;"
|
@@ -172,7 +142,7 @@ module Mail
|
|
172
142
|
"text/plain; #{$2}"
|
173
143
|
when val =~ /([\w\-]+\/[\w\-]+);\scharset="charset="(\w+)""/i
|
174
144
|
# Handles text/html; charset="charset="GB2312""
|
175
|
-
"#{$1}; charset=#{quote_atom($2)}"
|
145
|
+
"#{$1}; charset=#{Utilities.quote_atom($2)}"
|
176
146
|
when val =~ /([\w\-]+\/[\w\-]+);\s+(.*)/i
|
177
147
|
type = $1
|
178
148
|
# Handles misquoted param values
|
@@ -180,19 +150,19 @@ module Mail
|
|
180
150
|
# and: audio/x-midi;\r\n\sname=Part .exe
|
181
151
|
params = $2.to_s.split(/\s+/)
|
182
152
|
params = params.map { |i| i.to_s.chomp.strip }
|
183
|
-
params = params.map { |i| i.split(/\s*\=\s
|
184
|
-
params = params.map { |i| "#{i[0]}=#{dquote(i[1].to_s.gsub(/;$/,""))}" }.join('; ')
|
153
|
+
params = params.map { |i| i.split(/\s*\=\s*/, 2) }
|
154
|
+
params = params.map { |i| "#{i[0]}=#{Utilities.dquote(i[1].to_s.gsub(/;$/,""))}" }.join('; ')
|
185
155
|
"#{type}; #{params}"
|
186
156
|
when val =~ /^\s*$/
|
187
157
|
'text/plain'
|
188
158
|
else
|
189
|
-
|
159
|
+
val
|
190
160
|
end
|
191
161
|
end
|
192
162
|
|
193
|
-
def get_mime_type(
|
194
|
-
case
|
195
|
-
when
|
163
|
+
def get_mime_type(val)
|
164
|
+
case val
|
165
|
+
when /^([\w\-]+)\/([\w\-]+);.+$/i
|
196
166
|
"#{$1}/#{$2}"
|
197
167
|
else
|
198
168
|
'text/plain'
|
@@ -1,58 +1,29 @@
|
|
1
1
|
# encoding: utf-8
|
2
2
|
# frozen_string_literal: true
|
3
|
-
|
4
|
-
# = Date Field
|
5
|
-
#
|
6
|
-
# The Date field inherits from StructuredField and handles the Date: header
|
7
|
-
# field in the email.
|
8
|
-
#
|
9
|
-
# Sending date to a mail message will instantiate a Mail::Field object that
|
10
|
-
# has a DateField as its field type. This includes all Mail::CommonAddress
|
11
|
-
# module instance methods.
|
12
|
-
#
|
13
|
-
# There must be excatly one Date field in an RFC2822 email.
|
14
|
-
#
|
15
|
-
# == Examples:
|
16
|
-
#
|
17
|
-
# mail = Mail.new
|
18
|
-
# mail.date = 'Mon, 24 Nov 1997 14:22:01 -0800'
|
19
|
-
# mail.date #=> #<DateTime: 211747170121/86400,-1/3,2299161>
|
20
|
-
# mail.date.to_s #=> 'Mon, 24 Nov 1997 14:22:01 -0800'
|
21
|
-
# mail[:date] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
|
22
|
-
# mail['date'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
|
23
|
-
# mail['Date'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
|
24
|
-
#
|
25
|
-
require 'mail/fields/common/common_date'
|
3
|
+
require 'mail/fields/common_date_field'
|
26
4
|
|
27
5
|
module Mail
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
do_encode(CAPITALIZED_FIELD)
|
51
|
-
end
|
52
|
-
|
53
|
-
def decoded
|
54
|
-
do_decode
|
55
|
-
end
|
56
|
-
|
6
|
+
# = Date Field
|
7
|
+
#
|
8
|
+
# The Date field inherits from StructuredField and handles the Date: header
|
9
|
+
# field in the email.
|
10
|
+
#
|
11
|
+
# Sending date to a mail message will instantiate a Mail::Field object that
|
12
|
+
# has a DateField as its field type. This includes all Mail::CommonAddress
|
13
|
+
# module instance methods.
|
14
|
+
#
|
15
|
+
# There must be excatly one Date field in an RFC2822 email.
|
16
|
+
#
|
17
|
+
# == Examples:
|
18
|
+
#
|
19
|
+
# mail = Mail.new
|
20
|
+
# mail.date = 'Mon, 24 Nov 1997 14:22:01 -0800'
|
21
|
+
# mail.date #=> #<DateTime: 211747170121/86400,-1/3,2299161>
|
22
|
+
# mail.date.to_s #=> 'Mon, 24 Nov 1997 14:22:01 -0800'
|
23
|
+
# mail[:date] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
|
24
|
+
# mail['date'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
|
25
|
+
# mail['Date'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
|
26
|
+
class DateField < CommonDateField #:nodoc:
|
27
|
+
NAME = 'Date'
|
57
28
|
end
|
58
29
|
end
|
@@ -1,55 +1,34 @@
|
|
1
1
|
# encoding: utf-8
|
2
2
|
# frozen_string_literal: true
|
3
|
-
|
4
|
-
# = From Field
|
5
|
-
#
|
6
|
-
# The From field inherits from StructuredField and handles the From: header
|
7
|
-
# field in the email.
|
8
|
-
#
|
9
|
-
# Sending from to a mail message will instantiate a Mail::Field object that
|
10
|
-
# has a FromField as its field type. This includes all Mail::CommonAddress
|
11
|
-
# module instance metods.
|
12
|
-
#
|
13
|
-
# Only one From field can appear in a header, though it can have multiple
|
14
|
-
# addresses and groups of addresses.
|
15
|
-
#
|
16
|
-
# == Examples:
|
17
|
-
#
|
18
|
-
# mail = Mail.new
|
19
|
-
# mail.from = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
|
20
|
-
# mail.from #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
|
21
|
-
# mail[:from] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
|
22
|
-
# mail['from'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
|
23
|
-
# mail['From'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
|
24
|
-
#
|
25
|
-
# mail[:from].encoded #=> 'from: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
|
26
|
-
# mail[:from].decoded #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
|
27
|
-
# mail[:from].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
|
28
|
-
# mail[:from].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
|
29
|
-
#
|
30
|
-
require 'mail/fields/common/common_address'
|
3
|
+
require 'mail/fields/common_address_field'
|
31
4
|
|
32
5
|
module Mail
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
6
|
+
# = From Field
|
7
|
+
#
|
8
|
+
# The From field inherits from StructuredField and handles the From: header
|
9
|
+
# field in the email.
|
10
|
+
#
|
11
|
+
# Sending from to a mail message will instantiate a Mail::Field object that
|
12
|
+
# has a FromField as its field type. This includes all Mail::CommonAddress
|
13
|
+
# module instance metods.
|
14
|
+
#
|
15
|
+
# Only one From field can appear in a header, though it can have multiple
|
16
|
+
# addresses and groups of addresses.
|
17
|
+
#
|
18
|
+
# == Examples:
|
19
|
+
#
|
20
|
+
# mail = Mail.new
|
21
|
+
# mail.from = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
|
22
|
+
# mail.from #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
|
23
|
+
# mail[:from] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
|
24
|
+
# mail['from'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
|
25
|
+
# mail['From'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
|
26
|
+
#
|
27
|
+
# mail[:from].encoded #=> 'from: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
|
28
|
+
# mail[:from].decoded #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
|
29
|
+
# mail[:from].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
|
30
|
+
# mail[:from].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
|
31
|
+
class FromField < CommonAddressField #:nodoc:
|
32
|
+
NAME = 'From'
|
54
33
|
end
|
55
34
|
end
|
@@ -1,57 +1,46 @@
|
|
1
1
|
# encoding: utf-8
|
2
2
|
# frozen_string_literal: true
|
3
|
-
|
4
|
-
# = In-Reply-To Field
|
5
|
-
#
|
6
|
-
# The In-Reply-To field inherits from StructuredField and handles the
|
7
|
-
# In-Reply-To: header field in the email.
|
8
|
-
#
|
9
|
-
# Sending in_reply_to to a mail message will instantiate a Mail::Field object that
|
10
|
-
# has a InReplyToField as its field type. This includes all Mail::CommonMessageId
|
11
|
-
# module instance metods.
|
12
|
-
#
|
13
|
-
# Note that, the #message_ids method will return an array of message IDs without the
|
14
|
-
# enclosing angle brackets which per RFC are not syntactically part of the message id.
|
15
|
-
#
|
16
|
-
# Only one InReplyTo field can appear in a header, though it can have multiple
|
17
|
-
# Message IDs.
|
18
|
-
#
|
19
|
-
# == Examples:
|
20
|
-
#
|
21
|
-
# mail = Mail.new
|
22
|
-
# mail.in_reply_to = '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
23
|
-
# mail.in_reply_to #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
24
|
-
# mail[:in_reply_to] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
|
25
|
-
# mail['in_reply_to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
|
26
|
-
# mail['In-Reply-To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
|
27
|
-
#
|
28
|
-
# mail[:in_reply_to].message_ids #=> ['F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom']
|
29
|
-
#
|
30
|
-
require 'mail/fields/common/common_message_id'
|
3
|
+
require 'mail/fields/common_message_id_field'
|
31
4
|
|
32
5
|
module Mail
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
6
|
+
# = In-Reply-To Field
|
7
|
+
#
|
8
|
+
# The In-Reply-To field inherits from StructuredField and handles the
|
9
|
+
# In-Reply-To: header field in the email.
|
10
|
+
#
|
11
|
+
# Sending in_reply_to to a mail message will instantiate a Mail::Field object that
|
12
|
+
# has a InReplyToField as its field type. This includes all Mail::CommonMessageId
|
13
|
+
# module instance metods.
|
14
|
+
#
|
15
|
+
# Note that, the #message_ids method will return an array of message IDs without the
|
16
|
+
# enclosing angle brackets which per RFC are not syntactically part of the message id.
|
17
|
+
#
|
18
|
+
# Only one InReplyTo field can appear in a header, though it can have multiple
|
19
|
+
# Message IDs.
|
20
|
+
#
|
21
|
+
# == Examples:
|
22
|
+
#
|
23
|
+
# mail = Mail.new
|
24
|
+
# mail.in_reply_to = '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
25
|
+
# mail.in_reply_to #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
26
|
+
# mail[:in_reply_to] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
|
27
|
+
# mail['in_reply_to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
|
28
|
+
# mail['In-Reply-To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
|
29
|
+
#
|
30
|
+
# mail[:in_reply_to].message_ids #=> ['F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom']
|
31
|
+
class InReplyToField < CommonMessageIdField #:nodoc:
|
32
|
+
NAME = 'In-Reply-To'
|
33
|
+
|
34
|
+
def self.singular?
|
35
|
+
true
|
50
36
|
end
|
51
|
-
|
52
|
-
def
|
53
|
-
|
37
|
+
|
38
|
+
def initialize(value = nil, charset = nil)
|
39
|
+
if value.is_a?(Array)
|
40
|
+
super value.join("\r\n\s"), charset
|
41
|
+
else
|
42
|
+
super
|
43
|
+
end
|
54
44
|
end
|
55
|
-
|
56
45
|
end
|
57
46
|
end
|
@@ -1,44 +1,31 @@
|
|
1
1
|
# encoding: utf-8
|
2
2
|
# frozen_string_literal: true
|
3
|
-
|
4
|
-
|
3
|
+
require 'mail/fields/named_structured_field'
|
4
|
+
|
5
5
|
module Mail
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
CAPITALIZED_FIELD = 'Keywords'
|
10
|
-
|
11
|
-
def initialize(value = nil, charset = 'utf-8')
|
12
|
-
self.charset = charset
|
13
|
-
super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, value), charset)
|
14
|
-
self
|
15
|
-
end
|
6
|
+
# keywords = "Keywords:" phrase *("," phrase) CRLF
|
7
|
+
class KeywordsField < NamedStructuredField #:nodoc:
|
8
|
+
NAME = 'Keywords'
|
16
9
|
|
17
|
-
def
|
18
|
-
|
19
|
-
@phrase_list ||= PhraseList.new(value)
|
20
|
-
end
|
10
|
+
def element
|
11
|
+
@element ||= PhraseList.new(value)
|
21
12
|
end
|
22
|
-
|
23
|
-
def phrase_list
|
24
|
-
@phrase_list ||= PhraseList.new(value)
|
25
|
-
end
|
26
|
-
|
13
|
+
|
27
14
|
def keywords
|
28
|
-
|
29
|
-
end
|
30
|
-
|
31
|
-
def encoded
|
32
|
-
"#{CAPITALIZED_FIELD}: #{keywords.join(",\r\n ")}\r\n"
|
33
|
-
end
|
34
|
-
|
35
|
-
def decoded
|
36
|
-
keywords.join(', ')
|
15
|
+
element.phrases
|
37
16
|
end
|
38
17
|
|
39
18
|
def default
|
40
19
|
keywords
|
41
20
|
end
|
42
|
-
|
21
|
+
|
22
|
+
private
|
23
|
+
def do_decode
|
24
|
+
keywords.join(', ')
|
25
|
+
end
|
26
|
+
|
27
|
+
def do_encode
|
28
|
+
"#{name}: #{keywords.join(",\r\n ")}\r\n"
|
29
|
+
end
|
43
30
|
end
|
44
31
|
end
|
@@ -1,83 +1,37 @@
|
|
1
1
|
# encoding: utf-8
|
2
2
|
# frozen_string_literal: true
|
3
|
-
|
4
|
-
|
5
|
-
#
|
6
|
-
# The Message-ID field inherits from StructuredField and handles the
|
7
|
-
# Message-ID: header field in the email.
|
8
|
-
#
|
9
|
-
# Sending message_id to a mail message will instantiate a Mail::Field object that
|
10
|
-
# has a MessageIdField as its field type. This includes all Mail::CommonMessageId
|
11
|
-
# module instance metods.
|
12
|
-
#
|
13
|
-
# Only one MessageId field can appear in a header, and syntactically it can only have
|
14
|
-
# one Message ID. The message_ids method call has been left in however as it will only
|
15
|
-
# return the one message id, ie, an array of length 1.
|
16
|
-
#
|
17
|
-
# Note that, the #message_ids method will return an array of message IDs without the
|
18
|
-
# enclosing angle brackets which per RFC are not syntactically part of the message id.
|
19
|
-
#
|
20
|
-
# == Examples:
|
21
|
-
#
|
22
|
-
# mail = Mail.new
|
23
|
-
# mail.message_id = '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
24
|
-
# mail.message_id #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
25
|
-
# mail[:message_id] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
|
26
|
-
# mail['message_id'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
|
27
|
-
# mail['Message-ID'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
|
28
|
-
#
|
29
|
-
# mail[:message_id].message_id #=> 'F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom'
|
30
|
-
# mail[:message_id].message_ids #=> ['F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom']
|
31
|
-
#
|
32
|
-
require 'mail/fields/common/common_message_id'
|
3
|
+
require 'mail/fields/common_message_id_field'
|
4
|
+
require 'mail/utilities'
|
33
5
|
|
34
6
|
module Mail
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
self.parse
|
52
|
-
self
|
7
|
+
# Only one Message-ID field may appear in a header.
|
8
|
+
#
|
9
|
+
# Note that parsed Message IDs do not contain their enclosing angle
|
10
|
+
# brackets which, per RFC, are not part of the ID.
|
11
|
+
#
|
12
|
+
# mail = Mail.new
|
13
|
+
# mail.message_id = '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
14
|
+
# mail.message_id #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
|
15
|
+
# mail[:message_id] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
|
16
|
+
# mail['message_id'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
|
17
|
+
# mail['Message-ID'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
|
18
|
+
#
|
19
|
+
# mail[:message_id].message_id #=> 'F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom'
|
20
|
+
# mail[:message_id].message_ids #=> ['F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom']
|
21
|
+
class MessageIdField < CommonMessageIdField #:nodoc:
|
22
|
+
NAME = 'Message-ID'
|
53
23
|
|
24
|
+
def self.singular?
|
25
|
+
true
|
54
26
|
end
|
55
|
-
|
56
|
-
def
|
57
|
-
|
27
|
+
|
28
|
+
def initialize(value = nil, charset = nil)
|
29
|
+
value = Mail::Utilities.generate_message_id if Utilities.blank?(value)
|
30
|
+
super value, charset
|
58
31
|
end
|
59
|
-
|
32
|
+
|
60
33
|
def message_ids
|
61
34
|
[message_id]
|
62
35
|
end
|
63
|
-
|
64
|
-
def to_s
|
65
|
-
"<#{message_id}>"
|
66
|
-
end
|
67
|
-
|
68
|
-
def encoded
|
69
|
-
do_encode(CAPITALIZED_FIELD)
|
70
|
-
end
|
71
|
-
|
72
|
-
def decoded
|
73
|
-
do_decode
|
74
|
-
end
|
75
|
-
|
76
|
-
private
|
77
|
-
|
78
|
-
def generate_message_id
|
79
|
-
"<#{Mail.random_tag}@#{::Socket.gethostname}.mail>"
|
80
|
-
end
|
81
|
-
|
82
36
|
end
|
83
37
|
end
|