dynamicsyntax

dynamicsyntax is the python implementation of DyLan the Dynamic Syntax parser. It has been (vibe) translated from Java to Python by @incrementaliser, and is still under development.

Installation

You need uv and a Python that satisfies >=3.11.

1. Create a virtual environment with a fixed Python version (run this in the directory where you want .venv, e.g. the repo root for a clone):

 uv venv --python 3.11 # or 3.12 or 3.13

2. Activate it. On Linux or macOS:

 source .venv/bin/activate

On Windows, use .venv\Scripts\activate (cmd) or .\.venv\Scripts\Activate.ps1 (PowerShell). 3. Install into that environment, using the published package from PyPI:

 uv pip install dynamicsyntax

Examples

For some code examples of how to use the parser in action, check out this notebook: Open In Colab

Quickstart

import dynamicsyntax as ds

p = ds.parse("a man knows you", "ttr")
print(p.semantics)  # TTR semantics based on the default grammar/lexicon
print(p.vis())      # Visualise the parse tree

Get Involved

Contributions (issues, PRs, donations (spent on coffee/LLM credits!)) are very welcome! Please see CONTRIBUTING.md for more details.

Note Since this project has been translated using Cursor and tested only on Windows, there is a small chance errors exist. I would be grateful if you could report them to me through the above channels. Although, it is important to mention that some of the most critical methods here have been verified via unit tests, so there is a high chance the migration from Java has been correct so far.