pgn-reader

作为Rust库的PGN格式下棋类游戏的快速非分配和流式读取器。

简介

Reader 解析游戏并调用用户提供的 Visitor 的方法。实现自定义访问者允许最大灵活性

• 读取器本身不进行分配（除了单个固定大小的缓冲区）。访问者可以决定如何在内存中表示游戏。
• 读取器不验证走法的合法性。这允许实现对自定义棋类游戏的支持，或延迟走法验证。
• 访问者可以向读取器发出信号，表明它不关心某个游戏或变体。

示例

一个访问者，它计算每场游戏中主线中语法上有效的走法的数量。

use std::io;
use pgn_reader::{Visitor, Skip, BufferedReader, SanPlus};

struct MoveCounter {
    moves: usize,
}

impl MoveCounter {
    fn new() -> MoveCounter {
        MoveCounter { moves: 0 }
    }
}

impl Visitor for MoveCounter {
    type Result = usize;

    fn begin_game(&mut self) {
        self.moves = 0;
    }

    fn san(&mut self, _san_plus: SanPlus) {
        self.moves += 1;
    }

    fn begin_variation(&mut self) -> Skip {
        Skip(true) // stay in the mainline
    }

    fn end_game(&mut self) -> Self::Result {
        self.moves
    }
}

fn main() -> io::Result<()> {
    let pgn = b"1. e4 e5 2. Nf3 (2. f4)
                { game paused due to bad weather }
                2... Nf6 *";

    let mut reader = BufferedReader::new_cursor(&pgn[..]);

    let mut counter = MoveCounter::new();
    let moves = reader.read_game(&mut counter)?;

    assert_eq!(moves, Some(4));
    Ok(())
}

文档

阅读文档

库的状态

API 可能可以更简洁，性能可能比旧版本基于 mmap 的方法略有下降（#12）。这需要一些关注。在我解决这个问题之前，我只会进行最小维护，按照 shakmaty 的要求。

尽管如此，它可能仍然是速度最快的PGN解析器之一。

基准测试（v0.12.0）

在SSD（三星850）、Intel i7-6850K CPU @ 3.60 GHz上使用 lichess_db_standard_rated_2018-10.pgn（2,478,460,000场游戏，52,750 MB未压缩）运行

examples/stats.rs 与压缩文件

许可证

pgn-reader采用GPL-3.0（或您可选的任何后续版本）许可。请参阅COPYING文件获取完整的许可文本。