X-Git-Url: https://git.sesse.net/?p=remoteglot;a=blobdiff_plain;f=remoteglot.pl;h=3d636a2981a4e3c7a4b0a4eca516922dd0445eca;hp=9d88db75727817d0324f7c315e301e2f5b95fa22;hb=9380b4df34192b8befdd5b4911953add3bf960f2;hpb=195648946e62e7841af4af86601bde2ab281c5df

diff --git a/remoteglot.pl b/remoteglot.pl
index 9d88db7..3d636a2 100755
--- a/remoteglot.pl
+++ b/remoteglot.pl
@@ -18,11 +18,18 @@ use warnings;
 
 # Configuration
 my $server = "freechess.org";
-my $target = "22";
-# my $engine = "/usr/games/toga2";
-my $engine = "wine Rybkav2.3.2a.mp.w32.exe";
+my $target = "GMCarlsen";
+my $engine_cmdline = "'./Deep Rybka 4 SSE42 x64'";
 my $telltarget = undef;   # undef to be silent
 my @tell_intervals = (5, 20, 60, 120, 240, 480, 960);  # after each move
+my $uci_assume_full_compliance = 0;                    # dangerous :-)
+my @masters = (
+	'Sesse',
+	'Sessse',
+	'Sesssse',
+	'greatestguns',
+	'beuki'
+);
 
 # Program starts here
 $SIG{ALRM} = sub { output_screen(); };
@@ -43,7 +50,7 @@ $| = 1;
 select(STDOUT);
 
 # open the chess engine
-my $pid = IPC::Open2::open2(*UCIREAD, *UCIWRITE, $engine);
+my $engine = open_engine($engine_cmdline);
 my %uciinfo = ();
 my %uciid = ();
 my ($last_move, $last_tell);
@@ -51,23 +58,12 @@ my $last_text = '';
 my $last_told_text = '';
 my ($pos_waiting, $pos_calculating);
 
-uciprint("uci");
-
-# gobble the options
-while (<UCIREAD>) {
-	/uciok/ && last;
-	handle_uci($_);
-}
-
-uciprint("setoption name UCI_AnalyseMode value true");
-uciprint("setoption name Preserve Analysis value true");
-uciprint("setoption name NalimovPath value c:\\nalimov");
-uciprint("setoption name NalimovUsage value Rarely");
-uciprint("setoption name Hash value 1024");
-uciprint("setoption name MultiPV value 3");
-# uciprint("setoption name Contempt value 1000");
-# uciprint("setoption name Outlook value Ultra Optimistic");
-uciprint("ucinewgame");
+uciprint($engine, "setoption name UCI_AnalyseMode value true");
+# uciprint($engine, "setoption name NalimovPath value /srv/tablebase");
+uciprint($engine, "setoption name NalimovUsage value Rarely");
+uciprint($engine, "setoption name Hash value 1024");
+# uciprint($engine, "setoption name MultiPV value 2");
+uciprint($engine, "ucinewgame");
 
 print "Chess engine ready.\n";
 
@@ -75,7 +71,7 @@ print "Chess engine ready.\n";
 my $t = Net::Telnet->new(Timeout => 10, Prompt => '/fics% /');
 $t->input_log(\*FICSLOG);
 $t->open($server);
-$t->print("guest");
+$t->print("SesseBOT");
 $t->waitfor('/Press return to enter the server/');
 $t->cmd("");
 
@@ -90,7 +86,7 @@ print "FICS ready.\n";
 while (1) {
 	my $rin = '';
 	my $rout;
-	vec($rin, fileno(UCIREAD), 1) = 1;
+	vec($rin, fileno($engine->{'read'}), 1) = 1;
 	vec($rin, fileno($t), 1) = 1;
 
 	my ($nfound, $timeleft) = select($rout=$rin, undef, undef, 5.0);
@@ -103,7 +99,7 @@ while (1) {
 		chomp $line;
 		$line =~ tr/\r//d;
 		if ($line =~ /^<12> /) {
-			my $pos = style12_to_fen($line);
+			my $pos = style12_to_pos($line);
 			
 			# if this is already in the queue, ignore it
 			next if (defined($pos_waiting) && $pos->{'fen'} eq $pos_waiting->{'fen'});
@@ -116,14 +112,22 @@ while (1) {
 			# if we're already thinking on something, stop and wait for the engine
 			# to approve
 			if (defined($pos_calculating)) {
-				uciprint("stop");
-				$pos_waiting = $pos;
+				if (!defined($pos_waiting)) {
+					uciprint($engine, "stop");
+				}
+				if ($uci_assume_full_compliance) {
+					$pos_waiting = $pos;
+				} else {
+					uciprint($engine, "position fen " . $pos->{'fen'});
+					uciprint($engine, "go infinite");
+					$pos_calculating = $pos;
+				}
 			} else {
 				# it's wrong just to give the FEN (the move history is useful,
 				# and per the UCI spec, we should really have sent "ucinewgame"),
 				# but it's easier
-				uciprint("position fen " . $pos->{'fen'});
-				uciprint("go infinite");
+				uciprint($engine, "position fen " . $pos->{'fen'});
+				uciprint($engine, "go infinite");
 				$pos_calculating = $pos;
 			}
 
@@ -139,13 +143,28 @@ while (1) {
 			#
 			$t->cmd("date");
 		}
+		if ($line =~ /^([A-Za-z]+)(?:\([A-Z]+\))* tells you: (.*)$/) {
+			my ($who, $msg) = ($1, $2);
+
+			next if (grep { $_ eq $who } (@masters) == 0);
+	
+			if ($msg =~ /^fics (.*?)$/) {
+				$t->cmd("tell $who Executing '$1' on FICS.");
+				$t->cmd($1);
+			} elsif ($msg =~ /^uci (.*?)$/) {
+				$t->cmd("tell $who Sending '$1' to the engine.");
+				print { $engine->{'write'} } "$1\n";
+			} else {
+				$t->cmd("tell $who Couldn't understand '$msg', sorry.");
+			}
+		}
 		#print "FICS: [$line]\n";
 		$sleep = 0;
 	}
 	
 	# any fun on the UCI channel?
-	if ($nfound > 0 && vec($rout, fileno(UCIREAD), 1) == 1) {
-		my $line = <UCIREAD>;
+	if ($nfound > 0 && vec($rout, fileno($engine->{'read'}), 1) == 1) {
+		my $line = read_line($engine->{'read'});
 		handle_uci($line);
 		$sleep = 0;
 
@@ -161,7 +180,8 @@ sub handle_uci {
 
 	chomp $line;
 	$line =~ tr/\r//d;
-	print UCILOG "<= $line\n";
+	$line =~ s/  / /g;  # Sometimes needed for Zappa Mexico
+	print UCILOG localtime() . " <= $line\n";
 	if ($line =~ /^info/) {
 		my (@infos) = split / /, $line;
 		shift @infos;
@@ -174,10 +194,10 @@ sub handle_uci {
 
 		parse_ids(@ids);
 	}
-	if ($line =~ /^bestmove/) {
+	if ($line =~ /^bestmove/ && $uci_assume_full_compliance) {
 		if (defined($pos_waiting)) {
-			uciprint("position fen " . $pos_waiting->{'fen'});
-			uciprint("go infinite");
+			uciprint($engine, "position fen " . $pos_waiting->{'fen'});
+			uciprint($engine, "go infinite");
 
 			$pos_calculating = $pos_waiting;
 			$pos_waiting = undef;
@@ -257,16 +277,31 @@ sub parse_ids {
 	}
 }
 
-sub style12_to_fen {
+sub style12_to_pos {
 	my $str = shift;
 	my %pos = ();
 	my (@x) = split / /, $str;
 	
 	$pos{'board'} = [ @x[1..8] ];
 	$pos{'toplay'} = $x[9];
-	
+	$pos{'ep_file_num'} = $x[10];
+	$pos{'white_castle_k'} = $x[11];
+	$pos{'white_castle_q'} = $x[12];
+	$pos{'black_castle_k'} = $x[13];
+	$pos{'black_castle_q'} = $x[14];
+	$pos{'time_to_100move_rule'} = $x[15];
+	$pos{'move_num'} = $x[26];
+	$pos{'last_move'} = $x[29];
+	$pos{'fen'} = make_fen(\%pos);
+
+	return \%pos;
+}
+
+sub make_fen {
+	my $pos = shift;
+
 	# the board itself
-	my (@board) = @x[1..8];
+	my (@board) = @{$pos->{'board'}};
 	for my $rank (0..7) {
 		$board[$rank] =~ s/(-+)/length($1)/ge;
 	}
@@ -274,25 +309,26 @@ sub style12_to_fen {
 
 	# white/black to move
 	$fen .= " ";
-	$fen .= lc($x[9]);
+	$fen .= lc($pos->{'toplay'});
 
 	# castling
 	my $castling = "";
-	$castling .= "K" if ($x[11] == 1);
-	$castling .= "Q" if ($x[12] == 1);
-	$castling .= "k" if ($x[13] == 1);
-	$castling .= "q" if ($x[14] == 1);
+	$castling .= "K" if ($pos->{'white_castle_k'} == 1);
+	$castling .= "Q" if ($pos->{'white_castle_q'} == 1);
+	$castling .= "k" if ($pos->{'black_castle_k'} == 1);
+	$castling .= "q" if ($pos->{'black_castle_q'} == 1);
 	$castling = "-" if ($castling eq "");
+	# $castling = "-"; # chess960
 	$fen .= " ";
 	$fen .= $castling;
 
 	# en passant
 	my $ep = "-";
-	if ($x[10] != -1) {
-		my $col = $x[10];
+	if ($pos->{'ep_file_num'} != -1) {
+		my $col = $pos->{'ep_file_num'};
 		my $nep = (qw(a b c d e f g h))[$col];
 
-		if ($x[9] eq 'B') {
+		if ($pos->{'toplay'} eq 'B') {
 			$nep .= "3";
 		} else {
 			$nep .= "6";
@@ -305,12 +341,12 @@ sub style12_to_fen {
 		# not, just lie -- it doesn't matter anyway. I'm unsure what's the
 		# "right" thing as per the standard, though.
 		#
-		if ($x[9] eq 'B') {
-			$ep = $nep if ($col > 0 && substr($pos{'board'}[4], $col-1, 1) eq 'p');
-			$ep = $nep if ($col < 7 && substr($pos{'board'}[4], $col+1, 1) eq 'p');
+		if ($pos->{'toplay'} eq 'B') {
+			$ep = $nep if ($col > 0 && substr($pos->{'board'}[4], $col-1, 1) eq 'p');
+			$ep = $nep if ($col < 7 && substr($pos->{'board'}[4], $col+1, 1) eq 'p');
 		} else {
-			$ep = $nep if ($col > 0 && substr($pos{'board'}[3], $col-1, 1) eq 'P');
-			$ep = $nep if ($col < 7 && substr($pos{'board'}[3], $col+1, 1) eq 'P');
+			$ep = $nep if ($col > 0 && substr($pos->{'board'}[3], $col-1, 1) eq 'P');
+			$ep = $nep if ($col < 7 && substr($pos->{'board'}[3], $col+1, 1) eq 'P');
 		}
 	}
 	$fen .= " ";
@@ -318,41 +354,27 @@ sub style12_to_fen {
 
 	# half-move clock
 	$fen .= " ";
-	$fen .= $x[15];
+	$fen .= $pos->{'time_to_100move_rule'};
 
 	# full-move clock
 	$fen .= " ";
-	$fen .= $x[26];
+	$fen .= $pos->{'move_num'};
 
-	$pos{'fen'} = $fen;
-
-	return \%pos;
+	return $fen;
 }
 
-sub prettyprint_pv {
-	my ($board, @pvs) = @_;
-	
-	if (scalar @pvs == 0 || !defined($pvs[0])) {
-		return ();
-	}
-	
-	my @nb = @$board;
-
-	my $pv = shift @pvs;
-	my $from_col = ord(substr($pv, 0, 1)) - ord('a');
-	my $from_row = 7 - (ord(substr($pv, 1, 1)) - ord('1'));
-	my $to_col   = ord(substr($pv, 2, 1)) - ord('a');
-	my $to_row   = 7 - (ord(substr($pv, 3, 1)) - ord('1'));
-
-	my $pretty;
+sub make_move {
+	my ($board, $from_row, $from_col, $to_row, $to_col, $promo) = @_;
+	my $move = move_to_uci_notation($from_row, $from_col, $to_row, $to_col, $promo);
 	my $piece = substr($board->[$from_row], $from_col, 1);
+	my @nb = @$board;
 
 	if ($piece eq '-') {
-		die "Invalid move";
+		die "Invalid move $move";
 	}
 
 	# white short castling
-	if ($pv eq 'e1g1' && $piece eq 'K') {
+	if ($move eq 'e1g1' && $piece eq 'K') {
 		# king
 		substr($nb[7], 4, 1, '-');
 		substr($nb[7], 6, 1, $piece);
@@ -361,11 +383,11 @@ sub prettyprint_pv {
 		substr($nb[7], 7, 1, '-');
 		substr($nb[7], 5, 1, 'R');
 				
-		return ('0-0', prettyprint_pv(\@nb, @pvs));
+		return \@nb;
 	}
 
 	# white long castling
-	if ($pv eq 'e1c1' && $piece eq 'K') {
+	if ($move eq 'e1c1' && $piece eq 'K') {
 		# king
 		substr($nb[7], 4, 1, '-');
 		substr($nb[7], 2, 1, $piece);
@@ -374,11 +396,11 @@ sub prettyprint_pv {
 		substr($nb[7], 0, 1, '-');
 		substr($nb[7], 3, 1, 'R');
 				
-		return ('0-0-0', prettyprint_pv(\@nb, @pvs));
+		return \@nb;
 	}
 
 	# black short castling
-	if ($pv eq 'e8g8' && $piece eq 'k') {
+	if ($move eq 'e8g8' && $piece eq 'k') {
 		# king
 		substr($nb[0], 4, 1, '-');
 		substr($nb[0], 6, 1, $piece);
@@ -387,11 +409,11 @@ sub prettyprint_pv {
 		substr($nb[0], 7, 1, '-');
 		substr($nb[0], 5, 1, 'r');
 				
-		return ('0-0', prettyprint_pv(\@nb, @pvs));
+		return \@nb;
 	}
 
 	# black long castling
-	if ($pv eq 'e8c8' && $piece eq 'k') {
+	if ($move eq 'e8c8' && $piece eq 'k') {
 		# king
 		substr($nb[0], 4, 1, '-');
 		substr($nb[0], 2, 1, $piece);
@@ -400,15 +422,13 @@ sub prettyprint_pv {
 		substr($nb[0], 0, 1, '-');
 		substr($nb[0], 3, 1, 'r');
 				
-		return ('0-0-0', prettyprint_pv(\@nb, @pvs));
+		return \@nb;
 	}
 
 	# check if the from-piece is a pawn
 	if (lc($piece) eq 'p') {
 		# attack?
 		if ($from_col != $to_col) {
-			$pretty = substr($pv, 0, 1) . 'x' . substr($pv, 2, 2);
-
 			# en passant?
 			if (substr($board->[$to_row], $to_col, 1) eq '-') {
 				if ($piece eq 'p') {
@@ -417,6 +437,72 @@ sub prettyprint_pv {
 					substr($nb[$to_row - 1], $to_col, 1, '-');
 				}
 			}
+		} else {
+			if ($promo ne '') {
+				if ($piece eq 'p') {
+					$piece = $promo;
+				} else {
+					$piece = uc($promo);
+				}
+			}
+		}
+	}
+
+	# update the board
+	substr($nb[$from_row], $from_col, 1, '-');
+	substr($nb[$to_row], $to_col, 1, $piece);
+
+	return \@nb;
+}
+
+sub prettyprint_pv {
+	my ($board, @pvs) = @_;
+
+	if (scalar @pvs == 0 || !defined($pvs[0])) {
+		return ();
+	}
+
+	my $pv = shift @pvs;
+	my $from_col = col_letter_to_num(substr($pv, 0, 1));
+	my $from_row = row_letter_to_num(substr($pv, 1, 1));
+	my $to_col   = col_letter_to_num(substr($pv, 2, 1));
+	my $to_row   = row_letter_to_num(substr($pv, 3, 1));
+	my $promo    = substr($pv, 4, 1);
+
+	my $nb = make_move($board, $from_row, $from_col, $to_row, $to_col, $promo);
+	my $piece = substr($board->[$from_row], $from_col, 1);
+
+	if ($piece eq '-') {
+		die "Invalid move $pv";
+	}
+
+	# white short castling
+	if ($pv eq 'e1g1' && $piece eq 'K') {
+		return ('0-0', prettyprint_pv($nb, @pvs));
+	}
+
+	# white long castling
+	if ($pv eq 'e1c1' && $piece eq 'K') {
+		return ('0-0-0', prettyprint_pv($nb, @pvs));
+	}
+
+	# black short castling
+	if ($pv eq 'e8g8' && $piece eq 'k') {
+		return ('0-0', prettyprint_pv($nb, @pvs));
+	}
+
+	# black long castling
+	if ($pv eq 'e8c8' && $piece eq 'k') {
+		return ('0-0-0', prettyprint_pv($nb, @pvs));
+	}
+
+	my $pretty;
+
+	# check if the from-piece is a pawn
+	if (lc($piece) eq 'p') {
+		# attack?
+		if ($from_col != $to_col) {
+			$pretty = substr($pv, 0, 1) . 'x' . substr($pv, 2, 2);
 		} else {
 			$pretty = substr($pv, 2, 2);
 
@@ -477,17 +563,12 @@ sub prettyprint_pv {
 		$pretty .= substr($pv, 2, 2);
 	}
 
-	# update the board
-	substr($nb[$from_row], $from_col, 1, '-');
-	substr($nb[$to_row], $to_col, 1, $piece);
-
-	if (in_mate(\@nb)) {
+	if (in_mate($nb)) {
 		$pretty .= '#';
-	} elsif (in_check(\@nb) ne 'none') {
+	} elsif (in_check($nb) ne 'none') {
 		$pretty .= '+';
 	}
-
-	return ($pretty, prettyprint_pv(\@nb, @pvs));
+	return ($pretty, prettyprint_pv($nb, @pvs));
 }
 
 sub output_screen {
@@ -517,12 +598,22 @@ sub output_screen {
 		return;
 	}
 
-	my $text = '';
+	my $text = 'Analysis';
+	if ($pos_calculating->{'last_move'} ne 'none') {
+		if ($pos_calculating->{'toplay'} eq 'W') {
+			$text .= sprintf ' after %u. ... %s', ($pos_calculating->{'move_num'}-1), $pos_calculating->{'last_move'};
+		} else {
+			$text .= sprintf ' after %u. %s', $pos_calculating->{'move_num'}, $pos_calculating->{'last_move'};
+		}
+		if (exists($uciid{'name'})) {
+			$text .= ',';
+		}
+	}
 
 	if (exists($uciid{'name'})) {
-		$text .= "Analysis by $uciid{'name'}:\n\n";
+		$text .= " by $uciid{'name'}:\n\n";
 	} else {
-		$text .= "Analysis:\n\n";
+		$text .= ":\n\n";
 	}
 
 	return unless (exists($pos_calculating->{'board'}));
@@ -533,7 +624,7 @@ sub output_screen {
 	# specified.
 	#
 	if (exists($uciinfo{'pv1'}) && !exists($uciinfo{'pv2'})) {
-		for my $key qw(pv score_cp score_mate nodes nps depth seldepth tbhits) {
+		for my $key (qw(pv score_cp score_mate nodes nps depth seldepth tbhits)) {
 			if (exists($uciinfo{$key . '1'}) && !exists($uciinfo{$key})) {
 				$uciinfo{$key} = $uciinfo{$key . '1'};
 			}
@@ -549,8 +640,12 @@ sub output_screen {
 			$text .= "  ($score)" if (defined($score));
 
 			my $tbhits = '';
-			if (exists($uciinfo{'tbhits' . $mpv})) {
-				$tbhits = sprintf ", %u tbhits", $uciinfo{'tbhits' . $mpv};
+			if (exists($uciinfo{'tbhits' . $mpv}) && $uciinfo{'tbhits' . $mpv} > 0) {
+				if ($uciinfo{'tbhits' . $mpv} == 1) {
+					$tbhits = ", 1 tbhit";
+				} else {
+					$tbhits = sprintf ", %u tbhits", $uciinfo{'tbhits' . $mpv};
+				}
 			}
 
 			if (exists($uciinfo{'nodes' . $mpv}) && exists($uciinfo{'nps' . $mpv}) && exists($uciinfo{'depth' . $mpv})) {
@@ -574,8 +669,12 @@ sub output_screen {
 			$text .= sprintf "  %u nodes, %7u nodes/sec, depth %u ply",
 				$uciinfo{'nodes'}, $uciinfo{'nps'}, $uciinfo{'depth'};
 		}
-		if (exists($uciinfo{'tbhits'})) {
-			$text .= sprintf ", %u Nalimov hits", $uciinfo{'tbhits'};
+		if (exists($uciinfo{'tbhits'}) && $uciinfo{'tbhits'} > 0) {
+			if ($uciinfo{'tbhits'} == 1) {
+				$text .= ", one Nalimov hit";
+			} else {
+				$text .= sprintf ", %u Nalimov hits", $uciinfo{'tbhits'};
+			}
 		}
 		if (exists($uciinfo{'seldepth'})) {
 			$text .= sprintf " (%u selective)", $uciinfo{'seldepth'};
@@ -583,6 +682,8 @@ sub output_screen {
 		$text .=  "\n\n";
 	}
 
+	#$text .= book_info($pos_calculating->{'fen'}, $pos_calculating->{'board'}, $pos_calculating->{'toplay'});
+
 	if ($last_text ne $text) {
 		print ""; # clear the screen
 		print $text;
@@ -810,11 +911,17 @@ sub can_reach {
 		return (can_reach($board, 'R', $from_row, $from_col, $to_row, $to_col) ||
 		        can_reach($board, 'B', $from_row, $from_col, $to_row, $to_col));
 	}
+
+	# TODO: en passant
 	if ($piece eq 'p') {
 		# black pawn
 		if ($to_col == $from_col && $to_row == $from_row + 1) {
 			return ($dest_piece eq '-');
 		}
+		if ($to_col == $from_col && $from_row == 1 && $to_row == 3) {
+			my $middle_piece = substr($board->[2], $to_col, 1);
+			return ($dest_piece eq '-' && $middle_piece eq '-');
+		}
 		if (abs($to_col - $from_col) == 1 && $to_row == $from_row + 1) {
 			return ($dest_piece ne '-');
 		}
@@ -825,6 +932,10 @@ sub can_reach {
 		if ($to_col == $from_col && $to_row == $from_row - 1) {
 			return ($dest_piece eq '-');
 		}
+		if ($to_col == $from_col && $from_row == 6 && $to_row == 4) {
+			my $middle_piece = substr($board->[5], $to_col, 1);
+			return ($dest_piece eq '-' && $middle_piece eq '-');
+		}
 		if (abs($to_col - $from_col) == 1 && $to_row == $from_row - 1) {
 			return ($dest_piece ne '-');
 		}
@@ -836,9 +947,9 @@ sub can_reach {
 }
 
 sub uciprint {
-	my $msg = shift;
-	print UCIWRITE "$msg\n";
-	print UCILOG "=> $msg\n";
+	my ($engine, $msg) = @_;
+	print { $engine->{'write'} } "$msg\n";
+	print UCILOG localtime() . " => $msg\n";
 }
 
 sub short_score {
@@ -884,3 +995,118 @@ sub long_score {
 
 	return undef;
 }
+
+my %book_cache = ();
+sub book_info {
+	my ($fen, $board, $toplay) = @_;
+
+	if (exists($book_cache{$fen})) {
+		return $book_cache{$fen};
+	}
+
+	my $ret = `./booklook $fen`;
+	return "" if ($ret =~ /Not found/ || $ret eq '');
+
+	my @moves = ();
+
+	for my $m (split /\n/, $ret) {
+		my ($move, $annotation, $win, $draw, $lose, $rating, $rating_div) = split /,/, $m;
+
+		my $pmove;
+		if ($move eq '')  {
+			$pmove = '(current)';
+		} else {
+			($pmove) = prettyprint_pv($board, $move);
+			$pmove .= $annotation;
+		}
+
+		my $score;
+		if ($toplay eq 'W') {
+			$score = 1.0 * $win + 0.5 * $draw + 0.0 * $lose;
+		} else {
+			$score = 0.0 * $win + 0.5 * $draw + 1.0 * $lose;
+		}
+		my $n = $win + $draw + $lose;
+		
+		my $percent;
+		if ($n == 0) {
+			$percent = "     ";
+		} else {
+			$percent = sprintf "%4u%%", int(100.0 * $score / $n + 0.5);
+		}
+
+		push @moves, [ $pmove, $n, $percent, $rating ];
+	}
+
+	@moves[1..$#moves] = sort { $b->[2] cmp $a->[2] } @moves[1..$#moves];
+	
+	my $text = "Book moves:\n\n              Perf.     N     Rating\n\n";
+	for my $m (@moves) {
+		$text .= sprintf "  %-10s %s   %6u    %4s\n", $m->[0], $m->[2], $m->[1], $m->[3]
+	}
+
+	return $text;
+}
+
+sub open_engine {
+	my $cmdline = shift;
+	my ($uciread, $uciwrite);
+	my $pid = IPC::Open2::open2($uciread, $uciwrite, $cmdline);
+
+	my $engine = {
+		pid => $pid,
+		read => $uciread,
+		write => $uciwrite
+	};
+
+	uciprint($engine, "uci");
+
+	# gobble the options
+	while (<$uciread>) {
+		/uciok/ && last;
+		handle_uci($_);
+	}
+	
+	return $engine;
+}
+
+sub read_line {
+	my $fh = shift;
+
+	# 
+	# Read until we've got a full line -- if the engine sends part of
+	# a line and then stops we're pretty much hosed, but that should
+	# never happen.
+	#
+	my $line = '';
+	while ($line !~ /\n/) {
+		my $tmp;
+		my $ret = sysread $engine->{'read'}, $tmp, 1;
+
+		if (!defined($ret)) {
+			next if ($!{EINTR});
+			die "error in reading from the UCI engine: $!";
+		} elsif ($ret == 0) {
+			die "EOF from UCI engine";
+		}
+
+		$line .= $tmp;
+	}
+
+	$line =~ tr/\r\n//d;
+	return $line;
+}
+
+sub col_letter_to_num {
+	return ord(shift) - ord('a');
+}
+
+sub row_letter_to_num {
+	return 7 - (ord(shift) - ord('1'));
+}
+
+sub move_to_uci_notation {
+	my ($from_row, $from_col, $to_row, $to_col, $promo) = @_;
+	$promo //= "";
+	return sprintf("%c%d%c%d%s", ord('a') + $from_col, 8 - $from_row, ord('a') + $to_col, 8 - $to_row, $promo);
+}