Limnoria-doc/use/plugins/channellogger.rst
2011-10-28 22:49:04 +02:00

4.0 KiB

The ChannelLogger plugin

Configuration

supybot.plugins.ChannelLogger.enable

Default value: True

Determines whether logging is enabled.

supybot.plugins.ChannelLogger.filenameTimestamp

Default value: %Y-%m-%d

Determines how to represent the timestamp used for the filename in rotated logs. When this timestamp changes, the old logfiles will be closed and a new one started. The format characters for the timestamp are in the time.strftime docs at python.org. In order for your logs to be rotated, you'll also have to enable supybot.plugins.ChannelLogger.rotateLogs.

supybot.plugins.ChannelLogger.noLogPrefix

Default value: [nolog]

Determines what string a message should be prefixed with in order not to be logged. If you don't want any such prefix, just set it to the empty string.

supybot.plugins.ChannelLogger.rotateLogs

Default value: False

Determines whether the bot will automatically rotate the logs for this channel. The bot will rotate logs when the timestamp for the log changes. The timestamp is set according to the 'filenameTimestamp' configuration variable.

supybot.plugins.ChannelLogger.stripFormatting

Default value: True

Determines whether formatting characters (such as bolding, color, etc.) are removed when writing the logs to disk.

supybot.plugins.ChannelLogger.timestamp

Default value: True

Determines whether the logs for this channel are timestamped with the timestamp in supybot.log.timestampFormat.

supybot.plugins.ChannelLogger.directories

Default value: True

Determines whether the bot will partition its channel logs into separate directories based on different criteria.

supybot.plugins.ChannelLogger.directories.timestamp

Default value: False

Determines whether the bot will use a timestamp (determined by supybot.plugins.ChannelLogger.directories.timestamp.format) if using directories.

supybot.plugins.ChannelLogger.directories.timestamp.format

Default value: %B

Determines what timestamp format will be used in the directory structure for channel logs if supybot.plugins.ChannelLogger.directories.timestamp is True.

supybot.plugins.ChannelLogger.directories.channel

Default value: True

Determines whether the bot will use a channel directory if using directories.

supybot.plugins.ChannelLogger.directories.network

Default value: True

Determines whether the bot will use a network directory if using directories.

supybot.plugins.ChannelLogger.flushImmediately

Default value: False

Determines whether channel logfiles will be flushed anytime they're written to, rather than being buffered by the operating system.

supybot.plugins.ChannelLogger.public

Default value: True

Determines whether this plugin is publicly visible.