BON

Appearance

bon-ts CLI 使用指南 ​

安装 ​

bash
# 在 monorepo 根目录
npm install

# 构建 TypeScript
cd packages/bon-ts
npm run build

# 或者全局安装
npm install -g bon-ts

基本用法 ​

bash
# 从文件读取并解析
bon file.bon

# 解析 BON 表达式
bon -e '{ "name": "Alice", "age": 30 }'

# 从 stdin 读取
echo '{ "key": "value" }' | bon

# 紧凑输出
bon -c file.bon

# 美化输出（默认）
bon -p file.bon

命令行参数 ​

参数说明
file要解析的 .bon 文件
-e, --eval直接解析 BON 表达式字符串
-p, --pretty美化输出（默认）
-c, --compact紧凑输出

示例 ​

解析简单对象 ​

bash
bon -e '{ "name": "BON", "version": "1.0" }'

输出：

json
{
  "name": "BON",
  "version": "1.0"
}

使用模板 ​

bash
bon -e '
base_cpu-{"cpu": "250m"}
base_mem-{"memory": "512Mi"}
{
    "resources": {base_cpu},
    "limits": {base_mem}
}
'

输出：

json
{
  "resources": {
    "cpu": "250m"
  },
  "limits": {
    "memory": "512Mi"
  }
}

使用类和继承 ​

bash
bon -e '
class Animal {
    "type": "unknown",
    fn move() { return "moving" }
}

class Dog extends Animal {
    "type": "canine",
    fn bark() { return "woof!" }
}

Dog { "breed": "Husky" }
'

输出：

json
{
  "type": "canine",
  "breed": "Husky",
  "move": "moving",
  "bark": "woof!"
}

使用标准库 ​

bash
bon -e '
{
    "upper": std.upper("hello"),
    "split": std.split("a,b,c", ","),
    "map": std.map([1, 2, 3], fn(x) { return x * 2 }),
    "len": std.len("hello")
}
'

输出：

json
{
  "upper": "HELLO",
  "split": ["a", "b", "c"],
  "map": [2, 4, 6],
  "len": 5
}

在 TypeScript/JavaScript 代码中使用 ​

typescript
import { evaluate, load } from "bon-ts";

// 解析 BON 表达式
const result = evaluate('{ "name": "Alice" }');

// 从文件加载
const config = load("config.bon");

// 访问结果
console.log(result.name); // Alice

在 Shell 脚本中使用 ​

bash
#!/bin/bash

# 解析配置文件
CONFIG=$(bon config.bon)

# 提取值
NAME=$(bon -c -e "config.bon" | jq -r '.name')

# 管道处理
bon data.bon | jq '.items[]'

与 jq 配合 ​

bash
# 格式化输出
bon config.bon | jq .

# 提取特定字段
bon config.bon | jq '.database.host'

# 过滤数组
bon data.bon | jq '.items[] | select(.active == true)'