src/CommandStubs.pl

   1 #
   2 # User Command Extension Stubs
   3 # WARN: this file does not reload on HUP.
   4 #
   5
   6 #use strict; # TODO: sub { \&{ $hash{'CODEREF'} }($flatarg) };
   7
   8 use vars qw($who $msgType $conn $chan $message $ident $talkchannel
   9         $bot_version $bot_data_dir);
  10 use vars qw(@vernick @vernicktodo);
  11 use vars qw(%channels %cache %mask %userstats %myModules %cmdstats
  12         %cmdhooks %lang %ver);
  13 # TODO: FIX THE FOLLOWING:
  14 use vars qw($total $x $type $i $good %wingateToDo);
  15
  16 ### COMMAND HOOK IMPLEMENTATION.
  17 # addCmdHook('TEXT_HOOK',
  18 #       (CODEREF        => 'Blah',
  19 #       Forker          => 1,
  20 #       Module          => 'blah.pl'            # preload module.
  21 #       Identifier      => 'config_label',      # change to Config?
  22 #       Help            => 'help_label',
  23 #       Cmdstats        => 'text_label',)
  24 #}
  25 ###
  26
  27 sub addCmdHook {
  28     my ($ident, %hash) = @_;
  29
  30     if (exists $cmdhooks{$ident}) {
  31         &WARN("aCH: \$cmdhooks{$ident} already exists.");
  32         return;
  33     }
  34
  35     &VERB("aCH: added $ident",2);       # use $hash{'Identifier'}?
  36     ### hrm... prevent warnings?
  37     $cmdhooks{$ident} = \%hash;
  38 }
  39
  40 # RUN IF ADDRESSED.
  41 sub parseCmdHook {
  42     my ($line) = @_;
  43     $line =~ s/^\s+|\s+$//g;    # again.
  44     $line =~ /^(\S+)(\s+(.*))?$/;
  45     my $cmd     = $1;   # command name is whitespaceless.
  46     my $flatarg = $3;
  47     my @args    = split(/\s+/, $flatarg || '');
  48     my $done    = 0;
  49
  50     &shmFlush();
  51
  52     if (!defined %cmdhooks) {
  53         &WARN('%cmdhooks does not exist.');
  54         return 0;
  55     }
  56
  57     if (!defined $cmd) {
  58         &WARN('cstubs: cmd == NULL.');
  59         return 0;
  60     }
  61
  62     foreach (keys %cmdhooks) {
  63         # rename to something else! like $id or $label?
  64         my $ident = $_;
  65
  66         next unless ($cmd =~ /^$ident$/i);
  67
  68         if ($done) {
  69             &WARN("pCH: Multiple hook match: $ident");
  70             next;
  71         }
  72
  73         &status("cmdhooks: $cmd matched '$ident' '$flatarg'");
  74         my %hash = %{ $cmdhooks{$ident} };
  75
  76         if (!scalar keys %hash) {
  77             &WARN('CmdHook: hash is NULL?');
  78             return 1;
  79         }
  80
  81         if ($hash{NoArgs} and $flatarg) {
  82             &DEBUG("cmd $ident does not take args ('$flatarg'); skipping.");
  83             next;
  84         }
  85
  86         if (!exists $hash{CODEREF}) {
  87             &ERROR("CODEREF undefined for $cmd or $ident.");
  88             return 1;
  89         }
  90
  91         ### DEBUG.
  92         foreach (keys %hash) {
  93             &VERB(" $cmd->$_ => '$hash{$_}'.",2);
  94         }
  95
  96         ### HELP.
  97         if (exists $hash{'Help'} and !scalar(@args)) {
  98             &help( $hash{'Help'} );
  99             return 1;
 100         }
 101
 102         ### IDENTIFIER.
 103         if (exists $hash{'Identifier'}) {
 104             return 1 unless (&IsChanConfOrWarn($hash{'Identifier'}));
 105         }
 106
 107         ### USER FLAGS.
 108         if (exists $hash{'UserFlag'}) {
 109             return 1 unless (&hasFlag($hash{'UserFlag'}));
 110         }
 111
 112         ### FORKER,IDENTIFIER,CODEREF.
 113         if (($$ == $bot_pid) && exists $hash{'Forker'}) {
 114             if (exists $hash{'ArrayArgs'}) {
 115                 &Forker($hash{'Identifier'}, sub { \&{ $hash{'CODEREF'} }(@args) } );
 116             } else {
 117                 &Forker($hash{'Identifier'}, sub { \&{ $hash{'CODEREF'} }($flatarg) } );
 118             }
 119
 120         } else {
 121             if (exists $hash{'Module'}) {
 122                 &loadMyModule($hash{'Module'});
 123             }
 124
 125             # check if CODEREF exists.
 126             if (!defined &{ $hash{'CODEREF'} }) {
 127                 &WARN("coderef $hash{'CODEREF'} does not exist.");
 128                 if (defined $who) {
 129                     &msg($who, "coderef does not exist for $ident.");
 130                 }
 131
 132                 return 1;
 133             }
 134
 135             if (exists $hash{'ArrayArgs'}) {
 136                 &{ $hash{'CODEREF'} }(@args);
 137             } else {
 138                 &{ $hash{'CODEREF'} }($flatarg);
 139             }
 140         }
 141
 142         ### CMDSTATS.
 143         if (exists $hash{'Cmdstats'}) {
 144             $cmdstats{ $hash{'Cmdstats'} }++;
 145         }
 146
 147         &VERB('hooks: End of command.',2);
 148
 149         $done = 1;
 150     }
 151
 152     return 1 if ($done);
 153     return 0;
 154 }
 155
 156 sub Modules {
 157     if (!defined $message) {
 158         &WARN('Modules: message is undefined. should never happen.');
 159         return;
 160     }
 161
 162     my $debiancmd        = 'conflicts?|depends?|desc|file|(?:d)?info|provides?';
 163     $debiancmd          .= '|recommends?|suggests?|maint|maintainer';
 164
 165     if ($message =~ /^($debiancmd)(\s+(.*))?$/i) {
 166         return unless (&IsChanConfOrWarn('Debian'));
 167         my $package = lc $3;
 168
 169         if (defined $package) {
 170             &Forker('Debian', sub { &Debian::infoPackages($1, $package); } );
 171         } else {
 172             &help($1);
 173         }
 174
 175         return;
 176     }
 177
 178     # google searching. Simon++
 179     my $w3search_regex   = 'google';
 180     if ($message =~ /^(?:search\s+)?($w3search_regex)\s+(?:for\s+)?['"]?(.*?)["']?\s*\?*$/i) {
 181         return unless (&IsChanConfOrWarn('W3Search'));
 182
 183         &Forker('W3Search', sub { &W3Search::W3Search($1,$2); } );
 184
 185         $cmdstats{'W3Search'}++;
 186         return;
 187     }
 188
 189     # text counters. (eg: hehstats)
 190     my $itc;
 191     $itc = &getChanConf('ircTextCounters');
 192     $itc = &findChanConf('ircTextCounters') unless ($itc);
 193     return if ($itc && &do_text_counters($itc) == 1);
 194     # end of text counters.
 195
 196     # list{keys|values}. xk++. Idea taken from #linuxwarez@EFNET
 197     if ($message =~ /^list(\S+)(\s+(.*))?$/i) {
 198         return unless (&IsChanConfOrWarn('Search'));
 199
 200         my $thiscmd     = lc $1;
 201         my $args        = $3 || '';
 202
 203         $thiscmd        =~ s/^vals$/values/;
 204         return if ($thiscmd ne 'keys' && $thiscmd ne 'values');
 205
 206         # Usage:
 207         if (!defined $args or $args =~ /^\s*$/) {
 208             &help('list'. $thiscmd);
 209             return;
 210         }
 211
 212         # suggested by asuffield and \broken.
 213         if ($args =~ /^["']/ and $args =~ /["']$/) {
 214             &DEBUG('list*: removed quotes.');
 215             $args       =~ s/^["']|["']$//g;
 216         }
 217
 218         if (length $args < 2 && &IsFlag('o') ne 'o') {
 219             &msg($who, 'search string is too short.');
 220             return;
 221         }
 222
 223         &Forker('Search', sub { &Search::Search($thiscmd, $args); } );
 224
 225         $cmdstats{'Factoid Search'}++;
 226         return;
 227     }
 228
 229     # Topic management. xk++
 230     # may want to add a userflags for topic. -xk
 231     if ($message =~ /^topic(\s+(.*))?$/i) {
 232         return unless (&IsChanConfOrWarn('Topic'));
 233
 234         my $chan        = $talkchannel;
 235         my @args        = split / /, $2 || '';
 236
 237         if (!scalar @args) {
 238             &msg($who,"Try 'help topic'");
 239             return;
 240         }
 241
 242         $chan           = lc(shift @args) if ($msgType eq 'private');
 243         my $thiscmd     = shift @args;
 244
 245         # topic over public:
 246         if ($msgType eq 'public' && $thiscmd =~ /^#/) {
 247             &msg($who, 'error: channel argument is not required.');
 248             &msg($who, "\002Usage\002: topic <CMD>");
 249             return;
 250         }
 251
 252         # topic over private:
 253         if ($msgType eq 'private' && $chan !~ /^#/) {
 254             &msg($who, 'error: channel argument is required.');
 255             &msg($who, "\002Usage\002: topic #channel <CMD>");
 256             return;
 257         }
 258
 259         if (&validChan($chan) == 0) {
 260             &msg($who,"error: invalid channel \002$chan\002");
 261             return;
 262         }
 263
 264         # for semi-outsiders.
 265         if (!&IsNickInChan($who,$chan)) {
 266             &msg($who, "Failed. You ($who) are not in $chan, hey?");
 267             return;
 268         }
 269
 270         # now lets do it.
 271         &loadMyModule('Topic');
 272         &Topic($chan, $thiscmd, join(' ', @args));
 273         $cmdstats{'Topic'}++;
 274         return;
 275     }
 276
 277     # wingate.
 278     if ($message =~ /^wingate$/i) {
 279         return unless (&IsChanConfOrWarn('Wingate'));
 280
 281         my $reply = "Wingate statistics: scanned \002"
 282                         .scalar(keys %wingateToDo)."\002 hosts";
 283         my $queue = scalar(keys %wingateToDo);
 284         if ($queue) {
 285             $reply .= ".  I have \002$queue\002 hosts in the queue";
 286             $reply .= '.  Started the scan '.&Time2String(time() - $wingaterun).' ago';
 287         }
 288
 289         &performStrictReply("$reply.");
 290
 291         return;
 292     }
 293
 294     # do nothing and let the other routines have a go
 295     return 'CONTINUE';
 296 }
 297
 298 # Uptime. xk++
 299 sub uptime {
 300     my $count = 1;
 301     &msg($who, "- Uptime for $ident -");
 302     &msg($who, "Now: ". &Time2String(&uptimeNow()) ." running $bot_version");
 303
 304     foreach (&uptimeGetInfo()) {
 305         /^(\d+)\.\d+ (.*)/;
 306         my $time = &Time2String($1);
 307         my $info = $2;
 308
 309         &msg($who, "$count: $time $2");
 310         $count++;
 311     }
 312 }
 313
 314 # seen.
 315 sub seen {
 316     my($person) = lc shift;
 317     $person =~ s/\?*$//;
 318
 319     if (!defined $person or $person =~ /^$/) {
 320         &help('seen');
 321
 322         my $i = &countKeys('seen');
 323         &msg($who,'there '. &fixPlural('is',$i) ." \002$i\002 ".
 324                 'seen '. &fixPlural('entry',$i) .' that I know of.');
 325
 326         return;
 327     }
 328
 329     my @seen;
 330
 331     &seenFlush();       # very evil hack. oh well, better safe than sorry.
 332
 333     # TODO: convert to &sqlSelectRowHash();
 334     my $select = 'nick,time,channel,host,message';
 335     if ($person eq 'random') {
 336         @seen = &randKey('seen', $select);
 337     } else {
 338         @seen = &sqlSelect('seen', $select, { nick => $person } );
 339     }
 340
 341     if (scalar @seen < 2) {
 342         foreach (@seen) {
 343             &DEBUG("seen: _ => '$_'.");
 344         }
 345         &performReply("i haven't seen '$person'");
 346         return;
 347     }
 348
 349     # valid seen.
 350     my $reply;
 351     ### TODO: multi channel support. may require &IsNick() to return
 352     ### all channels or something.
 353
 354     my @chans = &getNickInChans($seen[0]);
 355     if (scalar @chans) {
 356         $reply = "$seen[0] is currently on";
 357
 358         foreach (@chans) {
 359             $reply .= ' '.$_;
 360             next unless (exists $userstats{lc $seen[0]}{'Join'});
 361             $reply .= ' ('.&Time2String(time() - $userstats{lc $seen[0]}{'Join'}).')';
 362         }
 363
 364         if (&IsChanConf('seenStats') > 0) {
 365             my $i;
 366             $i = $userstats{lc $seen[0]}{'Count'};
 367             $reply .= ". Has said a total of \002$i\002 messages" if (defined $i);
 368             $i = $userstats{lc $seen[0]}{'Time'};
 369             $reply .= '. Is idling for '.&Time2String(time() - $i) if (defined $i);
 370         }
 371         $reply .= ", last said\002:\002 '$seen[4]'.";
 372     } else {
 373         my $howlong = &Time2String(time() - $seen[1]);
 374         $reply = "$seen[0] <$seen[3]> was last seen on IRC ".
 375                  "in channel $seen[2], $howlong ago, ".
 376                  "saying\002:\002 '$seen[4]'.";
 377     }
 378
 379     &performStrictReply($reply);
 380     return;
 381 }
 382
 383 # User Information Services. requested by Flugh.
 384 sub userinfo {
 385     my ($arg) = join(' ',@_);
 386
 387     if ($arg =~ /^set(\s+(.*))?$/i) {
 388         $arg = $2;
 389         if (!defined $arg) {
 390             &help('userinfo set');
 391             return;
 392         }
 393
 394         &UserInfoSet(split /\s+/, $arg, 2);
 395     } elsif ($arg =~ /^unset(\s+(.*))?$/i) {
 396         $arg = $2;
 397         if (!defined $arg) {
 398             &help('userinfo unset');
 399             return;
 400         }
 401
 402         &UserInfoSet($arg, '');
 403     } else {
 404         &UserInfoGet($arg);
 405     }
 406 }
 407
 408 # cookie (random). xk++
 409 sub cookie {
 410     my ($arg) = @_;
 411
 412     # lets find that secret cookie.
 413     my $target          = ($msgType ne 'public') ? $who : $talkchannel;
 414     my $cookiemsg       = &getRandom(keys %{ $lang{'cookie'} });
 415     my ($key,$value);
 416
 417     ### WILL CHEW TONS OF MEM.
 418     ### TODO: convert this to a Forker function!
 419     if ($arg) {
 420         my @list = &searchTable('factoids', 'factoid_key', 'factoid_value', $arg);
 421         $key    = &getRandom(@list);
 422         $value  = &getFactInfo($key, 'factoid_value');
 423     } else {
 424         ($key,$value) = &randKey('factoids','factoid_key,factoid_value');
 425     }
 426
 427     for ($cookiemsg) {
 428         s/##KEY/\002$key\002/;
 429         s/##VALUE/$value/;
 430         s/##WHO/$who/;
 431         s/\$who/$who/;  # cheap fix.
 432         s/(\S+)?\s*<\S+>/$1 /;
 433         s/\s+/ /g;
 434     }
 435
 436     if ($cookiemsg =~ s/^ACTION //i) {
 437         &action($target, $cookiemsg);
 438     } else {
 439         &msg($target, $cookiemsg);
 440     }
 441 }
 442
 443 sub convert {
 444     my $arg = join(' ',@_);
 445     my ($from,$to) = ('','');
 446
 447     ($from,$to) = ($1,$2) if ($arg =~ /^(.*?) to (.*)$/i);
 448     ($from,$to) = ($2,$1) if ($arg =~ /^(.*?) from (.*)$/i);
 449
 450     if (!$to or !$from) {
 451         &msg($who, 'Invalid format!');
 452         &help('convert');
 453         return;
 454     }
 455
 456     &Units::convertUnits($from, $to);
 457
 458     return;
 459 }
 460
 461 sub lart {
 462     my ($target) = &fixString($_[0]);
 463     my $extra   = 0;
 464     my $chan    = $talkchannel;
 465     my ($for);
 466     my $mynick = $conn->nick();
 467
 468     if ($msgType eq 'private') {
 469         if ($target =~ /^($mask{chan})\s+(.*)$/) {
 470             $chan       = $1;
 471             $target     = $2;
 472             $extra      = 1;
 473         } else {
 474             &msg($who, 'error: invalid format or missing arguments.');
 475             &help('lart');
 476             return;
 477         }
 478     }
 479     if ($target =~ /^(.*)(\s+for\s+.*)$/) {
 480         $target = $1;
 481         $for    = $2;
 482     }
 483
 484     my $line = &getRandomLineFromFile($bot_data_dir. '/infobot.lart');
 485     if (defined $line) {
 486         if ($target =~ /^(me|you|itself|\Q$mynick\E)$/i) {
 487             $line =~ s/WHO/$who/g;
 488         } else {
 489             $line =~ s/WHO/$target/g;
 490         }
 491         $line .= $for if ($for);
 492         $line .= ", courtesy of $who" if ($extra);
 493
 494         &action($chan, $line);
 495     } else {
 496         &status('lart: error reading file?');
 497     }
 498 }
 499
 500 sub DebianNew {
 501     my $idx   = 'debian/Packages-sid.idx';
 502     my $error = 0;
 503     my %pkg;
 504     my @new;
 505
 506     $error++ unless ( -e $idx);
 507     $error++ unless ( -e "$idx-old");
 508
 509     if ($error) {
 510         $error = 'no sid/sid-old index file found.';
 511         &ERROR("Debian: $error");
 512         &msg($who, $error);
 513         return;
 514     }
 515
 516     open(IDX1, $idx);
 517     open(IDX2, "$idx-old");
 518
 519     while (<IDX2>) {
 520         chop;
 521         next if (/^\*/);
 522
 523         $pkg{$_} = 1;
 524     }
 525     close IDX2;
 526
 527     open(IDX1,$idx);
 528     while (<IDX1>) {
 529         chop;
 530         next if (/^\*/);
 531         next if (exists $pkg{$_});
 532
 533         push(@new, $_);
 534     }
 535     close IDX1;
 536
 537     &::performStrictReply( &::formListReply(0, 'New debian packages:', @new) );
 538 }
 539
 540 sub do_verstats {
 541     my ($chan)  = @_;
 542
 543     if (!defined $chan) {
 544         &help('verstats');
 545         return;
 546     }
 547
 548     if (!&validChan($chan)) {
 549         &msg($who, "chan $chan is invalid.");
 550         return;
 551     }
 552
 553     if (scalar @vernick > scalar(keys %{ $channels{lc $chan}{''} })/4) {
 554         &msg($who, 'verstats already in progress for someone else.');
 555         return;
 556     }
 557
 558     &msg($who, "Sending CTCP VERSION to $chan; results in 60s.");
 559     $conn->ctcp('VERSION', $chan);
 560     $cache{verstats}{chan}      = $chan;
 561     $cache{verstats}{who}       = $who;
 562     $cache{verstats}{msgType}   = $msgType;
 563
 564     $conn->schedule(30, sub {
 565         my $c           = lc $cache{verstats}{chan};
 566         @vernicktodo    = ();
 567
 568         foreach (keys %{ $channels{$c}{''} } ) {
 569             next if (grep /^\Q$_\E$/i, @vernick);
 570             push(@vernicktodo, $_);
 571         }
 572
 573         &verstats_flush();
 574     } );
 575
 576     $conn->schedule(60, sub {
 577         my $vtotal      = 0;
 578         my $c           = lc $cache{verstats}{chan};
 579         my $total       = keys %{ $channels{$c}{''} };
 580         $chan           = $c;
 581         $who            = $cache{verstats}{who};
 582         $msgType        = $cache{verstats}{msgType};
 583         delete $cache{verstats};        # sufficient?
 584
 585         foreach (keys %ver) {
 586             $vtotal     += scalar keys %{ $ver{$_} };
 587         }
 588
 589         my %sorted;
 590         my $unknown     = $total - $vtotal;
 591         my $perc        = sprintf("%.1f", $unknown * 100 / $total);
 592         $perc           =~ s/.0$//;
 593         $sorted{$perc}{'unknown/cloak'} = "$unknown ($perc%)" if ($unknown);
 594
 595         foreach (keys %ver) {
 596             my $count   = scalar keys %{ $ver{$_} };
 597             $perc       = sprintf("%.01f", $count * 100 / $total);
 598             $perc       =~ s/.0$//;     # lame compression.
 599
 600             $sorted{$perc}{$_} = "$count ($perc%)";
 601         }
 602
 603         ### can be compressed to a map?
 604         my @list;
 605         foreach ( sort { $b <=> $a } keys %sorted ) {
 606             my $perc = $_;
 607             foreach (sort keys %{ $sorted{$perc} }) {
 608                 push(@list, "$_ - $sorted{$perc}{$_}");
 609             }
 610         }
 611
 612         # hack. this is one major downside to scheduling.
 613         $chan = $c;
 614         &performStrictReply( &formListReply(0, "IRC Client versions for $c ", @list) );
 615
 616         # clean up not-needed data structures.
 617         undef %ver;
 618         undef @vernick;
 619     } );
 620
 621     return;
 622 }
 623
 624 sub verstats_flush {
 625     for (1..5) {
 626         last unless (scalar @vernicktodo);
 627
 628         my $n = shift(@vernicktodo);
 629         $conn->ctcp('VERSION', $n);
 630     }
 631
 632     return unless (scalar @vernicktodo);
 633
 634     $conn->schedule(3, \&verstats_flush() );
 635 }
 636
 637 sub do_text_counters {
 638     my ($itc) = @_;
 639     $itc =~ s/([^\w\s])/\\$1/g;
 640     my $z = join '|', split ' ', $itc;
 641
 642     if ($msgType eq 'privmsg' and $message =~ / ($mask{chan})$/) {
 643         &DEBUG("ircTC: privmsg detected; chan = $1");
 644         $chan = $1;
 645     }
 646
 647     if ($message =~ /^_stats(\s+(\S+))$/i) {
 648         &textstats_main($2);
 649         return 1;
 650     }
 651
 652     my ($type,$arg);
 653     if ($message =~ /^($z)stats(\s+(\S+))?$/i) {
 654         $type = $1;
 655         $arg  = $3;
 656     } else {
 657         return 0;
 658     }
 659
 660     # even more uglier with channel/time arguments.
 661     my $c       = $chan;
 662 #   my $c       = $chan || 'PRIVATE';
 663     my $where   = 'type='.&sqlQuote($type);
 664     if (defined $c) {
 665         &DEBUG("c => $c");
 666         $where  .= ' AND channel='.&sqlQuote($c) if (defined $c);
 667     } else {
 668         &DEBUG('not using chan arg');
 669     }
 670
 671     my $sum = (&sqlRawReturn('SELECT SUM(counter) FROM stats'
 672                         .' WHERE '.$where ))[0];
 673
 674     if (!defined $arg or $arg =~ /^\s*$/) {
 675         # this is way ugly.
 676
 677         # TODO: convert $where to hash
 678         my %hash = &sqlSelectColHash('stats', 'nick,counter',
 679                         { },
 680                         $where.' ORDER BY counter DESC LIMIT 3', 1
 681         );
 682         my $i;
 683         my @top;
 684
 685         # unfortunately we have to sort it again!
 686         my $tp = 0;
 687         foreach $i (sort { $b <=> $a } keys %hash) {
 688             foreach (keys %{ $hash{$i} }) {
 689                 my $p   = sprintf("%.01f", 100*$i/$sum);
 690                 $tp     += $p;
 691                 push(@top, "\002$_\002 -- $i ($p%)");
 692             }
 693         }
 694         my $topstr = '';
 695         if (scalar @top) {
 696             $topstr = '.  Top '.scalar(@top).': '.join(', ', @top);
 697         }
 698
 699         if (defined $sum) {
 700             &performStrictReply("total count of \037$type\037 on \002$c\002: $sum$topstr");
 701         } else {
 702             &performStrictReply("zero counter for \037$type\037.");
 703         }
 704     } else {
 705         # TODO: convert $where to hash and use a sqlSelect
 706         my $x = (&sqlRawReturn('SELECT SUM(counter) FROM stats'.
 707                         " WHERE $where AND nick=".&sqlQuote($arg) ))[0];
 708
 709         if (!defined $x) {      # !defined.
 710             &performStrictReply("$arg has not said $type yet.");
 711             return 1;
 712         }
 713
 714         # defined.
 715         # TODO: convert $where to hash
 716         my @array = &sqlSelect('stats', 'nick', undef,
 717                         $where.' ORDER BY counter', 1
 718         );
 719         my $good = 0;
 720         my $i = 0;
 721         for ($i=0; $i<scalar @array; $i++) {
 722             next unless ($array[0] =~ /^\Q$who\E$/);
 723             $good++;
 724             last;
 725         }
 726         $i++;
 727
 728         my $total = scalar(@array);
 729         my $xtra = '';
 730         if ($total and $good) {
 731             my $pct = sprintf("%.01f", 100*(1+$total-$i)/$total);
 732             $xtra = ", ranked $i\002/\002$total (percentile: \002$pct\002 %)";
 733         }
 734
 735         my $pct1 = sprintf("%.01f", 100*$x/$sum);
 736         &performStrictReply("\002$arg\002 has said \037$type\037 \002$x\002 times (\002$pct1\002 %)$xtra");
 737     }
 738
 739     return 1;
 740 }
 741
 742 sub textstats_main {
 743     my($arg) = @_;
 744
 745     # even more uglier with channel/time arguments.
 746     my $c       = $chan;
 747 #    my $c      = $chan || 'PRIVATE';
 748     &DEBUG('not using chan arg') if (!defined $c);
 749
 750     # example of converting from RawReturn to sqlSelect.
 751     my $where_href = (defined $c) ? { channel => $c } : '';
 752     my $sum = &sqlSelect('stats', 'SUM(counter)', $where_href);
 753
 754     if (!defined $arg or $arg =~ /^\s*$/) {
 755         # this is way ugly.
 756         &DEBUG('_stats: !arg');
 757
 758         my %hash = &sqlSelectColHash('stats', 'nick,counter',
 759                 $where_href,
 760                 ' ORDER BY counter DESC LIMIT 3', 1
 761         );
 762         my $i;
 763         my @top;
 764
 765         # unfortunately we have to sort it again!
 766         my $tp = 0;
 767         foreach $i (sort { $b <=> $a } keys %hash) {
 768             foreach (keys %{ $hash{$i} }) {
 769                 my $p   = sprintf("%.01f", 100*$i/$sum);
 770                 $tp     += $p;
 771                 push(@top, "\002$_\002 -- $i ($p%)");
 772             }
 773         }
 774
 775         my $topstr = '';
 776         if (scalar @top) {
 777             $topstr = '.  Top '.scalar(@top).': '.join(', ', @top);
 778         }
 779
 780         if (defined $sum) {
 781             &performStrictReply("total count of \037$type\037 on \002$c\002: $sum$topstr");
 782         } else {
 783             &performStrictReply("zero counter for \037$type\037.");
 784         }
 785
 786         return;
 787     }
 788
 789     # TODO: add nick to where_href
 790     my %hash = &sqlSelectColHash('stats', 'type,counter',
 791                 $where_href, ' AND nick='.&sqlQuote($arg)
 792     );
 793
 794     # this is totally messed up... needs to be fixed... and cleaned up.
 795     my $total;
 796     my $good;
 797     my $ii;
 798     my $x;
 799
 800     foreach (keys %hash) {
 801         &DEBUG("_stats: hash{$_} => $hash{$_}");
 802         # ranking.
 803         # TODO: convert $where to hash
 804         my $where = '';
 805         my @array = &sqlSelect('stats', 'nick', undef, $where.' ORDER BY counter', 1);
 806         $good = 0;
 807         $ii = 0;
 808         for(my $i=0; $i<scalar @array; $i++) {
 809             next unless ($array[0] =~ /^\Q$who\E$/);
 810             $good++;
 811             last;
 812         }
 813         $ii++;
 814
 815         $total = scalar(@array);
 816         &DEBUG("   i => $i, good => $good, total => $total");
 817         $x .= ' '.$total.'blah blah';
 818     }
 819
 820 #    return;
 821
 822     if (!defined $x) {  # !defined.
 823         &performStrictReply("$arg has not said $type yet.");
 824         return;
 825     }
 826
 827     my $xtra = '';
 828     if ($total and $good) {
 829         my $pct = sprintf("%.01f", 100*(1+$total-$ii)/$total);
 830         $xtra = ", ranked $ii\002/\002$total (percentile: \002$pct\002 %)";
 831     }
 832
 833     my $pct1 = sprintf("%.01f", 100*$x/$sum);
 834     &performStrictReply("\002$arg\002 has said \037$type\037 \002$x\002 times (\002$pct1\002 %)$xtra");
 835 }
 836
 837 sub nullski {
 838     my ($arg) = @_;
 839     return unless (defined $arg);
 840     # big security hole
 841     #foreach (`$arg`) { &msg($who,$_); }
 842 }
 843
 844 %cmdhooks=();
 845 ###
 846 ### START ADDING HOOKS.
 847 ###
 848 &addCmdHook('(babel(fish)?|x|xlate|translate)', ('CODEREF' => 'babelfish::babelfish', 'Identifier' => 'babelfish', 'Cmdstats' => 'babelfish', 'Forker' => 1, 'Help' => 'babelfish', 'Module' => 'babelfish') );
 849 &addCmdHook('(botmail|message)', ('CODEREF' => 'botmail::parse', 'Identifier' => 'botmail', 'Cmdstats' => 'botmail') );
 850 &addCmdHook('bzflist17', ('CODEREF' => 'BZFlag::list17', 'Identifier' => 'BZFlag', 'Cmdstats' => 'BZFlag', 'Forker' => 1, 'Module' => 'BZFlag') );
 851 &addCmdHook('bzflist', ('CODEREF' => 'BZFlag::list', 'Identifier' => 'BZFlag', 'Cmdstats' => 'BZFlag', 'Forker' => 1, 'Module' => 'BZFlag') );
 852 &addCmdHook('bzfquery', ('CODEREF' => 'BZFlag::query', 'Identifier' => 'BZFlag', 'Cmdstats' => 'BZFlag', 'Forker' => 1, 'Module' => 'BZFlag') );
 853 &addCmdHook('chan(stats|info)', ('CODEREF' => 'chaninfo', ) );
 854 &addCmdHook('cmd(stats|info)', ('CODEREF' => 'cmdstats', ) );
 855 &addCmdHook('convert', ('CODEREF' => 'convert', 'Forker' => 1, 'Identifier' => 'Units', 'Help' => 'convert') );
 856 &addCmdHook('(cookie|random)', ('CODEREF' => 'cookie', 'Forker' => 1, 'Identifier' => 'Factoids') );
 857 &addCmdHook('countdown', ('CODEREF' => 'countdown', 'Module' => 'countdown', 'Identifier' => 'countdown', 'Cmdstats' => 'countdown') );
 858 &addCmdHook('countrystats', ('CODEREF' => 'countryStats') );
 859 &addCmdHook('dauthor', ('CODEREF' => 'Debian::searchAuthor', 'Forker' => 1, 'Identifier' => 'Debian', 'Cmdstats' => 'Debian Author Search', 'Help' => 'dauthor' ) );
 860 &addCmdHook('d?bugs', ('CODEREF' => 'DebianExtra::Parse', 'Forker' => 1, 'Identifier' => 'DebianExtra', 'Cmdstats' => 'Debian Bugs') );
 861 &addCmdHook('d?contents', ('CODEREF' => 'Debian::searchContents', 'Forker' => 1, 'Identifier' => 'Debian', 'Cmdstats' => 'Debian Contents Search', 'Help' => 'contents' ) );
 862 &addCmdHook('d?find', ('CODEREF' => 'Debian::DebianFind', 'Forker' => 1, 'Identifier' => 'Debian', 'Cmdstats' => 'Debian Search', 'Help' => 'find' ) );
 863 &addCmdHook('dice', ('CODEREF' => 'dice::dice', 'Identifier' => 'dice', 'Cmdstats' => 'dice', 'Forker' => 1, 'Module' => 'dice') );
 864 &addCmdHook('Dict', ('CODEREF' => 'Dict::Dict', 'Identifier' => 'Dict', 'Help' => 'dict', 'Forker' => 1, 'Cmdstats' => 'Dict') );
 865 &addCmdHook('dincoming', ('CODEREF' => 'Debian::generateIncoming', 'Forker' => 1, 'Identifier' => 'Debian' ) );
 866 &addCmdHook('dnew', ('CODEREF' => 'DebianNew', 'Identifier' => 'Debian' ) );
 867 &addCmdHook('dns|d?nslookup', ('CODEREF' => 'dns::query', 'Identifier' => 'dns', 'Cmdstats' => 'dns', 'Forker' => 1, 'Help' => 'dns') );
 868 &addCmdHook('(d|search)desc', ('CODEREF' => 'Debian::searchDescFE', 'Forker' => 1, 'Identifier' => 'Debian', 'Cmdstats' => 'Debian Desc Search', 'Help' => 'ddesc' ) );
 869 &addCmdHook('dstats', ('CODEREF' => 'Debian::infoStats', 'Forker' => 1, 'Identifier' => 'Debian', 'Cmdstats' => 'Debian Statistics' ) );
 870 &addCmdHook('(ex)?change', ('CODEREF' => 'Exchange::query', 'Identifier' => 'Exchange', 'Cmdstats' => 'Exchange', 'Forker' => 1) );
 871 &addCmdHook('factinfo', ('CODEREF' => 'factinfo', 'Cmdstats' => 'Factoid Info', Module => 'Factoids', ) );
 872 &addCmdHook('factstats?', ('CODEREF' => 'factstats', 'Cmdstats' => 'Factoid Stats', Help => 'factstats', Forker => 1, 'Identifier' => 'Factoids', ) );
 873 &addCmdHook('help', ('CODEREF' => 'help', 'Cmdstats' => 'Help', ) );
 874 &addCmdHook('HTTPDtype', ('CODEREF' => 'HTTPDtype::HTTPDtype', 'Identifier' => 'HTTPDtype', 'Cmdstats' => 'HTTPDtype', 'Forker' => 1) );
 875 &addCmdHook('[ia]?spell', ('CODEREF' => 'spell::query', 'Identifier' => 'spell', 'Cmdstats' => 'spell', 'Forker' => 1, 'Help' => 'spell') );
 876 &addCmdHook('insult', ('CODEREF' => 'Insult::Insult', 'Forker' => 1, 'Identifier' => 'insult', 'Help' => 'insult' ) );
 877 &addCmdHook('karma', ('CODEREF' => 'karma', ) );
 878 &addCmdHook('kernel', ('CODEREF' => 'Kernel::Kernel', 'Forker' => 1, 'Identifier' => 'Kernel', 'Cmdstats' => 'Kernel', 'NoArgs' => 1) );
 879 &addCmdHook('lart', ('CODEREF' => 'lart', 'Identifier' => 'lart', 'Help' => 'lart') );
 880 &addCmdHook('lc', ('CODEREF' => 'case::lower', 'Identifier' => 'case', 'Cmdstats' => 'case', 'Forker' => 1, 'Module' => 'case') );
 881 &addCmdHook('listauth', ('CODEREF' => 'CmdListAuth', 'Identifier' => 'Search', Module => 'Factoids', 'Help' => 'listauth') );
 882 &addCmdHook('md5(sum)?', ('CODEREF' => 'md5::md5', 'Identifier' => 'md5', 'Cmdstats' => 'md5', 'Forker' => 1, 'Module' => 'md5') );
 883 &addCmdHook('metar', ('CODEREF' => 'Weather::Metar', 'Identifier' => 'Weather', 'Help' => 'weather', 'Cmdstats' => 'Weather', 'Forker' => 1) );
 884 &addCmdHook('News', ('CODEREF' => 'News::Parse', Module => 'News', 'Cmdstats' => 'News', 'Identifier' => 'News' ) );
 885 &addCmdHook('(?:nick|lame)ometer(?: for)?', ('CODEREF' => 'nickometer::query', 'Identifier' => 'nickometer', 'Cmdstats' => 'nickometer', 'Forker' => 1) );
 886 &addCmdHook('nullski', ('CODEREF' => 'nullski', ) );
 887 &addCmdHook('page', ('CODEREF' => 'pager::page', 'Identifier' => 'pager', 'Cmdstats' => 'pager', 'Forker' => 1, 'Help' => 'page') );
 888 &addCmdHook('piglatin', ('CODEREF' => 'piglatin::piglatin', 'Identifier' => 'piglatin', 'Cmdstats' => 'piglatin', 'Forker' => 1) );
 889 &addCmdHook('Plug', ('CODEREF' => 'Plug::Plug', 'Identifier' => 'Plug', 'Forker' => 1, 'Cmdstats' => 'Plug') );
 890 &addCmdHook('quote', ('CODEREF' => 'Quote::Quote', 'Forker' => 1, 'Identifier' => 'Quote', 'Help' => 'quote', 'Cmdstats' => 'Quote') );
 891 &addCmdHook('reverse', ('CODEREF' => 'reverse::reverse', 'Identifier' => 'reverse', 'Cmdstats' => 'reverse', 'Forker' => 1, 'Module' => 'reverse') );
 892 &addCmdHook('RootWarn', ('CODEREF' => 'CmdrootWarn', 'Identifier' => 'RootWarn', 'Module' => 'RootWarn') );
 893 &addCmdHook('OnJoin', ('CODEREF' => 'Cmdonjoin', 'Identifier' => 'OnJoin', 'Module' => 'OnJoin') );
 894 &addCmdHook('Rss', ('CODEREF' => 'Rss::Rss', 'Identifier' => 'Rss', 'Cmdstats' => 'Rss', 'Forker' => 1, 'Help' => 'rss') );
 895 &addCmdHook('sched(stats|info)', ('CODEREF' => 'scheduleList', ) );
 896 &addCmdHook('scramble', ('CODEREF' => 'scramble::scramble', 'Identifier' => 'scramble', 'Cmdstats' => 'scramble', 'Forker' => 1, 'Module' => 'scramble') );
 897 &addCmdHook('seen', ('CODEREF' => 'seen', 'Identifier' => 'seen') );
 898 &addCmdHook('slashdot', ('CODEREF' => 'Slashdot::Slashdot', 'Identifier' => 'slashdot', 'Forker' => 1, 'Cmdstats' => 'slashdot') );
 899 &addCmdHook('tell|explain', ('CODEREF' => 'tell', Help => 'tell', Identifier => 'allowTelling', Cmdstats => 'Tell') );
 900 &addCmdHook('uc', ('CODEREF' => 'case::upper', 'Identifier' => 'case', 'Cmdstats' => 'case', 'Forker' => 1, 'Module' => 'case') );
 901 &addCmdHook('Uptime', ('CODEREF' => 'uptime', 'Identifier' => 'Uptime', 'Cmdstats' => 'Uptime') );
 902 &addCmdHook('u(ser)?info', ('CODEREF' => 'userinfo', 'Identifier' => 'UserInfo', 'Help' => 'userinfo', 'Module' => 'UserInfo') );
 903 &addCmdHook('verstats', ('CODEREF' => 'do_verstats' ) );
 904 &addCmdHook('Weather', ('CODEREF' => 'Weather::Weather', 'Identifier' => 'Weather', 'Help' => 'weather', 'Cmdstats' => 'Weather', 'Forker' => 1, 'Module' => 'Weather') );
 905 &addCmdHook('wiki(pedia)?', ('CODEREF' => 'wikipedia::wikipedia', 'Identifier' => 'wikipedia', 'Cmdstats' => 'wikipedia', 'Forker' => 1, 'Help' => 'wikipedia', 'Module' => 'wikipedia') );
 906 &addCmdHook('wtf', ('CODEREF' => 'wtf::query', 'Identifier' => 'wtf', 'Cmdstats' => 'wtf', 'Forker' => 1, 'Help' => 'wtf', 'Module' => 'wtf') );
 907 &addCmdHook('zfi', ('CODEREF' => 'zfi::query', 'Identifier' => 'zfi', 'Cmdstats' => 'zfi', 'Forker' => 1, 'Module' => 'zfi') );
 908 &addCmdHook('(zippy|yow)', ('CODEREF' => 'zippy::get', 'Identifier' => 'Zippy', 'Cmdstats' => 'Zippy', 'Forker' => 1, 'Module' => 'Zippy') );
 909 &addCmdHook('zsi', ('CODEREF' => 'zsi::query', 'Identifier' => 'zsi', 'Cmdstats' => 'zsi', 'Forker' => 1, 'Module' => 'zsi') );
 910 ###
 911 ### END OF ADDING HOOKS.
 912 ###
 913
 914 &status('loaded '.scalar(keys %cmdhooks).' command hooks.');
 915
 916 1;