Limnoria/plugins/Lart/README.rst

2.3 KiB

Documentation for the Lart plugin for Supybot

Purpose

This plugin keeps a database of larts (Luser Attitude Readjustment Tool), and larts with it.

Usage

Provides an implementation of the Luser Attitude Readjustment Tool for users.

Example:

  • If you add slaps $who.
  • And Someone says @lart ChanServ.
  • * bot slaps ChanServ.

Commands

add [<channel>] <text>

Adds <text> to the lart database for <channel>. <channel> is only necessary if the message isn't sent in the channel itself.

change [<channel>] <id> <regexp>

Changes the lart with id <id> according to the regular expression <regexp>. <channel> is only necessary if the message isn't sent in the channel itself.

get [<channel>] <id>

Gets the lart with id <id> from the lart database for <channel>. <channel> is only necessary if the message isn't sent in the channel itself.

lart [<channel>] [<id>] <whowhat> (for <reason>, if given). If <id> is given, uses that specific lart. <channel> is only necessary if the message isn't sent in the channel itself.

remove [<channel>] <id>

Removes the lart with id <id> from the lart database for <channel>. <channel> is only necessary if the message isn't sent in the channel itself.

stats [<channel>]

Returns the number of larts in the database for <channel>. <channel> is only necessary if the message isn't sent in the channel itself.

Configuration

supybot.plugins.Lart.public

This config variable defaults to "True", is not network-specific, and is not channel-specific.

Determines whether this plugin is publicly visible.

supybot.plugins.Lart.showIds

This config variable defaults to "False", is network-specific, and is channel-specific.

Determines whether the bot will show the ids of a lart when the lart is given.