History

Valentin Lorentz 63eb6672ea Revert generic 'The Limnoria Contributors' in copyright notices This commit reverts `db7ef3f025` (though it keeps the year updates) After discussion with several people, it seems better to mention copyright owners explicitly. eg. https://reuse.software/faq/#vcs-copyright explains the issue of using VCSs to track copyright. As `db7ef3f025` only replaced mentions of my name with 'The Limnoria Contributors', this commit only needs to undo that + add one person who contributed to setup.py.		2021-10-17 09:57:55 +02:00
..
locales	Fix msgfmt warnings.	2020-03-26 22:10:28 +01:00
README.rst	all plugins: regenerate READMEs	2021-04-22 00:29:15 +02:00
__init__.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00
config.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00
messages.pot	Squashed commit of the following:	2014-12-20 14:37:27 +01:00
plugin.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00
test.py	Revert generic 'The Limnoria Contributors' in copyright notices	2021-10-17 09:57:55 +02:00

README.rst

Documentation for the QuoteGrabs plugin for Supybot

Purpose

Quotegrabs are like IRC sound bites. When someone says something funny, incriminating, stupid, outrageous, ... anything that might be worth remembering, you can grab that quote for that person. With this plugin, you can store many quotes per person and display their most recent quote, as well as see who "grabbed" the quote in the first place.

Usage

Stores and displays quotes from channels. Quotes are stored randomly and/or on user request.

Commands

get [<channel>] <id>: Return the quotegrab with the given <id>. <channel> is only necessary if the message isn't sent in the channel itself.

grab [<channel>] <nick>: Grabs a quote from <channel> by <nick> for the quotegrabs table. <channel> is only necessary if the message isn't sent in the channel itself.

list [<channel>] <nick>: Returns a list of shortened quotes that have been grabbed for <nick> as well as the id of each quote. These ids can be used to get the full quote. <channel> is only necessary if the message isn't sent in the channel itself.

quote [<channel>] <nick>: Returns <nick>'s latest quote grab in <channel>. <channel> is only necessary if the message isn't sent in the channel itself.

random [<channel>] [<nick>]: Returns a randomly grabbed quote, optionally choosing only from those quotes grabbed for <nick>. <channel> is only necessary if the message isn't sent in the channel itself.

say [<channel>] <id>: Return the quotegrab with the given <id>. <channel> is only necessary if the message isn't sent in the channel itself.

search [<channel>] <text>: Searches for <text> in a quote. <channel> is only necessary if the message isn't sent in the channel itself.

ungrab [<channel>] <number>: Removes the grab <number> (the last by default) on <channel>. <channel> is only necessary if the message isn't sent in the channel itself.

Configuration

supybot.plugins.QuoteGrabs.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.QuoteGrabs.randomGrabber

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

Determines whether the bot will randomly grab possibly-suitable quotes on occasion. The suitability of a given message is determined by ...

supybot.plugins.QuoteGrabs.randomGrabber.averageTimeBetweenGrabs

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

Determines about how many seconds, on average, should elapse between random grabs. This is only an average value; grabs can happen from any time after half this time until never, although that's unlikely to occur.

supybot.plugins.QuoteGrabs.randomGrabber.minimumCharacters

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

Determines the minimum number of characters in a message for it to be considered for random grabbing.

supybot.plugins.QuoteGrabs.randomGrabber.minimumWords

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

Determines the minimum number of words in a message for it to be considered for random grabbing.