sopel-chanlogs

A channel logging plugin for Sopel IRC bots

Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is pip:

$ pip install sopel-chanlogs

Enable the plugin with sopel-plugins enable chanlogs, if your bot configuration requires it.

Requirements

sopel-chanlogs requires only Sopel itself, version 8.0 or higher.

Usage

Configuration

The easiest way to configure sopel-chanlogs is via Sopel's configuration wizard—simply run sopel-plugins configure chanlogs and complete the prompts. All settings are optional, falling back on sensible defaults.

dir

Path to channel log storage directory. Default: ~/chanlogs

by_day

Split log files by day. Default: True

privmsg

Record private messages. Default: False

microseconds

Include microseconds in log timestamps. Default: False

localtime

Attempt to use preferred timezone (the bot's core.default_timezone) instead of UTC. Default: False

Please note that Sopel's default default_timezone is UTC.

Advanced configuration

Log line templates can be overridden using the relevant setting from this list:

• message_template
• action_template
• join_template
• part_template
• quit_template
• nick_template
• topic_template

Each template is formatted using the following {placeholder} values:

• the trigger, with all of its attributes (see Sopel's documentation)
• the date in ISO format
• the time in ISO format
• the full datetime in ISO format

For convenience, the message_template also receives a message placeholder.

Please consult the plugin's code for current default templates.