caffeinate 0.8.0 → 0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95fdb8a2737308443cbaea5cd679815501c8eef5b28a195a5922912436193b4c
-  data.tar.gz: 7d30e96bb9dedc5c5230c67435bc0a3967da9dd1a117c995b828f0ce5cc1c10c
+  metadata.gz: fa3c41f5c5af2ed5a8733c8c5f8614a99c2df6cfa6549bce48b6c521aedfc647
+  data.tar.gz: b8585a93022bbf70657f8d81485d9691b6a0c90192fb9b632da2a11fde45579b
 SHA512:
-  metadata.gz: 621b74af22e92674652545c490eb46a1ff26d936f2786741eed4afd11f596d5c21fcf391d80db271d2d99851a0d12bae13571b30315f2e43a1d24f1b9f07f878
-  data.tar.gz: ab7c14a44591695c6c76c038ee98e366c81e6b7cb3ab63435145b800174b26fae6cc155a8d27379a75e774b5f3b564679119ea9ca5ae41d640af806aaa9696f8
+  metadata.gz: 1cd7ab9dced54ac5cdc6be24498253bf95230d78301d1fecad21c9e74e325ad4bb05eea4cf22e50214448c304a25068f879f12ea2e9af5a6ce59b41e28aab654
+  data.tar.gz: d066b26a02543079a9a9571d71042216e3ccb69d8440b6efccb93fb47bf78e3367b58d681c7312c0c806b96d829edca1114f67951eb2c97f0c7aec9c818a38c3

data/app/models/caffeinate/campaign.rb

@@ -56,7 +56,15 @@ module Caffeinate
     def unsubscribe(subscriber, **args)
       reason = args.delete(:reason)
       subscription = subscriber(subscriber, **args)
-      raise ActiveRecord::RecordInvalid, subscription if subscription.nil?
+      return false if subscription.nil?
+
+      subscription.unsubscribe(reason)
+    end
+
+    def unsubscribe!(subscriber, **args)
+      reason = args.delete(:reason)
+      subscription = subscriber(subscriber, **args)
+      raise ::ActiveRecord::RecordInvalid, subscription if subscription.nil?
 
       subscription.unsubscribe!(reason)
     end
@@ -64,12 +72,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.find_or_create_by(subscriber: subscriber, **args)
+      caffeinate_campaign_subscriptions.create(subscriber: subscriber, **args)
     end
 
     # Subscribes an object to a campaign. Raises `ActiveRecord::RecordInvalid` if the record was invalid.
     def subscribe!(subscriber, **args)
-      subscribe(subscriber, **args)
+      caffeinate_campaign_subscriptions.create!(subscriber: subscriber, **args)
     end
   end
 end

data/app/models/caffeinate/campaign_subscription.rb

@@ -83,6 +83,16 @@ module Caffeinate
       true
     end
 
+    # Updates `ended_at` and runs `on_complete` callbacks
+    def end(reason = nil)
+      return false if unsubscribed?
+
+      result = update(ended_at: ::Caffeinate.config.time_now, ended_reason: reason)
+
+      caffeinate_campaign.to_dripper.run_callbacks(:on_end, self)
+      result
+    end
+
     # Updates `unsubscribed_at` and runs `on_subscribe` callbacks
     def unsubscribe!(reason = nil)
       raise ::Caffeinate::InvalidState, 'CampaignSubscription is already ended.' if ended?
@@ -93,6 +103,16 @@ module Caffeinate
       true
     end
 
+    # Updates `unsubscribed_at` and runs `on_subscribe` callbacks
+    def unsubscribe(reason = nil)
+      return false if ended?
+
+      result = update(unsubscribed_at: ::Caffeinate.config.time_now, unsubscribe_reason: reason)
+
+      caffeinate_campaign.to_dripper.run_callbacks(:on_unsubscribe, self)
+      result
+    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)
@@ -105,6 +125,18 @@ 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
+
     def completed?
       caffeinate_mailings.unsent.count.zero?
     end

data/app/views/layouts/_caffeinate.html.erb

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title><%= Rails.application.class.module_parent_name %></title>
+  <title></title>
 </head>
 <body>
 

data/lib/caffeinate.rb

@@ -1,6 +1,16 @@
 # frozen_string_literal: true
 
-require 'rails/all'
+require 'active_support'
+
+%w(
+  active_record/railtie
+  action_controller/railtie
+  action_view/railtie
+  action_mailer/railtie
+).each do |railtie|
+  require railtie
+end
+
 require 'caffeinate/mail_ext'
 require 'caffeinate/engine'
 require 'caffeinate/drip'

data/lib/caffeinate/drip_evaluator.rb

@@ -12,25 +12,28 @@ module Caffeinate
     def call(&block)
       return true unless block
 
-      instance_eval(&block)
+      catch(:abort) do
+        return instance_eval(&block)
+      end
+      false
     end
 
     # Ends the CampaignSubscription
-    def end!
-      mailing.caffeinate_campaign_subscription.end!
-      false
+    def end!(*args)
+      mailing.caffeinate_campaign_subscription.end!(*args)
+      throw(:abort)
     end
 
     # Unsubscribes the CampaignSubscription
-    def unsubscribe!
-      mailing.caffeinate_campaign_subscription.unsubscribe!
-      false
+    def unsubscribe!(*args)
+      mailing.caffeinate_campaign_subscription.unsubscribe!(*args)
+      throw(:abort)
     end
 
     # Skips the mailing
     def skip!
       mailing.skip!
-      false
+      throw(:abort)
     end
   end
 end

data/lib/caffeinate/dripper/perform.rb

@@ -20,7 +20,7 @@ module Caffeinate
           .upcoming
           .unsent
           .joins(:caffeinate_campaign_subscription)
-          .merge(Caffeinate::CampaignSubscription.active)
+          .merge(Caffeinate::CampaignSubscription.active.where(caffeinate_campaign: self.campaign))
           .in_batches(of: self.class.batch_size)
           .each do |batch|
           run_callbacks(:on_perform, self, batch)

data/lib/caffeinate/dripper/subscriber.rb

@@ -31,10 +31,10 @@ module Caffeinate
         #
         # @return [Caffeinate::CampaignSubscriber] the created CampaignSubscriber
         def subscribe(subscriber, **args)
-          caffeinate_campaign.subscribe(subscriber, **args)
+          caffeinate_campaign.subscribe!(subscriber, **args)
         end
 
-        # Unsubscribes from the campaign.
+        # Unsubscribes from the campaign. Returns false if something's wrong.
         #
         #   OrderDripper.unsubscribe(order, user: order.user)
         #
@@ -46,6 +46,18 @@ module Caffeinate
           caffeinate_campaign.unsubscribe(subscriber, **args)
         end
 
+        # Unsubscribes from the campaign. Raises error if somerthing's wrong.
+        #
+        #   OrderDripper.unsubscribe(order, user: order.user)
+        #
+        # @param [ActiveRecord::Base] subscriber The object subscribing
+        # @option [ActiveRecord::Base] :user The associated user (optional)
+        #
+        # @return [Caffeinate::CampaignSubscriber] the CampaignSubscriber
+        def unsubscribe!(subscriber, **args)
+          caffeinate_campaign.unsubscribe!(subscriber, **args)
+        end
+
         # :nodoc:
         def subscribes_block
           raise(NotImplementedError, 'Define subscribes') unless @subscribes_block

data/lib/caffeinate/mail_ext.rb

@@ -1,10 +1,21 @@
 # frozen_string_literal: true
 
 module Mail
+  def self.from_source(source)
+    Mail.new Mail::Utilities.binary_unsafe_to_crlf(source.to_s)
+  end
+
   # Extend Mail::Message to account for a Caffeinate::Mailing
   class Message
     attr_accessor :caffeinate_mailing
 
+    def caffeinate_mailing=(mailing)
+      @caffeinate_mailing = mailing
+      if mailing.is_a?(::Caffeinate::Mailing)
+        header['List-Unsubscribe'] = "<#{Caffeinate::UrlHelpers.caffeinate_subscribe_url(mailing.subscription)}>"
+      end
+    end
+
     def caffeinate?
       caffeinate_mailing.present?
     end

data/lib/caffeinate/version.rb

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

data/lib/generators/caffeinate/mailer_generator.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Caffeinate
+  module Generators
+    # Creates a mailer from a dripper.
+    class MailerGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+      include ::Rails::Generators::Migration
+      argument :dripper, banner: "dripper"
+
+      desc 'Creates a Mailer class from a dripper.'
+
+      def create_mailer
+        @dripper_klass = @dripper.safe_constantize
+        if @dripper_klass.nil?
+          raise ArgumentError, "Unknown dripper #{@dripper}"
+        end
+        @mailer_class = @dripper_klass.defaults[:mailer_class] || @dripper_klass.defaults[:mailer]
+        template 'mailer.rb', "app/mailers/#{@mailer_class.underscore}.rb"
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+class <%= @mailer_class %> < ApplicationMailer
+<% @dripper_klass.drips.each do |action| -%>
+  def <%= action.action %><% if action.options[:using].nil? %>(mailing)<% end %>
+<% if action.options[:using].nil? -%>
+    @mailing = mailing
+<% end -%>
+  end
+<% end -%>
+end

data/lib/generators/caffeinate/views_generator.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'rails/generators/base'
+
+module Caffeinate
+  module Generators
+    module ViewPathTemplates #:nodoc:
+      extend ActiveSupport::Concern
+
+      included do
+        public_task :copy_views
+      end
+
+      def copy_views
+        view_directory :campaign_subscriptions
+      end
+
+      protected
+
+      def view_directory(name, _target_path = nil)
+        directory name.to_s, _target_path || "#{target_path}/#{name}" do |content|
+          content
+        end
+      end
+
+      def target_path
+        @target_path ||= "app/views/caffeinate"
+      end
+    end
+
+    class SharedViewsGenerator < Rails::Generators::Base #:nodoc:
+      include ViewPathTemplates
+      source_root File.expand_path("../../../../app/views/caffeinate", __FILE__)
+      desc "Copies shared Caffeinate views to your application."
+      hide!
+    end
+
+    class ViewsGenerator < Rails::Generators::Base
+      desc "Copies Caffeinate views to your application."
+
+      invoke SharedViewsGenerator
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: caffeinate
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: '0.9'
 platform: ruby
 authors:
 - Josh Brody
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-16 00:00:00.000000000 Z
+date: 2020-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -175,8 +175,11 @@ files:
 - lib/caffeinate/url_helpers.rb
 - lib/caffeinate/version.rb
 - lib/generators/caffeinate/install_generator.rb
+- lib/generators/caffeinate/mailer_generator.rb
 - lib/generators/caffeinate/templates/application_dripper.rb
 - lib/generators/caffeinate/templates/caffeinate.rb
+- lib/generators/caffeinate/templates/mailer.rb.tt
+- lib/generators/caffeinate/views_generator.rb
 homepage: https://github.com/joshmn/caffeinate
 licenses:
 - MIT