smart_core 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 386622ee9696b78aaf7e86cfcc5eaa6e11591bab6607a355d85b9fbfa90d513a
-  data.tar.gz: 9a905a991a12f36dc775076afa4f9069c099c33351e1d19911be4087789f8858
+  metadata.gz: e2ff8c25822c588b21c3d5785f04998fb1bb838e30b6046cc7e1706891133c6b
+  data.tar.gz: 307a1f6b397dba1339c9e6d4ea701343b349c22261b59e42ae35ccce735b7ff7
 SHA512:
-  metadata.gz: 1d7d6a650e4b4656e932883da4669b3eb2659a1b32e68d70db5eaf48f6d37edd8470ac2400ab3822df60a475ebd669c761899ed08d4613282ef8738be22eda5f
-  data.tar.gz: 648eb736394268e455e478431df012b7658cb434e8fc5ab506fe16f3f81a005fd7fa3fa1c1d1777a0395cd8899490ffc1a47c1f3e05314cf5a1aca078c4662b1
+  metadata.gz: 7755b70015cc2cb2c0cc76c9e3436cda0f7d76170f9109e3e20655ce6e29c16a530b1b522398355329eaa64e5cd139153ba3c93043372b6e734dbfe4994b47a8
+  data.tar.gz: e580d37f900e4e969464b094d4fc4d4795edcc6bbd90e482716dfcbc7147e327543dcf7e8c29ae5905a15ccd29a362b1b3873cc68972e742c3a5fc579696062b

data/.rspec

@@ -1,3 +1,3 @@
 --color
---format=progress
+--format progress
 --require spec_helper

data/.travis.yml

@@ -2,15 +2,19 @@ language: ruby
 sudo: false
 before_install: gem install bundler
 cache: bundler
-rvm:
-- 2.3.8
-- 2.4.5
-- 2.5.3
-- 2.6.0
-- ruby-head
-- jruby-head
-script:
-- bundle exec rspec
+matrix:
+  fast_finish: true
+  include:
+  - rvm: 2.3.8
+  - rvm: 2.4.5
+  - rvm: 2.5.3
+  - rvm: 2.6.0
+  - rvm: ruby-head
+  - rvm: jruby-head
+  allow_failures:
+  - rvm: ruby-head
+  - rvm: jruby-head
+script: bundle exec rspec
 notifications:
   slack:
     secure: CUM3xnSJvn/y6Z+epQrO5uSk1EUuP4S+ugcS+48nlWD6eEzhYZwcBAK9tvD6kYGOPzoWyKSbW6Is1kzSunNr6f8ICc8HtrVHzoHE8UCzwZ7FpjgD0JgMgC4+xLLBO6lV0Hc7dNh4KLAhy4Zvbr09DPjcG8UW9/QgUdn+wBf9LHMgA+2SpBPEzMwz6pMbWW/+kkoCz2KU877kEfuFFGfvoOEFWTxUUhuCYi5a1SmTjm9A7CFTEWNkX8yHJwdgVgONjvm9lnhTeV0DvMeEOhk8Kx/hzQ2OGIicXZXWyZFkzNzpQm5xE12Hs4rY7mGPbo3bsYRDH9Ys6yf4fpNf0oZ/1agzl/gnDzacA2wL2b+eq1uZblE/fdwrNp+GIH0R+Ec2rsVKM7kh71sA6Xp1pzFb2DnHj5O4QFaPMsLyIZqD0BkVt4pNfwi4ZUB56sWkYeRQGm8x2Beh02IyFfxI65lY5kZrW6GjXx5eFeOHcmzQzeADWLSBf4iw01G/A/QqwZzlZ3fm0fRJi8BKDh3Jj0IrGndE9Bl+E7uOClKKngTPxOVLOLo/vY5mfI8M94f99kr0J45XkoAdc0SQfi3hDa/tHaakI5GJsmByjgOQwV7OU/2wzJoXAg/RPYjsYcwnTgzm9bLXPhQzfM8rUS5vLTOWIW+N0QKmWml7eWVtiedcwXA=

data/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.2.0] - 2019-01-20
+### Added
+- **Service object** abstraction (`SmartCore::Operation`);
+- **Validator**
+  - Support for `&block` attribute at object instantiation;
+
 ## [0.1.0] - 2019-01-05
 ### Added
 - Validation object abstraction;

data/README.md

@@ -1,12 +1,75 @@
-# SmartCore · [![Build Status](https://travis-ci.org/0exp/smart_core.svg?branch=master)](https://travis-ci.org/0exp/smart_core) [![Coverage Status](https://coveralls.io/repos/github/0exp/smart_core/badge.svg?branch=master)](https://coveralls.io/github/0exp/smart_core?branch=master)
+# SmartCore · [![Gem Version](https://badge.fury.io/rb/smart_core.svg)](https://badge.fury.io/rb/smart_core) [![Build Status](https://travis-ci.org/0exp/smart_core.svg?branch=master)](https://travis-ci.org/0exp/smart_core) [![Coverage Status](https://coveralls.io/repos/github/0exp/smart_core/badge.svg?branch=master)](https://coveralls.io/github/0exp/smart_core?branch=master)
 
 In active development.
 
+---
+
+## Installation
+
+```ruby
+gem 'smart_core'
+```
+
+```shell
+bundle install
+# --- or ---
+gem install smart_core
+```
+
+```ruby
+require 'smart_core'
+```
+
+---
+
 #### Completed abstractions:
 
-- **Validation object** (`SmartCore::Validator`)
+- [**Operation Object**](#operation-object) (aka `Service Object`) (`SmartCore::Operation`)
+  - attribute definition DSL (`param`, `option`, `params`, `options`);
+  - yieldable result object abstraction (`Success`, `Failure`, `#success?`, `#failure?`);
+  - yieldable `#call` (and `.call`);
+  - inheritance works as expected `:)`;
+  - no dependencies;
+
+- [**Validation Object**](#validation-object) (`SmartCore::Validator`)
   - support for nested validations;
   - inheritance works as expected `:)`;
   - command-style DSL;
   - thread-safe;
   - no dependencies;
+
+---
+
+#### Operation Object
+
+```ruby
+class Service < SmartCore::Operation
+  # soon...
+end
+```
+
+#### Validation Object
+
+```ruby
+class Validator < SmartCore::Validator
+  # soon...
+end
+```
+
+---
+
+## Contributing
+
+- Fork it ( https://github.com/0exp/smart_core/fork )
+- Create your feature branch (`git checkout -b feature/my-new-feature`)
+- Commit your changes (`git commit -am 'Add some feature'`)
+- Push to the branch (`git push origin feature/my-new-feature`)
+- Create new Pull Request
+
+## License
+
+Released under MIT License.
+
+## Authors
+
+[Rustam Ibragimov](https://github.com/0exp)

data/lib/smart_core/operation/attribute.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.2.0
+class SmartCore::Operation::Attribute
+  # @return [Symbol]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :name
+
+  # @return [Hash<Symbol,Any>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :options
+
+  # @param name [String, Symbol]
+  # @param options [Hash<Symbol,Any>] Supported options:
+  #   - :default (see #default_value) (proc or object)
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize(name, **options)
+    unless name.is_a?(Symbol) || name.is_a?(String)
+      raise(
+        SmartCore::Operation::IncorrectAttributeNameError,
+        'Attribute name should be a symbol or a string'
+      )
+    end
+
+    @name = name
+    @options = options # TODO: check for unsupported options (and fail if found)
+  end
+
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.2.0
+  def has_default_value?
+    options.key?(:default)
+  end
+
+  # @return [Any]
+  #
+  # @raise [SmartCore::Operation::ArgumentError]
+  #
+  # @api private
+  # @since 0.2.0
+  def default_value
+    default_value = options.fetch(:default) do
+      raise(SmartCore::Operation::ArgumentError, 'Default value is not provided.')
+    end
+
+    default_value.is_a?(Proc) ? default_value.call : default_value
+  end
+
+  # @return [SmartCore::Operation::Attribute]
+  #
+  # @api private
+  # @since 0.2.0
+  def dup
+    self.class.new(name, **options)
+  end
+end

data/lib/smart_core/operation/attribute_definer.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.2.0
+class SmartCore::Operation::AttributeDefiner
+  # @param operation_klass [Class<SmartCore::Operation>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize(operation_klass)
+    @operation_klass = operation_klass
+    @definition_lock = Mutex.new
+  end
+
+  # @param param_name [Symbol, String]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def define_param(param_name)
+    thread_safe do
+      parameter = build_attribute(param_name)
+      prevent_intersection_with_already_defined_option(parameter)
+      append_parameter(parameter)
+    end
+  end
+
+  # @param param_names [Array<String, Symbol>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def define_params(*param_names)
+    thread_safe do
+      parameters = param_names.map do |param_name|
+        build_attribute(param_name).tap do |parameter|
+          prevent_intersection_with_already_defined_option(parameter)
+        end
+      end
+
+      parameters.each { |parameter| append_parameter(parameter) }
+    end
+  end
+
+  # @param option_name [Symbol, String]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def define_option(option_name, **options)
+    thread_safe do
+      option = build_attribute(option_name, **options)
+      prevent_intersection_with_already_defined_param(option)
+      append_option(option)
+    end
+  end
+
+  # @param option_names [Array<String, Symbol>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def define_options(*option_names)
+    thread_safe do
+      options = option_names.map do |option_name|
+        build_attribute(option_name).tap do |option|
+          prevent_intersection_with_already_defined_param(option)
+        end
+      end
+
+      options.each { |option| append_option(option) }
+    end
+  end
+
+  private
+
+  # @return [Class<SmartCore::Operation>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :operation_klass
+
+  # @return [Mutex]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :definition_lock
+
+  # @param attribute_name [Symbol, String]
+  # @param attribute_options [Hash<Symbol,Any>]
+  # @return [SmartCore::Operation::Attribute]
+  #
+  # @api private
+  # @since 0.2.0
+  def build_attribute(attribute_name, **attribute_options)
+    SmartCore::Operation::Attribute.new(attribute_name, **attribute_options)
+  end
+
+  # @param parameter [SmartCore::Operation::Attribute]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def append_parameter(parameter)
+    operation_klass.__params__ << parameter
+    operation_klass.send(:attr_reader, parameter.name)
+  end
+
+  # @param option [SmartCore::Operation::Attribute]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def append_option(option)
+    operation_klass.__options__ << option
+    operation_klass.send(:attr_reader, option.name)
+  end
+
+  # @param parameter [SmartCore::Operation::Attribute]
+  # @return [void]
+  #
+  # @raise [SmartCore::Operation::OptionOverlapError]
+  #
+  # @api private
+  # @since 0.2.0
+  def prevent_intersection_with_already_defined_option(parameter)
+    if operation_klass.__options__.conflicts_with?(parameter)
+      raise(
+        SmartCore::Operation::OptionOverlapError,
+        "You have already defined option with :#{parameter.name} name"
+      )
+    end
+  end
+
+  # @param option [SmartCore::Operation::Attribute]
+  # @return [void]
+  #
+  # @raise [SmartCore::Operation::ParamOverlapError]
+  #
+  # @api private
+  # @since 0.2.0
+  def prevent_intersection_with_already_defined_param(option)
+    if operation_klass.__params__.conflicts_with?(option)
+      raise(
+        SmartCore::Operation::ParamOverlapError,
+        "You have already defined param with :#{option.name} name"
+      )
+    end
+  end
+
+  # @param block [Proc]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.2.0
+  def thread_safe(&block)
+    definition_lock.synchronize(&block)
+  end
+end

data/lib/smart_core/operation/attribute_set.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.2.0
+class SmartCore::Operation::AttributeSet
+  # @since 0.2.0
+  include Enumerable
+
+  # @return [Hash<Symbol, SmartCore::Operation::Attribute>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :attributes
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize
+    @attributes = {}
+    @access_lock = Mutex.new
+  end
+
+  # @param attribute [SmartCore::Operation::Attribute]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def add_attribute(attribute)
+    thread_safe { attributes[attribute.name] = attribute }
+  end
+  alias_method :<<, :add_attribute
+
+  # @param attribute_set [SmartCore::Operation::AttributeSet]
+  # @return [void]
+  #
+  # @api private
+  # @sinec 0.2.0
+  def concat(attribute_set)
+    thread_safe { attributes.merge!(attribute_set.dup.attributes) }
+  end
+
+  # @param attribute [SmartCore::Operation::Attribute]
+  # @return [Boolean]
+  #
+  # @api private
+  # @since 0.2.0
+  def conflicts_with?(attribute)
+    thread_safe { attributes.key?(attribute.name) }
+  end
+
+  # @return [SmartCore::Operation::AttributeSet]
+  #
+  # @api private
+  # @since 0.2.0
+  def dup
+    thread_safe do
+      self.class.new.tap do |duplicate|
+        attributes.each_value do |attribute|
+          duplicate.add_attribute(attribute.dup)
+        end
+      end
+    end
+  end
+
+  # @return [Integer]
+  #
+  # @api private
+  # @since 0.2.0
+  def size
+    thread_safe { attributes.size }
+  end
+
+  # @return [Enumerable]
+  #
+  # @api private
+  # @since 0.2.0
+  def each(&block)
+    thread_safe { block_given? ? attributes.each_value(&block) : attributes.each_value }
+  end
+
+  private
+
+  # @param block [Proc]
+  # @return [Any]
+  #
+  # @api private
+  # @since 0.2.0
+  def thread_safe(&block)
+    @access_lock.synchronize(&block)
+  end
+end

data/lib/smart_core/operation/exceptions.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+class SmartCore::Operation
+  # @api public
+  # @since 0.2.0
+  Error = Class.new(StandardError)
+
+  # @api public
+  # @since 0.2.0
+  ArgumentError = Class.new(::ArgumentError)
+
+  # @api public
+  # @since 0.2.0
+  ParameterError = Class.new(ArgumentError)
+
+  # @api public
+  # @since 0.2.0
+  ParamOverlapError = Class.new(ParameterError)
+
+  # @api public
+  # @since 0.2.0
+  OptionError = Class.new(ArgumentError)
+
+  # @api public
+  # @since 0.2.0
+  OptionOverlapError = Class.new(OptionError)
+
+  # @api public
+  # @since 0.2.0
+  IncorrectAttributeNameError = Class.new(Error)
+
+  # @api public
+  # @since 0.2.0
+  ResultMethodIntersectionError = Class.new(Error)
+
+  # @api public
+  # @since 0.2.0
+  IncompatibleResultObjectKeyError = Class.new(Error)
+end

data/lib/smart_core/operation/failure.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.2.0
+class SmartCore::Operation::Failure < SmartCore::Operation::Result
+  # @return [Array<Symbol|Any>]
+  #
+  # @api public
+  # @since 0.2.0
+  alias_method :errors, :__result_attributes__
+
+  # @param errors [Array<Symbol|Any>]
+  # @return [void]
+  #
+  # @api pubic
+  # @since 0.2.0
+  def initialize(*errors)
+    super(*errors)
+  end
+
+  # @yield [nil]
+  # @return [Boolean]
+  #
+  # @api public
+  # @since 0.2.0
+  def failure?
+    true.tap { yield(self) if block_given? }
+  end
+end

data/lib/smart_core/operation/initialization_dsl.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+class SmartCore::Operation
+  # @api private
+  # @since 0.2.0
+  module InitializationDSL
+    class << self
+      # @param base_klass [Class]
+      # @return [void]
+      #
+      # @api private
+      # @since 0.2.0
+      def included(base_klass) # rubocop:disable Metrics/AbcSize
+        base_klass.extend(DSLMethods)
+        base_klass.singleton_class.prepend(InitializationMethods)
+
+        base_klass.instance_variable_set(:@__attr_definer__, AttributeDefiner.new(base_klass))
+        base_klass.instance_variable_set(:@__params__, AttributeSet.new)
+        base_klass.instance_variable_set(:@__options__, AttributeSet.new)
+
+        base_klass.singleton_class.prepend(Module.new do
+          # @param child_klass [Class]
+          # @return [void]
+          #
+          # @api private
+          # @since 0.2.0
+          def inherited(child_klass)
+            child_klass.singleton_class.prepend(InitializationMethods)
+
+            child_klass.instance_variable_set(:@__attr_definer__, AttributeDefiner.new(child_klass))
+            child_klass.instance_variable_set(:@__params__, AttributeSet.new)
+            child_klass.instance_variable_set(:@__options__, AttributeSet.new)
+
+            child_klass.__params__.concat(__params__)
+            child_klass.__options__.concat(__options__)
+
+            super(child_klass)
+          end
+        end)
+      end
+    end
+
+    # @api private
+    # @since 0.2.0
+    module InitializationMethods
+      # @param parameters [Any]
+      # @param options [Hash<Symbol,Any>]
+      # @return [Any]
+      #
+      # @api public
+      # @since 0.2.0
+      def new(*parameters, **options)
+        allocate.tap do |object|
+          InstanceBuilder.call(object, self, parameters, options)
+        end
+      end
+    end
+
+    # @api private
+    # @since 0.2.0
+    module DSLMethods
+      # @param param_name [String, Symbol]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.2.0
+      def param(param_name)
+        __attr_definer__.define_param(param_name)
+      end
+
+      # @param param_names [Array<String, Symbol>]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.2.0
+      def params(*param_names)
+        __attr_definer__.define_params(*param_names)
+      end
+
+      # @param option_name [String, Symbol]
+      # @param options [Hash<Symbol,Any>]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.2.0
+      def option(option_name, **options)
+        __attr_definer__.define_option(option_name, **options)
+      end
+
+      # @param option_names [Array<String, Symbol>]
+      # @return [void]
+      #
+      # @api public
+      # @since 0.2.0
+      def options(*option_names)
+        __attr_definer__.define_options(*option_names)
+      end
+
+      # @return [SmartCore::Operation::AttributeSet]
+      #
+      # @api private
+      # @since 0.2.0
+      def __params__
+        @__params__
+      end
+
+      # @return [SmartCore::Operation::AttributeSet]
+      #
+      # @api private
+      # @since 0.2.0
+      def __options__
+        @__options__
+      end
+
+      # @return [SmartCore::Operation::AttributeDefiner]
+      #
+      # @api private
+      # @since 0.2.0
+      def __attr_definer__
+        @__attr_definer__
+      end
+    end
+  end
+end

data/lib/smart_core/operation/instance_builder.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.2.0
+class SmartCore::Operation::InstanceBuilder
+  class << self
+    # @param operation_object [SmartCore::Operation]
+    # @param operation_klass [Class<SmartCore::Operation>]
+    # @param parameters [Array<Any>]
+    # @param options [Hash<Symbol,Any>]
+    # @return [SmartCore::Operation]
+    #
+    # @api private
+    # @since 0.2.0
+    def call(operation_object, operation_klass, parameters, options)
+      new(operation_object, operation_klass, parameters, options).call
+    end
+  end
+
+  # @param operation_object [SmartCore::Operation]
+  # @param operation_klass [Class<SmartCore::Operation>]
+  # @param parameters [Array<Any>]
+  # @param options [Hash<Symbol,Any>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize(operation_object, operation_klass, parameters, options)
+    @operation_object = operation_object
+    @operation_klass = operation_klass
+    @parameters = parameters
+    @options = options
+  end
+
+  # @return [SmartCore::Operation]
+  #
+  # @api private
+  # @since 0.2.0
+  def call
+    operation_object.tap do
+      prevent_parameters_incomparability
+      initialize_parameters
+      initialize_options
+      call_original_methods
+      make_operation_caller_yieldable
+    end
+  end
+
+  private
+
+  # @return [SmartCore::Operation]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :operation_object
+
+  # @return [Class<SmartCore::Operation>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :operation_klass
+
+  # @return [Array<Any>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :parameters
+
+  # @return [Hash<Symbol,Any>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :options
+
+  # An array of the required option attribute names (parameters without default values)
+  #
+  # @return [Array<Symbol>]
+  #
+  # @api private
+  # @since 0.2.0
+  def required_options
+    operation_klass.__options__.each.reject(&:has_default_value?).map(&:name)
+  end
+
+  # @return [Integer]
+  #
+  # @api private
+  # @since 0.2.0
+  def required_attributes_count
+    operation_klass.__params__.size
+  end
+
+  # @return [void]
+  #
+  # @raise [SmartCore::Operation::AttributeError]
+  # @raise [SmartCore::Operation::ParameterError]
+  # @raise [SmartCore::Operation::OptionError]
+  #
+  # @api private
+  # @since 0.2.0
+  def prevent_parameters_incomparability
+    raise(
+      SmartCore::Operation::ParameterError,
+      "Wrong number of parameters " \
+      "(given #{parameters.size}, expected #{required_attributes_count})"
+    ) unless parameters.size == required_attributes_count
+
+    missing_options = required_options.reject { |option| options.key?(option) }
+
+    raise(
+      SmartCore::Operation::OptionError,
+      "Missing options: :#{missing_options.join(', :')}"
+    ) unless missing_options.empty?
+  end
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize_parameters
+    parameter_names = operation_klass.__params__.map(&:name)
+    parameter_pairs = Hash[parameter_names.zip(parameters)]
+
+    parameter_pairs.each_pair do |parameter_name, parameter_value|
+      operation_object.instance_variable_set("@#{parameter_name}", parameter_value)
+    end
+  end
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize_options
+    operation_klass.__options__.each do |option|
+      option_name  = option.name
+      option_value = options.fetch(option_name) { option.default_value }
+
+      operation_object.instance_variable_set("@#{option_name}", option_value)
+    end
+  end
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def call_original_methods
+    operation_object.send(:initialize, *parameters, **options)
+  end
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def make_operation_caller_yieldable
+    operation_object.singleton_class.prepend(Module.new do
+      def call
+        super.tap { |result| yield(result) if block_given? }
+      end
+    end)
+  end
+end

data/lib/smart_core/operation/result.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.2.0
+class SmartCore::Operation::Result
+  # @return [Array<Any>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :__result_attributes__
+
+  # @return [Hash<Symbol,Any>]
+  #
+  # @api private
+  # @since 0.2.0
+  attr_reader :__result_options__
+
+  # @param result_attributes [Array<Any>]
+  # @param result_options [Hash<Symbol,Any>]
+  # @return [void]
+  #
+  # @api public
+  # @since 0.2.0
+  def initialize(*result_attributes, **result_options)
+    @__result_attributes__ = result_attributes
+    @__result_options__ = result_options
+  end
+
+  # @return [Boolean]
+  #
+  # @api public
+  # @since 0.2.0
+  def success?
+    false
+  end
+
+  # @return [Boolean]
+  #
+  # @api public
+  # @since 0.2.0
+  def failure?
+    false
+  end
+end

data/lib/smart_core/operation/success.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.2.0
+class SmartCore::Operation::Success < SmartCore::Operation::Result
+  # @param result_options [Hash<Symbol,Any>]
+  # @return [void]
+  #
+  # @api public
+  # @since 0.2.0
+  def initialize(**result_options)
+    __prevent_method_overlapping__(result_options)
+    super(**result_options) # NOTE: initialize result object
+    __define_virtual_result_data_accessors__(result_options)
+  end
+
+  # @yield [nil]
+  # @return [Boolean]
+  #
+  # @api public
+  # @since 0.2.0
+  def success?
+    true.tap { yield(self) if block_given? }
+  end
+
+  private
+
+  # @param result_options [Hash<Symbol,Any>]
+  # @return [void]
+  #
+  # @raise [SmartCore::Operation::IncompatibleResultKeyError]
+  # @raise [SmartCore::Operation::ResultMethodIntersectionError]
+  #
+  # @api private
+  # @since 0.2.0
+  def __prevent_method_overlapping__(result_options)
+    overlappings = result_options.each_key.each_with_object([]) do |key, overlap|
+      overlap << key if self.class.__core_methods__.include?(key)
+    end
+
+    raise(
+      SmartCore::Operation::ResultMethodIntersectionError,
+      "Result keys can not overlap core methods " \
+      "(overlapping keys: #{overlappings.join(', ')})."
+    ) if overlappings.any?
+  end
+
+  # @param result_options [Hash<Symbol,Any>]
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def __define_virtual_result_data_accessors__(result_options)
+    result_options.each_key do |result_attribute_name|
+      define_singleton_method(result_attribute_name) do
+        __result_options__[result_attribute_name]
+      end
+    end
+  end
+
+  core_methods = (
+    instance_methods(false) | private_instance_methods(false) |
+    superclass.instance_methods(false) | superclass.private_instance_methods(false)
+  ).freeze
+
+  # @return [Array<Symbol>]
+  #
+  # @api private
+  # @since 0.2.0
+  define_singleton_method(:__core_methods__) { core_methods }
+end

data/lib/smart_core/operation.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.2.0
+class SmartCore::Operation
+  require_relative 'operation/exceptions'
+  require_relative 'operation/attribute'
+  require_relative 'operation/attribute_set'
+  require_relative 'operation/result'
+  require_relative 'operation/success'
+  require_relative 'operation/failure'
+  require_relative 'operation/instance_builder'
+  require_relative 'operation/attribute_definer'
+  require_relative 'operation/initialization_dsl'
+
+  # @since 0.2.0
+  include InitializationDSL
+
+  class << self
+    # @param arguments [Any]
+    # @param options [Hash<Symbol,Any>]
+    # @param block [Proc]
+    # @return [SmartCore::Operation::Success, SmartCore::Operation::Failure]
+    #
+    # @api public
+    # @since 0.2.0
+    def call(*arguments, **options, &block)
+      new(*arguments, **options).call(&block)
+    end
+  end
+
+  # @return [void]
+  #
+  # @api private
+  # @since 0.2.0
+  def initialize(*, **); end
+
+  # @return [SmartCore::Operation::Success, SmartCore::Operation::Failure]
+  #
+  # @api public
+  # @since 0.2.0
+  def call
+    Success()
+  end
+
+  private
+
+  # @param result_data [Hash<Symbol,Any>]
+  # @return [SmartCore::Operation::Success]
+  #
+  # @api public
+  # @since 0.2.0
+  def Success(**result_data) # rubocop:disable Naming/MethodName
+    SmartCore::Operation::Success.new(**result_data)
+  end
+
+  # @param errors [Array<Symbol|Any>]
+  # @return [SmartCore::Operation::Failure]
+  #
+  # @api public
+  # @since 0.2.0
+  def Failure(*errors) # rubocop:disable Naming/MethodName
+    SmartCore::Operation::Failure.new(*errors)
+  end
+end

data/lib/smart_core/validator/attribute_set.rb

@@ -6,7 +6,7 @@ class SmartCore::Validator::AttributeSet
   # @since 0.1.0
   include Enumerable
 
-  # @return [Hash<Symbol, SmartCore::Validator::Attribute>]
+  # @return [Hash<Symbol,SmartCore::Validator::Attribute>]
   #
   # @api private
   # @since 0.1.0
@@ -21,7 +21,7 @@ class SmartCore::Validator::AttributeSet
     @access_lock = Mutex.new
   end
 
-  # @param attribute [Symbiont::Validator::Attribute]
+  # @param attribute [SmartCore::Validator::Attribute]
   # @return [void]
   #
   # @api private

data/lib/smart_core/validator/dsl.rb

@@ -31,7 +31,7 @@ class SmartCore::Validator
     # @param attribute_name [String, Symbol]
     # @return [void]
     #
-    # @api private
+    # @api public
     # @since 0.1.0
     def attribute(attribute_name, default: nil)
       attribute = SmartCore::Validator::Attribute.new(attribute_name, default)
@@ -86,7 +86,7 @@ class SmartCore::Validator
     #
     # @see SmartCore::Validator::Commands::ValidateWith
     #
-    # @api private
+    # @api public
     # @since 0.1.0
     def validate_with(validating_klass, &nested_validations)
       commands << Commands::ValidateWith.new(validating_klass, nested_validations)

data/lib/smart_core/validator/instance_builder.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+# @api private
+# @since 0.2.0
+class SmartCore::Validator
+  class InstanceBuilder
+    class << self
+      # @param validator_object [SmartCore::Validator]
+      # @param validator_klass [Class<SmartCore::Validator>]
+      # @param arguments [Array<Any>]
+      # @param options [Hash<Symbol,Any>]
+      # @param block [Proc]
+      # @return [SmartCore::Validator]
+      #
+      # @api private
+      # @since 0.2.0
+      def call(validator_object, validator_klass, arguments, options, block)
+        new(validator_object, validator_klass, arguments, options, block).call
+      end
+    end
+
+    # @param validator_object [SmartCore::Validator]
+    # @param validator_klass [Class<SmartCore::Validator>]
+    # @param arguments [Array<Any>]
+    # @param options [Hash<Symbol,Any>]
+    # @param block [Proc]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.2.0
+    def initialize(validator_object, validator_klass, arguments, options, block)
+      @validator_object = validator_object
+      @validator_klass = validator_klass
+      @arguments = arguments
+      @options = options
+      @block = block
+    end
+
+    # @return [SmartCore::Validator]
+    #
+    # @api private
+    # @since 0.2.0
+    def call
+      validator_object.tap do
+        initialize_core_attributes
+        initialize_custom_attributes
+        invoke_original_methods
+      end
+    end
+
+    private
+
+    # @return [SmartCore::Validator]
+    #
+    # @api private
+    # @since 0.2.0
+    attr_reader :validator_object
+
+    # @return [Class<SmartCore::Validator>]
+    #
+    # @api private
+    # @since 0.2.0
+    attr_reader :validator_klass
+
+    # @return [Array<Any>]
+    #
+    # @api private
+    # @since 0.2.0
+    attr_reader :arguments
+
+    # @return [Hash<Symbol,Any>]
+    #
+    # @api private
+    # @since 0.2.0
+    attr_reader :options
+
+    # @return [Proc]
+    #
+    # @api private
+    # @since 0.2.0
+    attr_reader :block
+
+    # @return [void]
+    #
+    # @api private
+    # @since 0.2.0
+    def initialize_core_attributes
+      validator_object.instance_variable_set(:@__validation_errors__, ErrorSet.new)
+      validator_object.instance_variable_set(:@__invokation_lock__, Mutex.new)
+      validator_object.instance_variable_set(:@__access_lock__, Mutex.new)
+    end
+
+    # @return [void]
+    #
+    # @api private
+    # @since 0.2.0
+    def initialize_custom_attributes
+      validator_klass.attributes.each do |attribute|
+        attribute_name  = attribute.name
+        attribute_value = options.fetch(attribute_name) { attribute.default_value }
+
+        validator_object.instance_variable_set("@#{attribute_name}", attribute_value)
+      end
+    end
+
+    # @return [void]
+    #
+    # @api private
+    # @since 0.2.0
+    def invoke_original_methods
+      validator_object.send(:initialize, *arguments, **options, &block)
+    end
+  end
+end

data/lib/smart_core/validator.rb

@@ -11,37 +11,22 @@ class SmartCore::Validator
   require_relative 'validator/invoker'
   require_relative 'validator/commands'
   require_relative 'validator/dsl'
+  require_relative 'validator/instance_builder'
 
   # @since 0.1.0
   extend DSL
 
   class << self
-    # @param argumants [Any]
-    # @param options [Hash<Symbol, Object>]
+    # @param arguments [Any]
+    # @param options [Hash<Symbol,Object>]
+    # @param block [Proc]
     # @return [void]
     #
     # @api public
     # @since 0.1.0
-    def new(*arguments, **options)
+    def new(*arguments, **options, &block)
       allocate.tap do |object|
-        object.instance_variable_set(:@__validation_errors__, ErrorSet.new)
-        object.instance_variable_set(:@__invokation_lock__, Mutex.new)
-        object.instance_variable_set(:@__access_lock__, Mutex.new)
-
-        attributes.each do |attribute|
-          attribute_name = attribute.name
-
-          attribute_value =
-            if options.key?(attribute_name)
-              options[attribute_name]
-            else
-              attribute.default_value
-            end
-
-          object.instance_variable_set("@#{attribute_name}", attribute_value)
-        end
-
-        object.send(:initialize, *arguments, **options)
+        InstanceBuilder.call(object, self, arguments, options, block)
       end
     end
   end
@@ -56,7 +41,7 @@ class SmartCore::Validator
   #
   # @api public
   # @since 0.1.0
-  def initialize(*, **); end
+  def initialize(*, **, &block); end
 
   # @return [Boolean]
   #
@@ -91,7 +76,7 @@ class SmartCore::Validator
     end
   end
 
-  # @return [Hash<Symbol, Object>]
+  # @return [Hash<Symbol,Object>]
   #
   # @api private
   # @since 0.1.0

data/lib/smart_core/version.rb

@@ -5,5 +5,5 @@ module SmartCore
   #
   # @api public
   # @since 0.1.0
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/lib/smart_core.rb

@@ -5,4 +5,5 @@
 module SmartCore
   require_relative 'smart_core/version'
   require_relative 'smart_core/validator'
+  require_relative 'smart_core/operation'
 end

data/smart_core.gemspec

@@ -26,9 +26,10 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'coveralls',        '~> 0.8.22'
   spec.add_development_dependency 'simplecov',        '~> 0.16.1'
-  spec.add_development_dependency 'armitage-rubocop', '~> 0.16.0'
+  spec.add_development_dependency 'armitage-rubocop', '~> 0.17.0'
   spec.add_development_dependency 'rspec',            '~> 3.8.0'
-  spec.add_development_dependency 'bundler',          '~> 1.17'
-  spec.add_development_dependency 'rake',             '~> 12.3'
-  spec.add_development_dependency 'pry',              '~> 0.12'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'pry'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_core
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Rustam Ibragimov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-05 00:00:00.000000000 Z
+date: 2019-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coveralls
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 0.17.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 0.17.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -70,44 +70,44 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0'
 description: "(in active development) A set of common abstractions"
 email:
 - iamdaiver@icloud.com
@@ -128,6 +128,16 @@ files:
 - bin/console
 - bin/setup
 - lib/smart_core.rb
+- lib/smart_core/operation.rb
+- lib/smart_core/operation/attribute.rb
+- lib/smart_core/operation/attribute_definer.rb
+- lib/smart_core/operation/attribute_set.rb
+- lib/smart_core/operation/exceptions.rb
+- lib/smart_core/operation/failure.rb
+- lib/smart_core/operation/initialization_dsl.rb
+- lib/smart_core/operation/instance_builder.rb
+- lib/smart_core/operation/result.rb
+- lib/smart_core/operation/success.rb
 - lib/smart_core/validator.rb
 - lib/smart_core/validator/attribute.rb
 - lib/smart_core/validator/attribute_set.rb
@@ -141,6 +151,7 @@ files:
 - lib/smart_core/validator/dsl.rb
 - lib/smart_core/validator/error_set.rb
 - lib/smart_core/validator/exceptions.rb
+- lib/smart_core/validator/instance_builder.rb
 - lib/smart_core/validator/invoker.rb
 - lib/smart_core/version.rb
 - smart_core.gemspec
@@ -163,7 +174,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: "(in active development) A set of common abstractions"