Rubka 3.2.5__py3-none-any.whl → 3.3.4__py3-none-any.whl

rubka/api.py

@@ -222,9 +222,40 @@ class Robot:
 
         return self._post("sendMessage", payload)
 
-    def Get_Member_channel(self,object_guid: str, search_text: str = None, start_id: str = None, just_get_guids: bool = False):
-        getter = Client_get(show_last_six_words(self.token))
-        return getter.get_all_members(object_guid,search_text,start_id,just_get_guids)
+    def _get_client(self):
+        return Client_get(show_last_six_words(self.token))
+
+    def check_join(self, channel_guid: str, chat_id: str = None) -> bool | list[str]:
+        client = self._get_client()
+
+        if chat_id:
+            chat_info = self.get_chat(chat_id).get('data', {}).get('chat', {})
+            username = chat_info.get('username')
+            user_id = chat_info.get('user_id')
+
+            if username:
+                members = self.get_all_member(channel_guid, search_text=username).get('in_chat_members', [])
+                return any(m.get('username') == username for m in members)
+
+            elif user_id:
+                member_guids = client.get_all_members(channel_guid, just_get_guids=True)
+                return user_id in member_guids
+
+            return False
+
+        return False
+
+
+    def get_all_member(
+        self,
+        channel_guid: str,
+        search_text: str = None,
+        start_id: str = None,
+        just_get_guids: bool = False
+    ):
+        client = self._get_client()
+        return client.get_all_members(channel_guid, search_text, start_id, just_get_guids)
+
     def send_poll(
         self,
         chat_id: str,
@@ -373,3 +404,23 @@ class Robot:
             "chat_keypad_type": "New",
             "chat_keypad": chat_keypad
         })
+    def get_name(self, chat_id: str) -> str:
+        try:
+            chat = self.get_chat(chat_id)
+            chat_info = chat.get("data", {}).get("chat", {})
+            first_name = chat_info.get("first_name", "")
+            last_name = chat_info.get("last_name", "")
+            
+            if first_name and last_name:
+                return f"{first_name} {last_name}"
+            elif first_name:
+                return first_name
+            elif last_name:
+                return last_name
+            else:
+                return "Unknown"
+        except Exception:
+            return "Unknown"
+    def get_username(self, chat_id: str) -> str:
+        chat_info = self.get_chat(chat_id).get("data", {}).get("chat", {})
+        return chat_info.get("username", "None")

rubka/button.py

@@ -0,0 +1,264 @@
+from typing import Dict
+
+from typing import Dict, List, Optional, Union
+from typing import Dict, List, Optional
+
+class InlineBuilder:
+    def __init__(self):
+        self.rows: List[Dict] = []
+
+    def row(self, *buttons: Dict) -> "InlineBuilder":
+        """
+        افزودن یک ردیف دکمه به کیبورد
+        حداقل یک دکمه باید داده شود.
+        """
+        if not buttons:
+            raise ValueError("حداقل یک دکمه باید به row داده شود")
+        self.rows.append({"buttons": list(buttons)})
+        return self
+
+    def button_simple(self, id: str, text: str) -> Dict:
+        return {"id": id, "type": "Simple", "button_text": text}
+
+    def button_selection(self, id: str, text: str, selection: Dict) -> Dict:
+        """
+        selection: dict با فیلدهای:
+         - selection_id (str)
+         - search_type (str) [ButtonSelectionSearchEnum: None, Local, Api]
+         - get_type (str) [ButtonSelectionGetEnum: Local, Api]
+         - items (list of ButtonSelectionItem)
+         - is_multi_selection (bool)
+         - columns_count (str)
+         - title (str)
+        """
+        return {
+            "id": id,
+            "type": "Selection",
+            "button_text": text,
+            "button_selection": selection
+        }
+
+    def button_calendar(self, id: str, title: str, type_: str,
+                        default_value: Optional[str] = None,
+                        min_year: Optional[str] = None,
+                        max_year: Optional[str] = None) -> Dict:
+        """
+        type_: ButtonCalendarTypeEnum = "DatePersian" | "DateGregorian"
+        """
+        calendar = {
+            "title": title,
+            "type": type_,
+        }
+        if default_value:
+            calendar["default_value"] = default_value
+        if min_year:
+            calendar["min_year"] = min_year
+        if max_year:
+            calendar["max_year"] = max_year
+
+        return {
+            "id": id,
+            "type": "Calendar",
+            "button_text": title,
+            "button_calendar": calendar
+        }
+
+    def button_number_picker(self, id: str, title: str, min_value: str, max_value: str,
+                             default_value: Optional[str] = None) -> Dict:
+        picker = {
+            "title": title,
+            "min_value": min_value,
+            "max_value": max_value,
+        }
+        if default_value:
+            picker["default_value"] = default_value
+
+        return {
+            "id": id,
+            "type": "NumberPicker",
+            "button_text": title,
+            "button_number_picker": picker
+        }
+
+    def button_string_picker(self, id: str, title: Optional[str], items: List[str],
+                             default_value: Optional[str] = None) -> Dict:
+        picker = {
+            "items": items
+        }
+        if default_value:
+            picker["default_value"] = default_value
+        if title:
+            picker["title"] = title
+
+        return {
+            "id": id,
+            "type": "StringPicker",
+            "button_text": title if title else "انتخاب",
+            "button_string_picker": picker
+        }
+
+    def button_location(self, id: str, type_: str, location_image_url: str,
+                        default_pointer_location: Optional[Dict] = None,
+                        default_map_location: Optional[Dict] = None,
+                        title: Optional[str] = None) -> Dict:
+        """
+        type_: ButtonLocationTypeEnum = "Picker" | "View"
+        location_image_url: str آدرس عکس دکمه موقعیت
+        default_pointer_location و default_map_location هر کدام دیکشنری Location (latitude, longitude)
+        """
+        loc = {
+            "type": type_,
+            "location_image_url": location_image_url,
+        }
+        if default_pointer_location:
+            loc["default_pointer_location"] = default_pointer_location
+        if default_map_location:
+            loc["default_map_location"] = default_map_location
+        if title:
+            loc["title"] = title
+
+        return {
+            "id": id,
+            "type": "Location",
+            "button_text": title if title else "موقعیت مکانی",
+            "button_location": loc
+        }
+
+    def button_textbox(self, id: str, title: Optional[str], 
+                       type_line: str, type_keypad: str,
+                       place_holder: Optional[str] = None,
+                       default_value: Optional[str] = None) -> Dict:
+        """
+        type_line: ButtonTextboxTypeLineEnum = "SingleLine" | "MultiLine"
+        type_keypad: ButtonTextboxTypeKeypadEnum = "String" | "Number"
+        """
+        textbox = {
+            "type_line": type_line,
+            "type_keypad": type_keypad
+        }
+        if place_holder:
+            textbox["place_holder"] = place_holder
+        if default_value:
+            textbox["default_value"] = default_value
+        if title:
+            textbox["title"] = title
+
+        return {
+            "id": id,
+            "type": "Textbox",
+            "button_text": title if title else "متن",
+            "button_textbox": textbox
+        }
+
+    def button_payment(self, id: str, title: str, amount: int, description: Optional[str] = None) -> Dict:
+        """
+        نمونه‌ای ساده برای دکمه پرداخت (مقدار و توضیح دلخواه)
+        """
+        payment = {
+            "title": title,
+            "amount": amount
+        }
+        if description:
+            payment["description"] = description
+
+        return {
+            "id": id,
+            "type": "Payment",
+            "button_text": title,
+            "button_payment": payment
+        }
+
+    def button_camera_image(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "CameraImage",
+            "button_text": title
+        }
+
+    def button_camera_video(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "CameraVideo",
+            "button_text": title
+        }
+
+    def button_gallery_image(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "GalleryImage",
+            "button_text": title
+        }
+
+    def button_gallery_video(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "GalleryVideo",
+            "button_text": title
+        }
+
+    def button_file(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "File",
+            "button_text": title
+        }
+
+    def button_audio(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "Audio",
+            "button_text": title
+        }
+
+    def button_record_audio(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "RecordAudio",
+            "button_text": title
+        }
+
+    def button_my_phone_number(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "MyPhoneNumber",
+            "button_text": title
+        }
+
+    def button_my_location(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "MyLocation",
+            "button_text": title
+        }
+
+    def button_link(self, id: str, title: str, url: str) -> Dict:
+        return {
+            "id": id,
+            "type": "Link",
+            "button_text": title,
+            "url": url
+        }
+
+    def button_ask_my_phone_number(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "AskMyPhoneNumber",
+            "button_text": title
+        }
+
+    def button_ask_location(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "AskLocation",
+            "button_text": title
+        }
+
+    def button_barcode(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "Barcode",
+            "button_text": title
+        }
+
+    def build(self) -> Dict:
+        return {"rows": self.rows}

rubka/keypad.py

@@ -1,18 +1,268 @@
 from typing import Dict
 
+from typing import Dict, List, Optional, Union
+from typing import Dict, List, Optional
+
 class InlineBuilder:
     def __init__(self):
-        self.rows = []
+        self.rows: List[Dict] = []
 
-    def row(self, *buttons: Dict[str, str]):
+    def row(self, *buttons: Dict) -> "InlineBuilder":
+        """
+        افزودن یک ردیف دکمه به کیبورد
+        حداقل یک دکمه باید داده شود.
+        """
+        if not buttons:
+            raise ValueError("حداقل یک دکمه باید به row داده شود")
         self.rows.append({"buttons": list(buttons)})
         return self
 
-    def button(self, id: str, text: str, type: str = "Simple") -> Dict[str, str]:
-        return {"id": id, "type": type, "button_text": text}
+    def button_simple(self, id: str, text: str) -> Dict:
+        return {"id": id, "type": "Simple", "button_text": text}
+
+    def button_selection(self, id: str, text: str, selection: Dict) -> Dict:
+        """
+        selection: dict با فیلدهای:
+         - selection_id (str)
+         - search_type (str) [ButtonSelectionSearchEnum: None, Local, Api]
+         - get_type (str) [ButtonSelectionGetEnum: Local, Api]
+         - items (list of ButtonSelectionItem)
+         - is_multi_selection (bool)
+         - columns_count (str)
+         - title (str)
+        """
+        return {
+            "id": id,
+            "type": "Selection",
+            "button_text": text,
+            "button_selection": selection
+        }
+
+    def button_calendar(self, id: str, title: str, type_: str,
+                        default_value: Optional[str] = None,
+                        min_year: Optional[str] = None,
+                        max_year: Optional[str] = None) -> Dict:
+        """
+        type_: ButtonCalendarTypeEnum = "DatePersian" | "DateGregorian"
+        """
+        calendar = {
+            "title": title,
+            "type": type_,
+        }
+        if default_value:
+            calendar["default_value"] = default_value
+        if min_year:
+            calendar["min_year"] = min_year
+        if max_year:
+            calendar["max_year"] = max_year
+
+        return {
+            "id": id,
+            "type": "Calendar",
+            "button_text": title,
+            "button_calendar": calendar
+        }
+
+    def button_number_picker(self, id: str, title: str, min_value: str, max_value: str,
+                             default_value: Optional[str] = None) -> Dict:
+        picker = {
+            "title": title,
+            "min_value": min_value,
+            "max_value": max_value,
+        }
+        if default_value:
+            picker["default_value"] = default_value
+
+        return {
+            "id": id,
+            "type": "NumberPicker",
+            "button_text": title,
+            "button_number_picker": picker
+        }
+
+    def button_string_picker(self, id: str, title: Optional[str], items: List[str],
+                             default_value: Optional[str] = None) -> Dict:
+        picker = {
+            "items": items
+        }
+        if default_value:
+            picker["default_value"] = default_value
+        if title:
+            picker["title"] = title
+
+        return {
+            "id": id,
+            "type": "StringPicker",
+            "button_text": title if title else "انتخاب",
+            "button_string_picker": picker
+        }
+
+    def button_location(self, id: str, type_: str, location_image_url: str,
+                        default_pointer_location: Optional[Dict] = None,
+                        default_map_location: Optional[Dict] = None,
+                        title: Optional[str] = None) -> Dict:
+        """
+        type_: ButtonLocationTypeEnum = "Picker" | "View"
+        location_image_url: str آدرس عکس دکمه موقعیت
+        default_pointer_location و default_map_location هر کدام دیکشنری Location (latitude, longitude)
+        """
+        loc = {
+            "type": type_,
+            "location_image_url": location_image_url,
+        }
+        if default_pointer_location:
+            loc["default_pointer_location"] = default_pointer_location
+        if default_map_location:
+            loc["default_map_location"] = default_map_location
+        if title:
+            loc["title"] = title
+
+        return {
+            "id": id,
+            "type": "Location",
+            "button_text": title if title else "موقعیت مکانی",
+            "button_location": loc
+        }
+
+    def button_textbox(self, id: str, title: Optional[str], 
+                       type_line: str, type_keypad: str,
+                       place_holder: Optional[str] = None,
+                       default_value: Optional[str] = None) -> Dict:
+        """
+        type_line: ButtonTextboxTypeLineEnum = "SingleLine" | "MultiLine"
+        type_keypad: ButtonTextboxTypeKeypadEnum = "String" | "Number"
+        """
+        textbox = {
+            "type_line": type_line,
+            "type_keypad": type_keypad
+        }
+        if place_holder:
+            textbox["place_holder"] = place_holder
+        if default_value:
+            textbox["default_value"] = default_value
+        if title:
+            textbox["title"] = title
+
+        return {
+            "id": id,
+            "type": "Textbox",
+            "button_text": title if title else "متن",
+            "button_textbox": textbox
+        }
+
+    def button_payment(self, id: str, title: str, amount: int, description: Optional[str] = None) -> Dict:
+        """
+        نمونه‌ای ساده برای دکمه پرداخت (مقدار و توضیح دلخواه)
+        """
+        payment = {
+            "title": title,
+            "amount": amount
+        }
+        if description:
+            payment["description"] = description
+
+        return {
+            "id": id,
+            "type": "Payment",
+            "button_text": title,
+            "button_payment": payment
+        }
+
+    def button_camera_image(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "CameraImage",
+            "button_text": title
+        }
+
+    def button_camera_video(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "CameraVideo",
+            "button_text": title
+        }
+
+    def button_gallery_image(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "GalleryImage",
+            "button_text": title
+        }
+
+    def button_gallery_video(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "GalleryVideo",
+            "button_text": title
+        }
+
+    def button_file(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "File",
+            "button_text": title
+        }
+
+    def button_audio(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "Audio",
+            "button_text": title
+        }
 
-    def build(self):
+    def button_record_audio(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "RecordAudio",
+            "button_text": title
+        }
+
+    def button_my_phone_number(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "MyPhoneNumber",
+            "button_text": title
+        }
+
+    def button_my_location(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "MyLocation",
+            "button_text": title
+        }
+
+    def button_link(self, id: str, title: str, url: str) -> Dict:
+        return {
+            "id": id,
+            "type": "Link",
+            "button_text": title,
+            "url": url
+        }
+
+    def button_ask_my_phone_number(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "AskMyPhoneNumber",
+            "button_text": title
+        }
+
+    def button_ask_location(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "AskLocation",
+            "button_text": title
+        }
+
+    def button_barcode(self, id: str, title: str) -> Dict:
+        return {
+            "id": id,
+            "type": "Barcode",
+            "button_text": title
+        }
+
+    def build(self) -> Dict:
         return {"rows": self.rows}
+
 from typing import List, Dict, Optional
 
 class ChatKeypadBuilder:

{rubka-3.2.5.dist-info → rubka-3.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Rubka
-Version: 3.2.5
+Version: 3.3.4
 Summary: A Python library for interacting with Rubika Bot API.
 Home-page: https://github.com/Mahdy-Ahmadi/Rubka
 Download-URL: https://github.com/Mahdy-Ahmadi/Rubka/archive/refs/tags/v0.1.0.tar.gz

{rubka-3.2.5.dist-info → rubka-3.3.4.dist-info}/RECORD

@@ -1,12 +1,13 @@
 rubka/__init__.py,sha256=3f4H6Uj1ylrfBYlTHmTvzZSvaPJsdNhCocyX3Bbvuv0,254
-rubka/api.py,sha256=rAVyt11qzPb3gvz0ouuBlTASC_LrEaUGb9Em-G3XLfE,13805
+rubka/api.py,sha256=C1LImvk-0SWhU8g1Lhs_9h-gD_mbWVAjNuZoCQ9duhg,15489
+rubka/button.py,sha256=4fMSZR7vUADxSmw1R3_pZ4dw5uMLZX5sOkwPPyNTBDE,8437
 rubka/config.py,sha256=Bck59xkOiqioLv0GkQ1qPGnBXVctz1hKk6LT4h2EPx0,78
 rubka/context.py,sha256=5OMFjcnMWvkn3ZigRgJrjMiFt_tYgMwzHsTS6qXMGj8,12843
 rubka/decorators.py,sha256=hGwUoE4q2ImrunJIGJ_kzGYYxQf1ueE0isadqraKEts,1157
 rubka/exceptions.py,sha256=tujZt1XrhWaw-lmdeVadVceUptpw4XzNgE44sAAY0gs,90
 rubka/jobs.py,sha256=GvLMLsVhcSEzRTgkvnPISPEBN71suW2xXI0hUaUZPTo,378
 rubka/keyboards.py,sha256=7nr-dT2bQJVQnQ6RMWPTSjML6EEk6dsBx-4d8pab8xk,488
-rubka/keypad.py,sha256=FHe0xVYhOXMdHZhbGKHsRxtsRB27qZv0DvNfb8NkNwI,1545
+rubka/keypad.py,sha256=yGsNt8W5HtUFBzVF1m_p7GySlu1hwIcSvXZ4BTdrlvg,9558
 rubka/logger.py,sha256=J2I6NiK1z32lrAzC4H1Et6WPMBXxXGCVUsW4jgcAofs,289
 rubka/utils.py,sha256=XUQUZxQt9J2f0X5hmAH_MH1kibTAfdT1T4AaBkBhBBs,148
 rubka/adaptorrubka/__init__.py,sha256=6o2tCXnVeES7nx-LjnzsuMqjKcWIm9qwKficLE54s-U,83
@@ -30,7 +31,7 @@ rubka/adaptorrubka/types/socket/message.py,sha256=0WgLMZh4eow8Zn7AiSX4C3GZjQTkIg
 rubka/adaptorrubka/utils/__init__.py,sha256=OgCFkXdNFh379quNwIVOAWY2NP5cIOxU5gDRRALTk4o,54
 rubka/adaptorrubka/utils/configs.py,sha256=nMUEOJh1NqDJsf9W9PurkN_DLYjO6kKPMm923i4Jj_A,492
 rubka/adaptorrubka/utils/utils.py,sha256=5-LioLNYX_TIbQGDeT50j7Sg9nAWH2LJUUs-iEXpsUY,8816
-rubka-3.2.5.dist-info/METADATA,sha256=z_2CQsabaLqFe4s7pQ-tj8AxeEI8j48LUvzcWPqoWfE,8168
-rubka-3.2.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rubka-3.2.5.dist-info/top_level.txt,sha256=vy2A4lot11cRMdQS-F4HDCIXL3JK8RKfu7HMDkezJW4,6
-rubka-3.2.5.dist-info/RECORD,,
+rubka-3.3.4.dist-info/METADATA,sha256=tN6zlYf45FxI_wpHNI7IITcOs0CRZPTR5fNdiyXYIpY,8168
+rubka-3.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rubka-3.3.4.dist-info/top_level.txt,sha256=vy2A4lot11cRMdQS-F4HDCIXL3JK8RKfu7HMDkezJW4,6
+rubka-3.3.4.dist-info/RECORD,,