f_service 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35c76d6829665670a72f4763695d28a928a7751e178fea7719807232065982d3
-  data.tar.gz: 8ed46b18e5e50a03a8ff95dcc46415653493bcfd3fbf94070c2be3081a8d97c7
+  metadata.gz: 7e67e52f53d87a6ef69e75049dbde13dee8e57966ff6709215416a4e2eceb2c8
+  data.tar.gz: 061da3eafc01b904885ec3f60df2f33bc3cd492c123af23aa83b0bf330c125de
 SHA512:
-  metadata.gz: 636d06da2f25842dce9357c58019947abb9eb9de224e9ac1d6fe563f3e5ba72eaacae0254d35f406f1a1093746bed5e086a716d2dc4dd2fe7fa7a893c3de8dd4
-  data.tar.gz: 02a373098e1b98169983179162a14b32a23f9d1388c352ea7dbd561c97cde9507725f4480919d8924ffc254710c02f650c77f277a2acb169f2414e0664b356bf
+  metadata.gz: c73801a230b41d8597186e8996f6bcd0e4c529c26e859eb5fac622e01d398c4bc817e705b1087fd4baa46a30c741ee9aa2139a9536cc2a7fb4caeb07a4e8eae9
+  data.tar.gz: 0eaece233ff3e02cf5a3af3bd032f9801b36dd1f1e776e7610bf5af5eeb44492568d58ea9cb7e892ca16d49d71af966c20c99e631a6360aff90abc69b7854d7f

data/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0](https://github.com/Fretadao/f_service/compare/v0.4.1...v0.5.0) (2026-09-30)
+
+
+### ⚠ BREAKING CHANGES
+
+* specs that call a mocked service with arguments its initializer rejects now fail with ArgumentError, and mock_service / f_service_result raise ArgumentError for a result other than :success or :failure (e.g. :failed).
+
+### Features
+
+* verify mock_service calls against the service initializer [CU-86akqxnfz] ([#77](https://github.com/Fretadao/f_service/issues/77)) ([c4efd45](https://github.com/Fretadao/f_service/commit/c4efd4588a337302e5b40e9ba8ff262984d333ee))
+
 ## [0.4.1](https://github.com/Fretadao/f_service/compare/v0.4.0...v0.4.1) (2026-08-19)
 
 

data/README.md

@@ -25,7 +25,7 @@ Add this line to your application's Gemfile:
 
 <!-- x-release-please-start-version -->
 ```ruby
-gem 'f_service', '~> 0.4.1'
+gem 'f_service', '~> 0.5.0'
 ```
 <!-- x-release-please-end-version -->
 
@@ -322,6 +322,34 @@ mock_service(
 > way. `types:` also accepts a bare symbol, but an array reads consistently. The deprecated
 > singular `type:` argument was removed in 0.4.0.
 
+`result:` accepts only `:success` or `:failure`. Anything else raises `ArgumentError` instead of
+silently becoming a Failure — a typo like `result: :failed` used to pass for the wrong reason.
+
+#### Calls are checked against the service's signature
+
+Every call to a mocked service runs the service's real `initialize` with the call's arguments,
+so a call the service would reject fails the spec with `ArgumentError` — the same error it
+would raise in production. The service's `#run` is never executed.
+
+```ruby
+class User::Create < FService::Base
+  def initialize(name:)
+    @name = name
+  end
+end
+
+mock_service(User::Create, types: [:created])
+
+User::Create.(name: 'John')          # => the mocked Success
+User::Create.()                      # => ArgumentError: missing keyword: :name
+User::Create.(name: 'John', age: 42) # => ArgumentError: unknown keyword: :age
+```
+
+When a spec starts failing here after an upgrade, the mock was hiding a call the service no
+longer accepts: fix the call (or the service), not the mock. A test double passed as the
+service (`class_double(...)`) has no real initializer, so its calls are not checked — mock the
+real service class to get the check.
+
 Need the Result object itself rather than a stub — to pass it around in a unit test, say?
 `f_service_result` builds one:
 

data/lib/f_service/rspec/support/helpers/result.rb

@@ -2,8 +2,15 @@
 
 # Methods to mock a FService result from a service call.
 module FServiceResultHelpers
+  # Results a mock can describe.
+  RESULTS = %i[success failure].freeze
+
   # Create an Fservice result Success or Failure.
+  #
+  # @raise [ArgumentError] when the result is neither :success nor :failure
   def f_service_result(result, value = nil, types = [])
+    raise ArgumentError, "result must be :success or :failure, got #{result.inspect}" unless RESULTS.include?(result)
+
     if result == :success
       FService::Result::Success.new(value, Array(types))
     else
@@ -12,9 +19,20 @@ module FServiceResultHelpers
   end
 
   # Mock a Fservice service call returning a result.
+  #
+  # Every call to the mocked service runs the service's real initializer with the call's
+  # arguments, so a call the service would reject fails with ArgumentError. The service's
+  # #run is never executed. A double passed as the service is not verified.
+  #
+  # @raise [ArgumentError] when the result is neither :success nor :failure
   def mock_service(service, result: :success, value: nil, types: [])
     service_result = f_service_result(result, value, Array(types))
-    allow(service).to receive(:call).and_return(service_result)
+
+    allow(service).to receive(:call) do |*args, **kwargs|
+      # allocate skips .new, so a spec that stubs .new does not interfere with the verification
+      service.allocate.send(:initialize, *args, **kwargs) if service.is_a?(Class)
+      service_result
+    end
   end
 end
 

data/lib/f_service/version.rb

@@ -2,5 +2,5 @@
 
 module FService
   # Current version of the gem
-  VERSION = '0.4.1'
+  VERSION = '0.5.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: f_service
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Fretadao Tech Team