Crate owlchess

Yet another Rust chess library

🦉🦉🦉

Owlchess is a chess library written in Rust, with emphasis on both speed and safety. Primarily designed for various chess GUIs and tools, it’s also possible to use Owlchess to build a fast chess engine.

The code is mostly derived from my chess engine SoFCheck, but rewritten in Rust with regard to safety.

This crate supports core chess functionality:

• generate moves
• make moves
• calculate game outcome
• parse and format boards in FEN
• parse and format moves in UCI and SAN

Example

use owlchess::{Board, movegen::legal, Move};
use owlchess::{Coord, File, Rank};

// Create a board with initial position
let b = Board::initial();

// Generate all the legal moves
let moves = legal::gen_all(&b);
assert_eq!(moves.len(), 20);

// Parse move "e2e4" from UCI string
let mv = Move::from_uci("e2e4", &b).unwrap();
let e2 = Coord::from_parts(File::E, Rank::R2);
let e4 = Coord::from_parts(File::E, Rank::R4);
assert_eq!(mv.src(), e2);
assert_eq!(mv.dst(), e4);

// Create a new board with made move `mv`
let b = b.make_move(mv).unwrap();
assert_eq!(b.as_fen(), "rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1");

Re-exports

• pub use board::Board;
• pub use board::RawBoard;
• pub use chain::MoveChain;
• pub use movegen::MoveList;
• pub use movegen::MovePush;
• pub use moves::Make;
• pub use moves::Move;
• pub use moves::MoveKind;

Modules

• bitboard
  Bitboard-related stuff
• board
  Board and related things
• chain
  Board that remembers previous moves
• movegen
  Move generation and related things
• moves
  Moves and related stuff
• types
  Core chess types

Structs

• Bitboard
  Bitmask on chess board
• CastlingRights
  Flags specifying allowed castling sides for both white and black
• Cell
  Contents of square on a chess board
• Coord
  Coordinate of a square

Enums

• CastlingSide
  Castling side (either queenside or kingside)
• Color
  Color of chess pieces (either white or black)
• DrawReason
  Reason for game finish with draw
• File
  File (i. e. a vertical line) on a chess board
• GameStatus
  Short status of the game (either running of finished)
• Outcome
  Outcome of the finished game
• Piece
  Kind of chess pieces (without regard to piece color)
• Rank
  Rank (i. e. a horizontal line) on a chess board
• WinReason
  Reason for game finish with win