zen-service 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64770c881ffd916d2ae348ea1e0e1b2f50f0ae1ddfe77e4cb33488894800a241
-  data.tar.gz: 1cf89ac8571af9af101ddfe2458a0a09e371a40e6d1e6bab9a58be0c0eec1445
+  metadata.gz: 83f9ef4ebaca920508cb7aa96f3ce4eea6b899338b000c5a38edc6cacf342473
+  data.tar.gz: 86a27632c1fc83f7ba7c735bea83c41a1b0d9e52b2d546bfdd3054e4766c447d
 SHA512:
-  metadata.gz: 6467ffcd8497764c8974f45cef7106865d3109c3a794a2b7cbefd6342a3d69599392f56a83386be728ecca753fdf247a554ebd8b20c726ccc723b767618f54eb
-  data.tar.gz: '034914344b92311d62df7eec453791f87b39111a1d6f29c5344761718468c6f103a012a8981a37b0e358f612ab581ec29d4bb2a65f2b86f3a1f88ce303628157'
+  metadata.gz: 755c8e023bed8067af7fd509018ff8a001cb5618cde43fc00aa6b0244165482d58fadea79becc7b4ebb9f6a1e87aef9d9901aebd54e2218390553c2fcd71edbc
+  data.tar.gz: 55ae83ddff091119dff6b1448e37e704dcdf39cdc616fcc11b51cccd3c979113e41df8396c1cb5688c459dcc3002534ea2f512c54815a3ceecf85cc74e89d8b5

data/README.md

@@ -98,7 +98,9 @@ simplicity.
 However, `zen-service` still provides a couple of helpfull plugins out-of-the-box:
 
 - `:persisted_result` - provides `#result` method that returns value of the latest `#call`
-  method call. Also provides `#called?` helper method.
+  method call. Also provides `#called?` helper method. Supports `call_unless_called` option.
+  When set to `true`, calling `service.result` method will call `#call` method if it has
+  not yet been called. Default value is `false`.
 
 - `:result_yielding` - can be used in junction with nested service calls to result with
   block-provided value instead of nested service `call` return value. For example:

data/lib/zen/service/plugins/callable.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "ostruct"
-
 module Zen
   module Service::Plugins
     module Callable

data/lib/zen/service/plugins/persisted_result.rb

@@ -1,20 +1,18 @@
 # frozen_string_literal: true
 
-require "ostruct"
-
 module Zen
   module Service::Plugins
     module PersistedResult
       extend Plugin
 
+      default_options call_unless_called: false
+
       module Extension
         def call
           @result = super
         end
       end
 
-      attr_reader :result
-
       def initialize(*, **)
         super
         extend(Extension)
@@ -23,6 +21,12 @@ module Zen
       def called?
         defined?(@result)
       end
+
+      def result
+        call if self.class.plugins[:persisted_result].options[:call_unless_called] && !called?
+
+        @result
+      end
     end
   end
 end

data/lib/zen/service/plugins/pluggable.rb

@@ -11,7 +11,7 @@ module Zen
         defaults = extension.config[:default_options]
         opts = defaults.merge(opts) unless defaults.nil?
 
-        if using?(name)
+        if service_plugins.key?(name)
           extension.configure(self, **opts, &block) if extension.respond_to?(:configure)
           return extension
         end
@@ -23,8 +23,16 @@ module Zen
         plugins.key?(name)
       end
 
+      def service_plugins
+        @service_plugins ||= {}
+      end
+
       def plugins
-        @plugins ||= {}
+        ancestors
+          .select { |klass| klass <= ::Zen::Service }
+          .flat_map(&:service_plugins)
+          .reverse
+          .reduce(&:merge)
       end
       alias extensions plugins
 
@@ -37,7 +45,7 @@ module Zen
         extension.used(self, **opts, &block) if extension.respond_to?(:used)
         extension.configure(self, **opts, &block) if extension.respond_to?(:configure)
 
-        plugins[name] = Reflection.new(extension, opts.merge(block:))
+        service_plugins[name] = Reflection.new(extension, opts.merge(block:))
 
         extension
       end

data/lib/zen/service/plugins/result_yielding.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "ostruct"
-
 module Zen
   module Service::Plugins
     module ResultYielding

data/lib/zen/service/plugins.rb

@@ -8,15 +8,21 @@ module Zen
       plugins[name] || raise("extension `#{name}` is not registered")
     end
 
-    def self.register(name, extension)
-      raise(ArgumentError, "extension `#{name}` is already registered") if plugins.key?(name)
-
-      plugins[name] =
-        if (old_name = plugins.key(extension))
-          plugins.delete(old_name)
-        else
-          extension
+    def self.register(name_or_hash, extension = nil)
+      if name_or_hash.is_a?(Hash)
+        name_or_hash.each do |name, ext|
+          register(name, ext)
         end
+      else
+        raise ArgumentError, "extension must be given" if extension.nil?
+
+        plugins[name_or_hash] =
+          if (old_name = plugins.key(extension))
+            plugins.delete(old_name)
+          else
+            extension
+          end
+      end
     end
 
     def self.plugins

data/lib/zen/service/version.rb

@@ -2,6 +2,6 @@
 
 module Zen
   class Service
-    VERSION = "2.0.0"
+    VERSION = "2.1.0"
   end
 end

data/lib/zen/service.rb

@@ -5,8 +5,6 @@ require_relative "service/plugins"
 
 module Zen
   class Service
-    autoload :SpecHelpers, "zen/service/spec_helpers"
-
     extend Plugins::Pluggable
 
     use :callable

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zen-service
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Artem Kuzko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-12-07 00:00:00.000000000 Z
+date: 2025-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry