木兰编程语言重现
Project description
前言
没错,这就是那个木兰。
2020 年一月第一时间提出知乎问题「木兰」编程语言有什么特色?的正是本人,这是那段暴风骤雨的亲历记。
目标
悬赏完成之前,将努力向重现「木兰」编程语言的目标迈进。系列技术文章集结在知乎专栏并在开源中国同步更新,部分文章将发到 国产语言论坛木兰主题。
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、Linux、Windows 下全部测试通过。
为提高开发维护效率,本项目中尽量使用中文标识符。包括语法规则、Python 代码等等。
木兰语言部分依赖的第三方 Python 包:
本地运行
$ python -m 木兰
木兰向您问好
更多信息请说'你好'
>
运行测试
- 重现项目自身测试
python -m unittest 测试.unittest.交互 测试.unittest.语法树 测试.unittest.所有用例 测试.unittest.报错 测试.unittest.Python到木兰
- 原始木兰可执行文件测试
以下为检验与原始木兰可执行文件功能一致,在 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
版本历史介绍
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.