quickstep 0.2.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 346e59b0747f25796c6903ce007daf080a63e88ed9f19897fb9ef61f12e4dbcc
-  data.tar.gz: c3ba62ba1c119ca5b534482d2cd0c106c7161dbcdc3940026897862a1699a43b
+  metadata.gz: 2f14a3a824fcc4213fdceb8bd15d1a2e4912207c7e7bcc3760854e4cb137ff22
+  data.tar.gz: 282e253ac3fe9e47b227c9c6aa26e7e34c80ce922a5874bf6a9bfccf9d145739
 SHA512:
-  metadata.gz: 7c78591ee480a7835663e2ca8c136c48cc566df56937dfe34c40067b50799eccb1808de158b741653083dc2e498991f74107559fb08f26acea0c03f5c00bf891
-  data.tar.gz: 42a6abae6b2d76ebee7dbe7644270220d1864ef8df2d76f0f3ee72bcfe35d9c4a6379b9a903f52818f264bbf7c47b3601181bd23f17781227872086598303cbc
+  metadata.gz: d68a3ffb2eea14980103f7ab1fe1c5f1b6017dd66dd79d0656eda6707af8f5a547c0fa4a73783d8850c46dc9dcfff860e9af32312dc1ab4ded0dfffcde243771
+  data.tar.gz: 95e07911222e32c5ccb2bdb9e5f23b50523b9b85832bebcc182fa6bcdaf8847bd196cd817343a11b7ef9d2038983c62f3ec7215abe319247bb19966aaf4f9503

data/README.md

@@ -10,7 +10,7 @@ Quickstep is a lightweight business operation tool inspired by [dry-operation](h
 Add this line to your application's Gemfile:
 
 ```ruby
- gem 'quickstep'
+ gem 'quickstep', '1.0.0'
 ```
 
 Or install it manually:
@@ -48,8 +48,6 @@ class MyOperation
 end
 
 result = MyOperation.new.call(valid: true, value: 5)
-# or
-# result = MyOperation.call(valid: true, value: 5)
 
 if result.success?
   puts "Success: #{result.value}"
@@ -58,6 +56,55 @@ else
 end
 ```
 
+### Chaining Operations
+
+In Quickstep, you can use the result of another operation as a step in your operation.  
+This allows you to compose operations naturally and reuse existing logic.
+
+```ruby
+class MainOperation
+  include Quickstep
+
+  def call
+    step step1
+    step SecondOperation.new.call # chaining another operation
+  end
+
+  private
+
+  def first_step
+    Success("first step")
+  end
+end
+
+class SecondOperation
+  include Quickstep
+
+  def call
+    step first_step
+    step second_step
+  end
+
+  private
+
+  def first_step
+    Success("Step from SecondOperation")
+  end
+end
+```
+
+### Notes
+- Any value returned by `call` that is not already a `Success` or `Failure` will be wrapped in a `Success` automatically.
+- Operations can be executed either via an **instance** or directly on the **class**:
+```ruby
+# Using an instance
+result = MyOperation.new.call(:input)
+
+# Using the class method shortcut
+result = MyOperation.call(:input)
+```
+
+
 ## License
 
 Quickstep is available under the MIT License.

data/lib/quickstep/result.rb

@@ -5,7 +5,7 @@ module Quickstep
     class Success
       attr_reader :value
 
-      def initialize(value)
+      def initialize(value = nil)
         @value = value
       end
 
@@ -18,14 +18,18 @@ module Quickstep
       end
 
       def inspect
-        "Success(#{value.inspect})"
+        value.nil? ? 'Success()' : "Success(#{value.inspect})"
+      end
+
+      def ==(other)
+        other.is_a?(Success) && other.value == value
       end
     end
 
     class Failure
       attr_reader :value
 
-      def initialize(value)
+      def initialize(value = nil)
         @value = value
       end
 
@@ -38,15 +42,19 @@ module Quickstep
       end
 
       def inspect
-        "Failure(#{value.inspect})"
+        value.nil? ? 'Failure()' : "Failure(#{value.inspect})"
+      end
+
+      def ==(other)
+        other.is_a?(Failure) && other.value == value
       end
     end
 
-    def Success(value)
+    def Success(value = nil)
       Success.new(value)
     end
 
-    def Failure(value)
+    def Failure(value = nil)
       Failure.new(value)
     end
   end

data/lib/quickstep/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Quickstep
-  VERSION = '0.2.0'
+  VERSION = '1.0.0'
 end

data/lib/quickstep.rb

@@ -13,23 +13,34 @@ module Quickstep
 
   module ClassMethods
     def call(*args)
-      catch :halt do
+      result = catch :halt do
         new.call(*args)
       end
+      if result.respond_to?(:failure?)
+        result
+      else
+        Quickstep::Result::Success.new(result)
+      end
     end
   end
 
   module InstanceMethods
     def call(*args)
-      catch :halt do
+      result = catch :halt do
         super
       end
+
+      if result.respond_to?(:failure?)
+        result
+      else
+        Quickstep::Result::Success.new(result)
+      end
     end
   end
 
   def step(result)
     if result.success?
-      result
+      result.value
     else
       throw :halt, result
     end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: quickstep
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Igor Korepanov
 bindir: bin
 cert_chain: []
-date: 2025-05-07 00:00:00.000000000 Z
+date: 2025-08-28 00:00:00.000000000 Z
 dependencies: []
 description: |2
       Quickstep provides a structured way to execute multi-step business operations with built-in success and