用木兰编程语言编写 WebSocket 聊天服务示例

【安装:pip install ulang,用法与例程请见 PyPI。源码位于开源中国(文末链接)。 Python 3.7,源码文件 UTF-8 编码

本周发布木兰编程语言版本 0.0.14.8。将 Python 框架 tornado自带的用 WebSocket 实现聊天的例程改为木兰实现。顺便将该例程涉及的木兰与 Python 语法对比小结,包括本周重现的 super 语法等。

1 实例演示

用木兰编程语言编写 WebSocket 聊天服务示例

主要木兰代码如下(完整代码见源码库)

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,:57
      • setup.py, 34
      • 分析器/错误.py:17
      • 测试/unittest/交互.py,交互环境相关测试:28

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

(0)
上一篇 2023年3月15日 上午10:28
下一篇 2023年3月15日 上午10:44

相关推荐