@devicelab/maestro-runner-darwin-arm64 1.1.27 → 1.1.29

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCTest.framework/Headers/XCTNSNotificationExpectation.h

@@ -0,0 +1,92 @@
+#if __has_include(<XCTestCore/XCTNSNotificationExpectation.h>)
+#import <XCTestCore/XCTNSNotificationExpectation.h>
+#else
+
+//
+//  Copyright (c) 2016 Apple Inc. All rights reserved.
+//
+
+#import <XCTest/XCTestExpectation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*!
+ * @typedef
+ * A block to be invoked when a notification matching the specified name is observed
+ * from the object.
+ *
+ * @param notification
+ * The notification object.
+ *
+ * @return
+ * Return YES if the expectation is fulfilled, NO if it is not.
+ */
+typedef BOOL (^XCT_SWIFT_SENDABLE XCNotificationExpectationHandler)(NSNotification *notification);
+
+/*!
+ * @class XCTNSNotificationExpectation
+ * Expectation subclass for waiting on a condition defined by an NSNotification.
+ */
+@interface XCTNSNotificationExpectation : XCTestExpectation
+
++ (instancetype)new NS_UNAVAILABLE;
+- (instancetype)init NS_UNAVAILABLE;
+- (instancetype)initWithDescription:(NSString *)expectationDescription NS_UNAVAILABLE;
+
+/*!
+ * @method -initWithName:object:notificationCenter:
+ *
+ * @discussion
+ * Initializes an expectation that waits for an NSNotification to be posted by an optional object from
+ * a given notification center.
+ */
+- (instancetype)initWithName:(NSNotificationName)notificationName object:(nullable id)object notificationCenter:(NSNotificationCenter *)notificationCenter NS_DESIGNATED_INITIALIZER;
+
+/*!
+ * @method -initWithName:object:
+ *
+ * @discussion
+ * Initializes an expectation that waits for an NSNotification to be posted by an optional object from
+ * the default notification center.
+ */
+- (instancetype)initWithName:(NSNotificationName)notificationName object:(nullable id)object;
+
+/*!
+ * @method -initWithName:object:
+ *
+ * @discussion
+ * Initializes an expectation that waits for an NSNotification to be posted by any object from
+ * the default notification center.
+ */
+- (instancetype)initWithName:(NSNotificationName)notificationName;
+
+/*!
+ * @property notificationName
+ * Returns the name of the notification being waited on.
+ */
+@property (readonly, copy) NSNotificationName notificationName;
+
+/*!
+ * @property observedObject
+ * Returns the object that will post the notification.
+ */
+@property (nullable, readonly, strong) id observedObject;
+
+/*!
+ * @property notificationCenter
+ * Returns the notification center that is being used.
+ */
+@property (readonly, strong) NSNotificationCenter *notificationCenter;
+
+/*!
+ * @property handler
+ * Allows the caller to install a special handler to do custom evaluation of received notifications
+ * matching the specified object and notification center.
+ */
+@property (nullable, copy) XCNotificationExpectationHandler handler;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCTest.framework/Headers/XCTNSPredicateExpectation.h

@@ -0,0 +1,74 @@
+#if __has_include(<XCTestCore/XCTNSPredicateExpectation.h>)
+#import <XCTestCore/XCTNSPredicateExpectation.h>
+#else
+
+//
+//  Copyright (c) 2016 Apple Inc. All rights reserved.
+//
+
+#import <XCTest/XCTestExpectation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*!
+ * @typedef
+ * Handler called when evaluating the predicate against the object returns true. If the handler is not
+ * provided the first successful evaluation will fulfill the expectation. If provided, the handler will
+ * be queried each time the notification is received to determine whether the expectation should be fulfilled
+ * or not.
+ */
+typedef BOOL (^ XCT_SWIFT_SENDABLE XCPredicateExpectationHandler)(void);
+
+/*!
+ * @class XCTNSPredicateExpectation
+ * Expectation subclass for waiting on a condition defined by an NSPredicate and an object.
+ *
+ * When an instance of this class is used from Swift and is awaited using @c fulfillment(of:) rather than
+ * @c wait(for:), XCTest evaluates the associated predicate on the main actor.
+ */
+@interface XCTNSPredicateExpectation : XCTestExpectation
+
++ (instancetype)new NS_UNAVAILABLE;
+- (instancetype)init NS_UNAVAILABLE;
+- (instancetype)initWithDescription:(NSString *)expectationDescription NS_UNAVAILABLE;
+
+/*!
+ * @method -initWithPredicate:object:
+ * Initializes an expectation that waits for a predicate to evaluate as true with the provided object.
+ *
+ * When an instance of this class is used from Swift and is awaited using @c fulfillment(of:) rather than
+ * @c wait(for:), XCTest evaluates @a predicate on the main actor.
+ */
+- (instancetype)initWithPredicate:(NSPredicate *)predicate object:(nullable id)object NS_DESIGNATED_INITIALIZER;
+
+/*!
+ * @property predicate
+ * Returns the predicate used by the expectation.
+ */
+@property (readonly, copy) NSPredicate *predicate;
+
+/*!
+ * @property object
+ * Returns the object against which the predicate is evaluated.
+ */
+@property (nullable, readonly, strong) id object;
+
+/*!
+ * @property handler
+ * Allows the caller to install a special handler to do custom evaluation of predicate and its object.
+ */
+@property (nullable, copy) XCPredicateExpectationHandler handler;
+
+/*!
+ * @property expectedFulfillmentCount
+ * Unavailable on this class; XCTNSPredicateExpectation repeatedly evaluates its predicate until it becomes
+ * true. Once the predicate has become true, it is expected to remain true and will not be evaluated again.
+ * Setting expectedFulfillmentCount has no impact on fulfillment of the expectation.
+ */
+@property (nonatomic) NSUInteger expectedFulfillmentCount NS_UNAVAILABLE;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCTest.framework/Headers/XCTSourceCodeContext.h

@@ -0,0 +1,109 @@
+#if __has_include(<XCTestCore/XCTSourceCodeContext.h>)
+#import <XCTestCore/XCTSourceCodeContext.h>
+#else
+
+//
+//  Copyright © 2019 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*!
+ * @class XCTSourceCodeLocation
+ * Contains a file URL and line number representing a distinct location in source code related to a run of a test.
+ */
+__attribute__((objc_subclassing_restricted))
+@interface XCTSourceCodeLocation : NSObject <NSSecureCoding>
+
+- (instancetype)initWithFileURL:(NSURL *)fileURL lineNumber:(NSInteger)lineNumber NS_DESIGNATED_INITIALIZER;
+- (instancetype)initWithFilePath:(NSString *)filePath lineNumber:(NSInteger)lineNumber;
+
+- (instancetype)init NS_UNAVAILABLE;
++ (instancetype)new NS_UNAVAILABLE;
+
+@property (readonly) NSURL *fileURL;
+@property (readonly) NSInteger lineNumber;
+
+@end
+
+/*!
+ * @class XCTSourceCodeSymbolInfo
+ * Contains symbolication information for a given frame in a call stack.
+ */
+__attribute__((objc_subclassing_restricted))
+@interface XCTSourceCodeSymbolInfo : NSObject <NSSecureCoding>
+
+- (instancetype)initWithImageName:(NSString *)imageName
+                       symbolName:(NSString *)symbolName
+                         location:(nullable XCTSourceCodeLocation *)location NS_DESIGNATED_INITIALIZER;
+
+- (instancetype)init NS_UNAVAILABLE;
++ (instancetype)new NS_UNAVAILABLE;
+
+@property (readonly, copy) NSString *imageName;
+@property (readonly, copy) NSString *symbolName;
+@property (readonly, nullable) XCTSourceCodeLocation *location;
+
+@end
+
+/*!
+* @class XCTSourceCodeFrame
+* Represents a single frame in a call stack and supports retrieval of symbol information for the address.
+*/
+__attribute__((objc_subclassing_restricted))
+@interface XCTSourceCodeFrame : NSObject <NSSecureCoding>
+
+- (instancetype)initWithAddress:(uint64_t)address symbolInfo:(nullable XCTSourceCodeSymbolInfo *)symbolInfo NS_DESIGNATED_INITIALIZER;
+- (instancetype)initWithAddress:(uint64_t)address;
+
+- (instancetype)init NS_UNAVAILABLE;
++ (instancetype)new NS_UNAVAILABLE;
+
+@property (readonly) uint64_t address;
+
+@property (readonly, nullable) XCTSourceCodeSymbolInfo *symbolInfo;
+
+/// Error previously returned for symbolication attempt. This is not serialized when the frame is encoded.
+@property (readonly, nullable) NSError *symbolicationError;
+
+/*!
+ * method -symbolInfoWithError:
+ * Attempts to get symbol information for the address. This can fail if required symbol data is not available. Only
+ * one attempt will be made and the error will be stored and returned for future requests.
+ */
+- (nullable XCTSourceCodeSymbolInfo *)symbolInfoWithError:(NSError **)outError;
+
+@end
+
+/*!
+ * @class XCTSourceCodeContext
+ * Call stack and optional specific location - which may or may not be also included in the call stack
+ * providing context around a point of execution in a test.
+ */
+__attribute__((objc_subclassing_restricted))
+@interface XCTSourceCodeContext : NSObject <NSSecureCoding>
+
+- (instancetype)initWithCallStack:(NSArray<XCTSourceCodeFrame *> *)callStack
+                         location:(nullable XCTSourceCodeLocation *)location NS_DESIGNATED_INITIALIZER;
+
+/// The call stack addresses could be those from NSThread.callStackReturnAddresses,
+/// NSException.callStackReturnAddresses, or another source.
+- (instancetype)initWithCallStackAddresses:(NSArray<NSNumber *> *)callStackAddresses
+                                  location:(nullable XCTSourceCodeLocation *)location;
+
+/// Initializes a new instance with call stack derived from NSThread.callStackReturnAddresses and the specified location.
+- (instancetype)initWithLocation:(nullable XCTSourceCodeLocation *)location;
+
+/// Initializes a new instance with call stack derived from NSThread.callStackReturnAddresses and a nil location.
+- (instancetype)init;
+
+@property (readonly, copy) NSArray<XCTSourceCodeFrame *> *callStack;
+@property (readonly, nullable) XCTSourceCodeLocation *location;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCTest.framework/Headers/XCTWaiter.h

@@ -0,0 +1,304 @@
+#if __has_include(<XCTestCore/XCTWaiter.h>)
+#import <XCTestCore/XCTWaiter.h>
+#else
+
+//
+//  Copyright (c) 2016 Apple Inc. All rights reserved.
+//
+
+#import <XCTest/XCTestDefines.h>
+
+@class XCTestExpectation;
+@protocol XCTWaiterDelegate;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*!
+ * @enum XCTWaiterResult
+ * Values returned by a waiter when it completes, times out, or is interrupted due to another waiter
+ * higher in the call stack timing out.
+ */
+typedef NS_ENUM(NSInteger, XCTWaiterResult) {
+    XCTWaiterResultCompleted = 1,
+    XCTWaiterResultTimedOut,
+    XCTWaiterResultIncorrectOrder,
+    XCTWaiterResultInvertedFulfillment,
+    XCTWaiterResultInterrupted
+};
+
+/*!
+ * @class XCTWaiter
+ * Manages waiting - pausing the current execution context - for an array of XCTestExpectations. Waiters
+ * can be used with or without a delegate to respond to events such as completion, timeout, or invalid 
+ * expectation fulfillment. XCTestCase conforms to the delegate protocol and will automatically report
+ * timeouts and other unexpected events as test failures.
+ *
+ * Waiters can be used without a delegate or any association with a test case instance. This allows test
+ * support libraries to provide convenience methods for waiting without having to pass test cases through
+ * those APIs.
+ */
+NS_SWIFT_SENDABLE
+@interface XCTWaiter : NSObject
+
+/*!
+ * @method -initWithDelegate:
+ * Creates a new waiter with the specified delegate.
+ */
+- (instancetype)initWithDelegate:(nullable id<XCTWaiterDelegate>)delegate NS_DESIGNATED_INITIALIZER;
+
+/*!
+ * @property delegate
+ * The waiter delegate will be called with various events described in <XCTWaiterDelegate>.
+ */
+@property (nullable, weak) id<XCTWaiterDelegate> delegate;
+
+/*!
+ * @property fulfilledExpectations
+ * Returns an array containing the expectations that were fulfilled, in that order, up until the waiter
+ * stopped waiting. Expectations fulfilled after the waiter stopped waiting will not be in the array.
+ * The array will be empty until the waiter has started waiting, even if expectations have already been
+ * fulfilled. If a waiter is used to wait multiple times, this array will contain all of the
+ * fulfilled expectations from each wait operation.
+ */
+@property (readonly) NSArray<XCTestExpectation *> *fulfilledExpectations;
+
+/*!
+ * @method -waitForExpectations:
+ *
+ * Waits on a group of expectations indefinitely.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @discussion
+ * The test will continue to run until @a expectations are fulfilled or the
+ * test reaches its execution time allowance.
+ *
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * Enabling test timeouts is recommended when using this method to prevent a
+ * runaway expectation from hanging the test.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
+- (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method -waitForExpectations:timeout:
+ *
+ * Waits on a group of expectations for up to the specified timeout.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @param seconds
+ * The number of seconds within which all expectations must be fulfilled.
+ *
+ * @discussion
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
+- (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations timeout:(NSTimeInterval)seconds XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method -waitForExpectations:enforceOrder:
+ *
+ * Waits on a group of expectations indefinitely, optionally enforcing their
+ * order of fulfillment.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @param enforceOrderOfFulfillment
+ * If @c YES, the expectations specified by the @a expectations parameter must
+ * be satisfied in the order they appear in the array.
+ *
+ * @discussion
+ * The test will continue to run until @a expectations are fulfilled or the
+ * test reaches its execution time allowance.
+ *
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * Enabling test timeouts is recommended when using this method to prevent a
+ * runaway expectation from hanging the test.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
+- (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations enforceOrder:(BOOL)enforceOrderOfFulfillment XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method -waitForExpectations:timeout:enforceOrder:
+ *
+ * Waits on a group of expectations for up to the specified timeout, optionally
+ * enforcing their order of fulfillment.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @param seconds
+ * The number of seconds within which all expectations must be fulfilled.
+ *
+ * @param enforceOrderOfFulfillment
+ * If @c YES, the expectations specified by the @a expectations parameter must
+ * be satisfied in the order they appear in the array.
+ *
+ * @discussion
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
+- (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations timeout:(NSTimeInterval)seconds enforceOrder:(BOOL)enforceOrderOfFulfillment XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method +waitForExpectations:
+ *
+ * Creates a waiter that waits on a group of expectations indefinitely.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @discussion
+ * The test will continue to run until @a expectations are fulfilled or the
+ * test reaches its execution time allowance.
+ *
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * Enabling test timeouts is recommended when using this method to prevent a
+ * runaway expectation from hanging the test.
+ *
+ * The waiter is discarded when the wait completes.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
++ (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations XCT_WARN_UNUSED XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method +waitForExpectations:timeout:
+ *
+ * Creates a waiter that waits on a group of expectations for up to the
+ * specified timeout.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @param seconds
+ * The number of seconds within which all expectations must be fulfilled.
+ *
+ * @discussion
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * The waiter is discarded when the wait completes.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
++ (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations timeout:(NSTimeInterval)seconds XCT_WARN_UNUSED XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method +waitForExpectations:enforceOrder:
+ *
+ * Creates a waiter that waits on a group of expectations indefinitely,
+ * optionally enforcing their order of fulfillment.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @param enforceOrderOfFulfillment
+ * If @c YES, the expectations specified by the @a expectations parameter must
+ * be satisfied in the order they appear in the array.
+ *
+ * @discussion
+ * The test will continue to run until @a expectations are fulfilled or the
+ * test reaches its execution time allowance.
+ *
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * Enabling test timeouts is recommended when using this method to prevent a
+ * runaway expectation from hanging the test.
+ *
+ * The waiter is discarded when the wait completes.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
++ (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations enforceOrder:(BOOL)enforceOrderOfFulfillment XCT_WARN_UNUSED XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+/*!
+ * @method +waitForExpectations:timeout:enforceOrder:
+ *
+ * Creates a waiter that waits on a group of expectations for up to the
+ * specified timeout, optionally enforcing their order of fulfillment.
+ *
+ * @param expectations
+ * An array of expectations that must be fulfilled.
+ *
+ * @param seconds
+ * The number of seconds within which all expectations must be fulfilled.
+ *
+ * @param enforceOrderOfFulfillment
+ * If @c YES, the expectations specified by the @a expectations parameter must
+ * be satisfied in the order they appear in the array.
+ *
+ * @discussion
+ * Expectations can only appear in the list once. This method may return
+ * early based on fulfillment of the provided expectations.
+ *
+ * The waiter is discarded when the wait completes.
+ *
+ * @returns A value describing the outcome of waiting for @a expectations.
+ */
++ (XCTWaiterResult)waitForExpectations:(NSArray<XCTestExpectation *> *)expectations timeout:(NSTimeInterval)seconds enforceOrder:(BOOL)enforceOrderOfFulfillment XCT_WARN_UNUSED XCT_SWIFT_UNAVAILABLE_FROM_ASYNC("Use await fulfillment(of:timeout:enforceOrder:) instead");
+
+@end
+
+/*!
+ * @protocol XCTWaiterDelegate
+ * Events are reported to the waiter's delegate via these methods. XCTestCase conforms to the delegate
+ * protocol and will automatically report timeouts and other unexpected events as test failures.
+ *
+ * @note These methods are invoked on an arbitrary queue.
+ */
+@protocol XCTWaiterDelegate <NSObject>
+@optional
+/*!
+ * @method -waiter:didTimeoutWithUnfulfilledExpectations:
+ * Invoked when not all waited on expectations are fulfilled during the timeout period. If the delegate
+ * is an XCTestCase instance, this will be reported as a test failure.
+ */
+- (void)waiter:(XCTWaiter *)waiter didTimeoutWithUnfulfilledExpectations:(NSArray<XCTestExpectation *> *)unfulfilledExpectations;
+
+/*!
+ * @method -waiter:fulfillmentDidViolateOrderingConstraintsForExpectation:requiredExpectation:
+ * Invoked when the -wait call has specified that fulfillment order should be enforced and an expectation
+ * has been fulfilled in the wrong order. If the delegate is an XCTestCase instance, this will be reported
+ * as a test failure.
+ */
+- (void)waiter:(XCTWaiter *)waiter fulfillmentDidViolateOrderingConstraintsForExpectation:(XCTestExpectation *)expectation requiredExpectation:(XCTestExpectation *)requiredExpectation;
+
+/*!
+ * @method -waiter:didFulfillInvertedExpectation:
+ * Invoked when an expectation marked as inverted (/see inverted) is fulfilled. If the delegate is an
+ * XCTestCase instance, this will be reported as a test failure.
+ */
+- (void)waiter:(XCTWaiter *)waiter didFulfillInvertedExpectation:(XCTestExpectation *)expectation;
+
+/*!
+ * @method -nestedWaiter:wasInterruptedByTimedOutWaiter:
+ * Invoked when the waiter is interrupted prior to its expectations being fulfilled or timing out.
+ * This occurs when an "outer" waiter times out, resulting in any waiters nested inside it being
+ * interrupted to allow the call stack to quickly unwind.
+ */
+- (void)nestedWaiter:(XCTWaiter *)waiter wasInterruptedByTimedOutWaiter:(XCTWaiter *)outerWaiter;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+
+#endif