Testing

Quick start¶

just test_pytest    # Run the test suite
just test_mypy      # Type-check the Python bindings

Or without just:

pytest                            # from repo root
cd bindings && ./mypy_bindings.sh # mypy

What the test suite covers¶

• tests/lg_imgui_bundle_test.py — Main test file: exercises the litgen binding generation for imgui_bundle.

• bindings/mypy_bindings.sh — Runs mypy on all .pyi stubs to verify type consistency.

GUI tests¶

GUI tests live in tests/tests_python_gui/ and require a display (they open windows). They are not run by default in CI.

To run them locally:

pytest tests/tests_python_gui/

These tests verify:

• Widget rendering (e.g. test_color_edit3_tuple.py)

• RunnerParams identity across Python/C++ boundary (test_runner_params_identity.py)

• Async integration (async/)

Manual smoke testing¶

The most thorough manual test is to run the main demo application, which exercises most libraries:

C++:

cd builds/my_build
./demo_imgui_bundle

Python:

python bindings/imgui_bundle/demos_python/demos_immapp/demo_hello_world.py

CI workflows¶

The project has extensive CI via GitHub Actions (.github/workflows/):

Most workflows trigger on push to main and on pull requests.