PinnacleQt_GUI_PySide6_PyQt6

🔥本项目旨在为 Python GUI 开发提供一个更加强大和灵活的解决方案，使得开发工作变得更加高效和灵活。本框架适用于构建各种客户端应用程序，无论是数据库管理工具、图形化数据分析界面还是个性化的业务应用。

📖目录

快速启动
支持项目
项目简介
动图展示
特性
项目结构
二次开发
联系作者
致谢
许可证

⚡快速启动

本项目使用 Python 和 PySide6，确保你已经安装了 Python 3.12+ 和 PySide6

快速启动本项目，只需几个简单步骤：

克隆仓库：

git clone https://github.com/Frica01/PinnacleQt_GUI_PySide6_PyQt6.git

安装依赖：
```
pip install -r requirements.txt
```
运行应用：
```
python main.py
```

🌟支持项目

如果您觉得这个项目有用，不妨给它一个⭐️（Star）。Star对我来说是一种鼓励，也能帮助更多的开发者发现这个工具。

如果您希望跟踪最新的更新和改进，请Fork🍴本项目。Fork可以让您保持对项目更新的同步，并有机会贡献自己的改进和新功能。

✨项目简介

本项目是一个基于 PySide6 的现代 GUI 应用，采取了 MVC 架构，设计上对程序进行了解耦，使得整个项目结构更加清晰，易于理解和维护。

使用 MVC 架构重构项目，提升代码的可维护性和可读性。
项目结构清晰，便于新功能的快速集成和现有功能的扩展。
抽象化常用功能，提高开发效率和代码复用率。

动图展示

展开

启动界面

基本展示

切换主题

📌特性

以下是具体的特性说明：

采用 MVC 架构：通过模型（Model）、视图（View）和控制器（Controller）的分离，实现了逻辑与界面的解耦，为项目的后续维护和扩展打下了坚实基础。
易于扩展：MVC架构设计让添加新功能变得更加容易和直接，无需修改大量现有代码即可实现功能的扩展。
功能抽象化：将项目中的常用功能和组件抽象成独立的模块和函数，提高了代码的复用性，同时也简化了功能的修改和升级过程。

📖项目结构

展开

PinnacleQt_GUI_PySide6_PyQt6/
├── <assets>             # 展示图片
├── config/              # 应用配置相关文件
│   ├── __init__.py
│   └── config.py        # 应用的全局配置设置
├── controllers/         # MVC 中的控制器组件
│   ├── __init__.py
│   └── controller_main.py  # 主要的应用逻辑控制器
├── models/              # MVC 中的模型组件，处理数据逻辑
│   └── __init__.py
├── tests/               # 单元测试和功能测试文件
│   ├── __init__.py
│   └── demo.py          # 示例测试文件
├── views/               # MVC 中的视图组件，用户界面文件
│   ├── resources/       # UI 资源，如图标、图片等
│   │   ├── icons/
│   │   ├── images/
│   │   ├── svgs/
│   │   ├── themes/      # UI 主题文件
│   │   │   ├── py_dracula_dark.qss
│   │   │   └── py_dracula_light.qss
│   │   ├── ui_files/    # Qt Designer UI 文件
│   │   │   └── main.ui
│   │   └── resources.qrc
│   ├── ui_components/   # 重用的UI组件和逻辑
│   │   ├── __init__.py
│   │   ├── animations.py  # 动画效果实现
│   │   └── ui_setup.py    # UI设置和初始化
│   ├── ui_designs/      # UI 设计文件，基于PySide6自动生成的Python文件
│   │   ├── __init__.py
│   │   ├── resources_rc.py
│   │   ├── ui_login.py    # 登录界面UI设计
│   │   └── ui_main.py     # 主界面UI设计
│   ├── widgets/         # 自定义的Qt Widgets
│   │   ├── __init__.py
│   │   ├── custom_grips.py  # 自定义窗口调整大小控件
│   │   ├── login_window.py  # 登录窗口实现
│   │   └── main_window.py   # 主窗口实现
│   ├── __init__.py
│   └── view_main.py     # 主视图管理器，负责整合和管理应用的所有视图
└── main.py              # 应用程序的入口文件

🧐二次开发

想要对本项目进行定制化使用，您可以按照以下步骤操作：

模型（Model）定制：在 models/ 目录下添加自己的逻辑处理文件。这些文件应该包含处理应用数据、与数据库交互等逻辑。
视图（View）定制：在 views/ 目录下添加或修改界面文件。根据您的需求设计用户界面，并通过 Qt Designer 或代码来实现它们。
控制器（Controller）使用：在 controllers/ 目录下创建或修改文件，将模型和视图连接起来。控制器负责响应用户输入，通过模型获取数据，然后更新视图显示。

通过上述步骤，您可以轻松扩展现有的功能或为应用添加全新的特性。

✉️联系作者

如果您有任何问题或者想要更多地了解项目，欢迎通过以下方式联系我：

微信公众号：小菜的Python杂货铺扫码关注公众号
QQ群聊：扫码加入群聊
在GitHub上提交Issue

致谢

本项目的灵感来源于 Wanderson-Magalhaes 的创意和贡献。我对他在开源社区的工作表示由衷的敬意和感谢。本项目基于以下两个项目的重构版本。

许可证

该项目在 MIT 许可证下开源。更多详情请查阅 GitHub 仓库中 LICENSE 文件。

soaringsou/PinnacleQt_GUI_PySide6_PyQt6