Metadata-Version: 2.4
Name: spf1020
Version: 1.0.48
Summary: Sofia's Python Framework — Windows desktop UI (Giakou Silverfall). Free to use; proprietary — see EULA.txt.
Author: Giakou Silverfall
License: Proprietary — see EULA.txt; free to use, all rights reserved by Giakou Silverfall
Keywords: gui,win32,windows,desktop,ui,framework
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# SPF1020

**Sofia's Python Framework** — a proprietary, **Windows-only** desktop UI library for Python 3.10+.

Built with **ctypes + Win32** (no PyQt, no Qt binaries). **Free to use** for your apps; framework copyright and terms remain with **Giakou Silverfall**. See **`EULA.txt`** in the package.

## Requirements

- Windows 10 or later  
- Python 3.10+

## Install (when published on PyPI)

```bat
pip install spf1020
```

From a source checkout:

```bat
pip install -e .
```

## Minimal example

```python
from spf1020 import Application, LayoutRoot, Window, VBox, Label, Button

app = Application()
window = Window(app, title="Hello SPF1020", width=480, height=320)

root = VBox(padding=16, spacing=12)
root.add(Label(window, 0, 0, 200, 24, text="Hello from Win32."))
root.add(
    Button(window, 0, 0, 120, 32, text="Close", on_click=window.close),
    height=32,
)
LayoutRoot(window, root)
app.run()
```

## What you get

- Layouts (`VBox`, `HBox`, `Grid`, `SplitPane`, `ScrollPane`, …)  
- Widgets (buttons, fields, tables, trees, tabs, images, progress, …)  
- Dialogs (file/folder pickers, messages, color/font, input)  
- Themes, menus, shortcuts (`Action`), system tray, taskbar progress  
- Thread-safe UI updates (`UiBridge`)

Demos and reference shells live in the full repository under `examples/` (not all are shipped inside the wheel).

## License

**Proprietary — not open source.** Use is governed by **`EULA.txt`**. Summary: **`LICENSE`** in the repository root.

You may build and distribute **your own closed-source applications** with SPF1020. You may **not** claim ownership of SPF1020 or redistribute **modified** SPF1020 as your own framework.

## Publishing this package

Maintainers: see **`docs/distribution_checklist.md`** (PyPI section) and **`docs/licensing.md`**.
