rust pgn reader Download - rust pgn reader Code Source Téléchargement

rust pgn reader

Autre code source

Télécharger

lecteur PGN

Un lecteur rapide non allouant et en streaming pour les jeux d'échecs en notation PGN, en tant que bibliothèque de rouille.

Introduction

Reader analyse les jeux et les méthodes d'appel d'un Visitor fourni par l'utilisateur. La mise en œuvre des visiteurs personnalisés permet une flexibilité maximale:

Le lecteur lui-même n'attribue pas (à part un seul tampon de taille fixe). Le visiteur peut décider si et comment représenter des jeux en mémoire.
Le lecteur ne valide pas la légalité de déplacement. Cela permet d'implémenter la prise en charge des variantes d'échecs personnalisées ou de retarder la validation de déplacement.
Le visiteur peut signaler au lecteur qu'il ne se soucie pas d'un jeu ou d'une variation.

Exemple

Un visiteur qui compte le nombre de mouvements syntaxiquement valides dans la ligne principale de chaque jeu.

 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 ( ( ) )
}

Documentation

Lire la documentation

État de la bibliothèque

L'API pourrait être plus propre et les performances peuvent avoir régressé légèrement par rapport à l'approche basée sur mmap des anciennes versions (# 12). Cela nécessite une certaine attention. Jusqu'à ce que j'y arrive, je ne fais qu'un entretien minimal, en suivant shakmaty au besoin.

Néanmoins, c'est probablement encore l'un des analyseurs PGN les plus rapides.

Benchmarks (V0.12.0)

Exécutez avec lichess_db_standard_rated_2018-10.pgn (24 784 600 jeux, 52 750 Mo non compressé) sur un SSD (Samsung 850), Intel i7-6850K CPU @ 3,60 GHz:

Référence	Temps	Déborder
Exemples / stats.rs	111.9S	471,4 Mb / s
exemples / valider.rs	237.1	222,5 Mb / s
Exemples / parallel_validate.rs	148.6s	355,0 Mb / s
`scoutfish make`	269.2s	196,0 Mb / s
`grep -F "[Event " -c`	39.2S	1345,7 Mb / s