#import "QuickSpec.h" #import "QuickConfiguration.h" #import "World.h" #import static QuickSpec *currentSpec = nil; @interface QuickSpec () @property (nonatomic, strong) Example *example; @end @implementation QuickSpec #pragma mark - XCTestCase Overrides /** The runtime sends initialize to each class in a program just before the class, or any class that inherits from it, is sent its first message from within the program. QuickSpec hooks into this event to compile the example groups for this spec subclass. If an exception occurs when compiling the examples, report it to the user. Chances are they included an expectation outside of a "it", "describe", or "context" block. */ + (void)initialize { [QuickConfiguration initialize]; World *world = [World sharedWorld]; [world performWithCurrentExampleGroup:[world rootExampleGroupForSpecClass:self] closure:^{ QuickSpec *spec = [self new]; @try { [spec spec]; } @catch (NSException *exception) { [NSException raise:NSInternalInconsistencyException format:@"An exception occurred when building Quick's example groups.\n" @"Some possible reasons this might happen include:\n\n" @"- An 'expect(...).to' expectation was evaluated outside of " @"an 'it', 'context', or 'describe' block\n" @"- 'sharedExamples' was called twice with the same name\n" @"- 'itBehavesLike' was called with a name that is not registered as a shared example\n\n" @"Here's the original exception: '%@', reason: '%@', userInfo: '%@'", exception.name, exception.reason, exception.userInfo]; } [self testInvocations]; }]; } /** Invocations for each test method in the test case. QuickSpec overrides this method to define a new method for each example defined in +[QuickSpec spec]. @return An array of invocations that execute the newly defined example methods. */ + (NSArray *)testInvocations { NSArray *examples = [[World sharedWorld] examplesForSpecClass:[self class]]; NSMutableArray *invocations = [NSMutableArray arrayWithCapacity:[examples count]]; NSMutableSet *selectorNames = [NSMutableSet set]; for (Example *example in examples) { SEL selector = [self addInstanceMethodForExample:example classSelectorNames:selectorNames]; NSMethodSignature *signature = [self instanceMethodSignatureForSelector:selector]; NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature]; invocation.selector = selector; [invocations addObject:invocation]; } return invocations; } #pragma mark - Public Interface - (void)spec { } #pragma mark - Internal Methods /** QuickSpec uses this method to dynamically define a new instance method for the given example. The instance method runs the example, catching any exceptions. The exceptions are then reported as test failures. In order to report the correct file and line number, examples must raise exceptions containing following keys in their userInfo: - "SenTestFilenameKey": A String representing the file name - "SenTestLineNumberKey": An Int representing the line number These keys used to be used by SenTestingKit, and are still used by some testing tools in the wild. See: https://github.com/Quick/Quick/pull/41 @return The selector of the newly defined instance method. */ + (SEL)addInstanceMethodForExample:(Example *)example classSelectorNames:(NSMutableSet *)selectorNames { IMP implementation = imp_implementationWithBlock(^(QuickSpec *self){ self.example = example; currentSpec = self; [example run]; }); const char *types = [[NSString stringWithFormat:@"%s%s%s", @encode(void), @encode(id), @encode(SEL)] UTF8String]; NSString *originalName = example.name.qck_c99ExtendedIdentifier; NSString *selectorName = originalName; NSUInteger i = 2; while ([selectorNames containsObject:selectorName]) { selectorName = [NSString stringWithFormat:@"%@_%tu", originalName, i++]; } [selectorNames addObject:selectorName]; SEL selector = NSSelectorFromString(selectorName); class_addMethod(self, selector, implementation, types); return selector; } /** This method is used to record failures, whether they represent example expectations that were not met, or exceptions raised during test setup and teardown. By default, the failure will be reported as an XCTest failure, and the example will be highlighted in Xcode. */ - (void)recordFailureWithDescription:(NSString *)description inFile:(NSString *)filePath atLine:(NSUInteger)lineNumber expected:(BOOL)expected { if (self.example.isSharedExample) { filePath = self.example.callsite.file; lineNumber = self.example.callsite.line; } [currentSpec.testRun recordFailureWithDescription:description inFile:filePath atLine:lineNumber expected:expected]; } @end