barewingui 0.2.0b1__tar.gz

barewingui-0.2.0b1/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bastian Flügel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

barewingui-0.2.0b1/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: barewingui
+Version: 0.2.0b1
+Summary: Pure GUI framework for native Windows apps in Python. No dependencies.
+Keywords: win32,gui,desktop,native,ctypes,zero-dependency,windows
+Author: Bastian Flügel
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Typing :: Typed
+License-File: LICENSE.md
+Project-URL: Homepage, https://bastian-fluegel.de
+Project-URL: Issues, https://github.com/bastian-fluegel/barewingui/issues
+Project-URL: Repository, https://github.com/bastian-fluegel/barewingui
+
+<div align="center">
+<a id="document-title"></a>
+# BareWinGUI
+
+**Pure GUI framework for native Windows apps in Python. No dependencies.**
+
+[🇬🇧 English](#barewingui-en) • [🇩🇪 Deutsch](#barewingui-de)
+
+</div>
+
+---
+
+<a id="barewingui-en"></a>
+## 🇬🇧 BareWinGUI (English)
+
+BareWinGUI is a pure GUI framework for Windows: native windows and controls from Python, with nothing but `ctypes` and the Windows system DLLs. It is the Python successor of the GUI part of AutoIt (`GUICreate`/`GUICtrlCreate`), with a Python-like API and a flexbox-style layout.
+
+[Jump to German Version 🇩🇪](#barewingui-de)
+
+### Key Features
+
+* **No dependencies:** Python standard library only. No wheels, no runtimes.
+* **Native controls only:** standard controls (`user32`) and common controls (`comctl32` v6), themed by Windows. BareWinGUI draws nothing itself: no owner-draw, no custom theme.
+* **Flexbox-style layout:** `VBox`, `HBox`, `Stack`, `Spacer`, options `grow`, `shrink`, `width`, `height`, `min_*`, `max_*`, `align_self`. Built with `with` blocks.
+* **High DPI:** Per-Monitor-V2, all sizes in DIPs, reacts to monitor changes.
+* **Python-like API:** events are handlers without arguments (`on_click=...`, `button.on_click(fn)`), properties instead of getters and setters.
+* **Thread-safe UI updates:** `app.invoke(fn)` and `app.call(fn)`.
+* **Targets:** Windows 10 / 11, Python 3.11+, x64 and x86. The package imports on every platform; creating an `App` needs Windows.
+
+### Installation
+
+```bash
+pip install --pre barewingui   # beta: pip needs --pre for pre-releases
+```
+
+or from source:
+
+```bash
+git clone https://github.com/bastian-fluegel/barewingui.git
+cd barewingui
+pip install -e .
+```
+
+### Quickstart
+
+```python
+from barewingui import App, Button, Label, VBox, Window
+
+app = App()
+with Window("Hello", size=(320, 160)) as win:
+    with VBox(padding=16, gap=10):
+        label = Label("Hello, world!")
+        Button("Click me", on_click=lambda: setattr(label, "text", "Clicked!"))
+app.run()
+```
+
+### What is included
+
+| Area | Classes and functions |
+| --- | --- |
+| Windows | `App`, `Window` (modal windows, shortcuts, `on_close`, `on_resize`) |
+| Layout | `VBox`, `HBox`, `Stack`, `Spacer`, `Flex` |
+| Standard controls | `Label`, `Button`, `CheckBox`, `RadioButton`, `TextBox`, `ComboBox`, `ListBox`, `GroupBox` |
+| Common controls | `ProgressBar`, `Slider`, `SpinBox`, `StatusBar`, `DatePicker`, `TimePicker`, `ListView`, `TreeView`, `TabControl` / `TabPage` |
+| Menus | `MenuBar`, `Menu`, `MenuItem`, `MenuSeparator`, `ContextMenu` (`context_menu=` on any control) |
+| Dialogs | `message_box`, `ask_yes_no`, `show_info`, `show_error`, `input_box`, `open_file`, `save_file`, `pick_folder`, `choose_color`, `choose_font` |
+| Other | `Timer`, `Event`, `Scale` |
+
+### Examples
+
+Run them with `python examples/<file>.py`:
+
+* `01_form.py`: registration form with live validation
+* `02_file_browser.py`: menu, `TreeView` (lazy loading), `ListView`, `StatusBar`
+* `03_settings.py`: settings dialog with tabs, groups, slider, spin box
+* `04_editor.py`: text editor with file dialogs and shortcuts
+* `05_progress.py`: long task in a worker thread, reporting back with `app.invoke`
+
+### Known Limits (Beta)
+
+* Windows only, by design.
+* Standard Windows controls only. Dark mode is not supported (classic controls have no documented dark mode); an experimental mode may follow later.
+* No grid layout yet (`VBox`/`HBox`/`Stack` nest freely).
+* No rich text, no custom-drawn controls, no images in controls yet.
+* The API may still change before 1.0; unstable parts are marked in the docstrings.
+* CI tests real windows on Windows (x64 and x86, Python 3.11 to 3.13) but cannot test mouse and keyboard behavior, native dialogs or multi-monitor DPI changes interactively. Reports from real machines are welcome.
+
+### Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+Logic tests (layout, scaling, shortcuts, dispatch) run everywhere; tests that create real windows run on Windows only and are skipped elsewhere. GitHub Actions runs both.
+
+### Feedback
+
+This is a beta. Please try it and tell me what is missing or broken: [report a bug or give feedback](https://github.com/bastian-fluegel/barewingui/issues/new/choose). Useful details: Windows version, display scaling, Python version, and a small script.
+
+### License
+
+Distributed under the MIT License. See [LICENSE.md](LICENSE.md) for details.
+
+---
+
+<a id="barewingui-de"></a>
+## 🇩🇪 BareWinGUI (Deutsch)
+
+BareWinGUI ist ein reines GUI-Framework für Windows: native Fenster und Steuerelemente aus Python, nur mit `ctypes` und den Windows-Systembibliotheken. Es ist der Python-Nachfolger des GUI-Teils von AutoIt (`GUICreate`/`GUICtrlCreate`), mit Python-typischer API und Flexbox-artigem Layout.
+
+[Switch to English Version 🇬🇧](#barewingui-en)
+
+### Kernmerkmale
+
+* **Keine Abhängigkeiten:** nur die Python-Standardbibliothek.
+* **Nur native Steuerelemente:** Standard-Controls (`user32`) und Common Controls (`comctl32` v6), von Windows gestaltet. BareWinGUI zeichnet nichts selbst.
+* **Flexbox-artiges Layout:** `VBox`, `HBox`, `Stack`, `Spacer` mit `grow`, `shrink`, `width`, `height`, `min_*`, `max_*`, `align_self`, aufgebaut mit `with`-Blöcken.
+* **Hohe DPI:** Per-Monitor-V2, alle Größen in DIPs.
+* **Pythonische API:** Ereignisse sind Handler ohne Argumente (`on_click=...`), Eigenschaften statt Getter/Setter.
+* **Thread-sichere Aktualisierung:** `app.invoke(fn)` und `app.call(fn)`.
+* **Ziele:** Windows 10 / 11, Python 3.11+, x64 und x86. Das Paket lässt sich überall importieren; eine `App` braucht Windows.
+
+### Installation
+
+```bash
+pip install --pre barewingui   # beta: pip needs --pre for pre-releases
+```
+
+### Schnellstart
+
+```python
+from barewingui import App, Button, Label, VBox, Window
+
+app = App()
+with Window("Hello", size=(320, 160)) as win:
+    with VBox(padding=16, gap=10):
+        label = Label("Hello, world!")
+        Button("Click me", on_click=lambda: setattr(label, "text", "Clicked!"))
+app.run()
+```
+
+### Beispiele
+
+Start mit `python examples/<Datei>.py`: Formular mit Prüfung (`01_form.py`), Dateibrowser (`02_file_browser.py`), Einstellungsdialog (`03_settings.py`), Texteditor (`04_editor.py`), Fortschritt mit Arbeitsthread (`05_progress.py`).
+
+### Bekannte Grenzen (Beta)
+
+* Nur Windows, bewusst.
+* Nur Standard-Windows-Controls; kein Dark Mode (später vielleicht experimentell).
+* Noch kein Grid-Layout, kein Rich Text, keine eigengezeichneten Controls.
+* Die API kann sich vor 1.0 noch ändern.
+* Die CI testet echte Fenster unter Windows (x64 und x86, Python 3.11 bis 3.13), aber keine Maus-/Tastaturbedienung, nativen Dialoge oder DPI-Wechsel zwischen Monitoren. Rückmeldungen von echten Rechnern sind willkommen.
+
+### Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+### Rückmeldung
+
+Das ist eine Beta. Probier es aus und sag mir, was fehlt oder kaputt ist: [Fehler melden oder Rückmeldung geben](https://github.com/bastian-fluegel/barewingui/issues/new/choose). Hilfreich: Windows-Version, Skalierung, Python-Version und ein kleines Skript.
+
+### Lizenz
+
+MIT-Lizenz, siehe [LICENSE.md](LICENSE.md).
+

barewingui-0.2.0b1/README.md

@@ -0,0 +1,166 @@
+<div align="center">
+<a id="document-title"></a>
+# BareWinGUI
+
+**Pure GUI framework for native Windows apps in Python. No dependencies.**
+
+[🇬🇧 English](#barewingui-en) • [🇩🇪 Deutsch](#barewingui-de)
+
+</div>
+
+---
+
+<a id="barewingui-en"></a>
+## 🇬🇧 BareWinGUI (English)
+
+BareWinGUI is a pure GUI framework for Windows: native windows and controls from Python, with nothing but `ctypes` and the Windows system DLLs. It is the Python successor of the GUI part of AutoIt (`GUICreate`/`GUICtrlCreate`), with a Python-like API and a flexbox-style layout.
+
+[Jump to German Version 🇩🇪](#barewingui-de)
+
+### Key Features
+
+* **No dependencies:** Python standard library only. No wheels, no runtimes.
+* **Native controls only:** standard controls (`user32`) and common controls (`comctl32` v6), themed by Windows. BareWinGUI draws nothing itself: no owner-draw, no custom theme.
+* **Flexbox-style layout:** `VBox`, `HBox`, `Stack`, `Spacer`, options `grow`, `shrink`, `width`, `height`, `min_*`, `max_*`, `align_self`. Built with `with` blocks.
+* **High DPI:** Per-Monitor-V2, all sizes in DIPs, reacts to monitor changes.
+* **Python-like API:** events are handlers without arguments (`on_click=...`, `button.on_click(fn)`), properties instead of getters and setters.
+* **Thread-safe UI updates:** `app.invoke(fn)` and `app.call(fn)`.
+* **Targets:** Windows 10 / 11, Python 3.11+, x64 and x86. The package imports on every platform; creating an `App` needs Windows.
+
+### Installation
+
+```bash
+pip install --pre barewingui   # beta: pip needs --pre for pre-releases
+```
+
+or from source:
+
+```bash
+git clone https://github.com/bastian-fluegel/barewingui.git
+cd barewingui
+pip install -e .
+```
+
+### Quickstart
+
+```python
+from barewingui import App, Button, Label, VBox, Window
+
+app = App()
+with Window("Hello", size=(320, 160)) as win:
+    with VBox(padding=16, gap=10):
+        label = Label("Hello, world!")
+        Button("Click me", on_click=lambda: setattr(label, "text", "Clicked!"))
+app.run()
+```
+
+### What is included
+
+| Area | Classes and functions |
+| --- | --- |
+| Windows | `App`, `Window` (modal windows, shortcuts, `on_close`, `on_resize`) |
+| Layout | `VBox`, `HBox`, `Stack`, `Spacer`, `Flex` |
+| Standard controls | `Label`, `Button`, `CheckBox`, `RadioButton`, `TextBox`, `ComboBox`, `ListBox`, `GroupBox` |
+| Common controls | `ProgressBar`, `Slider`, `SpinBox`, `StatusBar`, `DatePicker`, `TimePicker`, `ListView`, `TreeView`, `TabControl` / `TabPage` |
+| Menus | `MenuBar`, `Menu`, `MenuItem`, `MenuSeparator`, `ContextMenu` (`context_menu=` on any control) |
+| Dialogs | `message_box`, `ask_yes_no`, `show_info`, `show_error`, `input_box`, `open_file`, `save_file`, `pick_folder`, `choose_color`, `choose_font` |
+| Other | `Timer`, `Event`, `Scale` |
+
+### Examples
+
+Run them with `python examples/<file>.py`:
+
+* `01_form.py`: registration form with live validation
+* `02_file_browser.py`: menu, `TreeView` (lazy loading), `ListView`, `StatusBar`
+* `03_settings.py`: settings dialog with tabs, groups, slider, spin box
+* `04_editor.py`: text editor with file dialogs and shortcuts
+* `05_progress.py`: long task in a worker thread, reporting back with `app.invoke`
+
+### Known Limits (Beta)
+
+* Windows only, by design.
+* Standard Windows controls only. Dark mode is not supported (classic controls have no documented dark mode); an experimental mode may follow later.
+* No grid layout yet (`VBox`/`HBox`/`Stack` nest freely).
+* No rich text, no custom-drawn controls, no images in controls yet.
+* The API may still change before 1.0; unstable parts are marked in the docstrings.
+* CI tests real windows on Windows (x64 and x86, Python 3.11 to 3.13) but cannot test mouse and keyboard behavior, native dialogs or multi-monitor DPI changes interactively. Reports from real machines are welcome.
+
+### Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+Logic tests (layout, scaling, shortcuts, dispatch) run everywhere; tests that create real windows run on Windows only and are skipped elsewhere. GitHub Actions runs both.
+
+### Feedback
+
+This is a beta. Please try it and tell me what is missing or broken: [report a bug or give feedback](https://github.com/bastian-fluegel/barewingui/issues/new/choose). Useful details: Windows version, display scaling, Python version, and a small script.
+
+### License
+
+Distributed under the MIT License. See [LICENSE.md](LICENSE.md) for details.
+
+---
+
+<a id="barewingui-de"></a>
+## 🇩🇪 BareWinGUI (Deutsch)
+
+BareWinGUI ist ein reines GUI-Framework für Windows: native Fenster und Steuerelemente aus Python, nur mit `ctypes` und den Windows-Systembibliotheken. Es ist der Python-Nachfolger des GUI-Teils von AutoIt (`GUICreate`/`GUICtrlCreate`), mit Python-typischer API und Flexbox-artigem Layout.
+
+[Switch to English Version 🇬🇧](#barewingui-en)
+
+### Kernmerkmale
+
+* **Keine Abhängigkeiten:** nur die Python-Standardbibliothek.
+* **Nur native Steuerelemente:** Standard-Controls (`user32`) und Common Controls (`comctl32` v6), von Windows gestaltet. BareWinGUI zeichnet nichts selbst.
+* **Flexbox-artiges Layout:** `VBox`, `HBox`, `Stack`, `Spacer` mit `grow`, `shrink`, `width`, `height`, `min_*`, `max_*`, `align_self`, aufgebaut mit `with`-Blöcken.
+* **Hohe DPI:** Per-Monitor-V2, alle Größen in DIPs.
+* **Pythonische API:** Ereignisse sind Handler ohne Argumente (`on_click=...`), Eigenschaften statt Getter/Setter.
+* **Thread-sichere Aktualisierung:** `app.invoke(fn)` und `app.call(fn)`.
+* **Ziele:** Windows 10 / 11, Python 3.11+, x64 und x86. Das Paket lässt sich überall importieren; eine `App` braucht Windows.
+
+### Installation
+
+```bash
+pip install --pre barewingui   # beta: pip needs --pre for pre-releases
+```
+
+### Schnellstart
+
+```python
+from barewingui import App, Button, Label, VBox, Window
+
+app = App()
+with Window("Hello", size=(320, 160)) as win:
+    with VBox(padding=16, gap=10):
+        label = Label("Hello, world!")
+        Button("Click me", on_click=lambda: setattr(label, "text", "Clicked!"))
+app.run()
+```
+
+### Beispiele
+
+Start mit `python examples/<Datei>.py`: Formular mit Prüfung (`01_form.py`), Dateibrowser (`02_file_browser.py`), Einstellungsdialog (`03_settings.py`), Texteditor (`04_editor.py`), Fortschritt mit Arbeitsthread (`05_progress.py`).
+
+### Bekannte Grenzen (Beta)
+
+* Nur Windows, bewusst.
+* Nur Standard-Windows-Controls; kein Dark Mode (später vielleicht experimentell).
+* Noch kein Grid-Layout, kein Rich Text, keine eigengezeichneten Controls.
+* Die API kann sich vor 1.0 noch ändern.
+* Die CI testet echte Fenster unter Windows (x64 und x86, Python 3.11 bis 3.13), aber keine Maus-/Tastaturbedienung, nativen Dialoge oder DPI-Wechsel zwischen Monitoren. Rückmeldungen von echten Rechnern sind willkommen.
+
+### Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+### Rückmeldung
+
+Das ist eine Beta. Probier es aus und sag mir, was fehlt oder kaputt ist: [Fehler melden oder Rückmeldung geben](https://github.com/bastian-fluegel/barewingui/issues/new/choose). Hilfreich: Windows-Version, Skalierung, Python-Version und ein kleines Skript.
+
+### Lizenz
+
+MIT-Lizenz, siehe [LICENSE.md](LICENSE.md).

barewingui-0.2.0b1/barewingui/__init__.py

@@ -0,0 +1,114 @@
+"""
+barewingui
+~~~~~~~~~~
+Native Windows GUIs for Python: real Win32 controls, flexbox-style layout, no dependencies.
+
+Beta (0.2.0b1). Importable everywhere; creating an App needs Windows.
+"""
+
+from __future__ import annotations
+
+from barewingui.app import App
+from barewingui.dpi import Scale
+from barewingui.controls import (
+    Button,
+    CheckBox,
+    ComboBox,
+    DatePicker,
+    GroupBox,
+    Label,
+    ListBox,
+    ListView,
+    ProgressBar,
+    RadioButton,
+    Slider,
+    SpinBox,
+    StatusBar,
+    TabControl,
+    TabPage,
+    TextBox,
+    TextInput,
+    TimePicker,
+    TreeNode,
+    TreeView,
+)
+from barewingui.dialogs import (
+    FontChoice,
+    ask_ok_cancel,
+    ask_yes_no,
+    choose_color,
+    choose_font,
+    input_box,
+    message_box,
+    open_file,
+    pick_folder,
+    save_file,
+    show_error,
+    show_info,
+    show_warning,
+)
+from barewingui.errors import BareWinGUIError, LayoutError, PlatformError
+from barewingui.events import Event
+from barewingui.menu import ContextMenu, Menu, MenuBar, MenuItem, MenuSeparator
+from barewingui.layout import Flex, HBox, Rect, Size, Spacer, Stack, VBox
+from barewingui.timer import Timer
+from barewingui.window import Window
+
+__version__ = "0.2.0b1"
+
+__all__ = [
+    "App",
+    "FontChoice",
+    "ask_ok_cancel",
+    "ask_yes_no",
+    "choose_color",
+    "choose_font",
+    "input_box",
+    "message_box",
+    "open_file",
+    "pick_folder",
+    "save_file",
+    "show_error",
+    "show_info",
+    "show_warning",
+    "ContextMenu",
+    "Menu",
+    "MenuBar",
+    "MenuItem",
+    "MenuSeparator",
+    "Timer",
+    "BareWinGUIError",
+    "Button",
+    "CheckBox",
+    "ComboBox",
+    "DatePicker",
+    "Event",
+    "GroupBox",
+    "Label",
+    "ListBox",
+    "ListView",
+    "ProgressBar",
+    "RadioButton",
+    "Slider",
+    "SpinBox",
+    "StatusBar",
+    "TabControl",
+    "TabPage",
+    "TextBox",
+    "TextInput",
+    "TimePicker",
+    "TreeNode",
+    "TreeView",
+    "Flex",
+    "HBox",
+    "LayoutError",
+    "PlatformError",
+    "Rect",
+    "Scale",
+    "Size",
+    "Spacer",
+    "Stack",
+    "VBox",
+    "Window",
+    "__version__",
+]