plox

This is my python version implementation of crafting interpreter.

Setup

I use uv to manage the environment. To set up the dev environment, just run

uv sync
source .venv/bin/activate

Run

# Start REPL (no args)
python plox.py

# Run a Lox script (positional path)
python plox.py path/to/script.lox

# Enable verbose logs (DEBUG)
python plox.py --verbose path/to/script.lox

Test

pytest -q

Build

pyinstaller --onefile plox.py --name plox --clean

Then you can find the plox executable in folder ./dist.

You can also run the binary with the same conventions:

./dist/plox                 # REPL
./dist/plox script.lox      # Run a file
./dist/plox --verbose file.lox