mailgun-api-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 80262a1aa9a30a3eaea8981ac574ed01b996f5b9
+  data.tar.gz: 28b491ff33c0e541026bfc2252bb71957b4dc311
+SHA512:
+  metadata.gz: a59ebfcd73f2c1d7a95d3d0756682035f8880acdb30603abf346bc208b59108f21d72968b0aba0f1c27abd3dde9212ea76c7f0362e8c6ec767612e0e97bcdec7
+  data.tar.gz: 1d7ca1b3279883064bb950f819366fdaa22d15d367aacc72d7e28a3d87a9732f6a494c64509939f89acc786839629eb00034d305923450eba99c2903e4d77bc5

data/README.md

@@ -0,0 +1,31 @@
+# Mailgun API Action Mailer Adapter
+A simple [Mailgun](https://mailgun.com) API [Action Mailer](https://github.com/rails/rails/tree/master/actionmailer) adapter.
+
+The alternatives try to recreate `The Matrix`, while others just utilize the `config.action_mailer.delivery_method = :smtp`. Why make a `gem` for that? Here is what Mailgun says ["Send with SMTP or API"](https://documentation.mailgun.com/quickstart-sending.html#send-with-smtp-or-api).
+
+## Install
+
+Plop the gem into your `Gemfile`.
+```
+gem 'mailgun-api-rails'
+```
+
+Run the `bundle` command.
+```
+$ bundle
+```
+
+Set the `delivery_method` to `:mailgun` in `config/application.rb` or your environment specific configuration. When it comes to the `mailgun_settings`, I just map them from my `.env` file
+```
+config.action_mailer.delivery_method = :mailgun
+
+## Settings
+config.action_mailer.mailgun_settings = {
+  domain:       ENV['MAILGUN_DOMAIN'],
+  api_key:      ENV['MAILGUN_API_KEY'],       
+  api_base_url: ENV['MAILGUN_API_BASE_URL']   ## api.mailgun.net/v3
+}
+```
+
+Boom. Done. Works with `devise_mail` as well.
+

data/lib/mailgun-api-rails.rb

@@ -0,0 +1,3 @@
+require 'action_mailer'
+Dir["#{File.dirname(__FILE__)}/mailgun-api-rails/*.rb"].each{|file| require file}
+module MailgunApiRails end

data/lib/mailgun-api-rails/delivery.rb

@@ -0,0 +1,41 @@
+require 'rest_client'
+
+module MailgunApiRails
+  class Delivery
+    attr_accessor :settings
+
+    def initialize(settings)
+      self.settings = settings
+    end
+
+    ## Config options
+    def sender
+      self.settings[:sender]
+    end
+
+    def domain
+      self.settings[:domain]
+    end
+
+    def api_key
+      self.settings[:api_key]
+    end
+
+    def api_base_url
+      self.settings[:api_base_url]
+    end
+
+    ## Action mailer call
+    def deliver!(mail)
+      ## Map mail values to Mailgun request
+      RestClient.post "https://api:#{api_key}@#{api_base_url}/#{domain}/messages",
+        from:    mail.from,
+        to:      mail.to,
+        subject: mail.subject,
+        text:    mail.multipart? ? (mail.text_part ? mail.text_part.body.decoded : nil) : mail.body.decoded,
+        html:    mail.body.decoded
+    end
+  end
+end
+
+ActionMailer::Base.add_delivery_method :mailgun, MailgunApiRails::Delivery

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: mailgun-api-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Thomas Mulloy
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionmailer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Mailgun API adapter for Action Mailer
+email: thomas@shoppu.us
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/mailgun-api-rails.rb
+- lib/mailgun-api-rails/delivery.rb
+homepage: https://github.com/shoppu/mailgun-api-rails
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- none
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Better Mailgun API adapter for Action Mailer
+test_files: []