@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/HTTPServer.h

@@ -0,0 +1,126 @@
+#import <Foundation/Foundation.h>
+
+@class GCDAsyncSocket;
+@class WebSocket;
+
+#if TARGET_OS_IPHONE
+#define IMPLEMENTED_PROTOCOLS
+#else
+#define IMPLEMENTED_PROTOCOLS
+#endif
+
+
+@interface HTTPServer : NSObject IMPLEMENTED_PROTOCOLS
+{
+  // Underlying asynchronous TCP/IP socket
+  GCDAsyncSocket *asyncSocket;
+  
+  // Dispatch queues
+  dispatch_queue_t serverQueue;
+  dispatch_queue_t connectionQueue;
+  void *IsOnServerQueueKey;
+  void *IsOnConnectionQueueKey;
+  
+  // HTTP server configuration
+  NSString *documentRoot;
+  Class connectionClass;
+  NSString *interface;
+  UInt16 port;
+
+  // Connection management
+  NSMutableArray *connections;
+  NSLock *connectionsLock;
+  
+  BOOL isRunning;
+}
+
+/**
+ * Specifies the document root to serve files from.
+ * For example, if you set this to "/Users/<your_username>/Sites",
+ * then it will serve files out of the local Sites directory (including subdirectories).
+ * 
+ * The default value is nil.
+ * The default server configuration will not serve any files until this is set.
+ * 
+ * If you change the documentRoot while the server is running,
+ * the change will affect future incoming http connections.
+ **/
+- (NSString *)documentRoot;
+- (void)setDocumentRoot:(NSString *)value;
+
+/**
+ * The connection class is the class used to handle incoming HTTP connections.
+ * 
+ * The default value is [HTTPConnection class].
+ * You can override HTTPConnection, and then set this to [MyHTTPConnection class].
+ * 
+ * If you change the connectionClass while the server is running,
+ * the change will affect future incoming http connections.
+ **/
+- (Class)connectionClass;
+- (void)setConnectionClass:(Class)value;
+
+/**
+ * Set what interface you'd like the server to listen on.
+ * By default this is nil, which causes the server to listen on all available interfaces like en1, wifi etc.
+ * 
+ * The interface may be specified by name (e.g. "en1" or "lo0") or by IP address (e.g. "192.168.4.34").
+ * You may also use the special strings "localhost" or "loopback" to specify that
+ * the socket only accept connections from the local machine.
+ **/
+- (NSString *)interface;
+- (void)setInterface:(NSString *)value;
+
+/**
+ * The port number to run the HTTP server on.
+ * 
+ * The default port number is zero, meaning the server will automatically use any available port.
+ * This is the recommended port value, as it avoids possible port conflicts with other applications.
+ * Technologies such as Bonjour can be used to allow other applications to automatically discover the port number.
+ * 
+ * Note: As is common on most OS's, you need root privledges to bind to port numbers below 1024.
+ * 
+ * You can change the port property while the server is running, but it won't affect the running server.
+ * To actually change the port the server is listening for connections on you'll need to restart the server.
+ * 
+ * The listeningPort method will always return the port number the running server is listening for connections on.
+ * If the server is not running this method returns 0.
+ **/
+- (UInt16)port;
+- (UInt16)listeningPort;
+- (void)setPort:(UInt16)value;
+
+/**
+ * Attempts to starts the server on the configured port, interface, etc.
+ * 
+ * If an error occurs, this method returns NO and sets the errPtr (if given).
+ * Otherwise returns YES on success.
+ * 
+ * Some examples of errors that might occur:
+ * - You specified the server listen on a port which is already in use by another application.
+ * - You specified the server listen on a port number below 1024, which requires root priviledges.
+ * 
+ * Code Example:
+ * 
+ * NSError *err = nil;
+ * if (![httpServer start:&err])
+ * {
+ *     NSLog(@"Error starting http server: %@", err);
+ * }
+ **/
+- (BOOL)start:(NSError **)errPtr;
+
+/**
+ * Stops the server, preventing it from accepting any new connections.
+ * You may specify whether or not you want to close the existing client connections.
+ * 
+ * The default stop method (with no arguments) will close any existing connections. (It invokes [self stop:NO])
+ **/
+- (void)stop;
+- (void)stop:(BOOL)keepExistingConnections;
+
+- (BOOL)isRunning;
+
+- (NSUInteger)numberOfHTTPConnections;
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/HTTPServer.m

@@ -0,0 +1,372 @@
+#import "HTTPServer.h"
+#import "HTTPConnection.h"
+#import "HTTPLogging.h"
+
+#import "GCDAsyncSocket.h"
+
+#if ! __has_feature(objc_arc)
+#warning This file must be compiled with ARC. Use -fobjc-arc flag (or convert project to ARC).
+#endif
+
+#pragma clang diagnostic ignored "-Wdirect-ivar-access"
+#pragma clang diagnostic ignored "-Wimplicit-retain-self"
+#pragma clang diagnostic ignored "-Wnullable-to-nonnull-conversion"
+#pragma clang diagnostic ignored "-Wunused"
+
+// Log levels: off, error, warn, info, verbose
+// Other flags: trace
+static const int httpLogLevel = HTTP_LOG_LEVEL_INFO; // | HTTP_LOG_FLAG_TRACE;
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark -
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+@implementation HTTPServer
+
+/**
+ * Standard Constructor.
+ * Instantiates an HTTP server, but does not start it.
+ **/
+- (id)init
+{
+  if ((self = [super init]))
+  {
+    HTTPLogTrace();
+    
+    // Setup underlying dispatch queues
+    serverQueue = dispatch_queue_create("HTTPServer", NULL);
+    connectionQueue = dispatch_queue_create("HTTPConnection", NULL);
+    
+    IsOnServerQueueKey = &IsOnServerQueueKey;
+    IsOnConnectionQueueKey = &IsOnConnectionQueueKey;
+    
+    void *nonNullUnusedPointer = (__bridge void *)self; // Whatever, just not null
+    
+    dispatch_queue_set_specific(serverQueue, IsOnServerQueueKey, nonNullUnusedPointer, NULL);
+    dispatch_queue_set_specific(connectionQueue, IsOnConnectionQueueKey, nonNullUnusedPointer, NULL);
+    
+    // Initialize underlying GCD based tcp socket
+    asyncSocket = [[GCDAsyncSocket alloc] initWithDelegate:(id<GCDAsyncSocketDelegate>)self delegateQueue:serverQueue];
+
+    // Use default connection class of HTTPConnection
+    connectionClass = [HTTPConnection self];
+    
+    // By default bind on all available interfaces, en1, wifi etc
+    interface = nil;
+    
+    // Use a default port of 0
+    // This will allow the kernel to automatically pick an open port for us
+    port = 0;
+    
+    // Initialize arrays to hold all the HTTP connections
+    connections = [[NSMutableArray alloc] init];
+    
+    connectionsLock = [[NSLock alloc] init];
+    
+    // Register for notifications of closed connections
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(connectionDidDie:)
+                                                 name:HTTPConnectionDidDieNotification
+                                               object:nil];
+    
+    isRunning = NO;
+  }
+  return self;
+}
+
+/**
+ * Standard Deconstructor.
+ * Stops the server, and clients, and releases any resources connected with this instance.
+ **/
+- (void)dealloc
+{
+  HTTPLogTrace();
+  
+  // Remove notification observer
+  [[NSNotificationCenter defaultCenter] removeObserver:self];
+  
+  // Stop the server if it's running
+  [self stop];
+  
+  // Release all instance variables
+  
+#if !OS_OBJECT_USE_OBJC
+  dispatch_release(serverQueue);
+  dispatch_release(connectionQueue);
+#endif
+  
+  [asyncSocket setDelegate:nil delegateQueue:NULL];
+}
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark Server Configuration
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * The document root is filesystem root for the webserver.
+ * Thus requests for /index.html will be referencing the index.html file within the document root directory.
+ * All file requests are relative to this document root.
+ **/
+- (NSString *)documentRoot
+{
+  __block NSString *result;
+  
+  dispatch_sync(serverQueue, ^{
+    result = documentRoot;
+  });
+  
+  return result;
+}
+
+- (void)setDocumentRoot:(NSString *)value
+{
+  HTTPLogTrace();
+  
+  // Document root used to be of type NSURL.
+  // Add type checking for early warning to developers upgrading from older versions.
+  
+  if (value && ![value isKindOfClass:[NSString class]])
+  {
+    HTTPLogWarn(@"%@: %@ - Expecting NSString parameter, received %@ parameter",
+                THIS_FILE, THIS_METHOD, NSStringFromClass([value class]));
+    return;
+  }
+  
+  NSString *valueCopy = [value copy];
+  
+  dispatch_async(serverQueue, ^{
+    documentRoot = valueCopy;
+  });
+  
+}
+
+/**
+ * The connection class is the class that will be used to handle connections.
+ * That is, when a new connection is created, an instance of this class will be intialized.
+ * The default connection class is HTTPConnection.
+ * If you use a different connection class, it is assumed that the class extends HTTPConnection
+ **/
+- (Class)connectionClass
+{
+  __block Class result;
+  
+  dispatch_sync(serverQueue, ^{
+    result = connectionClass;
+  });
+  
+  return result;
+}
+
+- (void)setConnectionClass:(Class)value
+{
+  HTTPLogTrace();
+  
+  dispatch_async(serverQueue, ^{
+    connectionClass = value;
+  });
+}
+
+/**
+ * What interface to bind the listening socket to.
+ **/
+- (NSString *)interface
+{
+  __block NSString *result;
+  
+  dispatch_sync(serverQueue, ^{
+    result = interface;
+  });
+  
+  return result;
+}
+
+- (void)setInterface:(NSString *)value
+{
+  NSString *valueCopy = [value copy];
+  
+  dispatch_async(serverQueue, ^{
+    interface = valueCopy;
+  });
+  
+}
+
+/**
+ * The port to listen for connections on.
+ * By default this port is initially set to zero, which allows the kernel to pick an available port for us.
+ * After the HTTP server has started, the port being used may be obtained by this method.
+ **/
+- (UInt16)port
+{
+  __block UInt16 result;
+  
+  dispatch_sync(serverQueue, ^{
+    result = port;
+  });
+  
+  return result;
+}
+
+- (UInt16)listeningPort
+{
+  __block UInt16 result;
+  
+  dispatch_sync(serverQueue, ^{
+    if (isRunning)
+      result = [asyncSocket localPort];
+    else
+      result = 0;
+  });
+  
+  return result;
+}
+
+- (void)setPort:(UInt16)value
+{
+  HTTPLogTrace();
+  
+  dispatch_async(serverQueue, ^{
+    port = value;
+  });
+}
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark Server Control
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+- (BOOL)start:(NSError **)errPtr
+{
+  HTTPLogTrace();
+  
+  __block BOOL success = YES;
+  __block NSError *err = nil;
+  
+  dispatch_sync(serverQueue, ^{ @autoreleasepool {
+    
+    success = [asyncSocket acceptOnInterface:interface port:port error:&err];
+    if (success)
+    {
+      HTTPLogInfo(@"%@: Started HTTP server on port %hu", THIS_FILE, [asyncSocket localPort]);
+      
+      isRunning = YES;
+    }
+    else
+    {
+      HTTPLogError(@"%@: Failed to start HTTP Server: %@", THIS_FILE, err);
+    }
+  }});
+  
+  if (errPtr)
+    *errPtr = err;
+  
+  return success;
+}
+
+- (void)stop
+{
+  [self stop:NO];
+}
+
+- (void)stop:(BOOL)keepExistingConnections
+{
+  HTTPLogTrace();
+  
+  dispatch_sync(serverQueue, ^{ @autoreleasepool {
+    // Stop listening / accepting incoming connections
+    [asyncSocket disconnect];
+    isRunning = NO;
+    
+    if (!keepExistingConnections)
+    {
+      // Stop all HTTP connections the server owns
+      [connectionsLock lock];
+      for (HTTPConnection *connection in connections)
+      {
+        [connection stop];
+      }
+      [connections removeAllObjects];
+      [connectionsLock unlock];
+    }
+  }});
+}
+
+- (BOOL)isRunning
+{
+  __block BOOL result;
+  
+  dispatch_sync(serverQueue, ^{
+    result = isRunning;
+  });
+  
+  return result;
+}
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark Server Status
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Returns the number of http client connections that are currently connected to the server.
+ **/
+- (NSUInteger)numberOfHTTPConnections
+{
+  NSUInteger result = 0;
+  
+  [connectionsLock lock];
+  result = [connections count];
+  [connectionsLock unlock];
+  
+  return result;
+}
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark Incoming Connections
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+- (HTTPConfig *)config
+{
+  // Override me if you want to provide a custom config to the new connection.
+  // 
+  // Generally this involves overriding the HTTPConfig class to include any custom settings,
+  // and then having this method return an instance of 'MyHTTPConfig'.
+  
+  // Note: Think you can make the server faster by putting each connection on its own queue?
+  // Then benchmark it before and after and discover for yourself the shocking truth!
+  // 
+  // Try the apache benchmark tool (already installed on your Mac):
+  // $  ab -n 1000 -c 1 http://localhost:<port>/some_path.html
+  
+  return [[HTTPConfig alloc] initWithServer:self documentRoot:documentRoot queue:connectionQueue];
+}
+
+- (void)socket:(GCDAsyncSocket *)sock didAcceptNewSocket:(GCDAsyncSocket *)newSocket
+{
+  HTTPConnection *newConnection = (HTTPConnection *)[[connectionClass alloc] initWithAsyncSocket:newSocket
+                                                                                   configuration:[self config]];
+  [connectionsLock lock];
+  [connections addObject:newConnection];
+  [connectionsLock unlock];
+  
+  [newConnection start];
+}
+
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+#pragma mark Notifications
+////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * This method is automatically called when a notification of type HTTPConnectionDidDieNotification is posted.
+ * It allows us to remove the connection from our array.
+ **/
+- (void)connectionDidDie:(NSNotification *)notification
+{
+  // Note: This method is called on the connection queue that posted the notification
+  
+  [connectionsLock lock];
+  
+  HTTPLogTrace();
+  [connections removeObject:[notification object]];
+  
+  [connectionsLock unlock];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/LICENSE

@@ -0,0 +1,18 @@
+Software License Agreement (BSD License)
+
+Copyright (c) 2011, Deusty, LLC
+All rights reserved.
+
+Redistribution and use of this software in source and binary forms,
+with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above
+  copyright notice, this list of conditions and the
+  following disclaimer.
+
+* Neither the name of Deusty nor the names of its
+  contributors may be used to endorse or promote products
+  derived from this software without specific prior
+  written permission of Deusty, LLC.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/Responses/HTTPDataResponse.h

@@ -0,0 +1,13 @@
+#import <Foundation/Foundation.h>
+#import "HTTPResponse.h"
+
+
+@interface HTTPDataResponse : NSObject <HTTPResponse>
+{
+  NSUInteger offset;
+  NSData *data;
+}
+
+- (id)initWithData:(NSData *)data;
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/Responses/HTTPDataResponse.m

@@ -0,0 +1,83 @@
+#import "HTTPDataResponse.h"
+#import "HTTPLogging.h"
+
+#if ! __has_feature(objc_arc)
+#warning This file must be compiled with ARC. Use -fobjc-arc flag (or convert project to ARC).
+#endif
+
+#pragma clang diagnostic ignored "-Wdirect-ivar-access"
+#pragma clang diagnostic ignored "-Wcast-qual"
+#pragma clang diagnostic ignored "-Wunused-variable"
+
+// Log levels : off, error, warn, info, verbose
+// Other flags: trace
+static const int httpLogLevel = HTTP_LOG_LEVEL_OFF; // | HTTP_LOG_FLAG_TRACE;
+
+
+@implementation HTTPDataResponse
+
+- (id)initWithData:(NSData *)dataParam
+{
+  if((self = [super init]))
+  {
+    HTTPLogTrace();
+    
+    offset = 0;
+    data = dataParam;
+  }
+  return self;
+}
+
+- (void)dealloc
+{
+  HTTPLogTrace();
+  
+}
+
+- (UInt64)contentLength
+{
+  UInt64 result = (UInt64)[data length];
+  
+  HTTPLogTrace2(@"%@[%p]: contentLength - %llu", THIS_FILE, self, result);
+  
+  return result;
+}
+
+- (UInt64)offset
+{
+  HTTPLogTrace();
+  
+  return offset;
+}
+
+- (void)setOffset:(UInt64)offsetParam
+{
+  HTTPLogTrace2(@"%@[%p]: setOffset:%lu", THIS_FILE, self, (unsigned long)offset);
+  
+  offset = (NSUInteger)offsetParam;
+}
+
+- (NSData *)readDataOfLength:(NSUInteger)lengthParameter
+{
+  HTTPLogTrace2(@"%@[%p]: readDataOfLength:%lu", THIS_FILE, self, (unsigned long)lengthParameter);
+  
+  NSUInteger remaining = [data length] - offset;
+  NSUInteger length = lengthParameter < remaining ? lengthParameter : remaining;
+  
+  void *bytes = (void *)(((char*)[data bytes]) + offset);
+  
+  offset += length;
+  
+  return [NSData dataWithBytesNoCopy:bytes length:length freeWhenDone:NO];
+}
+
+- (BOOL)isDone
+{
+  BOOL result = (offset == [data length]);
+  
+  HTTPLogTrace2(@"%@[%p]: isDone - %@", THIS_FILE, self, (result ? @"YES" : @"NO"));
+  
+  return result;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/Responses/HTTPErrorResponse.h

@@ -0,0 +1,9 @@
+#import "HTTPResponse.h"
+
+@interface HTTPErrorResponse : NSObject <HTTPResponse> {
+  NSInteger _status;
+}
+
+- (id)initWithErrorCode:(int)httpErrorCode;
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/CocoaHTTPServer/Responses/HTTPErrorResponse.m

@@ -0,0 +1,40 @@
+#import "HTTPErrorResponse.h"
+
+#pragma clang diagnostic ignored "-Wdirect-ivar-access"
+
+@implementation HTTPErrorResponse
+
+-(id)initWithErrorCode:(int)httpErrorCode
+{
+  if ((self = [super init]))
+  {
+    _status = httpErrorCode;
+  }
+  
+  return self;
+}
+
+- (UInt64) contentLength {
+  return 0;
+}
+
+- (UInt64) offset {
+  return 0;
+}
+
+- (void)setOffset:(UInt64)offset {
+  ;
+}
+
+- (NSData*) readDataOfLength:(NSUInteger)length {
+  return nil;
+}
+
+- (BOOL) isDone {
+  return YES;
+}
+
+- (NSInteger) status {
+  return _status;
+}
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Vendor/RoutingHTTPServer/HTTPResponseProxy.h

@@ -0,0 +1,13 @@
+#import <Foundation/Foundation.h>
+#import "HTTPResponse.h"
+
+// Wraps an HTTPResponse object to allow setting a custom status code
+// without needing to create subclasses of every response.
+@interface HTTPResponseProxy : NSObject <HTTPResponse>
+
+@property (nonatomic) NSObject<HTTPResponse> *response;
+@property (nonatomic) NSInteger status;
+
+- (NSInteger)customStatus;
+
+@end