Change main loop to using AnyEvent.
[remoteglot] / remoteglot.pl
1 #! /usr/bin/perl
2
3 #
4 # remoteglot - Connects an abitrary UCI-speaking engine to ICS for easier post-game
5 #              analysis, or for live analysis of relayed games. (Do not use for
6 #              cheating! Cheating is bad for your karma, and your abuser flag.)
7 #
8 # Copyright 2007 Steinar H. Gunderson <sgunderson@bigfoot.com>
9 # Licensed under the GNU General Public License, version 2.
10 #
11
12 use AnyEvent;
13 use AnyEvent::Handle;
14 use AnyEvent::Loop;
15 use Net::Telnet;
16 use FileHandle;
17 use IPC::Open2;
18 use Time::HiRes;
19 use JSON::XS;
20 require 'Position.pm';
21 require 'Engine.pm';
22 use strict;
23 use warnings;
24
25 # Configuration
26 my $server = "freechess.org";
27 my $target = "GMCarlsen";
28 my $engine_cmdline = "'./Deep Rybka 4 SSE42 x64'";
29 my $engine2_cmdline = "./stockfish_13111119_x64_modern_sse42";  # undef for none
30 my $uci_assume_full_compliance = 0;                    # dangerous :-)
31 my $update_max_interval = 1.0;
32 my @masters = (
33         'Sesse',
34         'Sessse',
35         'Sesssse',
36         'greatestguns',
37         'beuki'
38 );
39
40 # Program starts here
41 $SIG{ALRM} = sub { output(); };
42 my $latest_update = undef;
43
44 $| = 1;
45
46 open(FICSLOG, ">ficslog.txt")
47         or die "ficslog.txt: $!";
48 print FICSLOG "Log starting.\n";
49 select(FICSLOG);
50 $| = 1;
51
52 open(UCILOG, ">ucilog.txt")
53         or die "ucilog.txt: $!";
54 print UCILOG "Log starting.\n";
55 select(UCILOG);
56 $| = 1;
57 select(STDOUT);
58
59 # open the chess engine
60 my $engine = open_engine($engine_cmdline, 'E1', sub { handle_uci(@_, 1); });
61 my $engine2 = open_engine($engine2_cmdline, 'E2', sub { handle_uci(@_, 0); });
62 my $last_move;
63 my $last_text = '';
64 my ($pos_waiting, $pos_calculating, $pos_calculating_second_engine);
65
66 uciprint($engine, "setoption name UCI_AnalyseMode value true");
67 # uciprint($engine, "setoption name NalimovPath value /srv/tablebase");
68 uciprint($engine, "setoption name NalimovUsage value Rarely");
69 uciprint($engine, "setoption name Hash value 1024");
70 # uciprint($engine, "setoption name MultiPV value 2");
71 uciprint($engine, "ucinewgame");
72
73 if (defined($engine2)) {
74         uciprint($engine2, "setoption name UCI_AnalyseMode value true");
75         # uciprint($engine2, "setoption name NalimovPath value /srv/tablebase");
76         uciprint($engine2, "setoption name NalimovUsage value Rarely");
77         uciprint($engine2, "setoption name Hash value 1024");
78         uciprint($engine2, "setoption name Threads value 8");
79         uciprint($engine2, "setoption name MultiPV value 500");
80         uciprint($engine2, "ucinewgame");
81 }
82
83 print "Chess engine ready.\n";
84
85 # now talk to FICS
86 my $t = Net::Telnet->new(Timeout => 10, Prompt => '/fics% /');
87 $t->input_log(\*FICSLOG);
88 $t->open($server);
89 $t->print("SesseBOT");
90 $t->waitfor('/Press return to enter the server/');
91 $t->cmd("");
92
93 # set some options
94 $t->cmd("set shout 0");
95 $t->cmd("set seek 0");
96 $t->cmd("set style 12");
97 $t->cmd("observe $target");
98 print "FICS ready.\n";
99
100 my $ev1 = AnyEvent->io(
101         fh => fileno($t),
102         poll => 'r',
103         cb => sub {    # what callback to execute
104                 while (1) {
105                         my $line = $t->getline(Timeout => 0, errmode => 'return');
106                         return if (!defined($line));
107
108                         chomp $line;
109                         $line =~ tr/\r//d;
110                         handle_fics($line);
111                 }
112         }
113 );
114 # Engine events have already been set up by Engine.pm.
115 AnyEvent::Loop::run;
116
117 sub handle_uci {
118         my ($engine, $line, $primary) = @_;
119
120         $line =~ s/  / /g;  # Sometimes needed for Zappa Mexico
121         print UCILOG localtime() . " $engine->{'tag'} <= $line\n";
122         if ($line =~ /^info/) {
123                 my (@infos) = split / /, $line;
124                 shift @infos;
125
126                 parse_infos($engine, @infos);
127         }
128         if ($line =~ /^id/) {
129                 my (@ids) = split / /, $line;
130                 shift @ids;
131
132                 parse_ids($engine, @ids);
133         }
134         if ($line =~ /^bestmove/) {
135                 if ($primary) {
136                         return if (!$uci_assume_full_compliance);
137                         if (defined($pos_waiting)) {
138                                 uciprint($engine, "position fen " . $pos_waiting->fen());
139                                 uciprint($engine, "go infinite");
140
141                                 $pos_calculating = $pos_waiting;
142                                 $pos_waiting = undef;
143                         }
144                 } else {
145                         $engine2->{'info'} = {};
146                         my $pos = $pos_waiting // $pos_calculating;
147                         uciprint($engine2, "position fen " . $pos->fen());
148                         uciprint($engine2, "go infinite");
149                         $pos_calculating_second_engine = $pos;
150                 }
151         }
152         output();
153 }
154
155 sub handle_fics {
156         my $line = shift;
157         if ($line =~ /^<12> /) {
158                 my $pos = Position->new($line);
159                 
160                 # if this is already in the queue, ignore it
161                 next if (defined($pos_waiting) && $pos->fen() eq $pos_waiting->fen());
162
163                 # if we're already chewing on this and there's nothing else in the queue,
164                 # also ignore it
165                 next if (!defined($pos_waiting) && defined($pos_calculating) &&
166                          $pos->fen() eq $pos_calculating->fen());
167
168                 # if we're already thinking on something, stop and wait for the engine
169                 # to approve
170                 if (defined($pos_calculating)) {
171                         if (!defined($pos_waiting)) {
172                                 uciprint($engine, "stop");
173                         }
174                         if ($uci_assume_full_compliance) {
175                                 $pos_waiting = $pos;
176                         } else {
177                                 uciprint($engine, "position fen " . $pos->fen());
178                                 uciprint($engine, "go infinite");
179                                 $pos_calculating = $pos;
180                         }
181                 } else {
182                         # it's wrong just to give the FEN (the move history is useful,
183                         # and per the UCI spec, we should really have sent "ucinewgame"),
184                         # but it's easier
185                         uciprint($engine, "position fen " . $pos->fen());
186                         uciprint($engine, "go infinite");
187                         $pos_calculating = $pos;
188                 }
189
190                 if (defined($engine2)) {
191                         if (defined($pos_calculating_second_engine)) {
192                                 uciprint($engine2, "stop");
193                         } else {
194                                 uciprint($engine2, "position fen " . $pos->fen());
195                                 uciprint($engine2, "go infinite");
196                                 $pos_calculating_second_engine = $pos;
197                         }
198                         $engine2->{'info'} = {};
199                 }
200
201                 $engine->{'info'} = {};
202                 $last_move = time;
203
204                 # 
205                 # Output a command every move to note that we're
206                 # still paying attention -- this is a good tradeoff,
207                 # since if no move has happened in the last half
208                 # hour, the analysis/relay has most likely stopped
209                 # and we should stop hogging server resources.
210                 #
211                 $t->cmd("date");
212         }
213         if ($line =~ /^([A-Za-z]+)(?:\([A-Z]+\))* tells you: (.*)$/) {
214                 my ($who, $msg) = ($1, $2);
215
216                 next if (grep { $_ eq $who } (@masters) == 0);
217
218                 if ($msg =~ /^fics (.*?)$/) {
219                         $t->cmd("tell $who Executing '$1' on FICS.");
220                         $t->cmd($1);
221                 } elsif ($msg =~ /^uci (.*?)$/) {
222                         $t->cmd("tell $who Sending '$1' to the engine.");
223                         print { $engine->{'write'} } "$1\n";
224                 } else {
225                         $t->cmd("tell $who Couldn't understand '$msg', sorry.");
226                 }
227         }
228         #print "FICS: [$line]\n";
229 }
230
231 sub parse_infos {
232         my ($engine, @x) = @_;
233         my $mpv = '';
234
235         my $info = $engine->{'info'};
236
237         # Search for "multipv" first of all, since e.g. Stockfish doesn't put it first.
238         for my $i (0..$#x - 1) {
239                 if ($x[$i] =~ 'multipv') {
240                         $mpv = $x[$i + 1];
241                         next;
242                 }
243         }
244
245         while (scalar @x > 0) {
246                 if ($x[0] =~ 'multipv') {
247                         # Dealt with above
248                         shift @x;
249                         shift @x;
250                         next;
251                 }
252                 if ($x[0] =~ /^(currmove|currmovenumber|cpuload)$/) {
253                         my $key = shift @x;
254                         my $value = shift @x;
255                         $info->{$key} = $value;
256                         next;
257                 }
258                 if ($x[0] =~ /^(depth|seldepth|hashfull|time|nodes|nps|tbhits)$/) {
259                         my $key = shift @x;
260                         my $value = shift @x;
261                         $info->{$key . $mpv} = $value;
262                         next;
263                 }
264                 if ($x[0] eq 'score') {
265                         shift @x;
266
267                         delete $info->{'score_cp' . $mpv};
268                         delete $info->{'score_mate' . $mpv};
269
270                         while ($x[0] =~ /^(cp|mate|lowerbound|upperbound)$/) {
271                                 if ($x[0] eq 'cp') {
272                                         shift @x;
273                                         $info->{'score_cp' . $mpv} = shift @x;
274                                 } elsif ($x[0] eq 'mate') {
275                                         shift @x;
276                                         $info->{'score_mate' . $mpv} = shift @x;
277                                 } else {
278                                         shift @x;
279                                 }
280                         }
281                         next;
282                 }
283                 if ($x[0] eq 'pv') {
284                         $info->{'pv' . $mpv} = [ @x[1..$#x] ];
285                         last;
286                 }
287                 if ($x[0] eq 'string' || $x[0] eq 'UCI_AnalyseMode' || $x[0] eq 'setting' || $x[0] eq 'contempt') {
288                         last;
289                 }
290
291                 #print "unknown info '$x[0]', trying to recover...\n";
292                 #shift @x;
293                 die "Unknown info '" . join(',', @x) . "'";
294
295         }
296 }
297
298 sub parse_ids {
299         my ($engine, @x) = @_;
300
301         while (scalar @x > 0) {
302                 if ($x[0] =~ /^(name|author)$/) {
303                         my $key = shift @x;
304                         my $value = join(' ', @x);
305                         $engine->{'id'}{$key} = $value;
306                         last;
307                 }
308
309                 # unknown
310                 shift @x;
311         }
312 }
313
314 sub prettyprint_pv {
315         my ($board, @pvs) = @_;
316
317         if (scalar @pvs == 0 || !defined($pvs[0])) {
318                 return ();
319         }
320
321         my $pv = shift @pvs;
322         my ($from_col, $from_row, $to_col, $to_row, $promo) = parse_uci_move($pv);
323         my ($pretty, $nb) = $board->prettyprint_move($from_row, $from_col, $to_row, $to_col, $promo);
324         return ($pretty, prettyprint_pv($nb, @pvs));
325 }
326
327 sub output {
328         #return;
329
330         return if (!defined($pos_calculating));
331
332         # Don't update too often.
333         my $age = Time::HiRes::tv_interval($latest_update);
334         if ($age < $update_max_interval) {
335                 Time::HiRes::alarm($update_max_interval + 0.01 - $age);
336                 return;
337         }
338         
339         my $info = $engine->{'info'};
340         
341         #
342         # Some programs _always_ report MultiPV, even with only one PV.
343         # In this case, we simply use that data as if MultiPV was never
344         # specified.
345         #
346         if (exists($info->{'pv1'}) && !exists($info->{'pv2'})) {
347                 for my $key (qw(pv score_cp score_mate nodes nps depth seldepth tbhits)) {
348                         if (exists($info->{$key . '1'})) {
349                                 $info->{$key} = $info->{$key . '1'};
350                         }
351                 }
352         }
353         
354         #
355         # Check the PVs first. if they're invalid, just wait, as our data
356         # is most likely out of sync. This isn't a very good solution, as
357         # it can frequently miss stuff, but it's good enough for most users.
358         #
359         eval {
360                 my $dummy;
361                 if (exists($info->{'pv'})) {
362                         $dummy = prettyprint_pv($pos_calculating->{'board'}, @{$info->{'pv'}});
363                 }
364         
365                 my $mpv = 1;
366                 while (exists($info->{'pv' . $mpv})) {
367                         $dummy = prettyprint_pv($pos_calculating->{'board'}, @{$info->{'pv' . $mpv}});
368                         ++$mpv;
369                 }
370         };
371         if ($@) {
372                 $engine->{'info'} = {};
373                 return;
374         }
375
376         output_screen();
377         output_json();
378         $latest_update = [Time::HiRes::gettimeofday];
379 }
380
381 sub output_screen {
382         my $info = $engine->{'info'};
383         my $id = $engine->{'id'};
384
385         my $text = 'Analysis';
386         if ($pos_calculating->{'last_move'} ne 'none') {
387                 if ($pos_calculating->{'toplay'} eq 'W') {
388                         $text .= sprintf ' after %u. ... %s', ($pos_calculating->{'move_num'}-1), $pos_calculating->{'last_move'};
389                 } else {
390                         $text .= sprintf ' after %u. %s', $pos_calculating->{'move_num'}, $pos_calculating->{'last_move'};
391                 }
392                 if (exists($id->{'name'})) {
393                         $text .= ',';
394                 }
395         }
396
397         if (exists($id->{'name'})) {
398                 $text .= " by $id->{'name'}:\n\n";
399         } else {
400                 $text .= ":\n\n";
401         }
402
403         return unless (exists($pos_calculating->{'board'}));
404                 
405         if (exists($info->{'pv1'}) && exists($info->{'pv2'})) {
406                 # multi-PV
407                 my $mpv = 1;
408                 while (exists($info->{'pv' . $mpv})) {
409                         $text .= sprintf "  PV%2u", $mpv;
410                         my $score = short_score($info, $pos_calculating, $mpv);
411                         $text .= "  ($score)" if (defined($score));
412
413                         my $tbhits = '';
414                         if (exists($info->{'tbhits' . $mpv}) && $info->{'tbhits' . $mpv} > 0) {
415                                 if ($info->{'tbhits' . $mpv} == 1) {
416                                         $tbhits = ", 1 tbhit";
417                                 } else {
418                                         $tbhits = sprintf ", %u tbhits", $info->{'tbhits' . $mpv};
419                                 }
420                         }
421
422                         if (exists($info->{'nodes' . $mpv}) && exists($info->{'nps' . $mpv}) && exists($info->{'depth' . $mpv})) {
423                                 $text .= sprintf " (%5u kn, %3u kn/s, %2u ply$tbhits)",
424                                         $info->{'nodes' . $mpv} / 1000, $info->{'nps' . $mpv} / 1000, $info->{'depth' . $mpv};
425                         }
426
427                         $text .= ":\n";
428                         $text .= "  " . join(', ', prettyprint_pv($pos_calculating->{'board'}, @{$info->{'pv' . $mpv}})) . "\n";
429                         $text .= "\n";
430                         ++$mpv;
431                 }
432         } else {
433                 # single-PV
434                 my $score = long_score($info, $pos_calculating, '');
435                 $text .= "  $score\n" if defined($score);
436                 $text .=  "  PV: " . join(', ', prettyprint_pv($pos_calculating->{'board'}, @{$info->{'pv'}}));
437                 $text .=  "\n";
438
439                 if (exists($info->{'nodes'}) && exists($info->{'nps'}) && exists($info->{'depth'})) {
440                         $text .= sprintf "  %u nodes, %7u nodes/sec, depth %u ply",
441                                 $info->{'nodes'}, $info->{'nps'}, $info->{'depth'};
442                 }
443                 if (exists($info->{'seldepth'})) {
444                         $text .= sprintf " (%u selective)", $info->{'seldepth'};
445                 }
446                 if (exists($info->{'tbhits'}) && $info->{'tbhits'} > 0) {
447                         if ($info->{'tbhits'} == 1) {
448                                 $text .= ", one Syzygy hit";
449                         } else {
450                                 $text .= sprintf ", %u Syzygy hits", $info->{'tbhits'};
451                         }
452                 }
453                 $text .= "\n\n";
454         }
455
456         #$text .= book_info($pos_calculating->fen(), $pos_calculating->{'board'}, $pos_calculating->{'toplay'});
457
458         my @refutation_lines = ();
459         if (defined($engine2)) {
460                 for (my $mpv = 1; $mpv < 500; ++$mpv) {
461                         my $info = $engine2->{'info'};
462                         last if (!exists($info->{'pv' . $mpv}));
463                         eval {
464                                 my $pv = $info->{'pv' . $mpv};
465
466                                 my $pretty_move = join('', prettyprint_pv($pos_calculating_second_engine->{'board'}, $pv->[0]));
467                                 my @pretty_pv = prettyprint_pv($pos_calculating_second_engine->{'board'}, @$pv);
468                                 if (scalar @pretty_pv > 5) {
469                                         @pretty_pv = @pretty_pv[0..4];
470                                         push @pretty_pv, "...";
471                                 }
472                                 my $key = $pretty_move;
473                                 my $line = sprintf("  %-6s %6s %3s  %s",
474                                         $pretty_move,
475                                         short_score($info, $pos_calculating_second_engine, $mpv, 0),
476                                         "d" . $info->{'depth' . $mpv},
477                                         join(', ', @pretty_pv));
478                                 push @refutation_lines, [ $key, $line ];
479                         };
480                 }
481         }
482
483         if ($#refutation_lines >= 0) {
484                 $text .= "Shallow search of all legal moves:\n\n";
485                 for my $line (sort { $a->[0] cmp $b->[0] } @refutation_lines) {
486                         $text .= $line->[1] . "\n";
487                 }
488                 $text .= "\n\n";        
489         }       
490
491         if ($last_text ne $text) {
492                 print "\e[H\e[2J"; # clear the screen
493                 print $text;
494                 $last_text = $text;
495         }
496 }
497
498 sub output_json {
499         my $info = $engine->{'info'};
500
501         my $json = {};
502         $json->{'position'} = $pos_calculating->to_json_hash();
503         $json->{'id'} = $engine->{'id'};
504         $json->{'score'} = long_score($info, $pos_calculating, '');
505
506         $json->{'nodes'} = $info->{'nodes'};
507         $json->{'nps'} = $info->{'nps'};
508         $json->{'depth'} = $info->{'depth'};
509         $json->{'tbhits'} = $info->{'tbhits'};
510         $json->{'seldepth'} = $info->{'seldepth'};
511
512         # single-PV only for now
513         $json->{'pv_uci'} = $info->{'pv'};
514         $json->{'pv_pretty'} = [ prettyprint_pv($pos_calculating->{'board'}, @{$info->{'pv'}}) ];
515
516         my %refutation_lines = ();
517         my @refutation_lines = ();
518         if (defined($engine2)) {
519                 for (my $mpv = 1; $mpv < 500; ++$mpv) {
520                         my $info = $engine2->{'info'};
521                         my $pretty_move = "";
522                         my @pretty_pv = ();
523                         last if (!exists($info->{'pv' . $mpv}));
524
525                         eval {
526                                 my $pv = $info->{'pv' . $mpv};
527                                 my $pretty_move = join('', prettyprint_pv($pos_calculating->{'board'}, $pv->[0]));
528                                 my @pretty_pv = prettyprint_pv($pos_calculating->{'board'}, @$pv);
529                                 $refutation_lines{$pv->[0]} = {
530                                         sort_key => $pretty_move,
531                                         depth => $info->{'depth' . $mpv},
532                                         score_sort_key => score_sort_key($info, $pos_calculating, $mpv, 0),
533                                         pretty_score => short_score($info, $pos_calculating, $mpv, 0),
534                                         pretty_move => $pretty_move,
535                                         pv_pretty => \@pretty_pv,
536                                 };
537                                 $refutation_lines{$pv->[0]}->{'pv_uci'} = $pv;
538                         };
539                 }
540         }
541         $json->{'refutation_lines'} = \%refutation_lines;
542
543         open my $fh, ">/srv/analysis.sesse.net/www/analysis.json.tmp"
544                 or return;
545         print $fh JSON::XS::encode_json($json);
546         close $fh;
547         rename("/srv/analysis.sesse.net/www/analysis.json.tmp", "/srv/analysis.sesse.net/www/analysis.json");
548 }
549
550 sub uciprint {
551         my ($engine, $msg) = @_;
552         $engine->print($msg);
553         print UCILOG localtime() . " $engine->{'tag'} => $msg\n";
554 }
555
556 sub short_score {
557         my ($info, $pos, $mpv, $invert) = @_;
558
559         $invert //= 0;
560         if ($pos->{'toplay'} eq 'B') {
561                 $invert = !$invert;
562         }
563
564         if (defined($info->{'score_mate' . $mpv})) {
565                 if ($invert) {
566                         return sprintf "M%3d", -$info->{'score_mate' . $mpv};
567                 } else {
568                         return sprintf "M%3d", $info->{'score_mate' . $mpv};
569                 }
570         } else {
571                 if (exists($info->{'score_cp' . $mpv})) {
572                         my $score = $info->{'score_cp' . $mpv} * 0.01;
573                         if ($score == 0) {
574                                 return " 0.00";
575                         }
576                         if ($invert) {
577                                 $score = -$score;
578                         }
579                         return sprintf "%+5.2f", $score;
580                 }
581         }
582
583         return undef;
584 }
585
586 sub score_sort_key {
587         my ($info, $pos, $mpv, $invert) = @_;
588
589         if (defined($info->{'score_mate' . $mpv})) {
590                 if ($invert) {
591                         return 99999 - $info->{'score_mate' . $mpv};
592                 } else {
593                         return -(99999 - $info->{'score_mate' . $mpv});
594                 }
595         } else {
596                 if (exists($info->{'score_cp' . $mpv})) {
597                         my $score = $info->{'score_cp' . $mpv};
598                         if ($invert) {
599                                 $score = -$score;
600                         }
601                         return $score;
602                 }
603         }
604
605         return undef;
606 }
607
608 sub long_score {
609         my ($info, $pos, $mpv) = @_;
610
611         if (defined($info->{'score_mate' . $mpv})) {
612                 my $mate = $info->{'score_mate' . $mpv};
613                 if ($pos->{'toplay'} eq 'B') {
614                         $mate = -$mate;
615                 }
616                 if ($mate > 0) {
617                         return sprintf "White mates in %u", $mate;
618                 } else {
619                         return sprintf "Black mates in %u", -$mate;
620                 }
621         } else {
622                 if (exists($info->{'score_cp' . $mpv})) {
623                         my $score = $info->{'score_cp' . $mpv} * 0.01;
624                         if ($score == 0) {
625                                 return "Score:  0.00";
626                         }
627                         if ($pos->{'toplay'} eq 'B') {
628                                 $score = -$score;
629                         }
630                         return sprintf "Score: %+5.2f", $score;
631                 }
632         }
633
634         return undef;
635 }
636
637 my %book_cache = ();
638 sub book_info {
639         my ($fen, $board, $toplay) = @_;
640
641         if (exists($book_cache{$fen})) {
642                 return $book_cache{$fen};
643         }
644
645         my $ret = `./booklook $fen`;
646         return "" if ($ret =~ /Not found/ || $ret eq '');
647
648         my @moves = ();
649
650         for my $m (split /\n/, $ret) {
651                 my ($move, $annotation, $win, $draw, $lose, $rating, $rating_div) = split /,/, $m;
652
653                 my $pmove;
654                 if ($move eq '')  {
655                         $pmove = '(current)';
656                 } else {
657                         ($pmove) = prettyprint_pv($board, $move);
658                         $pmove .= $annotation;
659                 }
660
661                 my $score;
662                 if ($toplay eq 'W') {
663                         $score = 1.0 * $win + 0.5 * $draw + 0.0 * $lose;
664                 } else {
665                         $score = 0.0 * $win + 0.5 * $draw + 1.0 * $lose;
666                 }
667                 my $n = $win + $draw + $lose;
668                 
669                 my $percent;
670                 if ($n == 0) {
671                         $percent = "     ";
672                 } else {
673                         $percent = sprintf "%4u%%", int(100.0 * $score / $n + 0.5);
674                 }
675
676                 push @moves, [ $pmove, $n, $percent, $rating ];
677         }
678
679         @moves[1..$#moves] = sort { $b->[2] cmp $a->[2] } @moves[1..$#moves];
680         
681         my $text = "Book moves:\n\n              Perf.     N     Rating\n\n";
682         for my $m (@moves) {
683                 $text .= sprintf "  %-10s %s   %6u    %4s\n", $m->[0], $m->[2], $m->[1], $m->[3]
684         }
685
686         return $text;
687 }
688
689 sub open_engine {
690         my ($cmdline, $tag, $cb) = @_;
691         return undef if (!defined($cmdline));
692         return Engine->open($cmdline, $tag, $cb);
693 }
694
695 sub col_letter_to_num {
696         return ord(shift) - ord('a');
697 }
698
699 sub row_letter_to_num {
700         return 7 - (ord(shift) - ord('1'));
701 }
702
703 sub parse_uci_move {
704         my $move = shift;
705         my $from_col = col_letter_to_num(substr($move, 0, 1));
706         my $from_row = row_letter_to_num(substr($move, 1, 1));
707         my $to_col   = col_letter_to_num(substr($move, 2, 1));
708         my $to_row   = row_letter_to_num(substr($move, 3, 1));
709         my $promo    = substr($move, 4, 1);
710         return ($from_col, $from_row, $to_col, $to_row, $promo);
711 }