Add comments to the start of modules

app/modules/ai.py

@@ -1,3 +1,8 @@
+"""
+This module is an old mockup of an AI chatbot system using ollama and a set of servers.
+
+It is not actively used or maintained anymore.
+"""
 import asyncio
 import json
 import logging

app/modules/fediverse_preview.py

@@ -1,5 +1,8 @@
 """
 This module takes fediverse links (e.g.) and provides a preview in a reply.
+
+By default, this will only work with fedi.transgender.ing, but if you set `[fediverse_preview.urls]` in your config,
+you can add more. This module will use the Mastodon protocol, however it is designed to be used with misskey.
 """
 import logging
 import niobot

app/modules/latency.py

@@ -1,3 +1,8 @@
+"""
+This module simply returns the latency between a message being sent and the bot receiving it.
+
+It also supports a rudimentary federation latency check, by sending a request to the target homeserver.
+"""
 import urllib.parse
 
 import niobot

app/modules/ts_transcode.py

@@ -1,3 +1,12 @@
+"""
+This module actively listens for messages in a specific room from specific users, and checks if they contain
+a video which uses an unsupported video codec. If it does, it will be transcoded and re-uploaded to the room.
+
+This is used because we mirror Truth Social into a matrix room and sometimes the videos are in H265, which a lot of
+clients cannot play.
+
+This can easily be adapted to other rooms and users, or even to other types of media, by changing the USER_IDS list.
+"""
 import logging
 import shlex
 import shutil

app/modules/version.py

@@ -1,3 +1,6 @@
+"""
+Displays versions for the bot and its dependencies
+"""
 import niobot
 import asyncio
 import tomllib

app/modules/yd_dl.py

@@ -1,3 +1,6 @@
+"""
+What it says on the tin - a command wrapper around yt-dlp.
+"""
 import datetime
 import functools
 import math