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	Remove Spanish translations as requested by the author	2021-06-24 22:36:04 -07: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 Alias plugin for Supybot

Purpose

Allows aliases for other commands. NOTE THAT IT'S RECOMMENDED TO USE Aka PLUGIN INSTEAD!

Usage

This plugin allows users to define aliases to commands and combinations of commands (via nesting). This plugin is only kept for backward compatibility, you should use the built-in Aka plugin instead (you can migrate your existing aliases using the 'importaliasdatabase' command.

To 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

To 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 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.

Commands

add <name> <command>: Defines an alias <name> that executes <command>. The <command> should be in the standard "command argument [nestedcommand argument]" arguments to the alias; they'll be filled with the first, second, etc. arguments. $1, $2, etc. can be used for required arguments. @1, @2, etc. can be used for optional arguments. $* simply means "all remaining arguments," and cannot be combined with optional arguments.

list [--locked|--unlocked]: Lists alias names of a particular type, defaults to all aliases if no --locked or --unlocked option is given.

lock <alias>: Locks an alias so that no one else can change it.

remove <name>: Removes the given alias, if unlocked.

unlock <alias>: Unlocks an alias so that people can define new aliases over it.

Configuration

supybot.plugins.Alias.aliases: This is a group of:

supybot.plugins.Alias.escapedaliases: This is a group of:

supybot.plugins.Alias.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.Alias.validName

This config variable defaults to "^[^\x00-\x20]+$", is not network-specific, and is not channel-specific.

Regex which alias names must match in order to be valid