eventish 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 965405052bda0cb9903d4a447c91e5db89c8b98a868ded8428ee0399652680bd
-  data.tar.gz: 4608f89362bd42919071b404d428c8a44178d608a51ae0c0eb2aeb0b9a3d40ee
+  metadata.gz: 8f5572d1bca258f0f1c9bd4e09e3743f99bf3045c82013c9742e1b06cfb3c590
+  data.tar.gz: abe5bdf2cbe1998404c21686ee97758681be8e038c0af03c67b7be1cbed2c8c5
 SHA512:
-  metadata.gz: 78839ea7b019d89e6587692faa575e345c9b72eae8355833cb374a5b7906cedd97ebcc74e4e61db1ecf9ea3c4764f5de7eeacac0a79bd6448c080f341ef33db3
-  data.tar.gz: 9b88eb7b02e330c68449cb7e978c8b40c6bc0a19cab874bd082fbf897ef61a9ec67ad3d2be866b3936d0370f777f158d423a414d3f469a4656facdfb8d201cb1
+  metadata.gz: 885eb9228852f4d143a52ca2db3b622eead0bb9c57bc47fecb8ce29ce9694488973151a1bcaf07df2783192aa362dd3626c200ca36a39afc721a6f5c22cc6222
+  data.tar.gz: e86ca0a3133a144c709a3a1cc76b2ba777d5995a8068ba202b6570bc4c31ab14e73fea390e3898825276bbc97651dfcdecb978af2266880f47219e810fc00d03

data/README.md

@@ -8,7 +8,8 @@ Yet another opinionated events library which proposes a simple API to handle...
 The main features:
 - _composable_: just require the components that you need;
 - with _adapters_: support ActiveSupport::Notifications for pub/sub events;
-- with _async events_: support ActiveJob for background execution.
+- with _async events_: support ActiveJob for background execution;
+- with _callbacks_ wrapper: support ActiveRecord.
 
 ## Install
 
@@ -123,6 +124,25 @@ module Notifications
 end
 ```
 
+### Callbacks
+
+Only for ActiveRecord, callbacks wrapper are available with the postfix `_event` (ex. `after_commit_event SomeEvent`).
+
+```rb
+# initializer setup
+require 'eventish/active_record/callback'
+```
+
+```rb
+class SomeModel < ActiveRecord::Base
+  extend ::Eventish::ActiveRecord::Callback
+
+  before_validation_event SomeBeforeValidationEvent
+end
+```
+
+The related callback will be setup by the wrapper and the specified event class will be invoked accordingly.
+
 ## Do you like it? Star it!
 
 If you use this component just star it. A developer is more motivated to improve a project when there is some interest.

data/lib/eventish/active_record/callback.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Eventish
+  module ActiveRecord
+    module Callback
+      # Init events
+      def after_initialize_event
+        before_validation -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_find_event
+        before_validation -> { ::Eventish.publish(event, self) }
+      end
+
+      # Validation events
+      def before_validation_event(event)
+        before_validation -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_validation_event(event)
+        after_validation -> { ::Eventish.publish(event, self) }
+      end
+
+      # Create events
+      def before_create_event(event)
+        before_create -> { ::Eventish.publish(event, self) }
+      end
+
+      def around_create_event(event)
+        around_create -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_create_event(event)
+        after_create -> { ::Eventish.publish(event, self) }
+      end
+
+      # Update events
+      def before_update_event(event)
+        before_update -> { ::Eventish.publish(event, self) }
+      end
+
+      def around_update_event(event)
+        around_update -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_update_event(event)
+        after_update -> { ::Eventish.publish(event, self) }
+      end
+
+      # Save events
+      def before_save_event(event)
+        before_save -> { ::Eventish.publish(event, self) }
+      end
+
+      def around_save_event(event)
+        around_save -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_save_event(event)
+        after_save -> { ::Eventish.publish(event, self) }
+      end
+
+      # Destroy events
+      def before_destroy_event(event)
+        before_destroy -> { ::Eventish.publish(event, self) }
+      end
+
+      def around_destroy_event(event)
+        around_destroy -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_destroy_event(event)
+        after_destroy -> { ::Eventish.publish(event, self) }
+      end
+
+      # Commit events
+      def after_commit_event(event)
+        after_commit -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_save_commit_event(event)
+        after_save_commit -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_create_commit_event(event)
+        after_create_commit -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_update_commit_event(event)
+        after_update_commit -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_destroy_commit_event(event)
+        after_destroy_commit -> { ::Eventish.publish(event, self) }
+      end
+
+      def after_rollback_event(event)
+        after_rollback -> { ::Eventish.publish(event, self) }
+      end
+
+      # Touch events
+      def after_touch_event(event)
+        after_touch -> { ::Eventish.publish(event, self) }
+      end
+    end
+  end
+end

data/lib/eventish/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Eventish # :nodoc:
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eventish
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Mattia Roccoberton
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-18 00:00:00.000000000 Z
+date: 2022-05-19 00:00:00.000000000 Z
 dependencies: []
 description: A simple and composable event library
 email: mat@blocknot.es
@@ -20,6 +20,7 @@ files:
 - README.md
 - lib/eventish.rb
 - lib/eventish/active_job_event.rb
+- lib/eventish/active_record/callback.rb
 - lib/eventish/adapters/active_support.rb
 - lib/eventish/event_api.rb
 - lib/eventish/simple_event.rb