grug-lang 1.0.4

Make your mods immortal.

grug for Python

This repository provides Python bindings, a frontend, and a backend for grug.

Install this package using pip install grug-lang, and run python -c "import grug" to check it.

A minimal example program is provided in the example/ directory on GitHub:

import grug
import time

state = grug.init()

@state.game_fn
def print_string(string: str):
    print(string)

file = state.compile_grug_file("animals/labrador-Dog.grug")
dog1 = file.create_entity()
dog2 = file.create_entity()

while True:
    state.update()
    dog1.on_bark("woof")
    dog2.on_bark("arf")
    time.sleep(1)

on_bark(sound: string) {
    print_string(sound)

    # Print "arf" a second time
    if sound == "arf" {
        print_string(sound)
    }
}

Run it by cloning the repository, cd-ing into it, running cd example, and finally running python example.py.

Dependencies

This project requires Python version 3.7 or newer. You can manage your Python versions using pyenv.

If you want to run the tests, you'll need to install pytest:

pip install pytest
pip install -e .

If you are on a Python version older than 3.11, you will additionally need to install these:

pip install tomli importlib-metadata

Running the tests

You will need to clone the grug-tests repository next to this repository, and then run git checkout development in it, followed by ./tests.sh.

In this grug-for-python repository, you can then run all tests using this command:

pytest --grug-tests-path=../grug-tests -s

You can additionally pass --whitelisted-test=f32_too_big if you only want to run the test called f32_too_big.

Alternatively, you can walk through the tests and set breakpoints by installing the Python Debugger VS Code extension. Hit F5 to run all tests. You can edit .vscode/launch.json if you want to pass --whitelisted-test=f32_too_big.

Type checking

Run pyright in the terminal to type check the Python code. Pyright can be installed using sudo npm install -g pyright.

Updating the pypi package

python -m pip install --upgrade pip
python -m pip install --upgrade build
python -m build
python -m pip install --upgrade twine
python -m twine upload dist/*