mirror of
https://github.com/samsonjs/Marshmallows.git
synced 2026-03-25 09:05:52 +00:00
151 lines
4.1 KiB
Objective-C
151 lines
4.1 KiB
Objective-C
//
|
|
// 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.
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
#import "GHUnit.h"
|
|
|
|
#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
|