poetry-lark

Lark is an amazing parsing toolkit for Python, built with a focus on ergonomics, performance and modularity. Lark can parse all context-free languages. To put it simply, it means that it is capable of parsing almost any programming language out there, and to some degree most natural languages too.

Lark can generate a stand-alone LALR(1) parser from a grammar. This plugin integrates Lark into the Poetry build system and provides several commands for configuring standalone parsers using pyproject.toml and Poetry.

Install

$ poetry self add poetry-lark

The plugin depends only on Lark and Poetry, but you can use Lark's extra features:

• interegular (if it is installed, Lark uses it to check for collisions, and warn about any conflicts that it can find)
• regex (if you want to use the regex module instead of the re module).

Usage

$ poetry lark-add <module> <grammar-file>
$ poetry lark-remove <module>
$ poetry lark-build <module>

By default, the plugin is integrated into the Poetry build system and generates all parser modules specified in the pyproject.toml (if auto-build option is not configured as false for parser module).

In the simplest case, when adding a parser, you will get:

[[tool.lark.standalone]]
module = "parser"
source = "grammar.lark"

In a more complex case you can use all features of Lark standalone parser:

[[tool.lark.standalone]]
module = {expose = "parser", from = "src", auto-build = true}
source = "grammar.lark"
start = ["start"]
lexer = "contextual"
enable_compress = false
keep_all_tokens = false
propagate_positions = false
use_bytes = false
use_maybe_placeholders = true
use_regex = false
use_strict = false

These options are available on lark-add command: