首发于中文编程
草蟒 Python 中文 API 与 VS Code 支持尝鲜

草蟒 Python 中文 API 与 VS Code 支持尝鲜

2020-6-15 更:祝贺草蟒在 OSChina 发表!草蟒首页、文档和下载 - Python 汉化版 - OSCHINA


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

英文版 python 用户能够充分体验中文编程的 模块有<海龟 (turtle)>、<随机数 (random)>和<图快 (tkinter)>。

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

海龟(turtle)

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

from 海龟 import *

颜色('黄色', '红色')
开始填充()

for i in range(5):
    前进(200)
    右转(144)

结束填充()
完成()

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

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

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

图快(tkinter)

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

import 图快

窗口 = 图快.主窗口类()
窗口.标题('图形应用程序')
窗口.尺寸('500x300+600+300')

def 登录():
    登录窗口 = 图快.顶级窗口类(窗口)
    登录窗口.标题('请登录...')
    登录窗口.尺寸('200x200+750+350')

登录按钮 = 图快.按钮类(文本='登录', 命令=登录)
登录按钮.位置布局(相对x=0.5, 相对y=0.5)

窗口.主循环()

中英 API 代码对比:

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 下测试。可以看到中文文档:

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

草蟒

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

2020-1-17 补原作者发布的草蟒入门视频:

知乎视频www.zhihu.com图标

始于足下

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

拭目以待!

编辑于 06-16

文章被以下专栏收录

    在所有编程语言和领域中尝试编写中文代码,开发相关工具,总结经验,一致代码风格。包括中文命名,汉化现有语言,创造中文语法的编程语言等等。作为最熟悉的母语,用来编写代码会让代码更容易被自己和母语相同的其他开发者理解。基于英文的编程语言和框架中,使用中文命名有时有技术问题。希望这里为后人趟雷,填坑。多数现有API是英文的,这里也会对其中一些常用的进行汉化。当然,这里也会对基于中文的编程语言进行探讨。包括汉化基于英文的编程语言,以及创造新的编程语言。