PycordViews 1.2.7__py3-none-any.whl → 1.2.9__py3-none-any.whl

pycordViews/modal/__init__.py

@@ -0,0 +1,2 @@
+from .easy_modal_view import EasyModal
+from .errors import *

pycordViews/modal/easy_modal_view.py

@@ -0,0 +1,100 @@
+from discord.ui import Modal, InputText
+from discord import InputTextStyle, Interaction
+from typing import Optional, Callable, Union
+from functools import partial
+from asyncio import iscoroutinefunction
+
+from .errors import CoroutineError, CustomIDNotFound
+
+class EasyModal(Modal):
+
+    def __init__(self, title: str, custom_id: Optional[str] = None, timeout: Optional[float] = None, global_callable: Optional[Callable] = None):
+        """
+        Init EasyModal instance.
+        :param title: The title set to the Modal
+        :param custom_id: ID set to the Modal
+        :param timeout: Timeout before the view don't allow response.
+        :param global_callable: Asynchronous function called when user submit the modal. Called before all subcoroutine function set for each inputText. Get the instance modal and user interaction in parameters
+        """
+        super().__init__(title=title, custom_id=custom_id, timeout=timeout)
+
+        self.__callback: dict[str, Union[Callable, None]] = {}
+
+        if global_callable is not None and not iscoroutinefunction(global_callable):
+            raise CoroutineError(global_callable)
+
+        self.__global_callable: Optional[Callable] = global_callable
+
+    def add_input_text(self, label: str,
+                       style: InputTextStyle = InputTextStyle.short,
+                       custom_id: Optional[str] = None,
+                       placeholder: Optional[str] = None,
+                       min_length: Optional[int] = None,
+                       max_length: Optional[int] = None,
+                       required: Optional[bool] = True,
+                       value: Optional[str] = None,
+                       row: Optional[int] = None) -> Callable:
+        """
+        Add an input text on the Modal.
+        :return: set_inputText_callable function to set the callable on the inputText. Require an asynchronous function in parameters.
+        """
+
+        x = InputText(label=label, style=style, custom_id=custom_id, placeholder=placeholder, min_length=min_length, max_length=max_length, required=required, row=row, value=value)
+        self.__callback[x.custom_id] = None
+        self.add_item(x)
+        return partial(self.set_inputText_callable, x.custom_id)
+
+    def set_inputText_callable(self, inputText_id: str, _callable: Callable) -> "EasyModal":
+        """
+        Set an asynchronous function to a single inputText. _callable function was called when modal is completed by the user
+
+        x = EasyModal(title="test")
+        # init '8878' custom_id for one inputtext
+
+        x.set_inputText_callable(inputText_id='8878', _callable=set_any)
+
+        async def set_any(data: InputText, interaction: Interaction):
+                ...
+        """
+        if not iscoroutinefunction(_callable):
+            raise CoroutineError(_callable)
+
+        if inputText_id not in self.__callback.keys():
+            raise CustomIDNotFound(inputText_id)
+
+        self.__callback[inputText_id] = _callable
+        return self
+
+    def del_inputText_callable(self, inputText_id: str) -> "EasyModal":
+        """
+        Delete callable object link to the inputText ID
+        :param inputText_id: ID to the inputText
+        """
+        if inputText_id not in self.__callback.keys():
+            raise CustomIDNotFound(inputText_id)
+
+        self.__callback[inputText_id] = None
+
+    async def callback(self, interaction: Interaction):
+        """
+        Call when the user submit the modal.
+        All callable function set to the user get the 'interaction' parameter.
+        """
+
+        if self.__global_callable is not None:
+            await self.__global_callable(self, interaction)
+
+        for inputTextID, _callable in self.__callback.items():
+            if _callable is not None:
+                await _callable(self.get_input_text(inputTextID),interaction)
+
+    def get_input_text(self, inputText_id: str) -> InputText:
+        """
+        Return the inputText associated to the inputText_id
+        :param inputText_id: ID inputText
+        """
+        for i in self.children:
+            if i.custom_id == inputText_id:
+                return i
+
+        raise CustomIDNotFound(inputText_id)

pycordViews/modal/errors.py

@@ -0,0 +1,12 @@
+class ModalError(Exception):
+    pass
+
+
+class CustomIDNotFound(ModalError):
+    def __init__(self, customID: str):
+        super().__init__(f"'{customID}' ID not found !")
+
+
+class CoroutineError(ModalError):
+    def __init__(self, coro):
+        super().__init__(f"{coro} is not a coroutine !")

{pycordviews-1.2.7.dist-info → pycordviews-1.2.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PycordViews
-Version: 1.2.7
+Version: 1.2.9
 Summary: Views and multibot for py-cord library
 Home-page: https://github.com/BOXERRMD/Py-cord_Views
 Author: Chronos (alias BOXERRMD)

{pycordviews-1.2.7.dist-info → pycordviews-1.2.9.dist-info}/RECORD

@@ -6,6 +6,9 @@ pycordViews/menu/__init__.py,sha256=QUXA9ezyeTScvS1kxMNFgKEbZMsPq5yUnWWgbXCytCk,
 pycordViews/menu/errors.py,sha256=0Um-oH5qMdWSZB_bGlqILsf9WSDtC4n_HwkheekiMV4,480
 pycordViews/menu/menu.py,sha256=3D13C5Vs69w9SlrnixBfF0riY48jORi8JcYte65YFPs,4306
 pycordViews/menu/selectMenu.py,sha256=oYydLtoQm7YRjnFII2af5cUfIZ8ci_86lk0Il5TGYTw,10459
+pycordViews/modal/__init__.py,sha256=TFUX3z25oInBhBzoOQhnLbKmwArXo4IVVqBfN6y11Bo,61
+pycordViews/modal/easy_modal_view.py,sha256=n8shCQD5z1BQ7uv_sWvyk4hjZsX6l-VyN624GocWV0E,4277
+pycordViews/modal/errors.py,sha256=nIGYyOS_oWH49Dj8ZGW53nnzaPmbvFbAo7ydikD5xWE,307
 pycordViews/multibot/__init__.py,sha256=93Q_URiRUMsvwQJIqUnb75aq6SPM83yteSMrH0rmXMg,30
 pycordViews/multibot/bot.py,sha256=UrRqSSmtFpkQKAqeunHxIy_O5DgO1gcW-nMEQ9yNdAo,8267
 pycordViews/multibot/errors.py,sha256=_xawL8jQZTajx253F4JKywFGVPdYf8vTALOMiNqJ9hs,1176
@@ -18,8 +21,8 @@ pycordViews/pagination/pagination_view.py,sha256=T9kN_-hj2bD4ia4NI2CIkzJCgdp_6xx
 pycordViews/views/__init__.py,sha256=yligptZmw-np8tjKLr76SVmi0807Nk6jCyKkKYLhbCY,89
 pycordViews/views/easy_modified_view.py,sha256=EFtVQnbQTYkq-iF7Dzb4u1Libra8M22f-SkeiJsGulA,11005
 pycordViews/views/errors.py,sha256=AkhGskuBjbFs0ZQdTDlVyfvAJ1WRMMQx2sAXUnYjmog,360
-pycordviews-1.2.7.dist-info/licenses/LICENSE,sha256=lNgcw1_xb7QENAQi3uHGymaFtbs0RV-ihiCd7AoLQjA,1082
-pycordviews-1.2.7.dist-info/METADATA,sha256=5jOKpHM4hd2ceT5Mxmos_WuRaeHyozbOmiABdt3JUAU,11824
-pycordviews-1.2.7.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-pycordviews-1.2.7.dist-info/top_level.txt,sha256=HL_sar7xC3Ogx-qQF0r8mXhc3xwd5zXOGnUDkyuUrJw,107
-pycordviews-1.2.7.dist-info/RECORD,,
+pycordviews-1.2.9.dist-info/licenses/LICENSE,sha256=lNgcw1_xb7QENAQi3uHGymaFtbs0RV-ihiCd7AoLQjA,1082
+pycordviews-1.2.9.dist-info/METADATA,sha256=_bahF12GRtEKqlBvEja6sxlyL3-yD5-QqF61YlhGkgQ,11824
+pycordviews-1.2.9.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+pycordviews-1.2.9.dist-info/top_level.txt,sha256=3NvgH6MjESe7Q6jb6aqHgdYrYb5NhxwxnoDyE6PkThY,125
+pycordviews-1.2.9.dist-info/RECORD,,

{pycordviews-1.2.7.dist-info → pycordviews-1.2.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.0)
+Generator: setuptools (79.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{pycordviews-1.2.7.dist-info → pycordviews-1.2.9.dist-info}/top_level.txt

@@ -1,6 +1,7 @@
 pycordViews
 pycordViews/kit
 pycordViews/menu
+pycordViews/modal
 pycordViews/multibot
 pycordViews/pagination
 pycordViews/views