oort-lang 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. oort_lang-0.4.0/.gitignore +104 -0
  2. oort_lang-0.4.0/CHANGELOG.md +285 -0
  3. oort_lang-0.4.0/CONTRIBUTING.md +95 -0
  4. oort_lang-0.4.0/LICENSE +21 -0
  5. oort_lang-0.4.0/PKG-INFO +227 -0
  6. oort_lang-0.4.0/README.md +188 -0
  7. oort_lang-0.4.0/SECURITY.md +21 -0
  8. oort_lang-0.4.0/benchmarks/README.md +97 -0
  9. oort_lang-0.4.0/benchmarks/reference/README.md +68 -0
  10. oort_lang-0.4.0/docs/proposals/README.md +96 -0
  11. oort_lang-0.4.0/grammars/Oort.g4 +632 -0
  12. oort_lang-0.4.0/pyproject.toml +236 -0
  13. oort_lang-0.4.0/src/oort_lang/__init__.py +8 -0
  14. oort_lang-0.4.0/src/oort_lang/__main__.py +8 -0
  15. oort_lang-0.4.0/src/oort_lang/ast/__init__.py +1 -0
  16. oort_lang-0.4.0/src/oort_lang/ast/ast_visitor.py +188 -0
  17. oort_lang-0.4.0/src/oort_lang/ast/binding.py +44 -0
  18. oort_lang-0.4.0/src/oort_lang/ast/nodes/__init__.py +67 -0
  19. oort_lang-0.4.0/src/oort_lang/ast/nodes/adt.py +156 -0
  20. oort_lang-0.4.0/src/oort_lang/ast/nodes/argument.py +40 -0
  21. oort_lang-0.4.0/src/oort_lang/ast/nodes/assignment.py +23 -0
  22. oort_lang-0.4.0/src/oort_lang/ast/nodes/base.py +55 -0
  23. oort_lang-0.4.0/src/oort_lang/ast/nodes/call_expr.py +34 -0
  24. oort_lang-0.4.0/src/oort_lang/ast/nodes/class_def.py +67 -0
  25. oort_lang-0.4.0/src/oort_lang/ast/nodes/compiler_attr.py +17 -0
  26. oort_lang-0.4.0/src/oort_lang/ast/nodes/control_flow.py +131 -0
  27. oort_lang-0.4.0/src/oort_lang/ast/nodes/declarations.py +119 -0
  28. oort_lang-0.4.0/src/oort_lang/ast/nodes/expressions.py +93 -0
  29. oort_lang-0.4.0/src/oort_lang/ast/nodes/function_def.py +114 -0
  30. oort_lang-0.4.0/src/oort_lang/ast/nodes/import_stmt.py +48 -0
  31. oort_lang-0.4.0/src/oort_lang/ast/nodes/literal_constants.py +212 -0
  32. oort_lang-0.4.0/src/oort_lang/ast/nodes/lvalue.py +88 -0
  33. oort_lang-0.4.0/src/oort_lang/ast/nodes/macro.py +58 -0
  34. oort_lang-0.4.0/src/oort_lang/ast/nodes/module_node.py +25 -0
  35. oort_lang-0.4.0/src/oort_lang/ast/printer.py +159 -0
  36. oort_lang-0.4.0/src/oort_lang/bytecode/__init__.py +54 -0
  37. oort_lang-0.4.0/src/oort_lang/bytecode/code.py +102 -0
  38. oort_lang-0.4.0/src/oort_lang/bytecode/compile.py +607 -0
  39. oort_lang-0.4.0/src/oort_lang/bytecode/disasm.py +201 -0
  40. oort_lang-0.4.0/src/oort_lang/bytecode/opcodes.py +251 -0
  41. oort_lang-0.4.0/src/oort_lang/diagnostics/__init__.py +11 -0
  42. oort_lang-0.4.0/src/oort_lang/diagnostics/base.py +22 -0
  43. oort_lang-0.4.0/src/oort_lang/diagnostics/error_handler.py +171 -0
  44. oort_lang-0.4.0/src/oort_lang/diagnostics/error_listener.py +26 -0
  45. oort_lang-0.4.0/src/oort_lang/diagnostics/runtime_errors.py +23 -0
  46. oort_lang-0.4.0/src/oort_lang/diagnostics/syntax_errors.py +15 -0
  47. oort_lang-0.4.0/src/oort_lang/diagnostics/type_errors.py +7 -0
  48. oort_lang-0.4.0/src/oort_lang/driver/__init__.py +1 -0
  49. oort_lang-0.4.0/src/oort_lang/driver/arguments.py +89 -0
  50. oort_lang-0.4.0/src/oort_lang/driver/compiler.py +484 -0
  51. oort_lang-0.4.0/src/oort_lang/driver/logging_utils.py +22 -0
  52. oort_lang-0.4.0/src/oort_lang/driver/main.py +33 -0
  53. oort_lang-0.4.0/src/oort_lang/driver/repl.py +241 -0
  54. oort_lang-0.4.0/src/oort_lang/hir/__init__.py +104 -0
  55. oort_lang-0.4.0/src/oort_lang/hir/dump.py +188 -0
  56. oort_lang-0.4.0/src/oort_lang/hir/lower.py +1263 -0
  57. oort_lang-0.4.0/src/oort_lang/hir/nodes.py +474 -0
  58. oort_lang-0.4.0/src/oort_lang/parser/__init__.py +1 -0
  59. oort_lang-0.4.0/src/oort_lang/parser/ast_builder.py +558 -0
  60. oort_lang-0.4.0/src/oort_lang/parser/dialect.py +153 -0
  61. oort_lang-0.4.0/src/oort_lang/parser/expressions.py +306 -0
  62. oort_lang-0.4.0/src/oort_lang/parser/grammar/OortLexer.py +468 -0
  63. oort_lang-0.4.0/src/oort_lang/parser/grammar/OortParser.py +6467 -0
  64. oort_lang-0.4.0/src/oort_lang/parser/grammar/OortVisitor.py +483 -0
  65. oort_lang-0.4.0/src/oort_lang/parser/grammar/__init__.py +2 -0
  66. oort_lang-0.4.0/src/oort_lang/parser/literals.py +38 -0
  67. oort_lang-0.4.0/src/oort_lang/parser/names.py +16 -0
  68. oort_lang-0.4.0/src/oort_lang/parser/operator_defs.py +165 -0
  69. oort_lang-0.4.0/src/oort_lang/parser/parameters.py +219 -0
  70. oort_lang-0.4.0/src/oort_lang/parser/token_processor.py +114 -0
  71. oort_lang-0.4.0/src/oort_lang/runtime/__init__.py +73 -0
  72. oort_lang-0.4.0/src/oort_lang/runtime/builtins.py +162 -0
  73. oort_lang-0.4.0/src/oort_lang/runtime/bytecode_vm.py +1194 -0
  74. oort_lang-0.4.0/src/oort_lang/runtime/call_args.py +34 -0
  75. oort_lang-0.4.0/src/oort_lang/runtime/call_protocol.py +248 -0
  76. oort_lang-0.4.0/src/oort_lang/runtime/context.py +33 -0
  77. oort_lang-0.4.0/src/oort_lang/runtime/control_flow_exceptions.py +25 -0
  78. oort_lang-0.4.0/src/oort_lang/runtime/dispatch.py +136 -0
  79. oort_lang-0.4.0/src/oort_lang/runtime/environment.py +243 -0
  80. oort_lang-0.4.0/src/oort_lang/runtime/functions.py +265 -0
  81. oort_lang-0.4.0/src/oort_lang/runtime/host.py +35 -0
  82. oort_lang-0.4.0/src/oort_lang/runtime/interpreter.py +1290 -0
  83. oort_lang-0.4.0/src/oort_lang/runtime/modules.py +313 -0
  84. oort_lang-0.4.0/src/oort_lang/runtime/native.py +57 -0
  85. oort_lang-0.4.0/src/oort_lang/runtime/objects.py +596 -0
  86. oort_lang-0.4.0/src/oort_lang/runtime/signature.py +176 -0
  87. oort_lang-0.4.0/src/oort_lang/runtime/stdlib/__init__.py +35 -0
  88. oort_lang-0.4.0/src/oort_lang/runtime/stdlib/collections.py +80 -0
  89. oort_lang-0.4.0/src/oort_lang/runtime/stdlib/io_module.py +39 -0
  90. oort_lang-0.4.0/src/oort_lang/runtime/stdlib/math_module.py +96 -0
  91. oort_lang-0.4.0/src/oort_lang/runtime/stdlib/os_module.py +31 -0
  92. oort_lang-0.4.0/src/oort_lang/runtime/stdlib/string_module.py +106 -0
  93. oort_lang-0.4.0/src/oort_lang/runtime/type_system.py +575 -0
  94. oort_lang-0.4.0/src/oort_lang/semantics/__init__.py +1 -0
  95. oort_lang-0.4.0/src/oort_lang/semantics/analyzer.py +61 -0
  96. oort_lang-0.4.0/src/oort_lang/semantics/core/__init__.py +3 -0
  97. oort_lang-0.4.0/src/oort_lang/semantics/core/checker.py +1929 -0
  98. oort_lang-0.4.0/src/oort_lang/semantics/core/definite_assignment.py +266 -0
  99. oort_lang-0.4.0/src/oort_lang/semantics/core/types.py +258 -0
  100. oort_lang-0.4.0/src/oort_lang/semantics/decl.py +36 -0
  101. oort_lang-0.4.0/src/oort_lang/semantics/functions.py +221 -0
  102. oort_lang-0.4.0/src/oort_lang/semantics/pass1.py +325 -0
  103. oort_lang-0.4.0/src/oort_lang/semantics/resolution.py +73 -0
  104. oort_lang-0.4.0/src/oort_lang/semantics/scope.py +51 -0
  105. oort_lang-0.4.0/src/oort_lang/source/__init__.py +1 -0
  106. oort_lang-0.4.0/src/oort_lang/source/input_info.py +147 -0
  107. oort_lang-0.4.0/src/oort_lang/source/source_position.py +123 -0
  108. oort_lang-0.4.0/tests/README.md +119 -0
@@ -0,0 +1,104 @@
1
+ # Byte-compiled / optimized / DLL files
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # C extensions
7
+ *.so
8
+
9
+ # Distribution / packaging
10
+ .Python
11
+ env/
12
+ build/
13
+ develop-eggs/
14
+ dist/
15
+ downloads/
16
+ eggs/
17
+ .eggs/
18
+ lib/
19
+ lib64/
20
+ parts/
21
+ sdist/
22
+ var/
23
+ *.egg-info/
24
+ .installed.cfg
25
+ *.egg
26
+
27
+ # PyInstaller
28
+ # Usually these files are written by a python script from a template
29
+ # before PyInstaller builds the exe, so as to inject date/other infos into it.
30
+ *.manifest
31
+ *.spec
32
+
33
+ # Installer logs
34
+ pip-log.txt
35
+ pip-delete-this-directory.txt
36
+
37
+ # Unit test / coverage reports
38
+ htmlcov/
39
+ .tox/
40
+ .coverage
41
+ .coverage.*
42
+ .cache
43
+ nosetests.xml
44
+ coverage.xml
45
+ *,cover
46
+ .hypothesis/
47
+
48
+ # Translations
49
+ *.mo
50
+ *.pot
51
+
52
+ # Django stuff:
53
+ *.log
54
+
55
+ # Sphinx documentation
56
+ docs/_build/
57
+
58
+ # MkDocs site output
59
+ /site/
60
+
61
+ # PyBuilder
62
+ target/
63
+
64
+ #Ipython Notebook
65
+ .ipynb_checkpoints
66
+
67
+ # PyCharm Project Files
68
+ /.idea/
69
+
70
+ # pytest-benchmark files.
71
+ /.benchmarks/
72
+
73
+ # Vibe coding.
74
+ /.claude/
75
+
76
+ # Generated grammar files.
77
+ /grammars/.antlr/
78
+ /src/oort_lang/parser/grammar/Oort.interp
79
+ /src/oort_lang/parser/grammar/Oort.tokens
80
+ /src/oort_lang/parser/grammar/OortLexer.interp
81
+ /src/oort_lang/parser/grammar/OortLexer.tokens
82
+
83
+ # Some local files.
84
+ /private
85
+
86
+ # Benchmark / profile artifacts.
87
+ /benchmark.json
88
+ /baseline.json
89
+ /current.json
90
+ /profile.svg
91
+ /memory.bin
92
+
93
+ # Modern Python tooling
94
+ .venv/
95
+ .smoke/
96
+ .mypy_cache/
97
+ .ruff_cache/
98
+ .pytest_cache/
99
+ .coverage
100
+ htmlcov/
101
+ dmypy.json
102
+ *.pyc
103
+ *.pyo
104
+ __pycache__/
@@ -0,0 +1,285 @@
1
+ # 更新日志
2
+
3
+ 本文件记录本项目所有值得注意的变更。
4
+ 格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
5
+ 本项目遵循 [语义化版本](https://semver.org/)。
6
+
7
+ ## [Unreleased]
8
+
9
+ ## [0.4.0] - 2026-11-22
10
+
11
+ ### 新增
12
+
13
+ - `oort-core` 轻量探针:`#lang oort-core` 搭配独立的静态检查器,支持 `Int`、`Bool`、
14
+ `Unit`、带注解的函数、`val`/`var`、`if`/`return`、`print` 以及一小组运算符。
15
+ 同一份源码仍可在 `oort-object` 下动态运行,此时注解不做检查(OP 0017)。
16
+ - 通过静态检查的核心模块在现有解释器上执行;`-t astm` 显示推断出的静态类型,
17
+ `Unit` 映射为运行时 `null`。
18
+ - 同一方言内的 `oort-core` 模块导入:`import "m"` / `from "m" import f`
19
+ 暴露带类型的模块导出,支持再导出,并在编译期检测缺失的导出与循环导入。
20
+ 跨方言导入和原生导入仍被拒绝。
21
+ - 单态 `oort-core` ADT:顶层 `enum` 声明、构造器值、带通配符/绑定/嵌套构造器
22
+ 模式的 `match` 表达式,以及顶层构造器的穷尽性检查。枚举值可以打印;枚举相等性、
23
+ 泛型 ADT 和完整的嵌套穷尽性检查暂缓。`oort-object` 显式拒绝 `enum`/`match`。
24
+ - `oort-core` 中的函数类型、lambda 与一等函数值:`(Int, Bool) -> Int`、
25
+ `do(x: Int) -> Int { ... }`、高阶函数、函数值变量/ADT 载荷,以及从核心模块
26
+ 导出的函数值。函数类型箭头是右结合的(`Int -> Int -> Int` =
27
+ `Int -> (Int -> Int)`),调用可以沿函数值链式进行(`add(1)(2)`)。多参数函数
28
+ 不会自动柯里化。匿名/泛型/默认参数 lambda 仍被拒绝。
29
+ - `oort-core` 中的双向期望类型传播:注解、赋值、返回、函数体和调用实参现在会把
30
+ 期望类型推入 `if` 分支、块尾和 `match` 分支,从而在确切的分支或参数处
31
+ 给出更好的诊断。
32
+ - VSCode 语法(0.1.3)高亮 `enum` 声明与名称、`match`、`=>` 和 `Unit`;
33
+ 0.1.2 添加了最初的 enum/match 作用域。
34
+ - 内部后端基础:一个共享的线性寄存器 HIR、一个 32 位字节码编译器/反汇编器,
35
+ 以及一个用于动态标量/集合/函数/循环子集的寄存器 VM,包括容器切片、属性读写、
36
+ lambda 和被帧捕获的闭包。函数值可以存储、返回、索引和调用,并能传给 `map`
37
+ 等原生高阶辅助函数。顶层动态类和实例方法(包括继承、`__init__` 和
38
+ `__iter__`)、模块导入(`import`/`from`、别名、相对路径和 `-I`)以及
39
+ `oort-core` 子集(带类型的静态槽位、带 `match` 的单态 ADT,以及
40
+ `break`/`continue`,含 `break value`)现在也能在 VM 上运行。导入的模块在
41
+ 同一 VM 上执行,全局环境相互隔离,并且每个 `examples/08_core` 程序都能在
42
+ `-t vm` 下运行。完整的参数绑定(调用时默认值、关键字参数和仅位置/仅关键字
43
+ 参数、`*args`、`**kwargs`、`&block`)现在通过 `CALL_KW` 描述符在解释器和 VM
44
+ 之间共享同一个绑定器。嵌套的具名函数现在会降级为带自递归局部绑定的闭包;
45
+ 循环内创建的函数使用每轮独立 cell,因此每个迭代闭包捕获自己的绑定。
46
+ `-t bc` 打印反汇编,`-t vm` 执行该子集;`-t eval` 仍是默认后端。
47
+ - HIR/VM 动态类补充类方法与运算符方法:`def class.f` 写入元类并在类/子类上绑定,
48
+ `def operator "<sym>"` 注册到类型运算符表;下标读写改走共享的
49
+ `get_item`/`set_item`,因此用户 `"[]"`/`"[]="` 与 `on_missing` 在 VM 下生效。
50
+ 增强赋值(名字、属性、下标目标)也降低为读-改-写;`examples/03_oop/03_03_protocols.ort`
51
+ 现可在 VM 下运行。VM 还支持元类、`super`、扩展方法与扩展运算符(含词法作用域、
52
+ 导入激活和扩展内 `super`);`examples/` 现已全部可在 VM 下运行。
53
+ - `oort-object` 下标与缺失属性协议(OP 0018):`def operator "[]"(index)` /
54
+ `def operator "[]="(index, value)` 用于用户自定义索引(包括切片和元组索引),
55
+ 以及在字段、方法和扩展之后进行只读的 `on_missing(name)` 回退。内建容器保留
56
+ 原生索引;没有 `__setattr__` 风格的写钩子。
57
+ - `oort-core` 静态类与槽位:带固定类型 `val`/`var` 槽位的顶层类、在 `__init__`
58
+ 之前运行的每实例槽位初始化器、构造函数的确定性赋值检查、只读 `val` 槽位、
59
+ 带类型的方法/`this`,以及构造函数调用。继承、元类、类方法、运算符方法和
60
+ 动态字段仍被拒绝。
61
+ - `oort-core` 集合与循环:`List[T]`、`Set[T]`、`Dict[K, V]` 和 `Tuple[...]`
62
+ 注解,同构/空字面量检查,索引,特殊的 `len` 内建函数,同类型集合相等性,以及
63
+ 针对列表、集合、字典键、字符串和同构元组的 `while`/`for` 循环。集合是不可变的,
64
+ 切片、`in`、排序和异构元组迭代仍被拒绝。
65
+ - `oort-core` 标量表达式:`Float` 和 `String` 类型及字面量,混合 Int/Float
66
+ 算术,`/`(始终为 `Float`),数值和 String 的比较/相等性,以及二者的带注解
67
+ 参数/返回值。数值注解仍然严格(`val x: Float = 1` 会被拒绝);`**` 仍不受
68
+ 支持,因为其结果类型取决于指数。
69
+
70
+ ### 变更
71
+
72
+ - List/Tuple 排序现在使用递归的 Oort 比较(元素用 Oort 的 `==`/`<` 比较,包括
73
+ 用户运算符),而不是 Python 宿主比较;Dict 不再支持排序,Set 排序使用键协议。
74
+ `Bool` 这类不可排序的元素现在会报错。
75
+ - List/Tuple 的 `+` 和 `*` 是值级运算符,会构建共享元素对象的新序列,而不是进行
76
+ `HOST` 往返复制。
77
+ - 除 `__init__` 和 `__iter__` 之外的 dunder 方法在类体中被拒绝
78
+ (`Special method '<name>' is not supported.`),而不是被存储却从不分派;
79
+ 未使用的 `__op_*__` 字段和被遮蔽的 `super` 内建函数已移除。
80
+ - `enum` 和 `match` 现在是硬关键字,`=>` 是保留的 `FATARROW` 记号(不是用户
81
+ 运算符),用于 `match` 分支;原先名为 `enum`/`match` 的标识符和拼写为 `=>`
82
+ 的用户运算符不再有效。
83
+ - 方言边界是显式的:`oort-core` 可以导入其他核心模块,而加载器在 FFI 跳板
84
+ 落地之前仍会拒绝 `oort-object` ↔ `oort-core` 导入。
85
+ - REPL 仍仅支持 `oort-object`,现在会以清晰的错误消息拒绝 `#lang` 指令,
86
+ 而不是静默地把提交内容当作动态代码处理。
87
+
88
+ ### 修复
89
+
90
+ - 向 List 等内建对象赋值属性时,现在会报告
91
+ `Cannot set attribute ... on 'List' object`,而不是内部断言。
92
+
93
+ - 在内建容器内部进行比较或成员测试时抛出的错误,现在会报告用户表达式的源码
94
+ 位置,而不是 `<builtin>`。
95
+ - 在没有显式参数列表的具名 `def` 中,`$0`/`$1` 不再被静默绑定到外层 lambda
96
+ 的匿名参数。
97
+ - 初始化导入模块时(REPL 中的 Ctrl-C)发生 `KeyboardInterrupt`,会丢弃失败的
98
+ 记录,以便可以重试导入。
99
+ - `zip` 的文档现在说明它会急切地耗尽所有输入,并在无限可迭代对象上挂起。
100
+ - `OortIterator.take_remaining` 始终返回其底层列表的副本。
101
+ - 已移除语法中 `.` 之前多余的 `NEWLINE*`;行首点号续行仍由词法记号后处理器
102
+ 处理。
103
+
104
+ ## [0.3.1] - 2026-11-20
105
+
106
+ ### 变更
107
+
108
+ - 相等性现在有一个递归的值协议和一个独立的键协议(OP 0016):嵌套的
109
+ `Bool`/`Int` 保持不同,Dict/Set 相等性和集合代数使用键相等性,Int/Float 仍
110
+ 值相等但键不同。相等性、成员测试或集合代数不再使用宿主投影。
111
+ - 带显式参数列表的 lambda 现在是 `$0`/`$1` 解析的屏障,因此它无法静默捕获
112
+ 外层的匿名参数。
113
+ - 行首 `.` 续行在解析前从解析器记号流中移除;REPL 仍要求 `\`,因为它看不到
114
+ 下一行。
115
+ - JSON 展示程序对无参数方法使用仅花括号的定义(`def parse { ... }`)。
116
+
117
+ ### 修复
118
+
119
+ - 类对象写入(`C.f = ...`)不再能替换通过类/元类 MRO 继承的可调用成员。
120
+
121
+ ## [0.3.0] - 2026-11-20
122
+
123
+ ### 新增
124
+
125
+ - 模块系统(OP 0006):`.ort` 模块,支持 `import "m" [as x]` 和
126
+ `from "m" import a, b as c`,急切的顶层提升初始化,规范路径缓存,
127
+ 循环导入诊断,带自动再导出的模块命名空间,以及 `-I/--module-path`
128
+ 搜索目录。
129
+ - `examples/04_modules/` 下的多文件示例。
130
+ - 诊断信息现在让每个错误与其自身的源码输入配对,并跨文件排序,因此导入模块的
131
+ 错误会指向正确的文件和行。
132
+ - 最小标准库(OP 0012):急切的 `map`、`filter`、`zip`、`enumerate` 和稳定的
133
+ `sorted` 内建函数,以及可通过 `import "math"` / `from "string" import upper`
134
+ 导入的原生 `math` 和 `string` 模块。
135
+ - `examples/05_stdlib/` 下的标准库示例,以及 `benchmarks/test_stdlib.py` 中的
136
+ 宿主/标准库基准测试。
137
+ - 迭代器协议(OP 0013):用户类实现 `__iter__`,返回一个产出 `(value, valid)`
138
+ 元组的可调用对象;`for` 是流式的,内建容器通过原生 `Iterator` 类型暴露
139
+ 同一协议。
140
+ - `examples/06_iterators/` 下的用户迭代器示例,以及
141
+ `benchmarks/test_iterators.py` 中的内建/用户迭代器基准测试。
142
+ - 扩展方法(OP 0014):`def C.f` 在类外部为现有类型定义方法。扩展具有词法
143
+ 作用域,由 `import`/`from` 激活,按运行时类型 MRO 分派,且从不覆盖成员、
144
+ 字段或内建运算符。扩展中的 `super` 只搜索类成员。
145
+ - 扩展运算符:`def C.operator "+"(x)` 填补目标类型未定义的运算符;类和原生
146
+ 运算符始终优先。
147
+ - `examples/03_oop/03_02_extensions.ort` 下的扩展示例和
148
+ `benchmarks/test_extensions.py`。
149
+ - 最小 I/O 与进程支持(OP 0015):用于 UTF-8 整文件访问的 `io.read_file` /
150
+ `io.write_file`,`os.args` / `os.script` / `os.exit`,以及
151
+ `string.ord` / `string.chr`。
152
+ - `examples/07_showcase/07_00_json.ort` 的 JSON 解析器/格式化器展示,包括
153
+ `\uXXXX`/代理对处理和 CLI 文件参数。
154
+ - 使用 MkDocs Material 构建并部署到 GitHub Pages 的文档站点:
155
+ <https://fyabc.github.io/oort-lang/>,新增了入门和示例页面。
156
+
157
+ ### 变更
158
+
159
+ - 宿主边界重构:`OortObject.py_value` 变为 `host_value`,引入 `HostBridge`、
160
+ HOST/VALUE/CONTEXT 原生调用模式和用于高阶原生函数的 `NativeContext`。
161
+ `len` 不再投影整个容器。
162
+ - 导入只允许在模块顶层;嵌套导入会以显式诊断被拒绝。
163
+ - 每个模块拥有隔离的全局环境;全局查找针对定义该名字的模块解析,因此函数和
164
+ 方法在其他地方被调用时仍保有自己的模块全局。
165
+ - 语法不再内嵌宿主语言动作(OP 0008):括号跟踪、换行过滤和行转义移至纯
166
+ 记号后处理器(`parser/token_processor.py`),词法分析器始终发出 `NEWLINE`。
167
+ - REPL 现在是 `ReplSession` + `ConsoleIO`:每次提交都重新解析其缓冲区,而不是
168
+ 修改 ANTLR 词法/语法分析器的内部状态。Ctrl-C 会取消当前输入或中断正在执行的
169
+ 语句而不退出;非 TTY 输入时隐藏提示符,EOF 干净退出。在 Windows 上,EOF 是
170
+ Ctrl-Z 后跟 Enter;`exit` / `quit` 也会关闭 REPL。
171
+
172
+ ### 修复
173
+
174
+ - VSCode 语法现在将 `import`、`from` 和 `as` 着色为导入关键字
175
+ (`keyword.control.import.oort`);此前 `as` 与运算符词共享作用域,某些主题
176
+ 下可能不着色。扩展版本 0.1.1。
177
+ - 不匹配的右括号(`)`、`]`、`}`)现在产生正常的语法诊断,而不是来自词法
178
+ 分析器栈动作的 `IndexError`。
179
+ - 管道/重定向的 REPL 输入在 EOF 时干净退出,而不会以 traceback 结束,语法
180
+ 错误也不再中止会话。
181
+
182
+ ## [0.2.0] - 2026-11-19
183
+
184
+ ### 新增
185
+
186
+ - `editors/vscode/` 中的 VSCode 扩展:TextMate 语法高亮、括号匹配、注释配置、
187
+ 轨道与彗星语言文件图标以及语法测试。
188
+ - 用于没有显式参数列表的 lambda 的匿名 lambda 参数 `$0` / `$1`
189
+ (`do: $0 * 2`、`do: $0 + $1`;OP 0010)。
190
+ - 完整参数绑定:调用时默认值、关键字参数、仅位置(`/`)和仅关键字(`*`)
191
+ 参数、作为 Tuple 的 `*args`、作为 Dict 的 `**kwargs`,以及支持尾随块或
192
+ 关键字语法的 `&block`(OP 0011)。
193
+ - 方言契约:可选的首行 `#lang oort-object` 指令、`DialectConfig`(特性开关和
194
+ 每次编译的 Pratt 运算符表),以及针对未知、未实现(`oort-core`)或位置错误
195
+ 的方言声明的显式诊断。
196
+ - 运算符重载:用于一元和二元运算符(包括比较和成员测试)的
197
+ `def operator "<sym>"` 方法。内建类型使用同一张分派表,`!=` / `!in` 由
198
+ `==` / `in` 派生,`is` / `!is` 比较对象标识。
199
+ - 表达式与表层语法清理(OP 0009):Python/Rust 优先级,严格的 `Bool`/`Int`
200
+ 分离,带括号的参数列表,禁用隐式中缀,`break value`,DOT 续行和 Oort
201
+ 容器显示。
202
+ - 语言规范(`docs/spec/`)和提案流程(`docs/proposals/`,OP 0001–0011)。
203
+ - Linux 和 Windows 上的 CI(Python 3.11–3.13):lint、格式、类型检查和
204
+ 覆盖率门禁。
205
+ - 贡献、安全和 issue/PR 模板。
206
+
207
+ ### 变更
208
+
209
+ - 质量基础设施现在包括 bandit、pip-audit、deptry、vulture、hypothesis 属性
210
+ 测试、markdown/actionlint 检查和 CI 中的 wheel/sdist 安装冒烟测试。
211
+ - 基准测试基础设施现在覆盖微操作、宏工作负载、启动、内存上限和历史
212
+ Fibonacci,并带有 CI 历史工作流和性能分析说明。
213
+ - 包被重组为 `source/`、`diagnostics/`、`ast/`、`parser/`、`semantics/`、
214
+ `runtime/` 和 `driver/` 层。`objects.py`、`ast_builder.py` 和 `pass1.py`
215
+ 按职责拆分,import-linter 契约保持层边界强制执行。
216
+ - 名称解析现在向 AST 名称节点附加带类型的 `Binding`(作用域深度加槽位索引),
217
+ 而不是写入无类型的 `metadata` 键;作用域布局与未来的槽位/上值后端共享。
218
+ - 每个解释器现在拥有独立的 `Runtime`,带有自己的内建类型表和
219
+ `null`/`true`/`false` 单例,因此多个解释器可以在同一进程中共享而不会互相
220
+ 覆盖类型。
221
+ - mypy 现在是有效的门禁:排除生成的解析器/词法分析器代码,手写代码以
222
+ `check_untyped_defs` 和严格 optional 检查,pre-commit 使用项目锁定的
223
+ 工具版本。
224
+ - 运算符优先级现在遵循 Python/Rust:按位 `& ^ |` 比较运算符绑得更紧,比较
225
+ 运算符不具结合性(`a < b < c` 会报错)。
226
+ - `Bool` 不再是 `Int` 的子类型:布尔运算和 `true == 1` 会被拒绝;容器成员
227
+ 测试保持布尔值与整数不同。
228
+ - 标识符不再接受尾随 `!`,因此 `a!=b`、`x!in xs` 和 `a!is b` 在无空格时也能
229
+ 正确分词。
230
+ - 所有参数列表现在都要求括号。`def f x: ...` 和 `do x: ...` 等裸形式是语法
231
+ 错误,消除了 `:` 类型与函数体的歧义。
232
+ - 隐式中缀调用(`a b c`)在显式 `infix` 设计落地之前被禁用;`def C.f`、
233
+ `class A.B` 和显式 `super(...)` 调用会被拒绝。
234
+ - `break expr` 使 `while` / `for` 表达式返回值;以 `.` 开头的行继续方法链;
235
+ 支持 `//=`。
236
+ - Dict/set 显示使用 Oort 字面量分隔符(`{: ... :}` / `{. ... .}`)。
237
+ - `oort-object` 拒绝在类体中直接声明 `var` / `val`。实例是开放的字段包;
238
+ 字段必须在 `__init__` 中用 `this.name = ...` 创建(OP 0007)。
239
+ - 实例字段不再能遮蔽实例方法或类方法;缺失属性抛出 `OortAttributeError`。
240
+ 默认相等性和哈希使用对象标识。
241
+ - 源文件以 UTF-8 读取,可选 BOM(`utf-8-sig`)。
242
+ - 公开路线图现在是高层次的;详细规划位于私有账本和 GitHub 里程碑/issue 中。
243
+ 开发围绕共享主干上的方言垂直切片组织:先 `oort-object` v1,接着是轻量
244
+ `oort-core` 探针,两个方言 v1 之后是共享字节码后端。类槽位限定在
245
+ `oort-core`;`oort-object` 保持开放字段包(OP 0001 §5、OP 0007)。
246
+ - 最低 Python 版本现在是 3.11(3.10 已到生命周期终点);CI 在 Linux 上测试
247
+ 3.11–3.13,在 Windows 上测试 3.13。
248
+ - 开发依赖已更新(ruff、mypy、pytest、pytest-benchmark、pre-commit、
249
+ virtualenv、filelock),解决了未决的 Dependabot 警报。
250
+
251
+ ### 修复
252
+
253
+ - 在循环内定义的函数中的 `break` / `continue` 不再逃逸到外层循环。
254
+ - 参数布局验证现在能处理索引 0 处的可变关键字参数和尾随块参数,并修正了
255
+ 标记顺序诊断。
256
+ - Pratt 绑定力是整数,而不是浮点 epsilon 值。
257
+
258
+ ## [0.1.0] - 2026-11-18
259
+
260
+ ### 新增
261
+
262
+ - 动态核心:函数、闭包、类、方法、类方法、多继承(C3 MRO)、元类、
263
+ `this` / `super`。
264
+ - `for ... in` 循环(解构、逐次迭代绑定)、`if` / `elif` / `else`、带
265
+ `break` / `continue` 的 `while`。
266
+ - List、tuple、dict 和 set 字面量;下标与切片;增强赋值;多声明目标和
267
+ 元组解包。
268
+ - 内建函数:`print`、`clock`、`type`、`super`、`len`、`range`、`str`、
269
+ `repr`、`int`、`float`、`bool`。
270
+ - 带错误恢复的多行 REPL。
271
+ - 单元测试和集成测试、示例程序以及基准基线。
272
+ - 从 `grammars/Oort.g4` 生成的解析器,带有 Pratt 表达式解析器。
273
+
274
+ ### 变更
275
+
276
+ - 默认执行目标是 `eval`(树遍历解释器)。
277
+ - 不支持的构造会以显式的 `UnsupportedSyntax` 诊断被拒绝,而不是静默地做出
278
+ 错误行为。
279
+ - `USER_OP` 排除 `.`、`:`、`@`;移除了死记号;支持 `elif` 和对称的 `else`
280
+ 形式。
281
+
282
+ ### 移除
283
+
284
+ - 未完成的基于寄存器的字节码后端(会静默地错误编译不支持的构造)。设计与
285
+ 重新实现要求保留在 `docs/design/02-bytecode-vm-design.md` 和 OP 0004 中。
@@ -0,0 +1,95 @@
1
+ # 为 Oort 做贡献
2
+
3
+ 感谢你的帮助!Oort 是一个面向学习的语言项目,因此清晰度和明确的设计决策比功能数量更重要。
4
+
5
+ ## 开发环境搭建
6
+
7
+ ```bash
8
+ uv sync --extra dev
9
+ pre-commit install
10
+
11
+ uv run --frozen pytest tests/
12
+ uv run --frozen ruff check src tests benchmarks scripts
13
+ uv run --frozen ruff format --check src tests benchmarks scripts
14
+ uv run --frozen mypy src/
15
+ ```
16
+
17
+ 仅在从 `grammars/Oort.g4` 重新生成解析器时才需要 Java 17+:
18
+
19
+ ```bash
20
+ uv sync --extra build-grammar
21
+ python scripts/build_grammar.py # or: make build-grammar
22
+ ```
23
+
24
+ 不要手动编辑 `src/oort_lang/parser/grammar/` 中的文件;它们是由工具生成的。
25
+
26
+ 文档站点使用 MkDocs Material 构建:
27
+
28
+ ```bash
29
+ make docs-serve # preview at http://127.0.0.1:8000/
30
+ make docs # strict build, same as CI
31
+ ```
32
+
33
+ ## 各部分的位置
34
+
35
+ | 路径 | 内容 |
36
+ |------|------|
37
+ | `docs/spec/` | 规范性语言参考(必须与实现保持一致) |
38
+ | `docs/proposals/` | PEP/RFC 风格的设计提案 |
39
+ | `docs/implementation/` | 编译器实现说明 |
40
+ | `mkdocs.yml` | 文档站点的导航与主题配置 |
41
+ | `src/oort_lang/source/` | 源文本、位置与输入抽象 |
42
+ | `src/oort_lang/diagnostics/` | 异常、错误处理器与 ANTLR 错误监听器 |
43
+ | `src/oort_lang/ast/` | AST 节点、visitor、类型化绑定与打印器 |
44
+ | `src/oort_lang/parser/` | 文法、Pratt 解析器与 AST 构建器 |
45
+ | `src/oort_lang/semantics/` | 名称解析与语义检查 |
46
+ | `src/oort_lang/runtime/` | 树遍历运行时与对象模型 |
47
+ | `src/oort_lang/driver/` | 编译器、REPL 与 CLI 入口 |
48
+ | `tests/unit/`, `tests/integration/` | 单元测试、CLI/REPL/示例测试 |
49
+
50
+ ## 语言变更规则
51
+
52
+ 1. **先提交提案**:任何非平凡的改动(新语法、语义、类型系统变更)都需要先提交提案。复制 `docs/proposals/0000-template.md`。
53
+ 2. **不要半成品功能。** 如果某个构造已被解析但尚未实现,必须在
54
+ `src/oort_lang/semantics/pass1.py` 中以 `UnsupportedSyntax` 拒绝,并列入
55
+ `docs/spec/06-conformance.md`。
56
+ 3. **同步更新规范与测试。** 只有当 `docs/spec/` 和 `tests/` 都反映了该功能时,功能才算完成。
57
+ 4. **保持功能正交。** 避免针对特定类型或语法的特例;优先使用显式、可组合的机制。
58
+ 5. **不要添加元编程捷径**(宏、`comptime`、隐藏的代码生成),除非运行时语义已经稳定。
59
+
60
+ ## 测试
61
+
62
+ - 在 `tests/unit/` 下为你所改动的子系统添加或扩展测试。
63
+ - CLI/REPL/示例行为应放在 `tests/integration/`。
64
+ - 新示例必须注册到 `tests/integration/test_examples.py`
65
+ (如果需要昂贵的初始化,可放到专门的测试模块)。
66
+ - 耗时超过几秒的测试应使用 `@pytest.mark.slow`;
67
+ 它们被排除在默认运行之外,由 CI 的 slow 任务执行。
68
+ - 核心代码应保持在 CI 覆盖率阈值(87%)以上。
69
+
70
+ ## 质量门禁
71
+
72
+ `make check` 运行 lint、格式化、mypy、导入边界和测试。以下可选门禁在 `quality` CI 任务中或通过 `make quality` 运行:
73
+
74
+ | 门禁 | 工具 | 命令 |
75
+ |------|------|------|
76
+ | 安全 | bandit | `make security` |
77
+ | 依赖 CVE | pip-audit | `make audit` |
78
+ | 依赖卫生 | deptry | `make deps` |
79
+ | 死代码 | vulture | `make dead-code` |
80
+ | 属性测试 | hypothesis | `make property` |
81
+ | Markdown | markdownlint-cli2 | `make markdown` |
82
+
83
+ Mutmut/`cosmic-ray` 变异测试是偶尔进行的本地检查,而不是每次推送的门禁;
84
+ 在修改解释器核心时,针对 `src/oort_lang/runtime` 运行它。
85
+
86
+ ## 提交与拉取请求
87
+
88
+ - 使用约定式提交前缀(`feat:`、`fix:`、`docs:`、`test:` 等)。
89
+ - 每个提交保持聚焦;避免将重构与行为变更混在一起。
90
+ - 在 PR 描述中说明改动了什么、为什么改、适用的提案/规范章节,以及如何测试。
91
+ - CI 必须在 Linux 和 Windows 上通过。
92
+
93
+ ## 报告缺陷
94
+
95
+ 请附上最小的 `.ort` 复现程序、你运行的命令以及完整的诊断输出。安全问题请参阅 [SECURITY.md](SECURITY.md)。
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 fyabc
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.