Some example tests added and basic unit tests architecture setup

Author: Achal1607

vscode/src/test/unit/mocks/README.md

@@ -0,0 +1,2 @@
+## Important Note:
+Every entity exported from this directory should be prefixed with `Mock` or `Mocked` so that any developer doesn't import mocked VS Code or mocked elements in the extension main logic code.

vscode/src/test/unit/mocks/init.ts

@@ -0,0 +1,37 @@
+import { initMockedLocaliser } from "./mockLocaliser";
+import { initMockedVSCode } from "./vscode/mockVscode";
+
+const Module = require('module');
+const originalLoad = Module._load;
+
+export const initMocks = () => {
+   const mockedVSCode = initMockedVSCode();
+   const mockedLocaliser = initMockedLocaliser();
+   
+   const mocks = {
+    vscode: mockedVSCode,
+    localiser: mockedLocaliser
+   };
+
+   replaceImportsWithMocks(mocks);
+}
+
+
+const replaceImportsWithMocks = (mocks: any) => {
+    Module._load = function (request: any, _parent: any) {
+        if (request === 'vscode') {
+            return mocks.vscode;
+        } else if (request.includes('localiser')) {
+            return mocks.localiser;
+        }
+
+        if (/\.less$/.test(request)) {
+            return;
+        }
+        return originalLoad.apply(this, arguments);
+    };
+}
+
+export function restore() {
+    Module._load = originalLoad;
+}

vscode/src/test/unit/mocks/mockLocaliser.ts

@@ -0,0 +1,14 @@
+const mockedL10n = {
+    l10n: {
+        value(key: string) {
+            return key;
+        },
+        nbLocaleCode() {
+            return 'en';
+        },
+    }
+};
+
+export const initMockedLocaliser = () => {
+    return mockedL10n;
+}

vscode/src/test/unit/mocks/vscode/mockVscode.ts

@@ -0,0 +1,24 @@
+import * as vscode from 'vscode';
+import { URI } from './uri';
+import { mockWindowNamespace } from './namespaces/window';
+import { mockedEnums } from './vscodeHostedTypes';
+
+type VSCode = typeof vscode;
+const mockedVSCode: Partial<VSCode> = {};
+
+const mockedVscodeClassesAndTypes = () => {
+    mockedVSCode.Uri = URI as any;
+    mockedVSCode.ViewColumn = mockedEnums.viewColumn;
+}
+
+const mockNamespaces = () => {
+    mockWindowNamespace(mockedVSCode);
+}
+
+export const initMockedVSCode = () => {
+    mockedVscodeClassesAndTypes();
+    mockNamespaces();
+
+    return mockedVSCode;
+}
+

vscode/src/test/unit/mocks/vscode/namespaces/window.ts

@@ -0,0 +1,29 @@
+import * as vscode from 'vscode';
+import { mock, when, anyString, anyOfClass, anything, instance } from "ts-mockito";
+
+type VSCode = typeof vscode;
+
+let mockedWindow: typeof vscode.window;
+export const mockWindowNamespace = (mockedVSCode: Partial<VSCode>) => {
+    mockedWindow = mock<typeof vscode.window>();
+    mockedVSCode.window = instance(mockedWindow);
+    mockCreateWebViewPanel();
+    mockCreateOutputChannel();
+}
+
+const mockCreateWebViewPanel = () => {
+    const mockedWebviewPanel = mock<vscode.WebviewPanel>();
+    when(mockedWindow.createWebviewPanel(
+        anyString(),
+        anyString(),
+        anyOfClass(Number),
+        anything()
+    )).thenReturn(instance(mockedWebviewPanel));
+} 
+
+const mockCreateOutputChannel = () => {
+    const mockedOutputChannel = mock<vscode.OutputChannel>();
+    when(mockedWindow.createOutputChannel(
+        anyString()
+    )).thenReturn(instance(mockedOutputChannel));
+} 

vscode/src/test/unit/mocks/vscode/vscodeHostedTypes.ts

@@ -0,0 +1,17 @@
+enum ViewColumn {
+    Active = -1,
+    Beside = -2,
+    One = 1,
+    Two = 2,
+    Three = 3,
+    Four = 4,
+    Five = 5,
+    Six = 6,
+    Seven = 7,
+    Eight = 8,
+    Nine = 9,
+}
+
+export const mockedEnums = {
+    viewColumn: ViewColumn
+}

vscode/src/test/unit/mocks/vscode/vscodeMock.ts

@@ -1,12 +1,12 @@
 import * as Mocha from 'mocha';
 import { glob } from 'glob';
 import * as path from 'path';
-import { vscodeMockInit } from './mocks/vscode/vscodeMock';
-
+import { initMocks } from './mocks/init';
 
 const mocha = new Mocha({
     ui: 'tdd',
-    color: true
+    color: true,
+    timeout: 600 * 1000
 });
 
 
@@ -46,7 +46,7 @@ try {
     if (args.length) {
         console.log(`Running unit tests for following speicified modules: ${args.map(el => el)}`);
     }
-    vscodeMockInit();
+    initMocks();
     testRunner(args);
 } catch (err: any) {
     console.error("Exception occurred while running tests");

vscode/src/test/unit/runTest.ts

@@ -0,0 +1,33 @@
+import { describe, it, beforeEach, afterEach } from 'mocha';
+import { expect } from 'chai';
+import * as sinon from 'sinon';
+import { WebviewPanel, window } from 'vscode';
+import { LOGGER } from '../../../logger';
+import { JdkDownloaderAction } from '../../../webviews/jdkDownloader/action';
+import { JdkDownloaderView } from '../../../webviews/jdkDownloader/view';
+
+describe('JDK Downloader action tests', () => {
+  let jdkDownloaderAction: JdkDownloaderAction;
+  const sandbox = sinon.createSandbox();
+
+  beforeEach(() => {
+    jdkDownloaderAction = new JdkDownloaderAction(new JdkDownloaderView());
+    sandbox.stub(LOGGER, 'log').callsFake((message) => {
+      console.log(message);
+    });
+    sandbox.stub(LOGGER, 'error').callsFake((message) => {
+      console.error(message);
+    });
+    sandbox.stub(LOGGER, 'warn').callsFake((message) => {
+      console.warn(message);
+    });
+  });
+
+  afterEach(() => {
+    sandbox.restore();
+  });
+
+  describe('JDK Downloader action attachListener tests', () => {
+    
+  });
+});