DanielCardonaRojas/swift-mocking

- Stub API is `thenReturn` / `thenThrow` / `do` — there is no `.then`. - **Never write `thenReturn(())`.** `Void` is in the default-value registry, so an unstubbed `-> Void` member just runs and records the call — stub it only to throw or t

- **Never write `thenReturn(())`.** `Void` is in the default-value registry, so an unstubbed `-> Void` member just runs and records the call — stub it only to throw or to attach a `do` side effect. The registry also covers `Bool`/`String`/`

- Spy names come from the requirement, ignoring argument labels: methods use their name, subscripts are namespaced as `subscript`+ParameterNames (`subscript(row:column:)` → `subscriptRowColumn`), settable members add `set`+Name. The prefix 

let mock = MyServiceMock()                    // generated: @Mockable protocol MyService when(mock.fetch(id: .any)).thenReturn(value)  // arrange — stub BEFORE use

when(mock.fetch(id: .any)).thenReturn(value)  // arrange — stub BEFORE use

let out = try await sut.fetch(id: "1")        // act — direct call routes through the spy

verify(mock.fetch(id: .equal("1"))).called(1) // assert

when(mock.execute(completion: .any)).do { completion in completion("ok") }     // side effect / callbacks when(mock.calculatePrice(.any)).thenReturn { item in prices[item] ?? 0 }      // dynamic return when(mock.fetch(.equal(url))).thenRetu

when(mock.fetch(.equal(url))).thenReturn { _ in callCount == 1 ? throw Timeout : data } // stateful

await verify(mock.upload(.any)).didThrow()      // async spies: await the didThrow() form verifyInOrder([mock.auth(.any), mock.data(.any)])  // call order across spies `called(n)` is synchronous for all effect types; only `.didThrow()` on a

`called(n)` is synchronous for all effect types; only `.didThrow()` on async spies needs `await`. Verification failures are reported through [IssueReporting](https://github.com/pointfreeco/swift-issue-reporting) — they record issues inside 

@Test func fetches() async throws {     let mock = MyServiceMock()     when(mock.fetch(id: .any)).thenReturn(User(id: "123"))

let mock = MyServiceMock()     when(mock.fetch(id: .any)).thenReturn(User(id: "123"))     let user = try await SUT(mock).fetch(id: "123")

when(mock.fetch(id: .any)).thenReturn(User(id: "123"))

let user = try await SUT(mock).fetch(id: "123")

#expect(user.id == "123")     await verify(mock.fetch(id: .equal("123"))).called(1) }

await verify(mock.fetch(id: .equal("123"))).called(1)