Class: Howitzer::MailAdapters::Mailgun

Inherits:
Abstract
  • Object
show all
Defined in:
lib/howitzer/mail_adapters/mailgun.rb

Overview

This class represents Mailgun mail adapter

Instance Attribute Summary

Attributes inherited from Abstract

#message

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Abstract

#initialize

Constructor Details

This class inherits a constructor from Howitzer::MailAdapters::Abstract

Class Method Details

.find(recipient, subject, wait:) ⇒ Object

Note:

emails are stored for 3 days only!

Finds an email in storage

Parameters:

  • recipient (String) —

    an email

  • subject (String)
  • wait (Integer) —

    how much time is required to wait an email

Raises:



16
17
18
19
20
21
22
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 16

def self.find(recipient, subject, wait:)
  message = {}
  retryable(find_retry_params(wait)) { message = retrieve_message(recipient, subject) }
  return new(message) if message.present?
  raise Howitzer::EmailNotFoundError,
        "Message with subject '#{subject}' for recipient '#{recipient}' was not found."
end

Instance Method Details

#html_body ⇒ String

Returns html body of the email message.

Returns:

  • (String) —

    html body of the email message



32
33
34
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 32

def html_body
  message['stripped-html']
end

#mail_from ⇒ String

Returns an email address specified in ‘From` field.

Returns:

  • (String) —

    an email address specified in ‘From` field



44
45
46
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 44

def mail_from
  message['From']
end

#mime_part ⇒ Array

Returns attachments.

Returns:

  • (Array) —

    attachments



68
69
70
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 68

def mime_part
  message['attachments']
end

#mime_part! ⇒ Array

Returns attachments.

Returns:

  • (Array) —

    attachments

Raises:



75
76
77
78
79
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 75

def mime_part!
  files = mime_part
  return files if files.present?
  raise Howitzer::NoAttachmentsError, 'No attachments were found.'
end

#plain_text_body ⇒ String

Returns plain text body of the email message.

Returns:

  • (String) —

    plain text body of the email message



26
27
28
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 26

def plain_text_body
  message['body-plain']
end

#received_time ⇒ String

Returns when email was received.

Returns:

  • (String) —

    when email was received



56
57
58
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 56

def received_time
  message['Received'][/\w+, \d+ \w+ \d+ \d+:\d+:\d+ -\d+ \(\w+\)$/]
end

#recipients ⇒ String

Returns recipient emails separated with ‘, `.

Returns:

  • (String) —

    recipient emails separated with ‘, `



50
51
52
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 50

def recipients
  message['To'].split ', '
end

#sender_email ⇒ String

Returns a real sender email address.

Returns:

  • (String) —

    a real sender email address



62
63
64
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 62

def sender_email
  message['sender']
end

#text ⇒ String

Returns stripped text.

Returns:

  • (String) —

    stripped text



38
39
40
 
# File 'lib/howitzer/mail_adapters/mailgun.rb', line 38

def text
  message['stripped-text']
end