Skip to content

Latest commit

 

History

History
28 lines (16 loc) · 1.21 KB

README.md

File metadata and controls

28 lines (16 loc) · 1.21 KB

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.