google-http-actionmailer 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4c49b1cf78e1d9525108d53bccf04f316115d289f0dbbf01d8e60da1916099a
-  data.tar.gz: a49d301415298d9d6680d2cc2041f4a7874a9e0bf073f90a47c0e9744fa2003c
+  metadata.gz: 5681fb59448881c9fd4872b3e63c5d0b23ab8f5c8f329c0558fd5860881456ec
+  data.tar.gz: 94601ff306b9a1af4610b71c0566c1365a2061ed6c494674940c7d2dd0e16566
 SHA512:
-  metadata.gz: 239cf6f032ba6ef893024d2fd90124055bdc36546dc943cc7ead7cb7188c9babf0ab16b5a5b00606a5efd4d338018753e84033244ec5c896b16cefe5f78abf59
-  data.tar.gz: fb64d96c1383a39487966d7f60bf17261944b4ae694b5b8f1900e254784a8e511f9542fb8c5941a9a66f94ae86f4ae396d2fbd33f7e41b6ed519716918585944
+  metadata.gz: 791f3bb2d5cd9e10b8d21b67618fdce58e7f11373cf33aa838f122296c09afd932445e8763259ea29a1360a88e715ace1a763971961b0723fbd83772a8e06264
+  data.tar.gz: 76ed809027807736bacce6d0dd14c3e3bfe370123c5b48e45df9d64a04ae63246feef6f731a83f905dbbe248bbc806956e0bc598413db296beb88793aa49a9a0

data/README.md

@@ -1,15 +1,13 @@
 # GoogleHttpActionmailer
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/google_http_actionmailer`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+An ActionMailer adapter to send email using Google's HTTPS Web API (instead of SMTP).
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'google_http_actionmailer'
+gem 'google-http-actionmailer'
 ```
 
 And then execute:
@@ -18,11 +16,43 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install google_http_actionmailer
+    $ gem install google-http-actionmailer
 
 ## Usage
 
-TODO: Write usage instructions here
+Set up your `authorization` as described in the [Google API Client](https://github.com/google/google-api-ruby-client/#authorization) (the easiest method is to pass a valid access token), edit `config/application.rb` or `config/environments/$ENVIRONMENT.rb` and add/change the following to the ActionMailer configuration:
+
+```ruby
+config.action_mailer.delivery_method = :google_http_actionmailer
+config.action_mailer.google_http_actionmailer_settings = {
+  authorization: ...,
+  client_options: {
+    application_name: ...,
+    application_version: ...,
+  },
+  request_options: {
+    retries: ...,
+    header: ...,
+  },
+  message_options: {
+    fields: ...,
+    content_type: ...,
+  }
+}
+```
+
+For client and request options, you can look [here](https://github.com/google/google-api-ruby-client/blob/master/lib/google/apis/options.rb). And for message options, you can look at the `send_user_message` method [here](https://github.com/google/google-api-ruby-client/blob/master/generated/google/apis/gmail_v1/service.rb#L1150).
+
+For dynamic setting of delivery method (this may be required given the access tokens usually expire):
+
+```ruby
+mail.delivery_method(
+  GoogleHttpActionmailer::DeliveryMethod, {
+  authorization: ...
+})
+```
+
+Normal ActionMailer usage will now transparently be sent using Google's HTTPS API.
 
 ## Development
 

data/lib/google_http_actionmailer/version.rb

@@ -1,3 +1,3 @@
 module GoogleHttpActionmailer
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/google_http_actionmailer.rb

@@ -9,6 +9,7 @@ module GoogleHttpActionmailer
   class DeliveryMethod
     attr_reader :service
     attr_reader :message_options
+    attr_reader :delivery_options
 
     def initialize(params)
       @service = Google::Apis::GmailV1::GmailService.new
@@ -26,6 +27,7 @@ module GoogleHttpActionmailer
       end
 
       @message_options = params[:message_options] || {}
+      @delivery_options = params[:delivery_options] || {}
     end
 
     def deliver!(mail)
@@ -35,7 +37,21 @@ module GoogleHttpActionmailer
         thread_id: mail['Thread-ID']
       )
 
-      service.send_user_message(user_id, message, message_options)
+      before_send = delivery_options[:before_send]
+      if before_send && before_send.respond_to?(:call)
+        before_send.call(mail, message)
+      end
+
+      message = service.send_user_message(
+        user_id,
+        message,
+        message_options
+      )
+
+      after_send = delivery_options[:after_send]
+      if after_send && after_send.respond_to?(:call)
+        after_send.call(mail, message)
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-http-actionmailer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kartik Luke Singh
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-04-19 00:00:00.000000000 Z
+date: 2018-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mail