|
//
// GHTesting.h
// GHUnit
//
// Created by Gabriel Handford on 1/30/09.
// Copyright 2008 Gabriel Handford
//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
// restriction, including without limitation the rights to use,
// copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
// OTHER DEALINGS IN THE SOFTWARE.
//
//! @cond DEV
//
// Portions of this file fall under the following license, marked with:
// GTM_BEGIN : GTM_END
//
// Copyright 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.
//
#ifdef __cplusplus
extern "C" NSString *GHUStackTraceFromException(NSException *e);
#else
extern NSString *GHUStackTraceFromException(NSException *e);
#endif
// GTM_BEGIN
BOOL isTestFixtureOfClass(Class aClass, Class testCaseClass);
// GTM_END
/*!
Utility test for loading and running tests.
@note Much of this is borrowed from GTM/UnitTesting.
*/
@interface GHTesting : NSObject {
NSMutableArray/* of NSString*/ *testCaseClassNames_;
}
/*!
The shared testing instance.
*/
+ (GHTesting *)sharedInstance;
/*!
Load all test classes that we can "see".
@result Array of initialized (and autoreleased) test case classes in an autoreleased array.
*/
- (NSArray *)loadAllTestCases;
/*!
Load tests from target.
@result Array of id<GHTest>
*/
- (NSArray *)loadTestsFromTarget:(id)target;
/*!
See if class is of a registered test case class.
*/
- (BOOL)isTestCaseClass:(Class)aClass;
/*!
Register test case class.
@param aClass
*/
- (void)registerClass:(Class)aClass;
/*!
Register test case class by name.
@param className Class name (via NSStringFromClass(aClass)
*/
- (void)registerClassName:(NSString *)className;
/*!
Format test exception.
@param exception
@result Description
*/
+ (NSString *)descriptionForException:(NSException *)exception;
/*!
Filename for cause of test exception.
@param test
@result Filename
*/
+ (NSString *)exceptionFilenameForTest:(id<GHTest>)test;
/*!
Line number for cause of test exception.
@param test
@result Line number
*/
+ (NSInteger)exceptionLineNumberForTest:(id<GHTest>)test;
/*!
Run test.
@param target
@param selector
@param exception Exception, if set, is retained and should be released by the caller.
@param interval Time to run the test
@param reraiseExceptions If YES, will re-raise exceptions
*/
+ (BOOL)runTestWithTarget:(id)target selector:(SEL)selector exception:(NSException **)exception
interval:(NSTimeInterval *)interval reraiseExceptions:(BOOL)reraiseExceptions;
/*!
Same as normal runTest without catching exceptions.
*/
+ (BOOL)runTestOrRaiseWithTarget:(id)target selector:(SEL)selector exception:(NSException **)exception interval:(NSTimeInterval *)interval;
@end
@protocol GHSenTestCase
- (void)raiseAfterFailure;
@end
//! @endcond
|
By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.
If a file you wish to view isn't highlighted, and is a text file (not binary), please
let us know and we'll add colourisation support for it.
Jozef Božek is currently a software engineer at bring-it-together s.r.o. in area of large scale infomation systems and mobile applications development.
He has been developing in C++ nearly full time since 2000, in Java since 2004 and in Objective-C since 2009. He is programming using Java EE SDK, iOS SDK, COM/DCOM, MFC, ATL, STL and so on