基石jishi

上手

四个命令就能用起来(当前版本 0.2.6)。

1. 安装

pip install 基石
# 或者用发行版里的安装程序 / 免安装压缩包

2. 跑第一个程序

函数 问候(名字):
    返回 `你好,{名字}!`

打印(问候("世界"))

存成 你好.jsh,然后 jishi 你好.jsh。

3. 出错了怎么办

基石把报错写成「说清原因 + 给出能照着改的提示」,并且带源码与 ^ 指示:

jishi 坏的.jsh
错误 E0302:找不到这个名字(找不到名字「甲」)
  ┌─ 坏的.jsh:3:11
  │ 3 │ 打印(甲)
  │   │     ^^

4. 调不动的时候用调试器

jishi 调试 脚本.jsh --断点 12
调试 > 变量
调试 > 单步
调试 > 栈

树遍历与字节码(--执行器 vm)两个执行器都能调试,断点、单步、变量、调用栈、出错现场一应俱全。

5. 想让它变快

同一份源码有三个执行器:树遍历(默认,最好调试)、字节码 Python VM、以及 C 写的虚拟机。语义由对拍测试保证一致,所以换执行器不需要改代码。