feat(driverProviders): Add TestObject and Kobiton as driverProviders

feat(driverProviders): Add TestObject and Kobiton as driverProviders

1. Add testObject and kobiton to driverProviders
2. Add testObject and kobiton items to cli, config and index
3. Add instructions for using testObject and kobiton to server-setup

Author: lt-bstevens

Diff for: docs/server-setup.md

@@ -61,7 +61,23 @@ Please note that if you set seleniumAddress, the settings for `seleniumServerJar
 Remote Selenium Server
 ----------------------
 
-To run your tests against a remote Selenium Server, you will need an account with a service that hosts the server (and the browser drivers). Protractor has built in support for [BrowserStack](https://www.browserstack.com) and [Sauce Labs](http://www.saucelabs.com).
+To run your tests against a remote Selenium Server, you will need an account with a service that hosts the server (and the browser drivers). Protractor has built in support for [BrowserStack](https://www.browserstack.com) , [Sauce Labs](http://www.saucelabs.com) and [TestObject](https://www.testobject.com).
+
+**Using TestObject as remote Selenium Server**
+
+In your config file, set these options:
+ - `testobjectUser` -  The username for your TestObject account.
+ - `testobjectKey` -  The key for your TestObject account.
+
+Please note that if you set `testobjectUser` and `testobjectKey`, the settings for `kobitonUser`, `kobitonKey`, `browserstackUser`, `browserstackKey`, `seleniumServerJar`, `seleniumPort`, `seleniumArgs`, `sauceUser` and `sauceKey` will be ignored.
+
+**Using Kobiton as remote Selenium Server**
+
+In your config file, set these options:
+ - `kobitonUser` -  The username for your Kobiton account.
+ - `kobitonKey` -  The API key from your Kobiton account.
+
+Please note that if you set `kobitonUser` and `kobitonKey`, the settings for `browserstackUser`, `browserstackKey`, `seleniumServerJar`, `seleniumPort`, `seleniumArgs`, `sauceUser` and `sauceKey` will be ignored.
 
 **Using BrowserStack as remote Selenium Server**
 

Diff for: lib/cli.ts

@@ -50,6 +50,10 @@ let allowedNames = [
   'sauceSeleniumAddress',
   'browserstackUser',
   'browserstackKey',
+  'kobitonUser',
+  'kobitonKey',
+  'testobjectUser',
+  'testobjectKey',
   'directConnect',
   'firefoxPath',
   'noGlobals',

Diff for: lib/config.ts

@@ -162,7 +162,37 @@ export interface Config {
    */
   sauceSeleniumAddress?: string;
 
-  // ---- 4. To use remote browsers via BrowserStack ---------------------------
+  // ---- 4. To use remote browsers via TestObject ---------------------------
+
+  /**
+   * If testobjectUser and testobjectKey are specified, kobitonUser, kobitonKey, browserstackUser,
+   * browserStackKey and seleniumServerJar will be ignored. The tests will be run remotely using
+   * TestObject.
+   */
+  testobjectUser?: string;
+  /**
+   * If testobjectUser and testobjectKey are specified, kobitonUser, kobitonKey, browserStackUser,
+   * browserStackKey and seleniumServerJar will be ignored. The tests will be run remotely using
+   * TestObject.
+   */
+  testobjectKey?: string;
+
+  // ---- 5. To use remote browsers via Kobiton ---------------------------
+
+  /**
+   * If kobitonUser and kobitonKey are specified, testobjectUser, testojbectKey, browserstackUser,
+   * browserStackKey and seleniumServerJar will be ignored. The tests will be run remotely using
+   * TestObject.
+   */
+  kobitonUser?: string;
+  /**
+   * If kobitonUser and kobitonKey are specified, testobjectUser, testojbectKey, browserStackUser,
+   * browserStackKey and seleniumServerJar will be ignored. The tests will be run remotely using
+   * TestObject.
+   */
+  kobitonKey?: string;
+
+  // ---- 6. To use remote browsers via BrowserStack ---------------------------
 
   /**
    * If browserstackUser and browserstackKey are specified, seleniumServerJar
@@ -175,7 +205,7 @@ export interface Config {
    */
   browserstackKey?: string;
 
-  // ---- 5. To connect directly to Drivers ------------------------------------
+  // ---- 7. To connect directly to Drivers ------------------------------------
 
   /**
    * If true, Protractor will connect directly to the browser Drivers

Diff for: lib/driverProviders/index.ts

@@ -6,6 +6,8 @@ export * from './hosted';
 export * from './local';
 export * from './mock';
 export * from './sauce';
+export * from './testObject';
+export * from './kobiton';
 
 
 import {AttachSession} from './attachSession';
@@ -16,6 +18,8 @@ import {Hosted} from './hosted';
 import {Local} from './local';
 import {Mock} from './mock';
 import {Sauce} from './sauce';
+import {TestObject} from './testObject';
+import {Kobiton} from './kobiton';
 
 import {Config} from '../config';
 import {Logger} from '../logger';
@@ -36,6 +40,12 @@ export let buildDriverProvider = (config: Config): DriverProvider => {
       driverProvider = new Hosted(config);
       logWarnings('hosted', config);
     }
+  } else if (config.testobjectUser && config.testobjectKey) {
+    driverProvider = new TestObject(config);
+    logWarnings('testObject', config);
+  } else if (config.kobitonUser && config.kobitonKey) {
+    driverProvider = new Kobiton(config);
+    logWarnings('kobiton', config);
   } else if (config.browserstackUser && config.browserstackKey) {
     driverProvider = new BrowserStack(config);
     logWarnings('browserStack', config);
@@ -69,6 +79,18 @@ export let logWarnings = (providerType: string, config: Config): void => {
   if ('attachSession' !== providerType && config.seleniumSessionId) {
     warnList.push('seleniumSessionId');
   }
+  if ('testObject' !== providerType && config.testObjectUser) {
+    warnList.push('testobjectUser');
+  }
+  if ('testObject' !== providerType && config.testObjectKey) {
+    warnList.push('testobjectKey');
+  }
+  if ('kobitonUser' !== providerType && config.kobitonUser) {
+    warnList.push('kobitonUser');
+  }
+  if ('kobitonKey' !== providerType && config.kobitonKey) {
+    warnList.push('kobitonKey');
+  }
   if ('browserStack' !== providerType && config.browserstackUser) {
     warnList.push('browserstackUser');
   }

Diff for: lib/driverProviders/kobiton.ts

@@ -0,0 +1,34 @@
+/*
+ * This is an implementation of the Kobiton Driver Provider.
+ * It is responsible for setting up the account object, tearing
+ * it down, and setting up the driver correctly.
+ */
+import * as q from 'q';
+import {Config} from '../config';
+import {Logger} from '../logger';
+import {DriverProvider} from './driverProvider';
+
+let logger = new Logger('kobiton');
+
+export class Kobiton extends DriverProvider {
+  constructor(config: Config) {
+    super(config);
+  }
+
+  /**
+   * Configure and launch (if applicable) the object's environment.
+   * @return {q.promise} A promise which will resolve when the environment is
+   *      ready to test.
+   */
+  protected setupDriverEnv(): q.Promise<any> {
+    let deferred = q.defer();
+    this.config_.capabilities['kobitonUser'] = this.config_.kobitonUser;
+    this.config_.capabilities['kobitonKey'] = this.config_.kobitonKey;
+    this.config_.seleniumAddress = 'https://' + this.config_.kobitonUser + ':' +
+        this.config_.kobitonKey + '@api.kobiton.com/wd/hub';
+
+    logger.info('Using Kobiton selenium server at ' + this.config_.seleniumAddress);
+    deferred.resolve();
+    return deferred.promise;
+  }
+}

Diff for: lib/driverProviders/testObject.ts

@@ -0,0 +1,33 @@
+/*
+ * This is an implementation of the TestObject Driver Provider.
+ * It is responsible for setting up the account object, tearing
+ * it down, and setting up the driver correctly.
+ */
+import * as q from 'q';
+import {Config} from '../config';
+import {Logger} from '../logger';
+import {DriverProvider} from './driverProvider';
+
+let logger = new Logger('testobject');
+
+export class TestObject extends DriverProvider {
+  constructor(config: Config) {
+    super(config);
+  }
+
+  /**
+   * Configure and launch (if applicable) the object's environment.
+   * @return {q.promise} A promise which will resolve when the environment is
+   *      ready to test.
+   */
+  protected setupDriverEnv(): q.Promise<any> {
+    let deferred = q.defer();
+    this.config_.capabilities['testobject.user'] = this.config_.testobjectUser;
+    this.config_.capabilities['testobject_api_key'] = this.config_.testobjectKey;
+    this.config_.seleniumAddress = 'https://us1.appium.testobject.com/wd/hub';
+
+    logger.info('Using TestObject selenium server at ' + this.config_.seleniumAddress);
+    deferred.resolve();
+    return deferred.promise;
+  }
+}