Merge pull request 'v0.1.0-rc.3' (#15) from dev into main

Reviewed-on: #15

.dockerignore

@@ -1,40 +0,0 @@
-# Include any files or directories that you don't want to be copied to your
-# container here (e.g., local build artifacts, temporary files, etc.).
-#
-# For more help, visit the .dockerignore file reference guide at
-# https://docs.docker.com/go/build-context-dockerignore/
-
-**/.DS_Store
-**/__pycache__
-**/.venv
-**/.classpath
-**/.dockerignore
-**/.env
-**/.git
-**/.gitignore
-**/.project
-**/.settings
-**/.toolstarget
-**/.vs
-**/.vscode
-**/*.*proj.user
-**/*.dbmdl
-**/*.jfm
-**/bin
-**/charts
-**/docker-compose*
-**/compose.y*ml
-**/Dockerfile*
-**/node_modules
-**/npm-debug.log
-**/obj
-**/secrets.dev.yaml
-**/values.dev.yaml
-LICENSE
-README.md
-
-config.json
-.renovaterc
-**/.idea
-**/.mypy_cache
-validation

Dockerfile

@@ -1,27 +0,0 @@
-ARG PYTHON_VERSION=3.12.8
-FROM python:${PYTHON_VERSION}-slim AS base
-
-ENV PYTHONDONTWRITEBYTECODE=1
-ENV PYTHONUNBUFFERED=1
-
-WORKDIR /app
-
-ARG UID=10001
-RUN adduser \
-    --disabled-password \
-    --gecos "" \
-    --home "/nonexistent" \
-    --shell "/sbin/nologin" \
-    --no-create-home \
-    --uid "${UID}" \
-    appuser
-
-RUN --mount=type=cache,target=/root/.cache/pip \
-    --mount=type=bind,source=requirements.txt,target=requirements.txt \
-    python -m pip install -r requirements.txt
-
-USER appuser
-
-COPY . .
-
-ENTRYPOINT ["python", "main.py", "--migrate"]

README.md

@@ -7,50 +7,14 @@
 <a href="https://git.end-play.xyz/HoloUA/Discord"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
 </p>  
 
-## Installation from release
+## Installation
 
-1. Install MongoDB using the [official installation manual](https://www.mongodb.com/docs/manual/installation)
+1. Install MongoDB using the [official installation manual](https://www.mongodb.com/docs/manual/installation/).
-2. Install Python 3.11+
+2. `git clone https://git.end-play.xyz/HoloUA/Discord.git`
-3. Download the [latest release](https://git.end-play.xyz/HoloUA/Discord/releases/latest)'s archive
+3. `cd Discord`
-4. Extract the archive
+4. Install Python 3.9+ (at least 3.11 is recommended) for your OS
-5. Navigate to the extracted folder and subfolder `Discord` in it
+5. `python3 -m pip install -r requirements.txt`
-6. Create a virtual environment:  
+6. Run it with `python3 main.py` after configuring
-   `python -m venv .venv` or `virtualenv .venv`
-7. Activate the virtual environment:  
-   Windows: `.venv\Scripts\activate.bat`  
-   Linux/macOS: `.venv/bin/activate`
-8. Install the dependencies:  
-   `python -m pip install -r requirements.txt`
-9. Run the bot with `python main.py` after completing the [configuration](#Configuration)
-
-## Installation with Git
-
-1. Install MongoDB using the [official installation manual](https://www.mongodb.com/docs/manual/installation)
-2. Install Python 3.11+
-3. Clone the repository:  
-   `git clone https://git.end-play.xyz/HoloUA/Discord.git`
-4. `cd Discord`
-5. Create a virtual environment:  
-   `python -m venv .venv` or `virtualenv .venv`
-6. Activate the virtual environment:  
-   Windows: `.venv\Scripts\activate.bat`  
-   Linux/macOS: `.venv/bin/activate`
-7. Install the dependencies:  
-   `python -m pip install -r requirements.txt`
-8. Run the bot with `python main.py` after completing the [configuration](#Configuration)
-
-## Upgrading with Git
-
-1. Go to the bot's directory
-2. `git pull`
-3. Activate the virtual environment:  
-   Windows: `.venv\Scripts\activate.bat`  
-   Linux/macOS: `.venv/bin/activate`
-4. Update the dependencies:  
-   `python -m pip install -r requirements.txt`
-5. First start after the upgrade must initiate the migration:  
-   `python main.py --migrate`
-6. Now the bot is up to date and the next run will not require `--migrate` anymore
 
 ## Configuration
 
@@ -72,22 +36,3 @@ Mandatory keys to modify:
 - roles.*
 
 After all of that you're good to go! Happy using :)
-
-## Docker [Experimental]
-
-As an experiment, Docker deployment option has been added.
-
-### Building the image
-
-1. `git clone https://git.end-play.xyz/HoloUA/Discord.git`
-2. `cd Discord`
-3. `docker build -t holoua-discord .`
-
-### Starting the bot
-
-1. Install MongoDB using the [official installation manual](https://www.mongodb.com/docs/manual/installation)
-2. Download
-   the [configuration example file](https://git.end-play.xyz/HoloUA/Discord/src/branch/main/config_example.json) and
-   store it somewhere you would like your bot to access it
-3. Complete the [configuration](#Configuration) step for this file
-4. `docker run -d -v /path/to/config.json:/app/config.json holoua-discord`

classes/holo_bot.py

@@ -1,6 +0,0 @@
-from libbot.pycord.classes import PycordBot
-
-
-class HoloBot(PycordBot):
-    def __init__(self, *args, **kwargs):
-        super().__init__(*args, **kwargs)

classes/holo_user.py

@@ -1,89 +1,67 @@
 import logging
-from logging import Logger
+from typing import Any, Union, Dict
-from typing import Any, Dict
 
 from bson import ObjectId
 from discord import User, Member
-from libbot.utils import config_get
+from libbot import config_get
-from pymongo.results import InsertOneResult
 
 from errors import UserNotFoundError
-from modules.database import col_warnings, col_users
+from modules.database import col_warnings, sync_col_users, sync_col_warnings, col_users
 
-logger: Logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class HoloUser:
-    def __init__(
+    def __init__(self, user: Union[User, Member, int]) -> None:
-        self,
-        _id: ObjectId,
-        id: int,
-        custom_role: int | None,
-        custom_channel: int | None,
-    ) -> None:
-        self._id: ObjectId = _id
-
-        self.id: int = id
-        self.custom_role: int | None = custom_role
-        self.custom_channel: int | None = custom_channel
-
-    @classmethod
-    async def from_user(
-        cls, user: User | Member, allow_creation: bool = True
-    ) -> "HoloUser":
         """Get an object that has a proper binding between Discord ID and database
 
         ### Args:
-            * `user` (User | Member): Object from which an ID can be extracted
+            * `user` (Union[User, Member, int]): Object from which ID can be extracted
 
         ### Raises:
             * `UserNotFoundError`: User with such ID does not seem to exist in database
         """
-        db_entry: Dict[str, Any] | None = await col_users.find_one({"user": user.id})
 
-        if db_entry is None:
+        self.id: int = user if not hasattr(user, "id") else user.id
-            if not allow_creation:
-                raise UserNotFoundError(user=user, user_id=user.id)
 
-            db_entry = {
+        jav_user: Union[Dict[str, Any], None] = sync_col_users.find_one(
-                "user": user.id,
+            {"user": self.id}
-                "custom_role": None,
+        )
-                "custom_channel": None,
-            }
 
-            insert_result: InsertOneResult = await col_users.insert_one(db_entry)
+        if jav_user is None:
+            raise UserNotFoundError(user=user, user_id=self.id)
 
-            db_entry["_id"] = insert_result.inserted_id()
+        self.db_id: ObjectId = jav_user["_id"]
 
-        db_entry["id"] = db_entry.pop("user")
+        self.customrole: Union[int, None] = jav_user["customrole"]
+        self.customchannel: Union[int, None] = jav_user["customchannel"]
+        self.warnings: int = self.warns()
 
-        return cls(**db_entry)
+    def warns(self) -> int:
-
-    @classmethod
-    async def from_id(cls, user_id: int) -> "HoloUser":
-        return NotImplemented
-
-    async def get_warnings(self) -> int:
         """Get number of warnings user has
 
         ### Returns:
             * `int`: Number of warnings
         """
-        warns: Dict[str, Any] | None = await col_warnings.find_one({"user": self.id})
+        warns: Union[Dict[str, Any], None] = sync_col_warnings.find_one(
+            {"user": self.id}
+        )
 
         return 0 if warns is None else warns["warns"]
 
-    async def warn(self, count: int = 1, reason: str = "Not provided") -> None:
+    async def warn(self, count=1, reason: str = "Not provided") -> None:
         """Warn and add count to warns number
 
         ### Args:
             * `count` (int, optional): Count of warnings to be added. Defaults to 1.
         """
-        warns: Dict[str, Any] | None = await col_warnings.find_one({"user": self.id})
+        warns: Union[Dict[str, Any], None] = await col_warnings.find_one(
+            {"user": self.id}
+        )
 
         if warns is not None:
             await col_warnings.update_one(
-                {"_id": self._id},
+                {"_id": self.db_id},
                 {"$set": {"warns": warns["warns"] + count}},
             )
         else:
@@ -91,8 +69,8 @@ class HoloUser:
 
         logger.info("User %s was warned %s times due to: %s", self.id, count, reason)
 
-    async def _set(self, key: str, value: Any) -> None:
+    async def set(self, key: str, value: Any) -> None:
-        """Set attribute data and save it into the database
+        """Set attribute data and save it into database
 
         ### Args:
             * `key` (str): Attribute to be changed
@@ -104,50 +82,17 @@ class HoloUser:
         setattr(self, key, value)
 
         await col_users.update_one(
-            {"_id": self._id}, {"$set": {key: value}}, upsert=True
+            {"_id": self.db_id}, {"$set": {key: value}}, upsert=True
         )
 
         logger.info("Set attribute %s of user %s to %s", key, self.id, value)
 
-    async def _remove(self, key: str) -> None:
-        """Remove attribute data and save it into the database
-
-        ### Args:
-            * `key` (str): Attribute to be removed
-        """
-        if not hasattr(self, key):
-            raise AttributeError()
-
-        setattr(self, key, None)
-
-        await col_users.update_one(
-            {"_id": self._id}, {"$unset": {key: None}}, upsert=True
-        )
-
-        logger.info("Removed attribute %s of user %s", key, self.id)
-
-    async def set_custom_channel(self, channel_id: int) -> None:
-        await self._set("custom_channel", channel_id)
-
-    async def set_custom_role(self, role_id: int) -> None:
-        await self._set("custom_role", role_id)
-
-    async def remove_custom_channel(self) -> None:
-        await self._remove("custom_channel")
-
-    async def remove_custom_role(self) -> None:
-        await self._remove("custom_role")
-
-    async def purge(self) -> None:
-        """Completely remove user data from database. Will not remove transactions logs and warnings."""
-        await col_users.delete_one({"_id": self._id})
-
     @staticmethod
-    async def is_moderator(member: User | Member) -> bool:
+    async def is_moderator(member: Union[User, Member]) -> bool:
         """Check if user is moderator or council member
 
         ### Args:
-            * `member` (User | Member): Member object
+            * `member` (Union[User, Member]): Member object
 
         ### Returns:
             `bool`: `True` if member is a moderator or member of council and `False` if not
@@ -155,8 +100,8 @@ class HoloUser:
         if isinstance(member, User):
             return False
 
-        moderator_role: int | None = await config_get("moderators", "roles")
+        moderator_role: Union[int, None] = await config_get("moderators", "roles")
-        council_role: int | None = await config_get("council", "roles")
+        council_role: Union[int, None] = await config_get("council", "roles")
 
         for role in member.roles:
             if role.id in (moderator_role, council_role):
@@ -165,11 +110,11 @@ class HoloUser:
         return False
 
     @staticmethod
-    async def is_council(member: User | Member) -> bool:
+    async def is_council(member: Union[User, Member]) -> bool:
         """Check if user is a member of council
 
         ### Args:
-            * `member` (User | Member): Member object
+            * `member` (Union[User, Member]): Member object
 
         ### Returns:
             `bool`: `True` if member is a member of council and `False` if not
@@ -184,3 +129,8 @@ class HoloUser:
                 return True
 
         return False
+
+    # def purge(self) -> None:
+    #     """Completely remove data from database. Will not remove transactions logs and warnings."""
+    #     col_users.delete_one(filter={"_id": self.db_id})
+    #     self.unauthorize()

cogs/admin.py

@@ -1,6 +1,6 @@
 import logging
 import sys
-from logging import Logger
+from typing import Union
 
 from discord import (
     ApplicationContext,
@@ -13,27 +13,111 @@ from discord import (
 )
 from discord import utils as ds_utils
 from discord.ext import commands
-from libbot.utils import config_get
+from libbot import config_get
+from libbot.pycord.classes import PycordBot
+from libbot.sync import config_get as sync_config_get
 
-from classes.holo_bot import HoloBot
 from enums import Color
 from modules.scheduler import scheduler
 from modules.utils_sync import guild_name
 from modules.waifu_pics import waifu_pics
 
-logger: Logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class Admin(commands.Cog):
     """Cog with utility commands for admins."""
 
-    def __init__(self, client: HoloBot):
+    def __init__(self, client: PycordBot):
-        self.client: HoloBot = client
+        self.client: PycordBot = client
+
+    # Disabled because warning functionality is temporarily not needed
+    # @slash_command(
+    #     name="warning",
+    #     description="Попередити юзера про порушення правил",
+    #     guild_ids=[config_get_sync("guild")],
+    # )
+    # @option("user", description="Користувач")
+    # @option("reason", description="Причина")
+    # async def warn_cmd(
+    #     self,
+    #     ctx: ApplicationContext,
+    #     user: User,
+    #     reason: str = "Не вказана",
+    # ):
+    #     logging.info(f"User {ctx.user.id} warned {user.id} for {reason}")
+    #     await ctx.defer()
+    #     jav_user = HoloUser(user)
+    #     if ctx.user.id in await config_get("admins"):
+    #         logging.info(
+    #             f"Moderator {guild_name(ctx.user)} warned {guild_name(user)} for {reason} (has {jav_user.warnings} warns)"
+    #         )
+    #         if jav_user.warnings >= 5:
+    #             logging.info(
+    #                 f"User {guild_name(user)} was banned due to a big amount of warns ({jav_user.warnings})"
+    #             )
+    #             await user.send(
+    #                 embed=Embed(
+    #                     title="Перманентне блокування",
+    #                     description=f"Вас було заблоковано за неодноразове порушення правил сервера.",
+    #                     color=Color.fail,
+    #                 )
+    #             )
+    #             await user.ban(reason=reason)
+    #         elif jav_user.warnings >= 2:
+    #             logging.info(
+    #                 f"User {guild_name(user)} was muted due to a big amount of warns ({jav_user.warnings})"
+    #             )
+    #             jav_user.warn(reason=reason)
+    #             await user.send(
+    #                 embed=Embed(
+    #                     title="Тимчасове блокування",
+    #                     description=f"Причина: `{reason}`\n\nНа вашому рахунку вже {jav_user.warnings} попереджень. Вас було тимчасово заблоковано на **1 годину**.\n\nЯкщо Ви продовжите порушувати правила сервера – згодом Вас заблокують.",
+    #                     color=0xDED56B,
+    #                 )
+    #             )
+    #             await user.timeout_for(timedelta(hours=1), reason=reason)
+    #         else:
+    #             jav_user.warn()
+
+    #         await ctx.respond(
+    #             embed=Embed(
+    #                 title="Попередження",
+    #                 description=f"{user.mention} Будь ласка, не порушуйте правила. Ви отримали попередження з причини `{reason}`.\n\nЯкщо Ви продовжите порушувати правила – це може призвести до блокування в спільноті.",
+    #                 color=0xDED56B,
+    #             )
+    #         )
+    #     else:
+    #         logging.warning(
+    #             f"User {guild_name(ctx.user)} tried to use /warn but permission denied"
+    #         )
+    #         await ctx.respond(
+    #             embed=Embed(
+    #                 title="Відмовлено в доступі",
+    #                 description="Здається, це команда лише для модераторів",
+    #                 color=Color.fail,
+    #             )
+    #         )
+    #         mod_role = ds_utils.get(
+    #             ctx.user.guild.roles, id=await config_get("moderators", "roles")
+    #         )
+    #         admin_chan = ds_utils.get(
+    #             ctx.user.guild.channels,
+    #             id=await config_get("adminchat", "channels", "text"),
+    #         )
+    #         await admin_chan.send(
+    #             content=f"{mod_role.mention}",
+    #             embed=Embed(
+    #                 title="Неавторизований запит",
+    #                 description=f"Користувач {ctx.user.mention} запитав у каналі {ctx.channel.mention} команду, до якої не повинен мати доступу/бачити.",
+    #                 color=Color.fail,
+    #             ),
+    #         )
 
     @slash_command(
         name="clear",
         description="Видалити деяку кількість повідомлень в каналі",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option("amount", description="Кількість")
     @option("user", description="Користувач", default=None)
@@ -43,10 +127,6 @@ class Admin(commands.Cog):
         amount: int,
         user: User,
     ) -> None:
-        """Command /clear <amount> [<user>]
-
-        Removes last <amount> messages in the current channel. Optionally from a specific user.
-        """
         if ctx.user.id in self.client.owner_ids:
             logging.info(
                 "User %s removed %s message(s) in %s",
@@ -81,10 +161,10 @@ class Admin(commands.Cog):
             )
         )
 
-        mod_role: Role | None = ds_utils.get(
+        mod_role: Union[Role, None] = ds_utils.get(
             ctx.user.guild.roles, id=await config_get("moderators", "roles")
         )
-        admin_chan: TextChannel | None = ds_utils.get(
+        admin_chan: Union[TextChannel, None] = ds_utils.get(
             ctx.user.guild.channels,
             id=await config_get("adminchat", "channels", "text"),
         )
@@ -102,13 +182,9 @@ class Admin(commands.Cog):
     @slash_command(
         name="reboot",
         description="Перезапустити бота",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     async def reboot_cmd(self, ctx: ApplicationContext) -> None:
-        """Command /reboot
-
-        Stops the bot. Is called "reboot" because it's assumed that the bot has automatic restart.
-        """
         await ctx.defer(ephemeral=True)
 
         if ctx.user.id in self.client.owner_ids:
@@ -141,10 +217,10 @@ class Admin(commands.Cog):
             )
         )
 
-        mod_role: Role | None = ds_utils.get(
+        mod_role: Union[Role, None] = ds_utils.get(
             ctx.user.guild.roles, id=await config_get("moderators", "roles")
         )
-        admin_chan: TextChannel | None = ds_utils.get(
+        admin_chan: Union[TextChannel, None] = ds_utils.get(
             ctx.user.guild.channels,
             id=await config_get("adminchat", "channels", "text"),
         )
@@ -160,5 +236,5 @@ class Admin(commands.Cog):
             )
 
 
-def setup(client: HoloBot) -> None:
+def setup(client: PycordBot) -> None:
     client.add_cog(Admin(client))

cogs/analytics.py

@@ -1,29 +1,26 @@
 import logging
-from logging import Logger
 from typing import Dict, List, Any
 
 from discord import Cog, Message
 from discord.ext import commands
+from libbot.pycord.classes import PycordBot
 
-from classes.holo_bot import HoloBot
 from modules.database import col_analytics
 
-logger: Logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class Analytics(commands.Cog):
-    def __init__(self, client: HoloBot):
+    def __init__(self, client: PycordBot):
-        self.client: HoloBot = client
+        self.client: PycordBot = client
 
     @Cog.listener()
     async def on_message(self, message: Message) -> None:
-        """Listener that collects analytical data (stickers, attachments, messages)."""
         if (
             (message.author != self.client.user)
             and (message.author.bot is False)
             and (message.author.system is False)
         ):
-            # Handle stickers
             stickers: List[Dict[str, Any]] = []
 
             for sticker in message.stickers:
@@ -36,7 +33,6 @@ class Analytics(commands.Cog):
                     }
                 )
 
-            # Handle attachments
             attachments: List[Dict[str, Any]] = []
 
             for attachment in message.attachments:
@@ -53,7 +49,6 @@ class Analytics(commands.Cog):
                     }
                 )
 
-            # Insert entry into the database
             await col_analytics.insert_one(
                 {
                     "user": message.author.id,
@@ -65,5 +60,5 @@ class Analytics(commands.Cog):
             )
 
 
-def setup(client: HoloBot) -> None:
+def setup(client: PycordBot) -> None:
     client.add_cog(Analytics(client))

cogs/custom_channels.py

@@ -1,31 +1,31 @@
 import logging
-from logging import Logger
+from typing import Any, Dict, Union
-from typing import Any, Dict
 
 from discord import ApplicationContext, Embed, option, TextChannel, Role
 from discord import utils as ds_utils
 from discord.abc import GuildChannel
 from discord.commands import SlashCommandGroup
 from discord.ext import commands
-from libbot.utils import config_get
+from libbot import config_get
+from libbot.pycord.classes import PycordBot
+from libbot.sync import config_get as sync_config_get
 
-from classes.holo_bot import HoloBot
 from classes.holo_user import HoloUser
 from enums import Color
 from modules.database import col_users
 from modules.utils_sync import guild_name
 
-logger: Logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class CustomChannels(commands.Cog):
-    def __init__(self, client: HoloBot):
+    def __init__(self, client: PycordBot):
-        self.client: HoloBot = client
+        self.client: PycordBot = client
 
     @commands.Cog.listener()
     async def on_guild_channel_delete(self, channel: GuildChannel) -> None:
         await col_users.find_one_and_update(
-            {"custom_channel": channel.id}, {"$set": {"custom_channel": None}}
+            {"customchannel": channel.id}, {"$set": {"customchannel": None}}
         )
 
     custom_channel_group: SlashCommandGroup = SlashCommandGroup(
@@ -35,7 +35,7 @@ class CustomChannels(commands.Cog):
     @custom_channel_group.command(
         name="get",
         description="Отримати персональний текстовий канал",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option("name", description="Назва каналу")
     @option("reactions", description="Дозволити реакції")
@@ -43,11 +43,7 @@ class CustomChannels(commands.Cog):
     async def custom_channel_get_cmd(
         self, ctx: ApplicationContext, name: str, reactions: bool, threads: bool
     ) -> None:
-        """Command /customchannel get <name> <reactions> <threads>
+        holo_user_ctx: HoloUser = HoloUser(ctx.user)
-
-        Command to create a custom channel for a user.
-        """
-        holo_user_ctx: HoloUser = await HoloUser.from_user(ctx.user)
 
         # Return if the user is using the command outside of a guild
         if not hasattr(ctx.author, "guild"):
@@ -62,7 +58,7 @@ class CustomChannels(commands.Cog):
             return
 
         # Return if the user already has a custom channel
-        if holo_user_ctx.custom_channel is not None:
+        if holo_user_ctx.customchannel is not None:
             await ctx.defer(ephemeral=True)
             await ctx.respond(
                 embed=Embed(
@@ -80,7 +76,7 @@ class CustomChannels(commands.Cog):
             reason=f"Користувач {guild_name(ctx.user)} отримав власний приватний канал",
             category=ds_utils.get(
                 ctx.author.guild.categories,
-                id=await config_get("custom_channels", "categories"),
+                id=await config_get("customchannels", "categories"),
             ),
         )
 
@@ -100,7 +96,7 @@ class CustomChannels(commands.Cog):
             manage_channels=True,
         )
 
-        await holo_user_ctx.set_custom_channel(created_channel.id)
+        await holo_user_ctx.set("customchannel", created_channel.id)
 
         await ctx.respond(
             embed=Embed(
@@ -113,7 +109,9 @@ class CustomChannels(commands.Cog):
         bots: Dict[str, Any] = await config_get("bots")
 
         for bot in bots:
-            role: Role | None = ds_utils.get(ctx.user.guild.roles, id=bots[bot]["role"])
+            role: Union[Role, None] = ds_utils.get(
+                ctx.user.guild.roles, id=bots[bot]["role"]
+            )
 
             if role is not None:
                 await created_channel.set_permissions(
@@ -124,7 +122,7 @@ class CustomChannels(commands.Cog):
     @custom_channel_group.command(
         name="edit",
         description="Змінити параметри особистого каналу",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option("name", description="Назва каналу")
     @option("reactions", description="Дозволити реакції")
@@ -132,14 +130,10 @@ class CustomChannels(commands.Cog):
     async def custom_channel_edit_cmd(
         self, ctx: ApplicationContext, name: str, reactions: bool, threads: bool
     ) -> None:
-        """Command /customchannel edit <name> <reactions> <threads>
+        holo_user_ctx: HoloUser = HoloUser(ctx.user)
 
-        Command to change properties of a custom channel.
+        custom_channel: Union[TextChannel, None] = ds_utils.get(
-        """
+            ctx.guild.channels, id=holo_user_ctx.customchannel
-        holo_user_ctx: HoloUser = await HoloUser.from_user(ctx.user)
-
-        custom_channel: TextChannel | None = ds_utils.get(
-            ctx.guild.channels, id=holo_user_ctx.custom_channel
         )
 
         # Return if the channel was not found
@@ -173,19 +167,16 @@ class CustomChannels(commands.Cog):
     @custom_channel_group.command(
         name="remove",
         description="Відібрати канал, знищуючи його, та частково повернути кошти",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option("confirm", description="Підтвердження операції")
     async def custom_channel_remove_cmd(
         self, ctx: ApplicationContext, confirm: bool = False
     ) -> None:
-        """Command /customchannel remove [<confirm>]
+        holo_user_ctx: HoloUser = HoloUser(ctx.user)
-
-        Command to remove a custom channel. Requires additional confirmation."""
-        holo_user_ctx: HoloUser = await HoloUser.from_user(ctx.user)
 
         # Return if the user does not have a custom channel
-        if holo_user_ctx.custom_channel is None:
+        if holo_user_ctx.customchannel is None:
             await ctx.defer(ephemeral=True)
             await ctx.respond(
                 embed=Embed(
@@ -198,8 +189,8 @@ class CustomChannels(commands.Cog):
 
         await ctx.defer()
 
-        custom_channel: TextChannel | None = ds_utils.get(
+        custom_channel: Union[TextChannel, None] = ds_utils.get(
-            ctx.guild.channels, id=holo_user_ctx.custom_channel
+            ctx.guild.channels, id=holo_user_ctx.customchannel
         )
 
         # Return if the channel was not found
@@ -211,7 +202,7 @@ class CustomChannels(commands.Cog):
                     color=Color.FAIL,
                 )
             )
-            await holo_user_ctx.remove_custom_channel()
+            await holo_user_ctx.set("customchannel", None)
             return
 
         # Return if the confirmation is missing
@@ -227,7 +218,7 @@ class CustomChannels(commands.Cog):
 
         await custom_channel.delete(reason="Власник запросив видалення")
 
-        await holo_user_ctx.remove_custom_channel()
+        await holo_user_ctx.set("customchannel", None)
 
         try:
             await ctx.respond(
@@ -243,5 +234,5 @@ class CustomChannels(commands.Cog):
             )
 
 
-def setup(client: HoloBot) -> None:
+def setup(client: PycordBot) -> None:
     client.add_cog(CustomChannels(client))

cogs/data.py

@@ -1,43 +1,41 @@
 import logging
-from logging import Logger
 from os import makedirs
 from pathlib import Path
-from typing import List, Dict, Any
+from typing import Union, List, Dict, Any
 from uuid import uuid4
 
 from discord import ApplicationContext, Embed, File, option, Role, TextChannel
 from discord import utils as ds_utils
 from discord.commands import SlashCommandGroup
 from discord.ext import commands
-from libbot.utils import config_get, json_write
+from libbot import config_get
+from libbot.pycord.classes import PycordBot
+from libbot.sync import config_get as sync_config_get
+from libbot.sync import json_write as sync_json_write
 
-from classes.holo_bot import HoloBot
 from classes.holo_user import HoloUser
 from enums import Color
 from modules.database import col_users
 from modules.utils_sync import guild_name
 
-logger: Logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class Data(commands.Cog):
-    def __init__(self, client: HoloBot):
+    def __init__(self, client: PycordBot):
-        self.client: HoloBot = client
+        self.client: PycordBot = client
 
     data: SlashCommandGroup = SlashCommandGroup("data", "Керування даними користувачів")
 
     @data.command(
         name="export",
         description="Експортувати дані",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option(
         "kind", description="Тип даних, які треба експортувати", choices=["Користувачі"]
     )
     async def data_export_cmd(self, ctx: ApplicationContext, kind: str) -> None:
-        """Command /data export <kind>
-
-        Command to export specific kind of data."""
         await ctx.defer()
 
         # Return if the user is not an owner and not in the council
@@ -57,10 +55,10 @@ class Data(commands.Cog):
                 )
             )
 
-            mod_role: Role | None = ds_utils.get(
+            mod_role: Union[Role, None] = ds_utils.get(
                 ctx.user.guild.roles, id=await config_get("moderators", "roles")
             )
-            admin_chan: TextChannel | None = ds_utils.get(
+            admin_chan: Union[TextChannel, None] = ds_utils.get(
                 ctx.user.guild.channels,
                 id=await config_get("adminchat", "channels", "text"),
             )
@@ -95,26 +93,19 @@ class Data(commands.Cog):
                     }
                 )
 
-            # Temporary file must be written synchronously,
+            sync_json_write(users, Path(f"tmp/{uuid}"))
-            # otherwise it will not be there when ctx.respond() is be called
-            json_write(users, Path(f"tmp/{uuid}"))
 
             await ctx.respond(file=File(Path(f"tmp/{uuid}"), filename="users.json"))
 
     @data.command(
         name="migrate",
         description="Мігрувати всіх користувачів до бази",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option(
         "kind", description="Тип даних, які треба експортувати", choices=["Користувачі"]
     )
     async def data_migrate_cmd(self, ctx: ApplicationContext, kind: str) -> None:
-        """Command /migrate <kind>
-
-        Command to migrate specific kind of data.
-
-        Migration of users in this case means creation of their DB entries."""
         await ctx.defer()
 
         # Return if the user is not an owner and not in the council
@@ -134,10 +125,10 @@ class Data(commands.Cog):
                 )
             )
 
-            mod_role: Role | None = ds_utils.get(
+            mod_role: Union[Role, None] = ds_utils.get(
                 ctx.user.guild.roles, id=await config_get("moderators", "roles")
             )
-            admin_chan: TextChannel | None = ds_utils.get(
+            admin_chan: Union[TextChannel, None] = ds_utils.get(
                 ctx.user.guild.channels,
                 id=await config_get("adminchat", "channels", "text"),
             )
@@ -188,5 +179,5 @@ class Data(commands.Cog):
         )
 
 
-def setup(client: HoloBot) -> None:
+def setup(client: PycordBot) -> None:
     client.add_cog(Data(client))

cogs/fun.py

@@ -1,36 +1,33 @@
 import logging
-from logging import Logger
 
 from discord import ApplicationContext, Embed, User, option, slash_command
 from discord.ext import commands
-from libbot.utils import config_get
+from libbot import config_get
+from libbot.pycord.classes import PycordBot
+from libbot.sync import config_get as sync_config_get
 
-from classes.holo_bot import HoloBot
 from modules.utils_sync import guild_name
 from modules.waifu_pics import waifu_pics
 
-logger: Logger = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 class Fun(commands.Cog):
-    def __init__(self, client: HoloBot):
+    def __init__(self, client: PycordBot):
-        self.client: HoloBot = client
+        self.client: PycordBot = client
 
     @slash_command(
         name="action",
         description="Провести над користувачем РП дію",
-        guild_ids=[config_get("guild")],
+        guild_ids=[sync_config_get("guild")],
     )
     @option(
         "type",
         description="Тип дії, яку хочете провести з користувачем",
-        choices=config_get("actions").keys(),
+        choices=sync_config_get("actions").keys(),
     )
     @option("user", description="Користувач")
     async def action_cmd(self, ctx: ApplicationContext, type: str, user: User) -> None:
-        """Command /action <type> <user>
-
-        Command to perform some RP action on a user and send them a GIF."""
         await ctx.defer()
 
         action: str = await config_get("category", "actions", type)
@@ -57,5 +54,5 @@ class Fun(commands.Cog):
         await ctx.respond(embed=embed)
 
 
-def setup(client: HoloBot) -> None:
+def setup(client: PycordBot) -> None:
     client.add_cog(Fun(client))

cogs/logger.py

@@ -1,25 +1,20 @@
-import logging
+from typing import Dict, Any, Union
-from logging import Logger
-from typing import Dict, Any
 
-from discord import Member, Message, TextChannel, MessageType
+from discord import Member, Message, TextChannel
 from discord import utils as ds_utils
 from discord.ext import commands
-from libbot.utils import config_get
+from libbot import config_get
+from libbot.pycord.classes import PycordBot
 
-from classes.holo_bot import HoloBot
 from modules.database import col_users
 
-logger: Logger = logging.getLogger(__name__)
-
 
 class Logger(commands.Cog):
-    def __init__(self, client: HoloBot):
+    def __init__(self, client: PycordBot):
-        self.client: HoloBot = client
+        self.client: PycordBot = client
 
     @commands.Cog.listener()
     async def on_message(self, message: Message):
-        """Message listener. All actions on messages remain here for now."""
         if (
             (message.author != self.client.user)
             and (message.author.bot is False)
@@ -36,42 +31,17 @@ class Logger(commands.Cog):
 
                 await col_users.insert_one(document=user)
 
-        if (
-            (message.type == MessageType.thread_created)
-            and (message.channel is not None)
-            and (
-                await col_users.count_documents({"custom_channel": message.channel.id})
-                > 0
-            )
-        ):
-            try:
-                logger.info(
-                    "Deleting the thread creation message in a custom channel %s",
-                    message.channel.id,
-                )
-                await message.delete()
-            except Exception as exc:
-                logger.warning(
-                    "Could not delete the thread creation message in a custom channel %s due to %s",
-                    message.channel.id,
-                    exc,
-                )
-
     @commands.Cog.listener()
     async def on_member_join(self, member: Member) -> None:
-        """Member join handler. All actions on member join remain here for now."""
+        welcome_chan: Union[TextChannel, None] = ds_utils.get(
-        welcome_chan: TextChannel | None = ds_utils.get(
             self.client.get_guild(await config_get("guild")).channels,
             id=await config_get("welcome", "channels", "text"),
         )
-        rules_chan: TextChannel | None = ds_utils.get(
+        rules_chan: Union[TextChannel, None] = ds_utils.get(
             self.client.get_guild(await config_get("guild")).channels,
             id=await config_get("rules", "channels", "text"),
         )
 
-        if welcome_chan is None:
-            logger.warning("Could not find a welcome channel by its id")
-
         if (
             (member != self.client.user)
             and (member.bot is False)
@@ -95,5 +65,5 @@ class Logger(commands.Cog):
                 await col_users.insert_one(document=user)
 
 
-def setup(client: HoloBot) -> None:
+def setup(client: PycordBot) -> None:
     client.add_cog(Logger(client))

cogs/utility.py

@@ -1,58 +0,0 @@
-import logging
-from logging import Logger
-
-from discord import Activity, ActivityType
-from discord.ext import commands
-from libbot.utils import config_get
-
-from classes.holo_bot import HoloBot
-
-logger: Logger = logging.getLogger(__name__)
-
-
-class Utility(commands.Cog):
-    def __init__(self, client: HoloBot):
-        self.client: HoloBot = client
-
-    @commands.Cog.listener()
-    async def on_ready(self) -> None:
-        """Listener for the event when bot connects to Discord and becomes "ready"."""
-        logger.info("Logged in as %s", self.client.user)
-
-        activity_type: str = await config_get("type", "status")
-        activity_message: str = await config_get("message", "status")
-
-        if activity_type == "playing":
-            await self.client.change_presence(
-                activity=Activity(type=ActivityType.playing, name=activity_message)
-            )
-        elif activity_type == "watching":
-            await self.client.change_presence(
-                activity=Activity(type=ActivityType.watching, name=activity_message)
-            )
-        elif activity_type == "listening":
-            await self.client.change_presence(
-                activity=Activity(type=ActivityType.listening, name=activity_message)
-            )
-        elif activity_type == "streaming":
-            await self.client.change_presence(
-                activity=Activity(type=ActivityType.streaming, name=activity_message)
-            )
-        elif activity_type == "competing":
-            await self.client.change_presence(
-                activity=Activity(type=ActivityType.competing, name=activity_message)
-            )
-        elif activity_type == "custom":
-            await self.client.change_presence(
-                activity=Activity(type=ActivityType.custom, name=activity_message)
-            )
-        else:
-            return
-
-        logger.info(
-            "Set activity type to %s with message %s", activity_type, activity_message
-        )
-
-
-def setup(client: HoloBot) -> None:
-    client.add_cog(Utility(client))

config_example.json

@@ -28,12 +28,12 @@
     },
     "defaults": {
         "user": {
-            "custom_role": null,
+            "customrole": null,
-            "custom_channel": null
+            "customchannel": null
         }
     },
     "categories": {
-        "custom_channels": 0
+        "customchannels": 0
     },
     "channels": {
         "text": {

main.py

@@ -1,15 +1,12 @@
-import contextlib
 import logging
 import sys
-from argparse import ArgumentParser
 from logging import Logger
-from pathlib import Path
 
-from discord import LoginFailure, Intents
+from discord import Activity, ActivityType
-from libbot.utils import config_get
+from libbot import config_get
+from libbot.sync import config_get as sync_config_get
 
-from classes.holo_bot import HoloBot
+from modules.client import client
-from modules.migrator import migrate_database
 from modules.scheduler import scheduler
 
 logging.basicConfig(
@@ -20,50 +17,61 @@ logging.basicConfig(
 
 logger: Logger = logging.getLogger(__name__)
 
-# Declare the parser that retrieves the command line arguments
+try:
-parser = ArgumentParser(
+    import uvloop  # type: ignore
-    prog="HoloUA Discord",
-    description="Discord bot for the HoloUA community.",
-)
-
-# Add a switch argument --migrate to be parsed...
-parser.add_argument("--migrate", action="store_true")
-
-# ...and parse the arguments we added
-args = parser.parse_args()
-
-# Try to import the module that improves performance
-# and ignore errors when module is not installed
-with contextlib.suppress(ImportError):
-    import uvloop
 
     uvloop.install()
+except ImportError:
+    pass
+
+
+@client.event
+async def on_ready() -> None:
+    logger.info("Logged in as %s", client.user)
+
+    activity_type: str = await config_get("type", "status")
+    activity_message: str = await config_get("message", "status")
+
+    if activity_type == "playing":
+        await client.change_presence(
+            activity=Activity(type=ActivityType.playing, name=activity_message)
+        )
+    elif activity_type == "watching":
+        await client.change_presence(
+            activity=Activity(type=ActivityType.watching, name=activity_message)
+        )
+    elif activity_type == "listening":
+        await client.change_presence(
+            activity=Activity(type=ActivityType.listening, name=activity_message)
+        )
+    elif activity_type == "streaming":
+        await client.change_presence(
+            activity=Activity(type=ActivityType.streaming, name=activity_message)
+        )
+    elif activity_type == "competing":
+        await client.change_presence(
+            activity=Activity(type=ActivityType.competing, name=activity_message)
+        )
+    elif activity_type == "custom":
+        await client.change_presence(
+            activity=Activity(type=ActivityType.custom, name=activity_message)
+        )
+    else:
+        return
+
+    logger.info(
+        "Set activity type to %s with message %s", activity_type, activity_message
+    )
 
 
 def main() -> None:
-    if not Path("config.json").exists():
-        logger.error(
-            "Config file is missing: Make sure the configuration file 'config.json' is in place."
-        )
-        sys.exit()
-
-    # Perform migration if command line argument was provided
-    if args.migrate:
-        logger.info("Performing migrations...")
-        migrate_database()
-
-    intents: Intents = Intents().all()
-    client: HoloBot = HoloBot(intents=intents, scheduler=scheduler)
-
     client.load_extension("cogs")
 
     try:
-        client.run(config_get("bot_token", "bot"))
+        scheduler.start()
-    except LoginFailure as exc:
+        client.run(sync_config_get("bot_token", "bot"))
-        logger.error("Provided bot token is invalid: %s", exc)
     except KeyboardInterrupt:
-        logger.info("KeyboardInterrupt received: Shutting down gracefully.")
+        scheduler.shutdown()
-    finally:
         sys.exit()
 
 

migrations/202412272043.py

@@ -1,79 +0,0 @@
-import logging
-from logging import Logger
-
-from libbot.utils import config_get, config_set, config_delete
-from mongodb_migrations.base import BaseMigration
-
-logger: Logger = logging.getLogger(__name__)
-
-
-class Migration(BaseMigration):
-    def upgrade(self):
-        try:
-            # Categories
-            config_set(
-                "custom_channels",
-                config_get("customchannels", "categories"),
-                "categories",
-            )
-            config_delete("customchannels", "categories")
-
-            # User defaults
-            config_delete(
-                "user",
-                "defaults",
-            )
-        except Exception as exc:
-            logger.error(
-                "Could not upgrade the config during migration '%s' due to: %s",
-                __name__,
-                exc,
-            )
-
-        self.db.users.update_many(
-            {"customchannel": {"$exists": True}},
-            {"$rename": {"customchannel": "custom_channel"}},
-        )
-        self.db.users.update_many(
-            {"customrole": {"$exists": True}},
-            {"$rename": {"customrole": "custom_role"}},
-        )
-
-    def downgrade(self):
-        try:
-            # Categories
-            config_set(
-                "customchannels",
-                config_get("custom_channels", "categories"),
-                "categories",
-            )
-            config_delete("custom_channels", "categories")
-
-            # User defaults
-            config_set(
-                "customrole",
-                None,
-                "defaults",
-                "user",
-            )
-            config_set(
-                "customchannel",
-                None,
-                "defaults",
-                "user",
-            )
-        except Exception as exc:
-            logger.error(
-                "Could not downgrade the config during migration '%s' due to: %s",
-                __name__,
-                exc,
-            )
-
-        self.db.users.update_many(
-            {"custom_channel": {"$exists": True}},
-            {"$rename": {"custom_channel": "customchannel"}},
-        )
-        self.db.users.update_many(
-            {"custom_role": {"$exists": True}},
-            {"$rename": {"custom_role": "customrole"}},
-        )

modules/client.py

@@ -0,0 +1,10 @@
+from discord import Intents
+from libbot.pycord.classes import PycordBot
+
+from modules.scheduler import scheduler
+
+intents: Intents = Intents().all()
+
+intents.members = True
+
+client: PycordBot = PycordBot(intents=intents, scheduler=scheduler)

modules/database.py

@@ -1,12 +1,12 @@
 from typing import Dict, Any
 
 from async_pymongo import AsyncClient, AsyncCollection, AsyncDatabase
-from libbot.utils import config_get
+from libbot.sync import config_get as sync_config_get
 from pymongo import MongoClient
 from pymongo.synchronous.collection import Collection
 from pymongo.synchronous.database import Database
 
-db_config: Dict[str, Any] = config_get("database")
+db_config: Dict[str, Any] = sync_config_get("database")
 
 con_string: str = (
     "mongodb://{0}:{1}/{2}".format(

modules/migrator.py

@@ -1,22 +0,0 @@
-from typing import Any, Mapping
-
-from libbot.utils import config_get
-from mongodb_migrations.cli import MigrationManager
-from mongodb_migrations.config import Configuration
-
-
-def migrate_database() -> None:
-    """Apply migrations from folder `migrations/` to the database"""
-    database_config: Mapping[str, Any] = config_get("database")
-
-    manager_config = Configuration(
-        {
-            "mongo_host": database_config["host"],
-            "mongo_port": database_config["port"],
-            "mongo_database": database_config["name"],
-            "mongo_username": database_config["user"],
-            "mongo_password": database_config["password"],
-        }
-    )
-    manager = MigrationManager(manager_config)
-    manager.run()

modules/utils_sync.py

@@ -1,7 +1,9 @@
+from typing import Union
+
 from discord import Member, User
 
 
-def guild_name(member: Member | User) -> str:
+def guild_name(member: Union[Member, User]) -> str:
     if isinstance(member, User):
         return member.name
 

requirements.txt

@@ -5,7 +5,6 @@ requests>=2.32.2
 aiofiles~=24.1.0
 apscheduler>=3.10.0
 async_pymongo==0.1.11
-libbot[speed,pycord]==4.0.2
+libbot[speed,pycord]==3.2.3
-mongodb-migrations==1.3.1
 ujson~=5.10.0
 WaifuPicsPython==0.2.0

validation/users.json

@@ -2,26 +2,21 @@
     "$jsonSchema": {
         "required": [
             "user",
-            "custom_role",
+            "customrole",
-            "custom_channel"
+            "customchannel"
+
         ],
         "properties": {
             "user": {
                 "bsonType": "long",
                 "description": "Discord ID of user"
             },
-            "custom_role": {
+            "customrole": {
-                "bsonType": [
+                "bsonType": ["null", "long"],
-                    "null",
-                    "long"
-                ],
                 "description": "Discord ID of custom role or 'null' if not set"
             },
-            "custom_channel": {
+            "customchannel": {
-                "bsonType": [
+                "bsonType": ["null", "long"],
-                    "null",
-                    "long"
-                ],
                 "description": "Discord ID of custom channel or 'null' if not set"
             }
         }

validation/warnings.json

@@ -2,14 +2,14 @@
     "$jsonSchema": {
         "required": [
             "user",
-            "warnings"
+            "warns"
         ],
         "properties": {
             "user": {
                 "bsonType": "long",
                 "description": "Discord ID of user"
             },
-            "warnings": {
+            "warns": {
                 "bsonType": "int",
                 "description": "Number of warnings on count"
             }