/**
 *    Copyright (c) 2024 Project CHIP Authors
 *
 *    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 <XCTest/XCTest.h>

#if TARGET_OS_IPHONE || TARGET_OS_SIMULATOR
#define HAVE_NSTASK 0
#else
#define HAVE_NSTASK 1
#endif

NS_ASSUME_NONNULL_BEGIN

@interface MTRTestCase : XCTestCase
// It would be nice to do the leak-detection automatically, but running "leaks"
// on every single sub-test is slow, and some of our tests seem to have leaks
// outside Matter.framework.  So have it be opt-in for now, and improve later.
@property (nonatomic) BOOL detectLeaks;

#if HAVE_NSTASK
/**
 * Create an NSTask for the given path.  Path should be relative to the Matter
 * SDK root.
 */
- (NSTask *)createTaskForPath:(NSString *)path;

/**
 * Same thing, but not tied to a specific testcase instance.
 */
+ (NSTask *)createTaskForPath:(NSString *)path;

/**
 * Run a task to completion and make sure it succeeds.
 */
- (void)runTask:(NSTask *)task;

/**
 * Launch a task.  The task will be automatically terminated when the testcase
 * tearDown happens.
 */
- (void)launchTask:(NSTask *)task;

/**
 * Launch a cross-test task.  The task will be automatically terminated when the testsuite
 * tearDown happens.
 */
+ (void)launchTask:(NSTask *)task;
#endif // HAVE_NSTASK

/**
 * Get an absolute path from a path relative to the Matter SDK root.
 */
- (NSString *)absolutePathFor:(NSString *)matterRootRelativePath;

/**
 * Same thing, but not tied to a specific testcase instance.
 */
+ (NSString *)absolutePathFor:(NSString *)matterRootRelativePath;

@end

NS_ASSUME_NONNULL_END