Skip to main content

Oort Programming Language

CI PyPI License: MIT

文档站点:https://fyabc.github.io/oort-lang/(规范、提案、设计与示例)

简介

Oort 是一门用于编译原理与编程语言设计学习的玩具语言。Python 实现目前作为原型, 未来可能迁移到 Rust。

Oort 的命名来自天文学中的“奥尔特云”, 相关工具链的命名也会使用天文学词汇。

当前状态

默认执行路径是共享 HIR 与 32 位字节码的寄存器 VM(-t vm,动态类型); examples/ 全部示例都能在 VM 下运行。-t eval 树遍历解释器保留为回退 选项(REPL 仍用它)。语法前端(ANTLR + Pratt)解析的语言超集比运行时更大; 未实现的特性会显式报错,不会静默产生错误结果——VM 下部分构造在编译期 (HIR 降低)拒绝,解释器下在运行期拒绝。完整的实现/拒绝清单见 规范:实现状态。

开发以方言垂直切片为主轴:oort-object 动态方言的 v1 已完成; oort-core 已落地薄探针(#lang oort-core,Int/Float/Bool/String/Unit 与 函数、独立静态检查器、跨方言导入拒绝);共享 HIR/字节码/VM 已接通。详见 路线图 与 OP 0001 §5。

已实现

  • 类 C 语法;换行分隔语句,括号内可自由换行
  • 整数/浮点/字符串/布尔/null
  • List、Tuple、Dict、Set 字面量与下标、切片
  • 一等函数、do lambda、闭包、尾随闭包调用;匿名参数 do: $0 * 2
  • 默认参数、关键字实参、位置/关键字限定、*args、**kwargs、&block
  • 迭代器协议:用户类实现 __iter__ 返回 (value, valid) 闭包;内置容器与 用户对象统一用于 for ... in
  • if / elif / else、while、for ... in(含解包)、break expr
  • var / val、多目标声明与元组解包、增强赋值(含 //=)
  • 类、方法、类方法、多重继承(C3 MRO)、元类、this / super
  • 扩展方法与扩展运算符:类外 def C.f / def C.operator "+"(x),按词法 作用域生效,导入激活,成员/字段/类内运算符优先
  • 运算符重载:def operator "+"(other) 等方法,内建类型使用同一套调度; 下标 operator "[]"/"[]=" 与缺失属性 on_missing
  • 行首 . 方法链续行;Bool 与 Int 语义分离
  • 内建:print、clock、type、len、range、str、repr、 int、float、bool;集合助手 map/filter/sorted/zip/enumerate
  • 标准库:math(常量与数学函数)、string(切分/连接/大小写/查找/替换/ ord/chr)、io(UTF-8 整文件读写)与 os(参数、脚本路径、退出码)
  • 模块:import "./lib"、import "./lib" as l、from "./lib" import a, b as c; 规范路径缓存、循环诊断、-I/--module-path 搜索路径
  • REPL(多行输入;Ctrl-C 取消输入或中断执行;Unix Ctrl-D、Windows Ctrl-Z+Enter、 exit / quit 或管道 EOF 正常退出)
  • oort-core 薄探针:#lang oort-core、Int/Float/Bool/String/Unit、List/Tuple/Dict/Set、循环、静态类/槽、标注必填的函数、 if/return、ADT(enum,单态与泛型 enum E[T],含 [out T]/[in T] 声明处变型)、内建 Option/Result、完整模式匹配(字面量/元组/或/守卫、 嵌套穷尽性)、ADT 结构相等与静态类身份相等、函数类型/lambda/高阶函数、独立 静态检查器;同方言模块导入与跨模块类型标注(m.Type、类导入带入类型、 跨模块泛型 enum);静态类单继承(槽/方法继承、覆盖、super、子类型赋值) 与静态接口(多接口实现、接口继承); oort-object 仍忽略标注。见 规范

待实现(见 proposals)

  • 静态对象模型扩展(属性访问器) — OP 0005
  • 自定义运算符声明与优先级 — OP 0002
  • 宏系统与 comptime — 设计笔记
  • VM 性能优化(调用点缓存等)与 LLVM 后端 — OP 0004
  • 语言方言(core / object / systems) — OP 0001

样例

各种样例参见 examples,包括一个可读取文件的 JSON 解析/格式化 CLI。

文档

安装与使用

从 PyPI 安装(推荐)

要求 Python 3.11+:

pip install oort-lang
oort --version

从源码使用 uv

git clone https://github.com/fyabc/oort-lang.git
cd oort-lang
pip install uv
uv sync

# 运行文件(默认用字节码 VM 执行)
oort test.ort

# 执行一行代码
oort -c "print(42)"

# 启动 REPL
oort

# 只打印 AST / 带元数据的 AST
oort test.ort -t ast
oort test.ort -t astm
oort test.ort -t bc       # 打印 HIR/字节码反汇编(动态子集)
oort test.ort -t eval     # 回退到树遍历解释器

从源码使用 pip

git clone https://github.com/fyabc/oort-lang.git
cd oort-lang
pip install .

oort test.ort

VSCode 语法高亮

仓库内置 .ort 高亮插件(TextMate,含文件图标,无需 Marketplace):

cd editors/vscode
npm install
npm run package
code --install-extension oort-lang-0.1.0.vsix

安装后重载窗口即可生效。开发方式、scope 说明与已知限制见 editors/vscode/README.md。

开发

uv sync --extra dev
pre-commit install

# 测试(默认排除 slow;完整运行用 -m slow)
uv run pytest tests/
uv run pytest tests/ -m slow

# 基准测试(结果见 benchmarks/RESULTS.md)
uv run pytest benchmarks/

# 代码质量
uv run ruff check src/ tests/ benchmarks/ scripts/
uv run ruff format src/ tests/ benchmarks/ scripts/
uv run mypy src/

重新生成语法

需要 Java(17+)。语法文件位于 grammars/Oort.g4:

uv sync --extra build-grammar
python scripts/build_grammar.py

目录结构

src/oort_lang/
├── source/           # 源文本、位置与输入抽象
├── diagnostics/      # 异常、错误报告与 ANTLR 错误监听
├── ast/              # AST 节点、visitor、Binding 与打印器
├── parser/           # 语法、Pratt 解析器与 AST 构建
│   └── grammar/      # ANTLR 生成的词法/语法分析器(勿手改)
├── semantics/        # 名字解析与语义检查
├── hir/              # 线性寄存器中间表示与 AST 降低
├── bytecode/         # 32 位字节码编码、编译与反汇编
├── runtime/          # 树遍历解释器、字节码 VM、对象模型、内建
└── driver/           # 编译器、REPL 与命令行入口
grammars/Oort.g4      # 语法定义
tests/                # 单元测试与集成测试
examples/             # 示例程序
editors/vscode/       # VSCode 语法高亮插件
docs/                 # 规范、提案、实现笔记、设计调研
benchmarks/           # 性能基线

相关工具

  • ANTLR 4 — 词法与语法分析器生成
  • uv — 依赖与虚拟环境管理
  • ruff / mypy — 代码质量

参与贡献

语言变更请先阅读 提案流程;未实现的功能会被显式拒绝, 不会静默产生错误结果。

Metadata

Release files for oort-lang 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oort-lang 0.5.0
File Size Uploaded Provenance Actions
oort_lang-0.5.0.tar.gz 215.1 kB With provenance Details for oort_lang-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for oort-lang 0.5.0
File Interpreter ABI Platform Actions
oort_lang-0.5.0-py3-none-any.whl Python 3 none any Details for oort_lang-0.5.0-py3-none-any.whl

Total release size: 440.7 kB

Release files / oort_lang-0.5.0.tar.gz

Download URL oort_lang-0.5.0.tar.gz
Size 215.1 kB
Tags Source
SHA-256 checksum
How to use checksums
dcf0a258b7184961f7279a754834f6afd93d50f0a0a4154ae2f4d1196ae76ab0
BLAKE2b-256 checksum
How to use checksums
3dd4dc7ab7c140a609156092b384b7f3842cce89c9a3945c59d3fe8c15848820
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.

Transparency log

Release files / oort_lang-0.5.0-py3-none-any.whl

Download URL oort_lang-0.5.0-py3-none-any.whl
Size 225.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
31fbd4788e91dad8d023aae91448111893896216272db1cb93e99d10e6c42ae1
BLAKE2b-256 checksum
How to use checksums
a4db15579e74fcbfd9a6f855ce6830044df4851d85d31266b4417f696795be32
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.

Transparency log

Security for oort-lang 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for oort_lang-0.5.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page