Class: Howitzer::MailAdapters::Gmail

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

Overview

This class represents Gmail mail adapter

Instance Attribute Summary

Attributes inherited from Abstract

#message

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Abstract

#initialize, #sender_email

Constructor Details

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

Class Method Details

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

Finds an email in storage

Parameters:

  • recipient (String) —

    an email

  • subject (String)
  • wait (Integer) —

    how much time is required to wait an email

Raises:



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

def self.find(recipient, subject, wait:)
  message = {}
  retryable(find_retry_params(wait)) { message = get_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/gmail.rb', line 32

def html_body
  message.html_part.to_s
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/gmail.rb', line 44

def mail_from
  "#{message.from[0]['mailbox']}@#{message.from[0]['host']}"
end

#mime_part ⇒ Array

Returns attachments.

Returns:

  • (Array) —

    attachments



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

def mime_part
  message.attachments
end

#mime_part! ⇒ Array

Returns attachments.

Returns:

  • (Array) —

    attachments

Raises:



69
70
71
72
73
74
 
# File 'lib/howitzer/mail_adapters/gmail.rb', line 69

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/gmail.rb', line 26

def plain_text_body
  message.body.to_s
end

#received_time ⇒ String

Returns when email was received.

Returns:

  • (String) —

    when email was received



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

def received_time
  Time.parse(message.date).strftime('%F %T')
end

#recipients ⇒ Array

Returns recipient emails.

Returns:

  • (Array) —

    recipient emails



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

def recipients
  message.to.inject([]) { |ar, to| ar << "#{to['mailbox']}@#{to['host']}" }
end

#text ⇒ String

Returns stripped text.

Returns:

  • (String) —

    stripped text



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

def text
  message.text_part.to_s
end