caffeinate 0.14.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8ae5ac5375188ce5a7bc8960ac7d7b392ccc7dc7de71070e88a2285fa76e7af
-  data.tar.gz: dd06d837c2c1477bf8e48484e028016f00203066f0b2383c6f0a7a3cb5b5af1f
+  metadata.gz: f16a6861b725b37b7b98bda070586ae794875a171af2b7ea4582a05b7d9aacaa
+  data.tar.gz: c6ff565b6792fdf4ed193d3bd478b445a55835262d11118530f69d1aef08e8af
 SHA512:
-  metadata.gz: 5c71b3ba2196a9a9f7ae66074b8eeb76ad6fe1a6b2ecff521e7f92c06da411c4722e0bc8b4a49fcfc9eaf0fde921c76fd4b13fbb5c7b59cfe1ec173ea69e5b29
-  data.tar.gz: 498848318785a2f8f4ab669cada385760f63663b1c6bf254235a7f640c189eaa170391aff58990c05c6a4d8ee6a6dc860399ea24745431dec7dfebaa8d760533
+  metadata.gz: c2e5c6cc7c7af6f37c270f883d74e1eff9f48ac4b16226b4bf3c31729c116d7790ba198f7657a272458cf66d9993a2814e8bf2e183fd8830876eee50bf26ba65
+  data.tar.gz: 7c9519545b4183787b71422b706a059bab5b73df0f872677f9fdb2dc0f10f60f4a3c2eacbc64eabf1246815bd5574dcadc0750d30a018075945e87bbc9f25254

data/README.md

@@ -2,18 +2,32 @@
   <img width="450" src="https://github.com/joshmn/caffeinate/raw/master/logo.png" alt="Caffeinate logo" />
 </div>
 
----
+<div align="center">
+    <a href="https://codecov.io/gh/joshmn/caffeinate">
+        <img src="https://codecov.io/gh/joshmn/caffeinate/branch/master/graph/badge.svg?token=5LCOB4ESHL" alt="Coverage"/>
+    </a>
+    <a href="https://codeclimate.com/github/joshmn/caffeinate/maintainability">
+        <img src="https://api.codeclimate.com/v1/badges/9c075416ce74985d5c6c/maintainability" alt="Maintainability"/>
+    </a>
+     <a href="https://inch-ci.org/github/joshmn/caffeinate">
+        <img src="https://inch-ci.org/github/joshmn/caffeinate.svg?branch=master" alt="Docs"/>
+    </a>
+</div>
 
 # Caffeinate
 
-Caffeinate is a drip campaign engine for Ruby on Rails applications.
+Caffeinate is a drip email engine for managing, creating, and sending scheduled email sequences from your Ruby on Rails application.
 
-Caffeinate tries to make creating and managing timed and scheduled email sequences fun. It works alongside ActionMailer
-and has everything you need to get started and to successfully manage campaigns. It's only dependency is the stack you're
-already familiar with: Ruby on Rails.
+Caffeinate provides a simple DSL to create scheduled email sequences which can be used by ActionMailer without any additional configuration. 
 
 There's a cool demo with all the things included at [caffeinate.email](https://caffeinate.email). You can view the [marketing site source code here](https://github.com/joshmn/caffeinate-marketing).
 
+## Is this thing dead?
+
+No! Not at all!
+
+There's not a lot of activity here because it's stable and working! I am more than happy to entertain new features.
+
 ## Do you suffer from ActionMailer tragedies?
 
 If you have _anything_ like this is your codebase, **you need Caffeinate**:
@@ -30,19 +44,16 @@ end
 
 ```ruby
 class OnboardingMailer < ActionMailer::Base
-  # Send on account creation
   def welcome_to_my_cool_app(user)
     mail(to: user.email, subject: "Welcome to CoolApp!")
   end
 
-  # Send 2 days after the user signs up
   def some_cool_tips(user)
     return if user.unsubscribed_from_onboarding_campaign?
 
     mail(to: user.email, subject: "Here are some cool tips for MyCoolApp")
   end
 
-  # Sends 3 days after the user signs up and hasn't added a company profile yet
   def help_getting_started(user)
     return if user.unsubscribed_from_onboarding_campaign?
     return if user.onboarding_completed?
@@ -56,22 +67,12 @@ end
 
 * You're checking state in a mailer
 * The unsubscribe feature is, most likely, tied to a `User`, which means...
-* It's going to be _so fun_ to scale horizontally
+* It's going to be _so fun_ to scale when you finally want to add more unsubscribe links for different types of sequences
+    - "one of your projects has expired", but which one? Then you have to add a column to `projects` and manage all that state... ew
 
-## Caffeinate to the rescue
+## Do this all better in five minutes
 
-Caffeinate combines a simple scheduling DSL, ActionMailer, and your data models to create scheduled email sequences.
-
-What can you do with drip campaigns?
-* Onboard new customers with cool tips and tricks
-* Remind customers to use your product
-* Nag customers about using your product
-* Reach their spam folder after you fail to handle their unsubscribe request
-* And more!
-
-## Onboarding in Caffeinate
-
-In five minutes you can implement this onboarding campaign, and it won't even hijack your entire app!
+In five minutes you can implement this onboarding campaign:
 
 ### Install it
 
@@ -83,11 +84,11 @@ $ rails g caffeinate:install
 $ rake db:migrate
 ```
 
-### Remove that ActionMailer logic
+### Clean up the mailer logic
 
-Just delete it. Mailers should be responsible for receiving context and creating a `mail` object. Nothing more.
+Mailers should be responsible for receiving context and creating a `mail` object. Nothing more.
 
-The only other change you need to make is the argument that the mailer action receives:
+The only other change you need to make is the argument that the mailer action receives. It will now receive a `Caffeinate::Mailing`. [Learn more about the data models](docs/2-data-models.md):
 
 ```ruby
 class OnboardingMailer < ActionMailer::Base
@@ -108,27 +109,36 @@ class OnboardingMailer < ActionMailer::Base
 end
 ```
 
-While we're there, let's add an unsubscribe link to the views or layout:
-
-```erb
-<%= link_to "Stop receiving onboarding tips :(", caffeinate_unsubscribe_url %>
-```
-
 ### Create a Dripper
 
-A Dripper has all the logic for your Campaign and coordinates with ActionMailer on what to send.
+A Dripper has all the logic for your sequence and coordinates with ActionMailer on what to send.
 
 In `app/drippers/onboarding_dripper.rb`:
 
 ```ruby
 class OnboardingDripper < ApplicationDripper
+  # each sequence is a campaign. This will dynamically create one by the given slug
+  self.campaign = :onboarding 
+  
+  # gets called before every time we process a drip
+  before_drip do |_drip, mailing| 
+    if mailing.subscription.subscriber.onboarding_completed?
+      mailing.subscription.unsubscribe!("Completed onboarding")
+      throw(:abort)
+    end 
+  end
+  
+  # map drips to the mailer
   drip :welcome_to_my_cool_app, mailer: 'OnboardingMailer', delay: 0.hours
   drip :some_cool_tips, mailer: 'OnboardingMailer', delay: 2.days
   drip :help_getting_started, mailer: 'OnboardingMailer', delay: 3.days
 end
 ```
 
-The `drip` syntax is `def drip(mailer_action, options = {})`.
+We want to skip sending the `mailing` if the `subscriber` (`User`) completed onboarding. Let's unsubscribe 
+with `#unsubscribe!` and give it an optional reason of `Completed onboarding` so we can reference it later 
+when we look at analytics. `throw(:abort)` halts the callback chain just like regular Rails callbacks, stopping the 
+mailing from being sent.
 
 ### Add a subscriber to the Campaign
 
@@ -138,48 +148,37 @@ a `Caffeinate::CampaignSubscription`.
 ```ruby
 class User < ApplicationRecord
   after_commit on: :create do
-    OnboardingDripper.subscribe(self)
-  end
-
-  after_commit on: :update do
-    if onboarding_completed? && onboarding_completed_changed?
-      if OnboardingDripper.subscribed?(self)
-        OnboardingDripper.unsubscribe(self)
-      end
-    end
+    OnboardingDripper.subscribe!(self)
   end
 end
 ```
 
-When a `Caffeinate::CampaignSubscription` is created, the relevant Dripper is parsed and `Caffeinate::Mailing` records
-are created from the `drip` DSL. A `Caffeinate::Mailing` record has a `send_at` attribute which tells Caffeinate when we
-can send the mail, which we get from `Caffeiate::Mailing#mailer_class` and `Caffeinate::Mailing#mailer_action`.
-
 ### Run the Dripper
 
-Running `OnboardingDripper.perform!` every `x` minutes will call `Caffeinate::Mailing#process!` on `Caffeinate::Mailing`
-records that have `send_at < Time.now`.
-
 ```ruby
 OnboardingDripper.perform!
 ```
 
-### Done. But wait, there's more fun if you want
+### Done
 
-* Automatic subscriptions
-* Campaign-specific unsubscribe links
-* Reasons for unsubscribing so you can have some sort of analytics
-* Periodical emails (daily, weekly, monthly digests, anyone?)
-* Parameterized mailer support a la `OnboardingMailer.with(mailing: mailing)`
+You're done. 
 
-### Done. But wait, there's more fun if you want
+[Check out the docs](/docs/README.md) for a more in-depth guide that includes all the options you can use for more complex setups,
+tips, tricks, and shortcuts.
 
-* Automatic subscriptions
-* Campaign-specific unsubscribe links
-* Reasons for unsubscribing so you can have some sort of analytics
-* Periodical emails (daily, weekly, monthly digests, anyone?)
-* Parameterized mailer support a la `OnboardingMailer.with(mailing: mailing)`
+## But wait, there's more
 
+Caffeinate also...
+
+* ✅ Allows hyper-precise scheduled times. 9:19AM _in the user's timezone_? Sure! **Only on business days**? YES! 
+* ✅ Periodicals
+* ✅ Manages unsubscribes
+* ✅ Works with singular and multiple associations
+* ✅ Compatible with every background processor
+* ✅ Tested against large databases at AngelList and is performant as hell
+* ✅ Effortlessly handles complex workflows
+    - Need to skip a certain mailing? You can!
+ 
 ## Documentation
 
 * [Getting started, tips and tricks](https://github.com/joshmn/caffeinate/blob/master/docs/README.md)
@@ -191,7 +190,7 @@ OnboardingDripper.perform!
 
 ## Alternatives
 
-Not a fan? There are some alternatives!
+Not a fan of Caffeinate? I built it because I wasn't a fan of the alternatives. To each their own:
 
 * https://github.com/honeybadger-io/heya
 * https://github.com/tarr11/dripper
@@ -199,11 +198,14 @@ Not a fan? There are some alternatives!
 
 ## Contributing
 
-Just do it.
+There's so much more that can be done with this. I'd love to see what you're thinking.
+
+If you have general feedback, I'd love to know what you're using Caffeinate for! Please email me (any-thing [at] josh.mn) or [tweet me @joshmn](https://twitter.com/joshmn) or create an issue! I'd love to chat.
 
 ## Contributors & thanks
 
 * Thanks to [sourdoughdev](https://github.com/sourdoughdev/caffeinate) for releasing the gem name to me. :)
+* Thanks to [markokajzer](https://github.com/markokajzer) for listening to me talk about this most mornings.
 
 ## License
 

data/app/models/caffeinate/campaign.rb

@@ -14,12 +14,15 @@ module Caffeinate
   # Campaign ties together subscribers and mailings, and provides one core model for handling your Drippers.
   class Campaign < ApplicationRecord
     self.table_name = 'caffeinate_campaigns'
+    class NoSubscription < ::ActiveRecord::RecordInvalid; end
 
     has_many :caffeinate_campaign_subscriptions, class_name: 'Caffeinate::CampaignSubscription', foreign_key: :caffeinate_campaign_id
     has_many :subscriptions, class_name: 'Caffeinate::CampaignSubscription', foreign_key: :caffeinate_campaign_id
     has_many :caffeinate_mailings, through: :caffeinate_campaign_subscriptions, class_name: 'Caffeinate::CampaignSubscriptions'
     has_many :mailings, through: :caffeinate_campaign_subscriptions, class_name: 'Caffeinate::CampaignSubscriptions'
 
+    scope :active, -> { where(active: true) }
+
     # Poorly-named Campaign class resolver
     def to_dripper
       ::Caffeinate.dripper_collection.resolve(self)
@@ -64,7 +67,7 @@ module Caffeinate
     def unsubscribe!(subscriber, **args)
       reason = args.delete(:reason)
       subscription = subscriber(subscriber, **args)
-      raise ::ActiveRecord::RecordInvalid, subscription if subscription.nil?
+      raise NoSubscription, subscription if subscription.nil?
 
       subscription.unsubscribe!(reason)
     end
@@ -72,12 +75,12 @@ module Caffeinate
     # Creates a `CampaignSubscription` object for the present Campaign. Allows passing `**args` to
     # delegate additional arguments to the record. Uses `find_or_create_by`.
     def subscribe(subscriber, **args)
-      caffeinate_campaign_subscriptions.create(subscriber: subscriber, **args)
+      caffeinate_campaign_subscriptions.find_or_create_by(subscriber: subscriber, **args)
     end
 
     # Subscribes an object to a campaign. Raises `ActiveRecord::RecordInvalid` if the record was invalid.
     def subscribe!(subscriber, **args)
-      caffeinate_campaign_subscriptions.create!(subscriber: subscriber, **args)
+      caffeinate_campaign_subscriptions.find_or_create_by!(subscriber: subscriber, **args)
     end
   end
 end

data/app/models/caffeinate/campaign_subscription.rb

@@ -55,7 +55,7 @@ module Caffeinate
 
     before_validation :call_dripper_before_subscribe_blocks!, on: :create
 
-    after_commit :create_mailings!, on: :create
+    after_create :create_mailings!
 
     after_commit :on_complete, if: :completed?
 
@@ -131,18 +131,7 @@ module Caffeinate
       true
     end
 
-    # Updates `unsubscribed_at` to nil and runs `on_subscribe` callbacks.
-    # Use `force` to forcefully reset. Does not create the mailings.
-    def resubscribe!(force = false)
-      return false if ended? && !force
-      return false if unsubscribed? && !force
-
-      result = update(unsubscribed_at: nil, resubscribed_at: ::Caffeinate.config.time_now)
-
-      caffeinate_campaign.to_dripper.run_callbacks(:on_resubscribe, self)
-      result
-    end
-
+    # Checks if the record is not new and if mailings are all gone.
     def completed?
       caffeinate_mailings.unsent.count.zero?
     end

data/app/models/caffeinate/mailing.rb

@@ -24,7 +24,7 @@ module Caffeinate
     has_one :caffeinate_campaign, through: :caffeinate_campaign_subscription
     alias_attribute :campaign, :caffeinate_campaign
 
-    scope :upcoming, -> { unsent.unskipped.where('send_at < ?', ::Caffeinate.config.time_now).order('send_at asc') }
+    scope :upcoming, -> { joins(:caffeinate_campaign_subscription).where(caffeinate_campaign_subscription: ::Caffeinate::CampaignSubscription.active).unsent.unskipped.where('send_at < ?', ::Caffeinate.config.time_now).order('send_at asc') }
     scope :unsent, -> { unskipped.where(sent_at: nil) }
     scope :sent, -> { unskipped.where.not(sent_at: nil) }
     scope :skipped, -> { where.not(skipped_at: nil) }
@@ -112,7 +112,7 @@ module Caffeinate
 
     # Delivers the Mailing in the background
     def deliver_later!
-      klass = ::Caffeinate.config.mailing_job_class
+      klass = ::Caffeinate.config.async_delivery_class
       if klass.respond_to?(:perform_later)
         klass.perform_later(id)
       elsif klass.respond_to?(:perform_async)

data/app/views/caffeinate/campaign_subscriptions/subscribe.html.erb

@@ -1,3 +1,3 @@
 <%= t("caffeinate.campaign_subscriptions.subscribe") %>
 <p><%= t("caffeinate.campaign_subscriptions.changed_your_mind")%></p>
-<p><%= link_to "Unsubscribe", caffeinate_subscribe_url %></p>
+<p><%= link_to "Unsubscribe", caffeinate_unsubscribe_url %></p>

data/app/views/caffeinate/campaign_subscriptions/unsubscribe.html.erb

@@ -1,3 +1,3 @@
 <h5><%= t("caffeinate.campaign_subscriptions.unsubscribe")%></h5>
 <p><%= t("caffeinate.campaign_subscriptions.changed_your_mind")%></p>
-<p><%= link_to "Resubscribe", caffeinate_subscribe_url %></p>
+<p><%= link_to "Resubscribe", caffeinate_resubscribe_url %></p>

data/lib/caffeinate/configuration.rb

@@ -3,14 +3,44 @@
 module Caffeinate
   # Global configuration
   class Configuration
-    attr_accessor :now, :async_delivery, :deliver_later,:mailing_job, :batch_size, :drippers_path, :implicit_campaigns,
-                  :default_ended_reason, :default_unsubscribe_reason
+
+    # Used for relation to a lot of things. If you have a weird time setup, set this.
+    # Accepts anything that responds to `#call`; you'll probably use a block.
+    attr_accessor :now
+
+    # If true, enqueues the processing of a `Caffeinate::Mailing` to the background worker class
+    # as defined in `async_delivery_class`
+    #
+    # Default is false
+    attr_accessor :async_delivery
+
+    # The background worker class for `async_delivery`.
+    attr_accessor :async_delivery_class
+
+    # If true, uses `deliver_later` instead of `deliver`
+    attr_accessor :deliver_later
+
+    # The number of `Caffeinate::Mailing` records we find in a batch at once.
+    attr_accessor :batch_size
+
+    # The path to the drippers
+    attr_accessor :drippers_path
+
+    # Automatically creates a `Caffeinate::Campaign` record by the named slug of the campaign from a dripper
+    # if none is found by the slug.
+    attr_accessor :implicit_campaigns
+
+    # The default reason for an ended `Caffeinate::CampaignSubscription`
+    attr_accessor :default_ended_reason
+
+    # The default reason for an unsubscribed `Caffeinate::CampaignSubscription`
+    attr_accessor :default_unsubscribe_reason
 
     def initialize
       @now = -> { Time.current }
       @async_delivery = false
       @deliver_later = false
-      @mailing_job = nil
+      @async_delivery_class = nil
       @batch_size = 1_000
       @drippers_path = 'app/drippers'
       @implicit_campaigns = true
@@ -24,29 +54,24 @@ module Caffeinate
       @now = val
     end
 
-    # Automatically create a `::Caffeinate::Campaign` object if not found per `Dripper.inferred_campaign_slug`
     def implicit_campaigns?
-      @implicit_campaigns == true
+      @implicit_campaigns
     end
 
-    # The current time, for database calls
     def time_now
       @now.call
     end
 
-    # If delivery is asyncronous
     def async_delivery?
       @async_delivery
     end
 
-    # If we should use `#deliver_later` instead of `#deliver`
     def deliver_later?
       @deliver_later
     end
 
-    # The @mailing_job constantized. Only used if `async_delivery = true`
-    def mailing_job_class
-      @mailing_job.constantize
+    def async_delivery_class
+      @async_delivery_class.constantize
     end
   end
 end

data/lib/caffeinate/deliver_async.rb

@@ -10,7 +10,7 @@ module Caffeinate
   #
   # To use this, make sure your initializer is configured correctly:
   #   config.async_delivery = true
-  #   config.mailing_job = 'MyWorker'
+  #   config.async_delivery_class = 'MyWorker'
   module DeliverAsync
     def perform(mailing_id)
       mailing = ::Caffeinate::Mailing.find(mailing_id)

data/lib/caffeinate/drip.rb

@@ -1,31 +1,13 @@
 # frozen_string_literal: true
 
 require 'caffeinate/drip_evaluator'
+require 'caffeinate/schedule_evaluator'
+
 module Caffeinate
   # A Drip object
   #
   # Handles the block and provides convenience methods for the drip
   class Drip
-    class OptionEvaluator
-      def initialize(thing, drip, mailing)
-        @thing = thing
-        @drip = drip
-        @mailing = mailing
-      end
-
-      def call
-        if @thing.is_a?(Symbol)
-          @drip.dripper.new.send(@thing, @drip, @mailing)
-        elsif @thing.is_a?(Proc)
-          @mailing.instance_exec(&@thing)
-        elsif @thing.is_a?(String)
-          Time.parse(@thing)
-        else
-          @thing
-        end
-      end
-    end
-
     attr_reader :dripper, :action, :options, :block
 
     def initialize(dripper, action, options, &block)
@@ -41,29 +23,7 @@ module Caffeinate
     end
 
     def send_at(mailing = nil)
-      if periodical?
-        start = mailing.instance_exec(&options[:start])
-        start += options[:every] if mailing.caffeinate_campaign_subscription.caffeinate_mailings.count.positive?
-        date = start.from_now
-      elsif options[:on]
-        date = OptionEvaluator.new(options[:on], self, mailing).call
-      else
-        date = OptionEvaluator.new(options[:delay], self, mailing).call
-        if date.respond_to?(:from_now)
-          date = date.from_now
-        end
-      end
-
-      if options[:at]
-        time = OptionEvaluator.new(options[:at], self, mailing).call
-        return date.change(hour: time.hour, min: time.min, sec: time.sec)
-      end
-
-      date
-    end
-
-    def periodical?
-      options[:every].present?
+      ::Caffeinate::ScheduleEvaluator.call(self, mailing)
     end
 
     # Checks if the drip is enabled

data/lib/caffeinate/dripper/drip.rb

@@ -30,7 +30,22 @@ module Caffeinate
         # @option options [String] :mailer_class The mailer_class
         # @option options [Integer] :step The order in which the drip is executed
         # @option options [ActiveSupport::Duration] :delay When the drip should be ran
-        # @option options [Symbol] :using set to :parameters if the mailer action uses ActionMailer::Parameters
+        # @option options [Block|Symbol|String] :at Alternative to `:delay` option, allowing for more fine-tuned timing.
+        # Accepts a block, symbol (an instance method on the Dripper that accepts two arguments: drip, mailing), or a string
+        # to be later parsed into a Time object.
+        #
+        #   drip :mailer_action_name, mailer_class: "MailerClass", at: -> { 3.days.from_now.in_time_zone(mailing.subscriber.timezone) }
+        #
+        #   class MyDripper
+        #     drip :mailer_action_name, mailer_class: "MailerClass", at: :generate_date
+        #     def generate_date(drip, mailing)
+        #       3.days.from_now.in_time_zone(mailing.subscriber.timezone)
+        #     end
+        #   end
+        #
+        #   drip :mailer_action_name, mailer_class: "MailerClass", at: 'January 1, 2022'
+        #
+        # @option options [Symbol] :using Set to `:parameters` if the mailer action uses ActionMailer::Parameters
         def drip(action_name, options = {}, &block)
           drip_collection.register(action_name, options, &block)
         end

data/lib/caffeinate/dripper/drip_collection.rb

@@ -4,6 +4,8 @@ module Caffeinate
   module Dripper
     # A collection of Drip objects for a `Caffeinate::Dripper`
     class DripCollection
+      VALID_DRIP_OPTIONS = [:mailer_class, :step, :delay, :every, :start, :using, :mailer, :at, :on].freeze
+
       include Enumerable
 
       def initialize(dripper)
@@ -42,7 +44,7 @@ module Caffeinate
 
       def validate_drip_options(action, options)
         options.symbolize_keys!
-        options.assert_valid_keys(:mailer_class, :step, :delay, :every, :start, :using, :mailer, :at, :on)
+        options.assert_valid_keys(*VALID_DRIP_OPTIONS)
         options[:mailer_class] ||= options[:mailer] || @dripper.defaults[:mailer_class]
         options[:using] ||= @dripper.defaults[:using]
         options[:step] ||= @dripper.drips.size + 1

data/lib/caffeinate/dripper/subscriber.rb

@@ -10,14 +10,7 @@ module Caffeinate
       end
 
       module ClassMethods
-        # Runs the subscriber_block
-        #
-        #   OrderDripper.subscribe!
-        def subscribe!
-          subscribes_block.call
-        end
-
-        # Returns the campaign's `Caffeinate::CampaignSubscriber`
+        # Returns the Campaign's `Caffeinate::CampaignSubscriber`
         def subscriptions
           caffeinate_campaign.caffeinate_campaign_subscriptions
         end
@@ -57,33 +50,6 @@ module Caffeinate
         def unsubscribe!(subscriber, **args)
           caffeinate_campaign.unsubscribe!(subscriber, **args)
         end
-
-        # :nodoc:
-        def subscribes_block
-          raise(NotImplementedError, 'Define subscribes') unless @subscribes_block
-
-          @subscribes_block
-        end
-
-        # The subscriber block. Used to create `::Caffeinate::CampaignSubscribers` subscribers.
-        #
-        #   subscribes do
-        #     Cart.left_joins(:cart_items)
-        #         .includes(:user)
-        #         .where(completed_at: nil)
-        #         .where(updated_at: 1.day.ago..2.days.ago)
-        #         .having('count(cart_items.id) > 0').each do |cart|
-        #       subscribe(cart, user: cart.user)
-        #     end
-        #   end
-        #
-        # No need to worry about checking if the given subscriber being already subscribed.
-        # The `subscribe` method does that for you.
-        #
-        # Optionally, can subscribe a user manually via `Caffeinate::Campaign#subscribe`
-        def subscribes(&block)
-          @subscribes_block = block
-        end
       end
     end
   end

data/lib/caffeinate/schedule_evaluator.rb

@@ -0,0 +1,70 @@
+module Caffeinate
+  class OptionEvaluator
+    def initialize(thing, drip, mailing)
+      @thing = thing
+      @drip = drip
+      @mailing = mailing
+    end
+
+    def call
+      if @thing.is_a?(Symbol)
+        @drip.dripper.new.send(@thing, @drip, @mailing)
+      elsif @thing.is_a?(Proc)
+        @mailing.instance_exec(&@thing)
+      elsif @thing.is_a?(String)
+        Time.parse(@thing)
+      else
+        @thing
+      end
+    end
+  end
+
+  class ScheduleEvaluator
+    def self.call(drip, mailing)
+      new(drip, mailing).call
+    end
+
+    attr_reader :mailing
+    def initialize(drip, mailing)
+      @drip = drip
+      @mailing = mailing
+    end
+
+    # todo: test this decision tree.
+    def call
+      if periodical?
+        start = mailing.instance_exec(&options[:start])
+        start += options[:every] if mailing.caffeinate_campaign_subscription.caffeinate_mailings.count.positive?
+        date = start.from_now
+      elsif options[:on]
+        date = OptionEvaluator.new(options[:on], self, mailing).call
+      else
+        date = OptionEvaluator.new(options[:delay], self, mailing).call
+        if date.respond_to?(:from_now)
+          date = date.from_now
+        end
+      end
+
+      if options[:at]
+        time = OptionEvaluator.new(options[:at], self, mailing).call
+        return date.change(hour: time.hour, min: time.min, sec: time.sec)
+      end
+
+      date
+    end
+    
+    def respond_to_missing?(name, include_private = false)
+      @drip.respond_to?(name, include_private)
+    end
+
+    def method_missing(method, *args, &block)
+      @drip.send(method, *args, &block)
+    end
+    
+    private
+
+    def periodical?
+      options[:every].present?
+    end
+  end
+end

data/lib/caffeinate/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Caffeinate
-  VERSION = '0.14.0'
+  VERSION = '2.0.1'
 end

data/lib/generators/caffeinate/templates/caffeinate.rb

@@ -17,10 +17,10 @@ Caffeinate.setup do |config|
   #
   # Default:
   #   config.async_delivery = false
-  #   config.mailing_job = nil
+  #   config.async_delivery_class = nil
   #
   # config.async_delivery = true
-  # config.mailing_job = 'MyCustomCaffeinateJob'
+  # config.async_delivery_class = 'MyCustomCaffeinateJob'
   #
   # == Batching
   #

data/lib/generators/caffeinate/templates/migrations/create_caffeinate_mailings.rb.tt

@@ -4,7 +4,7 @@ class CreateCaffeinateMailings < ActiveRecord::Migration<%= migration_version %>
   def change
     create_table :caffeinate_mailings do |t|
       t.references :caffeinate_campaign_subscription, null: false, foreign_key: true, index: { name: 'index_caffeinate_mailings_on_campaign_subscription' }
-      t.datetime :send_at
+      t.datetime :send_at, null: false
       t.datetime :sent_at
       t.datetime :skipped_at
       t.string :mailer_class, null: false

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: caffeinate
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 2.0.1
 platform: ruby
 authors:
 - Josh Brody
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-18 00:00:00.000000000 Z
+date: 2021-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -122,7 +122,22 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Ruby on Rails drip campaign engine. Buzzwords!
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Create, manage, and send scheduled email sequences and drip campaigns
+  from your Rails app.
 email:
 - josh@josh.mn
 executables: []
@@ -169,6 +184,7 @@ files:
 - lib/caffeinate/engine.rb
 - lib/caffeinate/helpers.rb
 - lib/caffeinate/mail_ext.rb
+- lib/caffeinate/schedule_evaluator.rb
 - lib/caffeinate/url_helpers.rb
 - lib/caffeinate/version.rb
 - lib/generators/caffeinate/install_generator.rb
@@ -184,7 +200,7 @@ homepage: https://github.com/joshmn/caffeinate
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -199,8 +215,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.0.rc.2
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
-summary: Ruby on Rails drip campaign engine. Buzzwords!
+summary: Create, manage, and send scheduled email sequences and drip campaigns from
+  your Rails app.
 test_files: []