cells-mailer 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 992d44f718d8090f5a9e0dbfd60b2227a2300928
-  data.tar.gz: a76f206da09e97dbf92289db2e90200a3fb648ab
+  metadata.gz: b2a9a4b39ab44d4d9ec2e0a5768d9dbc5c860343
+  data.tar.gz: 4b4f28cb58ac9ad421f92d18c8bf28fcc891319c
 SHA512:
-  metadata.gz: 548c2e07dd21f8d957ea41a545f310647d4a9586e0bdcf0cfeb625fc83a0050a751089e2e987feae61cf4b0176584a36f625257bda0231756a664d4b5c740e0b
-  data.tar.gz: 61558fff49267f02a8a1b41a18b45005ecfef0d807c871d39f63852a917f0a54dacb0ee583806e1358bb415aec78046b29fa2190ec642514e61cb62afbb4d5b4
+  metadata.gz: f903b79ac439061cac98c370322482015c891cf59d6126679eb95a3213c67ef35532f3dd13b24054077bb8e56d384263f6348e1812f03fbb52b0b4855daa8868
+  data.tar.gz: aa48d673a02daf1df42b0ec2d803485adb1d86138c7b45fa72b15c973e66f414be9b49c5ef47574d224e9ab0390cf298dc2c25c28d379184107a36747391e83b

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## v0.3.0 [☰](https://github.com/timoschilling/cells-mailer/compare/v0.2.0...v0.3.0)
+
+* class level options
+
 ## v0.2.0 [☰](https://github.com/timoschilling/cells-mailer/compare/v0.1.0...v0.2.0)
 
 * Allow instance methods for `subject`, `from` and `to`

data/README.md

@@ -1,6 +1,6 @@
 # Cells::Mailer
 
-Provides mail functionality for [Cells](https://github.com/apotonick/cells/).
+Provides mail functionality for [Cells](https://github.com/apotonick/cells/) via the [Mail](https://github.com/mikel/mail) gem.
 
 ## Installation
 
@@ -16,8 +16,9 @@ And then execute:
 
 ## Configuration
 
-Cells::Mailer don't provide any own configuration at the moment. 
-Please take a look at the [mail](https://github.com/mikel/mail) gem for any configuration options.
+Cells::Mailer don't provide a global delivery configuration at the moment. 
+You can configure the `deliver_method` of `Mail` per [class level](#class-level-configurations) or take a look 
+at the [mail](https://github.com/mikel/mail) gem for any other configuration options.
 
 ## Usage
 
@@ -57,10 +58,44 @@ I don't know why you should use it, but you can also pass in a body as argument.
 UserNotificationCell.(user).deliver(..., body: "Hello user")
 ```
 
+### Instance method arguments
+
+You can use instance methods to receive the value for `to`, `from` and `subject`.
+
+```ruby
+class UserNotificationCell < Cell::ViewModel
+  include Cell::Mailer
+  property :user_name
+
+  def subject
+    "Hello #{user_name}"
+  end
+end
+
+UserNotificationCell.(user).deliver(..., subject: :subject)
+```
+
+### Class level configurations
+
+You can use class level configurations for `to`, `from`, `subject` and `mail_options`.
+`mail_options` are passed to `Mail`, could be used to configure `Mail#delivery_method` per Cell class.
+
+```ruby
+class UserNotificationCell < Cell::ViewModel
+  include Cell::Mailer
+
+  mailer do
+    from "nick@trailblazer.to"
+    subject "nick loves good code!"
+    mail_options delivery_method: :smtp
+  end
+end
+
+UserNotificationCell.(user).deliver(to: "timo@schilling.io")
+```
+
+This configurations will be inherited.
+
 ## Roadmap
 
-- Allow instand methods as source for
-  - `from`
-  - `to`
-  - `subject`
-- Provide class level `mail` delivery configurations
+* making a real config object

data/lib/cell/mailer/version.rb

@@ -1,5 +1,5 @@
 module Cell
   module Mailer
-    VERSION = "0.2.0"
+    VERSION = "0.3.0"
   end
 end

data/lib/cell/mailer.rb

@@ -4,7 +4,11 @@ require "mail"
 
 module Cell
   module Mailer
-    def deliver(options)
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    def deliver(options = {})
       mail = Mail.new process_mail_options(options)
       mail.deliver
     end
@@ -12,12 +16,51 @@ module Cell
     private
 
     def process_mail_options(options)
-      state = options.delete(:method) || :show
+      if options[:body] && options[:method]
+        raise ArgumentError, "You can't pass in `:method` and `:body` at once!"
+      end
+
       [:to, :subject, :from].each do |field|
         options[field] = send(options[field]) if options[field].is_a? Symbol
       end
+
+      [:to, :subject, :from].each do |field|
+        options[field] ||= self.class.send(field)
+      end
+
+      (self.class.mail_options || {}).each do |key, value|
+        options[key] = value
+      end
+
+      state = options.delete(:method) || :show
       options[:body] ||= call(state)
+
       options
     end
+
+    module ClassMethods
+      def self.extended(base)
+        base.extend Uber::InheritableAttr
+        base.inheritable_attr :to
+        base.inheritable_attr :from
+        base.inheritable_attr :subject
+        base.inheritable_attr :mail_options
+      end
+
+      def mailer(&block)
+        tap &block
+      end
+
+      def inheritable_attr(name, options={})
+        super
+        instance_eval %Q{
+          def #{name}(value = :__undefined)
+            return self.#{name} = value if value != :__undefined
+            return @#{name} if instance_variable_defined?(:@#{name})
+            @#{name} = Uber::InheritableAttribute.inherit_for(self, :#{name}, #{options})
+          end
+        }
+      end
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cells-mailer
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Timo Schilling
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-07 00:00:00.000000000 Z
+date: 2015-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cells