Mikaela
/
Limnoria
mirror of https://github.com/Mikaela/Limnoria.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Limnoria/plugins/Admin
History
Valentin Lorentz 833af36b08 all plugins: auto-generate READMEs 
Starting with this commit, there should be no "original" text
in READMEs.
Instead, the entire text should be in docstrings, and READMEs
should be automatically generated from these docstrings.

Motivation:

* The same help is available both via IRC and in the README
  (although the README can be more detailed, as only the first
  paragraph will be shown on IRC)
* This will allow auto-generating plugin help on docs.limnoria.net
  using the same content as the README, as it's sourced from the
  docstrings

Additionally, this converts all READMEs from Markdown to ReST,
because the documentation already uses ReST, and other docstrings
in the codebase are in ReST for this reason.
 		2021-04-05 17:42:31 +02:00
..
locales Fix msgfmt warnings. 2020-03-26 22:10:28 +01:00
README.rst all plugins: auto-generate READMEs 2021-04-05 17:42:31 +02:00
__init__.py Use importlib instead of imp. 2020-01-26 12:00:08 +01:00
config.py Move 'part' command from Admin to Channel and require #channel,op instead of admin 2015-02-27 18:12:52 -08:00
messages.pot Squashed commit of the following: 2014-12-20 14:37:27 +01:00
plugin.py Remove confusing comment (irrelevant since 69ead6c2677262a52f8e9fcd185110d383f2c63d) 2017-09-24 21:21:55 +02:00
test.py Admin: Add tests for joining-on-invite. 2017-05-04 21:53:56 +02:00

README.rst

Documentation for the Admin plugin for Supybot

Purpose

These are commands useful for administrating the bot; they all require their caller to have the 'admin' capability. This plugin is loaded by default.

Usage

This plugin provides access to administrative commands, such as adding capabilities, managing ignore lists, and joining channels. This is a core Supybot plugin that should not be removed!

Commands

acmd <command> [<arg> ...]

Perform <command> (with associated <arg>s on all channels on current network.

capability add <name|hostmask> <capability>

Gives the user specified by <name> (or the user to whom <hostmask> currently maps) the specified capability <capability>

capability remove <name|hostmask> <capability>

Takes from the user specified by <name> (or the user to whom <hostmask> currently maps) the specified capability <capability>

channels takes no arguments

Returns the channels the bot is on.

clearq takes no arguments

Clears the current send queue for this network.

ignore add <hostmask|nick> [<expires>]

This will set a persistent ignore on <hostmask> or the hostmask currently associated with <nick>. <expires> is an optional argument specifying when (in "seconds from now") the ignore will expire; if it isn't given, the ignore will never automatically expire.

ignore list takes no arguments

Lists the hostmasks that the bot is ignoring.

ignore remove <hostmask|nick>

This will remove the persistent ignore on <hostmask> or the hostmask currently associated with <nick>.

join <channel> [<key>]

Tell the bot to join the given channel. If <key> is given, it is used when attempting to join the channel.

nick [<nick>] [<network>]

Changes the bot's nick to <nick>. If no nick is given, returns the bot's current nick.

Configuration

supybot.plugins.Admin.public

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

Determines whether this plugin is publicly visible.