123456789_123456789_123456789_123456789_123456789_

Module: ActionMailbox::TestHelper

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
TestCase
Defined in: actionmailbox/lib/action_mailbox/test_helper.rb

Instance Method Summary

Instance Method Details

#create_inbound_email_from_fixture(fixture_name, status: :processing)

Create an InboundEmail record using an eml fixture in the format of message/rfc822 referenced with fixture_name located in test/fixtures/files/fixture_name.

[ GitHub ] 

  


# File 'actionmailbox/lib/action_mailbox/test_helper.rb', line 9



def create_inbound_email_from_fixture(fixture_name, status: :processing)
  create_inbound_email_from_source file_fixture(fixture_name).read, status: status
end


  








  

    #create_inbound_email_from_mail(status: :processing, **mail_options, &block)  
  



  

    

Creates an InboundEmail by specifying through options or a block.



Options


  • 

    :status - The status to set for the created InboundEmail. For possible statuses, see its documentation.
    




Creating a simple email



When you only need to set basic fields like from, to, subject, and body, you can pass them directly as options.



create_inbound_email_from_mail(from: "david@loudthinking.com", subject: "Hello!")



Creating a multi-part email



When you need to create a more intricate email, like a multi-part email that contains both a plaintext version and an HTML version, you can pass a block.



create_inbound_email_from_mail do
  to "David Heinemeier Hansson <david@loudthinking.com>"
  from "Bilbo Baggins <bilbo@bagend.com>"
  subject "Come down to the Shire!"

  text_part do
    body "Please join us for a party at Bag End"
  end

  html_part do
    body "<h1>Please join us for a party at Bag End</h1>"
  end
end



As with Mail.new, you can also use a block parameter to define the parts of the message:



create_inbound_email_from_mail do |mail|
  mail.to "David Heinemeier Hansson <david@loudthinking.com>"
  mail.from "Bilbo Baggins <bilbo@bagend.com>"
  mail.subject "Come down to the Shire!"

  mail.text_part do |part|
    part.body "Please join us for a party at Bag End"
  end

  mail.html_part do |part|
    part.body "<h1>Please join us for a party at Bag End</h1>"
  end
end


  



  [ GitHub ]


  

  


# File 'actionmailbox/lib/action_mailbox/test_helper.rb', line 63



def create_inbound_email_from_mail(status: :processing, **mail_options, &block)
  mail = Mail.new(mail_options, &block)
  # Bcc header is not encoded by default
  mail[:bcc].include_in_headers = true if mail[:bcc]

  create_inbound_email_from_source mail.to_s, status: status
end


  








  

    #create_inbound_email_from_source(source, status: :processing)  
  



  

    

Create an InboundEmail using the raw rfc822 source as text.


  



  [ GitHub ]


  

  


# File 'actionmailbox/lib/action_mailbox/test_helper.rb', line 72



def create_inbound_email_from_source(source, status: :processing)
  ActionMailbox::InboundEmail.create_and_extract_message_id! source, status: status
end


  








  

    #receive_inbound_email_from_fixture(*args)  
  



  

    

Create an InboundEmail from fixture using the same arguments as #create_inbound_email_from_fixture and immediately route it to processing.


  



  [ GitHub ]


  

  


# File 'actionmailbox/lib/action_mailbox/test_helper.rb', line 79



def receive_inbound_email_from_fixture(*args)
  create_inbound_email_from_fixture(*args).tap(&:route)
end


  








  

    #receive_inbound_email_from_mail(**kwargs, &block)  
  



  

    

Create an InboundEmail using the same options or block as create_inbound_email_from_mail, then immediately route it for processing.


  



  [ GitHub ]


  

  


# File 'actionmailbox/lib/action_mailbox/test_helper.rb', line 86



def receive_inbound_email_from_mail(**kwargs, &block)
  create_inbound_email_from_mail(**kwargs, &block).tap(&:route)
end


  








  

    #receive_inbound_email_from_source(*args)  
  



  

    

Create an InboundEmail using the same arguments as #create_inbound_email_from_source and immediately route it to processing.


  



  [ GitHub ]


  

  


# File 'actionmailbox/lib/action_mailbox/test_helper.rb', line 92



def receive_inbound_email_from_source(*args)
  create_inbound_email_from_source(*args).tap(&:route)
end