postmortem 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 396ef931001e6084271eb46994b2f9ec65daa948f544cf75306e28c0aab1c6df
-  data.tar.gz: 851cd36f02f31b91152ffbcc7cad143c911078ac9f5dd991f9345f23728030d2
+  metadata.gz: 7d675b984abb71e212b6c7f3e190c9bf8d17282ed0741b260cf06891cff5b70d
+  data.tar.gz: 408e888943fe644d76b686d3693588378c513138ea88d82da633bf0c2367f19e
 SHA512:
-  metadata.gz: 42a525ba6a1d6744177591da24b03585daab8476945dbbbfa7d3f6b3cc8202db19804507e40e5415b05c2edb8eefa793a9f7eb710094595b47d832b169f7055a
-  data.tar.gz: 7e8386b1af03787689640fb5ad812fadbe3e04429471c17f166220bfc6f6e57b18bc7eb8f722b9dd22d6031cae892c846941e48b9881fc5214c6f6332849c373
+  metadata.gz: c6cddb8f06e21fd028b7531d79efabf8320e86a22670cfed45901b189d563249cd1a420859ff8cbf1a7a542a15d8c908018a6fb8477ec023407997e7d51338e9
+  data.tar.gz: cfda5e45b5302a36cbd7503b418142c13f5c0e458ca0ba1e705503513b9549e5c41d440af485bade2db280a1890fffef5df33bfd487250e38762ee7a811b4992

data/.gitignore

@@ -2,7 +2,6 @@
 /.yardoc
 /_yardoc/
 /coverage/
-/doc/
 /pkg/
 /spec/reports/
 /tmp/
@@ -10,3 +9,5 @@
 # rspec failure tracking
 .rspec_status
 *.gem
+
+Gemfile.lock

data/.rubocop.yml

@@ -1,6 +1,7 @@
 Metrics/BlockLength:
   Exclude:
     - 'spec/**/*_spec.rb'
+    - 'postmortem.gemspec'
 
 Layout/EmptyLinesAroundAttributeAccessor:
   Enabled: true

data/README.md

@@ -1,15 +1,29 @@
 # Postmortem
 
-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/postmortem`. To experiment with that code, run `bin/console` for an interactive prompt.
+_Postmortem_ provides a simple and clean preview of all outgoing mails sent by your _Ruby_ application to make email development a little less painful.
 
-TODO: Delete this and the text above, and describe your gem
+Every time your application sends an email a clearly-visible log entry will be written which provides a path to a temporary file containing your preview.
+
+Take a look at a [live example](https://postmortem.surge.sh/) to see _Postmortem_ in action.
+
+_Postmortem_ should only be enabled in test or development environments.
+
+## Features
+
+* Seamless integration with [_ActionMailer_](https://guides.rubyonrails.org/action_mailer_basics.html) and [_Pony_](https://github.com/benprew/pony) (with automatic delivery skipping when using _Pony_).
+* Preview email content as well as typical email headers (recipients, subject, etc.).
+* View rendered _HTML_, plaintext, or _HTML_ source with syntax highlighting (courtesy of [highlight.js](https://highlightjs.org/)).
+* Dual or single column view to suit your requirements.
+* Content is loaded inside an `<iframe>` to ensure document isolation and validity.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add the gem to your application's Gemfile:
 
 ```ruby
-gem 'postmortem'
+group :development, :test do
+  gem 'postmortem', '~> 0.1.1'
+end
 ```
 
 And then execute:
@@ -22,18 +36,58 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+_Postmortem_ automatically integrates with _Rails ActionMailer_ and  _Pony_. When an email is sent an entry will be visible in your application's log output.
+
+The path to the preview file is based on the current time and the subject of the email. If you would prefer to use the same path for each email you can disable timestamps (see [configuration](#configuration)) and simply reload your browser every time an email is sent.
 
-## Development
+If you are using assets (images etc.) with _ActionMailer_ make sure to configure the asset host, e.g.:
 
-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.
+```ruby
+# config/environments/development.rb
+Rails.application.configure do
+  config.action_mailer.asset_host = 'http://localhost:3000'
+end
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then 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](https://rubygems.org).
+Load the provided file in your browser to preview your email.
 
-## Contributing
+![Screenshot](doc/screenshot.png)
+
+
+## Configuration
+<a name="configuration"></a>
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/postmortem.
+Configure _Postmortem_ by calling `Postmortem.configure`, e.g. in a _Rails_ initializer.
+
+```ruby
+# config/initializers/postmortem.rb
+Postmortem.configure do |config|
+  # Colorize output in logs (path to preview HTML file) to improve visibility (default: true).
+  config.colorize = true
+
+  # Prefix all preview filenames with a timestamp (default: true).
+  # Setting to false allows refreshing the same path in your browser to view the latest version.
+  config.timestmap = true
+
+  # Path to the Postmortem log file, where preview paths are written (default: STDOUT).
+  config.log_path = '/path/to/postmortem.log'
+
+  # Path to save preview .html files (default: OS-provided temp directory).
+  # The directory will be created if it does not exist.
+  config.preview_directory = '/path/to/postmortem/directory'
+
+  # Provide a custom layout path if the default interface does not suit you.
+  # See `layout/default.html.erb` for implementation reference.
+  config.layout = '/path/to/layout'
+
+  # Skip delivery of emails when using Pony (default: true).
+  config.pony_skip_delivery = true
+end
+```
+
+## Contributing
 
+Feel free to make a pull request.
 
 ## License
 

data/layout/default.html.erb

@@ -1,49 +1,290 @@
 <html>
   <head>
-  <link rel="stylesheet"
-        href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css"
-        integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh"
-        crossorigin="anonymous">
+    <link rel="stylesheet"
+          href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css"
+          integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh"
+          crossorigin="anonymous" />
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css"
+          rel="stylesheet" />
+    <link rel="stylesheet"
+          href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.18.3/styles/a11y-light.min.css"
+          integrity="sha512-zqEpZCxg7IVhGXy6EwdTb26cHl8IZzN/29Mj2/oSzkCKiLxHTi491mcC/K1NhShMWXu+WvfU5Z261XPc60lw7g=="
+          crossorigin="anonymous" />
+    <style>
+      .headers {
+        height: 100%;
+        max-width: 35rem;
+        display: none;
+      }
+
+      .content {
+        background-color: #efefef;
+        padding: 1rem 2rem;
+        height: 100%;
+      }
+
+      .headers table {
+        background-color: #fff;
+      }
+
+      .preview {
+        display: none;
+        background-color: #fff;
+        padding: 2rem;
+        height: 100%;
+      }
+
+      .preview.source-view {
+        padding: 1.5rem;
+      }
+
+      .preview iframe {
+        border-style: none;
+        width: 100%;
+        height: 100%;
+      }
+
+      .main-row {
+        height: 100%;
+      }
+
+      .container {
+         height: 90vh;
+         margin-top: 2.8rem;
+      }
+
+      .container.full-width {
+         max-width: 100%;
+      }
+
+      .visible {
+        display: block;
+      }
+
+      .toolbar {
+         background-color: #fff;
+         text-align: right;
+         padding: 0.5rem 1rem;
+         position: fixed;
+         width: 100%;
+      }
+
+      .toolbar i {
+        font-size: 1.2rem;
+        cursor: pointer;
+        margin: 0 0.2rem;
+      }
+
+      .toolbar i.disabled {
+        cursor: default;
+        color: #ddd !important;
+      }
+
+      .toolbar .separator {
+        border-right: 1px solid #ccc;
+        margin-right: 0.5rem;
+        margin-left: 0.2rem;
+      }
+    </style>
   </head>
-  <body style="background-color: #efefef; padding: 2rem; height: 100%">
-    <div style="height: 100%; display: flex; flex-direction: column">
-    <table class="table table-hover table-bordered" style="background-color: #fff">
-      <tbody>
-        <tr>
-          <th style="width: 7rem;">From:</th>
-          <td><%= mail.from&.join(', ') %></td>
-        </tr>
-
-        <tr>
-          <th>To:</th>
-          <td><%= mail.to&.join(', ') %></td>
-        </tr>
-
-        <tr>
-          <th>Cc:</th>
-          <td><%= mail.cc&.join(', ') %></td>
-        </tr>
-
-        <tr>
-          <th>Bcc:</th>
-          <td><%= mail.bcc&.join(', ') %></td>
-        </tr>
-
-        <tr>
-          <th>Subject:</th>
-          <td><%= mail.subject %></td>
-        </tr>
-      </tbody>
-    </table>
-
-    <div style="background-color: #ffffff; padding: 2rem; height: 100%; flex-grow: 1">
-      <iframe id="mail-iframe" src="" style="border-style: none; width: 100%; height: 100%"></iframe>
+  <body>
+    <div class="toolbar">
+
+      <i data-toggle="tooltip"
+         title="<%= mail.html_body.nil? ? 'View HTML Part (Unavailable)' : 'View HTML Part' %>"
+         class="fa fa-code html-view-switch"></i>
+
+      <i data-toggle="tooltip"
+         title="<%= mail.html_body.nil? ? 'View HTML Source (Unavailable)' : 'View HTML Source' %>"
+         class="fa fa-file-code-o source-view-switch"></i>
+
+      <i data-toggle="tooltip"
+         title="<%= mail.text_body.nil? ? 'View Plaintext Part (Unavailable)' : 'View Plaintext Part' %>"
+         class="fa fa-file-text-o text-view-switch"></i>
+
+      <span class="separator"></span>
+
+      <i data-toggle="tooltip"
+         title="Toggle Email Headers"
+         class="fa fa-columns column-switch"></i>
+
     </div>
+    <div class="content">
+      <div class="container full-width">
+        <div class="row main-row">
+          <div class="col headers visible">
+            <table class="table table-hover table table-bordered">
+              <tbody>
+                <tr>
+                  <th>Subject:</th>
+                  <td><%= mail.subject %></td>
+                </tr>
+
+                <tr>
+                  <th style="width: 7rem;">From:</th>
+                  <td><%= format_email_array(mail.from) %></td>
+                </tr>
+
+                <tr>
+                  <th>Reply-To:</th>
+                  <td><%= format_email_array(mail.reply_to) %></td>
+                </tr>
+
+                <tr>
+                  <th>To:</th>
+                  <td><%= format_email_array(mail.to) %></td>
+                </tr>
+
+                <tr>
+                  <th>Cc:</th>
+                  <td><%= format_email_array(mail.cc) %></td>
+                </tr>
+
+                <tr>
+                  <th>Bcc:</th>
+                  <td><%= format_email_array(mail.bcc) %></td>
+                </tr>
+              </tbody>
+            </table>
+          </div>
+          <div class="preview col html-view">
+            <iframe id="html-iframe"></iframe>
+          </div>
+          <div class="preview col text-view">
+            <iframe id="text-iframe"></iframe>
+          </div>
+          <div class="preview col source-view">
+            <iframe id="source-iframe"></iframe>
+          </div>
+        </div>
+      </div>
+    </div>
+    <script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"
+            integrity="sha384-DfXdz2htPH0lsSSs5nCTpuj/zy4C+OGpamoFVy38MVBnE+IbbVYUew+OrCXaRkfj"
+            crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.1/dist/umd/popper.min.js"
+            integrity="sha384-9/reFTGAW83EW2RDu2S0VKaIzap3H66lZH81PoYlFhbGU+6BZp6G7niu735Sk7lN"
+            crossorigin="anonymous"></script>
+    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js"
+            integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV"
+            crossorigin="anonymous"></script>
     <script>
-      var mailContent = <%= mail.html_body.to_json %>;
-      var iframeDocument = document.querySelector("#mail-iframe").contentDocument;
-      iframeDocument.write(mailContent);
-      iframeDocument.close();
+      (function () {
+        var htmlIframeDocument = document.querySelector("#html-iframe").contentDocument;
+        htmlIframeDocument.write(<%= mail.html_body.to_json %>);
+        htmlIframeDocument.close();
+
+        var textIframeDocument = document.querySelector("#text-iframe").contentDocument;
+        textIframeDocument.write('<pre>' + <%= ERB::Util.html_escape(mail.text_body).to_json %> + '</pre>');
+        textIframeDocument.close();
+
+        var sourceHighlightBundle = [
+           '<link rel="stylesheet"',
+           '     href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.18.3/styles/agate.min.css"',
+           '     integrity="sha512-mMMMPADD4HAIogAWZbv+WjZTC0itafUZNI0jQm48PMBTApXt11omF5jhS7U1kp3R2Pr6oGJ+JwQKiUkUwCQaUQ=="',
+           '     crossorigin="anonymous" />',
+           '<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.18.3/highlight.min.js"',
+           '        integrity="sha512-tHQeqtcNWlZtEh8As/4MmZ5qpy0wj04svWFK7MIzLmUVIzaHXS8eod9OmHxyBL1UET5Rchvw7Ih4ZDv5JojZww=="',
+           '        crossorigin="anonymous"></' + 'script>',
+           '<script>hljs.initHighlightingOnLoad();</' + 'script>',
+        ].join('\n');
+
+        var sourceIframeDocument = document.querySelector("#source-iframe").contentDocument;
+        sourceIframeDocument.write('<pre><code style="padding: 1rem;" class="language-html">' + <%= ERB::Util.html_escape(mail.html_body).to_json %> + '</code></pre>');
+        sourceIframeDocument.write(sourceHighlightBundle);
+        sourceIframeDocument.close();
+
+        var twoColumnView;
+        var hasHtml = <%= (!mail.html_body.nil?).to_json %>;
+        var hasText = <%= (!mail.text_body.nil?).to_json %>;
+        var headers = document.querySelector('.headers');
+        var columnSwitch = document.querySelector('.column-switch');
+
+        var setColumnView = function (enableTwoColumnView) {
+          var container = document.querySelector('.container');
+          twoColumnView = enableTwoColumnView;
+          if (twoColumnView) {
+            setVisible(headers, true);
+            setOn(columnSwitch);
+            container.classList.add('full-width');
+          } else {
+            setVisible(headers, false);
+            setOff(columnSwitch);
+            container.classList.remove('full-width');
+          }
+        };
+
+        var contexts = ['source', 'text', 'html'];
+
+        var views = {
+          source: document.querySelector('.source-view'),
+          html: document.querySelector('.html-view'),
+          text: document.querySelector('.text-view'),
+        };
+
+        var toolbar = {
+          source: document.querySelector('.source-view-switch'),
+          html: document.querySelector('.html-view-switch'),
+          text: document.querySelector('.text-view-switch'),
+        };
+
+        var setOn = function(element) {
+          element.classList.add('text-primary');
+          element.classList.remove('text-secondary');
+        };
+
+        var setOff = function(element) {
+          element.classList.add('text-secondary');
+          element.classList.remove('text-primary');
+        };
+
+        var setDisabled = function(element) {
+          element.classList.add('disabled');
+          element.classList.remove('text-secondary');
+          element.onclick = function () {};
+        };
+
+        var setVisible = function(element, visible) {
+          if (visible) {
+            element.classList.add('visible');
+          } else {
+            element.classList.remove('visible');
+          }
+        };
+
+        var setView = function(context) {
+          var key;
+          for (i = 0; i < contexts.length; i++) {
+            key = contexts[i];
+            if (key === context) {
+              setOn(toolbar[key]);
+              setVisible(views[key], true);
+            } else {
+              setOff(toolbar[key]);
+              setVisible(views[key], false);
+            }
+          }
+        };
+
+        toolbar.html.onclick   = function () { setView('html'); };
+        toolbar.text.onclick   = function () { setView('text'); };
+        toolbar.source.onclick = function () { setView('source'); };
+        columnSwitch.onclick   = function () { setColumnView(!twoColumnView); };
+
+        if (!hasText) setDisabled(toolbar.text);
+
+        if (hasHtml) {
+          setView('html');
+        } else {
+          setDisabled(toolbar.html);
+          setDisabled(toolbar.source);
+          setView('text');
+        }
+
+        setColumnView(true);
+
+        $('[data-toggle="tooltip"]').tooltip();
+      })();
     </script>
   </body>
 </html>

data/lib/postmortem.rb

@@ -7,27 +7,20 @@ require 'fileutils'
 require 'mail'
 require 'erb'
 require 'json'
+require 'cgi'
 
 require 'postmortem/version'
 require 'postmortem/adapters'
 require 'postmortem/delivery'
 require 'postmortem/layout'
+require 'postmortem/configuration'
 
 # HTML email inspection tool.
 module Postmortem
   class Error < StandardError; end
 
   class << self
-    attr_reader :output_directory, :layout
-    attr_accessor :output_file
-
-    def output_directory=(val)
-      @output_directory = Pathname.new(val)
-    end
-
-    def layout=(val)
-      @layout = Pathname.new(val)
-    end
+    attr_reader :config
 
     def record_delivery(mail)
       Delivery.new(mail)
@@ -35,15 +28,20 @@ module Postmortem
               .tap { |delivery| log_delivery(delivery) }
     end
 
-    def try_load(*args)
+    def try_load(*args, plugin:)
       args.each { |arg| require arg }
     rescue LoadError
       false
     else
-      yield
+      require "postmortem/plugins/#{plugin}"
       true
     end
 
+    def configure
+      @config = Configuration.new
+      yield @config if block_given?
+    end
+
     private
 
     def log_delivery(delivery)
@@ -52,14 +50,19 @@ module Postmortem
     end
 
     def colorized(val)
-      return val unless output_file.tty?
+      return val unless output_file.tty? || !config.colorize
 
       "\e[34m[postmortem]\e[36m #{val}\e[0m"
     end
+
+    def output_file
+      return STDOUT if config.log_path.nil?
+
+      @output_file ||= File.open(config.log_path, mode: 'a')
+    end
   end
 end
 
-Postmortem.output_directory = File.join(Dir.tmpdir, 'postmortem')
-Postmortem.output_file = STDOUT
-Postmortem.layout = File.expand_path(File.join(__dir__, '..', 'layout', 'default.html.erb'))
-Postmortem.try_load('action_mailer', 'active_support') { require 'postmortem/action_mailer' }
+Postmortem.configure
+Postmortem.try_load('action_mailer', 'active_support', plugin: 'action_mailer')
+Postmortem.try_load('pony', plugin: 'pony')

data/lib/postmortem/adapters.rb

@@ -2,6 +2,7 @@
 
 require 'postmortem/adapters/base'
 require 'postmortem/adapters/action_mailer'
+require 'postmortem/adapters/pony'
 
 module Postmortem
   # Adapters for various email senders (e.g. ActionMailer).

data/lib/postmortem/adapters/action_mailer.rb

@@ -6,16 +6,55 @@ module Postmortem
     class ActionMailer < Base
       private
 
-      def adapted(data)
+      def adapted
         {
-          from: data[:from],
-          to: data[:to],
-          cc: data[:cc],
-          bcc: data[:bcc],
-          subject: data[:subject],
-          html_body: Mail.new(data[:mail]).html_part.decoded.strip
+          from: mail.from,
+          reply_to: mail.reply_to,
+          to: mail.to,
+          cc: mail.cc,
+          bcc: normalized_bcc,
+          subject: mail.subject,
+          text_body: text_part,
+          html_body: html_part
         }
       end
+
+      def text_part
+        return nil unless text?
+        return mail.body.decoded unless mail.text_part
+
+        mail.text_part.decoded
+      end
+
+      def html_part
+        return nil unless html?
+        return mail.body.decoded unless mail.html_part
+
+        mail.html_part.decoded
+      end
+
+      def mail
+        @mail ||= Mail.new(@data[:mail])
+      end
+
+      def normalized_bcc
+        Mail.new(to: @data[:bcc]).to
+      end
+
+      def text?
+        return true unless mail.has_content_type?
+        return true if mail.content_type.include?('text/plain')
+        return true if mail.multipart? && mail.text_part
+
+        false
+      end
+
+      def html?
+        return true if mail.has_content_type? && mail.content_type.include?('text/html')
+        return true if mail.multipart? && mail.html_part
+
+        false
+      end
     end
   end
 end

data/lib/postmortem/adapters/base.rb

@@ -5,20 +5,20 @@ module Postmortem
     # Base interface implementation for all Postmortem adapters.
     class Base
       def initialize(data)
-        @mail = adapted(data)
+        @data = data
+        @adapted = adapted
       end
 
-      %i[from to cc bcc subject html_body].each do |method_name|
+      %i[from reply_to to cc bcc subject text_body html_body].each do |method_name|
         define_method method_name do
-          @mail[method_name]
+          @adapted[method_name]
         end
       end
 
       private
 
-      def adapted(_data)
-        raise NotImplementedError,
-              'Adapter must be a child class of Base which implements #adapted'
+      def adapted
+        raise NotImplementedError, 'Adapter child class must implement #adapted'
       end
     end
   end

data/lib/postmortem/adapters/pony.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Postmortem
+  module Adapters
+    # Pony adapter.
+    class Pony < Base
+      private
+
+      def adapted
+        {
+          from: mail.from,
+          reply_to: mail.reply_to,
+          to: mail.to,
+          cc: mail.cc,
+          bcc: mail.bcc,
+          subject: mail.subject,
+          text_body: @data[:body],
+          html_body: @data[:html_body]
+        }
+      end
+
+      def mail
+        @mail ||= Mail.new(@data.select { |key| keys.include?(key) })
+      end
+
+      def keys
+        %i[from reply_to to cc bcc subject text_body html_body]
+      end
+    end
+  end
+end

data/lib/postmortem/configuration.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Postmortem
+  # Provides interface for configuring Postmortem and implements sensible defaults.
+  class Configuration
+    attr_writer :colorize, :timestamp, :pony_skip_delivery
+    attr_accessor :log_path
+
+    def timestamp
+      defined?(@timestamp) ? @timestamp : true
+    end
+
+    def colorize
+      defined?(@colorize) ? @colorize : true
+    end
+
+    def preview_directory=(val)
+      @preview_directory = Pathname.new(val)
+    end
+
+    def layout=(val)
+      @layout = Pathname.new(val)
+    end
+
+    def layout
+      default = File.expand_path(File.join(__dir__, '..', '..', 'layout', 'default'))
+      path = Pathname.new(@layout || default)
+      path.extname.empty? ? path.sub_ext('.html.erb') : path
+    end
+
+    def preview_directory
+      @preview_directory ||= Pathname.new(File.join(Dir.tmpdir, 'postmortem'))
+    end
+
+    def pony_skip_delivery
+      defined?(@pony_skip_delivery) ? @pony_skip_delivery : true
+    end
+  end
+end

data/lib/postmortem/delivery.rb

@@ -7,7 +7,7 @@ module Postmortem
 
     def initialize(adapter)
       @adapter = adapter
-      @path = Postmortem.output_directory.join(filename)
+      @path = Postmortem.config.preview_directory.join(filename)
     end
 
     def record
@@ -18,6 +18,8 @@ module Postmortem
     private
 
     def filename
+      return "#{safe_subject}.html" unless Postmortem.config.timestamp
+
       "#{timestamp}__#{safe_subject}.html"
     end
 
@@ -26,7 +28,7 @@ module Postmortem
     end
 
     def safe_subject
-      return 'no-subject' if @adapter.subject.empty?
+      return 'no-subject' if @adapter.subject.nil? || @adapter.subject.empty?
 
       @adapter.subject.tr(' ', '_').split('').select { |char| safe_chars.include?(char) }.join
     end

data/lib/postmortem/layout.rb

@@ -7,9 +7,13 @@ module Postmortem
       @adapter = adapter
     end
 
+    def format_email_array(array)
+      array&.map { |email| %(<a href="mailto:#{email}">#{email}</a>) }&.join(', ')
+    end
+
     def content
       mail = @adapter
-      ERB.new(Postmortem.layout.read).result(binding)
+      ERB.new(Postmortem.config.layout.read).result(binding)
     end
   end
 end

data/lib/postmortem/plugins/pony.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Pony monkey-patch.
+module Pony
+  class << self
+    alias _pony_mail mail
+
+    def mail(options)
+      result = _pony_mail(options) unless Postmortem.config.pony_skip_delivery
+      Postmortem.record_delivery(Postmortem::Adapters::Pony.new(options))
+      result
+    end
+  end
+end

data/lib/postmortem/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Postmortem
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/postmortem.gemspec

@@ -28,6 +28,7 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'mail', '~> 2.7'
 
   spec.add_development_dependency 'actionmailer', '~> 6.0'
+  spec.add_development_dependency 'pony', '~> 1.13'
   spec.add_development_dependency 'rspec', '~> 3.9'
   spec.add_development_dependency 'rspec-its', '~> 1.3'
   spec.add_development_dependency 'rubocop', '~> 0.88.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: postmortem
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Bob Farrell
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-15 00:00:00.000000000 Z
+date: 2020-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mail
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: pony
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -119,21 +133,24 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - Makefile
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
+- doc/screenshot.png
 - layout/default.html.erb
 - lib/postmortem.rb
-- lib/postmortem/action_mailer.rb
 - lib/postmortem/adapters.rb
 - lib/postmortem/adapters/action_mailer.rb
 - lib/postmortem/adapters/base.rb
+- lib/postmortem/adapters/pony.rb
+- lib/postmortem/configuration.rb
 - lib/postmortem/delivery.rb
 - lib/postmortem/layout.rb
+- lib/postmortem/plugins/action_mailer.rb
+- lib/postmortem/plugins/pony.rb
 - lib/postmortem/version.rb
 - postmortem.gemspec
 homepage: https://github.com/bobf/postmortem

data/Gemfile.lock

@@ -1,126 +0,0 @@
-PATH
-  remote: .
-  specs:
-    postmortem (0.1.0)
-      mail (~> 2.7)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    actionmailer (6.0.3.2)
-      actionpack (= 6.0.3.2)
-      actionview (= 6.0.3.2)
-      activejob (= 6.0.3.2)
-      mail (~> 2.5, >= 2.5.4)
-      rails-dom-testing (~> 2.0)
-    actionpack (6.0.3.2)
-      actionview (= 6.0.3.2)
-      activesupport (= 6.0.3.2)
-      rack (~> 2.0, >= 2.0.8)
-      rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actionview (6.0.3.2)
-      activesupport (= 6.0.3.2)
-      builder (~> 3.1)
-      erubi (~> 1.4)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (6.0.3.2)
-      activesupport (= 6.0.3.2)
-      globalid (>= 0.3.6)
-    activesupport (6.0.3.2)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
-    ast (2.4.1)
-    builder (3.2.4)
-    concurrent-ruby (1.1.7)
-    crass (1.0.6)
-    devpack (0.2.1)
-    diff-lcs (1.4.4)
-    erubi (1.9.0)
-    globalid (0.4.2)
-      activesupport (>= 4.2.0)
-    i18n (1.8.5)
-      concurrent-ruby (~> 1.0)
-    loofah (2.6.0)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.5.9)
-    mail (2.7.1)
-      mini_mime (>= 0.1.1)
-    mini_mime (1.0.2)
-    mini_portile2 (2.4.0)
-    minitest (5.14.1)
-    nokogiri (1.10.10)
-      mini_portile2 (~> 2.4.0)
-    paint (2.2.0)
-    parallel (1.19.2)
-    parser (2.7.1.4)
-      ast (~> 2.4.1)
-    rack (2.2.3)
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    rails-dom-testing (2.0.3)
-      activesupport (>= 4.2.0)
-      nokogiri (>= 1.6)
-    rails-html-sanitizer (1.3.0)
-      loofah (~> 2.3)
-    rainbow (3.0.0)
-    regexp_parser (1.7.1)
-    rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-its (1.3.0)
-      rspec-core (>= 3.0.0)
-      rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.9.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    rubocop (0.88.0)
-      parallel (~> 1.10)
-      parser (>= 2.7.1.1)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.7)
-      rexml
-      rubocop-ast (>= 0.1.0, < 1.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (0.3.0)
-      parser (>= 2.7.1.4)
-    ruby-progressbar (1.10.1)
-    strong_versions (0.4.5)
-      i18n (>= 0.5)
-      paint (~> 2.0)
-    thread_safe (0.3.6)
-    timecop (0.9.1)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
-    unicode-display_width (1.7.0)
-    zeitwerk (2.4.0)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  actionmailer (~> 6.0)
-  devpack (~> 0.2.0)
-  postmortem!
-  rspec (~> 3.9)
-  rspec-its (~> 1.3)
-  rubocop (~> 0.88.0)
-  strong_versions (~> 0.4.5)
-  timecop (~> 0.9.1)
-
-BUNDLED WITH
-   2.1.4