Metadata-Version: 2.4
Name: uui-cuil
Version: 0.3.0
Summary: A lightweight UI framework for Python via ctypes and Win32 API. Now with Direct2D Render!
Author-email: timixess <timofejosa@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/zcveo5/uui-cuil
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.11
Description-Content-Type: text/markdown

uui/cuil is a custom lightweight UI library written in Python using only ctypes. It provides direct interaction with the Windows API without heavy dependencies.

**PULL REQUESTS ARE WELCOME!**

## installation

```
pip install uui-cuil
```
zero dependencies

## Windows backend
#### Autors:
* zcveo5 (i am)
#### Features
* **Lightweight & Fast:** Zero external dependencies, pure Python + ctypes.
* **Frameless Window Support:** Modern borderless windows while keeping native Windows 11 animations, resizing, and shadows.
* **Per-pixel Scroll:** Built-in smooth, pixel-perfect scrolling system.
* **Customizable Render System:** Uses native `gdi32` out of the box, with full support for plugging in your own rendering backend (GDI+, Direct2D, etc.).
* **Low-level Control:** Direct access to `WND_PROCs` and low-level Win32 messages like `WM_MOUSEWHEEL` or `WM_LBUTTONDOWN`.
* **Flexible Event Binding:** Powerful binding system with parsed or raw `wParam` / `lParam` event data exposed directly to your code.

## Limitations:
- now only Windows backend ready, you can write your own and send pull request!
#### Rules for your own backend
- use only built-in libraries
- python 3.13 and newer
- use uui.backend.abstract and Windows backend as base
- form messages to uui.backend.events messages

## Examples:
### Hello world window
```py
import uui

root = uui.Window('Hello World') # Create a window with the title "Hello World"

uui.Label(root,              # Parent (window or another widget)
          'Hello World!',    # Text
          '#000000',         # Color 
          ).pack()

root.start()
```
