Skip to content

Latest commit

 

History

History
147 lines (92 loc) · 5.71 KB

README.md

File metadata and controls

147 lines (92 loc) · 5.71 KB

木兰在线版 所有测试

前言

没错,这就是那个木兰。

2020 年一月第一时间提出知乎问题「木兰」编程语言有什么特色?的正是本人,这是那段暴风骤雨的亲历记

目标

悬赏完成之前,将努力向 重现「木兰」编程语言的目标 迈进。系列技术文章集结在 知乎专栏开源中国(待同步),部分文章曾发在 国产语言论坛木兰主题

IDE 辅助

VS Code 语法高亮插件

vsc截图

在线编辑器原型

自带IDE截图

运行木兰源码文件

$ 木兰 测试/手工测试/命令行.ul 运行上面的 猜数字 游戏。

中文报错信息

交互环境中仅提示出错所在位置简要信息:

> func a(n) { return n1+1 }
> func b(n) { print(n) }
> b(a(2))
 😰 请先定义'n1'再使用, 见第1行

运行源码时,可见调用各层的详细信息。如果错误发生在其他文件,可见文件名:

$ 木兰 测试/错误处理/引用模块.ul
 😰 取列表内容时,索引超出范围
“测试/错误处理/下标越界函数.ul”第2行:print([][0])
调用层级如下
见第3行:a()

参考例程在此

其中 实用 为较接近实用的部分。另外 木兰代码编辑器 也用木兰代码编写。

所有例程演示的语法可用原始的木兰可执行文件 ulang-0.2.2.exe 检验。如发现有异烦请告知,长期悬赏在此

功能说明

随着逐渐缩小 与原版木兰的差距,将完善 语法说明。用户手册 尚待更新。为调试方便,报错等等反馈信息会逐渐中文化

试用发布版

必需 Python 3.7 ~ 3.12,源码文件需 UTF-8 编码pip install ulang 安装木兰。

命令行交互环境

$ 木兰
木兰向您问好
更多信息请说'你好'
> 和 = 0
> for 数 in 1..10 {
>> 和 += 数
>> }
> 和
55

功能说明 在此

binder 在线环境

New -> Terminal 打开命令行,同样输入“木兰”运行

新手入门

无编程经验不打紧,请入此门

参与开发

实现简介

木兰源代码转换为 Python 的中间表示(AST)后执行,可实现各种语法设计与周边功能,并可方便地利用 Python 现有生态。

新手开发者请看开发流程与项目结构简介

使用 Python 3.7 ~ 3.12 的最新小版本。Mac、LinuxWindows 下全部测试通过。

为提高开发维护效率,本项目中尽量使用中文标识符。包括语法规则、Python 代码等等。

木兰语言部分依赖的第三方 Python 包:

本地运行

$ python -m 木兰
木兰向您问好
更多信息请说'你好'
>

运行测试

  1. 重现项目自身测试
python -m unittest 测试.unittest.交互 测试.unittest.语法树 测试.unittest.所有用例 测试.unittest.报错 测试.unittest.Python到木兰
  1. 原始木兰可执行文件测试

以下为检验与原始木兰可执行文件功能一致,在 Windows 下需将 ulang-0.2.2.exe 置于项目根目录。

以下测试语法相关用例。Windows 系统下会使用 木兰原始可执行文件(ulang-0.2.2.exe)测试,其他系统下则会使用 Python 安装的木兰进行测试:

python 测试/运行所有.py

以下测试源码生成相关用例:

python -m unittest 测试.unittest.原始可执行文件

以下测试木兰源码转换为 Python:

python -m unittest 测试.unittest.木兰到Python

许可证

GNU GPLv3