Metadata-Version: 2.5
Name: pyguibud-runtime
Version: 0.1.0
Summary: Load PyGUIbud .ui files at run time and build them with ttkbootstrap, tkinter or PySide6.
Project-URL: Homepage, https://github.com/larrezze-dev/PyGUIbud_CLAUDE
Project-URL: Source, https://github.com/larrezze-dev/PyGUIbud_CLAUDE
Project-URL: Issues, https://github.com/larrezze-dev/PyGUIbud_CLAUDE/issues
Project-URL: Changelog, https://github.com/larrezze-dev/PyGUIbud_CLAUDE/releases
Author: Luciano Arrezze
License-Expression: MIT
License-File: LICENSE
License-File: NOTICE.md
Keywords: gui,loader,pyside6,runtime,tkinter,ttkbootstrap,ui
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Dutch
Classifier: Natural Language :: English
Classifier: Natural Language :: French
Classifier: Natural Language :: German
Classifier: Natural Language :: Italian
Classifier: Natural Language :: Portuguese
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: Natural Language :: Spanish
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: ttkbootstrap<3,>=2.2
Provides-Extra: pyside
Requires-Dist: pyside6>=6.6; extra == 'pyside'
Description-Content-Type: text/markdown

# pyguibud-runtime

The run-time half of [PyGUIbud](https://github.com/larrezze-dev/PyGUIbud_CLAUDE). It loads the
`.ui` files saved by the PyGUIbud designer and builds them with **ttkbootstrap** (default),
**tkinter** or **PySide6**. Applications need only this package, not the designer.

## Install
Python 3.10–3.13. On Linux, install Tk first (`sudo apt install python3-tk`).

```bash
pip install pyguibud-runtime
pip install "pyguibud-runtime[pyside]"   # adds the PySide6 back-end
```

More options (uv, TestPyPI, troubleshooting) are in the
[install guide](https://github.com/larrezze-dev/PyGUIbud_CLAUDE/blob/master/docs/install.md).

## Use
```python
from pyguibud_runtime import load_ui


class Handlers:
    def on_quit(self) -> None:
        ui.destroy()


ui = load_ui("form.ui", Handlers())  # backend="tkinter" or "pyside6" also work
ui.run()
```

`load_ui` validates the file first and raises `pyguibud_runtime.UiError` with a readable reason
when it cannot be built. Its own messages and standard button texts come in the 8 PyGUIbud
languages (for example `lang="de_DE"`).

## Links
- Designer, source and issues: <https://github.com/larrezze-dev/PyGUIbud_CLAUDE>
- Licence: MIT, see [LICENSE](https://github.com/larrezze-dev/PyGUIbud_CLAUDE/blob/master/LICENSE).
  The name and logo are covered by
  [NOTICE.md](https://github.com/larrezze-dev/PyGUIbud_CLAUDE/blob/master/NOTICE.md).

Created by Luciano Arrezze and programmed with the support of Claude Code.
