Lib.rs

Fentrail

关于

Fentrail 是一套工具（Rust库、CLI和HTTP服务器），用于研究棋局可以经过的可能路径以达到特定位置。系统的工怍流程由两个独立的组件组成。首先，使用CLI，通过处理用户提供的PGN格式的游戏数据库生成键值存储。其次，通过HTTP请求或通过命令行通过FEN输入查询生成的存储。

安装

假设您已安装Rust，则可以从https://crates.io安装 fentrail CLI和serveft HTTP服务器。

cargo install fentrail

cargo install serveft

用法

两个CLI子命令及其选项和参数通过提供的--help标志进行文档说明。

$ fentrail --help
Usage: fentrail <command> [<args>]

Build and query opening lookup tables for chess positions.

Options:
  --help            display usage information

Commands:
  pack              Initiate or populate KV-stores.
  ask               Inquire a store about a specific position.


$ fentrail pack --help
Usage: fentrail pack <pgn> [-d <depth>] [-e <ecotsv>] [-o <outdir>]

Initiate or populate KV-stores.

Positional Arguments:
  pgn               path to the game database in PGN format

Options:
  -d, --depth       moves from each side to process in a game [default: 12]
  -e, --ecotsv      path to a tsv file to be used as an ECO
  -o, --outdir      directory to store the fentrail database [default: $PWD]
  --help            display usage information


$ fentrail ask --help
Usage: fentrail ask <fen> [-s <store>]

Inquire a store about a specific position.

Positional Arguments:
  fen               FEN string to query

Options:
  -s, --store       path to the fentrail database [default: $PWD/fentrail.redb]
  --help            display usage information

pack 命令不会覆盖现有存储，而是从新的PGN输入中添加未见过的 (position, opening) 对。如果您需要，在调用 pack 之前始终可以手动删除旧数据库。

SERVEFT_PORT=3000 SERVEFT_STORE=/var/db/fentrail.redb serveft &

curl -sS 0.0.0.0:3000 -d 'rnbq1rk1/ppp1ppbp/3p1np1/8/2PPP3/2N2N1P/PP3PP1/R1BQKB1R b KQ - 0 6'