Metadata-Version: 2.4
Name: FluentQt
Version: 1.7.0
Summary: Native PySide6 bindings for the Fluent-Qt C++ Qt Widgets library
Author: calvinhxx
License-Expression: MIT
Keywords: Qt,PySide6,Fluent Design,WinUI,widgets
Requires-Python: >=3.11,<3.14
Requires-Dist: PySide6-Essentials (==6.9.3)
Requires-Dist: shiboken6 (==6.9.3)
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://calvinhxx.github.io/Fluent-Qt/
Project-URL: Documentation, https://github.com/calvinhxx/Fluent-Qt#readme
Project-URL: Repository, https://github.com/calvinhxx/Fluent-Qt
Project-URL: Issues, https://github.com/calvinhxx/Fluent-Qt/issues
Project-URL: Changelog, https://github.com/calvinhxx/Fluent-Qt/releases
Project-URL: Gallery, https://pypi.org/project/FluentQt-Gallery/
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: C++
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 :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Typing :: Typed
License-File: LICENSE
License-File: THIRD_PARTY_NOTICES.md
License-File: TRADEMARKS.md

# FluentQt for Python

FluentQt is the official PySide6 compatibility distribution for
[Fluent-Qt](https://github.com/calvinhxx/Fluent-Qt), a cross-platform
Fluent / WinUI-style C++ component library built on Qt Widgets. The widgets
remain native C++ objects; Shiboken6 exposes the same implementation to Python
instead of reimplementing the UI library.

The C++ library remains the primary project. Python support is optional and
targets Qt 6.

## Install

```bash
python -m pip install FluentQt
```

Published wheels install the matching `PySide6-Essentials` and `shiboken6`
runtime automatically.

## Minimal example

```python
import sys

import fluentqt
from PySide6.QtCore import Qt
from PySide6.QtWidgets import QApplication, QVBoxLayout, QWidget
from fluentqt.basicinput import Button
from fluentqt.windowing import Window


fluentqt.prepare_high_dpi_application()
app = QApplication(sys.argv)
fluentqt.initialize_resources()
app.setFont(fluentqt.font_for_role(fluentqt.FontRole.Body))

window = Window()
window.setWindowTitle("FluentQt Hello World")
window.resize(480, 320)

content = QWidget()
layout = QVBoxLayout(content)
button = Button("Hello from FluentQt", content)
button.setFluentStyle(Button.ButtonStyle.Accent)
layout.addWidget(button, 0, Qt.AlignCenter)

window.setContentWidget(content)
window.show()
sys.exit(app.exec())
```

## Package contents

- Native Qt Widgets with the Fluent design contract and Light/Dark themes.
- Qt properties, signals, enums, Python subclassing, and typed package stubs.
- Explicit ownership contracts for hosted widgets, overlays, models, and
  native windows.
- A single `_fluentqt` extension so themes, resources, and Qt object identity
  stay process-wide.

The example application is distributed separately as
[`FluentQt-Gallery`](https://pypi.org/project/FluentQt-Gallery/), keeping demo
code and assets out of the reusable UI library wheel.

## Compatibility

Official wheels target CPython 3.11–3.13 with matched Qt, PySide6, and
Shiboken6 6.9.3 runtimes.

| Platform | Architectures |
| --- | --- |
| Windows | x64, ARM64 |
| macOS 12+ | x64, ARM64 |
| Linux | x64; ARM64 for CPython 3.12–3.13 |

The source binding keeps Qt/PySide/Shiboken 6.2.4 as its minimum compatibility
baseline. All Qt for Python components and the C++ Qt SDK must use the same
version and architecture.

## Project links

- [Documentation](https://github.com/calvinhxx/Fluent-Qt#readme)
- [Source](https://github.com/calvinhxx/Fluent-Qt)
- [Issue tracker](https://github.com/calvinhxx/Fluent-Qt/issues)
- [Release notes](https://github.com/calvinhxx/Fluent-Qt/releases)
- [Project website](https://calvinhxx.github.io/Fluent-Qt/)

FluentQt is released under the MIT License. Microsoft product names and Fluent
design references are used only to describe compatibility and visual style.
