(Moderation): Base moderation and video system.

Migration to data v2.
Complete core Ticket-based moderation system.
StudyBan ticket implementation.
Video-channel tracking system.

bot/settings/base.py

@@ -218,6 +218,18 @@ class Setting:
                         Colour=discord.Colour.green()
                     ))
 
+    @classmethod
+    def init_task(self, client):
+        """
+        Initialisation task to be excuted during client initialisation.
+        May be used for e.g. populating a cache or required client setup.
+
+        Main application must execute the initialisation task before the setting is used.
+        Further, the task must always be executable, if the setting is loaded.
+        Conditional initalisation should go in the relevant module's init tasks.
+        """
+        return None
+
 
 class ObjectSettings:
     """

bot/settings/guild_settings.py

@@ -168,3 +168,30 @@ class donator_roles(settings.RoleList, settings.ListData, settings.Setting):
             return "The donator badges are now:\n{}".format(self.formatted)
         else:
             return "The donator badges have been removed."
+
+
+@GuildSettings.attach_setting
+class alert_channel(settings.Channel, GuildSetting):
+    category = "Meta"
+
+    attr_name = 'alert_channel'
+    _data_column = 'alert_channel'
+
+    display_name = "alert_channel"
+    desc = "Channel to display global user alerts."
+
+    long_desc = (
+        "This channel will be used for group notifications, "
+        "for example group timers and anti-cheat messages, "
+        "as well as for critical alerts to users that have their direct messages disapbled.\n"
+        "It should be visible to all members."
+    )
+
+    _chan_type = discord.ChannelType.text
+
+    @property
+    def success_response(self):
+        if self.value:
+            return "The alert channel is now {}.".format(self.formatted)
+        else:
+            return "The alert channel has been unset."

bot/settings/setting_types.py

@@ -1,3 +1,4 @@
+import datetime
 import itertools
 from enum import IntEnum
 from typing import Any, Optional
@@ -8,6 +9,7 @@ from cmdClient.Context import Context
 from cmdClient.lib import SafeCancellation
 
 from meta import client
+from utils.lib import parse_dur, strfdur, strfdelta
 
 from .base import UserInputError
 
@@ -596,6 +598,73 @@ class IntegerEnum(SettingType):
                 return "`{}`".format(value.name)
 
 
+class Duration(SettingType):
+    """
+    Duration type, stores a time duration in seconds.
+
+    Types:
+        data: Optional[int]
+            The stored number of seconds.
+        value: Optional[int]
+            The stored number of seconds.
+    """
+    accepts = "A number of days, hours, minutes, and seconds, e.g. `2d 4h 10s`."
+
+    # Set an upper limit on the duration
+    _max = 60 * 60 * 24 * 365
+    _min = None
+
+    # Whether to allow empty durations
+    # This is particularly useful since the duration parser will return 0 for most non-duration strings
+    allow_zero = False
+
+    @classmethod
+    def _data_from_value(cls, id: int, value: Optional[bool], **kwargs):
+        """
+        Both data and value are of type Optional[int].
+        Directly return the provided value as data.
+        """
+        return value
+
+    @classmethod
+    def _data_to_value(cls, id: int, data: Optional[bool], **kwargs):
+        """
+        Both data and value are of type Optional[int].
+        Directly return the internal data as the value.
+        """
+        return data
+
+    @classmethod
+    async def _parse_userstr(cls, ctx: Context, id: int, userstr: str, **kwargs):
+        """
+        Parse the provided duration.
+        """
+        if userstr.lower() == "none":
+            return None
+
+        num = parse_dur(userstr)
+
+        if num == 0 and not cls.allow_zero:
+            raise UserInputError("The provided duration cannot be `0`!")
+
+        if cls._max is not None and num > cls._max:
+            raise UserInputError("Duration cannot be longer than `{}`!".format(strfdur(cls._max)))
+        if cls._min is not None and num < cls._min:
+            raise UserInputError("Duration connot be shorter than `{}`!".format(strfdur(cls._min)))
+
+        return num
+
+    @classmethod
+    def _format_data(cls, id: int, data: Optional[int], **kwargs):
+        """
+        Return the string version of the data.
+        """
+        if data is None:
+            return None
+        else:
+            return "`{}`".format(strfdelta(datetime.timedelta(seconds=data)))
+
+
 class SettingList(SettingType):
     """
     List of a particular type of setting.