#MoonAr

#快速开始

git clone https://github.com/xmyd0915/moonar.git
cd moonar
moon update
moon run cmd/main --target native -- inspect examples/data/bundle-before.a

0	regular	11	"config.txt"
1	regular	3	"assets.bin"

moon run cmd/main --target native -- diff examples/data/bundle-before.a examples/data/bundle-time.a --json

#三个使用场景

#符号索引与跨方言比较

moon run cmd/main --target native -- diff before.a after.a --logical --json

#命令行用法

inspect FILE [--json]         列出物理记录、大小、类型和名称
check FILE [--json]           检查受支持的容器结构
diff BEFORE AFTER [--json] [--logical] 比较归档字节、成员或逻辑映射
--help | --version

#作为库使用

moon add xmyd0915/moonar@0.2.0

import {
  "xmyd0915/moonar" @ar,
}

fn inspect_bytes(input : Bytes) -> Unit {
  match @ar.parse(input) {
    Ok(archive) => {
      for i = 0; i < archive.member_count(); i = i + 1 {
        let entry = archive.get_member(i).unwrap()
        println("\{entry.name_hex()}: \{entry.size} bytes")
      }
    }
    Err(error) => println("\{error.code} at byte \{error.offset}")
  }
}

#支持范围

• 普通 ar、GNU 长名称表、BSD 内嵌名称，以及 LLVM Darwin 写出的布局。
• 符号表和名称表保留为独立物理记录。GNU 32/64 位及 BSD 32/64 位大小端索引解码为 符号到普通成员的引用，SORTED 索引还检查名称顺序。
• 重名项按完整内容优先匹配；哈希碰撞后仍检查字节相等。配对稳定，并明确报告歧义。
• bytes_equal 比较全部输入字节；order_changed 比较已配对记录的相对顺序， 单纯新增或删除一项不算重排。特殊记录也参与比较。
• payload_changed 和 metadata_changed 只对 modified 项有意义。 头部数字的空格写法或名称编码布局不同，可能只有 bytes_equal=false。
• Darwin 可能把填充换行计入声明的数据大小。MoonAr 保留这些字节， 与 llvm-ar 提取出的成员数据一致。Darwin 确定性重名归档可能调整时间戳，这类变化 在内容匹配后仍作为元数据报告。

#资源限制

#测试与复现

moon fmt --check
moon check --target all --deny-warn
moon test --target all --deny-warn
moon build --target native --deny-warn
python tools/examples.py --moonar _build/native/debug/build/cmd/main/main.exe
moon run examples/read_deb --target native

python tools/verify_archives.py --moonar _build/native/debug/build/cmd/main/main.exe --require-llvm

#文档与许可证

• 三个使用场景
• 复现指南
• 比较设计与案例
• API、JSON 与错误代码
• 代码结构与验证说明
• 来源与实现说明