pbark

Python port of jbark, the dog-themed story programming language.

Semi-automated port: pbark was translated from the Java source. It aims for parity with jbark and shares the same test suite. If behaviour diverges, jbark is canonical.

Release status

V1 is released.

Install

Requires Python 3.10+.

cd pbark
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Run

From the repo root (after install):

./pbark/bin/pbark examples/woof/goodboy.woof
./pbark/bin/pbark --version
./pbark/bin/pbark --list-breeds

Or with the module directly:

python3 -m pbark examples/woof/bimba.woof

Flags match jbark: --help, --version, --strict, --quiet, --list-breeds, --list-objects.

Tests

pip install -e ".[dev]"
pytest tests/ -q

The test suite is ported from jbark's JUnit tests. Golden output, parser shape, and feature coverage.

Docs

• docs/MANUAL.md - grammar and runtime rules
• docs/AUTHOR.md - writing stories
• docs/RELEASE-PYTHON.md - what's done vs what you still do for PyPI
• examples/ - runnable .woof programs