JSPM

  • Created
  • Published
  • Downloads 1062352
  • Score
    100M100P100Q269794F
  • License MIT

VSCode TextMate grammar helpers

Package Exports

  • vscode-textmate

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vscode-textmate) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

VSCode TextMate Build Status Coverage Status

An interpreter for grammar files as defined by TextMate. Supports loading grammar files from JSON or PLIST format. Cross - grammar injections are currently not supported.

Installing

npm install vscode-textmate

Using

var vsctm = require('vscode-textmate');
var grammarPaths = {
    'source.js': './javascript.tmbundle/Syntaxes/JavaScript.plist'
};

var registry = new vsctm.Registry({
    loadGrammar: function (scopeName) {
        var path = grammarPaths[scopeName];
        if (path) {
            return new Promise((c,e) => {
                fs.readFile(path, (error, content) => {
                    if (error) {
                        e(error);
                    } else {
                        var rawGrammar = vsctm.parseRawGrammar(content.toString(), path);
                        c(rawGrammar);
                    }
                });
            });
        }
        return null;
    }
});

// Load the JavaScript grammar and any other grammars included by it async.
registry.loadGrammar('source.js').then(grammar => {
    // at this point `grammar` is available...
    var lineTokens = grammar.tokenizeLine('function add(a,b) { return a+b; }');
    for (var i = 0; i < lineTokens.tokens.length; i++) {
        var token = lineTokens.tokens[i];
        console.log('Token from ' + token.startIndex + ' to ' + token.endIndex + ' with scopes ' + token.scopes);
    }
});

Tokenizing multiple lines

To tokenize multiple lines, you must pass in the previous returned ruleStack.

var ruleStack = null;
for (var i = 0; i < lines.length; i++) {
    var r = grammar.tokenizeLine(lines[i], ruleStack);
    console.log('Line: #' + i + ', tokens: ' + r.tokens);
    ruleStack = r.ruleStack;
}

API doc

See the main.ts file

Developing

  • Clone the repository
  • Run npm install
  • Compile in the background with npm run watch
  • Run tests with npm test
  • Run benchmark with npm run benchmark
  • Troubleshoot a grammar with npm run inspect -- PATH_TO_GRAMMAR PATH_TO_FILE

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

License

MIT