【安装:pip install ulang
,用法与例程请见 PyPI。源码位于开源中国。 注意:必需 python 3.7,源码文件需 UTF-8 编码】
本周将 Python 框架 tornado自带的用 websocket 实现聊天的例程改为木兰实现。顺便将该例程涉及的木兰与 Python 语法对比小结,包括本周重现的 super 语法等。
主要木兰代码如下(完整代码在此)
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=消息)
)
聊天渠道.更新历史(消息)
聊天渠道.广播(消息)
}
}
下面都基于当前对木兰的认识,今后随重现项目进展可能修改
如碰到形参的关键词为 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。见上面的 更新历史
方法。
主要部分的代码行数统计,格式为:上次->现在。
分析器/语法分析器.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