調用與構建 / 導出 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))類型轉換表
i64 | int | 格式 l(實際 L,long long) |
f64 | float | 格式 d |
bool | bool | 格式 p |
str | str | UTF-8,格式 s |
String | bytes | 格式 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 只留薄薄一層膠水。