//  OCHamcrest by Jon Reid, https://qualitycoding.org/
//  Copyright 2019 hamcrest.org. See LICENSE.txt

#import <OCHamcrest/HCBaseMatcher.h>


NS_ASSUME_NONNULL_BEGIN

/*!
 * @abstract Supporting class for matching a feature of an object.
 * @discussion Tests whether the result of passing the specified invocation to the value satisfies
 * the specified matcher.
 */
@interface HCInvocationMatcher : HCBaseMatcher


/*!
 * @abstract Determines whether a mismatch will be described in short form.
 * @discussion Default is long form, which describes the object, the name of the invocation, and the
 * sub-matcher's mismatch diagnosis. Short form only has the sub-matcher's mismatch diagnosis.
 */
@property (nonatomic, assign) BOOL shortMismatchDescription;

/*!
 * @abstract Initializes a newly allocated HCInvocationMatcher with an invocation and a matcher.
 */
- (instancetype)initWithInvocation:(NSInvocation *)anInvocation matching:(id <HCMatcher>)aMatcher NS_DESIGNATED_INITIALIZER;
- (instancetype)init NS_UNAVAILABLE;

/*!
 * @abstract Invokes stored invocation on the specified item and returns the result.
 */
- (id)invokeOn:(id)item;

/*!
 * @abstract Returns string representation of the invocation's selector.
 */
- (NSString *)stringFromSelector;

@end

NS_ASSUME_NONNULL_END