README.md

Xadrez

A chess engine written in Rust.

Usage

Xadrez uses Rusts built-in package manager Cargo.

To use Xadrez in your projects, first include it as a dependency in your Cargo.toml.

[dependencies]
xadrez = { path = "path/to/xadrez" }
xadrez = { git = "https://github.com/jovialen/xadrez" }

use xadrez::prelude::*;
use xadrez::search::MoveSearcher;
use std::time::Duration;

fn main() {
	let chessboard = Chessboard::default();

	let moves: Vec<Move> = chessboard.moves();
	let pieces: Vec<(Piece, Square)> = chessboard.pieces();

	chessboard.make_move(moves[1]);

	let fen = chessboard.to_string();

	chessboard.set_position("rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1");

	chessboard.make_move(Move::from_str("e2e4"));

	println!("{}", chessboard.evaluate());
	
	let best_move = MoveSearcher::new(&chessbboard)
		.max_depth(10)
		.max_time(Duration::from_secs(5))
		.search()
		.expect("Failed to find move");
	chessboard.make_move(best_move);
}

Use the cargo doc command to generate the full documentation.

Tests

To run the full test suite, run Cargos test command.

foo@bar:~$ cargo test

It is also recommended to use the --release flag as some of the tests take a long time to run.

Benchmarks

Xadrez also has benchmarks which you can use to test the performance of the engine on your system.

foo@bar:~$ cargo bench