mirror of https://github.com/Mikaela/Limnoria.git synced 2024-11-19 17:09:27 +01:00

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

5.0 KiB

Raw Blame History

Documentation for the User plugin for Supybot

Purpose

Provides commands useful to users in general. This plugin is loaded by default.

Usage

Provides commands for dealing with users, such as registration and authentication to the bot. This is a core Supybot plugin that should not be removed!

Commands

capabilities [<name>]: Returns the capabilities of the user specified by <name>; if <name> isn't specified, returns the capabilities of the user calling the command.
changename <name> <new name> [<password>]: Changes your current user database name to the new name given. <password> is only necessary if the user isn't recognized by hostmask. This message must be sent to the bot privately (not on a channel) since it may contain a password.
hostmask [<nick>]: Returns the hostmask of <nick>. If <nick> isn't given, return the hostmask of the person giving the command.
hostmask add [<name>] [<hostmask>] [<password>]: Adds the hostmask <hostmask> to the user specified by <name>. The <password> may only be required if the user is not recognized by hostmask. <password> is also not required if an owner user is giving the command on behalf of some other user. If <hostmask> is not given, it defaults to your current hostmask. If <name> is not given, it defaults to your currently identified name. This message must be sent to the bot privately (not on a channel) since it may contain a password.
hostmask list [<name>]: Returns the hostmasks of the user specified by <name>; if <name> isn't specified, returns the hostmasks of the user calling the command.
hostmask remove [<name>] [<hostmask>] [<password>]: Removes the hostmask <hostmask> from the record of the user specified by <name>. If the hostmask given is 'all' then all hostmasks will be removed. The <password> may only be required if the user is not recognized by their hostmask. This message must be sent to the bot privately (not on a channel) since it may contain a password. If <hostmask> is not given, it defaults to your current hostmask. If <name> is not given, it defaults to your currently identified name.
identify <name> <password>: Identifies the user as <name>. This command (and all other commands that include a password) must be sent to the bot privately, not in a channel.
list [--capability=<capability>] [<glob>]: Returns the valid registered usernames matching <glob>. If <glob> is not given, returns all registered usernames.
register <name> <password>: Registers <name> with the given password <password> and the current hostmask of the person registering. You shouldn't register twice; if you're not recognized as a user but you've already registered, use the hostmask add command to add another hostmask to your already-registered user, or use the identify command to identify just for a session. This command (and all other commands that include a password) must be sent to the bot privately, not in a channel.
set password [<name>] <old password> <new password>: Sets the new password for the user specified by <name> to <new password>. Obviously this message must be sent to the bot privately (not in a channel). If the requesting user is an owner user, then <old password> needn't be correct.
set secure <password> [<True|False>]: Sets the secure flag on the user of the person sending the message. Requires that the person's hostmask be in the list of hostmasks for that user in addition to the password being correct. When the secure flag is set, the user must identify before they can be recognized. If a specific True/False value is not given, it inverts the current value.
stats takes no arguments: Returns some statistics on the user database.
unidentify takes no arguments: Un-identifies you. Note that this may not result in the desired effect of causing the bot not to recognize you anymore, since you may have added hostmasks to your user that can cause the bot to continue to recognize you.
unregister <name> [<password>]: Unregisters <name> from the user database. If the user giving this command is an owner user, the password is not necessary.
username <hostmask|nick>: Returns the username of the user specified by <hostmask> or <nick> if the user is registered.
whoami takes no arguments: Returns the name of the user calling the command.

Configuration

supybot.plugins.User.customWhoamiError

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

Determines what message the bot sends when a user isn't identified or recognized.

supybot.plugins.User.listInPrivate

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

Determines whether the output of 'user list' will be sent in private. This prevents mass-highlights of people who use their nick as their bot username.

supybot.plugins.User.public

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

Determines whether this plugin is publicly visible.

5.0 KiB Raw Blame History