add a very basic bot structure

Author: artcz

Makefile

@@ -1,4 +1,4 @@
-DEV_CMD=cd intbot && DJANGO_ENV="dev" uv run ./manage.py
+DEV_CMD=cd intbot && DJANGO_ENV="dev" uv run --env-file .env -- ./manage.py
 TEST_CMD=cd intbot && DJANGO_SETTINGS_MODULE="intbot.settings" DJANGO_ENV="test" uv run pytest --nomigrations
 
 
@@ -21,6 +21,9 @@ migrations:
 test:
 	$(TEST_CMD) -s -vv
 
+bot:
+	$(DEV_CMD) run_bot
+
 
 client/send_test_webhook:
 	uv run client/send_test_webhook.py

intbot/.env.example

@@ -0,0 +1 @@
+DISCORD_BOT_TOKEN='asdf'

intbot/core/bot/__init__.py

@@ -0,0 +1,24 @@
+import discord
+from django.conf import settings
+from discord.ext import commands
+
+intents = discord.Intents.default()
+intents.members = True
+intents.message_content = True
+
+bot = commands.Bot(command_prefix="!", intents=intents)
+
+
+@bot.event
+async def on_ready():
+    print(f"Bot is ready. Logged in as {bot.user}")
+
+
+@bot.command()
+async def ping(ctx):
+    await ctx.send("Pong!")
+
+
+def run_bot():
+    bot_token = settings.DISCORD_BOT_TOKEN
+    bot.run(bot_token)

intbot/core/bot/main.py

@@ -0,0 +1,9 @@
+from core.bot.main import run_bot
+from django.core.management.base import BaseCommand
+
+
+class Command(BaseCommand):
+    help = "Run the discord bot"
+
+    def handle(self, *args, **kwargs):
+        run_bot()

intbot/core/management/commands/run_bot.py

@@ -11,6 +11,7 @@
 """
 
 import os
+import warnings
 from pathlib import Path
 
 # Build paths inside the project like this: BASE_DIR / 'subdir'.
@@ -123,6 +124,16 @@
 
     WEBHOOK_INTERNAL_TOKEN = "dev-token"
 
+    # This is only needed if you end up running the bot locally, hence it
+    # doesn't fail explicilty – however it does emit a warning.
+    # Please check the documentation and/or current online guides how to get
+    # one from the developer portal.
+    # If you run it locally, you probably want to run it against your own test
+    # bot and a test server.
+    DISCORD_BOT_TOKEN = os.environ.get("DISCORD_BOT_TOKEN", "")
+    if not DISCORD_BOT_TOKEN:
+        warnings.warn("DISCORD_BOT_TOKEN not set")
+
 elif DJANGO_ENV == "test":
     DEBUG = True
     ALLOWED_HOSTS = ["127.0.0.1", "localhost"]

intbot/intbot/settings.py

@@ -0,0 +1,16 @@
+from unittest.mock import AsyncMock
+
+import pytest
+from core.bot.main import ping
+
+
+@pytest.mark.asyncio
+async def test_ping_command():
+    # Mock context
+    ctx = AsyncMock()
+
+    # Call the command
+    await ping(ctx)
+
+    # Assert that the command sent the expected message
+    ctx.send.assert_called_once_with("Pong!")

intbot/tests/test_bot.py

@@ -15,4 +15,5 @@ dependencies = [
     "pytest-django>=4.9.0",
     "django-extensions>=3.2.3",
     "httpx>=0.28.1",
+    "pytest-asyncio>=0.25.2",
 ]