NAME

       Bot::BasicBot::Pluggable::Module::Infobot - infobot clone redone in B::B::P.

VERSION

       version 0.98

SYNOPSIS

       Does infobot things - basically remembers and returns factoids. Will ask another infobot
       about factoids that it doesn't know about, if you want. Due to persistent heckling from
       the peanut gallery, does things pretty much exactly like the classic infobot, even when
       they're not necessarily that useful (for example, saying "Okay." rather than "OK, water is
       wet."). Further infobot backwards compatibility is available through additional packages
       such as Bot::BasicBot::Pluggable::Module::Foldoc.

IRC USAGE

       The following examples assume you're running Infobot with its defaults settings, which
       require the bot to be addressed before learning factoids or answering queries. Modify
       these settings with the Vars below.

         <user> bot: water is wet.
          <bot> user: okay.
         <user> bot: water?
          <bot> user: water is wet.
         <user> bot: water is also blue.
          <bot> user: okay.
         <user> bot: water?
          <bot> user: water is wet or blue.
         <user> bot: no, water is translucent.
          <bot> user: okay.
         <user> bot: water?
          <bot> user: water is translucent.
         <user> bot: forget water.
          <bot> user: I forgot about water.
         <user> bot: water?
          <bot> user: No clue. Sorry.

       A fact that begins with "<reply>" will have the "<noun> is" stripped:

         <user> bot: what happen is <reply>somebody set us up the bomb.
          <bot> user: okay.
         <user> bot: what happen?
          <bot> user: somebody set us up the bomb.

       A fact that begins "<action>" will be emoted as a response:

         <user> bot: be funny is <action>dances silly.
          <bot> user: okay.
         <user> bot: be funny?
           * bot dances silly.

       Pipes ("|") indicate different possible answers, picked at random:

         <user> bot: dice is one|two|three|four|five|six
          <bot> user: okay.
         <user> bot: dice?
          <bot> user: two.
         <user> bot: dice?
          <bot> user: four.

       You can also use RSS feeds as a response:

         <user> bot: jerakeen.org is <rss="http://jerakeen.org/rss">.
          <bot> user: okay.
         <user> bot: jerakeen.org?
          <bot> user: jerakeen.org is <item>; <item>; etc....

       You can also ask the bot to learn a factoid from another bot, as follows:

         <user> bot: ask bot2 about fact.
          <bot> user: asking bot2 about fact...
         <user> bot: fact?
          <bot> user: fact is very boring.

       Finally, you can privmsg the bot to search for particular facts:

         <user> search for options.
          <bot> I know about 'options indexes', 'charsetoptions override', etc....

METHODS

VARS

       min_length
           Defaults to 3; the minimum length a factoid, or inquiry, must be before recognizing
           it.

       max_length
           Defaults to 25; the maximum length a factoid, or inquiry, can be before ignoring it.

       num_results
           Defaults to 20; the number of facts to return for "search for <term>" privmsg.

       passive_answer
           Defaults to 0; when enabled, the bot will answer factoids without being addressed.

       passive_learn
           Defaults to 0; when enabled, the bot will learn factoids without being addressed.

       require_question
           Defaults to 1; determines whether the bot requires a question mark before responding
           to a factoid. When enabled, the question mark is required (ie. "water?").  When
           disabled, the question mark is entirely optional (ie. "water" would also produce a
           response).

       stopwords
           A comma-, space-, or pipe- separated list of words the bot should not learn or answer.
           This prevents such insanity as the learning of "where is the store?" and "how is your
           mother?" The default list of stopwords contains "here", "how", "it", "something",
           "that", "this", "what", "when", "where", "which", "who" and "why").

       unknown_responses
           A pipe-separated list of responses the bot will randomly choose from when it doesn't
           know the answer to a question. The default list of response contains "Dunno.", "I give
           up.", "I have no idea.", "No clue. Sorry.", "Search me, bub.", and "Sorry, I don't
           know."

       allow_searching
           Defaults to 0.

           Searching on large factoid lists is ... problematic.

       http_timeout
           Time in seconds for an http request to timeout. When this value is set to a very high
           value, a slow site can disconnect a bot by blocking it. Defaults to 10.

       rss_items
           Maximal numbers of items returns when using RSS feeds. Defaults to 5.

BUGS

       "is also" doesn't work on <reply>s (ie. "<bot> cheetahs! or <reply>monkies.")

       "is also" doesn't work on <action>s (same as the previous bug, hobo.)

       The pipe syntax for random replies doesn't actually work. At all. Um.

       We should probably make a "choose_random_response" function.

       "<bot>?" fails, due to removal of <bot> name from $mess->body.

       "ask" syntax doesn't work in a private message.

       The tab stops are set to 2, not 4. OHMYGOD.

       If a "search" fails, the bot doesn't tell you.

       "search" is case-sensitive.

       If Title module is loaded, <rss> factoids don't work cos of told/fallback.

REQUIREMENTS

       URI

       LWP::Simple

       XML::Feed

AUTHOR

       Mario Domgoergen <mdom@cpan.org>

       This program is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

perl v5.20.2                                2015-06Bot::BasicBot::Pluggable::Module::Infobot(3pm)