Upload 56 files

.gitattributes

@@ -1,34 +1,2 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+# Auto detect text files and perform LF normalization
+* text=auto

.github/workflows/codeql.yml

@@ -0,0 +1,92 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  schedule:
+    - cron: '17 3 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    timeout-minutes: ${{ (matrix.language == 'swift' && 120) || 360 }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: python
+          build-mode: none
+        # CodeQL supports the following values keywords for 'language': 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+    # If the analyze step fails for one of the languages you are analyzing with
+    # "We were unable to automatically build your code", modify the matrix above
+    # to set the build mode to "manual" for that language. Then modify this step
+    # to build your code.
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+    - if: matrix.build-mode == 'manual'
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.gitignore

@@ -1,4 +1,7 @@
-
-.venv/
 __pycache__
-.DS_Store
+generated/*
+temp/*
+build/*
+logs/*
+test.py
+_config.yaml

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -1,20 +1,123 @@
----
-title: Bukkitgpt
-emoji: 🌍
-colorFrom: yellow
-colorTo: indigo
-sdk: docker
-pinned: false
-license: mit
----
+<div align="center">
+<img src="https://github.com/CubeGPT/CubeAgents/blob/master/banner.jpeg?raw=true"/>
+<img src="https://img.shields.io/badge/Cube-Agents-blue">
+<a href="https://github.com/CubeGPT/BuilderGPT/pulls"><img src="https://img.shields.io/badge/PRs-welcome-20BF20"></a>
+<img src="https://img.shields.io/badge/License-Apache-red">
+<a href="https://discord.gg/kTZtXw8s7r"><img src="https://img.shields.io/discord/1212765516532289587
+"></a>
+<!-- <p>English | <a href="https://github.com/CubeGPT/CubeAgents/blob/master/README-zh_cn.md">简体中文</a></p> -->
+<br>
+<a href="https://discord.gg/kTZtXw8s7r">Join our discord</a>
+<br/>
+</div>
 
-This is a templated Space for [Shiny for Python](https://shiny.rstudio.com/py/). 
+> [!NOTE]
+> Developers and translators are welcome to join the CubeGPT Team!
 
+## Introduction
+> Give GPT your idea, AI generates customized Minecraft server plugins with one click, which is suitable for Bukkit, Spigot, Paper, Purpur, Arclight, CatServer, Magma, Mohist and other Bukkit-based servers.
 
-To get started with a new app do the following:
+BukkitGPT is an open source, free, AI-powered Minecraft Bukkit plugin generator. It was developed for minecraft server owners who are not technically savvy but need to implement all kinds of customized small plugins. From code to build, debug, all done by gpt.
 
-1) Install Shiny with `pip install shiny`
-2) Create a new app with `shiny create .`
-3) Then run the app with `shiny run --reload`
+## WebApp
+Don't want to prepare the Python & Maven environment? Try our [WebApp](http://cubegpt.org/), designed for non-developers, just enter the plugin name and description, and you can get the plugin jar file.
 
-To learn more about this framework please see the [Documentation](https://shiny.rstudio.com/py/docs/overview.html).
+*The service is paid since the API key we are using is not free. You can get 1 key for 5 generations for $1 [here](https://buymeacoffee.com/baimoqilin/e/293180) or [here (for Chinese users)](https://afdian.com/item/b839835461e311efbd1252540025c377)
+
+## Partner
+[![](https://www.bisecthosting.com/partners/custom-banners/c37f58c7-c49b-414d-b53c-1a6e1b1cff71.webp)](https://bisecthosting.com/cubegpt)
+
+## Features
+
+### Core
+- Automatically generate code
+- Automatically fix bugs
+- AI `Better Description`
+
+### GUI
+- Creating projects
+- Projects management
+
+## Plans and TODOs
+
+Moved to [Projects Tab](https://github.com/orgs/CubeGPT/projects/4).
+
+### Other projects of CubeGPT Team
+- [x] Bukkit plugin generator. {*.jar} ([BukkitGPT-v3](https://github.com/CubeGPT/BukkitGPT-v3))
+- [ ] Structure generator. {*.schem} (BuilderGPT, or something?)
+- [ ] Serverpack generator. {*.zip} (ServerpackGPT or ServerGPT, or..?)
+- [ ] Have ideas or want to join our team? Send [us](mailto:[email protected]) an email!
+
+## How it works
+When the user types the plugin description, the program lets `gpt-3.5-turbo` optimize the prompt, and then gives the optimized prompt to `gpt-4-turbo-preview`. `gpt-4-turbo-preview` will return it in json format, for example:
+```
+{
+    "output": [
+        {
+            "file": "%WORKING_PATH%/Main.java",
+            "code": "package ...;\nimport org.bukkit.Bukkit;\npublic class Main extends JavaPlugin implements CommandExecutor {\n..."
+        },
+        {
+            "file": "src/main/resources/plugin.yml",
+            "code": "name: ...\nversion: ...\n..."
+        },
+        {
+            "file\": "src/main/resources/config.yml",
+            "code\": "..."
+        },
+        {
+            "file": "pom.xml",
+            "code": "..."
+        }
+    ]
+}
+```
+The program parses this prompt, copies the entire `projects/template` folder and names it `artifact_name`, and puts the code from the prompt into the each file. Finally the program builds the jar using maven.
+
+## Requirements
+You can use BukkitGPT on any computer with [Java](https://www.azul.com/downloads/), [Maven](https://maven.apache.org/), [Python 3+](https://www.python.org/).  
+
+And you need to install this package:
+```
+pip install openai
+```
+
+## Quick Start
+
+*(Make sure you have the [Python](https://www.python.org) environment installed on your computer)*
+
+
+### Python/UI
+
+1. Download `Source Code.zip` from [the release page](https://github.com/CubeGPT/BukkitGPT-v3/releases) and unzip it.
+2. Edit `config.yaml`, fill in your OpenAI Apikey. If you don't know how, remember that [Google](https://www.google.com/) and [Bing](https://www.bing.com/) are always your best friends.
+3. Install dependencies by running `pip install -r requirements.txt`.
+4. Run `ui.py` (bash `python console.py`).
+5. Enter the artifact name & description & package id as instructed to generate your plugin.
+6. Copy your plugin from `projects/<artifact_name>/target/<artifact_name>-<version>.jar` to your server `plugins/` folder.
+7. Restart your server and enjoy your AI-powered-plugin.
+
+## Troubleshooting
+
+### The POM for org.spigotmc:spigot:jar:1.13.2-R0.1-SNAPSHOT is missing
+Solution: [Download BuildTools](https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar), place it in an empty folder, double-click it, choose "1.13.2" in `Settings/Select Version`, click `Compile` in the bottom right corner and let it finish. And then go to your BukkitGPT folder, in `projects/<artifact_name_of_your_plugin>`, double-click `build.bat`. You'll find your plugin in `projects/<artifact_name_of_your_plugin>/target` folder.
+
+## Contributing
+If you like the project, you can give the project a star, or [submit an issue](https://github.com/CubeGPT/BukkitGPT-v3/issues) or [pull request](https://github.com/CubeGPT/BukkitGPT-v3/pulls) to help make it better.
+
+## License
+```
+Copyright [2024] [CubeGPT Team]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```

build.py

@@ -0,0 +1,41 @@
+from subprocess import Popen, PIPE, STDOUT
+from log_writer import logger
+
+
+def build_plugin(artifact_name):
+    project_path = f"codes/{artifact_name}"
+    build_command = [
+        "cd",
+        project_path,
+        "&&",
+        "mvn",
+        "-V",
+        "-B",
+        "clean",
+        "package",
+        "--file",
+        "pom.xml",
+    ]
+
+    process = Popen(build_command, stdout=PIPE, stderr=STDOUT, shell=True)
+
+    def log_subprocess_output(pipe):
+        output = ""
+        for line in iter(pipe.readline, b""):
+            str_line = str(line)
+            output += str_line
+            logger(f"building -> {str_line}")
+        return output
+
+    with process.stdout:
+        output = log_subprocess_output(process.stdout)
+
+    process.wait()
+
+    return output
+
+
+if __name__ == "__main__":
+    result = build_plugin("ExamplePlugin2")
+    print(result)
+    print(type(result))

codes/Demo/pom.xml

@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>org.cubegpt</groupId>
+    <artifactId>Demo</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <packaging>jar</packaging>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.bukkit</groupId>
+            <artifactId>bukkit</artifactId>
+            <version>1.13.2-R0.1-SNAPSHOT</version>
+            <scope>provided</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <sourceDirectory>src/main/java</sourceDirectory>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.1</version>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <configuration>
+                    <archive>
+                        <manifest>
+                            <addClasspath>true</addClasspath>
+                            <classpathPrefix>lib/</classpathPrefix>
+                            <mainClass>org.cubegpt._54672e99.Main</mainClass>
+                        </manifest>
+                    </archive>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

codes/Demo/src/main/java/org/cubegpt/54672e99/Main.java

@@ -0,0 +1,30 @@
+package org.cubegpt._54672e99;
+
+import org.bukkit.Bukkit;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.bukkit.event.Listener;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.player.PlayerJoinEvent;
+import org.bukkit.command.CommandExecutor;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+public class Main extends JavaPlugin implements Listener {
+
+    @Override
+    public void onEnable() {
+        getServer().getPluginManager().registerEvents(this, this);
+        Bukkit.getConsoleSender().sendMessage("Plugin enabled!");
+    }
+
+    @EventHandler
+    public void onPlayerJoin(PlayerJoinEvent event) {
+        event.getPlayer().sendMessage("hello");
+    }
+
+    @Override
+    public void onDisable() {
+        Bukkit.getConsoleSender().sendMessage("Plugin disabled!");
+    }
+}

codes/Demo/src/main/resources/config.yml

@@ -0,0 +1 @@
+greeting-message: 'hello'

codes/Demo/src/main/resources/plugin.yml

@@ -0,0 +1,10 @@
+name: Demo
+version: 1.0
+main: org.cubegpt._54672e99.Main
+api-version: 1.13
+author: CubeGPT
+dependencies: []
+commands:
+  demo:
+    description: Sends a greeting message to everyone.
+    usage: /<command>

codes/Demo/target/classes/config.yml

@@ -0,0 +1 @@
+greeting-message: 'hello'

codes/Demo/target/classes/plugin.yml

@@ -0,0 +1,10 @@
+name: Demo
+version: 1.0
+main: org.cubegpt._54672e99.Main
+api-version: 1.13
+author: CubeGPT
+dependencies: []
+commands:
+  demo:
+    description: Sends a greeting message to everyone.
+    usage: /<command>

codes/Demo/target/maven-archiver/pom.properties

@@ -0,0 +1,3 @@
+artifactId=Demo
+groupId=org.cubegpt
+version=1.0-SNAPSHOT

codes/Demo/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst

@@ -0,0 +1 @@
+org\cubegpt\_54672e99\Main.class

codes/Demo/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst

@@ -0,0 +1 @@
+D:\zhousl\BukkitGPT\BukkitGPT-v3\codes\Demo\src\main\java\org\cubegpt\54672e99\Main.java

codes/ExamplePlugin4/pom.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>org.cubegpt</groupId>
+    <artifactId>ExamplePlugin4</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <packaging>jar</packaging>
+
+    <dependencies>
+    <dependency>
+        <groupId>org.bukkit</groupId>
+        <artifactId>bukkit</artifactId>
+        <version>1.13.2-R0.1-SNAPSHOT</version>
+        <scope>provided</scope>
+    </dependency>
+    </dependencies>
+
+    <build>
+        <sourceDirectory>src/main/java</sourceDirectory>
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+            </resource>
+        </resources>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.0</version>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

codes/ExamplePlugin4/src/main/java/org/cubegpt/188eba63/Main.java

@@ -0,0 +1,20 @@
+package org.cubegpt._188eba63;
+
+import org.bukkit.Bukkit;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.PlayerJoinEvent;
+import org.bukkit.plugin.java.JavaPlugin;
+
+public class Main extends JavaPlugin implements Listener {
+
+    @Override
+    public void onEnable() {
+        Bukkit.getServer().getPluginManager().registerEvents(this, this);
+    }
+
+    @EventHandler
+    public void onPlayerJoin(PlayerJoinEvent event) {
+        event.getPlayer().sendMessage("hello");
+    }
+}

codes/ExamplePlugin4/src/main/resources/config.yml

@@ -0,0 +1 @@
+message: "hello"

codes/ExamplePlugin4/src/main/resources/plugin.yml

@@ -0,0 +1,5 @@
+name: ExamplePlugin4
+version: 1.0
+main: org.cubegpt._188eba63.Main
+api-version: 1.13
+author: CubeGPT

codes/ExamplePlugin4/target/classes/config.yml

@@ -0,0 +1 @@
+message: "hello"

codes/ExamplePlugin4/target/classes/plugin.yml

@@ -0,0 +1,5 @@
+name: ExamplePlugin4
+version: 1.0
+main: org.cubegpt._188eba63.Main
+api-version: 1.13
+author: CubeGPT

codes/ExamplePlugin4/target/maven-archiver/pom.properties

@@ -0,0 +1,3 @@
+artifactId=ExamplePlugin4
+groupId=org.cubegpt
+version=1.0-SNAPSHOT

codes/ExamplePlugin4/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst

@@ -0,0 +1 @@
+org\cubegpt\_188eba63\Main.class

codes/ExamplePlugin4/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst

@@ -0,0 +1 @@
+D:\zhousl\BukkitGPT\BukkitGPT-v3\codes\ExamplePlugin4\src\main\java\org\cubegpt\188eba63\Main.java

config.py

@@ -0,0 +1,60 @@
+import yaml
+from log_writer import logger
+
+
+def load_config():
+    """
+    Loads the configuration from the 'config.yaml' file and sets the global variables accordingly.
+
+    If the 'GENERATE_MODEL' key in the configuration is set to 'gpt-4', it forces the use of 'gpt-4-turbo-preview'
+    as the value for the 'GENERATE_MODEL' key, since 'gpt-4' no longer supports json modes.
+
+    Returns:
+        None
+    """
+    with open("config.yaml", "r") as conf:
+        config_content = yaml.safe_load(conf)
+        for key, value in config_content.items():
+            if key == "GENERATE_MODEL" and value == "gpt-4":
+                globals()[
+                    key
+                ] = "gpt-4-turbo-preview"  # Force using gpt-4-turbo-preview if the user set the GENERATE_MODEL to gpt-4. Because gpt-4 is not longer supports json modes.
+            globals()[key] = value
+            logger(f"config: {key} -> {value}")
+
+
+def edit_config(key, value):
+    """
+    Edits the config file.
+
+    Args:
+        key (str): The key to edit.
+        value (str): The value to set.
+
+    Returns:
+        bool: True
+    """
+
+    with open("config.yaml", "r") as conf:
+        config_content = conf.readlines()
+
+    with open("config.yaml", "w") as conf:
+        for line in config_content:
+            if line.startswith(key):
+                if value == True:
+                    write_value = "True"
+                elif value == False:
+                    write_value = "False"
+                else:
+                    write_value = f'"{value}"'
+                if "#" in line:
+                    conf.write(f"{key}: {write_value} # {line.split('#')[1]}\n")
+                else:
+                    conf.write(f"{key}: {write_value}\n")
+            else:
+                conf.write(line)
+
+    return True
+
+
+load_config()

config.yaml

@@ -0,0 +1,90 @@
+########## EDIT REQUIRED ##########
+
+# GPT SETTINGS #
+# Get your api key from openai. Remember google/bing is always your best friend.
+# Model names: gpt-4-turbo-preview, gpt-3.5-turbo, etc.
+# Recommend -> gpt-4-turbo (Better performance, more expensive), gpt-4-o (Good performance, cheaper)
+
+API_KEY: "" # Free API Key with GPT-4 access: https://github.com/CubeGPT/.github/discussions/1
+BASE_URL: "https://api.openai.com/v1"
+
+GENERATION_MODEL: "gpt-4-turbo-2024-04-09"
+FIXING_MODEL: "gpt-4-turbo-2024-04-09"
+
+# DEVELOPER SETTINGS #
+VERSION_NUMBER: "0.1.1"
+
+# PROMPT SETTINGS #
+# If you don't know what it is, please don't touch it. Be sure to backup before editing.
+
+## Code Generation ##
+SYS_GEN: | 
+  You're a minecraft bukkit plugin coder AI. Game Version: 1.13.2 (1.13.2-R0.1-SNAPSHOT)
+  Write the code & choose a artifact name for the following files with the infomation which is also provided by the user:
+  codes/%ARTIFACT_NAME%/src/main/java/%PKG_ID_LST%Main.java
+  codes/%ARTIFACT_NAME%/src/main/resources/plugin.yml
+  codes/%ARTIFACT_NAME%/src/main/resources/config.yml
+  codes/%ARTIFACT_NAME%/pom.xml
+  Response in json format:
+  {
+      \"codes\": [
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/src/main/java/%PKG_ID_LST%Main.java\",
+              \"code\": \"package ...;\\nimport org.bukkit.Bukkit;\\npublic class Main extends JavaPlugin implements CommandExecutor {\\n... (The code you need to write)\"
+          },
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/src/main/resources/plugin.yml\",
+              \"code\": \"name: ...\\nversion: ...\\n...\"
+          },
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/src/main/resources/config.yml\",
+              \"code\": \"...\"
+          },
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/pom.xml\",
+              \"code\": \"...\"
+          }
+      ]
+  }
+  You should never response anything else. Never use Markdown format. Use \n for line feed, and never forget to use \ before ". Never write uncompeleted codes, such as leave a comment that says "// Your codes here" or "// Uncompeleted".
+
+USR_GEN: | 
+  %DESCRIPTION%
+
+SYS_FIX: |
+  You're a minecraft bukkit plugin coder AI. Game Version: 1.13.2 (1.13.2-R0.1-SNAPSHOT)
+  Fix the error in the code provided by user. The error message is also provided by the user.
+  Response in json format:
+  {
+      \"codes\": [
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/src/main/java/%PKG_ID_LST%Main.java\",
+              \"code\": \"package ...;\\nimport org.bukkit.Bukkit;\\npublic class Main extends JavaPlugin implements CommandExecutor {\\n... (The code you need to write)\"
+          },
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/src/main/resources/plugin.yml\",
+              \"code\": \"name: ...\\nversion: ...\\n...\"
+          },
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/src/main/resources/config.yml\",
+              \"code\": \"...\"
+          },
+          {
+              \"file\": \"codes/%ARTIFACT_NAME%/pom.xml\",
+              \"code\": \"...\"
+          }
+      ]
+  }
+  You should never response anything else. Never use Markdown format. Use \n for line feed, and never forget to use \ before ". Never write uncompeleted codes, such as leave a comment that says "// Your codes here" or "// Original code" or "// Uncompeleted".
+
+USR_FIX: |
+  Main.java:
+  %MAIN_JAVA%
+  plugin.yml:
+  %PLUGIN_YML%
+  config.yml:
+  %CONFIG_YML%
+  pom.xml:
+  %POM_XML%
+  error message:
+  %P_ERROR_MSG%

console.py

@@ -0,0 +1,121 @@
+import sys
+import uuid
+import shutil
+
+from log_writer import logger
+import core
+import config
+import build
+
+if __name__ == "__main__":
+    main_java = None
+    plugin_yml = None
+    config_yml = None
+    pom_xml = None
+
+    core.initialize()
+
+    print("BukkitGPT v3 beta console running")
+
+    # Get user inputs
+    name = input("Enter the plugin name: ")
+    description = input("Enter the plugin description: ")
+
+    artifact_name = name.replace(" ", "")
+    package_id = f"org.cubegpt.{uuid.uuid4().hex[:8]}"
+
+    pkg_id_path = ""
+    for id in package_id.split("."):
+        pkg_id_path += id + "/"
+
+    logger(f"user_input -> name: {name}")
+    logger(f"user_input -> description: {description}")
+    logger(f"random_generate -> package_id: {package_id}")
+    logger(f"str_path -> pkg_id_path: {pkg_id_path}")
+
+    print("Generating plugin...")
+
+    codes = core.askgpt(
+        config.SYS_GEN.replace("%ARTIFACT_NAME%", artifact_name).replace(
+            "%PKG_ID_LST%", pkg_id_path
+        ),
+        config.USR_GEN.replace("%DESCRIPTION", description),
+        config.GENERATION_MODEL,
+    )
+    logger(f"codes: {codes}")
+
+    core.response_to_action(codes)
+
+    print("Code generated. Building now...")
+
+    result = build.build_plugin(artifact_name)
+
+    if "BUILD SUCCESS" in result:
+        print(
+            f"Build complete. Find your plugin at 'codes/{artifact_name}/target/{artifact_name}.jar'"
+        )
+    elif "Compilation failure":
+        print("Build failed. Passing the error to ChatGPT and let it to fix it?")
+        fix = input("Y/n: ")
+        if fix == "n":
+            print("Exiting...")
+            sys.exit(0)
+        else:
+            print("Passing the error to ChatGPT...")
+
+            files = [
+                f"codes/{artifact_name}/src/main/java/{pkg_id_path}Main.java",
+                f"codes/{artifact_name}/src/main/resources/plugin.yml",
+                f"codes/{artifact_name}/src/main/resources/config.yml",
+                f"codes/{artifact_name}/pom.xml",
+            ]
+
+            ids = ["main_java", "plugin_yml", "config_yml", "pom_xml"]
+
+            for file in files:
+                with open(file, "r") as f:
+                    code = f.read()
+                    id = ids[files.index(file)]
+                    globals()[id] = code
+
+            print("Generating...")
+            codes = core.askgpt(
+                config.SYS_FIX.replace("%ARTIFACT_NAME%", artifact_name),
+                config.USR_FIX.replace("%MAIN_JAVA%", main_java)
+                .replace("%PLUGIN_YML%", plugin_yml)
+                .replace("%CONFIG_YML%", config_yml)
+                .replace("%POM_XML%", pom_xml)
+                .replace("%P_ERROR_MSG%", result),
+                config.FIXING_MODEL,
+            )
+
+            shutil.rmtree(f"codes/{artifact_name}")
+            core.response_to_action(codes)
+
+            print("Code generated. Building now...")
+
+            result = build.build_plugin(artifact_name)
+
+        if "BUILD SUCCESS" in result:
+            print(
+                f"Build complete. Find your plugin at 'codes/{artifact_name}/target/{artifact_name}.jar'"
+            )
+        else:
+            print(
+                "Build failed. Please check the logs && send the log to @BaimoQilin on discord."
+            )
+            print("Exiting...")
+            sys.exit(0)
+
+    else:
+        print(
+            "Unknown error. Please check the logs && send the log to @BaimoQilin on discord."
+        )
+        print("Exiting...")
+        sys.exit(0)
+
+
+else:
+    print(
+        "Error: Please run console.py as the main program instead of importing it from another program."
+    )

core.py

@@ -0,0 +1,177 @@
+from openai import OpenAI
+import chardet
+import sys
+import json
+import locale
+import os
+
+from log_writer import logger
+import config
+
+
+def initialize():
+    """
+    Initializes the software.
+
+    This function logs the software launch, including the version number and platform.
+
+    Args:
+        None
+
+    Returns:
+        None
+    """
+    locale.setlocale(locale.LC_ALL, "en_US.UTF-8")
+    logger(f"Launch. Software version {config.VERSION_NUMBER}, platform {sys.platform}")
+
+    if (
+        "gpt-3.5" in config.GENERATION_MODEL
+        and config.BYPASS_NO_GPT35_FOR_GENERATION_LIMIT is False
+    ):
+        print(
+            "gpt-3.5 writes bugs *all the time* and is not recommended for code generation. Switching to gpt-4."
+        )
+        config.edit_config(
+            "GENERATION_MODEL", config.GENERATION_MODEL.replace("gpt-3.5", "gpt-4")
+        )
+
+
+def askgpt(
+    system_prompt: str,
+    user_prompt: str,
+    model_name: str,
+    disable_json_mode: bool = False,
+    image_url: str = None,
+):
+    """
+    Interacts with ChatGPT using the specified prompts.
+
+    Args:
+        system_prompt (str): The system prompt.
+        user_prompt (str): The user prompt.
+        model_name (str): The model name to use.
+        disable_json_mode (bool): Whether to disable JSON mode.
+
+    Returns:
+        str: The response from ChatGPT.
+    """
+    if image_url is not None and config.USE_DIFFERENT_APIKEY_FOR_VISION_MODEL:
+        logger("Using different API key for vision model.")
+        client = OpenAI(api_key=config.VISION_API_KEY, base_url=config.VISION_BASE_URL)
+    else:
+        client = OpenAI(api_key=config.API_KEY, base_url=config.BASE_URL)
+
+    logger("Initialized the OpenAI client.")
+
+    # Define the messages for the conversation
+    if image_url is not None:
+        messages = [
+            {"role": "system", "content": system_prompt},
+            {
+                "role": "user",
+                "content": [
+                    {"type": "text", "text": user_prompt},
+                    {"type": "image_url", "image_url": {"url": image_url}},
+                ],
+            },
+        ]
+    else:
+        messages = [
+            {"role": "system", "content": system_prompt},
+            {"role": "user", "content": user_prompt},
+        ]
+
+    logger(f"askgpt: system {system_prompt}")
+    logger(f"askgpt: user {user_prompt}")
+
+    # Create a chat completion
+    if disable_json_mode:
+        response = client.chat.completions.create(model=model_name, messages=messages)
+    else:
+        response = client.chat.completions.create(
+            model=model_name, response_format={"type": "json_object"}, messages=messages
+        )
+
+    logger(f"askgpt: response {response}")
+
+    # Extract the assistant's reply
+    assistant_reply = response.choices[0].message.content
+    logger(f"askgpt: extracted reply {assistant_reply}")
+    return assistant_reply
+
+
+def response_to_action(msg):
+    """
+    Converts a response from ChatGPT to an action.
+
+    Args:
+        msg (str): The response from ChatGPT.
+
+    Returns:
+        str: The action to take.
+    """
+    text = json.loads(msg)
+
+    codes = text["codes"]
+
+    for section in codes:
+        file = section["file"]
+        code = section["code"]
+
+        paths = file.split("/")
+
+        # Join the list elements to form a path
+        path = os.path.join(*paths)
+
+        # Get the directory path and the file name
+        dir_path, file_name = os.path.split(path)
+
+        # Create directories, if they don't exist
+        try:
+            os.makedirs(dir_path, exist_ok=True)
+        except FileNotFoundError:
+            pass
+
+        # Create the file
+        with open(path, "w") as f:
+            f.write(code)  # Write an empty string to the file
+
+
+def mixed_decode(text: str):
+    """
+    Decode a mixed text containing both normal text and a byte sequence.
+
+    Args:
+        text (str): The mixed text to be decoded.
+
+    Returns:
+        str: The decoded text, where the byte sequence has been converted to its corresponding characters.
+
+    """
+    # Split the normal text and the byte sequence
+    # Assuming the byte sequence is everything after the last colon and space ": "
+    try:
+        normal_text, byte_text = text.rsplit(": ", 1)
+    except (TypeError, ValueError):
+        # The text only contains normal text
+        return text
+
+    # Convert the byte sequence to actual bytes
+    byte_sequence = byte_text.encode(
+        "latin1"
+    )  # latin1 encoding maps byte values directly to unicode code points
+
+    # Detect the encoding of the byte sequence
+    detected_encoding = chardet.detect(byte_sequence)
+    encoding = detected_encoding["encoding"]
+
+    # Decode the byte sequence
+    decoded_text = byte_sequence.decode(encoding)
+
+    # Combine the normal text with the decoded byte sequence
+    final_text = normal_text + ": " + decoded_text
+    return final_text
+
+
+if __name__ == "__main__":
+    print("This script is not meant to be run directly. Please run console.py instead.")

cube_qgui/__init__.py

@@ -0,0 +1,18 @@
+# Author: Acer Zhang
+# Edit: CubeGPT Team
+# Original Version Datetime: 2021/9/16
+# Edited Version Datetime: 2024/5/31
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+
+import cube_qgui.base_tools
+import cube_qgui.factory
+# import qgui.notebook_tools
+# import qgui.banner_tools
+
+
+from cube_qgui.factory import CreateQGUI
+
+from cube_qgui.manager import *
+
+from cube_qgui.base_tools import ArgInfo

cube_qgui/__main__.py

@@ -0,0 +1,122 @@
+import time
+
+# 导入CreateQGUI模块
+from qgui import CreateQGUI, MessageBox
+# 【可选】导入自定义导航栏按钮模块、GitHub导航栏模块
+from qgui.banner_tools import BaseBarTool, GitHub, AIStudio
+# 【可选】一次性导入所有的主界面工具模块
+from qgui.notebook_tools import *
+# 【可选】导入占位符
+from qgui.manager import QStyle, HORIZONTAL
+
+
+def click(args: dict):
+    MessageBox.info("要开始啦~")
+    # 证明一下自己被点到了
+    print("你点到我啦~")
+    # 通过ChooseFileTextButton(name="文件选择")中预先设置的name参数，使用get方法即可获取对应的输入框信息
+    print("你选择的文件是：", args["文件选择"].get())
+    # 当然也可以通过name参数来设置对应的内容，使用set方法即可完成设置
+    print("保存位置修改为“快看，我被修改啦”", args["保存位置"].set("快看，我被修改啦"))
+    # 即使没有指定name，我们照样可以拿到所有的小工具情况
+    for arg, v_fun in args.items():
+        print("自定义组件Name：", arg, "状态：", v_fun.get())
+
+    # 若我们绑定了进度条，那么每当需要设置进度的时候，通过args["进度条"].set(当前进度)来进行设置吧，倒吸进度条也是可以哒
+    for i in range(1, 101):
+        time.sleep(0.01)
+        args["进度条"].set(i)
+        # 增加打印间隔
+        if i % 20 == 0:
+            print("当前进度", i)
+    MessageBox.warning(text="给个评价吧亲~")
+    # 也可以在终端中打印组件，顺便绑定用户调研函数
+    q_gui.print_tool(RadioButton(["满意", "一般", "你好垃圾啊"], title="体验如何？", name="feedback", bind_func=feedback))
+    # 甚至打印图片
+    from qgui import RESOURCES_PATH
+    q_gui.print_image(os.path.join(RESOURCES_PATH, "demo/panda.jpg"))
+
+
+def feedback(args: dict):
+    # 用户调研Callback
+    info = args["feedback"].get()
+    if info == "满意":
+        print("么么哒")
+    elif info == "一般":
+        print("啊啊啊，告诉GT哪里没做好吧")
+    else:
+        print("以后漂流瓶见吧，拜拜！")
+
+
+def bind_dir(args: dict):
+    # 获取所选择文件所在的文件夹路径
+    path = os.path.dirname(args["文件选择"].get())
+    # 可以通过name参数来设置对应的内容，使用set方法即可完成设置
+    args["保存位置"].set(path)
+    print("保存位置已自动修改为：", path)
+
+
+def go_to_first_page(args: dict):
+    args["QGUI-BaseNoteBook"].set(0)
+
+
+# 创建主界面
+q_gui = CreateQGUI(title="一个新应用",  # 界面标题
+                   tab_names=["主控制台", "选择按钮", "其他小工具"],  # 界面中心部分的分页标题 - 可不填
+                   style=QStyle.default)  # 皮肤
+
+# 在界面最上方添加一个按钮，链接到GitHub主页
+q_gui.add_banner_tool(GitHub(url="https://github.com/QPT-Family/QGUI"))
+# 也可以是AI Studio
+q_gui.add_banner_tool(AIStudio(url="https://aistudio.baidu.com/aistudio/personalcenter/thirdview/29724"))
+# 要不试试自定义Banner按钮，在大家点击它时触发刚刚定义的click函数，并向它传递其他组件的情况
+q_gui.add_banner_tool(BaseBarTool(bind_func=click, name="一个新组件"))
+
+# 在主界面部分添加一个文件选择工具吧，并在选择文件后自动变为文件所在的路径
+q_gui.add_notebook_tool(ChooseFileTextButton(name="文件选择", bind_func=bind_dir))
+# 再加个文件夹选择工具
+q_gui.add_notebook_tool(ChooseDirTextButton(name="保存位置"))
+# 当然也可以来个输入框
+q_gui.add_notebook_tool(InputBox(name="我是个木有感情的输入框"))
+# 想要加一个 进度条 和 运行按钮 而且俩要水平方向排列该如何做？
+# 试试HorizontalToolsCombine，它可以接受一组工具并将其进行水平排列
+# 这里我们也为RunButton绑定click函数
+run_menu = HorizontalToolsCombine([Progressbar(name="进度条"),
+                                   RunButton(bind_func=click)],
+                                  text="试试HorizontalToolsCombine，它可以接受一组工具并将其进行水平排列")
+q_gui.add_notebook_tool(run_menu)
+
+# 第二页 - 复选框和单选框
+# 使用VerticalFrameCombine可以将他们在垂直方向快速组合，它们会从左到右按顺序排列
+combine_left = VerticalFrameCombine([CheckButton(options=[("选择1", 0), ("选择2", 1), ("选择3", 0)]),
+                                     CheckToolButton(options=[("选择1", 0), ("选择2", 1), ("选择3", 0)]),
+                                     CheckObviousToolButton(options=[("选择1", 0), ("选择2", 1), ("选择3", 0)]),
+                                     ToggleButton(options=("开", 1))],
+                                    tab_index=1,
+                                    text="使用VerticalFrameCombine可以将他们在垂直方向快速组合，它们会从左到右按顺序排列")
+q_gui.add_notebook_tool(combine_left)
+# 设置title参数��会为其增加标题
+combine_right = VerticalFrameCombine([RadioButton(["选择1", "选择2", "选择3"], tab_index=1),
+                                      RadioToolButton(["选择1", "选择2", "选择3"], tab_index=1),
+                                      RadioObviousToolButton(["选择1", "选择2", "选择3"], tab_index=1)],
+                                     title="右侧的复选框")
+q_gui.add_notebook_tool(combine_right)
+
+# 第三页
+q_gui.add_notebook_tool(Label(text="这只是个简单的Label组件", alignment=RIGHT + TOP, tab_index=2))
+q_gui.add_notebook_tool(Slider(default=4, tab_index=2))
+q_gui.add_notebook_tool(Combobox(options=["选择1", "选择2", "选择3"], tab_index=2))
+q_gui.add_notebook_tool(BaseButton(bind_func=go_to_first_page, text="回到首页", tab_index=2))
+
+# 左侧信息栏
+# 简单加个简介
+q_gui.set_navigation_about(author="GT",
+                           version="0.0.1",
+                           github_url="https://github.com/QPT-Family/QGUI",
+                           other_info=["欢迎加入QPT！"])
+# 也可以加一下其他信息
+q_gui.set_navigation_info(title="随便写段话", info="除了QGUI，你还可以试试例如AgentQGUI这样同样简单的GUI框架")
+print("小Tips：占位符可以被Print，不信你看HORIZONTAL的描述被打印了出来->", HORIZONTAL)
+
+# 跑起来~切记！一定要放在程序末尾
+q_gui.run()

cube_qgui/banner_tools.py

@@ -0,0 +1,106 @@
+# Author: Acer Zhang
+# Datetime: 2021/9/16 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+import os
+import webbrowser
+
+import tkinter
+from tkinter import ttk
+from cube_qgui.manager import ICON_PATH, ConcurrencyModeFlag
+from cube_qgui.base_tools import ArgInfo, BaseTool
+
+RUN_ICON = os.path.join(ICON_PATH, "play_w.png")
+GITHUB_ICON = os.path.join(ICON_PATH, "github.png")
+AI_STUDIO_ICON =  os.path.join(ICON_PATH, "up_cloud.png")
+
+
+class BaseBarTool(BaseTool):
+    """
+    基础Banner工具集
+    需注意的是，如需增加异步等操作，请为函数添加_callback
+    """
+
+    def __init__(self,
+                 bind_func,
+                 name="Unnamed Tool",
+                 icon=None,
+                 style=None,
+                 async_run: bool = True,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         style=style,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode)
+
+        if icon and not os.path.exists(icon):
+            raise f"Please check if {os.path.abspath(icon)} exists."
+        if not icon:
+            icon = RUN_ICON
+        self.icon = icon
+
+    def build(self, *args, **kwargs):
+        super().build(*args, **kwargs)
+        self.img = tkinter.PhotoImage(file=self.icon)
+
+        btn = ttk.Button(self.master,
+                         text=self.name,
+                         image=self.img,
+                         compound="left",
+                         command=self._callback(self.bind_func) if self.async_run else self.bind_func,
+                         style=self.style + "TButton")
+
+        btn.pack(side="left", ipadx=5, ipady=5, padx=0, pady=1)
+
+
+class RunTool(BaseBarTool):
+    def __init__(self,
+                 bind_func,
+                 name="Start Processing",
+                 icon=None,
+                 style="success",
+                 async_run: bool = True,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG):
+        if not icon:
+            icon = RUN_ICON
+        super(RunTool, self).__init__(bind_func,
+                                      name=name,
+                                      icon=icon,
+                                      style=style,
+                                      async_run=async_run,
+                                      concurrency_mode=concurrency_mode)
+
+
+class GitHub(BaseBarTool):
+    def __init__(self,
+                 url,
+                 name="View on GitHub",
+                 style="primary"):
+        icon = GITHUB_ICON
+        bind_func = self.github_callback
+        super().__init__(bind_func,
+                         name=name,
+                         icon=icon,
+                         style=style)
+        self.github_url = url
+
+    def github_callback(self, args):
+        webbrowser.open_new(self.github_url)
+
+
+class AIStudio(BaseBarTool):
+    def __init__(self,
+                 url,
+                 name="Use on AI Studio",
+                 style="primary"):
+        icon = AI_STUDIO_ICON
+        bind_func = self.ai_studio_callback
+        super().__init__(bind_func,
+                         name=name,
+                         icon=icon,
+                         style=style)
+        self.ai_studio_url = url
+
+    def ai_studio_callback(self, args):
+        webbrowser.open_new(self.ai_studio_url)

cube_qgui/base_frame.py

@@ -0,0 +1,286 @@
+# Author: Acer Zhang
+# Datetime: 2021/9/14 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+
+import sys
+import webbrowser
+import time
+from typing import List
+
+import tkinter
+from tkinter import ttk
+from tkinter.scrolledtext import ScrolledText
+
+from cube_qgui.manager import BLACK, FONT
+from cube_qgui.banner_tools import BaseBarTool
+from cube_qgui.third_party.collapsing_frame import CollapsingFrame
+from cube_qgui.notebook_tools import BaseNotebookTool
+from cube_qgui.os_tools import StdOutWrapper, DataCache
+from cube_qgui.base_tools import ArgInfo
+
+TITLE_BG_COLOR = BLACK
+
+
+# ToDo 主题部分可考虑通过增加warmup来解决
+
+class _Backbone:
+    """
+    整个界面的基础，存放共有的变量
+    """
+
+    def __init__(self, f_style="primary"):
+        """
+        请务必检查self.frame是否做了pack等定位操作，无操作将不会被显示
+        :param f_style:
+        """
+        # 统一用place
+        self.style = f_style
+
+        # 全局变量
+        self.global_info = ArgInfo()
+
+    def build(self, master, global_info):
+        self.frame = ttk.Frame(master, style=self.style + ".TFrame")
+        self.global_info = global_info
+
+
+class BaseNavigation(_Backbone):
+    """
+    左侧导航栏基本框架
+    """
+
+    def __init__(self, style="primary"):
+        super(BaseNavigation, self).__init__(f_style=style)
+        self.tabs = dict()
+
+    def add_about(self,
+                  author: str = "未知作者",
+                  version: str = "0.0.1",
+                  github_url: str = None,
+                  bilibili_url: str = None,
+                  blog_url: str = None,
+                  other_info: List[str] = None):
+        bus_cf = CollapsingFrame(self.frame)
+        bus_cf.pack(fill='x', pady=0)
+
+        bus_frm = ttk.Frame(bus_cf, padding=5)
+        bus_frm.columnconfigure(1, weight=1)
+        bus_cf.add(bus_frm, title="Info", style='secondary.TButton')
+
+        ttk.Label(bus_frm, text=f"Author:\t{author}", style="TLabel", justify="left", wraplength=160).pack(anchor="nw")
+        ttk.Label(bus_frm, text=f"Version:\t{version}", style="TLabel", justify="left", wraplength=160).pack(anchor="nw")
+
+        if other_info:
+            for line in other_info:
+                ttk.Label(bus_frm, text=line, style="TLabel").pack(anchor="nw")
+
+        if github_url:
+            def github_callback(event):
+                webbrowser.open_new(github_url)
+
+            github_label = ttk.Label(bus_frm, text=f"> View on GitHub", style="info.TLabel", justify="left")
+            github_label.pack(anchor="nw")
+            github_label.bind("<Button-1>", github_callback)
+
+        if bilibili_url:
+            def bilibili_callback(event):
+                webbrowser.open_new(bilibili_url)
+
+            bilibili_label = ttk.Label(bus_frm, text=f"> View on bilibili", style="info.TLabel", justify="left")
+            bilibili_label.pack(anchor="nw")
+            bilibili_label.bind("<Button-1>", bilibili_callback)
+
+        if blog_url:
+            def blog_callback(event):
+                webbrowser.open_new(blog_url)
+
+            blog_label = ttk.Label(bus_frm, text=f"> View on blog", style="info.TLabel", justify="left")
+            blog_label.pack(anchor="nw")
+            blog_label.bind("<Button-1>", blog_callback)
+
+    def add_info(self,
+                 title: str,
+                 info: str):
+        bus_cf = CollapsingFrame(self.frame)
+        bus_cf.pack(fill='x', pady=0)
+
+        bus_frm = ttk.Frame(bus_cf, padding=5)
+        bus_frm.columnconfigure(1, weight=1)
+        bus_cf.add(bus_frm, title=title, style='secondary.TButton', justify="left")
+
+        ttk.Label(bus_frm, text=info, style="TLabel", wraplength=160).pack(anchor="nw")
+
+    # def add_homepage(self, tool):
+    #     btn = ttk.Button(self.frame,
+    #                      text=tool.name,
+    #                      image=tool.name,
+    #                      compound='left',
+    #                      command=tool.bind_func)
+    #     btn.pack(side='left', ipadx=5, ipady=5, padx=0, pady=1)
+    def build(self, master, global_info):
+        super(BaseNavigation, self).build(master, global_info)
+        self.frame.place(x=0, y=50, width=180, height=470)
+
+
+class BaseNoteBook(_Backbone):
+    """
+    中间Notebook部分框架
+    """
+
+    def __init__(self,
+                 style="primary",
+                 tab_names: List[str] = None,
+                 stdout=None):
+        super(BaseNoteBook, self).__init__(f_style=style)
+        self.tab_names = tab_names
+        self.nb_frames = list()
+
+        # 初始化总输出行数
+        self.line_len = 2
+        if not stdout:
+            stdout = sys.stdout
+        self.stdout = stdout
+
+        sys.stdout = StdOutWrapper(self.stdout, callback=self._write_log_callback)
+        sys.stderr = StdOutWrapper(self.stdout, callback=self._write_log_callback)
+
+        self.image_cache = DataCache()
+
+    def add_tool(self, tool: BaseNotebookTool, to_notebook=True):
+
+        if tool.tab_index >= len(self.nb_frames):
+            raise ValueError(f"设置的index大小越界，当前页面数量为{len(self.nb_frames)}，分别为：{self.nb_frames}，而"
+                             f"您设置的index为{tool.tab_index}，超过了当前页面数量。")
+        if to_notebook:
+            frame = self.nb_frames[tool.tab_index]
+            tool_frame = tool.build(master=frame, global_info=self.global_info)
+        else:
+            tool_frame = tool.build(global_info=self.global_info)
+        tool_info = tool.get_arg_info()
+        self.global_info += tool_info
+        return tool_frame
+
+    def build(self, master, global_info):
+        super(BaseNoteBook, self).build(master, global_info)
+        self.frame.place(x=182, y=55, width=750, height=460)
+        self.nb = ttk.Notebook(self.frame)
+        self.nb.pack(side="top", fill="both")
+
+        if self.tab_names:
+            for tab_name in self.tab_names:
+                sub_frame = ttk.Frame(self.nb)
+                sub_frame.pack(anchor="nw", expand="yes")
+                self.nb_frames.append(sub_frame)
+                self.nb.add(sub_frame, text=tab_name)
+        else:
+            sub_frame = ttk.Frame(self.nb)
+            sub_frame.pack(anchor="nw", expand="yes")
+            self.nb_frames.append(sub_frame)
+            self.nb.add(sub_frame, text="Generate")
+        self.global_info += ArgInfo(name="QGUI-BaseNoteBook",
+                                    set_func=self._select_notebook_callback,
+                                    get_func=lambda: print("BaseNoteBook不支持get"))
+
+        # 增加OutPut
+        self.console_frame = ttk.Frame(self.frame,
+                                       style=self.style + ".TFrame")
+        self.console_frame.pack(side="top", fill='both', expand="yes")
+
+        # 标题
+        self.title = ttk.Label(self.console_frame,
+                               font=(FONT, 15),
+                               style=self.style + ".Inverse.TLabel",
+                               text="Console Log",
+                               justify="left")
+        self.title.pack(side="top", fill="x", padx=10, pady=5)
+
+        # 文本
+        self.text_area = ScrolledText(self.console_frame,
+                                      highlightcolor=master.style.colors.primary,
+                                      highlightbackground=master.style.colors.border,
+                                      highlightthickness=1)
+
+        self.text_area.pack(fill="both", expand="yes")
+
+        self.text_area.insert("end", "Console Connected\n")
+        self.text_area.configure(state="disable")
+
+    def print_tool(self, tool: BaseNotebookTool):
+        self.text_area.configure(state="normal")
+        self.text_area.window_create("end", window=self.add_tool(tool, to_notebook=False))
+        self.text_area.configure(state="disable")
+        print("")
+
+    def print_image(self, image):
+        from PIL import Image, ImageTk
+        if isinstance(image, str):
+            image = Image.open(image)
+        w, h = image.size
+        scale = 128 / max(w, h)
+        w *= scale
+        h *= scale
+        image = image.resize((int(w), int(h)))
+        image = ImageTk.PhotoImage(image)
+        self.image_cache += image
+        self.text_area.configure(state="normal")
+        self.text_area.image_create("end", image=image)
+        self.text_area.configure(state="disable")
+        print("")
+
+    def _select_notebook_callback(self, index):
+        self.nb.select(index)
+
+    def _write_log_callback(self, text):
+        self.text_area.configure(state="normal")
+
+        # 对print形式的进度条进行适配
+        if "\r" in text:
+            self.text_area.delete(str(self.line_len) + ".0", str(self.line_len) + ".end")
+            self.line_len -= 1
+            text = text[text.index("\r") + 1:] + " "
+
+        if len(text) > 0 and text != "\n":
+            text = time.strftime("%H:%M:%S", time.localtime()) + "\t" + text
+
+        self.text_area.insert("end", text)
+        self.line_len += 1
+        self.text_area.configure(state="disable")
+        self.text_area.see("end")
+
+
+class BaseBanner(_Backbone):
+    def __init__(self,
+                 title: str = "QGUI Tesing Program",
+                 style="primary"):
+        super(BaseBanner, self).__init__(f_style=style)
+        self.img_info = dict()
+        self.title = title
+
+    def add_tool(self, tool: BaseBarTool):
+        """
+        添加小工具组件
+        :param
+        """
+        tool.build(master=self.frame, global_info=self.global_info)
+        tool_info = tool.get_arg_info()
+        self.global_info += tool_info
+
+    def build(self, master, global_info):
+        super(BaseBanner, self).build(master, global_info)
+        self.frame.place(x=0, y=0, width=940, height=50)
+        # 占位标题
+        black = tkinter.Frame(self.frame,
+                              height=10,
+                              bg=TITLE_BG_COLOR)
+        black.pack(side="right", anchor="se")
+        # 主标题
+        title = ttk.Label(self.frame,
+                          font=(FONT, 22),
+                          text=self.title,
+                          style=self.style + ".Inverse.TLabel")
+        title.pack(side="right", anchor="se", padx=5, pady=3)
+
+
+if __name__ == '__main__':
+    pass

cube_qgui/base_tools.py

@@ -0,0 +1,212 @@
+# Author: Acer Zhang
+# Datetime:2021/9/21 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+import threading
+import traceback
+import sys
+from typing import Dict
+
+import tkinter
+
+from cube_qgui.manager import *
+
+from log_writer import logger
+
+
+def check_callable(bind_func):
+    if bind_func and not hasattr(bind_func, "__call__"):
+        if hasattr(bind_func, "__name__"):
+            name = bind_func.__name__
+        else:
+            name = bind_func
+        raise Exception(f"{name}的bind_func不能被调用，其至少需要具备__call__方法，建议在此传入函数/方法或自行构建具备__call__方法的对象。\n"
+                        f"Example:\n"
+                        f"    def xxx():\n"
+                        f"        Do sth\n"
+                        f"    MakeThisTool(bind_func=xxx)\n"
+                        f"Error example:\n"
+                        f"    def xxx():\n"
+                        f"        Do sth\n"
+                        f"    MakeThisTool(bind_func=xxx())")
+
+
+def make_anchor(anchor):
+    if anchor:
+        r_anchor = str()
+        if TOP in anchor:
+            r_anchor = "n"
+        if BOTTOM in anchor:
+            r_anchor = "s"
+        if LEFT in anchor:
+            r_anchor += "w"
+        if RIGHT in anchor:
+            r_anchor += "e"
+        return r_anchor
+    else:
+        return None
+
+
+def make_side(side):
+    if side:
+        if side == TOP:
+            side = "top"
+        elif side == BOTTOM:
+            side = "bottom"
+        elif side == LEFT:
+            side = "left"
+        else:
+            side = "right"
+        return side
+    else:
+        return None
+
+
+class ArgInfo:
+    def __init__(self, name=None, set_func=None, get_func=None):
+        if not name and (set_func or get_func):
+            raise Exception(f"请设置{self.__class__.__name__}的name")
+        if name:
+            self.all_info = {name: self}
+        else:
+            self.all_info = dict()
+
+        check_callable(set_func)
+        check_callable(get_func)
+        self.set_func = set_func
+        self.get_func = get_func
+
+    def set(self, *args, **kwargs):
+        return self.set_func(*args, **kwargs)
+
+    def get(self, *args, **kwargs):
+        return self.get_func(*args, **kwargs)
+
+    def get_info(self):
+        return self.all_info
+
+    def __add__(self, other):
+        other_info = other.all_info
+        if other_info:
+            for info_name in other_info:
+                if info_name in self.all_info:
+                    self.all_info[f"{info_name}-QGUI-Conflict-Field-{len(self.all_info)}"] = other_info[info_name]
+                else:
+                    self.all_info[info_name] = other_info[info_name]
+        return self
+
+    def __getitem__(self, item):
+        return self.all_info[item]
+
+
+def select_var_dtype(dtype):
+    if issubclass(dtype, int):
+        return tkinter.IntVar
+    elif issubclass(dtype, float):
+        return tkinter.DoubleVar
+    elif issubclass(dtype, str):
+        return tkinter.StringVar
+    elif issubclass(dtype, bool):
+        return tkinter.BooleanVar
+
+
+class BaseTool:
+    """
+    基础工具集，提供基础异步Callback
+    1. 写Build，记得继承才会有self.master，继承时候传**kwargs
+    2. 若需返回信息，请重写get_info方法->ArgInfo
+    3. 如绑定func，需要封装Callback
+    """
+
+    def __init__(self,
+                 bind_func=None,
+                 name: str = None,
+                 style: str = "primary",
+                 async_run: bool = False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG):
+        check_callable(bind_func)
+        self.bind_func = bind_func
+        self.name = name
+        self.style = style + "." if style else ""
+        self.async_run = async_run
+        # 控制并发模式
+        self.concurrency_mode = concurrency_mode
+
+        # 占位符
+        self.global_info = None
+        self.master = None
+
+        # 重复点击的Flag
+        self.async_run_event = threading.Event()
+        self.thread_pool = list()
+
+    def _callback(self, func, start_func=None, end_func=None):
+        """
+        支持同步和异步的Callback
+        :param func: 函数对象
+        :param start_func: 开始前的函数对象
+        :param end_func: 结束后的函数对象
+        """
+        if func:
+            if not self.async_run:
+                def render():
+                    if start_func:
+                        start_func()
+                    func(self.global_info.get_info())
+                    if end_func:
+                        end_func()
+            else:
+                def render():
+                    # 若不允许并发则在启动时加Flag
+                    if self.async_run_event.is_set():
+                        if self.concurrency_mode == ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG:
+                            return lambda: print("��前设置为禁止并发，请勿重复点击，因为点了也没用")
+                    else:
+                        self.async_run_event.set()
+
+                    if start_func:
+                        start_func()
+
+                    def new_func(obj):
+                        try:
+                            func(obj)
+                        except Exception as e:
+                            print("-----ERROR MSG START-----")
+                            print(traceback.print_exc())
+                            print("-----ERROR MSG END-----")
+
+                            # Record the error message to the log
+                            logger(f"Error: {e}")
+                        if end_func:
+                            end_func()
+                        # 清除Flag，此时按钮可以再次点击
+                        self.async_run_event.clear()
+
+                    t = threading.Thread(target=new_func, args=(self.global_info.get_info(),))
+                    t.setDaemon(True)
+                    t.start()
+
+                    self.thread_pool.append(t)
+            return render
+        else:
+            def none():
+                pass
+
+            return none
+
+    def build(self, *args, **kwargs) -> tkinter.Frame:
+        self.global_info = kwargs.get("global_info")
+        self.master = kwargs.get("master")
+
+    def get_arg_info(self) -> ArgInfo:
+        return ArgInfo()
+
+
+if __name__ == '__main__':
+    n = ArgInfo(set_func=lambda: print("a"))
+    a = ArgInfo("A", None, lambda: print("a"))
+    b = ArgInfo("B", None, lambda: print("b"))
+    c = ArgInfo("A", None, lambda: print("a"))
+    n += a + b + c
+    a.get()
+    pass

cube_qgui/factory.py

@@ -0,0 +1,168 @@
+# Author: Acer Zhang
+# Datetime: 2021/8/31 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+from typing import List
+
+import tkinter
+import tkinter.font
+from ttkbootstrap import Style
+
+from cube_qgui.manager import QStyle, FONT
+from cube_qgui.base_frame import BaseNoteBook, BaseBanner, BaseNavigation
+from cube_qgui.banner_tools import BaseBarTool
+from cube_qgui.notebook_tools import BaseNotebookTool
+from cube_qgui.base_tools import check_callable
+
+
+class CreateQGUI:
+    """
+    创建最基础的QGUI程序
+
+    :param title: 主程序标题
+    :param style: 皮肤，需通过QStyle来确定
+    :param stout: 标准输出流
+    :param tab_names: List[str] 功能区Tab页面，默认为“主程序控制台”
+    :param banner: QGUI的Banner对象
+    :param navigation: QGUI的navigation对象
+    :param notebook: QGUI的notebook对象
+    :param bind_func: 全局事件绑定
+    """
+
+    def __init__(self,
+                 title="Unnamed",
+                 style: dict = None,
+                 stout=None,
+                 tab_names: List[str] = None,
+                 banner: BaseBanner = None,
+                 navigation: BaseNavigation = None,
+                 notebook: BaseNoteBook = None,
+                 bind_func=None):
+        super().__init__()
+        self.title = title
+        self.style = style
+
+        self.root = tkinter.Tk()
+        if bind_func:
+            check_callable(bind_func=bind_func)
+            self.root.bind_all("<1>", bind_func)
+        if self.style:
+            self.root.style = Style(**self.style)
+        else:
+            self.root.style = Style(**QStyle.default)
+        self.root.style.configure('bg.TFrame', background=self.root.style.colors.inputbg)
+        self.root.style.configure('bg.TLabel', background=self.root.style.colors.inputbg)
+        default_font = tkinter.font.nametofont("TkDefaultFont")
+        default_font.configure(family=FONT, size=10)
+        self.root.option_add("*Font", "TkDefaultFont")
+        self.root.geometry("940x520")
+        self.root.wm_resizable(False, False)
+        self.root.title(self.title)
+
+        # 初始化组件
+        self.banner = banner if banner else BaseBanner(title=self.title)
+        self.navigation = navigation if navigation else BaseNavigation()
+        self.notebook = notebook if notebook else BaseNoteBook(tab_names=tab_names, stdout=stout)
+
+        self.banner.build(self.root, self.get_global_info)
+        self.navigation.build(self.root, self.get_global_info)
+        self.notebook.build(self.root, self.get_global_info)
+
+    @property
+    def get_global_info(self):
+        # ToDo 做个 global_info管理器，目前信息只从Notebook中流出
+        return self.notebook.global_info
+
+    def add_banner_tool(self, tool: BaseBarTool):
+        """
+        在程序最上方添加小组件
+        :param tool: 继承于BaseBarTool的组件对象
+
+        Example
+            from qgui.banner_tools import GitHub
+            q_gui = CreateQGUI()
+            q_gui.add_banner_tool(GitHub())
+        """
+        self.banner.add_tool(tool)
+
+    abt = add_banner_tool
+
+    def add_notebook_tool(self, tool: BaseNotebookTool):
+        """
+        在程序中央功能区添加小组件
+        :param tool: 继承于BaseNotebookTool的组件对象
+
+        Example
+            from qgui.notebook_tools import RunButton
+            q_gui.add_notebook_tool(RunButton())
+        """
+        self.notebook.add_tool(tool)
+
+    ant = add_notebook_tool
+
+    def set_navigation_about(self,
+                             author: str = "Unknow Author",
+                             version: str = "N/A",
+                             github_url: str = None,
+                             bilibili_url: str = None,
+                             blog_url: str = None,
+                             other_info: List[str] = None):
+        """
+        设置左侧导航栏的程序基本信息
+        :param author: 作者
+        :param version: 版本号
+        :param github_url: GitHub链接
+        :param bilibili_url: bilibili链接
+        :param blog_url: blog链接
+        """
+        self.navigation.add_about(author=author,
+                                  version=version,
+                                  github_url=github_url,
+                                  bilibili_url=bilibili_url,
+                                  blog_url=blog_url,
+                                  other_info=other_info)
+
+    sna = set_navigation_about
+
+    def set_navigation_info(self,
+                            title: str,
+                            info: str):
+        """
+        设置左侧导航栏其他信息
+        :param title: 标题
+        :param info: 信息
+        """
+        self.navigation.add_info(title=title, info=info)
+
+    sni = set_navigation_info
+
+    def print_tool(self, tool: BaseNotebookTool):
+        """
+        在终端中打印组件
+        :param tool: 继承于BaseNotebookTool的���件对象
+        """
+        self.notebook.print_tool(tool)
+
+    def print_image(self, image):
+        """
+        在终端中打印图像
+        :param image: 图像所在路径 or pillow图片对象
+        """
+        self.notebook.print_image(image)
+
+    def run(self):
+        """
+        展示GUI界面
+        """
+        self.root.mainloop()
+
+
+if __name__ == '__main__':
+    from qgui.banner_tools import BaseBarTool
+    from qgui.notebook_tools import BaseChooseFileTextButton
+
+    _tmp = CreateQGUI()
+    _tmp.add_banner_tool(BaseBarTool(lambda: print(0)))
+    _tmp.add_notebook_tool(BaseChooseFileTextButton(lambda: print(1)))
+    _tmp.set_navigation_about()
+    _tmp.run()

cube_qgui/manager.py

@@ -0,0 +1,80 @@
+# Author: Acer Zhang
+# Datetime: 2021/9/14 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+
+import os
+import platform
+
+from tkinter import messagebox
+from ttkbootstrap import Style
+
+import cube_qgui as cqgui
+
+# 资源部分
+QGUI_BASE_PATH = os.path.dirname(cqgui.__file__)
+RESOURCES_PATH = os.path.join(QGUI_BASE_PATH, "resources")
+ICON_PATH = os.path.join(RESOURCES_PATH, "icon")
+THEME_PATH = os.path.join(QGUI_BASE_PATH, "theme/ttkbootstrap_themes.json")
+
+HORIZONTAL = "Horizontal水平方向"
+VERTICAL = "Vertical垂直方向"
+LEFT = "左侧"
+RIGHT = "右侧"
+TOP = "顶端"
+BOTTOM = "底部"
+
+
+# Tools部分
+class ConcurrencyModeFlag:
+    # QUEUE_ = "触发后相关事件会以队列的形式执行"
+    SAFE_CONCURRENCY_MODE_FLAG = "不允许并发，禁止触发下一个事件"
+    # FORCE_CONCURRENCY_MODE_FLAG = "不允许并发，下一个事件被触发时结束上一个事件"
+
+
+class QStyle:
+    default = {"theme": "qgui", "themes_file": THEME_PATH}
+
+    lumen = {"theme": "lumen"}
+
+    paddle = {"theme": "paddlelight", "themes_file": THEME_PATH}
+
+    paddle_dark = {"theme": "paddledark", "themes_file": THEME_PATH}
+
+    pytorch = {"theme": "pytorch", "themes_file": THEME_PATH}
+
+    tensorflow = {"theme": "tensorflow", "themes_file": THEME_PATH}
+
+
+class MessageBox:
+    @staticmethod
+    def info(text: str, title: str = "Info - QGUI"):
+        messagebox.showinfo(title, text)
+
+    @staticmethod
+    def warning(text: str, title: str = "Warning - QGUI"):
+        messagebox.showwarning(title, text)
+
+    @staticmethod
+    def error(text: str, title: str = "Error - QGUI"):
+        messagebox.showerror(title, text)
+
+
+def show_file_or_path(path, return_func=True):
+    def render(*args, **kwargs):
+        if platform.system().lower() == "darwin":
+            import subprocess
+            subprocess.call(["open", path])
+        else:
+            os.startfile(path)
+
+    if return_func:
+        return render
+    else:
+        return render()
+
+
+BLACK = "#24262d"
+GRAY = "#e3e3e3"
+GREEN = "#76b67e"
+FONT = "黑体"

cube_qgui/notebook_tools.py

@@ -0,0 +1,952 @@
+# Author: Acer Zhang
+# Datetime: 2021/9/16 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+
+from typing import List, Dict, Tuple
+from collections import OrderedDict
+
+import tkinter
+from tkinter import ttk
+from tkinter import filedialog
+
+from cube_qgui.manager import *
+from cube_qgui.base_tools import ConcurrencyModeFlag, check_callable, ArgInfo, select_var_dtype, BaseTool, make_anchor, \
+    make_side
+
+RUN_ICON = os.path.join(ICON_PATH, "play_w.png")
+
+LEFT_PAD_LEN = 10
+LABEL_WIDTH = 12
+INPUT_BOX_LEN = 70
+DEFAULT_PAD = 5
+
+
+class BaseNotebookTool(BaseTool):
+    """
+    基础Notebook工具集，提供基础异步Callback
+    1. 写Build，记得继承才会有self.master，继承时候传**kwargs
+    2. 若需返回信息，请重写get_info方法->ArgInfo
+    3. 如绑定func，需要封装Callback
+    """
+
+    def __init__(self,
+                 bind_func=None,
+                 name: str = None,
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 async_run: bool = False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         style=style,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode)
+        self.tab_index = tab_index
+        self.frame = frame
+
+
+class BaseChooseFileTextButton(BaseNotebookTool):
+    def __init__(self,
+                 bind_func=None,
+                 name: str = None,
+                 label_info: str = "Target File Path",
+                 entry_info: str = "Please select file path",
+                 button_info: str = "Select File",
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 async_run: bool = False,
+                 mode="file",
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func, name=name, style=style, tab_index=tab_index, async_run=async_run, frame=frame)
+
+        self.label_info = label_info
+        self.button_info = button_info
+        self.name = name
+        self.mode = mode
+
+        self.entry_var = tkinter.StringVar(value=entry_info)
+
+    def build(self, **kwargs) -> tkinter.Frame:
+        super().build(**kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=2)
+        label = ttk.Label(frame,
+                          text=self.label_info,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+        entry = ttk.Entry(frame,
+                          style=self.style + "info.TEntry",
+                          textvariable=self.entry_var)
+        entry.pack(side="left", fill="x", expand="yes", padx=5, pady=2)
+
+        if self.mode == "file":
+            if not hasattr(self, "filetypes"):
+                self.filetypes = [('All Files', '*')]
+
+            def render():
+                file_path = filedialog.askopenfilename(title="Select File",
+                                                       filetypes=self.filetypes)
+                if file_path:
+                    self.entry_var.set(file_path)
+
+        else:
+            def render():
+                file_path = filedialog.askdirectory(title="Select Directory")
+                if file_path:
+                    self.entry_var.set(file_path)
+
+        command = self._callback(self.bind_func, start_func=render) if self.bind_func else render
+        button = ttk.Button(frame,
+                            text=self.button_info,
+                            style=self.style + "TButton",
+                            command=command,
+                            width=12)
+        button.pack(side="right")
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo(name=field, set_func=self.entry_var.set, get_func=self.entry_var.get)
+
+        return arg_info
+
+
+class ChooseFileTextButton(BaseChooseFileTextButton):
+    def __init__(self,
+                 bind_func=None,
+                 name: str = None,
+                 label_info: str = "Target File Path",
+                 entry_info: str = "Please select file path",
+                 button_info: str = "Select File",
+                 filetypes: bool = None,
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 async_run: bool = False,
+                 frame: tkinter.Frame = None):
+        self.filetypes = [('All Files', '*')] if filetypes is None else filetypes
+
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         label_info=label_info,
+                         entry_info=entry_info,
+                         button_info=button_info,
+                         style=style,
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         frame=frame)
+
+
+class ChooseDirTextButton(BaseChooseFileTextButton):
+    def __init__(self,
+                 bind_func=None,
+                 name=None,
+                 label_info: str = "Target Directory Path",
+                 entry_info: str = "Please select directory path",
+                 button_info: str = "Select Directory",
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 async_run: bool = False,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         label_info=label_info,
+                         entry_info=entry_info,
+                         button_info=button_info,
+                         style=style,
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         mode="dir",
+                         frame=frame)
+
+
+class BaseButton(BaseNotebookTool):
+    def __init__(self,
+                 bind_func,
+                 name: str = None,
+                 text: str = "Start",
+                 icon: str = None,
+                 checked_text: str = None,
+                 async_run: bool = True,
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 concurrency_mode: bool = False,
+                 side: str = RIGHT,
+                 add_width=8,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func,
+                         name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         frame=frame)
+        self.text = text
+        self.checked_text = checked_text
+        self.add_width = add_width
+        self.side = side
+
+        self.icon = icon
+
+    def build(self, **kwargs) -> tkinter.Frame:
+        super().build(**kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5)
+        if self.icon:
+            self.icon = tkinter.PhotoImage(file=self.icon)
+        else:
+            self.icon = None
+
+        self.text_var = tkinter.StringVar(frame, value=self.text)
+
+        def click_btn():
+            self.btn.configure(style=self.style + "TButton")
+            self.btn.configure(state="disable")
+            if self.checked_text:
+                self.text_var.set(self.checked_text)
+
+        def done_btn():
+            self.btn.configure(style=self.style + "TButton")
+            self.btn.configure(state="normal")
+            self.text_var.set(self.text)
+
+        if not self.bind_func:
+            # 不知道为啥必须要有，不然文字不会显示，会头Debug一下
+            self.bind_func = lambda x: None
+        self.btn = ttk.Button(frame,
+                              textvariable=self.text_var,
+                              image=self.icon,
+                              width=len(self.text) + self.add_width,
+                              compound='left',
+                              command=self._callback(self.bind_func, click_btn, done_btn),
+                              style=self.style + "TButton")
+
+        self.btn.pack(side=make_side(self.side), padx=5, pady=5)
+        return frame
+
+
+class RunButton(BaseButton):
+    def __init__(self,
+                 bind_func,
+                 name: str = None,
+                 text: str = "Start Processing",
+                 checked_text: str = "Processing...",
+                 async_run: bool = True,
+                 style: str = "success",
+                 tab_index: int = 0,
+                 concurrency_mode: bool = False,
+                 side: str = RIGHT,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         text=text,
+                         checked_text=checked_text,
+                         async_run=async_run,
+                         style=style,
+                         tab_index=tab_index,
+                         concurrency_mode=concurrency_mode,
+                         add_width=6,
+                         icon=RUN_ICON,
+                         side=side,
+                         frame=frame)
+
+
+class InputBox(BaseNotebookTool):
+    def __init__(self,
+                 name: str = None,
+                 default: str = "Please input here...",
+                 label_info: str = "InputBox",
+                 style: str = "primary",
+                 tab_index=0,
+                 frame: tkinter.Frame = None):
+        super().__init__(name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         frame=frame)
+        self.input_vars = tkinter.StringVar(value=default)
+        self.label_info = label_info
+
+    def build(self, **kwargs):
+        super().build(**kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5)
+        label = ttk.Label(frame,
+                          text=self.label_info,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+
+        entry = ttk.Entry(frame,
+                          style=self.style + "info.TEntry",
+                          textvariable=self.input_vars,
+                          width=INPUT_BOX_LEN)
+        entry.pack(side="left", fill="x", padx=5, pady=2)
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo(name=field, set_func=self.input_vars.set, get_func=self.input_vars.get)
+
+        return arg_info
+
+
+class Combobox(BaseNotebookTool):
+    def __init__(self,
+                 bind_func=None,
+                 name=None,
+                 title: str = "Please select",
+                 options: List[str] = None,
+                 style="custom",
+                 tab_index=0,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         frame=frame)
+        self.title = title
+        self.options = options
+
+        self.options = options if options else ["--请选择--"]
+
+    def build(self, **kwargs):
+        super().build(**kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5)
+        label = ttk.Label(frame,
+                          text=self.title,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+        self.comb = ttk.Combobox(frame,
+                                 style=self.style + "TCombobox",
+                                 values=self.options)
+        self.comb.current(0)
+        if self.bind_func:
+            self.comb.bind('<<ComboboxSelected>>', self._callback(self.bind_func))
+        self.comb.pack(side="left", padx=5, pady=2)
+
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo(name=field, set_func=self.comb.set, get_func=self.comb.get)
+
+        return arg_info
+
+
+class Slider(BaseNotebookTool):
+    def __init__(self,
+                 name=None,
+                 title: str = "Please slide",
+                 default: int = 0,
+                 min_size: int = 0,
+                 max_size: int = 100,
+                 dtype=int,
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 frame: tkinter.Frame = None):
+        super().__init__(name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         frame=frame)
+        self.title = title
+        self.default = default
+        self.min_size = min_size
+        self.max_size = max_size
+        self.dtype = dtype
+
+    def slider_var_trace(self, *args):
+        v = self.scale.get()
+        self.value_var.set(f"Current: {self.dtype(v)}")
+
+    def build(self, **kwargs):
+        super().build(**kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5)
+
+        self.slider_var = select_var_dtype(self.dtype)(frame, value=self.default)
+        self.value_var = tkinter.StringVar(frame, value=f"Current: {self.default}")
+        self.slider_var.trace("w", self.slider_var_trace)
+
+        label = ttk.Label(frame,
+                          text=self.title,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+        self.scale = ttk.Scale(frame,
+                               from_=self.min_size,
+                               to=self.max_size,
+                               value=self.default,
+                               variable=self.slider_var)
+        # ToDo ttk 的Bug
+        # self.scale.configure(style="info.TSlider")
+        self.scale.pack(side="left", padx=5, fill="x", expand="yes")
+        self.value = ttk.Label(frame,
+                               textvariable=self.value_var,
+                               style="TLabel",
+                               width=LABEL_WIDTH)
+        self.value.pack(side="right")
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo(name=field, set_func=self.scale.set, get_func=self.scale.get)
+
+        return arg_info
+
+
+class BaseCheckButton(BaseNotebookTool):
+    def __init__(self,
+                 options: str or Tuple[str, bool] or List[Tuple[str, bool]],
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 button_style="TCheckbutton",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 mode=None,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         frame=frame)
+        self.title = title
+        self.mode = mode
+        if isinstance(options, str):
+            self.options = {options: 0}
+        if isinstance(options, tuple):
+            self.options = {options[0]: 1 if options[1] else 0}
+        if isinstance(options, list):
+            self.options = OrderedDict()
+            if len(options[0]) != 2:
+                raise TypeError(f"The 'options' arg of {self.__class__.__name__} should be str or List[Tuple[str, bool]] format\n"
+                                f"Example:\n"
+                                f"'选择框1' or [('选择1', 0), ('选择2', 1), ('选择3', 0)]")
+            for option in options:
+                self.options[option[0]] = 1 if option[1] else 0
+        self.button_style = button_style
+
+    def build(self, *args, **kwargs):
+        super().build(*args, **kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5)
+        label = ttk.Label(frame,
+                          text=self.title,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+
+        self.value_vars = dict()
+        for option in self.options:
+            self.value_vars[option] = tkinter.StringVar(frame, value=self.options[option])
+            if self.mode == "ToolButton":
+                pad_x = 0
+            else:
+                pad_x = 5
+            ttk.Checkbutton(frame,
+                            text=option,
+                            style=self.style + self.button_style,
+                            variable=self.value_vars[option],
+                            command=self._callback(self.bind_func)).pack(side="left", padx=pad_x)
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo()
+        for v in self.value_vars:
+            arg_info += ArgInfo(name=field + "-" + v, set_func=self.value_vars[v].set, get_func=self.value_vars[v].get)
+
+        return arg_info
+
+
+class CheckButton(BaseCheckButton):
+    def __init__(self,
+                 options: str or Tuple[str] or List[Tuple[str, bool]],
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(options=options,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="TCheckbutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         frame=frame)
+
+
+class CheckToolButton(BaseCheckButton):
+    def __init__(self,
+                 options: str or Tuple[str] or List[Tuple[str, bool]],
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="info",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(options=options,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="Toolbutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         mode="ToolButton",
+                         frame=frame)
+
+
+class CheckObviousToolButton(BaseCheckButton):
+    def __init__(self,
+                 options: str or Tuple[str] or List[Tuple[str, bool]],
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(options=options,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="Outline.Toolbutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         mode="ToolButton",
+                         frame=frame)
+
+
+class ToggleButton(BaseCheckButton):
+    def __init__(self,
+                 options: str or Tuple[str],
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        assert not isinstance(options, list), "There should be only one option for ToggleButton"
+        super().__init__(options=options,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="Roundtoggle.Toolbutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         frame=frame)
+
+
+class BaseRadioButton(BaseNotebookTool):
+    def __init__(self,
+                 options: str or List[str],
+                 default: str = None,
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 button_style="TRadiobutton",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 mode=None,
+                 frame: tkinter.Frame = None):
+        super().__init__(bind_func=bind_func,
+                         name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         frame=frame)
+        self.title = title
+        self.mode = mode
+        self.options = [options] if isinstance(options, str) else options
+        self.default = default if default else options[0]
+        self.button_style = button_style
+
+    def build(self, *args, **kwargs):
+        super().build(*args, **kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5)
+
+        label = ttk.Label(frame,
+                          text=self.title,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+
+        self.value_var = tkinter.StringVar(frame, value=self.options[0])
+        for option in self.options:
+            if self.mode == "ToolButton":
+                pad_x = 0
+            else:
+                pad_x = 5
+            ttk.Radiobutton(frame,
+                            text=option,
+                            style=self.style + self.button_style,
+                            variable=self.value_var,
+                            value=option,
+                            command=self._callback(self.bind_func)).pack(side="left", padx=pad_x)
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo(name=field, set_func=self.value_var.set, get_func=self.value_var.get)
+
+        return arg_info
+
+
+class RadioButton(BaseRadioButton):
+    def __init__(self,
+                 options: str or List[str],
+                 default: str = None,
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(options=options,
+                         default=default,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="TRadiobutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         mode=None,
+                         frame=frame)
+
+
+class RadioToolButton(BaseRadioButton):
+    def __init__(self,
+                 options: str or List[str],
+                 default: str = None,
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="info",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(options=options,
+                         default=default,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="Toolbutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         mode="ToolButton",
+                         frame=frame)
+
+
+class RadioObviousToolButton(BaseRadioButton):
+    def __init__(self,
+                 options: str or List[str],
+                 default: str = None,
+                 bind_func=None,
+                 name=None,
+                 title="Please select",
+                 style="primary",
+                 tab_index=0,
+                 async_run=False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(options=options,
+                         default=default,
+                         bind_func=bind_func,
+                         name=name,
+                         title=title,
+                         style=style,
+                         button_style="Outline.Toolbutton",
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         mode="ToolButton",
+                         frame=frame)
+
+
+class Progressbar(BaseNotebookTool):
+    def __init__(self,
+                 title: str = "Progressbar",
+                 default: int = 0,
+                 max_size: int = 100,
+                 name: str = None,
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 async_run: bool = False,
+                 concurrency_mode=ConcurrencyModeFlag.SAFE_CONCURRENCY_MODE_FLAG,
+                 frame: tkinter.Frame = None):
+        super().__init__(name=name,
+                         style=style,
+                         tab_index=tab_index,
+                         async_run=async_run,
+                         concurrency_mode=concurrency_mode,
+                         frame=frame)
+        self.title = title
+        self.default_value = default
+        self.max_size = max_size
+
+    def progressbar_var_trace(self, *args):
+        v = self.progressbar_var.get()
+        self.value_var.set(f"Progress {v:.2f}%")
+
+    def build(self, *args, **kwargs):
+        super().build(*args, **kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master, style="TFrame")
+            frame.pack(side="top", fill="x", padx=5, pady=5, expand="yes")
+
+        self.progressbar_var = tkinter.IntVar(frame, value=self.default_value)
+        self.value_var = tkinter.StringVar(frame, value=f"Progress: {self.default_value:.2f}%")
+        self.progressbar_var.trace("w", self.progressbar_var_trace)
+
+        label = ttk.Label(frame,
+                          text=self.title,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        label.pack(side="left")
+
+        progressbar = ttk.Progressbar(frame,
+                                      variable=self.progressbar_var,
+                                      style=self.style + "Striped.Horizontal.TProgressbar")
+        progressbar.pack(side="left", fill="x", expand="yes", padx=5, pady=2)
+
+        self.value = ttk.Label(frame,
+                               textvariable=self.value_var,
+                               style="TLabel",
+                               width=LABEL_WIDTH)
+        self.value.pack(side="left")
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        arg_info = ArgInfo(name=field, set_func=self.progressbar_var.set, get_func=self.progressbar_var.get)
+
+        return arg_info
+
+
+class BaseCombine(BaseNotebookTool):
+    def __init__(self,
+                 tools: BaseNotebookTool or List[BaseNotebookTool],
+                 side=HORIZONTAL,
+                 title: str = None,
+                 text: str = None,
+                 style: str = None,
+                 tab_index: int = None,
+                 frame: tkinter.Frame = None):
+        super().__init__(tab_index=tab_index, style=style, frame=frame)
+        self.side = "top" if side == HORIZONTAL else "left"
+        self.title = title
+        self.text = text
+
+        self.tools = tools if isinstance(tools, list) else [tools]
+
+        self.tab_index = tab_index if tab_index else self.tools[0].tab_index
+
+        for tool_id in range(len(self.tools)):
+            self.tools[tool_id].tab_index = self.tab_index
+
+    def get_arg_info(self) -> ArgInfo:
+        local_info = ArgInfo()
+        for tool_id in range(len(self.tools)):
+            local_info += self.tools[tool_id].get_arg_info()
+        return local_info
+
+
+class BaseFrameCombine(BaseCombine):
+    def build(self, *args, **kwargs):
+        super().build(self, *args, **kwargs)
+
+        if self.frame:
+            frame = self.frame
+        else:
+            style_mode = "TLabelframe" if self.title else "TFrame"
+            if self.title:
+                frame = ttk.LabelFrame(self.master, text=self.title, style=self.style + style_mode)
+            else:
+                frame = ttk.Frame(self.master, text=self.title, style=self.style + style_mode)
+            frame.pack(side="left", anchor="nw", fill="both", expand="yes", padx=DEFAULT_PAD, pady=DEFAULT_PAD)
+        if self.text:
+            label = ttk.Label(frame,
+                              text=self.text,
+                              style="TLabel")
+            label.pack(side="top", anchor="nw", padx=5)
+        for tool in self.tools:
+            kwargs["master"] = frame
+            tool.build(*args, **kwargs)
+        return frame
+
+
+class HorizontalFrameCombine(BaseFrameCombine):
+    def __init__(self,
+                 tools: BaseNotebookTool or List[BaseNotebookTool],
+                 title=None,
+                 style: str = None,
+                 text: str = None,
+                 tab_index: int = 0,
+                 frame: tkinter.Frame = None):
+        super().__init__(tools=tools,
+                         side=HORIZONTAL,
+                         title=title,
+                         style=style,
+                         text=text,
+                         tab_index=tab_index,
+                         frame=frame)
+
+
+class VerticalFrameCombine(BaseFrameCombine):
+    def __init__(self,
+                 tools: BaseNotebookTool or List[BaseNotebookTool],
+                 title=None,
+                 style: str = None,
+                 text: str = None,
+                 tab_index: int = 0,
+                 frame: tkinter.Frame = None):
+        super().__init__(tools=tools,
+                         side=VERTICAL,
+                         title=title,
+                         style=style,
+                         text=text,
+                         tab_index=tab_index,
+                         frame=frame)
+
+
+class HorizontalToolsCombine(BaseCombine):
+    def __init__(self,
+                 tools: BaseNotebookTool or List[BaseNotebookTool],
+                 title=None,
+                 style: str = None,
+                 text: str = None,
+                 tab_index: int = None,
+                 frame: tkinter.Frame = None):
+        super().__init__(tools=tools,
+                         side=HORIZONTAL,
+                         title=title,
+                         style=style,
+                         text=text,
+                         tab_index=tab_index,
+                         frame=frame)
+
+    def build(self, *args, **kwargs):
+        super().build(self, *args, **kwargs)
+
+        style_mode = "TLabelframe" if self.title else "TFrame"
+        if self.title:
+            frame = ttk.LabelFrame(self.master, text=self.title, style=self.style + style_mode)
+        else:
+            frame = ttk.Frame(self.master, style=self.style + style_mode)
+        frame.pack(side="top", fill="x", padx=DEFAULT_PAD, pady=DEFAULT_PAD)
+        if self.text:
+            label = ttk.Label(frame,
+                              text=self.text,
+                              style="TLabel")
+            label.pack(side="top", anchor="nw", padx=DEFAULT_PAD)
+        for tool in self.tools:
+            kwargs["master"] = self.frame
+            tool.frame = frame
+            tool.build(*args, **kwargs)
+        return frame
+
+
+class Label(BaseNotebookTool):
+    def __init__(self,
+                 name: str = None,
+                 text: str = None,
+                 title: str = None,
+                 alignment: str = LEFT + TOP,
+                 style: str = "primary",
+                 tab_index: int = 0,
+                 frame: tkinter.Frame = None):
+        super(Label, self).__init__(name=name,
+                                    style=style,
+                                    tab_index=tab_index,
+                                    frame=frame)
+        self.text = text
+        self.title = title
+        self.alignment = alignment
+
+        self.label_var = tkinter.StringVar(value=self.text)
+
+    def build(self, *args, **kwargs) -> tkinter.Frame:
+        super(Label, self).build(*args, **kwargs)
+        if self.frame:
+            frame = self.frame
+        else:
+            frame = ttk.Frame(self.master)
+            frame.pack(side="top", fill="both", padx=DEFAULT_PAD, pady=DEFAULT_PAD)
+
+        title = ttk.Label(frame,
+                          text=self.title,
+                          style="TLabel",
+                          width=LABEL_WIDTH)
+        title.pack(side="left")
+
+        label = ttk.Label(frame,
+                          text=self.text,
+                          textvariable=self.label_var,
+                          style="TLabel")
+        # make_anchor(self.alignment)
+        label.pack(anchor=make_anchor(self.alignment), padx=DEFAULT_PAD)
+        return frame
+
+    def get_arg_info(self) -> ArgInfo:
+        field = self.name if self.name else self.__class__.__name__
+        local_info = ArgInfo(field, set_func=self.label_var.set, get_func=self.label_var.get)
+        return local_info

cube_qgui/os_tools.py

@@ -0,0 +1,45 @@
+# Author: Acer Zhang
+# Datetime: 2021/9/17 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.
+import sys
+
+
+class StdOutWrapper:
+    def __init__(self, stdout, callback=None, do_print=True):
+        self.buff = ""
+        self.stdout = stdout
+        self.callback = callback
+        self.do_print = do_print
+
+    def write(self, output_stream):
+        self.buff += output_stream
+        if self.do_print:
+            self.stdout.write(output_stream)
+        if self.callback and ("\n" in self.buff or "\r" in output_stream):
+            self.callback(self.buff)
+            self.buff = ""
+
+    def flush(self):
+        self.buff = ""
+
+    def __del__(self):
+        sys.stdout = self.stdout
+
+
+class DataCache:
+    def __init__(self, seq_len=10, cache=7):
+        assert seq_len >= cache, "请设置seq_len的值低于cache"
+        self.seq_len = seq_len
+        self.cache = cache
+        self.seq = list()
+
+    def add(self, item):
+        if len(self.seq) == self.seq_len:
+            for i in range(self.seq_len - self.cache):
+                self.seq.pop(0)
+        self.seq.append(item)
+
+    def __add__(self, other):
+        self.add(other)
+        return self

cube_qgui/theme/ttkbootstrap_themes.json

@@ -0,0 +1,104 @@
+{
+	"themes": [
+		{
+			"name": "paddlelight",
+			"font": "Helvetica 10",
+			"type": "light",
+			"colors": {
+				"primary": "#2932e1",
+				"secondary": "#4e9bf8",
+				"success": "#18bc9c",
+				"info": "#3498db",
+				"warning": "#f39c12",
+				"danger": "#e74c3c",
+				"bg": "#ffffff",
+				"fg": "#212529",
+				"selectbg": "#95a5a6",
+				"selectfg": "#ffffff",
+				"border": "#ced4da",
+				"inputfg": "#212529",
+				"inputbg": "#ecf0f1"
+			}
+		},
+		{
+			"name": "paddledark",
+			"font": "Helvetica 10",
+			"type": "dark",
+			"colors": {
+				"primary": "#2932e1",
+				"secondary": "#4e9bf8",
+				"success": "#00bc8c",
+				"info": "#3498db",
+				"warning": "#f39c12",
+				"danger": "#e74c3c",
+				"bg": "#666666",
+				"fg": "#ffffff",
+				"selectbg": "#444444",
+				"selectfg": "#ffffff",
+				"border": "#222222",
+				"inputfg": "#333333",
+				"inputbg": "#adb5bd"
+			}
+		},
+		{
+			"name": "pytorch",
+			"font": "Helvetica 10",
+			"type": "light",
+			"colors": {
+				"primary": "#ee4c2c",
+				"secondary": "#db593a",
+				"success": "#18bc9c",
+				"info": "#3498db",
+				"warning": "#f39c12",
+				"danger": "#e74c3c",
+				"bg": "#ffffff",
+				"fg": "#212529",
+				"selectbg": "#321e5d",
+				"selectfg": "#ffffff",
+				"border": "#ced4da",
+				"inputfg": "#212529",
+				"inputbg": "#ecf0f1"
+			}
+		},
+		{
+			"name": "tensorflow",
+			"font": "Helvetica 10",
+			"type": "light",
+			"colors": {
+				"primary": "#ed722f",
+				"secondary": "#95a5a6",
+				"success": "#18bc9c",
+				"info": "#3498db",
+				"warning": "#f39c12",
+				"danger": "#e74c3c",
+				"bg": "#ffffff",
+				"fg": "#212529",
+				"selectbg": "#95a5a6",
+				"selectfg": "#ffffff",
+				"border": "#ced4da",
+				"inputfg": "#212529",
+				"inputbg": "#ecf0f1"
+			}
+		},
+		{
+			"name": "qgui",
+			"font": "Helvetica 10",
+			"type": "light",
+			"colors": {
+				"primary": "#2c3e50",
+				"secondary": "#4e9bf8",
+				"success": "#18bc9c",
+				"info": "#3498db",
+				"warning": "#f39c12",
+				"danger": "#e74c3c",
+				"bg": "#ffffff",
+				"fg": "#212529",
+				"selectbg": "#95a5a6",
+				"selectfg": "#ffffff",
+				"border": "#ced4da",
+				"inputfg": "#212529",
+				"inputbg": "#ecf0f1"
+			}
+		}
+	]
+}

cube_qgui/third_party/__init__.py

@@ -0,0 +1,4 @@
+# Author: Acer Zhang
+# Datetime: 2021/9/17 
+# Copyright belongs to the author.
+# Please indicate the source for reprinting.