#moonlibconfig

#特性

• 保留配置类型：区分32位整数、64位整数、浮点数、布尔值、字符串，以及 group、同类型标量 array 和异构 list。
• 读取 libconfig 文本：支持嵌套配置、三类注释、字符串转义与拼接、尾逗号、多进制整数和64位整数标记。
• 查询和编辑：支持命名成员、列表/数组索引、路径查询、严格类型提取，以及字段新增、替换和删除。
• 保存字符串字节：保留非 UTF-8 内容；需要 MoonBit String 时显式执行严格 UTF-8 解码。
• 确定性写出：生成可重读的规范化 ASCII 文本，保留值及类型，正确处理转义和浮点负零。
• 明确的错误和限制：提供错误码、消息、字节位置，以及输入、输出、嵌套、节点和字符串大小限制。

#安装

moon add Ryan-1125/moonlibconfig@0.2.0

import {
  "Ryan-1125/moonlibconfig" @config,
} for "test"

#快速开始

///|
test "read edit and write service configuration" {
  let source = @config.parse(
    "service={port=9000;enabled=true;} peers=({host=\"localhost\";weight=1L;})",
  )
  assert_eq(source.lookup("service.port").as_int(), 9000)
  assert_eq(source.lookup("peers[0].host").as_string(), "localhost")
  assert_eq(source.lookup("peers.[0].weight").as_int64(), 1L)

  let service = source.lookup("service").with_member("workers", @config.Integer(4))
  let changed = source
    .replaced(@config.parse_path("service"), service)
    .replaced(@config.parse_path("service.port"), @config.Integer(8080))

  let output = @config.stringify(changed)
  let reloaded = @config.parse(output)
  assert_eq(reloaded.lookup("service.port").as_int(), 8080)
  assert_eq(reloaded.lookup("service.workers").as_int(), 4)
  assert_eq(source.lookup("service.port").as_int(), 9000)

  let removed = service.without_member("workers")
  assert_eq(removed, source.lookup("service"))
}

moon test

#类型与 API

#错误与资源限制

///|
test "handle a missing setting" {
  let root = @config.parse("port=9000")
  let code = try {
    ignore(root.lookup("missing"))
    "accepted"
  } catch {
    @config.ConfigError(d) => d.code
  }
  assert_eq(code, "missing_member")
}

///|
test "apply explicit resource limits" {
  let limits = { ..@config.Limits::default(), max_input: 4096, max_depth: 16 }
  let root = @config.parse("port=9000", limits~)
  assert_eq(root.lookup("port").as_int(), 9000)
  assert_eq(@config.parse(@config.stringify(root, limits~)), root)
}

#兼容范围

• @include 返回 unsupported_include，不触发文件读取或路径展开。
• 未知或不完整转义、NUL 字节和非有限浮点明确拒绝。
• 写出使用十进制数值和规范化排版，不保留原始注释、空白及进制。
• 两项非十进制整数行为与实测 Windows 上游存在差异；交换大整数时优先使用十进制及显式 L 后缀。

#示例与验证

git clone https://github.com/Ryan-1125/moonlibconfig.git
cd moonlibconfig
moon update
moon run examples/service --target wasm-gc

moon fmt --check
moon check --deny-warn
moon test --target wasm-gc --deny-warn
moon test --target js --deny-warn
moon test --target native --deny-warn
moon info
moon package --list

#0.2.0：容器编辑、独立校验与源位置

///|
test "edit validate and locate configuration" {
  let doc = @config.parse_document("service={port=9000;} peers=(\"one\",\"two\")")
  assert_eq(doc.get_int("service.port"), 9000)
  assert_true(doc.location("service.port") != None)
  let peers = doc.lookup("peers")
    .inserted(1, @config.Text(b"backup"))
    .appended(@config.Text(b"last"))
    .removed_at(0)
  let root = doc.root().replaced(@config.parse_path("peers"), peers)
  assert_eq(@config.validate(root), [])
  assert_eq(@config.parse(@config.stringify(root)), root)
  let invalid = @config.Group([
    ("ports", @config.ScalarArray([@config.Integer(1), @config.Integer64(2L)])),
  ])
  let issues = @config.validate(invalid)
  assert_eq(issues[0].path, "ports[1]")
  assert_eq(issues[0].code, "array_type")
}

#许可证与参考