Class: Net::SMTP::Response
Relationships & Source Files | |
Inherits: | Object |
Defined in: | lib/net/smtp.rb |
Overview
This class represents a response received by the ::Net::SMTP server. Instances of this class are created by the ::Net::SMTP class; they should not be directly created by the user. For more information on ::Net::SMTP responses, view Section 4.2 of RFC 5321
Class Method Summary
-
.new(status, string) ⇒ Response
constructor
Creates a new instance of the
Response
class and sets the status and string attributes. -
.parse(str)
Parses the received response and separates the reply code and the human readable reply text.
Instance Attribute Summary
-
#continue? ⇒ Boolean
readonly
Determines whether the response received was a Positive Intermediate reply (3xx reply code).
-
#status
readonly
The three digit reply code of the ::Net::SMTP response.
-
#string
readonly
The human readable reply text of the ::Net::SMTP response.
-
#success? ⇒ Boolean
readonly
Determines whether the response received was a Positive Completion reply (2xx reply code).
Instance Method Summary
-
#capabilities
Returns a hash of the human readable reply text in the response if it is multiple lines.
-
#cram_md5_challenge
Creates a CRAM-MD5 challenge.
-
#exception_class
Determines whether there was an error and raises the appropriate error based on the reply code of the response.
-
#message
The first line of the human readable reply text.
-
#status_type_char
Takes the first digit of the reply code to determine the status type.
Constructor Details
.new(status, string) ⇒ Response
Creates a new instance of the Response
class and sets the status and string attributes
Class Method Details
.parse(str)
Parses the received response and separates the reply code and the human readable reply text
# File 'lib/net/smtp.rb', line 1003
def self.parse(str) new(str[0,3], str) end
Instance Attribute Details
#continue? ⇒ Boolean
(readonly)
Determines whether the response received was a Positive Intermediate reply (3xx reply code)
# File 'lib/net/smtp.rb', line 1033
def continue? status_type_char() == '3' end
#status (readonly)
The three digit reply code of the ::Net::SMTP response
# File 'lib/net/smtp.rb', line 1015
attr_reader :status
#string (readonly)
The human readable reply text of the ::Net::SMTP response
# File 'lib/net/smtp.rb', line 1018
attr_reader :string
#success? ⇒ Boolean
(readonly)
Determines whether the response received was a Positive Completion reply (2xx reply code)
# File 'lib/net/smtp.rb', line 1027
def success? status_type_char() == '2' end
Instance Method Details
#capabilities
Returns a hash of the human readable reply text in the response if it is multiple lines. It does not return the first line. The key of the hash is the first word the value of the hash is an array with each word thereafter being a value in the array
# File 'lib/net/smtp.rb', line 1052
def capabilities return {} unless @string[3, 1] == '-' h = {} @string.lines.drop(1).each do |line| k, *v = line[4..-1].chomp.split h[k] = v end h end
#cram_md5_challenge
Creates a CRAM-MD5 challenge. You can view more information on CRAM-MD5 on Wikipedia: en.wikipedia.org/wiki/CRAM-MD5
# File 'lib/net/smtp.rb', line 1044
def cram_md5_challenge @string.split(/ /)[1].unpack('m')[0] end
#exception_class
Determines whether there was an error and raises the appropriate error based on the reply code of the response
# File 'lib/net/smtp.rb', line 1064
def exception_class case @status when /\A4/ then SMTPServerBusy when /\A50/ then SMTPSyntaxError when /\A53/ then SMTPAuthenticationError when /\A5/ then SMTPFatalError else SMTPUnknownError end end
#message
The first line of the human readable reply text
# File 'lib/net/smtp.rb', line 1038
def @string.lines.first end
#status_type_char
Takes the first digit of the reply code to determine the status type
# File 'lib/net/smtp.rb', line 1021
def status_type_char @status[0, 1] end