Skip to main content

The tkintertools is an auxiliary development module of the Python3 built-in module tkinter.

Project description

🚀tkintertools🚀

Logo

tkintertools 是 Python3 内置模块 tkinter 的一个辅助开发模块
The tkintertools is an auxiliary development module of the Python3 built-in module tkinter

Version License ChangeLog ToDo Size Wiki
Downloads Owner Blog Email

Insights

Install/模块安装👇

Stable Version/稳定版本

  • Version/最新版本 : 2.6.9
  • Release/发布日期 : 2023/08/09 (UTC+08)

这个是目前的最新稳定版,相对于开发版本而言比较稳定,bug 大体上是没有那么多的,推荐使用这个。稳定版和开发版相比,它在发布之前有个测试的步骤,经过测试之后(各项功能正常运行,多平台兼容)才会发布。

PIP Cmd/安装命令:

pip install tkintertools==2.6.9

Development Version/开发版本

  • Version/最新版本 : 2.6.10.dev1 (第 2 个预发布版本)
  • Release/发布日期 : 2023/08/11 (UTC+08)

这个是我正在开发的版本,可能有新功能,bug 可能会比较多,但也可能会比原来的版本更加稳定。开发版没有经过多操作系统的测试,仅能保证在 Windows 系统下运行所有功能,在其他的操作系统上,可能有部分功能无法正常运行。大家可以在 Issues 中提出一些建议,我可能会适当采纳一些并在开发版本中更改或实现。

PIP Cmd/安装命令:

pip install tkintertools==2.6.10.dev1

Warning
开发版仅作示例,各函数或类的 API 并非最终确定结果,直接使用开发版可能导致后续无法与稳定版兼容!
若不指定具体的版本号,则会下载最新的稳定版本,也就是说,开发版本只能通过指定的版本号获取!

Requirements/环境需求

目前 稳定版 在以下操作系统中已经测试通过:

Windows10 Windows11 Ubuntu22.04

可能还有其他的操作系统也是可以运行 tkintertools 的,我没有进行更多的验证。
没有任何额外的依赖包(除了一般 Python 内置的 tkinter),但只支持以下 Python 版本:

Python3.8.* Python3.9.* Python3.10.* Python3.11.* Python3.12.*

如果拥有 PIL 库,则 tkintertools 会运行得更快,但 PIL 并不是必须的,没有 PIL 的情况下 tkintertools 依然可以正常使用。

News/最新功能👇

Release Notes/版本说明

最新版本: tkintertools-v2.6.10.dev1

Note
tkintertools 的介绍、使用教程和开发文档均在 Wiki 中,大家可前往查阅

下面是本次开发版本(v2.6.9 -> v2.6.10.dev1)的更新内容条目:

  • Added file exceptions.py and exception classes ScaleArgsValueError, ColorArgsValueError and WidgetStateModeError to provide a description of some exceptions
    新增文件 exceptions.py 及异常类 ScaleArgsValueErrorColorArgsValueErrorWidgetStateModeError 以提供部分异常的描述
  • The widget Progressbar adds a indeterminate mode
    控件 Progressbar 新增不定模式
  • The value of the constant SWITCH_WIDTH is changed from 0 to 60
    常量 SWITCH_WIDTH 的值从 0 更改为 60
  • The parameter width of class Switch was changed from positional argument to keyword argument
    Switch 的参数 width 由位置参数更改为关键字参数
  • Change the way the output is formatted in all code from the "%" mode to the more efficient f-string mode
    将所有代码中格式化输出的方式由 “%” 方式更改为效率更高的 f-string 方式
  • Optimized type hints for some code
    优化了部分代码的类型提示
  • Remove the function text and use f-string instead
    移除函数 text,可使用 f-string 来对其进行代替

Template Demo/模板演示

下面是一个主要新功能的示例程序:进度条控件为不定模式

下面是示例程序的效果图(运行环境为 Windows11 家庭中文版 23H2 - Python3.11.4):

news

CODE/源代码
# 此处只展示核心代码

pb = tkt.Progressbar(canvas, 320, 320, 640, 35, mode='indeterminate')  # 不定模式
pb.load(0.7)  # 加载到 70% 的状态

More/更多👇

GitHub Gitee GitCode
GitHub Watchers GitHub Forks GitHub Stars GitHub Contributors GitHub Issues GitHub Pull Requests

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tkintertools-2.6.10.dev1.tar.gz (34.4 kB view hashes)

Uploaded Source

Built Distribution

tkintertools-2.6.10.dev1-py3-none-any.whl (32.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page