0.0
The project is in a healthy, maintained state
MailPlugger helps you to use one or more mail providers. You can send emails via SMTP and API as well.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

~> 2.5
~> 0.3
 Project Readme

MilPlugger

Gem Version MIT license Ruby Style Guide MailPlugger CI Maintainability Code Coverage

MailPlugger helps you to use one or more mail providers. You can send emails via SMTP and API as well.

Also, it can help:

  • move between mail providers
  • load balancing
  • cost management

Installation

Add this line to your application's Gemfile:

gem 'mail_plugger'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install mail_plugger

Documentation

What is MailPlugger?

It is a Ruby library that provides a specialized mail delivery method with various configuration options. It can be utilized with Ruby on Rails as well as other solutions.

Why should I use MailPlugger?

  • It supports more mail providers.
  • It has built-in sending strategies, such as plugged_in_first, random, and round_robin, which are useful if you have multiple mail providers.
  • Your code for the mailers can remain simple and clean.
  • Switching mail providers can be a quick and easy process.

How Tos

FkePlugger

FakePlugger is a delivery method to mock MailPlugger. It works similarly to MailPlugger, but it won't send any emails (if we would like to, it is possible to send the email, but we should do it manually). Also, it can write out debug information, or we can manipulate the response with it. Another option that we can use MailGrabber web interface if the delivery method is :fake_plugger.

Documentation

How Tos

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

To release a new version:

  • Update CHANGELOG.md
  • Update the version number in version.rb manually or use the gem-release gem and run gem bump -v major|minor|patch|rc|beta.
  • Build gem with bundle exec rake build.
  • Run bundle install and bundle exec appraisal install to update gemfiles and commit the changes.
  • Run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome. Please read CONTRIBUTING.md if you would like to contribute to this project.

Inspiration

License

The gem is available as open source under the terms of the MIT License.