Metadata-Version: 2.1
Name: tkintertools
Version: 3.0.0b2
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
        
        Copyright (c) 2024 Xiaokang2022
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
Project-URL: Source, https://github.com/Xiaokang2022/tkintertools
Project-URL: Homepage, https://xiaokang2022.github.io/tkintertools/
Project-URL: Bug Reports, https://github.com/Xiaokang2022/tkintertools/issues
Keywords: tkinter,tkintertools,gui,ui,3d,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
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: darkdetect
Requires-Dist: darkdetect[macos-listener]

> [!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 discussion forum.  
> 由于本项目的不断壮大，原名称 `tkintertools` 已不符合其本意，故本项目准备在进入 `3.0.0.rc1` 版本时更名为 “tkinter advanced canvas UI framework”（`tacUI`）。如有其它想法或建议，可在讨论区中提出。

<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="./LICENSE.txt"><img alt="License" src="https://img.shields.io/github/license/Xiaokang2022/tkintertools?logo=github&label=License" title="License" /></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://static.pepy.tech/badge/tkintertools" 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/)

```sh
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.beta2`
* 🕓 Release - 发布日期 : 2024-06-03
* ✨ Feature - 更新内容 : [News-3.0.0b2](https://xiaokang2022.github.io/tkintertools/news/3.0.0/News/)

```sh
pip install tkintertools==3.0.0b2
```

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

* **Windows 11 Dark Theme**

![Light - Win11](https://xiaokang2022.github.io/tkintertools/news/3.0.0/dark-win11.png)

* **Windows 10 Light Theme**

![Dark - Win10](https://xiaokang2022.github.io/tkintertools/news/3.0.0/light-win10.png)

* **Ubuntu 24.04 (GNOME) Dark Theme**

![Light - Ubuntu](https://xiaokang2022.github.io/tkintertools/news/3.0.0/dark-ubuntu.png)

* **Kubuntu 24.04 (KDE) Light Theme**

![Light - Kubuntu](https://xiaokang2022.github.io/tkintertools/news/3.0.0/light-kubuntu.png)

* **macOS Dark Theme**

![Dark - MacOS](https://xiaokang2022.github.io/tkintertools/news/3.0.0/dark-mac.png)

</details>

> [!WARNING]  
> `tkt 2.*` has been discontinued, for new features, please use `tkt 3.*`. Also note that `tkt 3.*` is almost completely incompatible with `tkt 2.*`, and porting a project from `tkt 2.*` to `tkt 3.*` can be difficult.  
> `tkt 2.*` 已放弃支持，如需获取新的功能，请使用 `tkt 3.*`。同时请注意，`tkt 3.*` 与 `tkt 2.*` 几乎完全不兼容，将项目从 `tkt 2.*` 移植到 `tkt 3.*` 可能会十分困难。

📦 Dependency packages - 依赖包
-------------------------------

### 1️⃣ darkdetect

* 🔖 Version - 版本 : `0.8.0`
* 📑 License - 许可 : BSD 3-Clause
* 🔗 GitHub - 仓库 : [darkdetect](https://github.com/albertosottile/darkdetect)

👀 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/)
* 🚀 Repository Mirrors - 存储库镜像源:
[GitHub](https://github.com/Xiaokang2022/tkintertools) |
[Gitee](https://gitee.com/xiaokang-2022/tkintertools) |
[GitCode](https://gitcode.com/Xiaokang2022/tkintertools/overview)
