1
0

memory_views.py 11 KB

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