pbark 🐶

A dog-themed story programming language for Python.

pbark is the Python port of jbark, the original Java implementation.

pbark aims for feature parity with jbark and shares the same test suite. If behaviour differs, jbark is considered the canonical implementation.

Installation

Install pbark from PyPI:

pip install pbark

Quick start

Create a file called goodgirl.woof:

I have a labrador.
She has 2 toys.
Her name is "Bimba".
she barks how many toys she has

Run it:

pbark goodgirl.woof

Commands

Show version:

pbark --version

Show help:

pbark --help

List available breeds:

pbark --list-breeds

List available objects:

pbark --list-objects

Available flags:

• --help
• --version
• --strict
• --quiet
• --list-breeds
• --list-objects

Python module usage

pbark can also be executed as a Python module:

python -m pbark examples/woof/goodgirl.woof

Development

Clone the repository:

git clone https://github.com/AlexH89/bark
cd pbark

Create a virtual environment:

python3 -m venv .venv

Activate it:

Linux/macOS:

source .venv/bin/activate

Windows:

.venv\Scripts\activate

Install development dependencies:

pip install -e ".[dev]"

Run tests:

pytest tests/ -q

The test suite is ported from jbark's JUnit tests and verifies parser behaviour, runtime behaviour, and compatibility.

Documentation

See https://github.com/AlexH89/bark.

Examples

Runnable .woof programs are available in the GitHub repository as well.

Related project

pbark is the Python port of jbark, the original Java implementation.