smart_core 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2ff8c25822c588b21c3d5785f04998fb1bb838e30b6046cc7e1706891133c6b
-  data.tar.gz: 307a1f6b397dba1339c9e6d4ea701343b349c22261b59e42ae35ccce735b7ff7
+  metadata.gz: d5fabab611add86958e30b6ee5b01323f0bf9d25d1dc810a6b425551f6724f07
+  data.tar.gz: dd2568de8356fe185579a20adf5778672b84edebfe20145b71fe5ecc3ace07a3
 SHA512:
-  metadata.gz: 7755b70015cc2cb2c0cc76c9e3436cda0f7d76170f9109e3e20655ce6e29c16a530b1b522398355329eaa64e5cd139153ba3c93043372b6e734dbfe4994b47a8
-  data.tar.gz: e580d37f900e4e969464b094d4fc4d4795edcc6bbd90e482716dfcbc7147e327543dcf7e8c29ae5905a15ccd29a362b1b3873cc68972e742c3a5fc579696062b
+  metadata.gz: 3ed05efd0358bb94a3eafb8cfb4f4f719a163976ff9d55fe12dc85133173fc02cdfa2d658d51cc1c8109714f17babacdbad3bc77e8261586dcdc2cc3b5734187
+  data.tar.gz: 5e47ae0423372cd64d2dade6dad06b00d8faa6dce6a7a52ded5764001ac894c1c3eafb023c7d2babad7662561a4887c30c1b0820b71d4606357f76f66d4ba0ad

data/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## [0.3.0] - 2019-01-20
+### Added
+- **Operation**
+  - New result object type: `Fatal` (`SmartCore::Operation::Fatal`, `#Fatal`)
+    - stops the operation execution flow and returns
+      `SmartCore::Operation::Fatal` result immidietly;
+    - has `Failure`-like instantiation behavior and internal state (`#failure?`, `#fatal?`, `#errors`);
+
 ## [0.2.0] - 2019-01-20
 ### Added
 - **Service object** abstraction (`SmartCore::Operation`);

data/README.md

@@ -26,7 +26,7 @@ require 'smart_core'
 
 - [**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 result object abstraction (`Success`, `Failure`, `Fatal`, `#success?`, `#failure?`, `#fatal?`);
   - yieldable `#call` (and `.call`);
   - inheritance works as expected `:)`;
   - no dependencies;

data/lib/smart_core/operation/exceptions.rb

@@ -5,6 +5,26 @@ class SmartCore::Operation
   # @since 0.2.0
   Error = Class.new(StandardError)
 
+  # @api public
+  # @since 0.3.0
+  FatalError = Class.new(Error) do
+    # @return [SmartCore::Operation::Fatal]
+    #
+    # @api private
+    # @since 0.3.0
+    attr_reader :__operation_result__
+
+    # @param operation_result [SmartCore::Operation::Fatal]
+    # @return [void]
+    #
+    # @api private
+    # @since 0.3.0
+    def initialize(operation_result)
+      @__operation_result__ = operation_result
+      super()
+    end
+  end
+
   # @api public
   # @since 0.2.0
   ArgumentError = Class.new(::ArgumentError)

data/lib/smart_core/operation/fatal.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# @api public
+# @since 0.3.0
+class SmartCore::Operation::Fatal < SmartCore::Operation::Failure
+  # @return [SmartCore::Operation::FatalError]
+  #
+  # @api private
+  # @since 0.3.0
+  def exception
+    SmartCore::Operation::FatalError.new(self)
+  end
+
+  # @return [Boolean]
+  #
+  # @api public
+  # @since 0.3.0
+  def fatal?
+    true.tap { yield(self) if block_given? }
+  end
+end

data/lib/smart_core/operation/instance_builder.rb

@@ -155,6 +155,9 @@ class SmartCore::Operation::InstanceBuilder
     operation_object.singleton_class.prepend(Module.new do
       def call
         super.tap { |result| yield(result) if block_given? }
+      rescue SmartCore::Operation::FatalError => error
+        # NOTE: returns SmartCore::Operation::Fatal instance
+        error.__operation_result__.tap { |result| yield(result) if block_given? }
       end
     end)
   end

data/lib/smart_core/operation.rb

@@ -9,6 +9,7 @@ class SmartCore::Operation
   require_relative 'operation/result'
   require_relative 'operation/success'
   require_relative 'operation/failure'
+  require_relative 'operation/fatal'
   require_relative 'operation/instance_builder'
   require_relative 'operation/attribute_definer'
   require_relative 'operation/initialization_dsl'
@@ -35,7 +36,9 @@ class SmartCore::Operation
   # @since 0.2.0
   def initialize(*, **); end
 
-  # @return [SmartCore::Operation::Success, SmartCore::Operation::Failure]
+  # @return [SmartCore::Operation::Success]
+  # @return [SmartCore::Operation::Failure]
+  # @return [SmartCore::Operation::Fatal]
   #
   # @api public
   # @since 0.2.0
@@ -62,4 +65,15 @@ class SmartCore::Operation
   def Failure(*errors) # rubocop:disable Naming/MethodName
     SmartCore::Operation::Failure.new(*errors)
   end
+
+  # @param errors [Array<Symbol|Any>]
+  # @return [SmartCore::Operation::Fatal]
+  #
+  # @raise [SmartCore::Operation::FatalError]
+  #
+  # @api public
+  # @since 0.2.0
+  def Fatal(*errors) # rubocop:disable Naming/MethodName
+    raise SmartCore::Operation::Fatal.new(*errors)
+  end
 end

data/lib/smart_core/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smart_core
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rustam Ibragimov
@@ -134,6 +134,7 @@ files:
 - lib/smart_core/operation/attribute_set.rb
 - lib/smart_core/operation/exceptions.rb
 - lib/smart_core/operation/failure.rb
+- lib/smart_core/operation/fatal.rb
 - lib/smart_core/operation/initialization_dsl.rb
 - lib/smart_core/operation/instance_builder.rb
 - lib/smart_core/operation/result.rb