Bun-compatible .env file loader for MoonBit: discovery, parsing and variable expansion
moon add chensuiyi/dotenvfn main {
// dir:`.env` 文件所在目录;mode:"development" / "production" / "test"
// lookup:进程环境查询,由调用方提供;测试时可注入
let vars = @dotenv.load("/srv/api", "production", fn(n) { @env.get_env_var(n) })
let port = match vars.get("PORT") {
Some(v) => v
None => "3000"
}
println(port)
}| 函数 | 用途 |
|---|---|
| load(dir, mode, lookup) | 按 Bun 语义加载并合并;缺文件跳过、坏行跳过 |
| load_strict(dir, mode, lookup) | 同上,但坏行报错并指出文件与行号(配置校验用) |
| files(dir, mode) | 只给出「会读哪些文件」,按读取顺序 |
| 写法 | 结果 |
|---|---|
| $NAME / ${NAME} | 取该名字的值 |
| ${NAME:-默认} | 名字未定义时用默认值;名字存在但为空不触发 |
| ${NAME:-${OTHER}} | 默认值本身也会展开 |
| ${未定义} | 空串 |
| \$NAME | 字面 $NAME(引号内外一致) |
| 单引号内的 $NAME | 也会展开(与 dotenv 不同,与 Bun 一致) |
| 自引用 / 循环引用 | 保留原字面,不展开 |
| 多层引用 | 只展开一层,被引用的值不再递归 |
moon test --target nativepub suberror EnvError {
Unreadable(String)
Malformed(String, Int, String)
}Install
Download zipBun-compatible .env file loader for MoonBit: discovery, parsing and variable expansion