downstream 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3806c4f875e378357e47571ed0bd5dbac1b45a80f9a01a78187b3c971378f425
-  data.tar.gz: e038408a8fb1ce3e18dfd7614e9fe3931fd72c7913249457c29fa00b14a22aa4
+  metadata.gz: 5ceb9c34b8c3146b89ff1a6668ebadc7b4306abdf5b113fca512b1d2fb27cb64
+  data.tar.gz: 18986657d7665ecd183224025d72ace1013c6ebc3351792863cacca250ff16e7
 SHA512:
-  metadata.gz: 6f81acf6c0da05267067ac4d4c60d9edcb8aefba35d326643651afcf4ba17df09b88a791b379f10318e0c63aeaa691397d10b3a2cad10e23a38b2c29990fa9bf
-  data.tar.gz: 97bf35f16b9542bb032fb0ed52b6192b24ea92a3157d2f0cfc883546f50ee04e759965d6281fbb956e30029ee8bd716b129b8340b5638c3d619be78ca4494faf
+  metadata.gz: 880ea8f11ba29203402f975c523ac695af7befd8c5824a38805d4c48deec84123f0331f354296fe741cfd1341ba29a38c1f6273a4cdb0dccafc312536aa72de1
+  data.tar.gz: 06faab1f5d2a5d4be4d5a6e82109c197de85e7306f8b6a11d64d304206bf8fe220a3bd1b74dd61a25cb4cf104f1cffae9d5514aea75c60823c6d687e58fe0ac2

data/README.md

@@ -131,6 +131,12 @@ store.subscribe OnProfileCreated::DoThat, async: {queue: :low_priority}
 
 You can test subscribers as normal Ruby objects.
 
+First, load testing helpers in the `spec_helper.rb`:
+
+```ruby
+require "downstream/rspec"
+```
+
 To test that a given subscriber exists, you can do the following:
 
 ```ruby
@@ -143,6 +149,14 @@ it "is subscribed to some event" do
 
   expect(MySubscriberService).to have_received(:call).with(event)
 end
+
+# for asynchronous subscriptions
+it "is subscribed to some event" do
+  event = MyEvent.new(some: "data")
+  expect { Downstream.publish event }.
+    to have_enqueued_async_subscriber_for(MySubscriberService).
+    with(event)
+end
 ```
 
 To test publishing use `have_published_event` matcher:

data/lib/downstream/pubsub_adapters/abstract_pubsub.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Downstream
   class AbstractPubsub
     def subscribe(identifier, callable)

data/lib/downstream/pubsub_adapters/stateless/pubsub.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "active_support/notifications"
 require_relative "subscriber"
 
@@ -5,10 +7,7 @@ module Downstream
   module Stateless
     class Pubsub < AbstractPubsub
       def subscribe(identifier, callable, async: false)
-        ActiveSupport::Notifications.subscribe(
-          identifier,
-          Subscriber.new(callable, async: async)
-        )
+        Subscriber.new(callable, async: async).tap { |s| s.subscribe(identifier) }
       end
 
       def subscribed(identifier, callable, &block)

data/lib/downstream/pubsub_adapters/stateless/subscriber.rb

@@ -1,4 +1,4 @@
-require_relative "subscriber_job"
+# frozen_string_literal: true
 
 module Downstream
   module Stateless
@@ -38,8 +38,21 @@ module Downstream
         end
       end
 
+      def subscribe(identifier)
+        @notification_subscriber = ActiveSupport::Notifications.subscribe(
+          identifier,
+          self
+        )
+      end
+
+      def unsubscribe
+        ActiveSupport::Notifications.unsubscribe(notification_subscriber)
+      end
+
       private
 
+      attr_reader :notification_subscriber
+
       def async_queue_name
         return @async_queue_name if defined?(@async_queue_name)
 

data/lib/downstream/rspec/have_enqueued_async_subscriber_for.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "rspec/rails/matchers/active_job"
+
+module Downstream
+  class HaveEnqueuedAsyncSubscriberFor < RSpec::Rails::Matchers::ActiveJob::HaveEnqueuedJob
+    class EventMatcher
+      include ::RSpec::Matchers::Composable
+
+      attr_reader :event
+
+      def initialize(event)
+        @event = event
+      end
+
+      def matches?(actual)
+        actual == event
+      end
+
+      def description
+        "be #{event.inspect}"
+      end
+    end
+
+    attr_reader :callable
+
+    def initialize(callable)
+      @callable = callable
+      super(SubscriberJob)
+    end
+
+    def with(event)
+      super(EventMatcher.new(event), callable.name)
+    end
+
+    def matches?(proc)
+      raise ArgumentError, "have_enqueued_async_subscriber_for only supports block expectations" unless Proc === proc
+      super
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.include(Module.new do
+    def have_enqueued_async_subscriber_for(*args)
+      Downstream::HaveEnqueuedAsyncSubscriberFor.new(*args)
+    end
+  end)
+end

data/lib/downstream/rspec.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
 require_relative "rspec/have_published_event"
+require_relative "rspec/have_enqueued_async_subscriber_for"

data/lib/downstream/subscriber_job.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Downstream
+  class SubscriberJob < ActiveJob::Base
+    def perform(event, callable)
+      callable.constantize.call(event)
+    end
+  end
+end

data/lib/downstream/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Downstream
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

data/lib/downstream.rb

@@ -9,7 +9,7 @@ require "after_commit_everywhere"
 require "downstream/config"
 require "downstream/event"
 require "downstream/pubsub_adapters/abstract_pubsub"
-require "downstream/rspec" if defined?(RSpec)
+require "downstream/subscriber_job"
 
 module Downstream
   class << self

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: downstream
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - merkushin.m.s@gmail.com
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-01 00:00:00.000000000 Z
+date: 2021-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: after_commit_everywhere
@@ -194,9 +194,10 @@ files:
 - lib/downstream/pubsub_adapters/abstract_pubsub.rb
 - lib/downstream/pubsub_adapters/stateless/pubsub.rb
 - lib/downstream/pubsub_adapters/stateless/subscriber.rb
-- lib/downstream/pubsub_adapters/stateless/subscriber_job.rb
 - lib/downstream/rspec.rb
+- lib/downstream/rspec/have_enqueued_async_subscriber_for.rb
 - lib/downstream/rspec/have_published_event.rb
+- lib/downstream/subscriber_job.rb
 - lib/downstream/version.rb
 homepage: https://github.com/bibendi/downstream
 licenses:

data/lib/downstream/pubsub_adapters/stateless/subscriber_job.rb

@@ -1,9 +0,0 @@
-module Downstream
-  module Stateless
-    class SubscriberJob < ActiveJob::Base
-      def perform(event, callable)
-        callable.constantize.call(event)
-      end
-    end
-  end
-end