Limnoria/plugins/Aka
2014-05-07 21:24:18 +03:00
..
local Aka: First commit. 2013-07-23 21:02:06 +02:00
locales Aka: fix first comment in l10n-fi. 2014-03-22 13:19:01 +02:00
__init__.py Aka: First commit. 2013-07-23 21:02:06 +02:00
config.py Fix neutral pronouns. 2014-04-11 21:56:42 +00:00
messages.pot PluginDownloader: update l10n-fi. 2014-03-22 16:38:16 +02:00
plugin.py Merge branch 'aka-sqlite3' into speed-up-2to3 2014-02-02 22:15:43 +01:00
README.txt Aka: fix README.txt (alias add --> aka add). 2014-05-07 21:24:18 +03:00
test.py Aka: Add length limit of command names in order to limit the number of database queries. 2013-12-24 14:38:26 +00:00

This plugin allows the user to create various aliases (known as "Akas",
since Alias is the name of another plugin Aka is based on) to other commands
or combinations of other commands (via nested commands).  It is a good
idea to always quote the commands that are being aliased so that any
nested commands are not immediately run.

Basic usage
-----------

Add an aka, trout, which expects a word as an argument

<jamessan> @aka add trout "action slaps $1 with a large trout"
<bot> jamessan: The operation succeeded.
<jamessan> @trout me
* bot slaps me with a large trout

Add an aka, lastfm, which expects a last.fm user and replies with
their recently played items.

@aka add lastfm "rss [format concat http://ws.audioscrobbler.com/1.0/user/ [format concat [urlquote $1] /recenttracks.rss]]"

Note that if the nested commands being aliased hadn't been quoted, then
those commands would have been run immediately, and @lastfm would always
reply with the same information, the result of those commands.
 with any notes, etc. about using it.