// // GTMSenTestCase.h // // Copyright 2007-2008 Google Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); you may not // use this file except in compliance with the License. You may obtain a copy // of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the // License for the specific language governing permissions and limitations under // the License. // // Portions of this file fall under the following license, marked with // SENTE_BEGIN - SENTE_END // // Copyright (c) 1997-2005, Sen:te (Sente SA). All rights reserved. // // Use of this source code is governed by the following license: // // Redistribution and use in source and binary forms, with or without modification, // are permitted provided that the following conditions are met: // // (1) Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // // (2) Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. // IN NO EVENT SHALL Sente SA OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, // OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, // EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // // Note: this license is equivalent to the FreeBSD license. // // This notice may not be removed from this file. // Some extra test case macros that would have been convenient for SenTestingKit // to provide. I didn't stick GTM in front of the Macro names, so that they would // be easy to remember. #import "GTMDefines.h" #if (!GTM_IPHONE_SDK) #import #else #import NSString *STComposeString(NSString *, ...); #endif // Generates a failure when a1 != noErr // Args: // a1: should be either an OSErr or an OSStatus // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNoErr(a1, description, ...) \ do { \ @try {\ OSStatus a1value = (a1); \ if (a1value != noErr) { \ NSString *_expression = [NSString stringWithFormat:@"Expected noErr, got %ld for (%s)", a1value, #a1]; \ if (description) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(description, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ } \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat:@"(%s) == noErr fails", #a1] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 != a2 // Args: // a1: received value. Should be either an OSErr or an OSStatus // a2: expected value. Should be either an OSErr or an OSStatus // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertErr(a1, a2, description, ...) \ do { \ @try {\ OSStatus a1value = (a1); \ OSStatus a2value = (a2); \ if (a1value != a2value) { \ NSString *_expression = [NSString stringWithFormat:@"Expected %s(%ld) but got %ld for (%s)", #a2, a2value, a1value, #a1]; \ if (description) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(description, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ } \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat:@"(%s) == noErr fails", #a1] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 is NULL // Args: // a1: should be a pointer (use STAssertNotNil for an object) // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNotNULL(a1, description, ...) \ do { \ @try {\ const void* a1value = (a1); \ if (a1value == NULL) { \ NSString *_expression = [NSString stringWithFormat:@"(%s) != NULL", #a1]; \ if (description) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(description, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ } \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat:@"(%s) != NULL fails", #a1] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 is not NULL // Args: // a1: should be a pointer (use STAssertNil for an object) // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNULL(a1, description, ...) \ do { \ @try {\ const void* a1value = (a1); \ if (a1value != NULL) { \ NSString *_expression = [NSString stringWithFormat:@"(%s) == NULL", #a1]; \ if (description) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(description, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ } \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat:@"(%s) == NULL fails", #a1] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 is equal to a2. This test is for C scalars, // structs and unions. // Args: // a1: argument 1 // a2: argument 2 // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNotEquals(a1, a2, description, ...) \ do { \ @try {\ if (@encode(__typeof__(a1)) != @encode(__typeof__(a2))) { \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:[@"Type mismatch -- " stringByAppendingString:STComposeString(description, ##__VA_ARGS__)]]]; \ } else { \ __typeof__(a1) a1value = (a1); \ __typeof__(a2) a2value = (a2); \ NSValue *a1encoded = [NSValue value:&a1value withObjCType:@encode(__typeof__(a1))]; \ NSValue *a2encoded = [NSValue value:&a2value withObjCType:@encode(__typeof__(a2))]; \ if ([a1encoded isEqualToValue:a2encoded]) { \ NSString *_expression = [NSString stringWithFormat:@"(%s) != (%s)", #a1, #a2]; \ if (description) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(description, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ } \ } \ } \ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat:@"(%s) != (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 is equal to a2. This test is for objects. // Args: // a1: argument 1. object. // a2: argument 2. object. // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNotEqualObjects(a1, a2, desc, ...) \ do { \ @try {\ id a1value = (a1); \ id a2value = (a2); \ if ( (@encode(__typeof__(a1value)) == @encode(id)) && \ (@encode(__typeof__(a2value)) == @encode(id)) && \ ![(id)a1value isEqual:(id)a2value] ) continue; \ NSString *_expression = [NSString stringWithFormat:@"%s('%@') != %s('%@')", #a1, [a1 description], #a2, [a2 description]]; \ if (desc) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(desc, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) != (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(desc, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 is not 'op' to a2. This test is for C scalars. // Args: // a1: argument 1 // a2: argument 2 // op: operation // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertOperation(a1, a2, op, description, ...) \ do { \ @try {\ if (@encode(__typeof__(a1)) != @encode(__typeof__(a2))) { \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:[@"Type mismatch -- " stringByAppendingString:STComposeString(description, ##__VA_ARGS__)]]]; \ } else { \ __typeof__(a1) a1value = (a1); \ __typeof__(a2) a2value = (a2); \ if (!(a1value op a2value)) { \ double a1DoubleValue = a1value; \ double a2DoubleValue = a2value; \ NSString *_expression = [NSString stringWithFormat:@"%s (%lg) %s %s (%lg)", #a1, a1DoubleValue, #op, #a2, a2DoubleValue]; \ if (description) { \ _expression = [NSString stringWithFormat:@"%@: %@", _expression, STComposeString(description, ##__VA_ARGS__)]; \ } \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:_expression]]; \ } \ } \ } \ @catch (id anException) {\ [self failWithException:[NSException \ failureInRaise:[NSString stringWithFormat:@"(%s) %s (%s)", #a1, #op, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when a1 is not > a2. This test is for C scalars. // Args: // a1: argument 1 // a2: argument 2 // op: operation // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertGreaterThan(a1, a2, description, ...) \ STAssertOperation(a1, a2, >, description, ##__VA_ARGS__) // Generates a failure when a1 is not >= a2. This test is for C scalars. // Args: // a1: argument 1 // a2: argument 2 // op: operation // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertGreaterThanOrEqual(a1, a2, description, ...) \ STAssertOperation(a1, a2, >=, description, ##__VA_ARGS__) // Generates a failure when a1 is not < a2. This test is for C scalars. // Args: // a1: argument 1 // a2: argument 2 // op: operation // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertLessThan(a1, a2, description, ...) \ STAssertOperation(a1, a2, <, description, ##__VA_ARGS__) // Generates a failure when a1 is not <= a2. This test is for C scalars. // Args: // a1: argument 1 // a2: argument 2 // op: operation // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertLessThanOrEqual(a1, a2, description, ...) \ STAssertOperation(a1, a2, <=, description, ##__VA_ARGS__) // Generates a failure when string a1 is not equal to string a2. This call // differs from STAssertEqualObjects in that strings that are different in // composition (precomposed vs decomposed) will compare equal if their final // representation is equal. // ex O + umlaut decomposed is the same as O + umlaut composed. // Args: // a1: string 1 // a2: string 2 // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertEqualStrings(a1, a2, description, ...) \ do { \ @try {\ id a1value = (a1); \ id a2value = (a2); \ if (a1value == a2value) continue; \ if ([a1value isKindOfClass:[NSString class]] && \ [a2value isKindOfClass:[NSString class]] && \ [a1value compare:a2value options:0] == NSOrderedSame) continue; \ [self failWithException:[NSException failureInEqualityBetweenObject: a1value \ andObject: a2value \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) == (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when string a1 is equal to string a2. This call // differs from STAssertEqualObjects in that strings that are different in // composition (precomposed vs decomposed) will compare equal if their final // representation is equal. // ex O + umlaut decomposed is the same as O + umlaut composed. // Args: // a1: string 1 // a2: string 2 // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNotEqualStrings(a1, a2, description, ...) \ do { \ @try {\ id a1value = (a1); \ id a2value = (a2); \ if ([a1value isKindOfClass:[NSString class]] && \ [a2value isKindOfClass:[NSString class]] && \ [a1value compare:a2value options:0] != NSOrderedSame) continue; \ [self failWithException:[NSException failureInEqualityBetweenObject: a1value \ andObject: a2value \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) != (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when c-string a1 is not equal to c-string a2. // Args: // a1: string 1 // a2: string 2 // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertEqualCStrings(a1, a2, description, ...) \ do { \ @try {\ const char* a1value = (a1); \ const char* a2value = (a2); \ if (a1value == a2value) continue; \ if (strcmp(a1value, a2value) == 0) continue; \ [self failWithException:[NSException failureInEqualityBetweenObject: [NSString stringWithUTF8String:a1value] \ andObject: [NSString stringWithUTF8String:a2value] \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) == (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) // Generates a failure when c-string a1 is equal to c-string a2. // Args: // a1: string 1 // a2: string 2 // description: A format string as in the printf() function. Can be nil or // an empty string but must be present. // ...: A variable number of arguments to the format string. Can be absent. #define STAssertNotEqualCStrings(a1, a2, description, ...) \ do { \ @try {\ const char* a1value = (a1); \ const char* a2value = (a2); \ if (strcmp(a1value, a2value) != 0) continue; \ [self failWithException:[NSException failureInEqualityBetweenObject: [NSString stringWithUTF8String:a1value] \ andObject: [NSString stringWithUTF8String:a2value] \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) != (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) #if GTM_IPHONE_SDK // SENTE_BEGIN /*" Generates a failure when !{ [a1 isEqualTo:a2] } is false (or one is nil and the other is not). _{a1 The object on the left.} _{a2 The object on the right.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertEqualObjects(a1, a2, description, ...) \ do { \ @try {\ id a1value = (a1); \ id a2value = (a2); \ if (a1value == a2value) continue; \ if ( (@encode(__typeof__(a1value)) == @encode(id)) && \ (@encode(__typeof__(a2value)) == @encode(id)) && \ [(id)a1value isEqual: (id)a2value] ) continue; \ [self failWithException:[NSException failureInEqualityBetweenObject: a1value \ andObject: a2value \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) == (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) /*" Generates a failure when a1 is not equal to a2. This test is for C scalars, structs and unions. _{a1 The argument on the left.} _{a2 The argument on the right.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertEquals(a1, a2, description, ...) \ do { \ @try {\ if (@encode(__typeof__(a1)) != @encode(__typeof__(a2))) { \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:[@"Type mismatch -- " stringByAppendingString:STComposeString(description, ##__VA_ARGS__)]]]; \ } else { \ __typeof__(a1) a1value = (a1); \ __typeof__(a2) a2value = (a2); \ NSValue *a1encoded = [NSValue value:&a1value withObjCType: @encode(__typeof__(a1))]; \ NSValue *a2encoded = [NSValue value:&a2value withObjCType: @encode(__typeof__(a2))]; \ if (![a1encoded isEqualToValue:a2encoded]) { \ [self failWithException:[NSException failureInEqualityBetweenValue: a1encoded \ andValue: a2encoded \ withAccuracy: nil \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ } \ } \ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) == (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) #define STAbsoluteDifference(left,right) (MAX(left,right)-MIN(left,right)) /*" Generates a failure when a1 is not equal to a2 within + or - accuracy is false. This test is for scalars such as floats and doubles where small differences could make these items not exactly equal, but also works for all scalars. _{a1 The scalar on the left.} _{a2 The scalar on the right.} _{accuracy The maximum difference between a1 and a2 for these values to be considered equal.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertEqualsWithAccuracy(a1, a2, accuracy, description, ...) \ do { \ @try {\ if (@encode(__typeof__(a1)) != @encode(__typeof__(a2))) { \ [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:[@"Type mismatch -- " stringByAppendingString:STComposeString(description, ##__VA_ARGS__)]]]; \ } else { \ __typeof__(a1) a1value = (a1); \ __typeof__(a2) a2value = (a2); \ __typeof__(accuracy) accuracyvalue = (accuracy); \ if (STAbsoluteDifference(a1value, a2value) > accuracyvalue) { \ NSValue *a1encoded = [NSValue value:&a1value withObjCType:@encode(__typeof__(a1))]; \ NSValue *a2encoded = [NSValue value:&a2value withObjCType:@encode(__typeof__(a2))]; \ NSValue *accuracyencoded = [NSValue value:&accuracyvalue withObjCType:@encode(__typeof__(accuracy))]; \ [self failWithException:[NSException failureInEqualityBetweenValue: a1encoded \ andValue: a2encoded \ withAccuracy: accuracyencoded \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ } \ } \ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) == (%s)", #a1, #a2] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) /*" Generates a failure unconditionally. _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STFail(description, ...) \ [self failWithException:[NSException failureInFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]] /*" Generates a failure when a1 is not nil. _{a1 An object.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertNil(a1, description, ...) \ do { \ @try {\ id a1value = (a1); \ if (a1value != nil) { \ NSString *_a1 = [NSString stringWithUTF8String: #a1]; \ NSString *_expression = [NSString stringWithFormat:@"((%@) == nil)", _a1]; \ [self failWithException:[NSException failureInCondition: _expression \ isTrue: NO \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) == nil fails", #a1] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) /*" Generates a failure when a1 is nil. _{a1 An object.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertNotNil(a1, description, ...) \ do { \ @try {\ id a1value = (a1); \ if (a1value == nil) { \ NSString *_a1 = [NSString stringWithUTF8String: #a1]; \ NSString *_expression = [NSString stringWithFormat:@"((%@) != nil)", _a1]; \ [self failWithException:[NSException failureInCondition: _expression \ isTrue: NO \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ }\ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) != nil fails", #a1] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while(0) /*" Generates a failure when expression evaluates to false. _{expr The expression that is tested.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertTrue(expr, description, ...) \ do { \ BOOL _evaluatedExpression = (expr);\ if (!_evaluatedExpression) {\ NSString *_expression = [NSString stringWithUTF8String: #expr];\ [self failWithException:[NSException failureInCondition: _expression \ isTrue: NO \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ } while (0) /*" Generates a failure when expression evaluates to false and in addition will generate error messages if an exception is encountered. _{expr The expression that is tested.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertTrueNoThrow(expr, description, ...) \ do { \ @try {\ BOOL _evaluatedExpression = (expr);\ if (!_evaluatedExpression) {\ NSString *_expression = [NSString stringWithUTF8String: #expr];\ [self failWithException:[NSException failureInCondition: _expression \ isTrue: NO \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ } \ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"(%s) ", #expr] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while (0) /*" Generates a failure when the expression evaluates to true. _{expr The expression that is tested.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertFalse(expr, description, ...) \ do { \ BOOL _evaluatedExpression = (expr);\ if (_evaluatedExpression) {\ NSString *_expression = [NSString stringWithUTF8String: #expr];\ [self failWithException:[NSException failureInCondition: _expression \ isTrue: YES \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ } while (0) /*" Generates a failure when the expression evaluates to true and in addition will generate error messages if an exception is encountered. _{expr The expression that is tested.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertFalseNoThrow(expr, description, ...) \ do { \ @try {\ BOOL _evaluatedExpression = (expr);\ if (_evaluatedExpression) {\ NSString *_expression = [NSString stringWithUTF8String: #expr];\ [self failWithException:[NSException failureInCondition: _expression \ isTrue: YES \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } \ } \ @catch (id anException) {\ [self failWithException:[NSException failureInRaise:[NSString stringWithFormat: @"!(%s) ", #expr] \ exception:anException \ inFile:[NSString stringWithUTF8String:__FILE__] \ atLine:__LINE__ \ withDescription:STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while (0) /*" Generates a failure when expression does not throw an exception. _{expression The expression that is evaluated.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent. "*/ #define STAssertThrows(expr, description, ...) \ do { \ @try { \ (expr);\ } \ @catch (id anException) { \ continue; \ }\ [self failWithException:[NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: nil \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ } while (0) /*" Generates a failure when expression does not throw an exception of a specific class. _{expression The expression that is evaluated.} _{specificException The specified class of the exception.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertThrowsSpecific(expr, specificException, description, ...) \ do { \ @try { \ (expr);\ } \ @catch (specificException *anException) { \ continue; \ }\ @catch (id anException) {\ NSString *_descrip = STComposeString(@"(Expected exception: %@) %@", NSStringFromClass([specificException class]), description);\ [self failWithException:[NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: anException \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(_descrip, ##__VA_ARGS__)]]; \ continue; \ }\ NSString *_descrip = STComposeString(@"(Expected exception: %@) %@", NSStringFromClass([specificException class]), description);\ [self failWithException:[NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: nil \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(_descrip, ##__VA_ARGS__)]]; \ } while (0) /*" Generates a failure when expression does not throw an exception of a specific class with a specific name. Useful for those frameworks like AppKit or Foundation that throw generic NSException w/specific names (NSInvalidArgumentException, etc). _{expression The expression that is evaluated.} _{specificException The specified class of the exception.} _{aName The name of the specified exception.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertThrowsSpecificNamed(expr, specificException, aName, description, ...) \ do { \ @try { \ (expr);\ } \ @catch (specificException *anException) { \ if ([aName isEqualToString: [anException name]]) continue; \ NSString *_descrip = STComposeString(@"(Expected exception: %@ (name: %@)) %@", NSStringFromClass([specificException class]), aName, description);\ [self failWithException: \ [NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: anException \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(_descrip, ##__VA_ARGS__)]]; \ continue; \ }\ @catch (id anException) {\ NSString *_descrip = STComposeString(@"(Expected exception: %@) %@", NSStringFromClass([specificException class]), description);\ [self failWithException: \ [NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: anException \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(_descrip, ##__VA_ARGS__)]]; \ continue; \ }\ NSString *_descrip = STComposeString(@"(Expected exception: %@) %@", NSStringFromClass([specificException class]), description);\ [self failWithException: \ [NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: nil \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(_descrip, ##__VA_ARGS__)]]; \ } while (0) /*" Generates a failure when expression does throw an exception. _{expression The expression that is evaluated.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertNoThrow(expr, description, ...) \ do { \ @try { \ (expr);\ } \ @catch (id anException) { \ [self failWithException:[NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: anException \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ } while (0) /*" Generates a failure when expression does throw an exception of the specitied class. Any other exception is okay (i.e. does not generate a failure). _{expression The expression that is evaluated.} _{specificException The specified class of the exception.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertNoThrowSpecific(expr, specificException, description, ...) \ do { \ @try { \ (expr);\ } \ @catch (specificException *anException) { \ [self failWithException:[NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: anException \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(description, ##__VA_ARGS__)]]; \ }\ @catch (id anythingElse) {\ ; \ }\ } while (0) /*" Generates a failure when expression does throw an exception of a specific class with a specific name. Useful for those frameworks like AppKit or Foundation that throw generic NSException w/specific names (NSInvalidArgumentException, etc). _{expression The expression that is evaluated.} _{specificException The specified class of the exception.} _{aName The name of the specified exception.} _{description A format string as in the printf() function. Can be nil or an empty string but must be present.} _{... A variable number of arguments to the format string. Can be absent.} "*/ #define STAssertNoThrowSpecificNamed(expr, specificException, aName, description, ...) \ do { \ @try { \ (expr);\ } \ @catch (specificException *anException) { \ if ([aName isEqualToString: [anException name]]) { \ NSString *_descrip = STComposeString(@"(Expected exception: %@ (name: %@)) %@", NSStringFromClass([specificException class]), aName, description);\ [self failWithException: \ [NSException failureInRaise: [NSString stringWithUTF8String:#expr] \ exception: anException \ inFile: [NSString stringWithUTF8String:__FILE__] \ atLine: __LINE__ \ withDescription: STComposeString(_descrip, ##__VA_ARGS__)]]; \ } \ continue; \ }\ @catch (id anythingElse) {\ ; \ }\ } while (0) @interface NSException (GTMSenTestAdditions) + (NSException *)failureInFile:(NSString *)filename atLine:(int)lineNumber withDescription:(NSString *)formatString, ...; + (NSException *)failureInCondition:(NSString *)condition isTrue:(BOOL)isTrue inFile:(NSString *)filename atLine:(int)lineNumber withDescription:(NSString *)formatString, ...; + (NSException *)failureInEqualityBetweenObject:(id)left andObject:(id)right inFile:(NSString *)filename atLine:(int)lineNumber withDescription:(NSString *)formatString, ...; + (NSException *)failureInEqualityBetweenValue:(NSValue *)left andValue:(NSValue *)right withAccuracy:(NSValue *)accuracy inFile:(NSString *)filename atLine:(int) ineNumber withDescription:(NSString *)formatString, ...; + (NSException *)failureInRaise:(NSString *)expression inFile:(NSString *)filename atLine:(int)lineNumber withDescription:(NSString *)formatString, ...; + (NSException *)failureInRaise:(NSString *)expression exception:(NSException *)exception inFile:(NSString *)filename atLine:(int)lineNumber withDescription:(NSString *)formatString, ...; @end // SENTE_END @interface SenTestCase : NSObject { SEL currentSelector_; } - (void)setUp; - (void)invokeTest; - (void)tearDown; - (void)performTest:(SEL)sel; - (void)failWithException:(NSException*)exception; @end CF_EXPORT NSString * const SenTestFailureException; #endif // GTM_IPHONE_SDK // All unittest cases in GTM should inherit from GTMTestCase. It makes sure // to set up our logging system correctly to verify logging calls. // See GTMUnitTestDevLog.h for details @interface GTMTestCase : SenTestCase @end