Add --config-file, remove EP2025 default

Author: NMertsch

README.md

@@ -48,18 +48,16 @@ Create a Discord bot with the privileges for receiving `GUILD_MEMBER` events on
 
 ### Command-line usage
 
-* Set the environment variable `BOT_TOKEN` to the bot's access token.
-* Install this package, e.g., with `pip install .` or `uv sync`.
-* CLI: Run `discord-guild-configurator --guild-id <GUILD_ID>`. You can use `--verbose` or `--debug` to see more output.
-
-NOTE: This will apply the [EuroPython 2025 configuration](./src/discord_guild_configurator/configs/ep2025_config.py)
-to the specified guild.
-See below for instructions on how to configure the guild with your own configuration.
+- Set the environment variable `BOT_TOKEN` to the bot's access token.
+- Install this package, e.g., with `pip install .` or `uv sync`.
+- Run `discord-guild-configurator --guild-id <GUILD_ID> --config-file <JSON_FILE>`.
+  - You can use `--verbose` or `--debug` to receive more detailed output.
 
 ### Programmatic usage
 
 ```python
 # Option 1: Create guild configuration programmatically
+from discord_guild_configurator.configurator import GuildConfigurator
 from discord_guild_configurator.models import GuildConfig
 
 GUILD_CONFIG = GuildConfig(...)
@@ -77,11 +75,15 @@ GUILD_CONFIG = GuildConfig.model_validate_json(config_file_content)
 # Apply the configuration
 from discord_guild_configurator.bot import GuildConfigurationBot, run_bot
 
-BOT_TOKEN = "..."
+BOT_TOKEN = "YOUR_TOKEN"
 GUILD_ID = 123456789
 
-configurator = GuildConfigurationBot(GUILD_ID, GUILD_CONFIG)
-run_bot(configurator, BOT_TOKEN)
+async def configure_guild(guild) -> None:
+    configurator = GuildConfigurator(guild)
+    await configurator.apply_configuration(GUILD_CONFIG)
+
+bot = GuildConfigurationBot(GUILD_ID, action=configure_guild)
+run_bot(bot, BOT_TOKEN)
 ```
 
 ## Development

src/discord_guild_configurator/bot.py

@@ -1,33 +1,35 @@
 from __future__ import annotations
 
+import logging
 import sys
 from typing import TYPE_CHECKING, Any, Final
 
 import discord
+from discord import Guild
 from discord.ext.commands import Bot
 
-from discord_guild_configurator.configurator import GuildConfigurator, logger
-
 if TYPE_CHECKING:
-    from discord_guild_configurator.models import GuildConfig
+    from collections.abc import Awaitable, Callable
+
 
+logger = logging.getLogger(__name__)
 
 class GuildConfigurationBot(Bot):
-    def __init__(self, guild_id: int, guild_template: GuildConfig) -> None:
+    def __init__(self, guild_id: int, action: Callable[[Guild], Awaitable[None]]) -> None:
         """Discord bot which exports all guild members to .csv files and then stops itself."""
         intents = discord.Intents.all()
         intents.presences = False
         super().__init__(intents=intents, command_prefix="$")
 
         self.guild_id: Final[int] = guild_id
-        self.guild_template: Final[GuildConfig] = guild_template
+        self.action: Final[Callable[[Guild], Awaitable[None]]] = action
 
     async def on_ready(self) -> None:
         """Event handler for successful connection."""
         guild = self.get_guild(self.guild_id)
         if guild is None:
             raise RuntimeError(f"Could not find guild with ID {self.guild_id}")
-        await GuildConfigurator(guild).apply_configuration(self.guild_template)
+        await self.action(guild)
 
         await self.close()
 

src/discord_guild_configurator/main.py

@@ -5,9 +5,15 @@
 import logging
 import os
 import sys
+from pathlib import Path
+from typing import TYPE_CHECKING
 
 from discord_guild_configurator.bot import GuildConfigurationBot, run_bot
-from discord_guild_configurator.configs.ep2025_config import SERVER_CONFIG
+from discord_guild_configurator.configurator import GuildConfigurator
+from discord_guild_configurator.models import GuildConfig
+
+if TYPE_CHECKING:
+    import discord
 
 DESCRIPTION = """\
 Configure a Discord guild.
@@ -68,6 +74,12 @@ def main() -> None:
         formatter_class=argparse.RawTextHelpFormatter,
     )
     parser.add_argument("--guild-id", type=int, required=True, help="ID of the guild to configure")
+    parser.add_argument(
+        "--config-file",
+        type=Path,
+        required=True,
+        help="Path to the guild configuration file (JSON)",
+    )
     parser.add_argument("--verbose", action="store_true", help="Enable INFO logging")
     parser.add_argument("--debug", action="store_true", help="Enable DEBUG logging")
     args = parser.parse_args()
@@ -78,7 +90,13 @@ def main() -> None:
 
     configure_logging(debug=args.debug, verbose=args.verbose)
 
-    bot = GuildConfigurationBot(args.guild_id, SERVER_CONFIG)
+    guild_config = GuildConfig.model_validate_json(args.config_file.read_text(encoding="UTF-8"))
+
+    async def configure_guild(guild: discord.Guild) -> None:
+        configurator = GuildConfigurator(guild)
+        await configurator.apply_configuration(guild_config)
+
+    bot = GuildConfigurationBot(args.guild_id, configure_guild)
     asyncio.run(run_bot(bot, bot_token))