Deprecated MKTArgumentCaptor and MKTCapturingMatcher; use HCArgumentC…

…aptor from OCHamcrest v4.3.0 for capturing arguments.

CHANGELOG.md

@@ -21,6 +21,11 @@ NEXT VERSION - breaking change
   prevents retain cycles and crashes during test clean-up. See StopMockingTests.m for an example.
 - NSInvocation+OCMockito.h is now imported by OCMockito.h, so it no longer needs a separate import.
 
+**Deprecated:**
+
+- Deprecated MKTArgumentCaptor and MKTCapturingMatcher; use HCArgumentCaptor from OCHamcrest for
+  capturing arguments.
+
 
 Version 1.4.0
 -------------

README.md

@@ -311,18 +311,18 @@ In some situations though, it's helpful to assert on certain arguments after the
 actual verification. For example:
 
 ```obj-c
-MKTArgumentCaptor *argument = [[MKTArgumentCaptor alloc] init];
-[verify(mockObject) doSomething:[argument capture]];
-assertThat([[argument value] nameAtIndex:0], is(@"Jon"));
+HCArgumentCaptor *argument = [[HCArgumentCaptor alloc] init];
+[verify(mockObject) doSomething:(id)argument];
+assertThat([argument.value nameAtIndex:0], is(@"Jon"));
 ```
 
 Capturing arguments is especially handy for block arguments. You can capture a
 block, then invoke it within your test:
 
 ```obj-c
-MKTArgumentCaptor *argument = [[MKTArgumentCaptor alloc] init];
-[verify(mockArray) sortUsingComparator:[argument capture]];
-NSComparator block = [argument value];
+HCArgumentCaptor *argument = [[HCArgumentCaptor alloc] init];
+[verify(mockArray) sortUsingComparator:(id)argument];
+NSComparator block = argument.value;
 assertThat(@(block(@"a", @"z")), is(@(NSOrderedAscending)));
 ```
 

Source/OCMockito/Matchers/MKTArgumentCaptor.h

@@ -4,6 +4,10 @@
 #import <Foundation/Foundation.h>
 
 
+/*!
+ * @deprecated Version 2.0.0 Use HCArgumentCaptor instead.
+ */
+__attribute__ ((deprecated))
 @interface MKTArgumentCaptor : NSObject
 
 - (id)capture;

Source/OCMockito/Matchers/MKTCapturingMatcher.h

@@ -4,6 +4,10 @@
 #import <OCHamcrest/HCIsAnything.h>
 
 
+/*!
+ * @deprecated Version 2.0.0 Use HCArgumentCaptor instead.
+ */
+__attribute__ ((deprecated))
 @interface MKTCapturingMatcher : HCIsAnything
 
 - (NSArray *)allValues;

Source/Tests/BlockMatchingTests.m

@@ -61,14 +61,14 @@ - (void)testMockingMethodWithBlockArg_WithNotNilValueMatcher_ShouldMatchBlock
 
 - (void)testMockingMethodWithBlockArg_WithArgumentCaptor_ShouldLetYouExecuteCapturedBlock
 {
-    MKTArgumentCaptor *argument = [[MKTArgumentCaptor alloc] init];
+    HCArgumentCaptor *argument = [[HCArgumentCaptor alloc] init];
 
     [mockObj doBlock:^NSString * {
         return @"SUCCESS";
     }];
-    [verify(mockObj) doBlock:[argument capture]];
+    [verify(mockObj) doBlock:(id)argument];
 
-    BlockReturningString block = [argument value];
+    BlockReturningString block = argument.value;
     assertThat(block(), is(@"SUCCESS"));
 }