MAJ des commandes et de help

Author: Oreshout

app/_app.py

@@ -1,7 +1,7 @@
 from discord import app_commands
 import asyncio
-from config import os, bot, tree, logger,discord, TOKEN
-from tools import help, clear_slash,start_Session,Wait,presentation_bot
+from config import os, bot, tree, logger, discord, TOKEN
+from tools import help, clear_slash, start_Session, Wait, presentation_bot
 import error_embed as embed
 import classement as ldb
 from admin_command import ban
@@ -23,28 +23,6 @@ async def on_ready():
 # _______________________________________________________________________________________________________________________________
 
 
-@tree.command(name="ping", description="Répond avec Pong !")
-async def ping_slash(interaction: discord.Interaction):
-    await interaction.response.send_message("🏓 Pong !")
-
-# _______________________________________________________________________________________________________________________________
-
-
-@tree.command(name="say", description="Répète ton message")
-@app_commands.describe(message="Le message à répéter")
-async def say_slash(interaction: discord.Interaction, message: str):
-    await interaction.response.send_message(f"💬 {message}")
-
-# _______________________________________________________________________________________________________________________________
-
-
-@tree.command(name="salut", description="Salue quelqu’un")
-async def salut_slash(interaction: discord.Interaction):
-    await interaction.response.send_message(f"👋 Salut {interaction.user.mention} !")
-
-# _______________________________________________________________________________________________________________________________
-
-
 @tree.command(name="clear", description="Supprime des messages (admin uniquement)")
 @app_commands.describe(nombre="Nombre de messages à supprimer")
 async def clearing_tool(interaction: discord.Interaction, nombre: int):
@@ -85,6 +63,7 @@ async def submit(interaction: discord.Interaction, premier: str, deuxieme: str,
 
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="pronos_qualif", description="Enregistre tes pronos ou modifie les si tu l'a déja fait par le passé(max 1 fois)")
 @app_commands.describe(premier="Le premier", deuxieme="Le deuxième", troisieme="Le troisième")
 async def submit_qualif(interaction: discord.Interaction, premier: str, deuxieme: str, troisieme: str):
@@ -112,34 +91,38 @@ async def submit_qualif(interaction: discord.Interaction, premier: str, deuxieme
 
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="visualisation", description="Te montre tes pronos")
-async def visu(interaction : discord.Interaction):
+async def visu(interaction: discord.Interaction):
     await interaction.response.defer(ephemeral=True)
     await pr.visualisation(interaction)
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="leaderboard", description="Affiche le clasement des membres")
 async def leaderboard(interaction: discord.Interaction):
     await interaction.response.defer()
     embed = ldb.Leaderboard()
-    await interaction.followup.send(content=None,embed=embed)
+    await interaction.followup.send(content=None, embed=embed)
     logger.info(f'{interaction.user} à regarder le leaderbord')
-    
+
 # _______________________________________________________________________________________________________________________________
-    
+
+
 @tree.command(name="admin_ban", description="AC-03")
-@app_commands.describe(member= "Membre à bannnir", reason = "Raison du bannissement" , article = "Le ou les articles qu'il a enfreint")
+@app_commands.describe(member="Membre à bannnir", reason="Raison du bannissement", article="Le ou les articles qu'il a enfreint")
 async def bannissement(interaction: discord.Interaction, member: discord.Member, reason: str, article: str):
     if interaction.user.guild_permissions.ban_members:
         await interaction.response.defer(ephemeral=True)
         await ban(interaction, member, reason, article)
         logger.info(f"{interaction.user.name} à banni {member}")
-        
+
     else:
         await embed.chat_you_dont_have_perm(interaction)
-        
+
 # _______________________________________________________________________________________________________________________________
-        
+
+
 @tree.command(name="admin_open", description="Ouvre une session de pronostics pour un temp donné")
 @app_commands.describe(duration="temps en heures")
 async def create(interaction: discord.Interaction, duration: float):
@@ -160,9 +143,10 @@ async def create(interaction: discord.Interaction, duration: float):
     else:
         await interaction.response.defer(ephemeral=True)
         await interaction.followup.send(embed=await embed.permError(interaction))
-        
+
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="admin_close", description="Ferme la session de pronos")
 async def close(interaction: discord.Interaction):
     await interaction.response.defer(ephemeral=True)
@@ -187,6 +171,7 @@ async def close(interaction: discord.Interaction):
 
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="session", description="Configure manuellement la session des pronos récupère ses résultats, et update le leaderboard")
 @app_commands.describe(saison="Année de la saison", location="Nom du Circuit", type="Type de l'événement(Q pour qualif, ou R pour course)")
 async def session(interaction: discord.Interaction, saison: int, location: str, type: str):
@@ -211,15 +196,16 @@ async def session(interaction: discord.Interaction, saison: int, location: str,
         await interaction.followup.send("Le Leaderboard est à jour")
     else:
         await interaction.followup.send(embed=await embed.permError(interaction))
-        
+
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="admin_getresult", description="Mettre à jour l'api")
 async def maj_api(interaction: discord.Interaction):
     interaction.response.defer()
     if interaction.user.guild_permissions.administrator:
         await interaction.response.send_message("⏳ Mise à jour en cours...")
-        
+
         try:
             result = f1api.getResults()
 
@@ -256,6 +242,7 @@ async def status(interaction: discord.Interaction):
 
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="admin_stop", description="Stop le fonctionnement auto du bot")
 async def stop(interaction: discord.Interaction):
     await interaction.response.defer(ephemeral=True)
@@ -310,6 +297,8 @@ async def auto_mod(interaction: discord.Interaction):
             ldb.saveResults()
             if (os.path.exists("data/Pronos.json")):
                 os.remove("data/Pronos.json")
+
+
 @tree.command(name="admin_launch", description="Lance le fonctionnement auto du bot")
 async def launch(interaction: discord.Interaction):
     if interaction.user.guild_permissions.administrator:
@@ -320,9 +309,10 @@ async def launch(interaction: discord.Interaction):
     else:
         await interaction.response.defer(ephemeral=True)
         await interaction.followup.send(embed=await embed.permError(interaction), ephemeral=True)
-        
+
 # _______________________________________________________________________________________________________________________________
 
+
 @bot.event
 async def on_message(message: discord.Message):
     # Nos ID pour pouvoir etre les seuls à pouvoir lancer la commande
@@ -343,18 +333,20 @@ async def on_message(message: discord.Message):
                     asyncio.sleep(5)
                     pass
                 await message.delete()
-                
+
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="presentation", description="Laisse moi me présenter et aide moi à trouver mon nom !")
 async def presentation(interaction: discord.Interaction):
     await interaction.response.defer(ephemeral=True)
     await interaction.followup.send(f"{interaction.user.mention}, va voir tes MP !", ephemeral=False)
     await presentation_bot(interaction)
     logger.info(f"{interaction.user} a demandé la présentation du BOT")
-    
+
 # _______________________________________________________________________________________________________________________________
 
+
 @tree.command(name="rules", description="Affiche le règlement d'usage du BOT")
 async def reglement(interaction: discord.Interaction):
     await interaction.response.defer(ephemeral=True)

app/tools.py

@@ -17,36 +17,37 @@ def ensure_file_exists(path):
 async def help(interaction: discord.Interaction):
     embed = discord.Embed(
         title="📜 Help - Liste des commandes",
-        description=f"Salut {interaction.user.mention} ! Voici les commandes que tu peux utiliser :",
+        description=f"Salut {interaction.user.mention} ! Voici les commandes disponibles :",
         color=EMBED_COLOR_RED
     )
 
-    embed.add_field(name="/ping", value="Répond avec Pong ! 🏓", inline=False)
-    embed.add_field(name="/say", value="Répète ton message 💬", inline=False)
-    embed.add_field(name="/salut", value="Salue quelqu’un 👋", inline=False)
-    embed.add_field(
-        name="/clear", value="Supprime des messages (admin uniquement) 🧹", inline=False)
-    embed.add_field(name="/pronos_qualifs",
-                    value="Enregistre ton pronostique pour les qualifications", inline=False)
-    embed.add_field(name="/pronos_course",
-                    value="Enregistre ton pronostique pour les qualifications", inline=False)
-    embed.add_field(name="/visualisation_pronos_course",
-                    value="Te montre ton pronostique actuel de course", inline=False)
-    embed.add_field(name="/visualisation_pronos_qualif",
-                    value="Te montre ton pronostique actuel de qualif", inline=False)
-    embed.add_field(name="/modify_course",
-                    value="Modifie ton pronostique pour la course", inline=False)
-    embed.add_field(name="/modify_qualif",
-                    value="Modifie ton pronostique pour la qualif", inline=False)
+    # Commandes utilisateurs
+    embed.add_field(name="/help", value="📖 Affiche cette liste d’aide", inline=False)
+    embed.add_field(name="/pronos_course", value="🏁 Enregistre ou modifie ton pronostic pour la **course**", inline=False)
+    embed.add_field(name="/pronos_qualif", value="⏱️ Enregistre ou modifie ton pronostic pour les **qualifications**", inline=False)
+    embed.add_field(name="/visualisation", value="🔍 Affiche tes pronos actuels", inline=False)
+    embed.add_field(name="/leaderboard", value="🏆 Affiche le classement général", inline=False)
+    embed.add_field(name="/presentation", value="🤖 Laisse le bot se présenter et choisis-lui un nom", inline=False)
+    embed.add_field(name="/rules", value="📏 Affiche le règlement d’utilisation du bot", inline=False)
+
+    # Commandes admin
+    embed.add_field(name="/clear", value="🧹 Supprime un nombre de messages (admin uniquement)", inline=False)
+    embed.add_field(name="/admin_ban", value="🔨 Bannir un membre avec raison et article (admin)", inline=False)
+    embed.add_field(name="/admin_open", value="🟢 Ouvre une session de pronos pour une durée définie (admin)", inline=False)
+    embed.add_field(name="/admin_close", value="🔴 Ferme la session de pronos en cours (admin)", inline=False)
+    embed.add_field(name="/admin_status", value="📊 Affiche le mode actuel du bot : manuel ou auto (admin)", inline=False)
+    embed.add_field(name="/admin_getresult", value="🔄 Met à jour les résultats via l’API (admin)", inline=False)
+    embed.add_field(name="/admin_stop", value="⛔ Stoppe le mode automatique du bot (admin)", inline=False)
+    embed.add_field(name="/admin_launch", value="🚀 Lance le mode automatique du bot (admin)", inline=False)
+    embed.add_field(name="/session", value="🗂️ Configure manuellement une session + update leaderboard (admin)", inline=False)
 
-    embed.set_footer(text=EMBED_FOOTER_TEXT, icon_url=EMBED_THUMBNAIL)
     embed.set_thumbnail(url=interaction.user.display_avatar.url)
+    embed.set_footer(text=EMBED_FOOTER_TEXT, icon_url=EMBED_THUMBNAIL)
     embed.set_image(url=EMBED_IMAGE)
 
     await interaction.response.send_message(embed=embed, ephemeral=True)
 
-    logger.info(
-        f"{interaction.user.name} à demander help dans le salon {interaction.channel.name}")
+    logger.info(f"{interaction.user.name} a demandé /help dans {interaction.channel.name}")
 
 
 async def clear_slash(interaction: discord.Interaction, nombre: int):

docs/source/commands.rst

@@ -6,27 +6,21 @@ General Commands
 
 .. code:: slash
 
-   /ping
-
-Replies with "🏓 Pong!". Used to check if the bot is online.
-
-.. code:: slash
-
-   /say message: str
+   /help
 
-Repeats the provided message. Very useful to make the bot speak.
+Displays the list of all available commands with explanations.
 
 .. code:: slash
 
-   /salut
+   /presentation
 
-Sends a personalized greeting to the user.
+Introduces the bot and lets users suggest a name in DM. These suggestions are saved in a file.
 
 .. code:: slash
 
-   /help
+   /rules
 
-Displays the list of available commands with a brief explanation.
+Displays the bot usage rules.
 
 Prediction Commands
 -------------------
@@ -35,79 +29,82 @@ Prediction Commands
 
    /pronos_course premier: str deuxieme: str troisieme: str best_lap: str
 
-Allows a user to register their predictions for an event. Can be modified only once.
+Submit or update your race predictions. Can be modified only once and only when a session is open.
+
+.. code:: slash
+
+   /pronos_qualif premier: str deuxieme: str troisieme: str
+
+Submit or update your qualifying predictions. Can be modified only once and only when a session is open.
 
 .. code:: slash
 
    /visualisation
 
-Displays the user’s previously recorded predictions.
+Displays your current predictions (both race and qualifying if available).
 
 .. code:: slash
 
    /leaderboard
 
-Shows the general leaderboard of users based on their prediction scores.
+Displays the general leaderboard based on prediction accuracy.
 
-Administration Commands
------------------------
+Admin Commands
+--------------
 
 .. code:: slash
 
    /clear nombre: int
 
-Deletes a given number of messages in a channel (admins only).
+Deletes a specified number of messages in a channel. Admin only.
 
 .. code:: slash
 
    /admin_ban member: @member reason: str article: str
 
-Bans a member from the server for a specified reason and article (moderators only).
+Bans a member for a specified reason and rule/article. Admin only.
 
 .. code:: slash
 
    /admin_open duration: float
 
-Opens a prediction session for a set duration (in hours). Works only in manual mode.
+Opens a prediction session manually for a specified duration (in hours). Manual mode only.
 
 .. code:: slash
 
    /admin_close
 
-Closes the prediction session manually.
+Closes the current prediction session manually. Manual mode only.
 
 .. code:: slash
 
    /admin_status
 
-Shows the current bot mode (auto or manual).
+Returns the current bot mode (manual or auto).
 
 .. code:: slash
 
    /admin_stop
 
-Disables automatic mode and switches back to manual.
+Stops automatic mode and reverts to manual mode. Admin only.
 
 .. code:: slash
 
    /admin_launch
 
-Starts automatic mode: the bot automatically opens prediction sessions based on the F1 calendar.
+Launches the bot in automatic mode: sessions will be opened and closed based on the F1 calendar.
 
 .. code:: slash
 
-   /session saison: int location: str type: str
-
-Manually configures a session (Q for qualifying, R for race). Updates the leaderboard.
+   /admin_getresult
 
-Special Commands
-----------------
+Manually fetches session results from the FastF1 API and updates the leaderboard.
 
 .. code:: slash
 
-   /presentation
+   /session saison: int location: str type: str
 
-Introduces the bot and allows users to propose a name via private message. These proposals are saved in a file.
+Manually configures a prediction session and updates the leaderboard (Q = qualifying, R = race).
 
 System Commands (non-slash)
 ---------------------------
@@ -116,11 +113,12 @@ System Commands (non-slash)
 
    !sync
 
-Command available only to administrators listed in `owners_id`. Synchronizes all slash commands with Discord.
+Command reserved to the developers (listed in `owners_id`). Syncs all slash commands with Discord.
 
 Notes
 -----
 
-- Administration commands require the corresponding permissions (ban, admin, etc.).
-- The prediction system uses both manual and automatic modes.
-- All logs and errors are properly handled within `try/except` blocks.
+- Admin commands require appropriate permissions (administrator, ban members, etc.).
+- The prediction system works in both **manual** and **automatic** mode.
+- All sessions are time-limited and controlled based on mode.
+- Errors are handled using proper `try/except` blocks, and logs are generated accordingly.