[Issue #11] Support for localIdentifier capability

Author: nagpalkaran95

README.md

@@ -60,7 +60,8 @@ This will create a sample `browserstack.json` file. This file can be used to con
       "customBuildName": "build 1"
     },
     "connection_settings": {
-      "local": false
+      "local": false,
+      "localIdentifier": ""
     }
 }
 ```
@@ -80,6 +81,7 @@ The following table provides a reference for all the options that can be provide
 | `project`         | Name of your project. This will be displayed in your Automate dashboard, and you'll be able to search & filter your tests based on the project name.                                                                                                                         | A string providing the name of the project                                                                                    |
 | `customBuildName` | Helps in providing a custom name for the build. This will be displayed in your Automate dashboard, and you'll be able to search & filter your tests based on the build name.                                                                                              | A string providing the name of the build                                                                                      |
 | `local`           | Helps in testing websites that cannot be accessed in public network. If you set this to `true`, please download the Local binary and establish a local connection first (you can learn how to do so [here](https://www.browserstack.com/local-testing/automate#command-line))                                                                       | Boolean: `true` / `false`. Set this to `true` if you need to test a local website. Set this to `false` if the website is accessible publicly.              |
+| `localIdentifier`           |  Configure the test script to run through a specific connection. To do so, set the value of localIdentifier capability to be a unique connection name.                                                                       | Set this when `local` is set to `true`.              |
 
 ### Running the tests
 You can start running your test build using the following command.

bin/helpers/capabilityHelper.js

@@ -33,6 +33,10 @@ const caps = (bsConfig, zip) => {
     if (bsConfig.connection_settings.local === true) obj.local = true;
     logger.log(`Local is set to: ${obj.local}`);
 
+    // Local Identifier
+    obj.localIdentifier = bsConfig.connection_settings.localIdentifier;
+    if (obj.localIdentifier) logger.log(`Local Identifier is set to: ${obj.localIdentifier}`);
+
     // Project name
     obj.project = bsConfig.run_settings.project
     if (!obj.project) logger.log(`Project name is: ${obj.project}`);

bin/templates/configTemplate.js

@@ -17,7 +17,8 @@ module.exports = function () {
       "customBuildName": "build-name"
     },
     "connection_settings": {
-      "local": false
+      "local": false,
+      "localIdentifier": null
     }
   }
   var EOL = require('os').EOL