Only include the first line of descriptions in help pages (#117)

tanchan/_internal/localisation.py

@@ -129,16 +129,18 @@ def __init__(
 
             self._localise_id = f"{_TYPE_TO_STR[cmd_type]}:{name}:{field_type}"
 
-    def to_string(self) -> str:
+    def to_hashable(self) -> str:
         """Make a string representation of this localised value.
 
-        This is used for ensure synced states.
+        This is used for ensuring pagination states match.
         """
         if not self.localised_values:
-            return self.default_value
+            return self.default_value.split("\n", 1)[0]
 
         else:
-            return f"{self.default_value};{sorted(self.localised_values.items())!r}"
+            # Only care about the first line for pagination.
+            descriptions = [(key, value.split("\n", 1)[0]) for key, value in self.localised_values.items()]
+            return f"{self.default_value};{sorted(descriptions)!r}"
 
     def localise(self, locale: hikari.Locale, localiser: typing.Optional[tanjun.dependencies.AbstractLocaliser]) -> str:
         """Get the localised value for a context.

tanchan/components/help.py

@@ -237,11 +237,13 @@ def _localise(
         self, locale: typing.Optional[hikari.Locale], localiser: typing.Optional[tanjun.dependencies.AbstractLocaliser]
     ) -> tuple[str, str]:
         if locale is None:
-            description = "\n".join(f"{name}: {field.default_value}" for name, field in self._fields)
+            description = "\n".join(f"{name}: " + field.default_value.split("\n", 1)[0] for name, field in self._fields)
             title = f"{self._category_name.default_value} commands"
             return title, description
 
-        description = "\n".join(f"{name}: {field.localise(locale, localiser)}" for name, field in self._fields)
+        description = "\n".join(
+            f"{name}: " + field.localise(locale, localiser).split("\n", 1)[0] for name, field in self._fields
+        )
         title = self._category_name.localise(locale, localiser)
         return title, description
 
@@ -410,7 +412,7 @@ def reload(self, client: tanjun.abc.Client, help_config: config.HelpConfig, /) -
                 page_number += 1
                 pages.append(_Page(self, page_number, cateory, commands[10 * index : 10 * (index + 1)]))
 
-        items_repr = ((" ".join(k), v.to_string()) for k, v in descriptions.items())
+        items_repr = ((" ".join(k), v.to_hashable()) for k, v in descriptions.items())
         items_repr = ",".join(map(":".join, sorted(items_repr, key=lambda v: v[0]))).encode()
         self._descriptions = descriptions
         self._hash = "md5-" + hashlib.md5(items_repr, usedforsecurity=False).hexdigest()