mail 2.6.4 → 2.8.0
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.
- 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,5 +1,5 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
require 'mail/
|
2
|
+
require 'mail/smtp_envelope'
|
3
3
|
|
4
4
|
module Mail
|
5
5
|
# A delivery method implementation which sends via sendmail.
|
@@ -38,53 +38,50 @@ module Mail
|
|
38
38
|
#
|
39
39
|
# mail.deliver!
|
40
40
|
class Sendmail
|
41
|
-
|
41
|
+
DEFAULTS = {
|
42
|
+
:location => '/usr/sbin/sendmail',
|
43
|
+
:arguments => %w[ -i ]
|
44
|
+
}
|
45
|
+
|
46
|
+
attr_accessor :settings
|
47
|
+
|
48
|
+
class DeliveryError < StandardError
|
49
|
+
end
|
42
50
|
|
43
51
|
def initialize(values)
|
44
|
-
self.settings =
|
45
|
-
|
52
|
+
self.settings = self.class::DEFAULTS.merge(values)
|
53
|
+
raise ArgumentError, ":arguments expected to be an Array of individual string args" if settings[:arguments].is_a?(String)
|
46
54
|
end
|
47
55
|
|
48
|
-
|
56
|
+
def destinations_for(envelope)
|
57
|
+
envelope.to
|
58
|
+
end
|
49
59
|
|
50
60
|
def deliver!(mail)
|
51
|
-
|
61
|
+
envelope = Mail::SmtpEnvelope.new(mail)
|
52
62
|
|
53
|
-
|
54
|
-
|
63
|
+
command = [settings[:location]]
|
64
|
+
command.concat Array(settings[:arguments])
|
65
|
+
command.concat [ '-f', envelope.from ] if envelope.from
|
55
66
|
|
56
|
-
|
57
|
-
|
58
|
-
|
67
|
+
if destinations = destinations_for(envelope)
|
68
|
+
command.push '--'
|
69
|
+
command.concat destinations
|
70
|
+
end
|
59
71
|
|
60
|
-
|
61
|
-
|
62
|
-
io.puts ::Mail::Utilities.to_lf(encoded_message)
|
72
|
+
popen(command) do |io|
|
73
|
+
io.puts ::Mail::Utilities.binary_unsafe_to_lf(envelope.message)
|
63
74
|
io.flush
|
64
75
|
end
|
65
76
|
end
|
66
77
|
|
67
|
-
|
68
|
-
def
|
69
|
-
IO.popen
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
78
|
+
private
|
79
|
+
def popen(command, &block)
|
80
|
+
IO.popen(command, 'w+', :err => :out, &block).tap do
|
81
|
+
if $?.exitstatus != 0
|
82
|
+
raise DeliveryError, "Delivery failed with exitstatus #{$?.exitstatus}: #{command.inspect}"
|
83
|
+
end
|
84
|
+
end
|
74
85
|
end
|
75
|
-
end
|
76
|
-
|
77
|
-
# The following is an adaptation of ruby 1.9.2's shellwords.rb file,
|
78
|
-
# it is modified to include '+' in the allowed list to allow for
|
79
|
-
# sendmail to accept email addresses as the sender with a + in them.
|
80
|
-
def self.shellquote(address)
|
81
|
-
# Process as a single byte sequence because not all shell
|
82
|
-
# implementations are multibyte aware.
|
83
|
-
#
|
84
|
-
# A LF cannot be escaped with a backslash because a backslash + LF
|
85
|
-
# combo is regarded as line continuation and simply ignored. Strip it.
|
86
|
-
escaped = address.gsub(/([^A-Za-z0-9_\s\+\-.,:\/@])/n, "\\\\\\1").gsub("\n", '')
|
87
|
-
%("#{escaped}")
|
88
|
-
end
|
89
86
|
end
|
90
87
|
end
|
@@ -1,5 +1,5 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
require 'mail/
|
2
|
+
require 'mail/smtp_envelope'
|
3
3
|
|
4
4
|
module Mail
|
5
5
|
# == Sending Email with SMTP
|
@@ -45,9 +45,8 @@ module Mail
|
|
45
45
|
# hostname or update the certificate authorities trusted by your ruby. If
|
46
46
|
# that isn't possible, you can control this behavior with
|
47
47
|
# an :openssl_verify_mode setting. Its value may be either an OpenSSL
|
48
|
-
# verify mode constant (OpenSSL::SSL::VERIFY_NONE),
|
49
|
-
# the name of an OpenSSL verify mode (none, peer
|
50
|
-
# fail_if_no_peer_cert).
|
48
|
+
# verify mode constant (OpenSSL::SSL::VERIFY_NONE, OpenSSL::SSL::VERIFY_PEER),
|
49
|
+
# or a string containing the name of an OpenSSL verify mode (none, peer).
|
51
50
|
#
|
52
51
|
# === Others
|
53
52
|
#
|
@@ -75,69 +74,92 @@ module Mail
|
|
75
74
|
#
|
76
75
|
# mail.deliver!
|
77
76
|
class SMTP
|
78
|
-
|
77
|
+
attr_accessor :settings
|
78
|
+
|
79
|
+
DEFAULTS = {
|
80
|
+
:address => 'localhost',
|
81
|
+
:port => 25,
|
82
|
+
:domain => 'localhost.localdomain',
|
83
|
+
:user_name => nil,
|
84
|
+
:password => nil,
|
85
|
+
:authentication => nil,
|
86
|
+
:enable_starttls => nil,
|
87
|
+
:enable_starttls_auto => true,
|
88
|
+
:openssl_verify_mode => nil,
|
89
|
+
:ssl => nil,
|
90
|
+
:tls => nil,
|
91
|
+
:open_timeout => 5,
|
92
|
+
:read_timeout => 5
|
93
|
+
}
|
79
94
|
|
80
95
|
def initialize(values)
|
81
|
-
self.settings =
|
82
|
-
:port => 25,
|
83
|
-
:domain => 'localhost.localdomain',
|
84
|
-
:user_name => nil,
|
85
|
-
:password => nil,
|
86
|
-
:authentication => nil,
|
87
|
-
:enable_starttls_auto => true,
|
88
|
-
:openssl_verify_mode => nil,
|
89
|
-
:ssl => nil,
|
90
|
-
:tls => nil
|
91
|
-
}.merge!(values)
|
96
|
+
self.settings = DEFAULTS.merge(values)
|
92
97
|
end
|
93
98
|
|
94
|
-
attr_accessor :settings
|
95
|
-
|
96
|
-
# Send the message via SMTP.
|
97
|
-
# The from and to attributes are optional. If not set, they are retrieve from the Message.
|
98
99
|
def deliver!(mail)
|
99
|
-
|
100
|
-
|
101
|
-
smtp = Net::SMTP.new(settings[:address], settings[:port])
|
102
|
-
if settings[:tls] || settings[:ssl]
|
103
|
-
if smtp.respond_to?(:enable_tls)
|
104
|
-
smtp.enable_tls(ssl_context)
|
105
|
-
end
|
106
|
-
elsif settings[:enable_starttls_auto]
|
107
|
-
if smtp.respond_to?(:enable_starttls_auto)
|
108
|
-
smtp.enable_starttls_auto(ssl_context)
|
109
|
-
end
|
110
|
-
end
|
111
|
-
|
112
|
-
response = nil
|
113
|
-
smtp.start(settings[:domain], settings[:user_name], settings[:password], settings[:authentication]) do |smtp_obj|
|
114
|
-
response = smtp_obj.sendmail(message, smtp_from, smtp_to)
|
100
|
+
response = start_smtp_session do |smtp|
|
101
|
+
Mail::SMTPConnection.new(:connection => smtp, :return_response => true).deliver!(mail)
|
115
102
|
end
|
116
103
|
|
117
|
-
|
118
|
-
response
|
119
|
-
else
|
120
|
-
self
|
121
|
-
end
|
104
|
+
settings[:return_response] ? response : self
|
122
105
|
end
|
123
|
-
|
124
106
|
|
125
107
|
private
|
108
|
+
def start_smtp_session(&block)
|
109
|
+
build_smtp_session.start(settings[:domain], settings[:user_name], settings[:password], settings[:authentication], &block)
|
110
|
+
end
|
126
111
|
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
112
|
+
def build_smtp_session
|
113
|
+
Net::SMTP.new(settings[:address], settings[:port]).tap do |smtp|
|
114
|
+
tls = settings[:tls] || settings[:ssl]
|
115
|
+
if !tls.nil?
|
116
|
+
case tls
|
117
|
+
when true
|
118
|
+
smtp.enable_tls(ssl_context)
|
119
|
+
when false
|
120
|
+
smtp.disable_tls
|
121
|
+
else
|
122
|
+
raise ArgumentError, "Unrecognized :tls value #{settings[:tls].inspect}; expected true, false, or nil"
|
123
|
+
end
|
124
|
+
elsif settings.include?(:enable_starttls) && !settings[:enable_starttls].nil?
|
125
|
+
case settings[:enable_starttls]
|
126
|
+
when true
|
127
|
+
smtp.enable_starttls(ssl_context)
|
128
|
+
when false
|
129
|
+
smtp.disable_starttls
|
130
|
+
else
|
131
|
+
raise ArgumentError, "Unrecognized :enable_starttls value #{settings[:enable_starttls].inspect}; expected true, false, or nil"
|
132
|
+
end
|
133
|
+
elsif settings.include?(:enable_starttls_auto) && !settings[:enable_starttls_auto].nil?
|
134
|
+
case settings[:enable_starttls_auto]
|
135
|
+
when true
|
136
|
+
smtp.enable_starttls_auto(ssl_context)
|
137
|
+
when false
|
138
|
+
smtp.disable_starttls_auto
|
139
|
+
else
|
140
|
+
raise ArgumentError, "Unrecognized :enable_starttls_auto value #{settings[:enable_starttls_auto].inspect}; expected true, false, or nil"
|
141
|
+
end
|
142
|
+
end
|
131
143
|
|
132
|
-
|
133
|
-
|
144
|
+
smtp.open_timeout = settings[:open_timeout] if settings[:open_timeout]
|
145
|
+
smtp.read_timeout = settings[:read_timeout] if settings[:read_timeout]
|
146
|
+
end
|
134
147
|
end
|
135
148
|
|
136
|
-
context
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
|
141
|
-
|
149
|
+
# Allow SSL context to be configured via settings, for Ruby >= 1.9
|
150
|
+
# Just returns openssl verify mode for Ruby 1.8.x
|
151
|
+
def ssl_context
|
152
|
+
openssl_verify_mode = settings[:openssl_verify_mode]
|
153
|
+
|
154
|
+
if openssl_verify_mode.kind_of?(String)
|
155
|
+
openssl_verify_mode = OpenSSL::SSL.const_get("VERIFY_#{openssl_verify_mode.upcase}")
|
156
|
+
end
|
157
|
+
|
158
|
+
context = Net::SMTP.default_ssl_context
|
159
|
+
context.verify_mode = openssl_verify_mode if openssl_verify_mode
|
160
|
+
context.ca_path = settings[:ca_path] if settings[:ca_path]
|
161
|
+
context.ca_file = settings[:ca_file] if settings[:ca_file]
|
162
|
+
context
|
163
|
+
end
|
142
164
|
end
|
143
165
|
end
|
@@ -1,5 +1,5 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
require 'mail/
|
2
|
+
require 'mail/smtp_envelope'
|
3
3
|
|
4
4
|
module Mail
|
5
5
|
# == Sending Email with SMTP
|
@@ -38,7 +38,7 @@ module Mail
|
|
38
38
|
#
|
39
39
|
# mail.deliver!
|
40
40
|
class SMTPConnection
|
41
|
-
|
41
|
+
attr_accessor :smtp, :settings
|
42
42
|
|
43
43
|
def initialize(values)
|
44
44
|
raise ArgumentError.new('A Net::SMTP object is required for this delivery method') if values[:connection].nil?
|
@@ -46,17 +46,12 @@ module Mail
|
|
46
46
|
self.settings = values
|
47
47
|
end
|
48
48
|
|
49
|
-
attr_accessor :smtp
|
50
|
-
attr_accessor :settings
|
51
|
-
|
52
49
|
# Send the message via SMTP.
|
53
50
|
# The from and to attributes are optional. If not set, they are retrieve from the Message.
|
54
51
|
def deliver!(mail)
|
55
|
-
|
56
|
-
response = smtp.sendmail(message,
|
57
|
-
|
52
|
+
envelope = Mail::SmtpEnvelope.new(mail)
|
53
|
+
response = smtp.sendmail(envelope.message, envelope.from, envelope.to)
|
58
54
|
settings[:return_response] ? response : self
|
59
55
|
end
|
60
|
-
|
61
56
|
end
|
62
57
|
end
|
@@ -1,5 +1,5 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
|
-
require 'mail/
|
2
|
+
require 'mail/smtp_envelope'
|
3
3
|
|
4
4
|
module Mail
|
5
5
|
# The TestMailer is a bare bones mailer that does nothing. It is useful
|
@@ -8,10 +8,8 @@ module Mail
|
|
8
8
|
# It also provides a template of the minimum methods you require to implement
|
9
9
|
# if you want to make a custom mailer for Mail
|
10
10
|
class TestMailer
|
11
|
-
include Mail::CheckDeliveryParams
|
12
|
-
|
13
11
|
# Provides a store of all the emails sent with the TestMailer so you can check them.
|
14
|
-
def
|
12
|
+
def self.deliveries
|
15
13
|
@@deliveries ||= []
|
16
14
|
end
|
17
15
|
|
@@ -26,20 +24,21 @@ module Mail
|
|
26
24
|
# * length
|
27
25
|
# * size
|
28
26
|
# * and other common Array methods
|
29
|
-
def
|
27
|
+
def self.deliveries=(val)
|
30
28
|
@@deliveries = val
|
31
29
|
end
|
32
30
|
|
31
|
+
attr_accessor :settings
|
32
|
+
|
33
33
|
def initialize(values)
|
34
34
|
@settings = values.dup
|
35
35
|
end
|
36
|
-
|
37
|
-
attr_accessor :settings
|
38
36
|
|
39
37
|
def deliver!(mail)
|
40
|
-
|
38
|
+
# Create the envelope to validate it
|
39
|
+
Mail::SmtpEnvelope.new(mail)
|
40
|
+
|
41
41
|
Mail::TestMailer.deliveries << mail
|
42
42
|
end
|
43
|
-
|
44
43
|
end
|
45
44
|
end
|
@@ -11,8 +11,8 @@ module Mail
|
|
11
11
|
# count: number of emails to retrieve. The default value is 1.
|
12
12
|
# order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.
|
13
13
|
#
|
14
|
-
def first(options =
|
15
|
-
options
|
14
|
+
def first(options = nil, &block)
|
15
|
+
options = options ? Hash[options] : {}
|
16
16
|
options[:what] = :first
|
17
17
|
options[:count] ||= 1
|
18
18
|
find(options, &block)
|
@@ -24,8 +24,8 @@ module Mail
|
|
24
24
|
# count: number of emails to retrieve. The default value is 1.
|
25
25
|
# order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.
|
26
26
|
#
|
27
|
-
def last(options =
|
28
|
-
options
|
27
|
+
def last(options = nil, &block)
|
28
|
+
options = options ? Hash[options] : {}
|
29
29
|
options[:what] = :last
|
30
30
|
options[:count] ||= 1
|
31
31
|
find(options, &block)
|
@@ -36,8 +36,8 @@ module Mail
|
|
36
36
|
# Possible options:
|
37
37
|
# order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.
|
38
38
|
#
|
39
|
-
def all(options =
|
40
|
-
options
|
39
|
+
def all(options = nil, &block)
|
40
|
+
options = options ? Hash[options] : {}
|
41
41
|
options[:count] = :all
|
42
42
|
find(options, &block)
|
43
43
|
end
|
@@ -53,8 +53,8 @@ module Mail
|
|
53
53
|
# delete_after_find: flag for whether to delete each retreived email after find. Default
|
54
54
|
# is true. Call #find if you would like this to default to false.
|
55
55
|
#
|
56
|
-
def find_and_delete(options =
|
57
|
-
options
|
56
|
+
def find_and_delete(options = nil, &block)
|
57
|
+
options = options ? Hash[options] : {}
|
58
58
|
options[:delete_after_find] ||= true
|
59
59
|
find(options, &block)
|
60
60
|
end
|
@@ -45,7 +45,8 @@ module Mail
|
|
45
45
|
:user_name => nil,
|
46
46
|
:password => nil,
|
47
47
|
:authentication => nil,
|
48
|
-
:enable_ssl => false
|
48
|
+
:enable_ssl => false,
|
49
|
+
:enable_starttls => false }.merge!(values)
|
49
50
|
end
|
50
51
|
|
51
52
|
attr_accessor :settings
|
@@ -67,14 +68,14 @@ module Mail
|
|
67
68
|
# keys: are passed as criteria to the SEARCH command. They can either be a string holding the entire search string,
|
68
69
|
# or a single-dimension array of search keywords and arguments. Refer to [IMAP] section 6.4.4 for a full list
|
69
70
|
# The default is 'ALL'
|
71
|
+
# search_charset: charset to pass to IMAP server search. Omitted by default. Example: 'UTF-8' or 'ASCII'.
|
70
72
|
#
|
71
|
-
def find(options=
|
73
|
+
def find(options=nil, &block)
|
72
74
|
options = validate_options(options)
|
73
75
|
|
74
76
|
start do |imap|
|
75
77
|
options[:read_only] ? imap.examine(options[:mailbox]) : imap.select(options[:mailbox])
|
76
|
-
|
77
|
-
uids = imap.uid_search(options[:keys])
|
78
|
+
uids = imap.uid_search(options[:keys], options[:search_charset])
|
78
79
|
uids.reverse! if options[:what].to_sym == :last
|
79
80
|
uids = uids.first(options[:count]) if options[:count].is_a?(Integer)
|
80
81
|
uids.reverse! if (options[:what].to_sym == :last && options[:order].to_sym == :asc) ||
|
@@ -83,14 +84,18 @@ module Mail
|
|
83
84
|
if block_given?
|
84
85
|
uids.each do |uid|
|
85
86
|
uid = options[:uid].to_i unless options[:uid].nil?
|
86
|
-
fetchdata = imap.uid_fetch(uid, ['RFC822'])[0]
|
87
|
+
fetchdata = imap.uid_fetch(uid, ['RFC822', 'FLAGS'])[0]
|
87
88
|
new_message = Mail.new(fetchdata.attr['RFC822'])
|
88
89
|
new_message.mark_for_delete = true if options[:delete_after_find]
|
89
|
-
|
90
|
+
|
91
|
+
if block.arity == 4
|
92
|
+
yield new_message, imap, uid, fetchdata.attr['FLAGS']
|
93
|
+
elsif block.arity == 3
|
90
94
|
yield new_message, imap, uid
|
91
95
|
else
|
92
96
|
yield new_message
|
93
97
|
end
|
98
|
+
|
94
99
|
imap.uid_store(uid, "+FLAGS", [Net::IMAP::DELETED]) if options[:delete_after_find] && new_message.is_marked_for_delete?
|
95
100
|
break unless options[:uid].nil?
|
96
101
|
end
|
@@ -116,6 +121,7 @@ module Mail
|
|
116
121
|
mailbox = Net::IMAP.encode_utf7(mailbox)
|
117
122
|
|
118
123
|
start do |imap|
|
124
|
+
imap.select(mailbox)
|
119
125
|
imap.uid_search(['ALL']).each do |uid|
|
120
126
|
imap.uid_store(uid, "+FLAGS", [Net::IMAP::DELETED])
|
121
127
|
end
|
@@ -136,7 +142,7 @@ module Mail
|
|
136
142
|
|
137
143
|
# Set default options
|
138
144
|
def validate_options(options)
|
139
|
-
options
|
145
|
+
options = options ? Hash[options] : {}
|
140
146
|
options[:mailbox] ||= 'INBOX'
|
141
147
|
options[:count] ||= 10
|
142
148
|
options[:order] ||= :asc
|
@@ -154,7 +160,14 @@ module Mail
|
|
154
160
|
def start(config=Mail::Configuration.instance, &block)
|
155
161
|
raise ArgumentError.new("Mail::Retrievable#imap_start takes a block") unless block_given?
|
156
162
|
|
163
|
+
if settings[:enable_starttls] && settings[:enable_ssl]
|
164
|
+
raise ArgumentError, ":enable_starttls and :enable_ssl are mutually exclusive. Set :enable_ssl if you're on an IMAPS connection. Set :enable_starttls if you're on an IMAP connection and using STARTTLS for secure TLS upgrade."
|
165
|
+
end
|
166
|
+
|
157
167
|
imap = Net::IMAP.new(settings[:address], settings[:port], settings[:enable_ssl], nil, false)
|
168
|
+
|
169
|
+
imap.starttls if settings[:enable_starttls]
|
170
|
+
|
158
171
|
if settings[:authentication].nil?
|
159
172
|
imap.login(settings[:user_name], settings[:password])
|
160
173
|
else
|
@@ -41,7 +41,8 @@ module Mail
|
|
41
41
|
:user_name => nil,
|
42
42
|
:password => nil,
|
43
43
|
:authentication => nil,
|
44
|
-
:enable_ssl => false
|
44
|
+
:enable_ssl => false,
|
45
|
+
:read_timeout => nil }.merge!(values)
|
45
46
|
end
|
46
47
|
|
47
48
|
attr_accessor :settings
|
@@ -56,7 +57,7 @@ module Mail
|
|
56
57
|
# delete_after_find: flag for whether to delete each retreived email after find. Default
|
57
58
|
# is false. Use #find_and_delete if you would like this to default to true.
|
58
59
|
#
|
59
|
-
def find(options =
|
60
|
+
def find(options = nil, &block)
|
60
61
|
options = validate_options(options)
|
61
62
|
|
62
63
|
start do |pop3|
|
@@ -112,7 +113,7 @@ module Mail
|
|
112
113
|
|
113
114
|
# Set default options
|
114
115
|
def validate_options(options)
|
115
|
-
options
|
116
|
+
options = options ? Hash[options] : {}
|
116
117
|
options[:count] ||= 10
|
117
118
|
options[:order] ||= :asc
|
118
119
|
options[:what] ||= :first
|
@@ -128,6 +129,7 @@ module Mail
|
|
128
129
|
|
129
130
|
pop3 = Net::POP3.new(settings[:address], settings[:port], false)
|
130
131
|
pop3.enable_ssl(OpenSSL::SSL::VERIFY_NONE) if settings[:enable_ssl]
|
132
|
+
pop3.read_timeout = settings[:read_timeout] if settings[:read_timeout]
|
131
133
|
pop3.start(settings[:user_name], settings[:password])
|
132
134
|
|
133
135
|
yield pop3
|
@@ -17,7 +17,8 @@ module Mail
|
|
17
17
|
@@emails = []
|
18
18
|
end
|
19
19
|
|
20
|
-
def find(options =
|
20
|
+
def find(options = nil, &block)
|
21
|
+
options = options ? Hash[options] : {}
|
21
22
|
options[:count] ||= :all
|
22
23
|
options[:order] ||= :asc
|
23
24
|
options[:what] ||= :first
|
@@ -25,7 +26,7 @@ module Mail
|
|
25
26
|
emails_index.reverse! if options[:what] == :last
|
26
27
|
emails_index = case count = options[:count]
|
27
28
|
when :all then emails_index
|
28
|
-
when
|
29
|
+
when Integer then emails_index[0, count]
|
29
30
|
else
|
30
31
|
raise 'Invalid count option value: ' + count.inspect
|
31
32
|
end
|
data/lib/mail/network.rb
CHANGED
@@ -4,6 +4,7 @@ require 'mail/network/retriever_methods/base'
|
|
4
4
|
module Mail
|
5
5
|
register_autoload :SMTP, 'mail/network/delivery_methods/smtp'
|
6
6
|
register_autoload :FileDelivery, 'mail/network/delivery_methods/file_delivery'
|
7
|
+
register_autoload :LoggerDelivery, 'mail/network/delivery_methods/logger_delivery'
|
7
8
|
register_autoload :Sendmail, 'mail/network/delivery_methods/sendmail'
|
8
9
|
register_autoload :Exim, 'mail/network/delivery_methods/exim'
|
9
10
|
register_autoload :SMTPConnection, 'mail/network/delivery_methods/smtp_connection'
|
@@ -0,0 +1,15 @@
|
|
1
|
+
module Mail
|
2
|
+
# Extends each field parser with utility methods.
|
3
|
+
module ParserTools #:nodoc:
|
4
|
+
# Slice bytes from ASCII-8BIT data and mark as UTF-8.
|
5
|
+
if 'string'.respond_to?(:force_encoding)
|
6
|
+
def chars(data, from_bytes, to_bytes)
|
7
|
+
data.slice(from_bytes..to_bytes).force_encoding(Encoding::UTF_8)
|
8
|
+
end
|
9
|
+
else
|
10
|
+
def chars(data, from_bytes, to_bytes)
|
11
|
+
data.slice(from_bytes..to_bytes)
|
12
|
+
end
|
13
|
+
end
|
14
|
+
end
|
15
|
+
end
|