Limnoria/plugins/Alias
jacksonmj 9eafe29c30 Alias: fix tests 2015-08-22 14:36:00 +00:00
..
locales Alias & Anonymous: add l10n-es 2015-01-01 19:38:37 +02:00
README.md Alias: improve formatting of README.md. 2014-06-08 13:19:58 +03:00
__init__.py Remove need for 2to3. 2015-08-11 16:50:23 +02:00
config.py Alias: more relaxed valid name regex (printable characters instead of "a-z0-9 and some symbols") 2015-08-22 11:37:13 +00:00
messages.pot Squashed commit of the following: 2014-12-20 14:37:27 +01:00
plugin.py Alias: prevent "RuntimeError: dictionary changed size during iteration" for invalid aliases 2015-08-22 13:24:19 +00:00
test.py Alias: fix tests 2015-08-22 14:36:00 +00:00

README.md

This plugin allows the user to create various aliases 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 alias, trout, which expects a word as an argument

<jamessan> @alias 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 alias, lastfm, which expects a last.fm user and replies with their recently played items.

@alias 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 hadnt been quoted, then those commands would have been run immediately, and @lastfm would always reply with the same information, the result of those commands.