parsil-peg 0.1.0

A lightweight PEG parser combinator library for Python.

Parsil

A lightweight PEG parser combinator library for Python.

Parsil provides a small set of composable parsing rules for building recursive-descent parsers. It is designed to be simple, readable, and easy to extend.

Features

• Lightweight and dependency-free
• PEG-style parser combinators
• Recursive grammars
• Regular expression support
• Rule composition
• Rule transformation with Map
• Full-input parsing

Installation

pip install parsil

Or install from source:

pip install -e .

Quick Start

from parsil import *

grammar = Grammar()

grammar["number"] = Regex(r"\d+")

parser = Parser(grammar, "123")

print(parser.parse("number"))

Output:

123

Example

from parsil import *

grammar = Grammar()

grammar["word"] = Sequence(
    Literal("hello"),
    Literal(" "),
    Literal("world"),
)

parser = Parser(grammar, "hello world")

print(parser.parse("word"))

Output:

["hello", " ", "world"]

Available Rules

Rule	Description
Literal	Match an exact string
Regex	Match a regular expression
Sequence	Match rules in order
Choice	Match the first successful rule
Repeat	Repeat a rule
Ref	Reference another grammar rule
Map	Transform a matched value

Project Structure

parsil/
├── grammar.py
├── parser.py
├── rules/
│   ├── literal.py
│   ├── regex.py
│   ├── sequence.py
│   ├── choice.py
│   ├── repeat.py
│   ├── ref.py
│   └── map.py
└── examples/
└── tests/

Running Tests

pytest

License

This project is licensed under the MIT License.