re-structured again

recruitmentCog/recruitment.py

@@ -1,33 +1,28 @@
 import asyncio
 from typing import List
-
 import discord
-from redbot.core import commands
+from redbot.core import Config, checks, commands
 from redbot.core.utils import AsyncIter
+from redbot.core.utils.chat_formatting import pagify, box
 from redbot.core.utils.antispam import AntiSpam
-from redbot.core.utils.chat_formatting import box, pagify
 from redbot.core.bot import Red
 from redbot.core.utils.predicates import MessagePredicate
 
+application_channel_id = 1023172488143839252
 
 class Recruitment(commands.Cog):
-    """A cog that lets a user send a membership application.
-
-    Users can open an application using `[p]apply`. These are then sent
-    to a channel in the server for staff, and the application creator
-    gets a DM. Both can be used to communicate.
-    """
+    """A cog that lets a user send a membership application."""
 
     def __init__(self, bot: Red):
         self.bot = bot
-        self.message: str = ''
-        self.active = True
-        self.application_channel_id = 1023172488143839252
-        self.ask_questions_timeout = 300.0
 
-    @commands.group(name="apply", invoke_without_command=True)
-    async def apply(self, ctx: commands.Context):
-        """Send a membership application."""
+    @commands.group(name="application", usage="[text]", invoke_without_command=True)
+    async def application(self, ctx: commands.Context, *, _application: str = ""):
+        """Send an application.
+
+        Use without arguments for an interactive application creation flow, or do
+        `[p]application [text]` to use it non-interactively.
+        """
         author = ctx.author
 
         # Check if the command was sent in a direct message to the bot
@@ -35,25 +30,37 @@ class Recruitment(commands.Cog):
             await ctx.send("This command can only be used in a direct message to the bot.")
             return
 
-        # Ask the user the questions and get the answers with a timeout
+        if not _application:
+            await self.interactive_application(author)
+        else:
+            await self.noninteractive_application(_application, author)
+
+    async def interactive_application(self, author: discord.Member):
+        """Ask the user several questions to create an application."""
         questions = ["What's your name?", "What's your age?", "Why do you want to join our community?"]
         try:
-            answers = await asyncio.wait_for(self.ask_questions(author, questions), timeout=self.ask_questions_timeout)
+            answers = await self.ask_questions(author, questions)
         except asyncio.TimeoutError:
             await author.send("You took too long to answer. Please try again later.")
             return
 
-        # Create an embed with the application information
-        application_embed = await self.format_application(answers, author)
+        embed = await self.format_application(answers, author)
 
         # Send the embed to the application channel
-        application_channel = self.bot.get_channel(self.application_channel_id)
-        await application_channel.send(embed=application_embed)
+        application_channel = self.bot.get_channel(application_channel_id)
+        await application_channel.send(embed=embed)
 
         # Send a confirmation message to the author
         await author.send("Thank you for submitting your application!")
 
+    async def noninteractive_application(self, application_text: str, author: discord.Member):
+        """Send a non-interactive application."""
+        application_channel = self.bot.get_channel(application_channel_id)
+        await application_channel.send(application_text)
+        await author.send("Thank you for submitting your application!")
+
     async def format_application(self, answers: List[str], author: discord.Member) -> discord.Embed:
+        """Format the application answers into an embed."""
         embed = discord.Embed(title=f"Application from {author.display_name}", color=discord.Color.green())
         embed.add_field(name="Name", value=author.name)
         embed.add_field(name="Discord ID", value=author.id)
@@ -62,17 +69,18 @@ class Recruitment(commands.Cog):
         return embed
 
     async def ask_questions(self, author: discord.Member, questions: List[str]) -> List[str]:
-        """Ask the user a list of questions and return the answers."""
+        """Ask the user several questions and return the answers."""
         answers = []
 
-        # Ask the user the questions
         for question in questions:
             await author.send(question)
-
-            # Wait for the user to respond
-            answer = await self.bot.wait_for(
-                "message", check=lambda m: m.author == author and m.guild is None
-            )
+            answer = await self.get_answer(author)
             answers.append(answer.content)
 
-        return answers
+        return answers
+
+    async def get_answer(self, author: discord.Member) -> discord.Message:
+        """Wait for the user to send a message."""
+        return await self.bot.wait_for(
+            "message", check=lambda m: m.author == author and m.guild is None
+        )