@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBDebugLogDelegateDecorator.h

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <Foundation/Foundation.h>
+#import <WebDriverAgentLib/XCDebugLogDelegate-Protocol.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ XCTestLogger decorator that will print all debug information to console
+ */
+@interface FBDebugLogDelegateDecorator : NSObject <XCDebugLogDelegate>
+
+/**
+ Decorates XCTestLogger by also printing debug message to console
+ */
++ (void)decorateXCTestLogger;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBDebugLogDelegateDecorator.m

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBDebugLogDelegateDecorator.h"
+
+#import "FBLogger.h"
+#import "XCTestPrivateSymbols.h"
+
+@interface FBDebugLogDelegateDecorator ()
+@property (nonatomic, strong) id<XCDebugLogDelegate> debugLogger;
+@end
+
+@implementation FBDebugLogDelegateDecorator
+
++ (void)decorateXCTestLogger
+{
+  FBDebugLogDelegateDecorator *decorator = [FBDebugLogDelegateDecorator new];
+  id<XCDebugLogDelegate> debugLogger = XCDebugLogger();
+  if ([debugLogger isKindOfClass:FBDebugLogDelegateDecorator.class]) {
+    // Already decorated
+    return;
+  }
+  decorator.debugLogger = debugLogger;
+  XCSetDebugLogger(decorator);
+}
+
+- (void)logDebugMessage:(NSString *)logEntry
+{
+  NSString *debugLogEntry = logEntry;
+  static NSString *processName;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    processName = [NSProcessInfo processInfo].processName;
+  });
+  if ([logEntry rangeOfString:[NSString stringWithFormat:@" %@[", processName]].location != NSNotFound) {
+    // Ignoring "13:37:07.638 TestingApp[56374:10997466] " from log entry
+    NSUInteger ignoreCharCount = [logEntry rangeOfString:@"]"].location + 2;
+    debugLogEntry = [logEntry substringWithRange:NSMakeRange(ignoreCharCount, logEntry.length - ignoreCharCount)];
+  }
+  [FBLogger verboseLog:debugLogEntry];
+  [self.debugLogger logDebugMessage:logEntry];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBElementHelpers.h

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Checks if the element is a text field
+
+ @param elementType XCTest element type
+ @return YES if the element is a text field
+ */
+BOOL FBDoesElementSupportInnerText(XCUIElementType elementType);
+
+/**
+ Checks if the element supports min/max value attributes
+
+ @param elementType XCTest element type
+ @return YES if the element type supports min/max value attributes
+ */
+BOOL FBDoesElementSupportMinMaxValue(XCUIElementType elementType);
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBElementHelpers.m

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBElementHelpers.h"
+
+BOOL FBDoesElementSupportInnerText(XCUIElementType elementType) {
+  return elementType == XCUIElementTypeTextView
+    || elementType == XCUIElementTypeTextField
+    || elementType == XCUIElementTypeSearchField
+    || elementType == XCUIElementTypeSecureTextField;
+}
+
+BOOL FBDoesElementSupportMinMaxValue(XCUIElementType elementType) {
+  return elementType == XCUIElementTypeSlider
+      || elementType == XCUIElementTypeStepper;
+}

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBElementTypeTransformer.h

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <Foundation/Foundation.h>
+#import <XCTest/XCUIElementTypes.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Class used to translate between XCUIElementType and string name
+ */
+@interface FBElementTypeTransformer : NSObject
+
+/**
+ Converts string to XCUIElementType
+
+ @param typeName converted string to XCUIElementType
+ @return Proper XCUIElementType or XCUIElementTypeAny if typeName is nil or unrecognised
+ */
++ (XCUIElementType)elementTypeWithTypeName:(NSString *__nullable)typeName;
+
+/**
+ Converts XCUIElementType to string
+
+ @param type converted XCUIElementType to string
+ @return XCUIElementType as NSString
+ */
++ (NSString *)stringWithElementType:(XCUIElementType)type;
+
+/**
+ Converts XCUIElementType to short string by striping `XCUIElementType` from it
+
+ @param type converted XCUIElementType to string
+ @return XCUIElementType as NSString with stripped `XCUIElementType`
+ */
++ (NSString *)shortStringWithElementType:(XCUIElementType)type;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBElementTypeTransformer.m

@@ -0,0 +1,149 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBElementTypeTransformer.h"
+
+#import "FBExceptions.h"
+
+@implementation FBElementTypeTransformer
+
+static NSDictionary *ElementTypeToStringMapping;
+static NSDictionary *StringToElementTypeMapping;
+
+static NSString const *FB_ELEMENT_TYPE_PREFIX = @"XCUIElementType";
+
++ (void)createMapping
+{
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    ElementTypeToStringMapping =
+    @{
+      @0 : @"XCUIElementTypeAny",
+      @1 : @"XCUIElementTypeOther",
+      @2 : @"XCUIElementTypeApplication",
+      @3 : @"XCUIElementTypeGroup",
+      @4 : @"XCUIElementTypeWindow",
+      @5 : @"XCUIElementTypeSheet",
+      @6 : @"XCUIElementTypeDrawer",
+      @7 : @"XCUIElementTypeAlert",
+      @8 : @"XCUIElementTypeDialog",
+      @9 : @"XCUIElementTypeButton",
+      @10 : @"XCUIElementTypeRadioButton",
+      @11 : @"XCUIElementTypeRadioGroup",
+      @12 : @"XCUIElementTypeCheckBox",
+      @13 : @"XCUIElementTypeDisclosureTriangle",
+      @14 : @"XCUIElementTypePopUpButton",
+      @15 : @"XCUIElementTypeComboBox",
+      @16 : @"XCUIElementTypeMenuButton",
+      @17 : @"XCUIElementTypeToolbarButton",
+      @18 : @"XCUIElementTypePopover",
+      @19 : @"XCUIElementTypeKeyboard",
+      @20 : @"XCUIElementTypeKey",
+      @21 : @"XCUIElementTypeNavigationBar",
+      @22 : @"XCUIElementTypeTabBar",
+      @23 : @"XCUIElementTypeTabGroup",
+      @24 : @"XCUIElementTypeToolbar",
+      @25 : @"XCUIElementTypeStatusBar",
+      @26 : @"XCUIElementTypeTable",
+      @27 : @"XCUIElementTypeTableRow",
+      @28 : @"XCUIElementTypeTableColumn",
+      @29 : @"XCUIElementTypeOutline",
+      @30 : @"XCUIElementTypeOutlineRow",
+      @31 : @"XCUIElementTypeBrowser",
+      @32 : @"XCUIElementTypeCollectionView",
+      @33 : @"XCUIElementTypeSlider",
+      @34 : @"XCUIElementTypePageIndicator",
+      @35 : @"XCUIElementTypeProgressIndicator",
+      @36 : @"XCUIElementTypeActivityIndicator",
+      @37 : @"XCUIElementTypeSegmentedControl",
+      @38 : @"XCUIElementTypePicker",
+      @39 : @"XCUIElementTypePickerWheel",
+      @40 : @"XCUIElementTypeSwitch",
+      @41 : @"XCUIElementTypeToggle",
+      @42 : @"XCUIElementTypeLink",
+      @43 : @"XCUIElementTypeImage",
+      @44 : @"XCUIElementTypeIcon",
+      @45 : @"XCUIElementTypeSearchField",
+      @46 : @"XCUIElementTypeScrollView",
+      @47 : @"XCUIElementTypeScrollBar",
+      @48 : @"XCUIElementTypeStaticText",
+      @49 : @"XCUIElementTypeTextField",
+      @50 : @"XCUIElementTypeSecureTextField",
+      @51 : @"XCUIElementTypeDatePicker",
+      @52 : @"XCUIElementTypeTextView",
+      @53 : @"XCUIElementTypeMenu",
+      @54 : @"XCUIElementTypeMenuItem",
+      @55 : @"XCUIElementTypeMenuBar",
+      @56 : @"XCUIElementTypeMenuBarItem",
+      @57 : @"XCUIElementTypeMap",
+      @58 : @"XCUIElementTypeWebView",
+      @59 : @"XCUIElementTypeIncrementArrow",
+      @60 : @"XCUIElementTypeDecrementArrow",
+      @61 : @"XCUIElementTypeTimeline",
+      @62 : @"XCUIElementTypeRatingIndicator",
+      @63 : @"XCUIElementTypeValueIndicator",
+      @64 : @"XCUIElementTypeSplitGroup",
+      @65 : @"XCUIElementTypeSplitter",
+      @66 : @"XCUIElementTypeRelevanceIndicator",
+      @67 : @"XCUIElementTypeColorWell",
+      @68 : @"XCUIElementTypeHelpTag",
+      @69 : @"XCUIElementTypeMatte",
+      @70 : @"XCUIElementTypeDockItem",
+      @71 : @"XCUIElementTypeRuler",
+      @72 : @"XCUIElementTypeRulerMarker",
+      @73 : @"XCUIElementTypeGrid",
+      @74 : @"XCUIElementTypeLevelIndicator",
+      @75 : @"XCUIElementTypeCell",
+      @76 : @"XCUIElementTypeLayoutArea",
+      @77 : @"XCUIElementTypeLayoutItem",
+      @78 : @"XCUIElementTypeHandle",
+      @79 : @"XCUIElementTypeStepper",
+      @80 : @"XCUIElementTypeTab",
+      @81 : @"XCUIElementTypeTouchBar",
+      @82 : @"XCUIElementTypeStatusItem",
+      // !!! This mapping should be updated if there are changes after each new XCTest release
+      };
+    NSMutableDictionary *swappedMapping = [NSMutableDictionary dictionary];
+    [ElementTypeToStringMapping enumerateKeysAndObjectsUsingBlock:^(id key, id obj, BOOL *stop) {
+      swappedMapping[obj] = key;
+    }];
+    StringToElementTypeMapping = swappedMapping.copy;
+  });
+}
+
++ (XCUIElementType)elementTypeWithTypeName:(NSString *)typeName
+{
+  [self createMapping];
+  NSNumber *type = StringToElementTypeMapping[typeName];
+  if (nil == type) {
+    if ([typeName hasPrefix:(NSString *)FB_ELEMENT_TYPE_PREFIX] && typeName.length > FB_ELEMENT_TYPE_PREFIX.length) {
+      // Consider the element type is something new and has to be added into ElementTypeToStringMapping
+      return XCUIElementTypeOther;
+    }
+    NSString *reason = [NSString stringWithFormat:@"Invalid argument for class used '%@'. Did you mean %@%@?", typeName, FB_ELEMENT_TYPE_PREFIX, typeName];
+    @throw [NSException exceptionWithName:FBInvalidArgumentException reason:reason userInfo:@{}];
+  }
+  return (XCUIElementType) type.unsignedIntegerValue;
+}
+
++ (NSString *)stringWithElementType:(XCUIElementType)type
+{
+  [self createMapping];
+  NSString *typeName = ElementTypeToStringMapping[@(type)];
+  return nil == typeName
+    // Consider the type name is something new and has to be added into ElementTypeToStringMapping
+    ? [NSString stringWithFormat:@"%@Other", FB_ELEMENT_TYPE_PREFIX]
+    : typeName;
+}
+
++ (NSString *)shortStringWithElementType:(XCUIElementType)type
+{
+  return [[self stringWithElementType:type] stringByReplacingOccurrencesOfString:(NSString *)FB_ELEMENT_TYPE_PREFIX withString:@""];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBErrorBuilder.h

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Builder used create error raised by WebDriverAgent
+ */
+@interface FBErrorBuilder : NSObject
+
+/**
+ Default constructor
+ */
++ (instancetype)builder;
+
+/**
+ Configures description set as NSLocalizedDescriptionKey
+
+ @param description set as NSLocalizedDescriptionKey
+ @return builder instance
+ */
+- (instancetype)withDescription:(NSString *)description;
+
+/**
+ Configures description set as NSLocalizedDescriptionKey with convenient format
+
+ @param format of description set as NSLocalizedDescriptionKey
+ @return builder instance
+ */
+- (instancetype)withDescriptionFormat:(NSString *)format, ... NS_FORMAT_FUNCTION(1,2);
+
+/**
+ Configures error set as NSUnderlyingErrorKey
+
+ @param innerError used to set NSUnderlyingErrorKey
+ @return builder instance
+ */
+- (instancetype)withInnerError:(NSError *)innerError;
+
+/**
+ Builder used create error raised by WebDriverAgent
+
+ @return built error
+ */
+- (NSError *)build;
+
+/**
+ Builder used create error raised by WebDriverAgent
+
+ @param error pointer used to return built error
+ @return fixed NO to apply to Apple's coding conventions
+ */
+- (BOOL)buildError:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBErrorBuilder.m

@@ -0,0 +1,75 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBErrorBuilder.h"
+
+static NSString *const FBWebServerErrorDomain = @"com.facebook.WebDriverAgent";
+
+@interface FBErrorBuilder ()
+@property (nonatomic, copy) NSString *errorDescription;
+@property (nonatomic, strong) NSError *innerError;
+@end
+
+@implementation FBErrorBuilder
+
++ (instancetype)builder
+{
+  return [FBErrorBuilder new];
+}
+
+- (instancetype)withDescription:(NSString *)description
+{
+  self.errorDescription = description;
+  return self;
+}
+
+- (instancetype)withDescriptionFormat:(NSString *)format, ...
+{
+  va_list argList;
+  va_start(argList, format);
+  self.errorDescription = [[NSString alloc] initWithFormat:format arguments:argList];
+  va_end(argList);
+  return self;
+}
+
+- (instancetype)withInnerError:(NSError *)error
+{
+  self.innerError = error;
+  return self;
+}
+
+- (BOOL)buildError:(NSError **)errorOut
+{
+  if (errorOut) {
+    *errorOut = [self build];
+  }
+  return NO;
+}
+
+- (NSError *)build
+{
+  return
+  [NSError errorWithDomain:FBWebServerErrorDomain
+                      code:1
+                  userInfo:[self buildUserInfo]
+   ];
+}
+
+- (NSDictionary *)buildUserInfo
+{
+  NSMutableDictionary *userInfo = [NSMutableDictionary dictionary];
+  if (self.errorDescription) {
+    userInfo[NSLocalizedDescriptionKey] = self.errorDescription;
+  }
+  if (self.innerError) {
+    userInfo[NSUnderlyingErrorKey] = self.innerError;
+  }
+  return userInfo.copy;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBFailureProofTestCase.h

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <WebDriverAgentLib/XCTestCase.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Test Case that will never fail or stop from running in case of failure
+ */
+@interface FBFailureProofTestCase : XCTestCase
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBFailureProofTestCase.m

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBFailureProofTestCase.h"
+
+#import "FBLogger.h"
+
+@implementation FBFailureProofTestCase
+
+- (void)setUp
+{
+  [super setUp];
+  self.continueAfterFailure = YES;
+  // https://github.com/appium/appium/issues/13949
+  self.shouldSetShouldHaltWhenReceivesControl = NO;
+  self.shouldHaltWhenReceivesControl = NO;
+}
+
+- (void)_recordIssue:(XCTIssue *)issue
+{
+  NSString *description = [NSString stringWithFormat:@"%@ (%@)", issue.compactDescription, issue.associatedError.description];
+  [FBLogger logFmt:@"Issue type: %ld", issue.type];
+  [self _enqueueFailureWithDescription:description
+                                inFile:issue.sourceCodeContext.location.fileURL.path
+                                atLine:issue.sourceCodeContext.location.lineNumber
+                              // 5 == XCTIssueTypeUnmatchedExpectedFailure
+                              expected:issue.type == 5];
+}
+
+- (void)_recordIssue:(XCTIssue *)issue forCaughtError:(id)error
+{
+  [self _recordIssue:issue];
+}
+
+- (void)recordIssue:(XCTIssue *)issue
+{
+  [self _recordIssue:issue];
+}
+
+/**
+ Override 'recordFailureWithDescription' to not stop by failures.
+ */
+- (void)recordFailureWithDescription:(NSString *)description
+                              inFile:(NSString *)filePath
+                              atLine:(NSUInteger)lineNumber
+                            expected:(BOOL)expected
+{
+  [self _enqueueFailureWithDescription:description inFile:filePath atLine:lineNumber expected:expected];
+}
+
+/**
+ Private XCTestCase method used to block and tunnel failure messages
+ */
+- (void)_enqueueFailureWithDescription:(NSString *)description
+                                inFile:(NSString *)filePath
+                                atLine:(NSUInteger)lineNumber
+                              expected:(BOOL)expected
+{
+  [FBLogger logFmt:@"Enqueue Failure: %@ %@ %lu %d", description, filePath, (unsigned long)lineNumber, expected];
+  // TODO: Figure out which error types we want to escalate
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBImageProcessor.h

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <Foundation/Foundation.h>
+#import <CoreGraphics/CoreGraphics.h>
+
+@class UTType;
+
+NS_ASSUME_NONNULL_BEGIN
+
+// Those values define the allowed ranges for the scaling factor and compression quality settings
+extern const CGFloat FBMinScalingFactor;
+extern const CGFloat FBMaxScalingFactor;
+extern const CGFloat FBMinCompressionQuality;
+extern const CGFloat FBMaxCompressionQuality;
+
+@interface FBImageProcessor : NSObject
+
+/**
+ Puts the passed image on the queue and dispatches a scaling operation. If there is already a image on the
+ queue it will be replaced with the new one
+
+ @param image The image to scale down
+ @param completionHandler called after successfully scaling down an image
+ @param scalingFactor the scaling factor in range 0.01..1.0. A value of 1.0 won't perform scaling at all
+ */
+- (void)submitImageData:(NSData *)image
+          scalingFactor:(CGFloat)scalingFactor
+      completionHandler:(void (^)(NSData *))completionHandler;
+
+/**
+ Scales and crops the source image
+
+ @param image The source image data
+ @param uti Either UTTypePNG or UTTypeJPEG
+ @param scalingFactor Scaling factor in range 0.01..1.0. A value of 1.0 won't perform scaling at all
+ @param compressionQuality the compression quality in range 0.0..1.0 (0.0 for max. compression and 1.0 for lossless compression).
+ Only works if UTI is set to kUTTypeJPEG
+ @param error The actual error instance if the returned result is nil
+ @returns Processed image data compressed according to the given UTI or nil in case of a failure
+ */
+- (nullable NSData *)scaledImageWithData:(NSData *)image
+                                     uti:(UTType *)uti
+                           scalingFactor:(CGFloat)scalingFactor
+                      compressionQuality:(CGFloat)compressionQuality
+                                   error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END