Skip to main content

This is a fork of PyMeta 0.5.0 that supports Python 2 and 3.

Installation

pip install PyMeta3

Summary

PyMeta is an implementation of OMeta, an object-oriented pattern-matching language developed by Alessandro Warth (http://www.cs.ucla.edu/~awarth/ometa/). PyMeta provides a compact syntax based on Parsing Expression Grammars (PEGs) for common lexing, parsing and tree-transforming activities in a way that’s easy to reason about for Python programmers.

How It Works

PyMeta compiles a grammar to a Python class, with the rules as methods. The rules specify parsing expressions, which consume input and return values if they succeed in matching.

Basic syntax

foo ::= ....

Define a rule named foo.

expr1 expr2

Match expr1, and then match expr2 if it succeeds, returning the value of expr2. Like Python’s and.

expr1 | expr2

Try to match expr1 — if it fails, match expr2 instead. Like Python’s or.

expr*

Match expr zero or more times, returning a list of matches.

expr+

Match expr one or more times, returning a list of matches.

expr?

Try to match expr. Returns None if it fails to match.

~expr

Fail if the next item in the input matches expr.

<ruleName>

Call the rule ruleName.

'x'

Match the literal character ‘x’.

expr:name

Bind the result of expr to the local variable name.

=> pythonExpression

Evaluate the given Python expression and return its result.

Comments like Python comments are supported as well, starting with # and extending to the end of the line.

Interface

The starting point for defining a new grammar is pymeta.grammar.OMeta.makeGrammar, which takes a grammar definition and a dict of variable bindings for its embedded expressions and produces a Python class. Grammars can be subclassed as usual, and makeGrammar can be called on these classes to override rules and provide new ones. To invoke a grammar rule, call grammarObject.apply() with its name.

Example Usage

>>> from pymeta.grammar import OMeta
>>> exampleGrammar = """
ones ::= '1' '1' => 1
twos ::= '2' '2' => 2
stuff ::= (<ones> | <twos>)+
"""
>>> Example = OMeta.makeGrammar(exampleGrammar, {})
>>> g = Example("11221111")
>>> result, error = g.apply("stuff")
>>> result
[1, 2, 1, 1]

Metadata

Release files for PyMeta3-wheel 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for PyMeta3-wheel 0.5.1
File Size Uploaded
pymeta3_wheel-0.5.1.tar.gz 29.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for PyMeta3-wheel 0.5.1
File Interpreter ABI Platform
PyMeta3_wheel-0.5.1-py3-none-any.whl Python 3 none any Details

Total release size: 46.4 kB

Release files / pymeta3_wheel-0.5.1.tar.gz

Download URL pymeta3_wheel-0.5.1.tar.gz
Size 29.9 kB
Tags Source
SHA-256 checksum
How to use checksums
c1261fdf83ac0ef8e42ebde6c10de4ca657ed52e7414bb1a07353076e90db673
BLAKE2b-256 checksum
How to use checksums
85069b339f8396e9bfeaa977cae4765405959e4f7097eb9993ff900c0e9f8cbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.9.20

Release files / PyMeta3_wheel-0.5.1-py3-none-any.whl

Download URL PyMeta3_wheel-0.5.1-py3-none-any.whl
Size 16.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d52cf9e4f4a3ba61ba23a80043e75c0f36820f0db4cf84546a8d6a02c6ceaba2
BLAKE2b-256 checksum
How to use checksums
c84413bd18fa4c349a747081cc7ad17c05b2c6c6ac7b187e8b5de00fce95d068
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.9.20

Release history Release notifications | RSS feed

This release

0.5.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page