ruby interface
MhLoader | = | MhMailbox |
MboxLoader | = | UNIXMbox |
MaildirLoader | = | Maildir |
Provides a new email boundary to separate parts of the email. This is a random string based off the current time, so should be fairly unique.
For Example:
TMail.new_boundary #=> "mimepart_47bf656968207_25a8fbb80114" TMail.new_boundary #=> "mimepart_47bf66051de4_25a8fbb80240"
# File lib/tmail/utils.rb, line 67 def TMail.new_boundary 'mimepart_' + random_tag end
Provides a new email message ID. You can use this to generate unique email message id‘s for your email so you can track them.
Optionally takes a fully qualified domain name (default to the current hostname returned by Socket.gethostname) that will be appended to the message ID.
For Example:
email.message_id = TMail.new_message_id #=> "<47bf66845380e_25a8fbb80332@baci.local.tmail>" email.to_s #=> "Message-Id: <47bf668b633f1_25a8fbb80475@baci.local.tmail>\n\n" email.message_id = TMail.new_message_id("lindsaar.net") #=> "<47bf668b633f1_25a8fbb80475@lindsaar.net.tmail>" email.to_s #=> "Message-Id: <47bf668b633f1_25a8fbb80475@lindsaar.net.tmail>\n\n"
# File lib/tmail/utils.rb, line 87 def TMail.new_message_id( fqdn = nil ) fqdn ||= ::Socket.gethostname "<#{random_tag()}@#{fqdn}.tmail>" end
Returns the TMail object decoded and ready to be used by you, your program etc.
You should call this before you are packaging up your email to correctly escape all the values that need escaping in the email, line wrap the email etc.
For Example:
email = TMail::Load(my_email_file) email_to_send = email.encoded
# File lib/tmail/encode.rb, line 88 def decoded( eol = "\n", charset = 'e', dest = nil ) # Turn the E-Mail into a string and return it with all # encoded characters decoded. alias for to_s accept_strategy Decoder, eol, charset, dest end
You should call this before you are packaging up your email to correctly escape all the values that need escaping in the email, line wrap the email etc.
It is also a good idea to call this before you marshal or serialize a TMail object.
For Example:
email = TMail::Load(my_email_file) email_to_send = email.encoded
# File lib/tmail/encode.rb, line 73 def encoded( eol = "\r\n", charset = 'j', dest = nil ) accept_strategy Encoder, eol, charset, dest end