开发设置

git clone https://github.com/759401524/pyrs-yaml.git
cd pyrs-yaml

# 使用 uv（推荐）
uv sync

# 或使用 pip
pip install maturin
maturin develop --release

# 运行 Rust 测试
cargo test

# 运行 Python 测试（使用 uv lockfile 确保可重复依赖）
uv run --frozen pytest tests/

# 运行基准测试
cargo bench

pyrs-yaml/
├── src/
│   ├── lib.rs              # PyO3 模块定义
│   ├── ast.rs              # 自定义 AST (CustomNode)
│   ├── parser/
│   │   ├── mod.rs          # granit-parser 集成
│   │   └── yaml/           # YAML 特定解析
│   │       ├── comment.rs  # 注释提取
│   │       ├── merge.rs    # 合并键解析
│   │       ├── scalar.rs   # 标量解析
│   │       └── types.rs    # YAML 1.2 类型解析
│   └── serializer.rs       # YAML 序列化
├── python/pyrs_yaml/
│   ├── __init__.py         # Python 包初始化
│   ├── pyrs_yaml.pyi       # 类型桩文件
│   └── py.typed            # PEP 561 标记
├── tests/                  # Python 测试套件
├── benches/                # Rust 基准测试
└── docs/                   # 文档 (mkdocs)

# 构建 Python 扩展（使用 uv lockfile）
uv run --frozen maturin develop --release

# 构建 wheel
uv run --frozen maturin build --release --out dist

# 带调试信息构建
cargo build