opera 0.4.1 → 0.5.1

data/lib/opera/operation/builder.rb

@@ -3,7 +3,7 @@
 module Opera
   module Operation
     module Builder
-      INSTRUCTIONS = %I[validate transaction benchmark step success finish_if operation operations].freeze
+      INSTRUCTIONS = %I[validate transaction step success finish_if operation operations within].freeze
 
       def self.included(base)
         base.extend(ClassMethods)
@@ -16,7 +16,7 @@ module Opera
 
         INSTRUCTIONS.each do |instruction|
           define_method instruction do |method = nil, &blk|
-            self.check_method_availability!(method) if method
+            check_method_availability!(method) if method
             instructions.concat(InnerBuilder.new.send(instruction, method, &blk))
           end
         end

data/lib/opera/operation/config.rb

@@ -17,7 +17,7 @@ module Opera
         @instrumentation_class = self.class.instrumentation_class
 
         @mode = self.class.mode || DEVELOPMENT_MODE
-        @reporter = custom_reporter || self.class.reporter
+        @reporter = self.class.reporter
 
         validate!
       end
@@ -26,15 +26,11 @@ module Opera
         yield self
       end
 
-      def custom_reporter
-        Rails.application.config.x.reporter.presence if defined?(Rails)
-      end
-
       private
 
       def validate!
         unless [DEVELOPMENT_MODE, PRODUCTION_MODE].include?(mode)
-          raise ArgumentError, 'Mode is incorrect. Can be either: development or production' 
+          raise ArgumentError, 'Mode is incorrect. Can be either: development or production'
         end
       end
 
@@ -47,7 +43,7 @@ module Opera
         end
 
         def development_mode?
-          mode == DEFAULT_MODE
+          mode == DEVELOPMENT_MODE
         end
 
         def production_mode?

data/lib/opera/operation/executor.rb

@@ -20,15 +20,24 @@ module Opera
       end
 
       def evaluate_instructions(instructions = [])
-        instruction_copy = Marshal.load(Marshal.dump(instructions))
-
-        while instruction_copy.any?
-          instruction = instruction_copy.shift
+        instructions.each do |instruction|
           evaluate_instruction(instruction)
           break if break_condition
         end
       end
 
+      # Executes the operation method named in the instruction, instruments it,
+      # and records the execution. This is the shared primitive that all executors
+      # use to invoke a step method without mutating the instruction hash.
+      def execute_step(instruction)
+        method = instruction[:method]
+
+        Instrumentation.new(operation).instrument(name: "##{method}", level: :step) do
+          result.add_execution(method) unless production_mode?
+          operation.send(method)
+        end
+      end
+
       # rubocop:disable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity
       def evaluate_instruction(instruction)
         case instruction[:kind]
@@ -44,10 +53,10 @@ module Opera
           Instructions::Executors::Validate.new(operation).call(instruction)
         when :transaction
           Instructions::Executors::Transaction.new(operation).call(instruction)
-        when :benchmark
-          Instructions::Executors::Benchmark.new(operation).call(instruction)
         when :finish_if
           Instructions::Executors::FinishIf.new(operation).call(instruction)
+        when :within
+          Instructions::Executors::Within.new(operation).call(instruction)
         else
           raise(UnknownInstructionError, "Unknown instruction #{instruction[:kind]}")
         end
@@ -79,7 +88,7 @@ module Opera
       end
 
       def add_instruction_output(instruction, output = {})
-        context["#{instruction[:method]}_output".to_sym] = output
+        context[:"#{instruction[:method]}_output"] = output
       end
     end
   end

data/lib/opera/operation/instructions/executors/finish_if.rb

@@ -6,8 +6,7 @@ module Opera
       module Executors
         class FinishIf < Executor
           def call(instruction)
-            instruction[:kind] = :step
-            operation.finish! if super
+            operation.finish! if execute_step(instruction)
           end
         end
       end

data/lib/opera/operation/instructions/executors/operation.rb

@@ -6,8 +6,7 @@ module Opera
       module Executors
         class Operation < Executor
           def call(instruction)
-            instruction[:kind] = :step
-            operation_result = super
+            operation_result = execute_step(instruction)
             save_information(operation_result)
 
             if operation_result.success?

data/lib/opera/operation/instructions/executors/operations.rb

@@ -9,8 +9,7 @@ module Opera
 
           # rubocop:disable Metrics/MethodLength
           def call(instruction)
-            instruction[:kind] = :step
-            operations_results = super
+            operations_results = execute_step(instruction)
 
             case operations_results
             when Array
@@ -42,7 +41,7 @@ module Opera
           def add_results(instruction, results)
             add_instruction_output(instruction, results.map(&:output))
             execution = result.executions.pop
-            result.add_execution(execution => results.map(&:executions))  unless production_mode?
+            result.add_execution(execution => results.map(&:executions)) unless production_mode?
           end
 
           def raise_error

data/lib/opera/operation/instructions/executors/step.rb

@@ -6,12 +6,7 @@ module Opera
       module Executors
         class Step < Executor
           def call(instruction)
-            method = instruction[:method]
-
-            Instrumentation.new(operation).instrument(name: "##{method}", level: :step) do
-              operation.result.add_execution(method) unless production_mode?
-              operation.send(method)
-            end
+            execute_step(instruction)
           end
         end
       end

data/lib/opera/operation/instructions/executors/success.rb

@@ -6,8 +6,11 @@ module Opera
       module Executors
         class Success < Executor
           def call(instruction)
-            instruction[:kind] = :step
-            super
+            if instruction[:instructions]
+              evaluate_instructions(instruction[:instructions])
+            else
+              execute_step(instruction)
+            end
           end
 
           def break_condition

data/lib/opera/operation/instructions/executors/validate.rb

@@ -12,8 +12,7 @@ module Opera
           private
 
           def evaluate_instruction(instruction)
-            instruction[:kind] = :step
-            validation_result = super
+            validation_result = execute_step(instruction)
 
             case validation_result
             when Opera::Operation::Result

data/lib/opera/operation/instructions/executors/within.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Opera
+  module Operation
+    module Instructions
+      module Executors
+        class Within < Executor
+          def call(instruction)
+            wrapper_method = instruction[:label]
+            nested_instructions = instruction[:instructions]
+
+            raise ArgumentError, 'within requires a method name' unless wrapper_method
+            raise ArgumentError, 'within requires a block with at least one instruction' if nested_instructions.nil?
+
+            operation.send(wrapper_method) do
+              evaluate_instructions(nested_instructions)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opera/operation.rb

@@ -9,12 +9,12 @@ require 'opera/operation/result'
 require 'opera/operation/config'
 require 'opera/operation/instructions/executors/success'
 require 'opera/operation/instructions/executors/transaction'
-require 'opera/operation/instructions/executors/benchmark'
 require 'opera/operation/instructions/executors/finish_if'
 require 'opera/operation/instructions/executors/validate'
 require 'opera/operation/instructions/executors/operation'
 require 'opera/operation/instructions/executors/operations'
 require 'opera/operation/instructions/executors/step'
+require 'opera/operation/instructions/executors/within'
 
 module Opera
   module Operation

data/lib/opera/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Opera
-  VERSION = '0.4.1'
+  VERSION = '0.5.1'
 end

data/opera.gemspec

@@ -1,14 +1,16 @@
+# frozen_string_literal: true
+
 require_relative 'lib/opera/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = 'opera'
-  spec.version       = Opera::VERSION
-  spec.authors       = ['ProFinda Development Team']
-  spec.email         = ['dev@profinda.com']
+  spec.name = 'opera'
+  spec.version = Opera::VERSION
+  spec.authors = ['ProFinda Development Team']
+  spec.email = ['dev@profinda.com']
 
-  spec.summary       = 'Use simple DSL language to keep your Operations clean and maintainable'
-  spec.homepage      = 'https://github.com/Profinda/opera'
-  spec.license       = 'MIT'
+  spec.summary = 'Use simple DSL language to keep your Operations clean and maintainable'
+  spec.homepage = 'https://github.com/Profinda/opera'
+  spec.license = 'MIT'
   spec.required_ruby_version = Gem::Requirement.new('>= 3.1.0')
 
   spec.metadata['homepage_uri'] = spec.homepage
@@ -17,11 +19,11 @@ Gem::Specification.new do |spec|
 
   # 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.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = 'exe'
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'dry-validation', '>= 1.0'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opera
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.1
 platform: ruby
 authors:
 - ProFinda Development Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-19 00:00:00.000000000 Z
+date: 2026-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-validation
@@ -63,6 +63,7 @@ files:
 - ".github/workflows/specs.yml"
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".travis.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -72,9 +73,18 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- benchmarks/operation_benchmark.rb
 - bin/console
 - bin/setup
 - docker-compose.yml
+- docs/examples/basic-operation.md
+- docs/examples/context-params-dependencies.md
+- docs/examples/finish-if.md
+- docs/examples/inner-operations.md
+- docs/examples/success-blocks.md
+- docs/examples/transactions.md
+- docs/examples/validations.md
+- docs/examples/within.md
 - lib/opera.rb
 - lib/opera/errors.rb
 - lib/opera/operation.rb
@@ -83,7 +93,6 @@ files:
 - lib/opera/operation/builder.rb
 - lib/opera/operation/config.rb
 - lib/opera/operation/executor.rb
-- lib/opera/operation/instructions/executors/benchmark.rb
 - lib/opera/operation/instructions/executors/finish_if.rb
 - lib/opera/operation/instructions/executors/operation.rb
 - lib/opera/operation/instructions/executors/operations.rb
@@ -91,6 +100,7 @@ files:
 - lib/opera/operation/instructions/executors/success.rb
 - lib/opera/operation/instructions/executors/transaction.rb
 - lib/opera/operation/instructions/executors/validate.rb
+- lib/opera/operation/instructions/executors/within.rb
 - lib/opera/operation/instrumentation.rb
 - lib/opera/operation/result.rb
 - lib/opera/version.rb

data/lib/opera/operation/instructions/executors/benchmark.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module Opera
-  module Operation
-    module Instructions
-      module Executors
-        class Benchmark < Executor
-          def call(instruction)
-            benchmark = ::Benchmark.measure do
-              instruction[:kind] = :step
-              super
-            end
-
-            result.add_information(benchmark_key(instruction) => { real: benchmark.real, total: benchmark.total })
-          end
-
-          private
-
-          def benchmark_key(instruction)
-            instruction[:method] || instruction[:label] || instruction[:instructions].map { |e| e[:method] }.join('-').to_sym
-          end
-        end
-      end
-    end
-  end
-end