cmdx-rspec 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ed75f972481a1a428a86ce5ff19f3a804126f1e305097886f983cd102a00ced
-  data.tar.gz: 2bdc655439c8bafb3d865d13018290cd935262edef756596aa73b23dd9f0e85d
+  metadata.gz: 65acfca8209e73048a17abf0bc8c9b260904be2d222eb8d2f620c39452da0d0b
+  data.tar.gz: 64c7756f01efe07324193ca891bf4ce841361e2ce93235437b0a63ed4c74bfea
 SHA512:
-  metadata.gz: 711527fe0d0a79306f45dda1918aeaf656926064e5c7573dabb33785afb52d9b013ca663115340c222b2502900740f235741598b410d5861bc1fb26618d87357
-  data.tar.gz: 666bc45fdfb94f09d378c8a8adbee16f15d66e8069e2b324069602274b7ec49aacf79f64e98d8dd6a472137c2937bb9d465f212c7b7d787e6869319968f9ebdf
+  metadata.gz: e05b1817afbfacd6d8fca1bf97b3f1b94ba9fdff4ab9acbb089655641430cc636efd9a60cdadc506d347ab58b907b7b11e3991eff22655a24b5b7c5660599d75
+  data.tar.gz: 5b37bad356a2973d7ab0030afe938a8baa2b8a86d62a769e1ecd9bc7ffa31c5aa424b24016b14cb564e4e5db48c10b7dfce58dfbc626a81666212ae3b77923aa

data/CHANGELOG.md

@@ -6,7 +6,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
-## [1.0.0] - 2025-11-09
+## [1.2.0] - 2025-11-08
+
+### Added
+- Added unmock helpers
+
+## [1.1.0] - 2025-11-08
+
+### Added
+- Added unstub helpers
+
+## [1.0.0] - 2025-11-08
 
 ### Added
 - Added mock and stub helpers

data/README.md

@@ -59,7 +59,11 @@ it "returns skipped" do
   expect(result).to have_skipped
 
   # Custom result
-  expect(result).to have_skipped(reason: "Skipping for a custom reason")
+  expect(result).to have_skipped(
+    reason: "Skipping for a custom reason",
+    cause: be_a(CMDx::SkipFault)
+    # Other members of `result.to_h`...
+  )
 end
 ```
 
@@ -75,7 +79,11 @@ it "returns failure" do
   expect(result).to have_failed
 
   # Custom result
-  expect(result).to have_failed(reason: "Failed for a custom reason")
+  expect(result).to have_failed(
+    reason: "Failed for a custom reason",
+    cause: be_a(NoMethodError)
+    # Other members of `result.to_h`...
+  )
 end
 ```
 
@@ -163,7 +171,7 @@ end
 
 Helper methods for stubbing CMDx command execution.
 
-### Execution types
+#### Types
 
 ```ruby
 it "stubs task executions by type" do
@@ -179,11 +187,7 @@ it "stubs task executions by type" do
 
   # Your specs...
 end
-```
-
-### Options
 
-```ruby
 it "stubs task with arguments" do
   # eg: SomeTask.execute(some: "value")
   stub_task_success(SomeTask, some: "value")
@@ -195,6 +199,8 @@ it "stubs task with arguments" do
 end
 ```
 
+#### Options
+
 ```ruby
 it "stubs task with metadata" do
   stub_task_success(SomeTask, metadata: { some: "value" })
@@ -215,11 +221,25 @@ it "stubs task with a custom cause" do
 end
 ```
 
+#### Reset
+
+```ruby
+it "unstubs task executions by type" do
+  # eg: SomeTask.execute
+  unstub_task(SomeTask)
+
+  # eg: SomeTask.execute!
+  unstub_task!(SomeTask)
+
+  # Your specs...
+end
+```
+
 ### Mocks
 
 Helper methods for setting expectations on CMDx command execution.
 
-### Execution types
+#### Types
 
 ```ruby
 it "mocks task executions by type" do
@@ -231,11 +251,7 @@ it "mocks task executions by type" do
 
   # Your specs...
 end
-```
 
-### Options
-
-```ruby
 it "mocks task with arguments" do
   # eg: SomeTask.execute(some: "value")
   expect_task_execution(SomeTask, some: "value")
@@ -245,6 +261,16 @@ it "mocks task with arguments" do
 
   # Your specs...
 end
+
+it "mocks no task executions by type" do
+  # eg: SomeTask.execute
+  expect_no_task_execution(SomeTask)
+
+  # eg: SomeTask.execute!
+  expect_no_task_execution!(SomeTask)
+
+  # Your specs...
+end
 ```
 
 ## Development

data/lib/cmdx/rspec/helpers.rb

@@ -205,6 +205,34 @@ module CMDx
         result
       end
 
+      # Unstubs a command's :execute method.
+      #
+      # @param command [Class] The command class to unstub execution on
+      #
+      # @return [void]
+      #
+      # @example Unstubbing execute
+      #   unstub_task(MyCommand)
+      #
+      #   MyCommand.execute
+      def unstub_task(command)
+        allow(command).to receive(:execute).and_call_original
+      end
+
+      # Unstubs a command's :execute! method.
+      #
+      # @param command [Class] The command class to unstub execution on
+      #
+      # @return [void]
+      #
+      # @example Unstubbing execute!
+      #   unstub_task!(MyCommand)
+      #
+      #   MyCommand.execute!
+      def unstub_task!(command)
+        allow(command).to receive(:execute!).and_call_original
+      end
+
       # Sets up an expectation that a command will receive :execute with the given context.
       #
       # @param command [Class] The command class to expect execution on
@@ -253,6 +281,34 @@ module CMDx
         end
       end
 
+      # Sets up an expectation that a command will not receive :execute.
+      #
+      # @param command [Class] The command class to expect execution on
+      #
+      # @return [RSpec::Mocks::MessageExpectation] The RSpec expectation object
+      #
+      # @example Expecting no execution
+      #   expect_no_task_execution(MyCommand)
+      #
+      #   MyCommand.execute
+      def expect_no_task_execution(command)
+        expect(command).not_to receive(:execute)
+      end
+
+      # Sets up an expectation that a command will not receive :execute!.
+      #
+      # @param command [Class] The command class to expect execution on
+      #
+      # @return [RSpec::Mocks::MessageExpectation] The RSpec expectation object
+      #
+      # @example Expecting no execution!
+      #   expect_no_task_execution!(MyCommand)
+      #
+      #   MyCommand.execute!
+      def expect_no_task_execution!(command)
+        expect(command).not_to receive(:execute!)
+      end
+
     end
   end
 end

data/lib/cmdx/rspec/version.rb

@@ -3,7 +3,7 @@
 module CMDx
   module RSpec
 
-    VERSION = "1.0.0"
+    VERSION = "1.2.0"
 
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cmdx-rspec
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Juan Gomez