u-observers 2.3.0 → 3.0.0

data/bin/setup

@@ -3,6 +3,10 @@ set -euo pipefail
 IFS=$'\n\t'
 set -vx
 
+rm -f Gemfile.lock
+
 bundle install
 
+bundle exec appraisal install
+
 # Do any other automated setup that you need to do here

data/lib/micro/observers/for/active_model.rb

@@ -6,7 +6,7 @@ module Micro
 
       module ActiveModel
         module ClassMethods
-          def notify_observers!(events)
+          def notify_observers_proc(events)
             proc do |object|
               object.observers.subject_changed!
               object.observers.send(:broadcast_if_subject_changed, events)
@@ -14,19 +14,133 @@ module Micro
           end
 
           def notify_observers(*events)
-            notify_observers!(Event::Names.fetch(events))
+            notify_observers_proc(Event::Names.fetch(events))
           end
 
           def notify_observers_on(*callback_methods)
             Utils::Arrays.fetch_from_args(callback_methods).each do |callback_method|
-              self.public_send(callback_method, &notify_observers!([callback_method]))
+              self.public_send(callback_method, &notify_observers_proc([callback_method]))
             end
           end
+
+          NO_OBSERVERS_TO_NOTIFY_MSG =
+            'no observers (expected at least one observer in `with:`)'.freeze
+
+          NO_EVENT_TO_NOTIFY_MSG =
+            'no event (expected a callback name in `event:`)'.freeze
+
+          def notify_observers!(event:, with:, context: nil, **callback_options)
+            observers = Utils::Arrays.flatten_and_compact(with)
+
+            raise ArgumentError, NO_OBSERVERS_TO_NOTIFY_MSG if observers.empty?
+
+            events = Utils::Arrays.flatten_and_compact(event)
+
+            raise ArgumentError, NO_EVENT_TO_NOTIFY_MSG if events.empty?
+
+            events.each do |callback_method|
+              register_observers_to_notify(callback_method, observers, context)
+
+              install_observers_to_notify_callback(callback_method, callback_options)
+            end
+          end
+
+          # Introspection: the observers declared via `notify_observers!`, keyed
+          # by the callback they fire on. e.g. { after_commit: [TitlePrinter] }
+          def observers_to_notify
+            __observers_to_notify.each_with_object({}) do |(event, entries), result|
+              result[event] = entries.map { |observer, _context| observer } unless entries.empty?
+            end
+          end
+
+          # Remove previously declared observers. Without `from:` they are
+          # removed from every callback; pass `from:` (a callback name or an
+          # array of them) to scope it. With no observers, clears the callback(s).
+          def detach_observers_to_notify(*observers, from: nil)
+            observers = Utils::Arrays.flatten_and_compact(observers)
+            events = from ? Utils::Arrays.flatten_and_compact(from) : __observers_to_notify.keys
+
+            events.each do |event|
+              entries = __observers_to_notify[event]
+
+              next unless entries
+
+              if observers.empty?
+                __observers_to_notify.delete(event)
+              else
+                entries.reject! { |observer, _context| observers.include?(observer) }
+                __observers_to_notify.delete(event) if entries.empty?
+              end
+            end
+
+            observers_to_notify
+          end
+
+          def register_observers_to_notify(event, observers, context)
+            entries = (__observers_to_notify[event] ||= [])
+
+            observers.each do |observer|
+              entries << [observer, context] unless entries.any? { |existing, _| existing == observer }
+            end
+          end
+
+          def install_observers_to_notify_callback(event, callback_options)
+            installed = __observers_to_notify_callbacks
+
+            return if installed[event]
+
+            installed[event] = true
+
+            declaring_class = self
+
+            callback_block = proc do |record|
+              declaring_class.send(:notify_registered_observers, record, event)
+            end
+
+            if callback_options.empty?
+              self.public_send(event, &callback_block)
+            else
+              self.public_send(event, **callback_options, &callback_block)
+            end
+          end
+
+          def notify_registered_observers(record, event)
+            entries = __observers_to_notify[event]
+
+            return if entries.nil? || entries.empty?
+
+            set = record.observers
+
+            entries.each do |observer, context|
+              context ? set.attach(observer, context: context) : set.attach(observer)
+            end
+
+            set.subject_changed!
+            set.send(:broadcast_if_subject_changed, [event])
+          end
+
+          def __observers_to_notify
+            @__observers_to_notify ||= {}
+          end
+
+          def __observers_to_notify_callbacks
+            @__observers_to_notify_callbacks ||= {}
+          end
+
+          private_constant :NO_OBSERVERS_TO_NOTIFY_MSG, :NO_EVENT_TO_NOTIFY_MSG
         end
 
         def self.included(base)
           base.extend(ClassMethods)
-          base.send(:private_class_method, :notify_observers!)
+          base.send(
+            :private_class_method,
+            :notify_observers_proc,
+            :register_observers_to_notify,
+            :install_observers_to_notify_callback,
+            :notify_registered_observers,
+            :__observers_to_notify,
+            :__observers_to_notify_callbacks
+          )
           base.send(:include, ::Micro::Observers)
         end
       end

data/lib/micro/observers/version.rb

@@ -1,5 +1,5 @@
 module Micro
   module Observers
-    VERSION = '2.3.0'
+    VERSION = '3.0.0'
   end
 end

data/u-observers.gemspec

@@ -8,12 +8,13 @@ Gem::Specification.new do |spec|
 
   spec.summary       = %q{Simple and powerful implementation of the observer pattern.}
   spec.description   = %q{Simple and powerful implementation of the observer pattern.}
-  spec.homepage      = 'https://github.com/serradura/u-observers'
+  spec.homepage      = 'https://github.com/u-gems/u-observers'
   spec.license       = 'MIT'
 
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://github.com/serradura/u-observers'
-  spec.metadata['changelog_uri'] = 'https://github.com/serradura/u-observers/releases'
+  spec.metadata['source_code_uri'] = 'https://github.com/u-gems/u-observers'
+  spec.metadata['changelog_uri'] = 'https://github.com/u-gems/u-observers/blob/main/CHANGELOG.md'
+  spec.metadata['bug_tracker_uri'] = "#{spec.homepage}/issues"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -24,8 +25,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = Gem::Requirement.new('>= 2.2.0')
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.7.0')
 
+  spec.add_development_dependency 'appraisal', '~> 2.5'
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'rake', '~> 13.0'
 end

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: u-observers
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Rodrigo Serradura
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-11-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -45,10 +58,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".tool-versions"
-- ".travis.sh"
-- ".travis.yml"
+- Appraisals
+- CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
@@ -56,6 +71,7 @@ files:
 - README.pt-BR.md
 - Rakefile
 - bin/console
+- bin/matrix
 - bin/setup
 - lib/micro/observers.rb
 - lib/micro/observers/broadcast.rb
@@ -70,16 +86,15 @@ files:
 - lib/u-observers.rb
 - lib/u-observers/for/active_model.rb
 - lib/u-observers/for/active_record.rb
-- test.sh
 - u-observers.gemspec
-homepage: https://github.com/serradura/u-observers
+homepage: https://github.com/u-gems/u-observers
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/serradura/u-observers
-  source_code_uri: https://github.com/serradura/u-observers
-  changelog_uri: https://github.com/serradura/u-observers/releases
-post_install_message: 
+  homepage_uri: https://github.com/u-gems/u-observers
+  source_code_uri: https://github.com/u-gems/u-observers
+  changelog_uri: https://github.com/u-gems/u-observers/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/u-gems/u-observers/issues
 rdoc_options: []
 require_paths:
 - lib
@@ -87,15 +102,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.2.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 4.0.12
 specification_version: 4
 summary: Simple and powerful implementation of the observer pattern.
 test_files: []

data/.travis.sh

@@ -1,34 +0,0 @@
-#!/bin/bash
-
-ruby_v=$(ruby -v)
-
-bundle update
-bundle exec rake test
-
-ACTIVERECORD_VERSION='3.2' bundle update
-ACTIVERECORD_VERSION='3.2' bundle exec rake test
-
-ACTIVERECORD_VERSION='4.0' bundle update
-ACTIVERECORD_VERSION='4.0' bundle exec rake test
-
-ACTIVERECORD_VERSION='4.1' bundle update
-ACTIVERECORD_VERSION='4.1' bundle exec rake test
-
-ACTIVERECORD_VERSION='4.2' bundle update
-ACTIVERECORD_VERSION='4.2' bundle exec rake test
-
-ACTIVERECORD_VERSION='5.0' bundle update
-ACTIVERECORD_VERSION='5.0' bundle exec rake test
-
-ACTIVERECORD_VERSION='5.1' bundle update
-ACTIVERECORD_VERSION='5.1' bundle exec rake test
-
-if [[ ! $ruby_v =~ '2.2.0' ]]; then
-  ACTIVERECORD_VERSION='5.2' bundle update
-  ACTIVERECORD_VERSION='5.2' bundle exec rake test
-fi
-
-if [[ $ruby_v =~ '2.5.' ]] || [[ $ruby_v =~ '2.6.' ]] || [[ $ruby_v =~ '2.7.' ]]; then
-  ACTIVERECORD_VERSION='6.0' bundle update
-  ACTIVERECORD_VERSION='6.0' bundle exec rake test
-fi

data/.travis.yml

@@ -1,30 +0,0 @@
----
-language: ruby
-
-sudo: false
-
-rvm:
-- 2.2.0
-- 2.3.0
-- 2.4.0
-- 2.5.0
-- 2.6.0
-- 2.7.0
-
-cache: bundler
-
-before_install:
-  - gem uninstall -v '>= 2' -i $(rvm gemdir)@global -ax bundler || true
-  - gem install bundler -v '< 2'
-
-install: bundle install --jobs=3 --retry=3
-
-before_script:
-  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
-  - chmod +x ./cc-test-reporter
-  - "./cc-test-reporter before-build"
-
-script: "./.travis.sh"
-
-after_success:
-  - "./cc-test-reporter after-build -t simplecov"

data/test.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-
-bundle
-
-rm Gemfile.lock
-
-source $(dirname $0)/.travis.sh
-
-rm Gemfile.lock
-
-bundle