【安装：pip install ulang，用法与例程请见 PyPI。源码位于开源中国。 注意：必需 python 3.7，源码文件需 UTF-8 编码】
本周将 Python 框架 tornado自带的用 websocket 实现聊天的例程改为木兰实现。顺便将该例程涉及的木兰与 Python 语法对比小结，包括本周重现的 super 语法等。
1 实例演示
主要木兰代码如下（完整代码在此）
type 聊天渠道 : tornado.websocket.WebSocketHandler {
{
接收端 = set()
历史 = []
历史长度 = 200
}
func $get_compression_options {
// Non-None enables compression with default options.
return {:}
}
func $open {
聊天渠道.接收端.add($)
}
func $on_close {
聊天渠道.接收端.remove($)
}
func 更新历史(消息) {
// 必须指定类
聊天渠道.历史.append(消息)
if len(聊天渠道.历史) > 聊天渠道.历史长度 {
聊天渠道.历史 = 聊天渠道.历史[-聊天渠道.历史长度 :]
}
}
func 广播(消息) {
logging.info("发到%d个接收端", len(聊天渠道.接收端))
for 某接收端 in 聊天渠道.接收端 {
// TODO: try catch 尚待重现
//try:
某接收端.write_message(消息)
//except:
// logging.error("Error sending message", exc_info=True)
}
}
func $on_message(内容) {
logging.info("收到消息: %r", 内容)
parsed = tornado.escape.json_decode(内容)
消息 = {"id": str(uuid.uuid4()), "body": parsed["body"]}
消息["html"] = tornado.escape.to_basestring(
$render_string("message.html", message=消息)
)
聊天渠道.更新历史(消息)
聊天渠道.广播(消息)
}
}
2 与例程涉及的 Python 语法对比
下面都基于当前对木兰的认识，今后随重现项目进展可能修改
必须（否则报错）
- 如碰到形参的关键词为 type，需改为位置形参。如原始例程中的：
define("port", default=8888, help="run on the given port", type=int)
最后一个形参的 keyword 为 type，正好是木兰的语法关键词。因此只能改为位置形参（顺便中文化封装）：
func 定义(名称 : str, 默认=nil, 类型=nil, 帮助=nil) {
define(名称, 默认, 类型, 帮助)
}
定义("port", 默认=8888, 帮助="在此端口运行服务", 类型=int)
- 木兰只有静态方法（staticmethod）。碰到 Python 的 classmethod 时，引用类变量时用类名取代 cls。见上面的
更新历史方法。 - 需 tuple() 初始化元组，见前文介绍
- 所有块改为 {}，取代 Python 中的冒号
- class 变 type，用冒号指定类型，包括指定形参类型、超类等
- 注释段用 /* */，注释行用 //
- import 变 using
- None 变 nil
- def 变 func
- 【本周】super() 变 super
- 【本周】不支持 **，改用列举形参
- 类变量需用｛｝包围
- 字典初始化 {:}
可选
- self 变 $，见前文介绍
- 构造函数用类名而非__init__
- 无参数函数定义时可省略 ()
附：代码量统计
主要部分的代码行数统计，格式为：上次->现在。
- 木兰代码量 2965 -> 3114
- 编辑器，实现与测试都是木兰代码：432 -> 431 （在为分为前后端实现调研网络服务框架）
- 木兰测试用例，包括部分实用小程序（如井字棋）：2533 -> 2683
- Python 代码量（木兰实现与测试框架）：2594 -> 2612
分析器/语法分析器.py：1008 -> 1019分析器/词法分析器.py：204 -> 207测试/运行所有.py，检验所有木兰测试代码片段：192 -> 194环境.py，定义全局方法：171 -> 172分析器/语法成分.py，从语法分析器中提取出来的枚举常量：81 -> 82功用/反馈信息.py：65 -> 67测试/unittest/语法树.py，确保生成的语法树与原始版本一致：67 -> 66- 未变
分析器/语法树.py：202交互.py，交互环境（REPL）：138中.py，主程序：74功用/调试辅助.py，：57setup.py, 34分析器/错误.py：17测试/unittest/交互.py，交互环境相关测试：28