mail_plugger 1.0.0.beta1 → 1.0.0.rc1

data/docs/usage_of_delivery_method.md

@@ -0,0 +1,104 @@
+# How to use MailPlugger::DeliveryMethod class
+
+With this class it can extract data from the Mail::Message object and send message based on the given configurations. We can add these options directly in the `new` method or we can use `MailPlugger.plug_in` method as well.
+
+The `new` method parameter is a Hash where the keys are Symbols.
+
+Hash parameters:
+- `client` which should be a Class (It can be a Hash with this Class as well. In this case the key of the Hash is the `delivery_system` from the `Mail::Message` object or the `default_delivery_system`). This Class is a special class which generates the data and calls the API to send the message.
+- `delivery_options` which should be an Array with Symbols or Strings (It can be a Hash with this Array as well. In this case the key of the Hash is the `delivery_system` from the `Mail::Message` object or the `default_delivery_system`). It will search these options in the `Mail::Message` object like `from`, `to`, `cc`, `bcc`, `subject`, `body`, `text_part`, `html_part`, `attachments` or anything what we will add to this object. Also we can retrieve the `Mail::Message` object with `message_obj`.
+- `delivery_settings` which should be a Hash. The Mail gem can use these settings like `{ return_response: true }` (The keys are should be Symbols).
+- `default_delivery_system` which should be a String or Symbol. This option is needed when `delivery_options` and `client` are Hashes. When `delivery_system` in the `Mail::Message` object is not defined then the `default_delivery_system` value is the key of those Hashes. When `default_delivery_system` is not defined then `default_delivery_system_get` will return with the first key of `delivery_options` or `client` Hash.
+
+Examples:
+
+```ruby
+# NOTE: This is just an example for testing...
+class TestApiClientClass
+  def initialize(options = {})
+    @settings = { api_key: '12345' }
+    @options = options
+  end
+
+  def deliver
+    # e.g. API.new(@settings).client.post(generate_mail_hash)
+    puts " >>> settings: #{@settings.inspect}"
+    puts " >>> options: #{@options.inspect}"
+    puts " >>> generate_mail_hash: #{generate_mail_hash.inspect}"
+    { response: 'OK' }
+  end
+
+  private
+
+  def generate_mail_hash
+    {
+      to: generate_recipients,
+      from: {
+        email: @options[:from].first
+      },
+      subject: @options[:subject],
+      content: [
+        {
+          type: 'text/plain',
+          value: @options[:body]
+        }
+      ]
+    }
+  end
+
+  def generate_recipients
+    @options[:to].map do |to|
+      {
+        email: to
+      }
+    end
+  end
+end
+```
+
+We can add simple options to `MailPlugger::DeliveryMethod`.
+
+```ruby
+message = Mail.new(from: 'from@example.com', to: 'to@example.com', subject: 'Test email', body: 'Test email body')
+
+MailPlugger::DeliveryMethod.new(delivery_options: %i[from to subject body], client: TestApiClientClass).deliver!(message)
+```
+
+Or we can add these options in Hash and set `default_delivery_system`.
+
+```ruby
+message = Mail.new(from: 'from@example.com', to: 'to@example.com', subject: 'Test email', body: 'Test email body')
+
+MailPlugger::DeliveryMethod.new(delivery_options: { 'test_api_client' => %i[from to subject body] }, client: { 'test_api_client' => TestApiClientClass }, default_delivery_system: 'test_api_client').deliver!(message)
+```
+
+Add `delivery_system` in the `Mail::Message` object (it will search this value in the given Hash). The `delivery_system` type in the `Mail::Message` object should match with the given key type of the Hash (if `delivery_system` is String then Hash key should String as well).
+
+```ruby
+message = Mail.new(from: 'from@example.com', to: 'to@example.com', subject: 'Test email', body: 'Test email body', delivery_system: 'test_api_client')
+
+MailPlugger::DeliveryMethod.new(delivery_options: { 'test_api_client' => %i[from to subject body] }, client: { 'test_api_client' => TestApiClientClass }).deliver!(message)
+```
+
+If we are not adding `delivery_system` anywhere then it will use the first key of the Hash.
+
+```ruby
+message = Mail.new(from: 'from@example.com', to: 'to@example.com', subject: 'Test email', body: 'Test email body')
+
+MailPlugger::DeliveryMethod.new(delivery_options: { 'test_api_client' => %i[from to subject body] }, client: { 'test_api_client' => TestApiClientClass }).deliver!(message)
+```
+
+We can use `MailPlugger.plug_in` to add our configurations.
+
+```ruby
+MailPlugger.plug_in('test_api_client') do |api|
+  api.delivery_options = %i[from to subject body]
+  api.client = TestApiClientClass
+end
+
+message = Mail.new(from: 'from@example.com', to: 'to@example.com', subject: 'Test email', body: 'Test email body')
+
+MailPlugger::DeliveryMethod.new.deliver!(message)
+```
+
+If we are using `mail_plugger` gem in Ruby on Rails we don't have to do anything with this class. Rails will load this method automatically. Basically we should use `MailPlugger.plug_in` method to configure this delivery method.

data/docs/usage_of_mailgun_in_ruby_on_rails.md

@@ -0,0 +1,58 @@
+# How to use Mailgun with MailPlugger in Ruby on Rails
+
+**Please note that these examples were not tested, but I believe it should work.**
+
+Let's use mailer method which was defined [here](https://github.com/norbertszivos/mail_plugger/blob/main/docs/usage_in_ruby_on_rails.md).
+
+Add `mailgun-ruby` to the `Gemfile`.
+
+```ruby
+gem 'mailgun-ruby'
+```
+
+Then run `bundle install` command to deploy the gem.
+
+Change the API and `MailPlugger.plug_in` method in `config/initializers/mail_plugger.rb`.
+
+```ruby
+class MailgunApiClient
+  def initialize(options = {})
+    @settings = { api_key: ENV['MAILGUN_API_KEY'] }
+    @options = options
+  end
+
+  def deliver
+    Mailgun::Client.new(@settings[:api_key]).send_message('sending_domain.com', generate_mail_hash)
+  end
+
+  private
+
+  def generate_mail_hash
+    {
+      from: @options[:from].first,
+      to: @options[:to].join(','),
+      subject: @options[:subject],
+      text: @options[:text_part],
+      html: @options[:html_part]
+    }
+  end
+end
+
+MailPlugger.plug_in('mailgun') do |api|
+  api.delivery_options = %i[from to subject text_part html_part]
+  api.delivery_settings = { return_response: true }
+  api.client = MailgunApiClient
+end
+```
+
+Then modify the mailer method a little bit.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'mailgun'
+  end
+end
+```

data/docs/usage_of_mandrill_in_ruby_on_rails.md

@@ -0,0 +1,104 @@
+# How to use Mandrill with MailPlugger in Ruby on Rails
+
+**Please note that these examples were not tested, but I believe it should work.**
+
+Let's use mailer method which was defined [here](https://github.com/norbertszivos/mail_plugger/blob/main/docs/usage_in_ruby_on_rails.md).
+
+Add `mandrill-api-json` to the `Gemfile`.
+
+```ruby
+gem 'mandrill-api-json'
+```
+
+Then run `bundle install` command to deploy the gem.
+
+## Send
+
+Change the API and `MailPlugger.plug_in` method in `config/initializers/mail_plugger.rb`.
+
+```ruby
+class MandrillApiClient
+  def initialize(options = {})
+    @settings = { api_key: ENV['MANDRILL_API_KEY'] }
+    @options = options
+  end
+
+  def deliver
+    Mandrill::API.new(@settings[:api_key]).messages.send(generate_mail_hash)
+  end
+
+  private
+
+  def generate_mail_hash
+    {
+      from_email: @options[:from].first,
+      to: generate_recipients,
+      subject: @options[:subject],
+      text: @options[:text_part],
+      html: @options[:html_part],
+      tags: [@options[:tag]]
+    }
+  end
+
+  def generate_recipients
+    @options[:to].map do |to|
+      {
+        email: to
+      }
+    end
+  end
+end
+
+MailPlugger.plug_in('mandrill') do |api|
+  api.delivery_options = %i[from to subject text_part html_part tag]
+  api.delivery_settings = { return_response: true }
+  api.client = MandrillApiClient
+end
+```
+
+Then modify the mailer method a little bit.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'mandrill', tag: 'send_test'
+  end
+end
+```
+
+## Send Raw
+
+Change the API and `MailPlugger.plug_in` method in `config/initializers/mail_plugger.rb`.
+
+```ruby
+class MandrillApiClient
+  def initialize(options = {})
+    @settings = { api_key: ENV['MANDRILL_API_KEY'] }
+    @options = options
+  end
+
+  def deliver
+    Mandrill::API.new(@settings[:api_key]).messages.send_raw(@options[:message_obj].to_s)
+  end
+end
+
+MailPlugger.plug_in('mandrill') do |api|
+  api.delivery_options = %i[message_obj]
+  api.delivery_settings = { return_response: true }
+  api.client = MandrillApiClient
+end
+```
+
+Then modify the mailer method a little bit.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'mandrill'
+  end
+end
+```

data/docs/usage_of_more_delivery_system_in_ruby_on_rails.md

@@ -0,0 +1,332 @@
+# How to use more delivey systems in Ruby on Rails
+
+Let's modify the configuration which was defined [here](https://github.com/norbertszivos/mail_plugger/blob/main/docs/usage_in_ruby_on_rails.md).
+
+Add a new API Class in `config/initializers/mail_plugger.rb` (you can define it in another place just now it is esasier to do this).
+
+```ruby
+# NOTE: This is just an example for testing...
+class TestApiClientClass
+  def initialize(options = {})
+    @settings = { api_key: '12345' }
+    @options = options
+  end
+
+  def deliver
+    # e.g. API.new(@settings).client.post(generate_mail_hash)
+    puts " >>> settings: #{@settings.inspect}"
+    puts " >>> options: #{@options.inspect}"
+    puts " >>> generate_mail_hash: #{generate_mail_hash.inspect}"
+    { response: 'Message sent via API' }
+  end
+
+  private
+
+  def generate_mail_hash
+    {
+      to: generate_recipients,
+      from: {
+        email: @options[:from].first
+      },
+      subject: @options[:subject],
+      content: [
+        {
+          type: 'text/plain',
+          value: @options[:text_part]
+        },
+        {
+          type: 'text/html; charset=UTF-8',
+          value: @options[:html_part]
+        }
+      ]
+    }
+  end
+
+  def generate_recipients
+    @options[:to].map do |to|
+      {
+        email: to
+      }
+    end
+  end
+end
+
+class TestApi2ClientClass
+  def initialize(options = {})
+    @settings = { api_key: '54321' }
+    @options = options
+  end
+
+  def deliver
+    # e.g. API.new(@settings).client.post(generate_mail_hash)
+    puts " >>> settings: #{@settings.inspect}"
+    puts " >>> options: #{@options.inspect}"
+    puts " >>> generate_mail_hash: #{generate_mail_hash.inspect}"
+    { response: 'Message sent via API2' }
+  end
+
+  private
+
+  def generate_mail_hash
+    {
+      to: generate_recipients,
+      from: {
+        email: @options[:from].first
+      },
+      subject: @options[:subject],
+      content: [
+        {
+          type: 'text/plain',
+          value: @options[:text_part]
+        },
+        {
+          type: 'text/html; charset=UTF-8',
+          value: @options[:html_part]
+        }
+      ]
+    }
+  end
+
+  def generate_recipients
+    @options[:to].map do |to|
+      {
+        email: to
+      }
+    end
+  end
+end
+
+MailPlugger.plug_in('test_api_client') do |api|
+  api.delivery_options = %i[from to subject text_part html_part]
+  api.delivery_settings = { return_response: true }
+  api.client = TestApiClientClass
+end
+
+MailPlugger.plug_in('test_api2_client') do |api|
+  api.delivery_options = %i[from to subject text_part html_part]
+  api.delivery_settings = { return_response: true }
+  api.client = TestApi2ClientClass
+end
+```
+
+Then change `app/mailers/test_mailer.rb` file.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'test_api_client'
+  end
+
+  def send_test2
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'test_api2_client'
+  end
+end
+```
+
+Then we should add views of the second mailer method, so create `app/views/test_mailer/send_test2.html.erb`
+
+```erb
+<p>Test email body</p>
+```
+
+and `app/views/test_mailer/send_test2.text.erb`.
+
+```erb
+Test email body
+```
+
+In the `rails console` we can try it out.
+
+```ruby
+TestMailer.send_test.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+
+TestMailer.send_test2.deliver_now!
+#  Rendering test_mailer/send_test2.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test2.html.erb within layouts/mailer (2.6ms)
+#  Rendering test_mailer/send_test2.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test2.text.erb within layouts/mailer (0.4ms)
+#TestMailer#send_test2: processed outbound mail in 33.9ms
+# >>> settings: {:api_key=>"54321"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API2"}
+```
+
+In the `app/mailers/test_mailer.rb` file we can use the Rails default option as well to define `delivery_system`.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com', delivery_system: 'test_api_client'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com'
+  end
+
+  def send_test2
+    mail subject: 'Test email', to: 'to@example.com'
+  end
+end
+```
+
+In the `rails console` we can try it out.
+
+```ruby
+TestMailer.send_test.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+
+TestMailer.send_test2.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+```
+
+Or we can use default, but override it in the method.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com', delivery_system: 'test_api_client'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com'
+  end
+
+  def send_test2
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'test_api2_client'
+  end
+end
+```
+
+In the `rails console` we can try it out.
+
+```ruby
+TestMailer.send_test.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+
+TestMailer.send_test2.deliver_now!
+#  Rendering test_mailer/send_test2.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test2.html.erb within layouts/mailer (2.6ms)
+#  Rendering test_mailer/send_test2.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test2.text.erb within layouts/mailer (0.4ms)
+#TestMailer#send_test2: processed outbound mail in 33.9ms
+# >>> settings: {:api_key=>"54321"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API2"}
+```
+
+Or if we are not define any `delivey_system` then it will use the first defined one with `MailPlugger.plug_in` method.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com'
+  end
+
+  def send_test2
+    mail subject: 'Test email', to: 'to@example.com'
+  end
+end
+```
+
+In the `rails console` we can try it out.
+
+```ruby
+TestMailer.send_test.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+
+TestMailer.send_test2.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+```
+
+Or we can just define `delivery_system` where we would like to use the other one.
+
+```ruby
+class TestMailer < ApplicationMailer
+  default from: 'from@example.com'
+
+  def send_test
+    mail subject: 'Test email', to: 'to@example.com'
+  end
+
+  def send_test2
+    mail subject: 'Test email', to: 'to@example.com', delivery_system: 'test_api2_client'
+  end
+end
+```
+
+In the `rails console` we can try it out.
+
+```ruby
+TestMailer.send_test.deliver_now!
+#  Rendering test_mailer/send_test.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test.html.erb within layouts/mailer (1.0ms)
+#  Rendering test_mailer/send_test.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test.text.erb within layouts/mailer (0.3ms)
+#TestMailer#send_test: processed outbound mail in 46.1ms
+# >>> settings: {:api_key=>"12345"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API"}
+
+TestMailer.send_test2.deliver_now!
+#  Rendering test_mailer/send_test2.html.erb within layouts/mailer
+#  Rendered test_mailer/send_test2.html.erb within layouts/mailer (2.6ms)
+#  Rendering test_mailer/send_test2.text.erb within layouts/mailer
+#  Rendered test_mailer/send_test2.text.erb within layouts/mailer (0.4ms)
+#TestMailer#send_test2: processed outbound mail in 33.9ms
+# >>> settings: {:api_key=>"54321"}
+# >>> options: {"from"=>["from@example.com"], "to"=>["to@example.com"], "subject"=>"Test email", "text_part"=>"Test email body\n\n", "html_part"=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}
+# >>> generate_mail_hash: {:to=>[{:email=>"to@example.com"}], :from=>{:email=>"from@example.com"}, :subject=>"Test email", :content=>[{:type=>"text/plain", :value=>"Test email body\n\n"}, {:type=>"text/html; charset=UTF-8", :value=>"<!DOCTYPE html>\n<html>\n  <head>\n    <meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\" />\n    <style>\n      /* Email styles need to be inline */\n    </style>\n  </head>\n\n  <body>\n    <p>Test email body</p>\n\n  </body>\n</html>\n"}]}
+#=> {:response=>"Message sent via API2"}
+```