memory_views.py 13 KB

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