Rubka 3.2.5__tar.gz → 3.3.4__tar.gz

{rubka-3.2.5 → rubka-3.3.4}/PKG-INFO

@@ -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 → rubka-3.3.4}/Rubka.egg-info/PKG-INFO

@@ -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 → rubka-3.3.4}/Rubka.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ Rubka.egg-info/requires.txt
 Rubka.egg-info/top_level.txt
 rubka/__init__.py
 rubka/api.py
+rubka/button.py
 rubka/config.py
 rubka/context.py
 rubka/decorators.py

{rubka-3.2.5 → rubka-3.3.4}/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-3.3.4/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-3.3.4/rubka/keypad.py

@@ -0,0 +1,298 @@
+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}
+
+from typing import List, Dict, Optional
+
+class ChatKeypadBuilder:
+    def __init__(self):
+        self.rows: List[Dict[str, List[Dict[str, str]]]] = []
+
+    def row(self, *buttons: Dict[str, str]) -> "ChatKeypadBuilder":
+        """
+        یک ردیف دکمه به کی‌پد اضافه می‌کند.
+        ورودی: چند دیکشنری که نماینده دکمه‌ها هستند.
+        """
+        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 build(
+        self,
+        resize_keyboard: bool = True,
+        on_time_keyboard: bool = False
+    ) -> Dict[str, object]:
+        """
+        ساختار نهایی chat_keypad را می‌سازد.
+        """
+        return {
+            "rows": self.rows,
+            "resize_keyboard": resize_keyboard,
+            "on_time_keyboard": on_time_keyboard
+        }

{rubka-3.2.5 → rubka-3.3.4}/setup.py

@@ -8,7 +8,7 @@ except FileNotFoundError:
 
 setup(
     name='Rubka',
-    version='3.2.5',
+    version='3.3.4',
     description='A Python library for interacting with Rubika Bot API.',
     long_description=long_description,
     long_description_content_type='text/markdown',

rubka-3.2.5/rubka/keypad.py

@@ -1,48 +0,0 @@
-from typing import Dict
-
-class InlineBuilder:
-    def __init__(self):
-        self.rows = []
-
-    def row(self, *buttons: Dict[str, str]):
-        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 build(self):
-        return {"rows": self.rows}
-from typing import List, Dict, Optional
-
-class ChatKeypadBuilder:
-    def __init__(self):
-        self.rows: List[Dict[str, List[Dict[str, str]]]] = []
-
-    def row(self, *buttons: Dict[str, str]) -> "ChatKeypadBuilder":
-        """
-        یک ردیف دکمه به کی‌پد اضافه می‌کند.
-        ورودی: چند دیکشنری که نماینده دکمه‌ها هستند.
-        """
-        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 build(
-        self,
-        resize_keyboard: bool = True,
-        on_time_keyboard: bool = False
-    ) -> Dict[str, object]:
-        """
-        ساختار نهایی chat_keypad را می‌سازد.
-        """
-        return {
-            "rows": self.rows,
-            "resize_keyboard": resize_keyboard,
-            "on_time_keyboard": on_time_keyboard
-        }