memory_views.py 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243
  1. """Affichage et modification des fichiers de mémoire sur Discord : /memoire et /memoire-serveur.
  2. Tout s'affiche dans des messages éphémères : seule la personne qui a lancé la commande les voit."""
  3. from __future__ import annotations
  4. import logging
  5. from collections.abc import Awaitable, Callable
  6. from dataclasses import dataclass
  7. import discord
  8. from .members import MemberRegistry, display_name
  9. from .memory import NOT_SAVED, SERVER_FILE, MemoryStore
  10. from .text_utils import split_message
  11. logger = logging.getLogger("chatbot.memory")
  12. # Longueur maximale d'une zone de texte dans une fenêtre Discord, et nombre maximal de zones.
  13. INPUT_MAX = 4000
  14. MAX_INPUTS = 5
  15. # Texte maximal d'un embed (4096 pour Discord), et de tous les embeds d'un message (6000).
  16. EMBED_MAX = 4000
  17. EMBEDS_TOTAL_MAX = 5500
  18. # Durée pendant laquelle les boutons répondent (ensuite, il suffit de relancer la commande).
  19. VIEW_TIMEOUT = 600
  20. # Sous la fiche d'un membre, quand il la consulte lui-même.
  21. ADMINS_NOTE = "Les administrateurs du serveur peuvent aussi voir et corriger ta fiche."
  22. Callback = Callable[[discord.Interaction], Awaitable[None]]
  23. async def see_user(registry: MemberRegistry, user: discord.User | discord.Member) -> None:
  24. """Ajoute un utilisateur Discord au registre, ou met ses noms à jour."""
  25. # En message privé, l'auteur n'est pas un membre du serveur : son pseudo n'est pas connu.
  26. in_guild = isinstance(user, discord.Member)
  27. await registry.see(user.id, user.name, user.global_name, user.nick if in_guild else None, in_guild=in_guild)
  28. @dataclass
  29. class Target:
  30. """Fichier affiché : la fiche d'un membre, ou le fichier général (member_id=None)."""
  31. file: str
  32. member_id: int | None
  33. name: str = "" # nom du membre
  34. is_self: bool = False # fiche de la personne qui a lancé la commande
  35. class MemoryCard:
  36. """Ce que voit la personne qui a lancé la commande : le fichier et les boutons pour le modifier."""
  37. def __init__(self, store: MemoryStore, target: Target, owner_id: int, bot_name: str):
  38. self.store = store
  39. self.target = target
  40. self.owner_id = owner_id
  41. self.bot_name = bot_name
  42. # ---------------------------------------------------------------- état
  43. @property
  44. def memory_enabled(self) -> bool:
  45. return self.target.member_id is None or self.store.members.memory_enabled(self.target.member_id)
  46. def about(self) -> str:
  47. """« sur toi », « sur Penta » ou « sur le serveur »."""
  48. if self.target.member_id is None:
  49. return "sur le serveur"
  50. return "sur toi" if self.target.is_self else f"sur {self.target.name}"
  51. # ----------------------------------------------------------- affichage
  52. def embeds(self) -> list[discord.Embed]:
  53. if self.target.member_id is None:
  54. title = "Fichier général du serveur"
  55. else:
  56. title = "Ta fiche mémoire" if self.target.is_self else f"Fiche mémoire de {self.target.name}"
  57. content = self.store.read(self.target.file)
  58. if not self.memory_enabled:
  59. who = "Tu as" if self.target.is_self else f"{self.target.name} a"
  60. text = (f"{who} désactivé la mémoire : {self.bot_name} ne retient rien "
  61. f"{self.about()} et ne voit aucune fiche dans ses messages.")
  62. return [discord.Embed(title=title, description=text, color=discord.Color.light_grey())]
  63. # Le membre doit savoir que sa fiche n'est pas vue par lui seul (voir /memoire membre:@…).
  64. admins = ADMINS_NOTE if self.target.member_id is not None and self.target.is_self else ""
  65. if not content:
  66. embed = discord.Embed(title=title, description=f"{self.bot_name} n'a encore rien retenu {self.about()}.",
  67. color=discord.Color.blurple())
  68. if admins:
  69. embed.set_footer(text=admins)
  70. return [embed]
  71. size = len(content)
  72. if size > EMBEDS_TOTAL_MAX: # seulement si MEMORY_*_LIMIT dépasse ce que Discord affiche
  73. content = content[:EMBEDS_TOTAL_MAX] + "\n[…] (la suite est visible dans « Modifier »)"
  74. embeds = [discord.Embed(description=chunk, color=discord.Color.blurple())
  75. for chunk in split_message(content, EMBED_MAX)]
  76. embeds[0].title = title
  77. footer = f"{size}/{self.store.limit(self.target.file)} caractères"
  78. embeds[-1].set_footer(text=f"{footer} · {admins}" if admins else footer)
  79. return embeds
  80. def view(self) -> discord.ui.View:
  81. view = OwnerView(self.owner_id)
  82. content = self.store.read(self.target.file)
  83. add_button(view, "Modifier", "✏️", discord.ButtonStyle.primary, self.edit, disabled=not self.memory_enabled)
  84. add_button(view, "Tout effacer" if self.target.member_id is None else "Effacer la fiche", "🗑️",
  85. discord.ButtonStyle.secondary, self.ask_erase, disabled=not content or not self.memory_enabled)
  86. # Seul le membre lui-même choisit d'activer ou non la mémoire.
  87. if self.target.member_id is not None and self.target.is_self:
  88. if self.memory_enabled:
  89. add_button(view, "Désactiver la mémoire", "🚫", discord.ButtonStyle.danger, self.ask_disable)
  90. else:
  91. add_button(view, "Réactiver la mémoire", "✅", discord.ButtonStyle.success, self.enable)
  92. return view
  93. async def send(self, interaction: discord.Interaction) -> None:
  94. await interaction.response.send_message(embeds=self.embeds(), view=self.view(), ephemeral=True)
  95. async def refresh(self, interaction: discord.Interaction, note: str | None = None) -> None:
  96. """Réaffiche le fichier à jour dans le même message, avec une courte phrase au-dessus."""
  97. await interaction.response.edit_message(content=note, embeds=self.embeds(), view=self.view())
  98. # -------------------------------------------------------------- actions
  99. async def edit(self, interaction: discord.Interaction) -> None:
  100. await interaction.response.send_modal(EditModal(self))
  101. async def save(self, interaction: discord.Interaction, text: str) -> None:
  102. """Enregistre le texte de la fenêtre « Modifier »."""
  103. error = await self.store.overwrite(self.target.file, text, by=str(interaction.user))
  104. if error:
  105. await interaction.response.send_message(error, ephemeral=True)
  106. return
  107. await self.refresh(interaction, "C'est enregistré." if text.strip() else "C'est effacé.")
  108. async def ask_erase(self, interaction: discord.Interaction) -> None:
  109. # Seule la fiche est effacée (pas le fichier général, ni la conversation) : la question ne promet pas plus.
  110. if self.target.member_id is None:
  111. question = "Effacer tout le fichier général du serveur ? C'est définitif."
  112. else:
  113. whose = "ta fiche" if self.target.is_self else f"la fiche de {self.target.name}"
  114. said = "tu as dit" if self.target.is_self else f"{self.target.name} a dit"
  115. question = (f"Effacer {whose} ? C'est définitif. Seule la fiche est effacée : ce que {said} "
  116. f"récemment reste dans la conversation, et {self.bot_name} peut encore s'en souvenir.")
  117. await confirm(interaction, self, question, self.erase)
  118. async def erase(self, interaction: discord.Interaction) -> None:
  119. error = await self.store.overwrite(self.target.file, "", by=str(interaction.user))
  120. await self.refresh(interaction, error or "C'est effacé.")
  121. async def ask_disable(self, interaction: discord.Interaction) -> None:
  122. question = (f"Si tu désactives la mémoire, ta fiche et les lignes du fichier général de "
  123. f"{self.bot_name} qui te citent seront définitivement effacées, et ton nom sera retiré "
  124. f"des sources (« d'après … ») dans les fiches des autres. {self.bot_name} ne notera plus "
  125. f"rien sur toi, mais ce que tu as dit récemment reste dans la conversation. "
  126. f"Tu pourras la réactiver plus tard avec /memoire.")
  127. await confirm(interaction, self, question, self.disable)
  128. async def disable(self, interaction: discord.Interaction) -> None:
  129. error = await self.store.forget(self.target.member_id, by=str(interaction.user))
  130. await self.refresh(interaction, error or "Mémoire désactivée : ta fiche et ce qui te citait dans le "
  131. "fichier général ont été effacés, et ton nom retiré des sources.")
  132. async def enable(self, interaction: discord.Interaction) -> None:
  133. saved = await self.store.members.set_memory(self.target.member_id, True)
  134. await self.refresh(interaction, "Mémoire réactivée." if saved else NOT_SAVED.format(setting="la réactivation"))
  135. class OwnerView(discord.ui.View):
  136. """Boutons réservés à la personne qui a lancé la commande."""
  137. def __init__(self, owner_id: int):
  138. super().__init__(timeout=VIEW_TIMEOUT)
  139. self.owner_id = owner_id
  140. async def interaction_check(self, interaction: discord.Interaction) -> bool:
  141. return interaction.user.id == self.owner_id
  142. def add_button(view: discord.ui.View, label: str, emoji: str, style: discord.ButtonStyle,
  143. callback: Callback, disabled: bool = False) -> None:
  144. button = discord.ui.Button(label=label, emoji=emoji, style=style, disabled=disabled)
  145. button.callback = callback
  146. view.add_item(button)
  147. async def confirm(interaction: discord.Interaction, card: MemoryCard, question: str, action: Callback) -> None:
  148. """Remplace le fichier affiché par une question, avec « Confirmer » et « Annuler »."""
  149. view = OwnerView(card.owner_id)
  150. add_button(view, "Confirmer", "⚠️", discord.ButtonStyle.danger, action)
  151. add_button(view, "Annuler", "↩️", discord.ButtonStyle.secondary, card.refresh)
  152. embed = discord.Embed(description=question, color=discord.Color.orange())
  153. await interaction.response.edit_message(content=None, embeds=[embed], view=view)
  154. class EditModal(discord.ui.Modal):
  155. """Fenêtre « Modifier » : le fichier, déjà rempli, dans une ou plusieurs zones de texte
  156. (une zone fait 4000 caractères au plus ; le fichier général peut en demander deux)."""
  157. def __init__(self, card: MemoryCard):
  158. title = "Modifier ta fiche" if card.target.is_self else (
  159. "Modifier le fichier général" if card.target.member_id is None else f"Fiche de {card.target.name}")
  160. super().__init__(title=title[:45], timeout=VIEW_TIMEOUT)
  161. self.card = card
  162. limit = card.store.limit(card.target.file)
  163. count = min(MAX_INPUTS, -(-limit // INPUT_MAX))
  164. parts = split_for_inputs(card.store.read(card.target.file), count)
  165. self.inputs = []
  166. for i in range(count):
  167. label = "Contenu" if count == 1 else f"Contenu ({i + 1}/{count})"
  168. text_input = discord.ui.TextInput(
  169. label=label, style=discord.TextStyle.paragraph, required=False,
  170. max_length=min(INPUT_MAX, limit), default=parts[i] or None,
  171. placeholder="Une information par ligne. Tout vider efface le fichier." if i == 0 else None,
  172. )
  173. self.inputs.append(text_input)
  174. self.add_item(text_input)
  175. async def on_submit(self, interaction: discord.Interaction) -> None:
  176. text = "\n".join(text_input.value.strip() for text_input in self.inputs if text_input.value.strip())
  177. await self.card.save(interaction, text)
  178. async def on_error(self, interaction: discord.Interaction, error: Exception) -> None:
  179. logger.exception("Erreur pendant la modification de %s", self.card.target.file, exc_info=error)
  180. if not interaction.response.is_done():
  181. await interaction.response.send_message("La modification a échoué, regarde les logs.", ephemeral=True)
  182. def split_for_inputs(text: str, count: int) -> list[str]:
  183. """Répartit un texte dans count zones de texte, de préférence entre les lignes."""
  184. parts = split_message(text, INPUT_MAX)
  185. if len(parts) > count: # lignes trop mal réparties : découpage exact
  186. parts = [text[i:i + INPUT_MAX] for i in range(0, len(text), INPUT_MAX)]
  187. return (parts + [""] * count)[:count]
  188. def member_target(store: MemoryStore, member: discord.User | discord.Member, owner_id: int) -> Target:
  189. entry = store.members.get(member.id)
  190. name = display_name(entry) if entry else member.display_name
  191. return Target(store.member_file(member.id), member.id, name, is_self=member.id == owner_id)
  192. def server_target() -> Target:
  193. return Target(SERVER_FILE, None)