Bloatware is my passion.

Author: swyrin

nameless/custom/ui/__init__.py

@@ -1,4 +1,4 @@
 from .dropdown import *
 from .modal import *
-from .view import *
+from .paginated_view import *
 from .yes_no import *

nameless/custom/ui/dropdown/custom_dropdown.py nameless/custom/ui/dropdown.py

@@ -1,30 +1,32 @@
 import os
 from collections.abc import Callable
-from typing import override
+from typing import Self, override
 
 import discord
 from discord import ui
 
-__all__ = ["CustomDropdown"]
+__all__ = ["NamelessDropdown"]
 
 
-DropdownCallback = Callable[[discord.Interaction], str | None]
+_DropdownCallback = Callable[[discord.Interaction], str | None]
 """
 A callback for a dropdown.
 
 Parameters:
 -----------
-interaction: discord.Interaction
+interaction: `discord.Interaction`
     The interaction object.
 
 Returns:
 --------
-``str`` | ``None``
+`str` | `None`
     Return with a string to mark it as an error message, otherwise None.
 """
 
 
-class CustomDropdown(ui.Select[ui.View]):
+class NamelessDropdown(ui.Select[ui.View]):
+    """nameless* custom dropdown."""
+
     def __init__(
         self,
         custom_id: str | None = None,
@@ -33,7 +35,12 @@ def __init__(
         max_values: int = 1,
         disabled: bool = False,
     ):
-        self._callback: list[DropdownCallback] = []
+        assert min_values >= 1
+        assert max_values >= 1
+        assert min_values <= max_values
+
+        self._callback: list[_DropdownCallback] = []
+
         if custom_id is None:
             custom_id = "nameless-dropdown-" + os.urandom(16).hex()
 
@@ -46,7 +53,7 @@ def __init__(
             options=[],
         )
 
-    def add_callback(self, callback: DropdownCallback):
+    def push_callback(self, callback: _DropdownCallback) -> Self:
         self._callback.append(callback)
         return self
 
@@ -62,15 +69,15 @@ async def callback(self, interaction: discord.Interaction):
         if self.view is not None:
             self.view.stop()
 
-    def self_add_option(
+    def push_option(
         self,
         *,
         label: str,
         value: str = "",
         description: str | None = None,
         emoji: str | discord.Emoji | discord.PartialEmoji | None = None,
         default: bool = False,
-    ):
+    ) -> Self:
         self.add_option(
             label=label,
             value=value,

nameless/custom/ui/dropdown/__init__.py

@@ -1,4 +1,2 @@
-from .custom_input import CustomInput
-from .custom_modal import BaseCustomModal
-
-__all__ = ["CustomInput", "BaseCustomModal"]
+from .input import *
+from .modal import *

nameless/custom/ui/modal/__init__.py

@@ -5,8 +5,10 @@
 
 V = TypeVar("V", bound=type, covariant=True)
 
+__all__ = ["NamelessModalInput"]
 
-class CustomInput(ui.TextInput[ui.Modal], Generic[V]):
+
+class NamelessModalInput(ui.TextInput[ui.Modal], Generic[V]):
     def __init__(
         self, label: str, custom_id: str, default: str = "0", convert: V = str
     ):

nameless/custom/ui/modal/custom_input.py nameless/custom/ui/modal/input.py

@@ -1,13 +1,15 @@
-from typing import Generic, TypeVar, override
+from typing import Generic, TypeVar, cast, override
 
 import discord
 
-from nameless.custom.ui.modal.custom_input import CustomInput
+from nameless.custom.ui.modal.input import NamelessModalInput
 
 V = TypeVar("V", bound=type, covariant=True)
 
+__all__ = ["NamelessModal"]
 
-class BaseCustomModal(discord.ui.Modal, Generic[V]):
+
+class NamelessModal(discord.ui.Modal, Generic[V]):
     def __init__(self, title: str) -> None:
         super().__init__(timeout=30, title=title)
 
@@ -16,8 +18,8 @@ async def on_submit(self, interaction: discord.Interaction[discord.Client]) -> N
         await interaction.response.defer()
         self.stop()
 
-    def get_input(self) -> CustomInput[V]:
-        return self.children[0]  # pyright: ignore[reportReturnType]
+    def get_input(self) -> NamelessModalInput[V]:
+        return cast(NamelessModalInput[V], self.children[0])
 
     @property
     def value(self) -> V:

nameless/custom/ui/modal/custom_modal.py nameless/custom/ui/modal/modal.py

@@ -1,37 +1,106 @@
-# pyright: reportUnknownParameterType=false, reportMissingParameterType=false, reportUnknownArgumentType=false, reportUnknownMemberType=false
-from typing import override
+from collections.abc import Iterable
+from typing import Self, override
 
 import discord
-from discord import ui
-from discord.ui import Button
+from discord.ext.commands import Bot, Context
+from discord.ui import Button, Modal, TextInput
 
-from nameless.custom.ui.view.base import BaseView
+__all__ = ["NamelessPaginatedView"]
 
-__all__ = ["ViewButton"]
 
+class JumpToPageModal(Modal):
+    """Modal to ask for specific page."""
 
-class ToPageModal(discord.ui.Modal):
-    page: ui.TextInput[BaseView] = ui.TextInput(label="Page")
+    page: TextInput[Self] = TextInput(
+        label="Page number",
+        default="0",
+        placeholder="Any page number, will failsafe to '0' (zero).",
+    )
 
     @override
     async def on_submit(self, interaction: discord.Interaction) -> None:
         self.stop()
 
-    def get_values(self):
-        return self.page.value
+    def get_value(self) -> int:
+        """Get parsed page value. Will failsafe to 0."""
+        try:
+            return int(self.page.value)
+        except ValueError:
+            return 0
 
 
-class ViewButton(Button[BaseView]):
+class NamelessPaginatedView(discord.ui.View):
+    """nameless* custom paginated view."""
+
+    def __init__(self, ctx: Context[Bot], timeout: int = 60):
+        super().__init__(timeout=timeout)
+        self.ctx: Context[Bot] = ctx
+        self.pages: list[discord.Embed] = []
+        self.current_page: int = 0
+        self._current_message: discord.Message | None = None
+
+    @property
+    def message(self):
+        if not self._current_message:
+            return self.ctx.message
+
+        return self._current_message
+
+    @message.setter
+    def message(self, value: discord.Message):
+        self._current_message = value
+
+    def add_pages(self, pages: Iterable[discord.Embed]) -> None:
+        self.pages.extend(pages)
+
+    def add_button(self, button: Button[Self]):
+        self.add_item(button)
+
+    async def next_page(self):
+        if self.current_page + 1 >= len(self.pages):
+            self.current_page = 0
+        else:
+            self.current_page += 1
+        await self.message.edit(embed=self.pages[self.current_page], view=self)
+
+    async def previous_page(self):
+        if self.current_page - 1 < 0:
+            self.current_page = len(self.pages) - 1
+        else:
+            self.current_page -= 1
+        await self.message.edit(embed=self.pages[self.current_page], view=self)
+
+    async def go_to_first_page(self):
+        await self.message.edit(embed=self.pages[0], view=self)
+
+    async def go_to_last_page(self):
+        await self.message.edit(embed=self.pages[-1], view=self)
+
+    async def go_to_page(self, page: int):
+        self.current_page = page
+        await self.ctx.send(embed=self.pages[self.current_page], view=self)
+
+    async def start(self):
+        self.message = await self.ctx.send(embed=self.pages[0], view=self)
+        return await self.wait()
+
+    async def end(self):
+        self.stop()
+        # await self.__current_message.delete()
+        await self.message.edit(view=None)
+
+
+class NavigationButton(Button[NamelessPaginatedView]):
     NEXT_PAGE_ID: str = "0"
     PREVIOUS_PAGE_ID: str = "1"
     GO_TO_FIRST_PAGE_ID: str = "2"
     GO_TO_LAST_PAGE_ID: str = "3"
     GO_TO_PAGE_ID: str = "4"
     END_ID: str = "5"
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, *args: object, **kwargs: object):
         super().__init__(*args, **kwargs)
-        self._view: BaseView | None = None
+        self._view: NamelessPaginatedView | None = None
 
     @override
     async def callback(self, interaction: discord.Interaction):
@@ -49,7 +118,7 @@ async def callback(self, interaction: discord.Interaction):
             case self.GO_TO_LAST_PAGE_ID:
                 await self.view.go_to_last_page()
             case self.GO_TO_PAGE_ID:
-                modal = ToPageModal()
+                modal = JumpToPageModal()
                 await interaction.response.send_modal(modal)
                 if await modal.wait():
                     return
@@ -71,7 +140,7 @@ def create_button(
         with_label: bool,
         with_emote: bool,
         with_disabled: bool,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls(
             style=discord.ButtonStyle.gray,
@@ -88,7 +157,7 @@ def back(
         with_label: bool = False,
         with_emote: bool = True,
         with_disabled: bool = False,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls.create_button(
             "Back",
@@ -106,7 +175,7 @@ def next(
         with_label: bool = False,
         with_emote: bool = True,
         with_disabled: bool = False,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls.create_button(
             "Next",
@@ -124,7 +193,7 @@ def go_to_first_page(
         with_label: bool = False,
         with_emote: bool = True,
         with_disabled: bool = False,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls.create_button(
             "First Page",
@@ -142,7 +211,7 @@ def go_to_last_page(
         with_label: bool = False,
         with_emote: bool = True,
         with_disabled: bool = False,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls.create_button(
             "Last Page",
@@ -160,7 +229,7 @@ def go_to_page(
         with_label: bool = False,
         with_emote: bool = True,
         with_disabled: bool = False,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls.create_button(
             "Page Selection",
@@ -178,7 +247,7 @@ def end(
         with_label: bool = False,
         with_emote: bool = True,
         with_disabled: bool = False,
-        **kwargs,
+        **kwargs: object,
     ):
         return cls.create_button(
             "End", cls.END_ID, "⏹️", with_label, with_emote, with_disabled, **kwargs