Class: Howitzer::Email

Inherits:
Object
  • Object
show all
Includes:
RSpec::Matchers
Defined in:
lib/howitzer/email.rb

Overview

This class describes single email

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(message) ⇒ Email 



88
89
90
 
# File 'lib/howitzer/email.rb', line 88

def initialize(message)
  @message = message
end

Class Attribute Details

.adapter_name ⇒ Object (readonly)

Returns the value of attribute adapter_name.



21
22
23
 
# File 'lib/howitzer/email.rb', line 21

def adapter_name
  @adapter_name
end

Instance Attribute Details

#message ⇒ Object (readonly)

Returns the value of attribute message.



9
10
11
 
# File 'lib/howitzer/email.rb', line 9

def message
  @message
end

Class Method Details

.adapter ⇒ <MailAdapters::Abstract> 



13
14
15
16
17
18
 
# File 'lib/howitzer/email.rb', line 13

def self.adapter
  return @adapter if @adapter

  self.adapter = Howitzer.mail_adapter.to_sym
  @adapter
end

.adapter=(adapter_name) ⇒ Object

Specifies a mail adapter

Raises:



61
62
63
64
65
66
67
68
69
70
 
# File 'lib/howitzer/email.rb', line 61

def self.adapter=(adapter_name)
  @adapter_name = adapter_name
  case adapter_name
    when Symbol, String
      require "howitzer/mail_adapters/#{adapter_name}"
      @adapter = MailAdapters.const_get(adapter_name.to_s.capitalize.to_s)
    else
      raise Howitzer::NoMailAdapterError
  end
end

.find_by_recipient(recipient, params = {}) ⇒ Email

Searches a mail by a recepient

Raises:

See Also:



79
80
81
82
83
84
85
86
 
# File 'lib/howitzer/email.rb', line 79

def self.find_by_recipient(recipient, params = {})
  if defined?(subject_value).nil? || subject_value.nil?
    raise Howitzer::NoEmailSubjectError, "Please specify email subject. For example:\n" \
                                         "class SomeEmail < Howitzer::Email\n  " \
                                         "subject ‘some subject text’\nend"
  end
  new(adapter.find(recipient, expand_subject(params), wait: wait_time_value))
end

.subject(value) ⇒ Object

DSL method to specify a subject pattern directly in an email class

Examples:

class WelcomeEmail < Howitzer::Email
  subject 'Welcome on board :name'
end

WelcomeEmail.find_by_recipient('[email protected]', name: 'John')



35
36
37
38
 
# File 'lib/howitzer/email.rb', line 35

def subject(value)
  define_singleton_method(:subject_value) { value }
  private_class_method :subject_value
end

.wait_time(value) ⇒ Object

DSL method to specify a custom wait email time directly in an email class

Examples:

class WelcomeEmail < Howitzer::Email
  wait_time 10.minutes
end



49
50
51
52
 
# File 'lib/howitzer/email.rb', line 49

def wait_time(value)
  define_singleton_method(:wait_time_value) { value }
  private_class_method :wait_time_value
end

Instance Method Details

#html_body ⇒ String? 



100
101
102
 
# File 'lib/howitzer/email.rb', line 100

def html_body
  message.html_body
end

#mail_from ⇒ String 



112
113
114
 
# File 'lib/howitzer/email.rb', line 112

def mail_from
  message.mail_from
end

#mime_part ⇒ Object

Allows to get email MIME attachment



136
137
138
 
# File 'lib/howitzer/email.rb', line 136

def mime_part
  message.mime_part
end

#plain_text_body ⇒ String? 



94
95
96
 
# File 'lib/howitzer/email.rb', line 94

def plain_text_body
  message.plain_text_body
end

#received_time ⇒ String 



124
125
126
 
# File 'lib/howitzer/email.rb', line 124

def received_time
  message.received_time
end

#recipients ⇒ Array<String> 



118
119
120
 
# File 'lib/howitzer/email.rb', line 118

def recipients
  message.recipients
end

#sender_email ⇒ String 



130
131
132
 
# File 'lib/howitzer/email.rb', line 130

def sender_email
  message.sender_email
end

#text ⇒ String? 



106
107
108
 
# File 'lib/howitzer/email.rb', line 106

def text
  message.text
end