調用與構建 / 導出 Python 模塊

導出 Python 模塊

Aero 的殺手鐧之一:一行命令把 Aero 代碼變成 Python 可 import 的原生擴展。

用法

#[py_export]
fn aggregate(data: String, price_col: i64) -> i64 {
    // ... 熱循環
    return total;
}

構建:

aero build kernel.aero --pyext --py-module kernel

產出 kernel.pyd(Windows)/ kernel.so,然後:

import kernel
print(kernel.aggregate(b"1,100\n2,200\n", 1))

類型轉換表

i64int格式 l(實際 L,long long)
f64float格式 d
boolbool格式 p
strstrUTF-8,格式 s
Stringbytes格式 y#
無返回None—

返回值:i64 → int、f64 → float、bool → bool、str → str、String → bytes。

Python 定位順序

--py-home → PYTHON_HOME → 探測 python。

v1 鎖定 CPython 完整 ABI:升級 Python 需重新編譯。Windows 官方 Python 的 MSVC .lib 會被自動轉成 MinGW 兼容的導入庫(緩存在臨時目錄)。

真實案例:aero-csv

這就是 aero-csv 的做法——200 萬行 CSV 聚合 aggregate() 約 51ms(39M 行/s),比純 Python 快 11 倍、比 numpy 快 9 倍。整個熱循環是 Aero 寫的,Python 只留薄薄一層膠水。

Aero 文档 · 基于 Aero 1.2.0 文档整理 · MIT
SereinTeam