Lethargy

From Katapult

Contents 1 Using Lethargy 1.1 Advanced Factoid Manipulation 1.1.1 <reply> 1.1.2 also 1.1.3 <alias> 1.1.4 <sed> 1.2 Looking for Factoids

Using Lethargy

Lethargy is a (somewhat) intelligent IRC bot. The idea behind Lethargy is that it remembers answers to commonly asked questions and that users can easily recall them when needed.

Using Lethargy is simple, to ask Lethargy to recall an answer, simply type in #ubuntu/#kubuntu:

!<factoid>

Replace <factoid> with the actual factoid you want to recall. If Lethargy doesn't currently have the factoid, it will reply by telling you it doesn't know it.

Another way to use Lethargy is to ask Lethargy to tell someone else about a factoid. You can accomplish this by typing:

!tell <nick> about <factoid>
!<factoid> > <nick>

Just replace <nick> with the nickname of the person you wish to tell about <factoid>. Replace <factoid> with the factoid you wish to use. Replace nick with me to make it send the factoid to yourself in a private message

To make Lethargy reply in the channel, but prefix something to the factoid, replace {{{>}}} with

!<factoid> | <nick>
Lethargy: <factoid> | <nick>

You can also add new factoids to Lethargy:

!<factoid> is <fact>

or, if an incorrect factoid has been added, make Lethargy replace it with new information:

!no, <factoid> is <fact>

Replace <factoid> with the name of the new factoid and <fact> with the information for that factoid. One thing to keep in mind when creating new factoids is that they should point to official Ubuntu documentation where possible.

Due to the high volume of abuse/crap people added to the bot, adding factoids is currently limited to registered people who have been granted access. Attempts to edit the bot by unauthorized users will be forwarded to #katapult-bot for review so they can be added anyway. To register:

/msg Lethargy register <nickname> <password>

Each time the bot crashes, you will need to re-identify

/msg Lethargy identify <nickname> <password>

Advanced Factoid Manipulation

<reply>

Lethargys default response to !foo is "foo is bar". To suppress the "foo is", start the factoid with <reply>. Example:

<Mez> !foo is <reply> bar
<Mez> !foo
<Lethargy> bar

also

!foo is foo
!foo is also bar

This will make Lethargy say:

<Lethargy> foo is foo
<Lethargy> bar

Mainy used for factoids that are partially LTR and partially RTL text.

<alias>

Several facts have multiple factoids pointing to them via aliases. To add an alias, you use the <alias> keyword in your fact. Example:

<Mez> !foo is bar
<Mez> !bar is <alias> foo
<Mez> !bar
<Lethargy> foo is bar

To display alias information, use !-<factoid>. This will either display which factoid <factoid> is an alias of, or it will list all aliases of <factoid>, whichever is appropriate.

<sed>

Lethargy can edit its factoids using sed-like expressions. If you made a typo and do not want to erase and replace the entire factoid, you can edit factoids contents:

!<factoid> =~ /<regex>/<replacement>/
!<factoid> is <sed> /<regex>/<replacement>/

The <sed>/=~ construct understands regular expressions (PCRE) for advanced editing.

Looking for Factoids

If you are looking for a specific factoid, but cannot remember which one, you can search the factoid database by factoid name or fact:

!search <string>

You can use * as wildcard.