lezer/import-tree-sitter
1
0
Fork 0
Code Issues Pull requests Activity
Helps import tree-sitter grammars
14 commits 1 branch 0 tags 175 KiB
  • TypeScript 96.4%
  • JavaScript 3.6%
Find a file
Exact
milahu bb2e87bb73 toRegExp: rename token to expr
2022-12-21 11:28:34 +01:00
src toRegExp: rename token to expr 2022-12-21 11:28:34 +01:00
.gitignore make it build, add cli 2022-12-13 16:46:41 +01:00
LICENSE Add license file 2022-12-13 16:47:58 +01:00
package.json add watch command 2022-12-15 13:16:00 +01:00
README.md add sections, show cli usage 2022-12-15 13:16:00 +01:00
tsconfig.json make it build, add cli 2022-12-13 16:46:41 +01:00

README.md

import-tree-sitter

Utility to help convert grammars written for tree-sitter to Lezer's grammar notation.

Status

This isn't a polished easy-to-use tool, but might help save time when porting a grammar.

Usage

CLI

npm install -g https://github.com/lezer-parser/import-tree-sitter
lezer-import-tree-sitter src/grammar.json >some_language.grammar

API

If you pass the tree-sitter grammar JSON representation (usually in src/grammar.json), as a string, to the buildGrammar function defined in src/import.ts, it'll spit out an equivalent Lezer grammar file.

Limitations

Because tree-sitter's concepts don't all map to Lezer concepts, you'll only get a working, finished grammar for very trivial grammars. Specifically:

  • Precedences are specified in a more fine-grained way in Lezer, so the tool only emits a comment indicating that a precedence was specified, and leaves it to you to put the proper conflict markers in.

  • Tree-sitter's alias expressions are a bit like inline rules, but make the inner rule's name disappear. That's not something you can do in Lezer, so you'll get additional noise in your tree in some cases if you don't further clean up the grammar.