Add functions explorer

Refresh command and display subscriptions

Author: ejizba

.gitignore

@@ -57,3 +57,5 @@ typings/
 # dotenv environment variables file
 .env
 
+# package-lock file since it just causes merge conflicts
+package-lock.json

.travis.yml

@@ -0,0 +1,15 @@
+language: node_js
+
+node_js:
+  - 'stable'
+
+install:
+  - npm install
+
+script:
+  - tsc -p ./
+
+notifications:
+  email:
+    on_success: never
+    on_failure: always

.vscode/launch.json

@@ -0,0 +1,28 @@
+// A launch configuration that compiles the extension and then opens it inside a new window
+{
+    "version": "0.1.0",
+    "configurations": [
+        {
+            "name": "Launch Extension",
+            "type": "extensionHost",
+            "request": "launch",
+            "runtimeExecutable": "${execPath}",
+            "args": ["--extensionDevelopmentPath=${workspaceRoot}" ],
+            "stopOnEntry": false,
+            "sourceMaps": true,
+            "outFiles": [ "${workspaceRoot}/out/src/**/*.js" ],
+            "preLaunchTask": "npm"
+        },
+        {
+            "name": "Launch Tests",
+            "type": "extensionHost",
+            "request": "launch",
+            "runtimeExecutable": "${execPath}",
+            "args": ["--extensionDevelopmentPath=${workspaceRoot}", "--extensionTestsPath=${workspaceRoot}/out/test" ],
+            "stopOnEntry": false,
+            "sourceMaps": true,
+            "outFiles": [ "${workspaceRoot}/out/test/**/*.js" ],
+            "preLaunchTask": "npm"
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,9 @@
+// Place your settings in this file to overwrite default and user settings.
+{
+    "files.exclude": {
+        "out": false // set this to true to hide the "out" folder with the compiled JS files
+    },
+    "search.exclude": {
+        "out": true // set this to false to include "out" folder in search results
+    }
+}

.vscode/tasks.json

@@ -0,0 +1,30 @@
+// Available variables which can be used inside of strings.
+// ${workspaceRoot}: the root folder of the team
+// ${file}: the current opened file
+// ${fileBasename}: the current opened file's basename
+// ${fileDirname}: the current opened file's dirname
+// ${fileExtname}: the current opened file's extension
+// ${cwd}: the current working directory of the spawned process
+
+// A task runner that calls a custom npm script that compiles the extension.
+{
+    "version": "0.1.0",
+
+    // we want to run npm
+    "command": "npm",
+
+    // the command is a shell script
+    "isShellCommand": true,
+
+    // show the output window only if unrecognized errors occur.
+    "showOutput": "silent",
+
+    // we run the custom script "compile" as defined in package.json
+    "args": ["run", "compile", "--loglevel", "silent"],
+
+    // The tsc compiler is started in watching mode
+    "isBackground": true,
+
+    // use the standard tsc in watch mode problem matcher to find compile problems in the output.
+    "problemMatcher": "$tsc-watch"
+}

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Change Log
+All notable changes to the "azurefunctions" extension will be documented in this file.
+
+Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
+
+## [Unreleased]

LICENSE LICENSE.md

@@ -1,14 +1,26 @@
+# Azure Functions for Visual Studio Code
 
-# Contributing
+## Features
 
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit https://cla.microsoft.com.
+## Contributing
+There are a couple of ways you can contribute to this repo:
 
-When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
+- **Ideas, feature requests and bugs**: We are open to all ideas and we want to get rid of bugs! Use the Issues section to either report a new issue, provide your ideas or contribute to existing threads.
+- **Documentation**: Found a typo or strangely worded sentences? Submit a PR!
+- **Code**: Contribute bug fixes, features or design changes:
+  - Clone the repository locally and open in VS Code.
+  - Open the terminal (press `CTRL+`\`) and run `npm install`.
+  - To build, press `F1` and type in `Tasks: Run Build Task`.
+  - Debug: press `F5` to start debugging the extension.
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
+### Legal
+Before we can accept your pull request you will need to sign a **Contribution License Agreement**. All you need to do is to submit a pull request, then the PR will get appropriately labelled (e.g. `cla-required`, `cla-norequired`, `cla-signed`, `cla-already-signed`). If you already signed the agreement we will continue with reviewing the PR, otherwise system will tell you how you can sign the CLA. Once you sign the CLA all future PR's will be labeled as `cla-signed`.
+
+### Code of Conduct
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
+
+## Telemetry
+This extension collects telemetry data to help us build a better experience with Cosmos DB and VS Code. The extension respects the `telemetry.enableTelemetry` setting which you can learn more about in our [FAQ](https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting).
+
+## License 
+[MIT](LICENSE.md)

README.md

@@ -0,0 +1,84 @@
+{
+    "name": "vscode-azurefunctions",
+    "displayName": "Azure Functions",
+    "description": "An Azure Functions extension for Visual Studio Code.",
+    "version": "0.1.0",
+    "publisher": "ms-azuretools",
+    "icon": "resources/TODO.png",
+    "aiKey": "AIF-d9b70cd4-b9f9-4d70-929b-a071c400b217",
+    "engines": {
+        "vscode": "^1.16.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/Microsoft/vscode-azurefunctions"
+    },
+    "galleryBanner": {
+        "color": "#0072c6",
+        "theme": "dark"
+    },
+    "homepage": "https://github.com/Microsoft/vscode-azurefunctions/blob/master/README.md",
+    "license": "SEE LICENSE IN LICENSE.md",
+    "categories": [
+        "Azure"
+    ],
+    "preview": true,
+    "activationEvents": [
+        "onCommand:azureFunctions.refresh",
+        "onView:azureFunctionsExplorer"
+    ],
+    "main": "./out/src/extension",
+    "contributes": {
+        "commands": [
+            {
+                "command": "azureFunctions.refresh",
+                "title": "Refresh",
+                "category": "Azure Functions",
+                "icon": {
+                    "light": "resources/light/refresh.svg",
+                    "dark": "resources/dark/refresh.svg"
+                }
+            }
+        ],
+        "views": {
+            "explorer": [
+                {
+                    "id": "azureFunctionsExplorer",
+                    "name": "Functions"
+                }
+            ]
+        },
+        "menus": {
+            "view/title": [
+                {
+                    "command": "azureFunctions.refresh",
+                    "when": "view == azureFunctionsExplorer",
+                    "group": "navigation@2"
+                }
+            ]
+        }
+    },
+    "scripts": {
+        "vscode:prepublish": "tsc -p ./",
+        "compile": "tsc -watch -p ./",
+        "postinstall": "node ./node_modules/vscode/bin/install",
+        "test": "node ./node_modules/vscode/bin/test"
+    },
+    "devDependencies": {
+        "@types/archiver": "^2.0.0",
+        "@types/node": "^8.0.28",
+        "typescript": "^2.0.3",
+        "vscode": "^1.0.0"
+    },
+    "dependencies": {
+        "archiver": "^2.0.3",
+        "azure-arm-resource": "^2.0.0-preview",
+        "ms-rest": "^2.2.2",
+        "ms-rest-azure": "^2.3.1",
+        "opn": "^5.1.0",
+        "vscode-extension-telemetry": "^0.0.6"
+    },
+    "extensionDependencies": [
+        "ms-vscode.azure-account"
+    ]
+}

package.json

@@ -0,0 +1,39 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { Event } from 'vscode';
+import { ServiceClientCredentials } from 'ms-rest';
+import { AzureEnvironment } from 'ms-rest-azure';
+import { SubscriptionModels } from 'azure-arm-resource';
+
+export type AzureLoginStatus = 'Initializing' | 'LoggingIn' | 'LoggedIn' | 'LoggedOut';
+
+export interface AzureAccount {
+    readonly status: AzureLoginStatus;
+    readonly onStatusChanged: Event<AzureLoginStatus>;
+    readonly waitForLogin: () => Promise<boolean>;
+    readonly sessions: AzureSession[];
+    readonly onSessionsChanged: Event<void>;
+    readonly filters: AzureResourceFilter[];
+    readonly onFiltersChanged: Event<void>;
+}
+
+export interface AzureSession {
+    readonly environment: AzureEnvironment;
+    readonly userId: string;
+    readonly tenantId: string;
+    readonly credentials: ServiceClientCredentials;
+}
+
+export interface AzureResourceFilter {
+    readonly session: AzureSession;
+    readonly subscription: SubscriptionModels.Subscription;
+}
+
+export interface Credentials {
+    readSecret(service: string, account: string): Thenable<string | undefined>;
+    writeSecret(service: string, account: string, secret: string): Thenable<void>;
+    deleteSecret(service: string, account: string): Thenable<boolean>;
+}

resources/dark/AzureSubscription.svg

@@ -0,0 +1,40 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import { TreeDataProvider, Event, EventEmitter, TreeItem } from 'vscode';
+import { LoadingNode, NoSubscriptionsNode, SignInToAzureNode, SubscriptionNode, INode } from './nodes';
+import { AzureAccount } from './azure-account.api';
+
+export class AzureFunctionsExplorer implements TreeDataProvider<INode> {
+    private _onDidChangeTreeData: EventEmitter<INode> = new EventEmitter<INode>();
+    readonly onDidChangeTreeData: Event<INode> = this._onDidChangeTreeData.event;
+
+    constructor(private azureAccount: AzureAccount) {
+    }
+
+    getTreeItem(node: INode): TreeItem {
+        return node;
+    }
+
+    async getChildren(node?: INode): Promise<INode[]> {
+        if (node) {
+            return node.getChildren ? await node.getChildren() : [];
+        } else { // Root of the explorer
+            if (this.azureAccount.status === "Initializing" || this.azureAccount.status === "LoggingIn") {
+                return [new LoadingNode()];
+            } else if (this.azureAccount.status === "LoggedOut") {
+                return [new SignInToAzureNode()];
+            } else if (this.azureAccount.filters.length === 0) {
+                return [new NoSubscriptionsNode()];
+            } else {
+                return this.azureAccount.filters.map(filter => new SubscriptionNode(filter))
+            }
+        }
+    }
+
+    refresh(node?: INode): void {
+        this._onDidChangeTreeData.fire(node);
+    }
+}

resources/dark/Refresh.svg

@@ -0,0 +1,61 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+'use strict';
+
+import * as vscode from 'vscode';
+import * as util from "./util";
+
+import { AzureAccount } from './azure-account.api';
+import { AzureFunctionsExplorer } from './explorer';
+import { INode } from './nodes'
+import { Reporter } from './telemetry';
+
+export function activate(context: vscode.ExtensionContext) {
+    context.subscriptions.push(new Reporter(context));
+
+    const azureAccount = vscode.extensions.getExtension<AzureAccount>('ms-vscode.azure-account')!.exports;
+    if (azureAccount) {
+        context.subscriptions.push(azureAccount.onFiltersChanged(() => explorer.refresh()));
+        context.subscriptions.push(azureAccount.onStatusChanged(() => explorer.refresh()));
+
+        const explorer = new AzureFunctionsExplorer(azureAccount);
+        context.subscriptions.push(vscode.window.registerTreeDataProvider('azureFunctionsExplorer', explorer));
+
+        initCommand(context, 'azureFunctions.refresh', (node?: INode) => explorer.refresh(node));
+    } else {
+        vscode.window.showErrorMessage("The Azure Account Extension is required for the Azure Functions extension.");
+    }
+}
+
+export function deactivate() {
+}
+
+function initCommand(context: vscode.ExtensionContext, commandId: string, callback: (...args: any[]) => any) {
+    initAsyncCommand(context, commandId, (...args: any[]) => Promise.resolve(callback(...args)));
+}
+
+function initAsyncCommand(context: vscode.ExtensionContext, commandId: string, callback: (...args: any[]) => Promise<any>) {
+    context.subscriptions.push(vscode.commands.registerCommand(commandId, async (...args: any[]) => {
+        const start = Date.now();
+        let result = 'Succeeded';
+        let errorData: string | undefined;
+
+        try {
+            await callback(...args);
+        } catch (error) {
+            result = 'Failed';
+            errorData = util.errorToString(error);
+            throw error;
+        } finally {
+            const end = Date.now();
+            const properties: { [key: string]: string; } = { result: result };
+            if (errorData) {
+                properties.error = errorData;
+            }
+            util.sendTelemetry(commandId, properties, { duration: (end - start) / 1000 });
+        }
+    }));
+}