Metadata-Version: 2.4
Name: pytigon-gui
Version: 0.261004
Summary: Pytigon GUI
Author-email: Sławomir Chołaj <slawomir.cholaj@gmail.com>
License-Expression: LGPL-2.1-or-later
Project-URL: homepage, https://github.com/pytigon/pytigon-gui
Project-URL: repository, https://github.com/pytigon/pytigon-gui
Project-URL: documentation, https://pytigon-gui.readthedocs.io/
Keywords: pytigon,gui,wxpython,django,desktop,framework
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pytigon-batteries[all]<0.27,>=0.261002
Requires-Dist: wxpython>=4.2.0
Requires-Dist: PyDispatcher>=2.0.5
Requires-Dist: pyshortcuts>=1.8
Requires-Dist: libsass>=0.22
Requires-Dist: pytigon<0.27,>=0.261002
Provides-Extra: dev
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.0; extra == "dev"
Requires-Dist: pre-commit>=3.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Dynamic: license-file

# pytigon-gui

**wxPython desktop frontend for the Pytigon framework** — a rich GUI toolkit that connects to the Django web backend via an embedded HTTP client and WebSocket.

## Key Features

- **Tag-based UI** — Define layouts with an html-like syntax (`<panel>`, `<form>`, `<grid>`) parsed into native wxPython widgets
- **Rich component set** — Frames, notebook tabs, forms, data grids, popups, and modern/classic/tree toolbars
- **Django integration** — Embedded HTTP client + WebSocket bridge for real-time backend communication
- **Signal system** — Event-driven communication between components
- **Cross-platform** — Runs on Linux, Windows, and macOS

## Usage

Install the desktop application:

```
pip install pytigon-gui
ptigw
```

It installs `pytigon-batteries` for you, so the standard projects and the full
web-server package set are available to the embedded Django server. To serve the
same backend without the GUI, install `pytigon-batteries` instead.

For the framework overview, usage examples and full documentation, see the main
[Pytigon](https://github.com/Splawik/pytigon) project.

## Main dependencies

- Python 3.12+
- [wxPython](https://wxpython.org/) 4.x+
- [Django](https://www.djangoproject.com/) >= 6.0
- [pytigon](https://github.com/Splawik/pytigon) (base framework)
- [pytigon-batteries](https://github.com/Splawik/pytigon-batteries) (web-server package set)

## Documentation

Full documentation is available in the [`docs/`](docs/index.md) directory, covering the module architecture, API reference, and usage patterns.

## License

LGPL-2.1 © Sławomir Chołaj
