zen-service 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4c9b04897987c5d00fe1d73e2c4e4151be3292467ce87ed00317bae09c9d9f2
-  data.tar.gz: 4300a61cfe877b2c7212f7a8cf77da13b7ea0936bc033e0eab6f8f21e4df9138
+  metadata.gz: 64770c881ffd916d2ae348ea1e0e1b2f50f0ae1ddfe77e4cb33488894800a241
+  data.tar.gz: 1cf89ac8571af9af101ddfe2458a0a09e371a40e6d1e6bab9a58be0c0eec1445
 SHA512:
-  metadata.gz: 5e679eada81a3ab7fe338efc42c55e0ee9f8e3fda73e3b7a84ddd9b47e3b83a0ea598931730cf09790167463bcec4310894a6402898817032a280f94df2d2298
-  data.tar.gz: 0ce64d370187a540947d4931c780b3c2fa46b4408aaf229376f988111f26682dc8eeeea1287901fa94a49c4ff50aa49c4c49d9d7fce3bd180a7d2f05439e0531
+  metadata.gz: 6467ffcd8497764c8974f45cef7106865d3109c3a794a2b7cbefd6342a3d69599392f56a83386be728ecca753fdf247a554ebd8b20c726ccc723b767618f54eb
+  data.tar.gz: '034914344b92311d62df7eec453791f87b39111a1d6f29c5344761718468c6f103a012a8981a37b0e358f612ab581ec29d4bb2a65f2b86f3a1f88ce303628157'

data/.rubocop.yml

@@ -1,12 +1,12 @@
 AllCops:
   NewCops: disable
-  TargetRubyVersion: 2.4
+  TargetRubyVersion: 3.2
 
 Style/StringLiterals:
   EnforcedStyle: double_quotes
 
 Style/AccessModifierDeclarations:
-  EnforcedStyle: inline
+  EnforcedStyle: group
 
 Style/Documentation:
   Enabled: false

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.2.2

data/README.md

@@ -2,7 +2,6 @@
 
 Flexible and highly extensible Service Objects for business logic organization.
 
-[![build status](https://secure.travis-ci.org/akuzko/zen-service.png)](http://travis-ci.org/akuzko/zen-service)
 [![github release](https://img.shields.io/github/release/akuzko/zen-service.svg)](https://github.com/akuzko/zen-service/releases)
 
 ## Installation
@@ -21,42 +20,22 @@ Or install it yourself as:
 
     $ gem install zen-service
 
-## Preface
-
-From the beginning of Rails times, proper business logic code organization has always
-been a problem. Some code was placed in models, some in controllers, and complexity of
-both made applications hard to maintain. Then, patterns like "decorators", "facades" and
-"presenters" appeared to take care of certain part of logic. Finally, multiple service
-object solutions were proposed by many developers. This gem is one of such solutions, but
-with a significant difference.
-
-`Zen` services are aimed to take care of *all* business logic in your application, no
-matter what it is aimed for, and how complicated it is. From simplest cases of managing
-single model, to the most complicated logic related with external requests, `Zen` services
-got you covered. They are highly extendable due to plugin-based approach, composable and
-debuggable.
-
-Side note: as can be seen from commit history, this gem was initially called as `excom`,
-which stood for **Ex**ecutable **Com**and.
-
 ## Usage
 
-General idea behind every `Zen` service is simple: each service can have optional attributes,
-and should define `execute!` method that is called during service execution. Executed service
-responds to `success?` and has `result`.
-
 The very basic usage of `Zen` services can be shown with following example:
 
 ```rb
 # app/services/todos/update.rb
 module Todos
-  class Update < Zen::Service
+  class Update < ApplicationService # base class for app services, inherits from Zen::Service
     attributes :todo, :params
 
-    delegate :errors, to: :todo
-
-    def execute!
-      todo.update(params)
+    def call
+      if todo.update(params)
+        [:ok, todo]
+      else
+        [:error, todo.errors.messages]
+      end
     end
   end
 end
@@ -64,13 +43,9 @@ end
 # app/controllers/todos/controller
 class TodosController < ApplicationController
   def update
-    service = Todos::Update.new(todo, params: todo_params)
-
-    if service.execute.success?
-      # class .[] method initializes service with passed arguments, executes it and returns it's result
-      render json: Todos::Show[service.result]
-    else
-      render json: service.errors, status: service.status
+    case Todos::Update.call(todo, params: todo_params)
+    in [:ok, todo] then render json: Todos::Show.call(todo)
+    in [:error, errors] then render json: errors, status: :unprocessable_content
     end
   end
 end
@@ -91,7 +66,7 @@ were not declared with `attributes` class method.
 class MyService < Zen::Service
   attributes :foo, :bar
 
-  def execute!
+  def call
     # do something
   end
 
@@ -112,163 +87,79 @@ s3.foo # => 1
 s3.bar # => 2
 ```
 
-### Service Execution
-
-Read full version on [wiki](https://github.com/akuzko/zen-service/wiki#service-execution).
-
-At the core of each service's execution lies `execute!` method. By default, you can use
-`success`, `failure` and `result` methods to set execution success flag and result. If none
-were used, result and success flag will be set based on `execute!` method's return value.
-
-Example:
-
-```rb
-class Users::Create < Zen::Service
-  attributes :params
-
-  def execute!
-    result { User.create(params) } # explicit result assignment
-
-    send_invitation_email if success?
-  end
-end
-
-class Users::Update < Zen::Service
-  attributes :user, :params
-
-  def execute!
-    user.update(params) # implicit result assignment
-  end
-end
-
-service = Users::Create.new(valid_params)
-service.execute.success? # => true
-service.result # => instance of User
-```
-
-### Core API
-
-Please read about core API and available class and instance methods on [wiki](https://github.com/akuzko/zen-service/wiki#core-api)
-
 ### Service Extensions (Plugins)
 
 Read full version on [wiki](https://github.com/akuzko/zen-service/wiki/Plugins).
 
 `zen-service` is built with extensions in mind. Even core functionality is organized in plugins that are
-used in base `Zen::Service` class. Bellow you can see a list of plugins with some description
-and examples that are shipped with the gem:
+used in base `Zen::Service` class. Version 2.0.0 drops majority of built-in plugins for sake of
+simplicity.
 
-- [`:status`](https://github.com/akuzko/zen-service/wiki/Plugins#status) - Adds `status` execution state
-property to the service, as well as helper methods and behavior to set it. `status` property is not
-bound to the "success" flag of execution state and can have any value depending on your needs. It
-is up to you to setup which statuses correspond to successful execution and which are not. Generated
-status helper methods allow to atomically and more explicitly assign both status and result at
-the same time:
+However, `zen-service` still provides a couple of helpfull plugins out-of-the-box:
 
-```rb
-class Posts::Update < Zen::Service
-  use :status,
-    success: [:ok],
-    failure: [:unprocessable_entity]
-
-  attributes :post, :params
+- `:persisted_result` - provides `#result` method that returns value of the latest `#call`
+  method call. Also provides `#called?` helper method.
 
-  delegate :errors, to: :post
+- `: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:
 
-  def execute!
-    if post.update(params)
-      ok { post.as_json }
-    else
-      unprocessable_entity
+  ```rb
+    def call
+      logger.call do # logger uses `:result_yielding` plugin
+        todo.update!(params)
+        [:ok, todo]
+      rescue ActiveRecord::RecordInvalid
+        [:error, todo.errors.messages]
+      end
     end
-  end
-end
-
-service = Posts::Update.(post, post_params)
-# in case params were valid you will have:
-service.success? # => true
-service.status # => :ok
-service.result # => {'id' => 1, ...}
-```
+  ```
 
-Note that just like `success`, `failure`, or `result` methods, status helpers accept result value
-as result of yielded block.
-
-- [`:context`](https://github.com/akuzko/zen-service/wiki/Plugins#context) - Allows you to set an execution
-context for a block that will be available to any service that uses this plugin via `context` method.
+Bellow you can see sample implementation of a plugin that transforms resulting objects
+to camel-case notation (relying on ActiveSupport's core extensions)
 
 ```rb
-# application_controller.rb
-around_action :with_context
+module CamelizeResult
+  extend Zen::Service::Plugin
 
-def with_context
-  Zen::Service.with_context(current_user: current_user) do
-    yield
+  def self.used(service_class)
+    service_class.prepend(Extension)
   end
-end
-```
 
-```rb
-class Posts::Archive < Zen::Service
-  use :context
-
-  attributes :post
+  def self.camelize(obj)
+    case obj
+    when Array then obj.map { camelize(_1) }
+    when Hash then obj.deep_transform_keys { _1.to_s.camelize(:lower).to_sym }
+    else obj
+    end
+  end
 
-  def execute!
-    post.update(archived: true, archived_by: context[:current_user])
+  module Extension
+    def call
+      CamelizeResult.camelize(super)
+    end
   end
 end
 ```
 
-- [`:policies`](https://github.com/akuzko/zen-service/wiki/Plugins#policies) - Allows you to define permission
-checks within a service that can be used in other services for checks and guard violations. Much like
-[pundit](https://github.com/elabs/pundit) Policies (hence the name), but more. Where pundit governs only
-authorization logic, `zen-service`'s "policy" services can have any denial reason you find appropriate, and declare
-logic for different denial reasons in single place. It also defines `#execute!` method that will result in
-hash with all permission checks.
+and then
 
 ```rb
-class Posts::Policies < Zen::Service
-  use :policies
-
-  attributes :post, :user
+class Todos::Show < Zen::Service
+  attributes :todo
 
-  deny_with :unauthorized do
-    def publish?
-      # only author can publish a post
-      post.author_id == user.id
-    end
-
-    def delete?
-      publish?
-    end
-  end
+  use :camelize_result
 
-  deny_with :unprocessable_entity do
-    def delete?
-      # disallow to destroy posts that are older than 1 hour
-      (post.created_at + 1.hour).past?
-    end
+  def call
+    {
+      id: todo.id,
+      is_completed: todo.completed?
+    }
   end
 end
 
-policies = Posts::Policies.new(outdated_post, user)
-policies.can?(:publish)     # => true
-policies.can?(:delete)      # => false
-policies.why_cant?(:delete) # => :unprocessable_entity
-policies.guard!(:delete)    # => raises Zen::Service::Plugins::Policies::GuardViolationError, :unprocessable_entity
-policies.execute.result     # => {'publish' => true, 'delete' => false}
+Todos::Show[todo] # => { id: 1, isCompleted: true }
 ```
 
-- [`:assertions`](https://github.com/akuzko/zen-service/wiki/Plugins#assertions) - Provides `assert` method that
-can be used for different logic checks during service execution.
-
-- [`:execution_cache`](https://github.com/akuzko/zen-service/wiki/Plugins#execution_cache) - Simple plugin that will prevent
-re-execution of service if it already has been executed, and will immediately return result.
-
-- [`:rescue`](https://github.com/akuzko/zen-service/wiki/Plugins#rescue) - Provides `:rescue` execution option.
-If set to `true`, any error occurred during service execution will not be raised outside.
-
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
@@ -281,4 +172,3 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/akuzko
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-

data/bin/console

@@ -4,70 +4,5 @@
 require "bundler/setup"
 require "zen/service"
 
-class Show < Zen::Service
-  use :execution_cache
-
-  attributes :foo
-
-  def execute!
-    sleep(1)
-    { foo: foo }
-  end
-end
-
-class MyErrors < Hash
-  def add(key, message)
-    (self[key] ||= []) << message
-  end
-end
-
-class Policies < Zen::Service
-  use :policies
-
-  attributes :foo, :bar, :threshold
-
-  deny_with :unauthorized do
-    def save?
-      foo != 6
-    end
-  end
-
-  deny_with :unprocessable_entity do
-    def save?
-      foo != 7
-    end
-
-    def bar?
-      bar && bar > threshold
-    end
-  end
-end
-
-class Save < Zen::Service
-  use :status
-  use :validation, errors_class: MyErrors
-  use :assertions
-
-  attributes :foo, :bar
-
-  def foo
-    super || 6
-  end
-
-  def execute!
-    result { foo * 2 }
-    assert { foo > bar }
-  end
-
-  private def validate
-    errors.add(:foo, "invalid") unless policies.can?(:save)
-    errors.add(:bar, "too small") unless policies.can?(:bar)
-  end
-
-  private def policies
-    @policies ||= Policies.new(foo: foo, bar: bar, threshold: 0)
-  end
-end
-
 require "pry"
 Pry.start

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

@@ -5,8 +5,8 @@ module Zen
     module Attributes
       extend Plugin
 
-      def initialize(*args)
-        @attributes = assert_valid_attributes!(resolve_args!(args))
+      def initialize(*args, **kwargs)
+        @attributes = assert_valid_attributes!(resolve_args!(args, kwargs))
 
         super()
       end
@@ -20,24 +20,28 @@ module Zen
         clone.tap { |copy| copy.attributes.merge!(attributes) }
       end
 
-      protected def attributes
+      protected
+
+      def attributes
         @attributes
       end
 
-      private def resolve_args!(args) # rubocop:disable Metrics/AbcSize
-        opts = args.last.is_a?(Hash) ? args.pop : {}
+      private
+
+      def resolve_args!(args, kwargs) # rubocop:disable Metrics/AbcSize
         attributes = {}
+        total_length = args.length + kwargs.length
         allowed_length = self.class.attributes_list.length
 
-        if args.length > allowed_length
-          raise ArgumentError, "wrong number of attributes (given #{args.length}, expected 0..#{allowed_length})"
+        if total_length > allowed_length
+          raise ArgumentError, "wrong number of attributes (given #{total_length}, expected 0..#{allowed_length})"
         end
 
         args.each_with_index do |value, i|
           attributes[self.class.attributes_list[i]] = value
         end
 
-        opts.each do |name, value|
+        kwargs.each do |name, value|
           raise(ArgumentError, "attribute #{name} has already been provided as parameter") if attributes.key?(name)
 
           attributes[name] = value
@@ -46,7 +50,7 @@ module Zen
         attributes
       end
 
-      private def assert_valid_attributes!(actual)
+      def assert_valid_attributes!(actual)
         unexpected = actual.keys - self.class.attributes_list
 
         raise(ArgumentError, "wrong attributes #{unexpected} given") if unexpected.any?
@@ -58,7 +62,7 @@ module Zen
         def inherited(service_class)
           service_class.const_set(:AttributeMethods, Module.new)
           service_class.send(:include, service_class::AttributeMethods)
-          service_class.attributes_list.replace attributes_list.dup
+          service_class.attributes_list.replace(attributes_list.dup)
           super
         end
 

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Zen
+  module Service::Plugins
+    module Callable
+      extend Plugin
+
+      def call
+        # No-op by default
+      end
+
+      module ClassMethods
+        def call(...)
+          new(...).call
+        end
+        alias [] call
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Zen
+  module Service::Plugins
+    module PersistedResult
+      extend Plugin
+
+      module Extension
+        def call
+          @result = super
+        end
+      end
+
+      attr_reader :result
+
+      def initialize(*, **)
+        super
+        extend(Extension)
+      end
+
+      def called?
+        defined?(@result)
+      end
+    end
+  end
+end

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

@@ -3,6 +3,8 @@
 module Zen
   module Service::Plugins
     module Pluggable
+      Reflection = Struct.new(:extension, :options)
+
       def use(name, **opts, &block)
         extension = Service::Plugins.fetch(name)
 
@@ -17,18 +19,6 @@ module Zen
         use_extension(extension, name, **opts, &block)
       end
 
-      private def use_extension(extension, name, **opts, &block)
-        include extension
-        extend extension::ClassMethods if extension.const_defined?(:ClassMethods)
-
-        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: block))
-
-        extension
-      end
-
       def using?(name)
         plugins.key?(name)
       end
@@ -38,7 +28,19 @@ module Zen
       end
       alias extensions plugins
 
-      Reflection = Struct.new(:extension, :options)
+      private
+
+      def use_extension(extension, name, **opts, &block)
+        include extension
+        extend extension::ClassMethods if extension.const_defined?(:ClassMethods)
+
+        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:))
+
+        extension
+      end
     end
   end
 end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "ostruct"
+
+module Zen
+  module Service::Plugins
+    module ResultYielding
+      extend Plugin
+
+      module Extension
+        def call
+          return super unless block_given?
+
+          result = nil
+          super do
+            result = yield
+          end
+          result
+        end
+      end
+
+      def self.used(service_class)
+        service_class.prepend(Extension)
+      end
+    end
+  end
+end

data/lib/zen/service/plugins.rb

@@ -26,13 +26,8 @@ module Zen
 
   require_relative "plugins/plugin"
   require_relative "plugins/pluggable"
-  require_relative "plugins/executable"
+  require_relative "plugins/callable"
   require_relative "plugins/attributes"
-  require_relative "plugins/assertions"
-  require_relative "plugins/context"
-  require_relative "plugins/execution_cache"
-  require_relative "plugins/policies"
-  require_relative "plugins/rescue"
-  require_relative "plugins/status"
-  require_relative "plugins/validation"
+  require_relative "plugins/persisted_result"
+  require_relative "plugins/result_yielding"
 end

data/lib/zen/service/version.rb

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

data/lib/zen/service.rb

@@ -9,7 +9,7 @@ module Zen
 
     extend Plugins::Pluggable
 
-    use :executable
+    use :callable
     use :attributes
   end
 end

data/zen-service.gemspec

@@ -12,7 +12,7 @@ Gem::Specification.new do |spec|
   spec.description   = "Flexible and highly extensible Services for business logic organization"
   spec.homepage      = "https://github.com/akuzko/zen-service"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.2.0")
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org/"
 
@@ -33,5 +33,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
   spec.add_development_dependency "rspec-its", "~> 1.2"
-  spec.add_development_dependency "rubocop", "~> 0.80"
+  spec.add_development_dependency "rubocop", "~> 1.81"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zen-service
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Artem Kuzko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-10-09 00:00:00.000000000 Z
+date: 2025-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.80'
+        version: '1.81'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.80'
+        version: '1.81'
 description: Flexible and highly extensible Services for business logic organization
 email:
 - a.kuzko@gmail.com
@@ -104,7 +104,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
+- ".tool-versions"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -113,18 +113,12 @@ files:
 - bin/setup
 - lib/zen/service.rb
 - lib/zen/service/plugins.rb
-- lib/zen/service/plugins/assertions.rb
 - lib/zen/service/plugins/attributes.rb
-- lib/zen/service/plugins/context.rb
-- lib/zen/service/plugins/executable.rb
-- lib/zen/service/plugins/execution_cache.rb
+- lib/zen/service/plugins/callable.rb
+- lib/zen/service/plugins/persisted_result.rb
 - lib/zen/service/plugins/pluggable.rb
 - lib/zen/service/plugins/plugin.rb
-- lib/zen/service/plugins/policies.rb
-- lib/zen/service/plugins/rescue.rb
-- lib/zen/service/plugins/status.rb
-- lib/zen/service/plugins/validation.rb
-- lib/zen/service/spec_helpers.rb
+- lib/zen/service/plugins/result_yielding.rb
 - lib/zen/service/version.rb
 - zen-service.gemspec
 homepage: https://github.com/akuzko/zen-service
@@ -142,7 +136,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.travis.yml

@@ -1,4 +0,0 @@
-language: ruby
-rvm:
-  - 2.4.0
-before_install: gem install bundler -v 1.16.0

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

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module Assertions
-      extend Plugin
-
-      private def assert
-        if yield
-          success! unless state.has_success?
-        else
-          failure!
-        end
-      end
-    end
-  end
-end

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

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module Context
-      extend Plugin
-
-      attr_accessor :local_context
-      protected :local_context, :local_context=
-
-      def context
-        global_context = ::Zen::Service.context
-        return global_context if local_context.nil?
-
-        if global_context.respond_to?(:merge)
-          global_context.merge(local_context)
-        else
-          local_context
-        end
-      end
-
-      def with_context(ctx)
-        clone.tap do |copy|
-          copy.local_context =
-            copy.local_context.respond_to?(:merge) ? copy.local_context.merge(ctx) : ctx
-        end
-      end
-
-      def execute(*)
-        ::Zen::Service.with_context(context) do
-          super
-        end
-      end
-
-      module ServiceMethods
-        def with_context(ctx)
-          current = context
-          Thread.current[:zen_service_context] = context.respond_to?(:merge) ? context.merge(ctx) : ctx
-
-          yield
-        ensure
-          Thread.current[:zen_service_context] = current
-        end
-
-        def context
-          Thread.current[:zen_service_context]
-        end
-      end
-
-      service_extension ServiceMethods
-    end
-  end
-end

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

@@ -1,179 +0,0 @@
-# frozen_string_literal: true
-
-require "ostruct"
-
-module Zen
-  module Service::Plugins
-    module Executable
-      extend Plugin
-
-      class State
-        def self.prop_names
-          @prop_names ||= []
-        end
-
-        def self.add_prop(*props)
-          prop_names.push(*props)
-          props.each { |prop| def_prop_accessor(prop) }
-        end
-
-        def self.def_prop_accessor(name)
-          define_method(name) { @values[name] }
-          define_method("#{name}=") { |value| @values[name] = value }
-          define_method("has_#{name}?") { @values.key?(name) }
-        end
-
-        def initialize(values = {})
-          @values = values
-        end
-
-        def clear!
-          @values.clear
-        end
-
-        def prop_names
-          self.class.prop_names
-        end
-
-        def replace(other)
-          missing_props = prop_names - other.prop_names
-
-          unless missing_props.empty?
-            raise ArgumentError, "cannot accept execution state #{other} due to missing props: #{missing_props}"
-          end
-
-          prop_names.each do |prop|
-            @values[prop] = other.public_send(prop)
-          end
-        end
-      end
-
-      def self.used(service_class, *)
-        service_class.const_set(:State, Class.new(State))
-        service_class.add_execution_prop(:executed, :success, :result)
-      end
-
-      attr_reader :state
-
-      def initialize(*)
-        @state = self.class::State.new(executed: false)
-      end
-
-      def initialize_clone(*)
-        clear_execution_state!
-      end
-
-      def execute(*, &block)
-        clear_execution_state!
-        result = execute!(&block)
-        result_with(result) unless state.has_result?
-        state.executed = true
-
-        self
-      end
-
-      def executed?
-        state.executed
-      end
-
-      def ~@
-        state
-      end
-
-      private def execute!
-        success!
-      end
-
-      private def clear_execution_state!
-        state.clear!
-        state.executed = false
-      end
-
-      private def success(**)
-        assign_successful_state
-        assign_successful_result(yield)
-      end
-
-      private def failure(**)
-        assign_failed_state
-        assign_failed_result(yield)
-      end
-
-      private def success!(**)
-        assign_successful_state
-      end
-
-      private def failure!(**)
-        assign_failed_state
-      end
-
-      private def assign_successful_state
-        state.success = true
-        state.result = nil
-      end
-
-      private def assign_failed_state
-        state.success = false
-        state.result = nil
-      end
-
-      private def assign_successful_result(value)
-        state.result = value
-      end
-
-      private def assign_failed_result(value)
-        state.result = value
-      end
-
-      def result
-        return state.result unless block_given?
-
-        result_with(yield)
-      end
-
-      private def result_with(obj)
-        return state.replace(obj) if obj.is_a?(State)
-
-        state.success = !!obj
-        if state.success
-          assign_successful_result(obj)
-        else
-          assign_failed_result(obj)
-        end
-      end
-
-      def success?
-        state.success == true
-      end
-
-      def failure?
-        !success?
-      end
-
-      module ClassMethods
-        def inherited(klass)
-          klass.const_set(:State, Class.new(self::State))
-          klass::State.prop_names.replace(self::State.prop_names.dup)
-        end
-
-        def add_execution_prop(*props)
-          self::State.add_prop(*props)
-        end
-
-        def call(*args)
-          new(*args).execute
-        end
-        alias execute call
-
-        def [](*args)
-          call(*args).result
-        end
-
-        def method_added(name)
-          private :execute! if name == :execute!
-          super if defined? super
-        end
-      end
-    end
-  end
-end

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

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module ExecutionCache
-      extend Plugin
-
-      def initialize(*)
-        super
-        extend Extension
-      end
-
-      module Extension
-        def execute(*)
-          return super if block_given? || !executed?
-
-          self
-        end
-      end
-    end
-  end
-end

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

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module Policies
-      extend Plugin
-
-      GuardViolationError = Class.new(StandardError)
-
-      def self.used(service_class, *)
-        service_class.partials = []
-      end
-
-      private def execute!
-        partials.each_with_object({}) do |partial, permissions|
-          partial.public_methods(false).grep(/\?$/).each do |action_check|
-            key = action_check.to_s[0...-1]
-            can = partial.public_send(action_check)
-
-            permissions[key] = permissions.key?(key) ? permissions[key] && can : can
-          end
-        end
-      end
-
-      def can?(action)
-        why_cant?(action).nil?
-      end
-
-      def guard!(action)
-        reason = why_cant?(action)
-
-        return if reason.nil?
-
-        raise(reason) if (reason.is_a?(Class) ? reason : reason.class) < Exception
-
-        raise(GuardViolationError, reason)
-      end
-
-      def why_cant?(action)
-        action_check = "#{action}?"
-
-        reason =
-          partials
-          .find { |p| p.respond_to?(action_check) && !p.public_send(action_check) }
-            &.class
-            &.denial_reason
-
-        reason.is_a?(Proc) ? instance_exec(&reason) : reason
-      end
-
-      private def partials
-        @partials ||= self.class.partials.map do |klass|
-          klass.from(self)
-        end
-      end
-
-      module ClassMethods
-        attr_accessor :partials, :denial_reason
-
-        def deny_with(reason, &block)
-          partial = Class.new(self, &block)
-          partial.denial_reason = reason
-          partials << partial
-        end
-      end
-    end
-  end
-end

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

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module Rescue
-      extend Plugin
-
-      def self.used(service_class, *)
-        service_class.use(:status) unless service_class.using?(:status)
-        service_class.add_execution_prop(:error)
-      end
-
-      def execute(**opts)
-        rezcue = opts.delete(:rescue)
-        super
-      rescue StandardError => e
-        clear_execution_state!
-        failure!(status: :error)
-        state.error = e
-        raise e unless rezcue
-
-        self
-      end
-
-      def error
-        state.error
-      end
-
-      def error?
-        status == :error
-      end
-    end
-  end
-end

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

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module Status
-      extend Plugin
-
-      default_options(success: [], failure: [])
-
-      def self.used(service_class, **)
-        service_class.add_execution_prop(:status)
-
-        helpers = Module.new
-        service_class.const_set(:StatusHelpers, helpers)
-        service_class.send(:include, helpers)
-      end
-
-      def self.configure(service_class, success:, failure:)
-        service_class::StatusHelpers.module_eval do
-          success.each do |name|
-            define_method(name) do |**opts, &block|
-              success(status: name, **opts, &block)
-            end
-          end
-
-          failure.each do |name|
-            define_method(name) do |**opts, &block|
-              failure(status: name, **opts, &block)
-            end
-          end
-        end
-      end
-
-      def status
-        state.status
-      end
-
-      private def success!(status: :success, **)
-        state.status = status
-        super
-      end
-
-      private def success(status: :success, **)
-        state.status = status
-        super
-      end
-
-      private def failure!(status: :failure, **)
-        state.status = status
-        super
-      end
-
-      private def failure(status: :failure, **)
-        super.tap do
-          state.status = status
-        end
-      end
-
-      private def result_with(*)
-        super
-        state.status ||= state.success ? :success : :failure
-      end
-    end
-  end
-end

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

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::Plugins
-    module Validation
-      extend Plugin
-
-      class Errors < Hash
-        def add(key, message)
-          (self[key] ||= []).push(message)
-        end
-      end
-
-      default_options(errors_class: Errors)
-
-      def self.used(service_class, *)
-        service_class.add_execution_prop(:errors)
-      end
-
-      private def initialize(*)
-        super
-        state.errors = errors_class.new
-      end
-
-      def execute(*)
-        return super if valid?
-
-        failure!(status: :invalid)
-
-        self
-      end
-
-      def errors
-        state.errors
-      end
-
-      private def errors_class
-        self.class.plugins[:validation].options[:errors_class]
-      end
-
-      private def validate!
-        errors.clear
-        validate
-      end
-
-      def validate; end
-
-      def valid?
-        validate!
-        errors.empty?
-      end
-
-      private def clear_execution_state!
-        super
-        state.errors = errors_class.new
-      end
-    end
-  end
-end

data/lib/zen/service/spec_helpers.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-module Zen
-  module Service::SpecHelpers
-    def self.included(target)
-      target.extend(ClassMethods)
-    end
-
-    # Example:
-    #   stub_service(MyService)
-    #     .with_atributes(foo: 'foo')
-    #     .with_stubs(result: 'bar', success: true)
-    #     .service
-    def stub_service(service)
-      ServiceMocker.new(self).stub_service(service)
-    end
-
-    module ClassMethods
-      def service_context(&block)
-        around do |example|
-          ::Zen::Service.with_context(instance_exec(&block)) do
-            example.run
-          end
-        end
-      end
-    end
-
-    class ServiceMocker < SimpleDelegator
-      attr_reader :service_class, :service
-
-      def stub_service(service_class) # rubocop:disable Metrics/AbcSize
-        @service_class = service_class
-        @service = double(service_class.name)
-
-        allow(service_class).to receive(:new).and_return(service)
-        allow(service).to receive(:execute).and_return(service)
-        allow(service).to receive(:executed?).and_return(true)
-
-        self
-      end
-
-      def with_attributes(*attributes)
-        expect(service_class).to receive(:new).with(*attributes).and_return(service)
-
-        self
-      end
-
-      def with_stubs(stubs)
-        stubs[:success?] = !!stubs[:result] unless stubs.key?(:success)
-        stubs[:failure?] = !stubs[:success?]
-
-        stubs.each do |name, value|
-          allow(service).to receive(name).and_return(value)
-        end
-
-        self
-      end
-    end
-  end
-end