feat!: v0.0.1-dev.7 (#7)

CHANGELOG.md

@@ -1,3 +1,12 @@
+# 0.0.1-dev.7
+
+- **BREAKING** refactor: rename `verify(mock).calls(#member)` to `verify(mock).called(#member)`
+- feat: add `any` argument matcher support to `verify` and `calls`
+- feat: add `anyThat` argument matcher support to `verify` and `calls`
+- feat: support `verify(mock).called(#member).once()`
+- feat: support `verify(mock).called(#member).never()`
+- feat: improve error messages to include invocation arguments
+
 # 0.0.1-dev.6
 
 - **BREAKING** refactor: use `Symbol` rather than `String`

README.md

@@ -40,11 +40,20 @@ The `MockCat` instance can then be used to stub and verify calls.
 // Stub the `sound` method.
 when(cat).calls(#sound).thenReturn('meow');
 
+// Verify no interactions have occurred.
+verify(cat).called(#sound).never();
+
 // Interact with the mock cat instance.
 cat.sound();
 
-// Verify the interaction occurred (with matcher support).
-verify(cat).calls(#sound).times(equals(1));
+// Verify the interaction occurred.
+verify(cat).called(#sound).once();
+
+// Interact with the mock instance again.
+cat.sound();
+
+// Verify the interaction occurred twice.
+verify(cat).called(#sound).times(2);
 ```
 
 ## Additional Usage
@@ -73,11 +82,18 @@ when(cat).calls(#likes).withArgs(
 expect(cat.likes('fish'), isTrue);
 
 // You can verify the interaction for specific arguments.
-verify(cat).calls(#likes).withArgs(
+verify(cat).called(#likes).withArgs(
   positional: ['fish'],
   named: {#isHungry: false},
 ).times(1);
 
+// You can stub a method using argument matchers: `any` or `anyThat`.
+when(cat).calls(#likes).withArgs(
+  positional: [any],
+  named: {#isHungry: anyThat(isFalse)},
+).thenReturn(true);
+expect(cat.likes('fish'), isTrue);
+
 // You can stub a method to throw.
 when(cat).calls(#sound).thenThrow(Exception('oops'));
 expect(() => cat.sound(), throwsA(isA<Exception>()));

example/main.dart

@@ -27,7 +27,7 @@ void main() {
       expect(cat.sound(), 'purr');
 
       // Verify the interaction.
-      verify(cat).calls(#sound).times(1);
+      verify(cat).called(#sound).once();
 
       // Stub a method with parameters
       when(cat).calls(#likes).withArgs(
@@ -37,10 +37,10 @@ void main() {
       expect(cat.likes('fish'), isTrue);
 
       // Verify the interaction.
-      verify(cat).calls(#likes).withArgs(
+      verify(cat).called(#likes).withArgs(
         positional: ['fish'],
         named: {#isHungry: false},
-      ).times(1);
+      ).once();
     });
   });
 }