祝贺新中文 API 发布到 Python 库平台 pypi。它是一个Python3 汉化版——“草蟒”的一部分,其中的第三方库对 Python3 英文版也适用。下面节选自 pypi 简介:

英文版 python 用户能够充分体验中文编程的 模块有、和。

下面就在英文 Python 3.8.1 下对这个第三方库试用一二。

海龟(turtle)

参考官网入门文档中的画五角星演示,只将官网例程的中文关键字改为了英文的:

from 海龟 import *颜色('黄色', '红色')开始填充()for i in range(5):    前进(200)    右转(144)结束填充()完成()

使用中英 API 的代码对比如下:




pythonAPI官方文档 python中文api文档_pythonAPI官方文档


代码可读性看官自断,不用多说。

视觉效果上,如在代码中进行中文命名(类/变量/方法等)的优势中所提,中文的更加齐整。

图快(tkinter)

参考官网入门文档中的示例 16的英文关键字版:

import 图快窗口 = 图快.主窗口类()窗口.标题('图形应用程序')窗口.尺寸('500x300+600+300')def 登录():    登录窗口 = 图快.顶级窗口类(窗口)    登录窗口.标题('请登录...')    登录窗口.尺寸('200x200+750+350')登录按钮 = 图快.按钮类(文本='登录', 命令=登录)登录按钮.位置布局(相对x=0.5, 相对y=0.5)窗口.主循环()

中英 API 代码对比:


pythonAPI官方文档 python中文api文档_python汉化_02


API 的命名有些讲究。“类”后缀的思路与前文的“方法一”一致。参数命名也完成了汉化。

很值得一提的是,某些命名不拘泥于直译,而是从功能出发进行改进,比如Toplevel的功能:

Toplevel widgets work as windows that are directly managed by the window manager. They do not necessarily have a parent widget on top of them.

既然功能就是窗口,命名为顶级窗口类更加一目了然。类似这样将功能本质和中文特性结合的命名风格探索对于中文 API 的发展会很有助益(另参考前文末尾)。

VS Code 支持

使用微软的 Python 插件,在 Windows 下测试。可以看到中文文档:


pythonAPI官方文档 python中文api文档_第三方库_03


输入中文 API 的第一个字有自动补全弹窗,包括对应说明:


pythonAPI官方文档 python中文api文档_python中文_04


草蟒

这些第三方库之外,草蟒还实现了 Python 关键字和几个核心库的汉化,并开发了允许中文标点符号等等功能的 VSC 插件,有兴趣的不妨一试。

始于足下

这个中文 API 是周蟒之后个人看到的,发布在英文编程语言的第三方库平台的最大规模的中文库项目。 对于內建中文文档、中文API命名、打包发布等等技术细节都进行了较全面验证。期待库的文档、测试等等早日跟上。

拭目以待!