Metadata-Version: 2.1
Name: tkintertools
Version: 3.0.0rc1
Summary: tkintertools is a UI framework based on the Canvas class of tkinter
Author-email: Xiaokang2022 <2951256653@qq.com>
Maintainer-email: Xiaokang2022 <2951256653@qq.com>
License: MIT License
Project-URL: Bug tracker, https://github.com/Xiaokang2022/tkintertools/issues
Project-URL: Changelog, https://xiaokang2022.github.io/tkintertools/CHANGELOG/
Project-URL: Documentation, https://xiaokang2022.github.io/tkintertools/
Project-URL: Donate, https://xiaokang2022.github.io/tkintertools/Sponsor/
Project-URL: Homepage, https://xiaokang2022.github.io/tkintertools/
Project-URL: Source code, https://github.com/Xiaokang2022/tkintertools
Keywords: tkinter,tkintertools,gui,ui,cross-platform,themed
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Widget Sets
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Provides-Extra: recommended
Requires-Dist: darkdetect==0.8.0; platform_system != "Darwin" and extra == "recommended"
Requires-Dist: darkdetect[macos-listener]==0.8.0; platform_system == "Darwin" and extra == "recommended"
Requires-Dist: pywinstyles==1.8; platform_system == "Windows" and extra == "recommended"
Requires-Dist: pillow>=10.0.0; extra == "recommended"
Provides-Extra: all
Requires-Dist: darkdetect==0.8.0; platform_system != "Darwin" and extra == "all"
Requires-Dist: darkdetect[macos-listener]==0.8.0; platform_system == "Darwin" and extra == "all"
Requires-Dist: pywinstyles==1.8; platform_system == "Windows" and extra == "all"
Requires-Dist: hPyT==1.3.2; platform_system == "Windows" and extra == "all"
Requires-Dist: win32material==1.0.6; platform_system == "Windows" and extra == "all"
Requires-Dist: pillow>=10.0.0; extra == "all"
Provides-Extra: extension
Requires-Dist: tkintertools-mpl; extra == "extension"
Requires-Dist: tkintertools-3d; extra == "extension"

> [!IMPORTANT]  
> ~~Due to the growing nature of the project, the original name `tkintertools` is no longer in line with its original intended, so the project is going to be renamed to "tkinter advanced canvas UI framework" (`tacUI`) in version `3.0.0.rc1`. If you have any other ideas or suggestions, you can put them in the [Discussions](https://github.com/Xiaokang2022/tkintertools/discussions).~~  
> ~~由于本项目的不断壮大，原名称 `tkintertools` 已不符合其本意，故本项目准备在进入 `3.0.0.rc1` 版本时更名为 “tkinter advanced canvas UI framework”（`tacUI`）。如有其它想法或建议，可在[讨论区](https://github.com/Xiaokang2022/tkintertools/discussions)中提出。~~  
>   
> Originally, it was planned to change the name of the project when the version was *3.0.0.rc1*, but due to the inconvenience of some users to change the dependency, the name will not be changed for the time being, and may not be changed in the future.  
> 原计划在版本为 *3.0.0.rc1* 时更改项目的名称，但鉴于部分使用者不方便更改依赖，故名称暂时不再更改，后续可能也不再更改。

<h1 align="center">tkintertools</h1>

<p align="center"><img alt="logo" src="https://xiaokang2022.github.io/tkintertools/logo.png" title="Logo" /></p>

<p align="center">
<code>tkintertools</code> 是一个基于 <code>tkinter</code> 的 <code>Canvas</code> 类的 UI 框架
<br/>
<code>tkintertools</code> is a UI framework based on the <code>Canvas</code> class of <code>tkinter</code>
</p>

<p align="center">
<a href="https://github.com/Xiaokang2022/tkintertools/releases"><img alt="Version" src="https://img.shields.io/github/v/release/Xiaokang2022/tkintertools?include_prereleases&logo=github&label=Version" title="Latest Version" /></a>
<a href="https://pypistats.org/packages/tkintertools"><img alt="Downloads" src="https://img.shields.io/pypi/dm/tkintertools?label=Downloads&logo=pypi&logoColor=skyblue" title="Downloads" /></a>
<a href="https://pepy.tech/project/tkintertools"><img alt="Total Downloads" src="https://img.shields.io/pepy/dt/tkintertools?logo=pypi&logoColor=gold&label=Total%20Downloads" title="Total Downloads" /></a>
<a href="https://github.com/Xiaokang2022/tkintertools"><img alt="Size" src="https://img.shields.io/github/languages/code-size/Xiaokang2022/tkintertools?label=Size&logo=github" title="Code Size"/></a>
<br/>
<a href="https://github.com/Xiaokang2022/tkintertools/watchers"><img alt="Watchers" src="https://img.shields.io/github/watchers/Xiaokang2022/tkintertools?label=Watchers&logo=github&style=flat" title="Watchers" /></a>
<a href="https://github.com/Xiaokang2022/tkintertools/forks"><img alt="Forks" src="https://img.shields.io/github/forks/Xiaokang2022/tkintertools?label=Forks&logo=github&style=flat" title="Forks" /></a>
<a href="https://github.com/Xiaokang2022/tkintertools/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/Xiaokang2022/tkintertools?label=Stars&color=gold&logo=github&style=flat" title="Stars" /></a>
<a href="https://github.com/Xiaokang2022/tkintertools/issues"><img alt="Issues" src="https://img.shields.io/github/issues/Xiaokang2022/tkintertools?label=Issues&logo=github" title="Issues" /></a>
<a href="https://github.com/Xiaokang2022/tkintertools/pulls"><img alt="Pull Requests" src="https://img.shields.io/github/issues-pr/Xiaokang2022/tkintertools?label=Pull%20Requests&logo=github" title="Pull Requests" /></a>
<a href="https://github.com/Xiaokang2022/tkintertools/discussions"><img alt="Discussions" src="https://img.shields.io/github/discussions/Xiaokang2022/tkintertools?label=Discussions&logo=github" title="Discussions" /></a>
</p>

<p align="center">
<a href="https://github.com/Xiaokang2022/tkintertools/pulse"><img alt="Insights" src="https://repobeats.axiom.co/api/embed/ab8fae686a5a96f91fa71c40c53c189310924f5e.svg" /></a>
</p>

<p align="center">
    <a href="https://star-history.com/#Xiaokang2022/tkintertools&Date">
        <picture>
            <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Xiaokang2022/tkintertools&type=Date&theme=dark" />
            <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Xiaokang2022/tkintertools&type=Date" />
            <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Xiaokang2022/tkintertools&type=Date" />
        </picture>
    </a>
</p>

📦 Installation / 安装
----------------------

### ✅ Stable Version / 稳定版本

* 🔖 Version / 最新版本 : `2.6.21`
* 🕓 Release / 发布日期 : 2024-01-01
* ✨ Feature / 更新内容 : [News-2.6.21](https://xiaokang2022.github.io/tkintertools/news/2.6.21/News/)

```bash
pip install tkintertools
```

<details open><summary>👁️ Preview / 预览</summary>

[![Preview UI](https://xiaokang2022.github.io/tkintertools/tutorials/images/1.2-2.1-2.png)](https://xiaokang2022.github.io/tkintertools/tutorials/1-2/#21-%E9%AB%98%E5%BA%A6%E5%8F%AF%E9%85%8D%E7%BD%AE%E7%9A%84%E6%8E%A7%E4%BB%B6)

[![Preview 3D](https://xiaokang2022.github.io/tkintertools/tutorials/images/7.3-3.1-2.png)](https://xiaokang2022.github.io/tkintertools/tutorials/7-3/#%E4%B8%89%E9%80%9A%E8%BF%87-after-%E6%96%B9%E6%B3%95%E5%AE%9E%E7%8E%B0%E7%AE%80%E5%8D%95%E5%8A%A8%E7%94%BB)

</details>

### 🔥 Development Version / 开发版本

* 🔖 Version / 最新版本 : `3.0.0.rc1`
* 🕓 Release / 发布日期 : 2024-08-08
* ✨ Feature / 更新内容 : [News-3.0.0](https://xiaokang2022.github.io/tkintertools/news/3.0.0/News/)

```bash
pip install tkintertools[recommended]==3.0.0.rc1
```

* Demos / 演示: https://github.com/Xiaokang2022/tkintertools-demos

<details open><summary>👁️ Preview / 预览</summary>

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo0-1.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo0-2.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo1-1.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo1-2.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo2.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo3.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo4-1.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo4-2.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo5-1.png?raw=true)

![](https://github.com/Xiaokang2022/tkintertools-demos/blob/main/preview/demo5-2.png?raw=true)

</details>

📦 Dependency / 依赖包
----------------------

> [!NOTE]  
> All dependencies are listed in [*requirements.txt*](./requirements.txt), but optional packages don't have to be installed  
> 所有的依赖包均会在 [*requirements.txt*](./requirements.txt) 中列出，但可选包并不一定要安装

### 📌 Required Packages / 必需包

Not yet  
暂无

### 🎨 Optional Packages / 可选包

Considering that too many packages will result in a large size of the project file when packing, the optional packages selected below are recommended to be installed  
考虑到调用的包过多将导致打包时项目文件的大小过大，因此下面被选中的可选包是推荐安装的

- [X] [darkdetect](https://github.com/albertosottile/darkdetect) - `0.8.0`
- [X] [pywinstyles](https://github.com/Akascape/py-window-styles) - `1.8`
- [X] [pillow](https://github.com/python-pillow/Pillow) - `>=10.0.0`
- [ ] [hPyT](https://github.com/Zingzy/hPyT) - `1.3.2`
- [ ] [win32material](https://github.com/littlewhitecloud/win32style) - `1.0.6`

The following command installs the recommended optional dependencies:  
以下命令可以安装推荐的可选依赖包：

```bash
pip install tkintertools[recommended]==3.0.0.rc1
```

The following command installs all optional dependencies:  
以下命令可以安装全部可选依赖包：

```bash
pip install tkintertools[all]==3.0.0.rc1
```

📦 Extention / 扩展包
---------------------

In addition to the basic functionality, `tkintertools` also offers some extension packages to implement certain functionality. The following official extensions are available:  
除了基础功能之外，`tkintertools` 还提供一些扩展包来实现某些特定的功能。目前已有的官方扩展包如下：

- [X] [tkintertools-mpl](https://github.com/Xiaokang2022/tkintertools-mpl) - `1.0.0`
- [X] [tkintertools-3d](https://github.com/Xiaokang2022/tkintertools-3d) - `1.0.0`

The following command can be used to install all the official extensions:  
以下命令可以安装全部的官方扩展包：

```bash
pip install tkintertools[extention]==3.0.0.rc1
```

👀 More / 更多
--------------

* 📋 Todo / 待办事项: [*TODO.md*](TODO.md)
* 📑 License / 项目许可: [*LICENSE.txt*](LICENSE.txt)
* 📘 Changelog / 更新日志: [*CHANGELOG.md*](CHANGELOG.md)
* 📕 Security Policy / 安全策略: [*SECURITY.md*](SECURITY.md)
* 📗 Contribution Guide / 贡献指南: [*CONTRIBUTING.md*](CONTRIBUTING.md)
* 📙 Code of Conduct / 行为准则: [*CODE_OF_CONDUCT.md*](CODE_OF_CONDUCT.md)
* 📚 Tutorials and Documents / 教程和文档: [Tutorials & Documents](https://xiaokang2022.github.io/tkintertools/)
* ❤️ Sponsor this Project / 赞助此项目: [Sponsor](https://xiaokang2022.github.io/tkintertools/Sponsor/)
* 🚀 Repository Mirrors / 存储库镜像源:
[GitHub](https://github.com/Xiaokang2022/tkintertools) |
[Gitee](https://gitee.com/Xiaokang2022/tkintertools) |
[GitCode](https://gitcode.com/Xiaokang2022/tkintertools/overview)
