build tools

Author: omniomi

.gitignore

@@ -0,0 +1,3 @@
+syntaxes/
+tools/node_modules/
+tools/package-lock.json

README.md

@@ -22,6 +22,49 @@ both VS Code and Sublime Text.  There are a number of existing issues with the g
 that we need to track down and fix.  Please see [issue #1](https://github.com/PowerShell/EditorSyntax/issues/1)
 for more details.
 
+## Build and Import (VS Code)
+
+### Prerequisites
+
+- Python, >=2.7 (version 3 is not supported)
+- Node.JS, >= 8.9.1
+
+### Build
+
+1. Navigate via command line to the ./tools/` directory and install dependencies:
+
+    ```
+    npm install
+    ```
+
+2. Run the `build-grammar` script to generate the json file.
+
+    ```
+    npm run build-grammar
+    ```
+
+3. The .json file will be output to `./syntaxes/` at the root  of the directory. You can use the vscode.ps1 script to load it or do it manually.
+
+    **Install - script**
+
+    ```PowerShell
+    PS tools> .\vscode.ps1 -InstallSyntax
+    ```
+
+    **Revert - script**
+
+    ```PowerShell
+    PS tools> .\vscode.ps1 -RevertSyntax
+    ```
+
+    **Install - manually**
+
+    1. Locate the VS Code installation directory and navigate to to `resources/app/extensions/powershell/syntaxes`
+
+    2. Rename `powershell.tmLanguage.json` to `powershell.tmLanguage.json_default`
+
+    3. Copy `powershell.tmLanguage.json` from `./syntaxes/` within this project folder to where you just renamed the file under VS Code's path.
+
 ## Contributing
 
 We would love to have community contributions to this project to make PowerShell syntax

tools/package.json

@@ -0,0 +1,10 @@
+{
+ "name": "EditorSyntax",
+ "version": "1.0.0",
+ "dependencies": {
+  "fast-plist": "0.1.2"
+ },
+ "scripts": {
+  "build-grammar": "node ./scripts/build-grammar.js ../PowerShellSyntax.tmLanguage ../syntaxes/powershell.tmLanguage.json"
+ }
+}

tools/scripts/build-grammar.js

@@ -0,0 +1,51 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *
+ *  Modified for PowerShell\EditorSyntax from MicroSoft\vscode (update-grammar.js)
+ *    This script generates the JSON file using the same tools as vscode's build.
+ *--------------------------------------------------------------------------------------------*/
+
+ 'use strict';
+
+var path = require('path');
+var fs = require('fs');
+var plist = require('fast-plist');
+
+exports.update = function (tmlPath, dest) {
+
+    var content = fs.readFileSync(tmlPath).toString();
+
+    var grammar;
+	grammar = plist.parse(content);
+
+    let result = {
+        information_for_contributors: [
+            'This file has been converted from source and may not be in line with the official build.',
+            'The current master branch for this syntax can be found here: https://github.com/PowerShell/EditorSyntax',
+            'If you want to provide a fix or improvement, please create a pull request against the original repository.'
+        ]
+    };
+
+    result.version = require('child_process')
+        .execSync('git rev-parse HEAD')
+        .toString().trim()
+
+    let keys = ['name', 'scopeName', 'comment', 'injections', 'patterns', 'repository'];
+    for (let key of keys) {
+        if (grammar.hasOwnProperty(key)) {
+            result[key] = grammar[key];
+        }
+    }
+
+    var dirname = path.dirname(dest);
+    if (!fs.existsSync(dirname)) {
+        fs.mkdirSync(dirname);
+    }
+
+    fs.writeFileSync(dest, JSON.stringify(result, null, '\t'));
+};
+
+if (path.basename(process.argv[1]) === 'build-grammar.js') {
+    exports.update(process.argv[2], process.argv[3]);
+}

tools/vscode.ps1

@@ -0,0 +1,21 @@
+[cmdletbinding(DefaultParameterSetName='Install')]
+param(
+    [Parameter(ParameterSetName='Install')]
+    [switch]$InstallSyntax,
+
+    [Parameter(ParameterSetName='Revert')]
+    [switch]$RevertSyntax
+)
+
+$SyntaxPath = Join-Path $PSScriptRoot "..\syntaxes\powershell.tmLanguage.json"
+
+if ($InstallSyntax) {
+    if (-not(Test-Path $SyntaxPath)) {
+        throw "No syntax to install. Please follow the build steps in the README.md"
+    }
+
+} elseif ($RevertSyntax) {
+
+} else {
+    throw "Please use either -InstallSyntax or -RevertSyntax"
+}