| // |
| // 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_MACOS_SDK |
| #if GTM_USING_XCTEST |
| #import <XCTest/XCTest.h> |
| #else |
| #warning "SenTestingKit is deprecated. Please move to XCTest." |
| #import <SenTestingKit/SenTestingKit.h> |
| #endif // GTM_USING_XCTEST |
| // We don't support our built in testing on MacOS since its always had sentest. |
| #elif GTM_IPHONE_SDK |
| #if GTM_USING_XCTEST |
| #import <XCTest/XCTest.h> |
| #else |
| #import <Foundation/Foundation.h> |
| NS_DEPRECATED(10_4, 10_8, 1_0, 7_0, "Please move to XCTest") |
| GTM_EXTERN NSString *STComposeString(NSString *, ...) NS_FORMAT_FUNCTION(1, 2); |
| #endif // GTM_USING_XCTEST |
| #endif // GTM_MACOS_SDK |
| |
| #if GTM_USING_XCTEST |
| |
| #pragma clang diagnostic push |
| #pragma clang diagnostic ignored "-Wreserved-id-macro" |
| |
| #define _XCExceptionFormatString @"throwing \"%@\"" |
| #define _XCUnknownExceptionString @"throwing an unknown exception" |
| #if (defined(__IPHONE_8_0) && __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_8_0) || (GTM_MACOS_SDK == 1) |
| // They changed the call to _XCTRegisterFailure in iOS 8. Once we no longer need to support |
| // the iOS 7 SDK, we can remove this. |
| #define _GTMXCRegisterFailure(expression, format...) _XCTRegisterFailure(self, expression, format) |
| #else |
| #define _GTMXCRegisterFailure(expression, format...) _XCTRegisterFailure(expression, format) |
| #endif // defined defined(__IPHONE_8_0) && __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_8_0 |
| |
| #pragma clang diagnostic pop |
| |
| // 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. |
| #ifndef XCTAssertNoErr |
| #define XCTAssertNoErr(a1, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| __typeof__(a1) _a1value = (a1); \ |
| if (_a1value != noErr) { \ |
| _failure = [NSString stringWithFormat:@"%d != noErr", (int)_a1value]; \ |
| } \ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:@": " _XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = @": " _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%@) != noErr) failed%@", @#a1, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertNoErr |
| |
| // 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. |
| #ifndef XCTAssertErr |
| #define XCTAssertErr(a1, a2, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| __typeof__(a1) _a1value = (a1); \ |
| __typeof__(a2) _a2value = (a2); \ |
| if (_a1value != _a2value) { \ |
| _failure = [NSString stringWithFormat:@"(%d) != (%d)", (int)_a1value, (int)_a2value]; \ |
| } \ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:@": " _XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = @": " _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%@) != (%@)) failed %@", @#a1, @#a2, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertErr |
| |
| // Generates a failure when a1 is NULL |
| // Args: |
| // a1: should be a pointer (use XCTAssertNotNil 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. |
| #ifndef XCTAssertNotNULL |
| #define XCTAssertNotNULL(a1, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| __typeof__(a1) _a1value = (a1); \ |
| if (_a1value == (__typeof__(a1))NULL) { \ |
| _failure = @""; \ |
| } \ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:@": " _XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = @": " _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%@) != NULL) failed%@", @#a1, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertNotNULL |
| |
| // Generates a failure when a1 is not NULL |
| // Args: |
| // a1: should be a pointer (use XCTAssertNil 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. |
| #ifndef XCTAssertNULL |
| #define XCTAssertNULL(a1, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| __typeof__(a1) _a1value = (a1); \ |
| if (_a1value != (__typeof__(a1))NULL) { \ |
| _failure = @""; \ |
| } \ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:@": " _XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = @": " _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%@) == NULL) failed%@", @#a1, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertNULL |
| |
| // Generates a failure when string a1 is not equal to string a2. This call |
| // differs from XCTAssertEqualObjects 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. |
| #ifndef XCTAssertEqualStrings |
| #define XCTAssertEqualStrings(a1, a2, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| NSString *_a1value = (a1); \ |
| NSString *_a2value = (a2); \ |
| NSComparisonResult _result; \ |
| if (![_a1value isKindOfClass:[NSString class]]) { \ |
| _failure = [NSString stringWithFormat:@"(%@) is not an NSString* (%@)", @#a1, [_a1value class]]; \ |
| } else if (![_a2value isKindOfClass:[NSString class]]) { \ |
| _failure = [NSString stringWithFormat:@"(%@) is not an NSString* (%@)", @#a2, [_a2value class]]; \ |
| } else if ((_result = [_a1value compare:_a2value]) != NSOrderedSame) { \ |
| _failure = [NSString stringWithFormat:@"(%@) vs (%@) == %ld", _a1value, _a2value, (long)_result]; \ |
| } \ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:_XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"([(%@) compare:(%@)] == NSOrderedSame) failed: %@", @#a1, @#a2, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertEqualStrings |
| |
| // Generates a failure when string a1 is equal to string a2. This call |
| // differs from XCTAssertEqualObjects 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. |
| #ifndef XCTAssertNotEqualStrings |
| #define XCTAssertNotEqualStrings(a1, a2, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| NSString *_a1value = (a1); \ |
| NSString *_a2value = (a2); \ |
| NSComparisonResult _result; \ |
| if (![_a1value isKindOfClass:[NSString class]]) { \ |
| _failure = [NSString stringWithFormat:@"(%@) is not an NSString* (%@)", @#a1, [_a1value class]]; \ |
| } else if (![_a2value isKindOfClass:[NSString class]]) { \ |
| _failure = [NSString stringWithFormat:@"(%@) is not an NSString* (%@)", @#a2, [_a2value class]]; \ |
| } else if ((_result = [_a1value compare:_a2value]) == NSOrderedSame) { \ |
| _failure = [NSString stringWithFormat:@"(%@) vs (%@) == %ld", _a1value, _a2value, (long)_result]; \ |
| } \ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:_XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"([(%@) compare:(%@)] != NSOrderedSame) failed: %@", @#a1, @#a2, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertNotEqualStrings |
| |
| // 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. |
| #ifndef XCTAssertEqualCStrings |
| #define XCTAssertEqualCStrings(a1, a2, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| const char* _a1value = (a1); \ |
| const char* _a2value = (a2); \ |
| if (_a1value != _a2value && \ |
| (_a1value == NULL || _a2value == NULL || strcmp(_a1value, _a2value) != 0)) { \ |
| _failure = [NSString stringWithFormat:@"strcmp(\"%s\", \"%s\") != 0", _a1value, _a2value]; \ |
| }\ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:@": " _XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = @": " _XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%@) vs. (%@) failed: %@", \ |
| GTM_NSSTRINGIFY(a1), GTM_NSSTRINGIFY(a2), _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertEqualCStrings |
| |
| // 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. |
| #ifndef XCTAssertNotEqualCStrings |
| #define XCTAssertNotEqualCStrings(a1, a2, format...) \ |
| ({ \ |
| NSString *_failure = nil; \ |
| @try { \ |
| const char* _a1value = (a1); \ |
| const char* _a2value = (a2); \ |
| if (_a1value == _a2value || strcmp(_a1value, _a2value) == 0) { \ |
| failure = @""; \ |
| }\ |
| } \ |
| @catch (NSException *_exception) { \ |
| _failure = [NSString stringWithFormat:@": " _XCExceptionFormatString, [_exception reason]]; \ |
| } \ |
| @catch (...) { \ |
| _failure = @": "_XCUnknownExceptionString; \ |
| } \ |
| if (_failure) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%s) != (%s) failed%@", @#a1, @#a2, _failure]; \ |
| _GTMXCRegisterFailure(_expression, format); \ |
| } \ |
| }) |
| #endif // XCTAssertNotEqualCStrings |
| |
| #else // GTM_USING_XCTEST |
| |
| // 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)", (long)_a1value, #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) == 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, (long)_a2value, (long)_a1value, #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) == (%s) fails", #a1, #a2] \ |
| 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 { \ |
| __typeof__(a1) _a1value = (a1); \ |
| if (_a1value == (__typeof__(a1))NULL) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%s) != NULL)", #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) != 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 { \ |
| __typeof__(a1) _a1value = (a1); \ |
| if (_a1value != (__typeof__(a1))NULL) { \ |
| NSString *_expression = [NSString stringWithFormat:@"((%s) == NULL)", #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) == 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 (strcmp(@encode(__typeof__(a1)), @encode(__typeof__(a2)))) { \ |
| [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"Type mismatch -- %@", 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]; \ |
| [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) != (%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, description, ...) \ |
| do { \ |
| @try {\ |
| id _a1value = (a1); \ |
| id _a2value = (a2); \ |
| if ( (strcmp(@encode(__typeof__(_a1value)), @encode(id)) == 0) && \ |
| (strcmp(@encode(__typeof__(_a2value)), @encode(id)) == 0) && \ |
| (![(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 '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 (strcmp(@encode(__typeof__(a1)), @encode(__typeof__(a2)))) { \ |
| [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"Type mismatch -- %@", 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]; \ |
| [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) %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) |
| |
| #endif // GTM_USING_XCTEST |
| #if GTM_IPHONE_SDK && !GTM_USING_XCTEST |
| // When not using the Xcode provided version, define everything ourselves. |
| |
| // 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 ((strcmp(@encode(__typeof__(_a1value)), @encode(id)) == 0) && \ |
| (strcmp(@encode(__typeof__(_a2value)), @encode(id)) == 0) && \ |
| [(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 (strcmp(@encode(__typeof__(a1)), @encode(__typeof__(a2)))) { \ |
| [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"Type mismatch -- %@", 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 (strcmp(@encode(__typeof__(a1)), @encode(__typeof__(a2)))) { \ |
| [self failWithException:[NSException failureInFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"Type mismatch -- %@", 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])); \ |
| _descrip = [_descrip stringByAppendingFormat:description, ##__VA_ARGS__]; \ |
| [self failWithException:[NSException failureInRaise:[NSString stringWithUTF8String:#expr] \ |
| exception:anException \ |
| inFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"%@", _descrip]]; \ |
| continue; \ |
| } \ |
| NSString *_descrip = STComposeString( \ |
| @"(Expected exception: %@) ", \ |
| NSStringFromClass([specificException class])); \ |
| _descrip = [_descrip stringByAppendingFormat:description, ##__VA_ARGS__]; \ |
| [self failWithException:[NSException failureInRaise:[NSString stringWithUTF8String:#expr] \ |
| exception:nil \ |
| inFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"%@", _descrip]]; \ |
| } 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); \ |
| _descrip = [_descrip stringByAppendingFormat:description, ##__VA_ARGS__]; \ |
| [self failWithException: \ |
| [NSException failureInRaise:[NSString stringWithUTF8String:#expr] \ |
| exception:anException \ |
| inFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"%@", _descrip]]; \ |
| continue; \ |
| } \ |
| @catch (id anException) { \ |
| NSString *_descrip = STComposeString( \ |
| @"(Expected exception: %@ (name: %@)) ", \ |
| NSStringFromClass([specificException class]), aName); \ |
| _descrip = [_descrip stringByAppendingFormat:description, ##__VA_ARGS__]; \ |
| [self failWithException: \ |
| [NSException failureInRaise:[NSString stringWithUTF8String:#expr] \ |
| exception:anException \ |
| inFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"%@", _descrip]]; \ |
| continue; \ |
| } \ |
| NSString *_descrip = STComposeString( \ |
| @"(Expected exception: %@ (name: %@)) ", \ |
| NSStringFromClass([specificException class]), aName); \ |
| _descrip = [_descrip stringByAppendingFormat:description, ##__VA_ARGS__]; \ |
| [self failWithException: \ |
| [NSException failureInRaise:[NSString stringWithUTF8String:#expr] \ |
| exception:nil \ |
| inFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"%@", _descrip]]; \ |
| } 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); \ |
| _descrip = [_descrip stringByAppendingFormat:description, ##__VA_ARGS__]; \ |
| [self failWithException: \ |
| [NSException failureInRaise:[NSString stringWithUTF8String:#expr] \ |
| exception:anException \ |
| inFile:[NSString stringWithUTF8String:__FILE__] \ |
| atLine:__LINE__ \ |
| withDescription:@"%@", _descrip]]; \ |
| } \ |
| continue; \ |
| } \ |
| @catch (id anythingElse) { \ |
| ; \ |
| } \ |
| } while (0) |
| |
| |
| |
| @interface NSException (GTMSenTestAdditions) |
| + (NSException *)failureInFile:(NSString *)filename |
| atLine:(int)lineNumber |
| withDescription:(NSString *)formatString, ... NS_FORMAT_FUNCTION(3, 4); |
| + (NSException *)failureInCondition:(NSString *)condition |
| isTrue:(BOOL)isTrue |
| inFile:(NSString *)filename |
| atLine:(int)lineNumber |
| withDescription:(NSString *)formatString, ... NS_FORMAT_FUNCTION(5, 6); |
| + (NSException *)failureInEqualityBetweenObject:(id)left |
| andObject:(id)right |
| inFile:(NSString *)filename |
| atLine:(int)lineNumber |
| withDescription:(NSString *)formatString, ... NS_FORMAT_FUNCTION(5, 6); |
| + (NSException *)failureInEqualityBetweenValue:(NSValue *)left |
| andValue:(NSValue *)right |
| withAccuracy:(NSValue *)accuracy |
| inFile:(NSString *)filename |
| atLine:(int) ineNumber |
| withDescription:(NSString *)formatString, ... NS_FORMAT_FUNCTION(6, 7); |
| + (NSException *)failureInRaise:(NSString *)expression |
| inFile:(NSString *)filename |
| atLine:(int)lineNumber |
| withDescription:(NSString *)formatString, ... NS_FORMAT_FUNCTION(4, 5); |
| + (NSException *)failureInRaise:(NSString *)expression |
| exception:(NSException *)exception |
| inFile:(NSString *)filename |
| atLine:(int)lineNumber |
| withDescription:(NSString *)formatString, ... NS_FORMAT_FUNCTION(5, 6); |
| @end |
| |
| // SENTE_END |
| |
| @protocol SenTestCase |
| + (id)testCaseWithInvocation:(NSInvocation *)anInvocation; |
| - (id)initWithInvocation:(NSInvocation *)anInvocation; |
| - (void)setUp; |
| - (void)invokeTest; |
| - (void)tearDown; |
| - (void)performTest; |
| - (void)failWithException:(NSException*)exception; |
| - (NSInvocation *)invocation; |
| - (SEL)selector; |
| + (NSArray *)testInvocations; |
| @end |
| |
| NS_CLASS_DEPRECATED(10_4, 10_8, 1_0, 7_0, "Please move to XCTest") |
| @interface SenTestCase : NSObject<SenTestCase> { |
| @private |
| NSInvocation *invocation_; |
| } |
| @end |
| |
| GTM_EXTERN NSString *const SenTestFailureException; |
| |
| GTM_EXTERN NSString *const SenTestFilenameKey; |
| GTM_EXTERN NSString *const SenTestLineNumberKey; |
| |
| #endif // GTM_IPHONE_SDK && !GTM_USING_XCTEST |
| |
| // All unittest cases in GTM should inherit from GTMTestCase. |
| #if GTM_USING_XCTEST |
| @interface GTMTestCase : XCTestCase |
| #else |
| NS_CLASS_DEPRECATED(10_4, 10_8, 1_0, 7_0, "Please move to XCTest version of GTMTestCase") |
| @interface GTMTestCase : SenTestCase |
| #endif |
| |
| // Returns YES if this is an abstract testCase class as opposed to a concrete |
| // testCase class that you want tests run against. SenTestCase is not designed |
| // out of the box to handle an abstract class hierarchy descending from it with |
| // some concrete subclasses. In some cases we want all the "concrete" |
| // subclasses of an abstract subclass of SenTestCase to run a test, but we don't |
| // want that test to be run against an instance of an abstract subclass itself. |
| // By returning "YES" here, the tests defined by this class won't be run against |
| // an instance of this class. As an example class hierarchy: |
| // |
| // FooExtensionTestCase |
| // GTMTestCase <- ExtensionAbstractTestCase < |
| // BarExtensionTestCase |
| // |
| // So FooExtensionTestCase and BarExtensionTestCase inherit from |
| // ExtensionAbstractTestCase (and probably FooExtension and BarExtension inherit |
| // from a class named Extension). We want the tests in ExtensionAbstractTestCase |
| // to be run as part of FooExtensionTestCase and BarExtensionTestCase, but we |
| // don't want them run against ExtensionAbstractTestCase. The default |
| // implementation checks to see if the name of the class contains the word |
| // "AbstractTest" (case sensitive). |
| + (BOOL)isAbstractTestCase; |
| |
| @end |
