Limnoria/plugins/Scheduler
Valentin Lorentz cd02444f87 supybot-plugin-doc: Add labels for all command and config variables
So they can be referenced from elsewhere in the doc.
2021-04-06 00:33:07 +02:00
..
locales Fix msgfmt warnings. 2020-03-26 22:10:28 +01:00
__init__.py all plugins: auto-generate READMEs 2021-04-05 17:42:31 +02:00
config.py Fix neutral pronouns. 2014-04-11 21:56:42 +00:00
messages.pot Squashed commit of the following: 2014-12-20 14:37:27 +01:00
plugin.py Add command @scheduler remind 2020-10-07 21:42:53 +02:00
README.rst supybot-plugin-doc: Add labels for all command and config variables 2021-04-06 00:33:07 +02:00
test.py Add command @scheduler remind 2020-10-07 21:42:53 +02:00

Documentation for the Scheduler plugin for Supybot

Purpose

Gives the user the ability to schedule commands to run at a particular time, or repeatedly run at a particular interval. For example, scheduler add [time seconds 30m] "utilities echo [status cpu]" will schedule the command cpu to be sent to the channel in 30 minutes.

Usage

This plugin allows you to schedule commands to execute at a later time.

Commands

add <seconds> <command>

Schedules the command string <command> to run <seconds> seconds in the future. For example, 'scheduler add [seconds 30m] "echo [cpu]"' will schedule the command "cpu" to be sent to the channel the schedule add command was given in (with no prefixed nick, a consequence of using echo). Do pay attention to the quotes in that example.

list takes no arguments

Lists the currently scheduled events.

remind <seconds> <text>

Sets a reminder with string <text> to run <seconds> seconds in the future. For example, 'scheduler remind [seconds 30m] "Hello World"' will return '<nick> Reminder: Hello World' 30 minutes after being set.

remove <id>

Removes the event scheduled with id <id> from the schedule.

repeat [--delay <delay>] <name> <seconds> <command>

Schedules the command <command> to run every <seconds> seconds, starting now (i.e., the command runs now, and every <seconds> seconds thereafter). <name> is a name by which the command can be unscheduled. If --delay is given, starts in <delay> seconds instead of now.

Configuration

supybot.plugins.Scheduler.public

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

Determines whether this plugin is publicly visible.