Add extension unit testing infrastructure

This change enables Mocha-based unit tests for the PowerShell extension
using VS Code's embedded test running mode.

Author: daviwil

.gitignore

@@ -11,3 +11,4 @@ vscode-powershell.zip
 vscps-preview.zip
 *.vsix
 npm-debug.log
+.vscode-test/

.vscode/launch.json

@@ -9,7 +9,7 @@
 			"args": [ "--extensionDevelopmentPath=${workspaceRoot}" ],
 			"stopOnEntry": false,
 			"sourceMaps": true,
-			"outFiles": ["${workspaceRoot}/out"],
+			"outFiles": ["${workspaceRoot}/out/src/**/*.js"],
 			"preLaunchTask": "BuildAll"
 		},
 		{
@@ -20,7 +20,18 @@
 			"args": [ "--extensionDevelopmentPath=${workspaceRoot}" ],
 			"stopOnEntry": false,
 			"sourceMaps": true,
-			"outFiles": ["${workspaceRoot}/out"],
+			"outFiles": ["${workspaceRoot}/out/src/**/*.js"],
+			"preLaunchTask": "Build"
+		},
+		{
+			"name": "Launch Extension Tests",
+			"type": "extensionHost",
+			"request": "launch",
+			"runtimeExecutable": "${execPath}",
+			"args": ["--extensionDevelopmentPath=${workspaceRoot}", "--extensionTestsPath=${workspaceRoot}/out/test" ],
+			"stopOnEntry": false,
+			"sourceMaps": true,
+			"outFiles": ["${workspaceRoot}/out/test/**/*.js"],
 			"preLaunchTask": "Build"
 		},
 		{

.vscodeignore

@@ -1,4 +1,5 @@
 .vscode/**
+.vscode-test/**
 vscode-powershell.build.ps1
 typings/**
 **/*.ts
@@ -10,5 +11,7 @@ bin/DebugAdapter.log
 bin/*.vshost.*
 bin/PowerShell/**
 logs/**
+out/test/**
+test/**
 sessions/**
 scripts/Install-VSCode.ps1

package.json

@@ -24,7 +24,7 @@
     "type": "git",
     "url": "https://github.com/PowerShell/vscode-powershell.git"
   },
-  "main": "./out/main",
+  "main": "./out/src/main",
   "activationEvents": [
     "onLanguage:powershell",
     "onCommand:PowerShell.NewProjectFromTemplate",
@@ -41,15 +41,18 @@
     "@types/node": "^6.0.40",
     "typescript": "^2.0.3",
     "vsce": "^1.18.0",
-    "vscode": "^1.1.0"
+    "vscode": "^1.1.0",
+    "mocha": "^2.3.3",
+    "@types/mocha": "^2.2.32"
   },
   "extensionDependencies": [
     "vscode.powershell"
   ],
   "scripts": {
     "compile": "tsc -p ./",
     "compile-watch": "tsc -watch -p ./",
-    "postinstall": "node ./node_modules/vscode/bin/install"
+    "postinstall": "node ./node_modules/vscode/bin/install",
+    "test": "node ./node_modules/vscode/bin/test"
   },
   "contributes": {
     "keybindings": [
@@ -188,7 +191,7 @@
             "powershell"
           ]
         },
-        "program": "./out/debugAdapter.js",
+        "program": "./out/src/debugAdapter.js",
         "runtime": "node",
         "variables": {
           "PickPSHostProcess": "PowerShell.PickPSHostProcess",

src/debugAdapter.ts

@@ -14,7 +14,7 @@ import { Logger } from './logging';
 // named pipes or a network protocol).  It is purely a naive data
 // relay between the two transports.
 
-var logBasePath = path.resolve(__dirname, "../logs");
+var logBasePath = path.resolve(__dirname, "../../logs");
 
 var debugAdapterLogWriter =
     fs.createWriteStream(

src/features/Examples.ts

@@ -12,7 +12,7 @@ export class ExamplesFeature implements IFeature {
     private examplesPath: string;
 
     constructor() {
-        this.examplesPath = path.resolve(__dirname, "../../examples");
+        this.examplesPath = path.resolve(__dirname, "../../../examples");
         this.command = vscode.commands.registerCommand('PowerShell.OpenExamplesFolder', () => {
             vscode.commands.executeCommand(
                 "vscode.openFolder",

src/logging.ts

@@ -29,7 +29,7 @@ export class Logger {
     constructor() {
         this.logChannel = vscode.window.createOutputChannel("PowerShell Extension Logs");
 
-        this.logBasePath = path.resolve(__dirname, "../logs");
+        this.logBasePath = path.resolve(__dirname, "../../logs");
         utils.ensurePathExists(this.logBasePath);
 
         this.commands = [

src/main.ts

@@ -161,7 +161,7 @@ function checkForUpdatedVersion(context: vscode.ExtensionContext) {
                 if (choice === showReleaseNotes) {
                     vscode.commands.executeCommand(
                         'markdown.showPreview',
-                        vscode.Uri.file(path.resolve(__dirname, "../CHANGELOG.md")));
+                        vscode.Uri.file(path.resolve(__dirname, "../../CHANGELOG.md")));
                 }
             });
     }

src/process.ts

@@ -40,7 +40,7 @@ export class PowerShellProcess {
                     let startScriptPath =
                         path.resolve(
                             __dirname,
-                            '../scripts/Start-EditorServices.ps1');
+                            '../../scripts/Start-EditorServices.ps1');
 
                     var editorServicesLogPath = this.log.getLogFilePath(logFileName);
 
@@ -77,7 +77,7 @@ export class PowerShellProcess {
                         // NOTE: This batch file approach is needed temporarily until VS Code's
                         // createTerminal API gets an argument for setting environment variables
                         // on the launched process.
-                        var batScriptPath = path.resolve(__dirname, '../sessions/powershell.bat');
+                        var batScriptPath = path.resolve(__dirname, '../../sessions/powershell.bat');
                         fs.writeFileSync(
                             batScriptPath,
                             `@set DEVPATH=${path.dirname(powerShellExePath)}\r\n@${powerShellExePath} %*`);

src/session.ts

@@ -121,15 +121,15 @@ export class SessionManager implements Middleware {
 
         if (this.powerShellExePath) {
 
-            var bundledModulesPath = path.resolve(__dirname, "../modules");
+            var bundledModulesPath = path.resolve(__dirname, "../../modules");
 
             if (this.inDevelopmentMode) {
                 var devBundledModulesPath =
                     // this.sessionSettings.developer.bundledModulesPath ||
                     path.resolve(
                         __dirname,
                         this.sessionSettings.developer.bundledModulesPath ||
-                        "../../PowerShellEditorServices/module");
+                        "../../../PowerShellEditorServices/module");
 
                 // Make sure the module's bin path exists
                 if (fs.existsSync(path.join(devBundledModulesPath, "PowerShellEditorServices/bin"))) {

src/utils.ts

@@ -52,7 +52,7 @@ export interface WaitForSessionFileCallback {
     (details: EditorServicesSessionDetails, error: string): void;
 }
 
-let sessionsFolder = path.resolve(__dirname, "..", "sessions/");
+let sessionsFolder = path.resolve(__dirname, "..", "..", "sessions/");
 let sessionFilePathPrefix = path.resolve(sessionsFolder, "PSES-VSCode-" + process.env.VSCODE_PID);
 
 // Create the sessions path if it doesn't exist already

test/index.ts

@@ -0,0 +1,9 @@
+var testRunner = require('vscode/lib/testrunner');
+
+// See https://github.com/mochajs/mocha/wiki/Using-mocha-programmatically#set-options for options
+testRunner.configure({
+    ui: 'tdd', 		// the TDD UI is being used in extension.test.ts (suite, test, etc.)
+    useColors: true // colored output from test results
+});
+
+module.exports = testRunner;