RubigramClient 1.7.17__py3-none-any.whl

rubigram/types/buttons/button.py

@@ -0,0 +1,59 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional, Union
+from dataclasses import dataclass
+from ..config import Object
+import rubigram
+
+
+@dataclass
+class Button(Object):
+    """
+    **Represents a generic interactive button in a chat keypad.**
+        `from rubigram.types import Button`
+
+    Attributes:
+        id (`str`):
+            Unique identifier of the button.
+
+        button_text (`str`):
+            Text displayed on the button.
+
+        type (`Optional[Union[str, rubigram.enums.ButtonType]]`):
+            Type of the button.
+
+        button_selection (`Optional[rubigram.types.ButtonSelection]`):
+            Selection-type button.
+
+        button_calendar (`Optional[rubigram.types.ButtonCalendar]`):
+            Calendar-type button.
+
+        button_number_picker (`Optional[rubigram.types.ButtonNumberPicker]`):
+            Number-picker button.
+
+        button_string_picker (`Optional[rubigram.types.ButtonStringPicker]`):
+            String-picker button.
+
+        button_location (`Optional[rubigram.types.ButtonLocation]`):
+            Location picker button.
+
+        button_textbox (`Optional[rubigram.types.ButtonTextbox]`):
+            Textbox input button.
+
+        button_link (`Optional[rubigram.types.ButtonLink]`):
+            Link-type button.
+    """
+    id: str
+    button_text: str
+    type: Optional[Union[str, rubigram.enums.ButtonType]] = rubigram.enums.ButtonType.SIMPLE
+    button_selection: Optional[rubigram.types.ButtonSelection] = None
+    button_calendar: Optional[rubigram.types.ButtonCalendar] = None
+    button_number_picker: Optional[rubigram.types.ButtonNumberPicker] = None
+    button_string_picker: Optional[rubigram.types.ButtonStringPicker] = None
+    button_location: Optional[rubigram.types.ButtonLocation] = None
+    button_textbox: Optional[rubigram.types.ButtonTextbox] = None

rubigram/types/buttons/button_calendar.py

@@ -0,0 +1,40 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional, Union
+from dataclasses import dataclass
+from ..config import Object
+import rubigram
+
+
+@dataclass
+class ButtonCalendar(Object):
+    """
+    **Represents a calendar picker button.**
+        `from rubigram.types import ButtonCalendar`
+
+    Attributes:
+        default_value (`Optional[str]`):
+            The default selected date.
+
+        type (`Optional[Union[str, rubigram.enums.ButtonCalendarType]]`):
+            Type of calendar picker.
+
+        min_year (`Optional[str]`):
+            Minimum selectable year.
+
+        max_year (`Optional[str]`):
+            Maximum selectable year.
+
+        title (`Optional[str]`):
+            Title of the calendar picker.
+    """
+    default_value: Optional[str] = None
+    type: Optional[Union[str, rubigram.enums.ButtonCalendarType]] = None
+    min_year: Optional[str] = None
+    max_year: Optional[str] = None
+    title: Optional[str] = None

rubigram/types/buttons/button_location.py

@@ -0,0 +1,40 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional, Union
+from dataclasses import dataclass
+from ..config import Object
+import rubigram
+
+
+@dataclass
+class ButtonLocation(Object):
+    """
+    **Represents a location picker button.**
+        `from rubigram.types import ButtonLocation`
+
+    Attributes:
+        default_pointer_location (`Optional[rubigram.types.Location]`):
+            Default pointer location.
+
+        default_map_location (`Optional[rubigram.types.Location]`):
+            Default map location.
+
+        type (`Optional[Union[str, rubigram.enums.ButtonLocationType]]`):
+            Type of location picker.
+
+        title (`Optional[str]`):
+            Title of the location picker.
+
+        location_image_url (`Optional[str]`):
+            Optional image URL for the location.
+    """
+    default_pointer_location: Optional[rubigram.types.Location] = None
+    default_map_location: Optional[rubigram.types.Location] = None
+    type: Optional[Union[str, rubigram.enums.ButtonLocationType]] = None
+    title: Optional[str] = None
+    location_image_url: Optional[str] = None

rubigram/types/buttons/button_number_picker.py

@@ -0,0 +1,34 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from typing import Optional
+from dataclasses import dataclass
+from ..config import Object
+
+
+@dataclass
+class ButtonNumberPicker(Object):
+    """
+    **Represents a number picker button.**
+        `from rubigram.types import ButtonNumberPicker`
+
+    Attributes:
+        min_value (`Optional[str]`):
+            Minimum selectable number.
+
+        max_value (`Optional[str]`):
+            Maximum selectable number.
+
+        default_value (`Optional[str]`):
+            Default selected number.
+
+        title (`Optional[str]`):
+            Title of the number picker.
+    """
+
+    min_value: Optional[str] = None
+    max_value: Optional[str] = None
+    default_value: Optional[str] = None
+    title: Optional[str] = None

rubigram/types/buttons/button_selection.py

@@ -0,0 +1,48 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional
+from dataclasses import dataclass
+from ..config import Object
+import rubigram
+
+
+@dataclass
+class ButtonSelection(Object):
+    """
+    **Represents a selection of multiple items that can be shown in a button.**
+        `from rubigram.types import ButtonSelection`
+
+    Attributes:
+        selection_id (`Optional[str]`):
+            Unique identifier for this selection.
+
+        search_type (`Optional[str]`):
+            Type of search to filter items.
+
+        get_type (`Optional[str]`):
+            Type of retrieval for items.
+
+        items (`Optional[list[rubigram.types.ButtonSelectionItem]]`):
+            List of items in the selection.
+
+        is_multi_selection (`Optional[bool]`):
+            Whether multiple items can be selected.
+
+        columns_count (`Optional[str]`):
+            Number of columns to display items in.
+
+        title (`Optional[str]`):
+            Title displayed above the selection.
+    """
+    selection_id: Optional[str] = None
+    search_type: Optional[str] = None
+    get_type: Optional[str] = None
+    items: Optional[list[rubigram.types.ButtonSelectionItem]] = None
+    is_multi_selection: Optional[bool] = None
+    columns_count: Optional[str] = None
+    title: Optional[str] = None

rubigram/types/buttons/button_selection_item.py

@@ -0,0 +1,32 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional, Union
+from dataclasses import dataclass
+from ..config import Object
+import rubigram
+
+
+@dataclass
+class ButtonSelectionItem(Object):
+    """
+    **Represents an individual selectable item in a ButtonSelection.**
+        `from rubigram.types import ButtonSelectionItem`
+
+    Attributes:
+        text (`Optional[str]`):
+            The display text of the item.
+
+        image_url (`Optional[str]`):
+            Optional URL for an image representing the item.
+
+        type (`Optional[Union[str, rubigram.enums.ButtonSelectionType]]`):
+            Type of selection item.
+    """
+    text: Optional[str] = None
+    image_url: Optional[str] = None
+    type: Optional[Union[str, rubigram.enums.ButtonSelectionType]] = None

rubigram/types/buttons/button_string_picker.py

@@ -0,0 +1,29 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from typing import Optional
+from dataclasses import dataclass
+from ..config import Object
+
+
+@dataclass
+class ButtonStringPicker(Object):
+    """
+    **Represents a string picker button.**
+        `from rubigram.types import ButtonStringPicker`
+
+    Attributes:
+        items (`Optional[list[str]]`):
+            List of string options to select from.
+
+        default_value (`Optional[str]`):
+            Default selected string.
+
+        title (`Optional[str]`):
+            Title of the string picker.
+    """
+    items: Optional[list[str]] = None
+    default_value: Optional[str] = None
+    title: Optional[str] = None

rubigram/types/buttons/button_text_box.py

@@ -0,0 +1,40 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional, Union
+from dataclasses import dataclass
+from ..config import Object
+import rubigram
+
+
+@dataclass
+class ButtonTextbox(Object):
+    """
+    **Represents a textbox input button.**
+        `from rubigram.types import ButtonTextbox`
+
+    Attributes:
+        type_line (`Optional[Union[str, rubigram.enums.ButtonTextboxTypeLine]]`):
+            Line type for the textbox.
+
+        type_keypad (`Optional[Union[str, rubigram.enums.ButtonTextboxTypeKeypad]]`):
+            Keypad type for the textbox.
+
+        place_holder (`Optional[str]`):
+            Placeholder text.
+
+        title (`Optional[str]`):
+            Title of the textbox.
+
+        default_value (`Optional[str]`):
+            Default text in the textbox.
+    """
+    type_line: Optional[Union[str, rubigram.enums.ButtonTextboxTypeLine]] = None
+    type_keypad: Optional[Union[str, rubigram.enums.ButtonTextboxTypeKeypad]] = None
+    place_holder: Optional[str] = None
+    title: Optional[str] = None
+    default_value: Optional[str] = None

rubigram/types/chat.py

@@ -0,0 +1,86 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from __future__ import annotations
+
+from typing import Optional, Union
+from dataclasses import dataclass
+from .config import Object
+import rubigram
+
+
+@dataclass
+class Chat(Object):
+    """
+    **Represents a chat entity in Rubigram.**
+        `from rubigram.types import Chat`
+
+    This object can represent different types of chats such as private, group, or channel.
+    It contains identifying and descriptive information about the chat, including user
+    details for private chats and titles for groups/channels.
+
+    Attributes:
+        chat_id (`str`):
+            Unique identifier for the chat.
+
+        chat_type (`rubigram.enums.ChatType`):
+            Type of chat (e.g., User, Group, Channel).
+
+        user_id (`str`):
+            The user ID of the chat owner (for private chats).
+
+        first_name (`Optional[str]`):
+            First name of the user (if applicable).
+
+        last_name (`Optional[str]`):
+            Last name of the user (if applicable).
+
+        title (`Optional[str]`):
+            Title of the chat (for groups and channels).
+
+        username (`Optional[str]`):
+            Username of the chat or user (if available).
+
+        full_name (`Optional[str]`):
+            Full name of the user.
+    """
+
+    chat_id: str
+    chat_type: Union[str, rubigram.enums.ChatType]
+    user_id: str
+    first_name: Optional[str] = None
+    last_name: Optional[str] = None
+    title: Optional[str] = None
+    username: Optional[str] = None
+
+    @property
+    def full_name(self) -> str:
+        """
+        Return the full name of the user (first + last).
+
+        Combines `first_name` and `last_name` with a space. If one of them
+        is missing, it returns only the available name. Returns an empty
+        string if both are None.
+
+        Returns:
+            str: Full name of the user.
+        """
+        first = self.first_name or ""
+        last = self.last_name or ""
+        return (first + " " + last).strip()
+
+    def as_dict(self) -> dict:
+        """
+        Convert this Chat object into a dictionary representation.
+
+        Extends the base Object.as_dict() method to include the `full_name`
+        property in the dictionary output.
+
+        Returns:
+            dict: Dictionary containing all chat attributes, including `full_name`.
+        """
+        data = super().as_dict()
+        data["full_name"] = self.full_name
+        return data

rubigram/types/config/__init__.py

@@ -0,0 +1,6 @@
+#  RubigramClient - Rubika API library for python
+#  Copyright (C) 2025-present Javad <https://github.com/DevJavad>
+#  Github - https://github.com/DevJavad/rubigram
+
+
+from .object import Object