pyside-quasar 0.2.0__tar.gz

pyside_quasar-0.2.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: pyside-quasar
+Version: 0.2.0
+Summary: The Quasar Framework for PySide — Material Design components, pure QPainter, zero QSS.
+Author-email: eagleye-china <zdt168@sina.cn>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eagleye-china/pyside-quasar
+Project-URL: Documentation, https://eagleye-china.github.io/pyside-quasar
+Project-URL: Repository, https://github.com/eagleye-china/pyside-quasar
+Project-URL: Issues, https://github.com/eagleye-china/pyside-quasar/issues
+Project-URL: Changelog, https://github.com/eagleye-china/pyside-quasar/blob/main/CHANGELOG.md
+Keywords: pyside6,qt6,material-design,quasar,ui-framework,desktop,qpainter,pyside
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+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 :: User Interfaces
+Classifier: Topic :: Desktop Environment
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PySide6>=6.6
+Requires-Dist: typing-extensions>=4.0; python_version < "3.13"
+Provides-Extra: test
+Requires-Dist: pytest>=7.4; extra == "test"
+Requires-Dist: pytest-qt>=4.2; extra == "test"
+Requires-Dist: pytest-cov>=4.1; extra == "test"
+Provides-Extra: lint
+Requires-Dist: mypy>=1.5; extra == "lint"
+Requires-Dist: ruff>=0.7.0; extra == "lint"
+Requires-Dist: pre-commit>=3.4; extra == "lint"
+Requires-Dist: import-linter>=2.0; extra == "lint"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.4; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+Requires-Dist: mkdocs-gen-files>=0.5; extra == "docs"
+Provides-Extra: build
+Requires-Dist: nuitka>=2.4; extra == "build"
+Provides-Extra: dev
+Requires-Dist: pyside-quasar[build,docs,lint,test]; extra == "dev"
+
+# PySide-Quasar ⚛️
+
+> **Enterprise-grade UI components for PySide. Quasar aesthetics, Pure QPainter, Zero QSS.**
+
+**English** | [简体中文](README_zh.md)
+
+[![PyPI version](https://img.shields.io/pypi/v/pyside-quasar?color=blue&label=PyPI)](https://pypi.org/project/pyside-quasar/)
+[![Python Version](https://img.shields.io/pypi/pyversions/pyside-quasar)](https://pypi.org/project/pyside-quasar/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/eagleye-china/pyside-quasar?style=social)](https://github.com/eagleye-china/pyside-quasar)
+
+**PySide-Quasar** is a modern, enterprise-grade UI component framework for PySide. Inspired by the design language of Vue's *Quasar Framework*, it brings Material Design aesthetics to desktop applications using **pure `QPainter` rendering** with **ZERO QSS (Qt Style Sheets) dependencies**. 
+
+It eliminates the common pain points of QSS—such as cross-platform rendering inconsistencies, performance bottlenecks, and style breakages—making it the perfect choice for industrial control panels, monitoring dashboards, and complex enterprise desktop clients.
+
+---
+
+## 📸 Gallery
+
+> 💡 *Here is a preview of the core components. (Replace the image URLs below with your actual GIFs!)*
+
+| Components | Showcase |
+| :---: | :---: |
+| **Buttons & Checkboxes** | <img src="https://via.placeholder.com/600x300/1E1E1E/D4D4D4?text=Buttons+and+Checkboxes+GIF" alt="Buttons and Checkboxes" width="400"/> |
+| **Dialogs & Badges** | <img src="https://via.placeholder.com/600x300/1E1E1E/D4D4D4?text=Dialog+and+Badge+GIF" alt="Dialog and Badge" width="400"/> |
+
+---
+
+## 🤔 Why PySide-Quasar? (The "Zero QSS" Philosophy)
+
+Traditional PySide/PyQt applications rely heavily on QSS. While fine for small apps, QSS scales poorly in enterprise systems. Here is why we went completely QSS-free:
+
+| Feature | Traditional QSS Approach | **PySide-Quasar (Our Approach)** |
+| :--- | :--- | :--- |
+| **Rendering** | OS-dependent, often buggy with complex gradients. | **Pixel-perfect** across Windows, macOS, and Linux. |
+| **Performance** | High CPU usage during rapid updates (e.g., industrial data). | **Blazing fast** with optimized native `QPainter`. |
+| **High-DPI (4K)** | Blurry borders, broken scaling, jagged edges. | **Crisp & Sharp** automatically adapts to devicePixelRatio. |
+| **Maintenance** | Hundreds of lines of unstructured CSS-like strings. | **Clean Python** with strongly-typed APIs and theme engines. |
+| **PySide7/8 Future**| Style breakages requiring extensive rewrites. | **Future-proof**, seamlessly migrates to future PySide versions. |
+
+---
+
+## ✨ Core Features
+
+- 🚀 **Zero QSS Dependency** – Everything is drawn natively via `QPainter`.
+- 🧩 **Quasar-Inspired Design** – Beautiful Material Design components with smooth micro-animations.
+- 🔮 **Future-Proof API** – Built on an abstraction layer. Currently binds to `PySide6`, but fully prepared for `PySide7/8`.
+- 🖥️ **4K / Retina Ready** – Deeply optimized for High-DPI screens. No more blurry icons or jagged lines.
+- 🎨 **Dynamic Theme Engine** – Native Light/Dark mode support. Automatic high-contrast text calculation.
+- 🛡️ **Enterprise-Grade Typed** – 100% Type hints. Perfect for PyCharm/VSCode intellisense and strict CI pipelines.
+- 📦 **Lightweight & Packable** – No WebViews, no heavy assets. Very friendly for `PyInstaller`.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install pyside-quasar
+```
+
+**Dependencies:**
+- `PySide6 >= 6.6.0`
+- `typing-extensions`
+
+---
+
+## 🚀 Quick Start
+
+```python
+import sys
+from PySide6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout
+from pyside_quasar.components import Button, Checkbox, Dialog
+from pyside_quasar.theme import QuasarTheme
+
+if __name__ == "__main__":
+    app = QApplication(sys.argv)
+    
+    # 1. Apply Dark Theme (Native rendering)
+    QuasarTheme.apply_dark()
+
+    # 2. Create your main window
+    win = QMainWindow()
+    win.resize(800, 600)
+    win.setWindowTitle("PySide-Quasar Demo")
+
+    # 3. Use pure QPainter components
+    central = QWidget()
+    layout = QVBoxLayout(central)
+    
+    btn = Button(text="Open Dialog", color="primary", size="lg")
+    chk = Checkbox(text="Enable Advanced Settings", checked=True)
+    
+    layout.addWidget(btn)
+    layout.addWidget(chk)
+    win.setCentralWidget(central)
+    
+    win.show()
+    sys.exit(app.exec())
+```
+
+---
+
+## 🧩 Components Ecosystem
+
+We are actively expanding the ecosystem. Here is the current status:
+
+| Module | Stable Components | In Development |
+| :--- | :--- | :--- |
+| **Primitives** | `Button`, `Checkbox`, `Avatar`, `Badge` | `Input`, `Switch`, `Select` |
+| **Containers** | `Dialog` | `Card`, `Tabs`, `Drawer` |
+| **Feedback** | - | `Toast`, `Notify`, `Progress` |
+| **Data** | - | `Table`, `Pagination` |
+
+---
+
+## 🎨 Theming System
+
+Say goodbye to messy stylesheets. Control your entire app's look with Python.
+
+```python
+from pyside_quasar.theme import QuasarTheme
+
+# 1. Toggle Light/Dark mode
+QuasarTheme.apply_light()
+QuasarTheme.apply_dark()
+
+# 2. Set your enterprise brand color
+QuasarTheme.set_brand_color("#1976D2")
+
+# 3. Global border radius configuration
+QuasarTheme.set_border_radius(6)
+```
+
+---
+
+## 📐 Roadmap & Version Strategy
+
+Because our package name **`pyside-quasar`** does not contain a version number, you are protected from ecosystem churn.
+
+- **`v1.x`** – Active development, binding to **PySide6**.
+- **`v2.x`** – Seamless transition to **PySide7** (Zero code changes for UI layers).
+- **`v3.x`** – Future-ready for **PySide8**.
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions from the global community! Whether it's a bug report, a new component, or a documentation fix, your help is appreciated.
+
+```bash
+# Clone the repository
+git clone https://github.com/eagleye-china/pyside-quasar.git
+cd pyside-quasar
+
+# Install in editable mode for development
+pip install -e .
+
+# Build the package
+python -m build
+```
+
+If you find this project useful, please consider giving it a ⭐️ on GitHub! It means a lot to us.
+
+---
+
+## 📜 License
+
+MIT License. Commercial use is allowed. See the [LICENSE](LICENSE) file for details.

pyside_quasar-0.2.0/README.md

@@ -0,0 +1,168 @@
+# PySide-Quasar ⚛️
+
+> **Enterprise-grade UI components for PySide. Quasar aesthetics, Pure QPainter, Zero QSS.**
+
+**English** | [简体中文](README_zh.md)
+
+[![PyPI version](https://img.shields.io/pypi/v/pyside-quasar?color=blue&label=PyPI)](https://pypi.org/project/pyside-quasar/)
+[![Python Version](https://img.shields.io/pypi/pyversions/pyside-quasar)](https://pypi.org/project/pyside-quasar/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/eagleye-china/pyside-quasar?style=social)](https://github.com/eagleye-china/pyside-quasar)
+
+**PySide-Quasar** is a modern, enterprise-grade UI component framework for PySide. Inspired by the design language of Vue's *Quasar Framework*, it brings Material Design aesthetics to desktop applications using **pure `QPainter` rendering** with **ZERO QSS (Qt Style Sheets) dependencies**. 
+
+It eliminates the common pain points of QSS—such as cross-platform rendering inconsistencies, performance bottlenecks, and style breakages—making it the perfect choice for industrial control panels, monitoring dashboards, and complex enterprise desktop clients.
+
+---
+
+## 📸 Gallery
+
+> 💡 *Here is a preview of the core components. (Replace the image URLs below with your actual GIFs!)*
+
+| Components | Showcase |
+| :---: | :---: |
+| **Buttons & Checkboxes** | <img src="https://via.placeholder.com/600x300/1E1E1E/D4D4D4?text=Buttons+and+Checkboxes+GIF" alt="Buttons and Checkboxes" width="400"/> |
+| **Dialogs & Badges** | <img src="https://via.placeholder.com/600x300/1E1E1E/D4D4D4?text=Dialog+and+Badge+GIF" alt="Dialog and Badge" width="400"/> |
+
+---
+
+## 🤔 Why PySide-Quasar? (The "Zero QSS" Philosophy)
+
+Traditional PySide/PyQt applications rely heavily on QSS. While fine for small apps, QSS scales poorly in enterprise systems. Here is why we went completely QSS-free:
+
+| Feature | Traditional QSS Approach | **PySide-Quasar (Our Approach)** |
+| :--- | :--- | :--- |
+| **Rendering** | OS-dependent, often buggy with complex gradients. | **Pixel-perfect** across Windows, macOS, and Linux. |
+| **Performance** | High CPU usage during rapid updates (e.g., industrial data). | **Blazing fast** with optimized native `QPainter`. |
+| **High-DPI (4K)** | Blurry borders, broken scaling, jagged edges. | **Crisp & Sharp** automatically adapts to devicePixelRatio. |
+| **Maintenance** | Hundreds of lines of unstructured CSS-like strings. | **Clean Python** with strongly-typed APIs and theme engines. |
+| **PySide7/8 Future**| Style breakages requiring extensive rewrites. | **Future-proof**, seamlessly migrates to future PySide versions. |
+
+---
+
+## ✨ Core Features
+
+- 🚀 **Zero QSS Dependency** – Everything is drawn natively via `QPainter`.
+- 🧩 **Quasar-Inspired Design** – Beautiful Material Design components with smooth micro-animations.
+- 🔮 **Future-Proof API** – Built on an abstraction layer. Currently binds to `PySide6`, but fully prepared for `PySide7/8`.
+- 🖥️ **4K / Retina Ready** – Deeply optimized for High-DPI screens. No more blurry icons or jagged lines.
+- 🎨 **Dynamic Theme Engine** – Native Light/Dark mode support. Automatic high-contrast text calculation.
+- 🛡️ **Enterprise-Grade Typed** – 100% Type hints. Perfect for PyCharm/VSCode intellisense and strict CI pipelines.
+- 📦 **Lightweight & Packable** – No WebViews, no heavy assets. Very friendly for `PyInstaller`.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install pyside-quasar
+```
+
+**Dependencies:**
+- `PySide6 >= 6.6.0`
+- `typing-extensions`
+
+---
+
+## 🚀 Quick Start
+
+```python
+import sys
+from PySide6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout
+from pyside_quasar.components import Button, Checkbox, Dialog
+from pyside_quasar.theme import QuasarTheme
+
+if __name__ == "__main__":
+    app = QApplication(sys.argv)
+    
+    # 1. Apply Dark Theme (Native rendering)
+    QuasarTheme.apply_dark()
+
+    # 2. Create your main window
+    win = QMainWindow()
+    win.resize(800, 600)
+    win.setWindowTitle("PySide-Quasar Demo")
+
+    # 3. Use pure QPainter components
+    central = QWidget()
+    layout = QVBoxLayout(central)
+    
+    btn = Button(text="Open Dialog", color="primary", size="lg")
+    chk = Checkbox(text="Enable Advanced Settings", checked=True)
+    
+    layout.addWidget(btn)
+    layout.addWidget(chk)
+    win.setCentralWidget(central)
+    
+    win.show()
+    sys.exit(app.exec())
+```
+
+---
+
+## 🧩 Components Ecosystem
+
+We are actively expanding the ecosystem. Here is the current status:
+
+| Module | Stable Components | In Development |
+| :--- | :--- | :--- |
+| **Primitives** | `Button`, `Checkbox`, `Avatar`, `Badge` | `Input`, `Switch`, `Select` |
+| **Containers** | `Dialog` | `Card`, `Tabs`, `Drawer` |
+| **Feedback** | - | `Toast`, `Notify`, `Progress` |
+| **Data** | - | `Table`, `Pagination` |
+
+---
+
+## 🎨 Theming System
+
+Say goodbye to messy stylesheets. Control your entire app's look with Python.
+
+```python
+from pyside_quasar.theme import QuasarTheme
+
+# 1. Toggle Light/Dark mode
+QuasarTheme.apply_light()
+QuasarTheme.apply_dark()
+
+# 2. Set your enterprise brand color
+QuasarTheme.set_brand_color("#1976D2")
+
+# 3. Global border radius configuration
+QuasarTheme.set_border_radius(6)
+```
+
+---
+
+## 📐 Roadmap & Version Strategy
+
+Because our package name **`pyside-quasar`** does not contain a version number, you are protected from ecosystem churn.
+
+- **`v1.x`** – Active development, binding to **PySide6**.
+- **`v2.x`** – Seamless transition to **PySide7** (Zero code changes for UI layers).
+- **`v3.x`** – Future-ready for **PySide8**.
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions from the global community! Whether it's a bug report, a new component, or a documentation fix, your help is appreciated.
+
+```bash
+# Clone the repository
+git clone https://github.com/eagleye-china/pyside-quasar.git
+cd pyside-quasar
+
+# Install in editable mode for development
+pip install -e .
+
+# Build the package
+python -m build
+```
+
+If you find this project useful, please consider giving it a ⭐️ on GitHub! It means a lot to us.
+
+---
+
+## 📜 License
+
+MIT License. Commercial use is allowed. See the [LICENSE](LICENSE) file for details.

pyside_quasar-0.2.0/pyproject.toml

@@ -0,0 +1,180 @@
+[build-system]
+requires = ["setuptools>=68.2", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyside-quasar"
+version = "0.2.0"
+description = "The Quasar Framework for PySide — Material Design components, pure QPainter, zero QSS."
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "eagleye-china", email = "zdt168@sina.cn" },
+]
+
+keywords = [
+    "pyside6", "qt6", "material-design", "quasar",
+    "ui-framework", "desktop", "qpainter", "pyside"
+]
+classifiers = [
+    "Development Status :: 4 - Beta", # 建议从 Alpha 改为 Beta，更显成熟
+    "Environment :: X11 Applications :: Qt",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: MacOS X",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Desktop Environment",
+    "Typing :: Typed",
+]
+dependencies = [
+    "PySide6>=6.6",
+    "typing-extensions>=4.0; python_version<'3.13'",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.4",
+    "pytest-qt>=4.2",
+    "pytest-cov>=4.1",
+]
+lint = [
+    "mypy>=1.5",
+    "ruff>=0.7.0",
+    "pre-commit>=3.4",
+    "import-linter>=2.0",
+]
+docs = [
+    "mkdocs-material>=9.4",
+    "mkdocstrings[python]>=0.24",
+    "mkdocs-gen-files>=0.5",
+]
+build = [
+    "nuitka>=2.4",
+]
+dev = [
+    "pyside-quasar[test,lint,docs,build]",
+]
+
+[project.urls]
+Homepage = "https://github.com/eagleye-china/pyside-quasar"
+Documentation = "https://eagleye-china.github.io/pyside-quasar"
+Repository = "https://github.com/eagleye-china/pyside-quasar"
+Issues = "https://github.com/eagleye-china/pyside-quasar/issues"
+Changelog = "https://github.com/eagleye-china/pyside-quasar/blob/main/CHANGELOG.md" # 注意：现在 GitHub 默认分支多为 master
+
+# ================= src-layout 打包配置 =================
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+# ✅ 核心修复：这里必须改成 pyside_quasar
+include = ["pyside_quasar*"]
+exclude = ["tests*", "examples*", "docs*", "scripts*"]
+
+[tool.setuptools.package-data]
+# ✅ 核心修复：这里也必须是 pyside_quasar
+pyside_quasar = [
+    "py.typed",
+    "assets/icons/*.svg",
+    "assets/fonts/*.ttf",
+    "core/i18n/locales/*.json",
+]
+
+# ================= ruff 代码检查 & 格式化 =================
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests", "examples", "scripts"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM"]
+fix = true
+
+[tool.ruff.lint.isort]
+# ✅ 核心修复
+known-first-party = ["pyside_quasar"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+
+# ================= mypy 类型检查 =================
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+ignore_missing_imports = false
+# ✅ 核心修复
+files = ["src/pyside_quasar"]
+
+[[tool.mypy.overrides]]
+module = [
+    "examples.*",
+    "scripts.*",
+    "tests.*",
+]
+strict = false
+
+# ================= import-linter 分层架构约束 L0-L4 单向依赖 =================
+[tool.importlinter]
+# ✅ 核心修复
+root_package = "pyside_quasar"
+
+[[tool.importlinter.contracts.forbidden]]
+name = "core_must_not_import_components"
+modules = ["pyside_quasar.core*"]
+forbidden_modules = ["pyside_quasar.components*", "pyside_quasar.layouts*", "pyside_quasar.templates*"]
+
+[[tool.importlinter.contracts.forbidden]]
+name = "components_must_not_import_templates"
+modules = ["pyside_quasar.components*"]
+forbidden_modules = ["pyside_quasar.templates*"]
+
+[[tool.importlinter.contracts.forbidden]]
+name = "primitives_containers_data_no_reverse"
+modules = ["pyside_quasar.components.primitives*", "pyside_quasar.components.containers*"]
+forbidden_modules = ["pyside_quasar.components.data*"]
+
+# ================= pytest 测试配置 =================
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra --strict-markers --strict-config -W error::Warning"
+qt_api = "pyside6"
+markers = [
+    "unit: mark unit test",
+    "integration: mark integration test",
+    "visual: mark visual snapshot test",
+    "slow: mark slow running test",
+]
+filterwarnings = [
+    "ignore::DeprecationWarning:PySide6",
+]
+
+# ================= coverage 覆盖率 =================
+[tool.coverage.run]
+# ✅ 核心修复
+source = ["src/pyside_quasar"]
+branch = true
+parallel = false
+
+[tool.coverage.report]
+fail_under = 80
+show_missing = true
+skip_covered = false
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "@overload",
+    "raise NotImplementedError",
+]

pyside_quasar-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+