gitbin-bot 1.0.0__tar.gz

gitbin_bot-1.0.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 MMD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

gitbin_bot-1.0.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: gitbin-bot
+Version: 1.0.0
+Summary: کتابخانه پایتون برای GitBin Bot API
+Author-email: MMD <ammmd219@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MMD-C0DE/gitbin-bot
+Project-URL: Documentation, https://github.com/MMD-C0DE/gitbin-bot#readme
+Project-URL: Issues, https://github.com/MMD-C0DE/gitbin-bot/issues
+Keywords: gitbin,bot,api,telegram,messenger
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+# gitbin-bot
+
+کتابخانه پایتون برای GitBin Bot API.
+
+## نصب
+
+```bash
+pip install gitbin-bot
+```
+
+## استفاده
+
+```python
+from gitbin import Bot
+
+bot = Bot(token="YOUR_TOKEN")
+
+# اطلاعات ربات
+me = bot.get_me()
+print(me["first_name"])
+
+# ارسال پیام
+bot.send_message(chat_id=123, text="سلام 👋")
+
+# موجودی استارز
+bal = bot.get_my_star_balance()
+print(f"{bal['amount']:,} استارز")
+```
+
+## متدهای موجود
+
+getMe, getUpdates, sendMessage, sendPhoto, sendDocument, sendVideo, sendAudio, sendVoice, sendAnimation, sendVideoNote, sendSticker, sendDice, sendLocation, sendVenue, sendContact, editMessageText, deleteMessage, answerCallbackQuery, banChatMember, unbanChatMember, restrictChatMember, promoteChatMember, pinChatMessage, unpinChatMessage, getChatAdministrators, getChatMember, setMyCommands, getMyCommands, setChatMenuButton, getChatMenuButton, getFile, setWebhook, deleteWebhook, getWebhookInfo, getMyStarBalance, transferStars, sendGift, giftPremiumSubscription, getAvailableGifts, refundStarPayment, sendInvoice, answerPreCheckoutQuery, answerShippingQuery, answerWebAppQuery, savePreparedInlineMessage, setUserEmojiStatus
+
+**جمعاً ۴۵ متد.**
+
+## لایسنس
+
+MIT

gitbin_bot-1.0.0/README.md

@@ -0,0 +1,38 @@
+# gitbin-bot
+
+کتابخانه پایتون برای GitBin Bot API.
+
+## نصب
+
+```bash
+pip install gitbin-bot
+```
+
+## استفاده
+
+```python
+from gitbin import Bot
+
+bot = Bot(token="YOUR_TOKEN")
+
+# اطلاعات ربات
+me = bot.get_me()
+print(me["first_name"])
+
+# ارسال پیام
+bot.send_message(chat_id=123, text="سلام 👋")
+
+# موجودی استارز
+bal = bot.get_my_star_balance()
+print(f"{bal['amount']:,} استارز")
+```
+
+## متدهای موجود
+
+getMe, getUpdates, sendMessage, sendPhoto, sendDocument, sendVideo, sendAudio, sendVoice, sendAnimation, sendVideoNote, sendSticker, sendDice, sendLocation, sendVenue, sendContact, editMessageText, deleteMessage, answerCallbackQuery, banChatMember, unbanChatMember, restrictChatMember, promoteChatMember, pinChatMessage, unpinChatMessage, getChatAdministrators, getChatMember, setMyCommands, getMyCommands, setChatMenuButton, getChatMenuButton, getFile, setWebhook, deleteWebhook, getWebhookInfo, getMyStarBalance, transferStars, sendGift, giftPremiumSubscription, getAvailableGifts, refundStarPayment, sendInvoice, answerPreCheckoutQuery, answerShippingQuery, answerWebAppQuery, savePreparedInlineMessage, setUserEmojiStatus
+
+**جمعاً ۴۵ متد.**
+
+## لایسنس
+
+MIT

gitbin_bot-1.0.0/gitbin/__init__.py

@@ -0,0 +1,20 @@
+"""کتابخانه گیت‌بین — Bot API"""
+from .client import GitbinClient
+from .methods import BotMethods
+from .errors import GitbinError
+
+
+class Bot(GitbinClient, BotMethods):
+    """
+    کلاس اصلی — همه ۴۵ متد + ارتباط با API
+
+    مثال:
+        from gitbin import Bot
+        bot = Bot(token="1780243415:K0WZ...")
+        bot.send_message(chat_id=123, text="سلام")
+    """
+    pass
+
+
+__all__ = ["Bot", "GitbinError"]
+__version__ = "1.0.0"

gitbin_bot-1.0.0/gitbin/client.py

@@ -0,0 +1,72 @@
+"""کلاینت پایه — ارتباط با سرور گیت‌بین"""
+import json
+import requests
+from .errors import raise_from_response, GitbinError
+
+
+class GitbinClient:
+    def __init__(self, token: str, base_url: str = "https://api.gitbin.site", timeout: int = 40):
+        """
+        token: توکن ربات (مثل 1780243415:K0WZ...)
+        base_url: آدرس سرور (پیش‌فرض api.gitbin.site)
+        timeout: ثانیه صبر برای پاسخ
+        """
+        self.token = token
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.session = requests.Session()
+
+    # ─────────────────────────────────────────
+    # هسته: ارسال درخواست
+    # ─────────────────────────────────────────
+    def _call(self, method: str, **params):
+        """
+        متد رو صدا بزن. params می‌تونه هر پارامتری باشه.
+        برمی‌گردونه: result (بدون ok)
+        خطا: GitbinError raise می‌کنه
+        """
+        url = f"{self.base_url}/bot{self.token}/{method}"
+
+        # پاک‌سازی: حذف Noneها و تبدیل bool/dict/list به رشته
+        clean = {}
+        for k, v in params.items():
+            if v is None:
+                continue
+            if isinstance(v, bool):
+                clean[k] = "true" if v else "false"
+            elif isinstance(v, (dict, list)):
+                clean[k] = json.dumps(v, ensure_ascii=False)
+            else:
+                clean[k] = v
+
+        try:
+            r = self.session.post(url, data=clean, timeout=self.timeout)
+        except requests.RequestException as exc:
+            raise GitbinError(0, f"CONNECTION_ERROR: {exc}", method)
+
+        # پاسخ JSON
+        try:
+            data = r.json()
+        except ValueError:
+            raise GitbinError(r.status_code, f"BAD_JSON: {r.text[:200]}", method)
+
+        # خطای API
+        if not data.get("ok"):
+            raise_from_response(data, method)
+
+        return data.get("result")
+
+    # ─────────────────────────────────────────
+    # میان‌بر برای GET (بعضی متدها فقط GET قبول می‌کنن)
+    # ─────────────────────────────────────────
+    def _call_get(self, method: str, **params):
+        url = f"{self.base_url}/bot{self.token}/{method}"
+        clean = {k: v for k, v in params.items() if v is not None}
+        try:
+            r = self.session.get(url, params=clean, timeout=self.timeout)
+            data = r.json()
+        except Exception as exc:
+            raise GitbinError(0, str(exc), method)
+        if not data.get("ok"):
+            raise_from_response(data, method)
+        return data.get("result")

gitbin_bot-1.0.0/gitbin/errors.py

@@ -0,0 +1,61 @@
+"""خطاهای API گیت‌بین"""
+
+
+class GitbinError(Exception):
+    """خطای پایه همه خطاهای گیت‌بین"""
+    def __init__(self, code: int, description: str, method: str = ""):
+        self.code = code
+        self.description = description
+        self.method = method
+        msg = f"[{code}] {description}"
+        if method:
+            msg += f" (در متد {method})"
+        super().__init__(msg)
+
+
+# نقشه: description → اسم کلاس Exception
+_ERROR_NAMES = {
+    # احراز هویت
+    "ACCESS_TOKEN_INVALID": "AccessTokenInvalid",
+
+    # پارامترهای نامعتبر
+    "CHAT_ID_INVALID": "ChatIdInvalid",
+    "USER_ID_INVALID": "UserIdInvalid",
+    "FILE_ID_INVALID": "FileIdInvalid",
+    "GIFT_ID_INVALID": "GiftIdInvalid",
+    "QUERY_ID_INVALID": "QueryIdInvalid",
+    "BUTTON_INVALID": "ButtonInvalid",
+    "BOT_COMMAND_INVALID": "BotCommandInvalid",
+    "WEBHOOK_URL_INVALID": "WebhookUrlInvalid",
+    "EMOTICON_INVALID": "EmoticonInvalid",
+    "BOT_INVALID": "BotInvalid",
+
+    # محدودیت‌ها
+    "EPHEMERAL_TARGET_REQUIRED": "EphemeralTargetRequired",
+    "FILE_TOO_BIG": "FileTooBig",
+
+    # استارز
+    "STARS_AMOUNT_INVALID": "StarsAmountInvalid",
+    "BALANCE_TOO_LOW": "BalanceTooLow",
+    "USER_NOT_FOUND": "UserNotFound",
+    "USER_IS_BOT": "UserIsBot",
+
+    # عمومی
+    "METHOD_NOT_FOUND": "MethodNotFound",
+    "CONFLICT": "ConflictError",
+}
+
+# ساخت پویا کلاس‌ها
+import sys as _sys
+_module = _sys.modules[__name__]
+for _desc, _cls_name in _ERROR_NAMES.items():
+    globals()[_cls_name] = type(_cls_name, (GitbinError,), {})
+
+
+def raise_from_response(data: dict, method: str = ""):
+    """از پاسخ خطای API، Exception مناسب بساز و raise کن"""
+    desc = data.get("description", "UNKNOWN_ERROR")
+    code = data.get("error_code", 0)
+    cls_name = _ERROR_NAMES.get(desc, "GitbinError")
+    cls = globals().get(cls_name, GitbinError)
+    raise cls(code, desc, method)

gitbin_bot-1.0.0/gitbin/methods.py

@@ -0,0 +1,185 @@
+"""همه متدهای API گیت‌بین — ۴۵ متد"""
+
+
+class BotMethods:
+    # ═══════════════ هویت و آپدیت ═══════════════
+
+    def get_me(self):
+        """اطلاعات ربات"""
+        return self._call("getMe")
+
+    def get_updates(self, offset=None, limit=None, timeout=None, allowed_updates=None):
+        """دریافت آپدیت‌ها (long polling)"""
+        return self._call("getUpdates", offset=offset, limit=limit,
+                          timeout=timeout, allowed_updates=allowed_updates)
+
+    def set_webhook(self, url, **kwargs):
+        return self._call("setWebhook", url=url, **kwargs)
+
+    def delete_webhook(self, **kwargs):
+        return self._call("deleteWebhook", **kwargs)
+
+    def get_webhook_info(self):
+        return self._call("getWebhookInfo")
+
+    def get_file(self, file_id):
+        return self._call("getFile", file_id=file_id)
+
+    # ═══════════════ دستورات و منو ═══════════════
+
+    def set_my_commands(self, commands, **kwargs):
+        """commands: [{"command": "start", "description": "شروع"}]"""
+        return self._call("setMyCommands", commands=commands, **kwargs)
+
+    def get_my_commands(self, **kwargs):
+        return self._call("getMyCommands", **kwargs)
+
+    def set_chat_menu_button(self, **kwargs):
+        return self._call("setChatMenuButton", **kwargs)
+
+    def get_chat_menu_button(self, **kwargs):
+        return self._call("getChatMenuButton", **kwargs)
+
+    def set_user_emoji_status(self, user_id, emoji_status_custom_emoji_id=None, **kwargs):
+        return self._call("setUserEmojiStatus", user_id=user_id,
+                          emoji_status_custom_emoji_id=emoji_status_custom_emoji_id, **kwargs)
+
+    # ═══════════════ ارسال پیام ═══════════════
+
+    def send_message(self, chat_id, text, **kwargs):
+        return self._call("sendMessage", chat_id=chat_id, text=text, **kwargs)
+
+    def send_photo(self, chat_id, photo, **kwargs):
+        return self._call("sendPhoto", chat_id=chat_id, photo=photo, **kwargs)
+
+    def send_audio(self, chat_id, audio, **kwargs):
+        return self._call("sendAudio", chat_id=chat_id, audio=audio, **kwargs)
+
+    def send_document(self, chat_id, document, **kwargs):
+        return self._call("sendDocument", chat_id=chat_id, document=document, **kwargs)
+
+    def send_video(self, chat_id, video, **kwargs):
+        return self._call("sendVideo", chat_id=chat_id, video=video, **kwargs)
+
+    def send_animation(self, chat_id, animation, **kwargs):
+        return self._call("sendAnimation", chat_id=chat_id, animation=animation, **kwargs)
+
+    def send_voice(self, chat_id, voice, **kwargs):
+        return self._call("sendVoice", chat_id=chat_id, voice=voice, **kwargs)
+
+    def send_video_note(self, chat_id, video_note, **kwargs):
+        return self._call("sendVideoNote", chat_id=chat_id, video_note=video_note, **kwargs)
+
+    def send_sticker(self, chat_id, sticker, **kwargs):
+        return self._call("sendSticker", chat_id=chat_id, sticker=sticker, **kwargs)
+
+    def send_dice(self, chat_id, emoji=None, **kwargs):
+        """تاس/بسکتبال/فوتبال/... — emoji: 🎲 🎯 🎳 🏀 ⚽ 🎰"""
+        return self._call("sendDice", chat_id=chat_id, emoji=emoji, **kwargs)
+
+    # ─── سه متد ویژه: به‌جای chat_id، receiver_user_id لازم دارن ───
+    def send_location(self, chat_id, receiver_user_id, latitude, longitude, **kwargs):
+        return self._call("sendLocation", chat_id=chat_id, receiver_user_id=receiver_user_id,
+                          latitude=latitude, longitude=longitude, **kwargs)
+
+    def send_venue(self, chat_id, receiver_user_id, latitude, longitude, title, address, **kwargs):
+        return self._call("sendVenue", chat_id=chat_id, receiver_user_id=receiver_user_id,
+                          latitude=latitude, longitude=longitude,
+                          title=title, address=address, **kwargs)
+
+    def send_contact(self, chat_id, receiver_user_id, phone_number, first_name, **kwargs):
+        return self._call("sendContact", chat_id=chat_id, receiver_user_id=receiver_user_id,
+                          phone_number=phone_number, first_name=first_name, **kwargs)
+
+    # ═══════════════ ویرایش و حذف ═══════════════
+
+    def edit_message_text(self, chat_id, message_id, text, **kwargs):
+        return self._call("editMessageText", chat_id=chat_id,
+                          message_id=message_id, text=text, **kwargs)
+
+    def delete_message(self, chat_id, message_id):
+        return self._call("deleteMessage", chat_id=chat_id, message_id=message_id)
+
+    def answer_callback_query(self, callback_query_id, text=None, show_alert=None, **kwargs):
+        return self._call("answerCallbackQuery", callback_query_id=callback_query_id,
+                          text=text, show_alert=show_alert, **kwargs)
+
+    # ═══════════════ مدیریت چت ═══════════════
+
+    def ban_chat_member(self, chat_id, user_id, **kwargs):
+        return self._call("banChatMember", chat_id=chat_id, user_id=user_id, **kwargs)
+
+    def unban_chat_member(self, chat_id, user_id, **kwargs):
+        return self._call("unbanChatMember", chat_id=chat_id, user_id=user_id, **kwargs)
+
+    def restrict_chat_member(self, chat_id, user_id, permissions=None, **kwargs):
+        """permissions: dict مثل {"can_send_messages": False}"""
+        return self._call("restrictChatMember", chat_id=chat_id, user_id=user_id,
+                          permissions=permissions, **kwargs)
+
+    def promote_chat_member(self, chat_id, user_id, **kwargs):
+        return self._call("promoteChatMember", chat_id=chat_id, user_id=user_id, **kwargs)
+
+    def pin_chat_message(self, chat_id, message_id, **kwargs):
+        return self._call("pinChatMessage", chat_id=chat_id, message_id=message_id, **kwargs)
+
+    def unpin_chat_message(self, chat_id, message_id=None, **kwargs):
+        return self._call("unpinChatMessage", chat_id=chat_id, message_id=message_id, **kwargs)
+
+    def get_chat_administrators(self, chat_id):
+        return self._call("getChatAdministrators", chat_id=chat_id)
+
+    def get_chat_member(self, chat_id, user_id):
+        return self._call("getChatMember", chat_id=chat_id, user_id=user_id)
+
+    # ═══════════════ استارز (قابلیت ویژه گیت‌بین) ═══════════════
+
+    def get_my_star_balance(self):
+        """موجودی استارز ربات"""
+        return self._call("getMyStarBalance")
+
+    def get_available_gifts(self):
+        return self._call("getAvailableGifts")
+
+    def send_gift(self, gift_id, **kwargs):
+        return self._call("sendGift", gift_id=gift_id, **kwargs)
+
+    def gift_premium_subscription(self, user_id, **kwargs):
+        return self._call("giftPremiumSubscription", user_id=user_id, **kwargs)
+
+    def refund_star_payment(self, user_id, telegram_payment_charge_id, **kwargs):
+        return self._call("refundStarPayment", user_id=user_id,
+                          telegram_payment_charge_id=telegram_payment_charge_id, **kwargs)
+
+    def transfer_stars(self, user_id, amount, **kwargs):
+        """انتقال استارز از کیف پول ربات به یک کاربر"""
+        return self._call("transferStars", user_id=user_id, amount=amount, **kwargs)
+
+    # ═══════════════ پرداخت ═══════════════
+
+    def send_invoice(self, chat_id, title, description, payload,
+                     provider_token, currency, prices, **kwargs):
+        return self._call("sendInvoice", chat_id=chat_id, title=title,
+                          description=description, payload=payload,
+                          provider_token=provider_token, currency=currency,
+                          prices=prices, **kwargs)
+
+    def answer_pre_checkout_query(self, pre_checkout_query_id, ok, **kwargs):
+        return self._call("answerPreCheckoutQuery",
+                          pre_checkout_query_id=pre_checkout_query_id,
+                          ok=ok, **kwargs)
+
+    def answer_shipping_query(self, shipping_query_id, ok, **kwargs):
+        """⚠️ در اسکن 404 داد — با احتیاط استفاده کن"""
+        return self._call("answerShippingQuery",
+                          shipping_query_id=shipping_query_id, ok=ok, **kwargs)
+
+    # ═══════════════ WebApp ═══════════════
+
+    def answer_web_app_query(self, web_app_query_id, result, **kwargs):
+        return self._call("answerWebAppQuery",
+                          web_app_query_id=web_app_query_id, result=result, **kwargs)
+
+    def save_prepared_inline_message(self, user_id, result, **kwargs):
+        return self._call("savePreparedInlineMessage",
+                          user_id=user_id, result=result, **kwargs)

gitbin_bot-1.0.0/gitbin/types.py

@@ -0,0 +1,126 @@
+"""انواع داده API گیت‌بین — بر اساس مستندات"""
+from dataclasses import dataclass, field
+from typing import Optional, List, Dict, Any
+
+
+@dataclass
+class User:
+    id: int
+    is_bot: bool = False
+    first_name: str = ""
+    last_name: Optional[str] = None
+    username: Optional[str] = None
+    language_code: Optional[str] = None
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "User":
+        return cls(**{k: v for k, v in d.items() if k in cls.__dataclass_fields__})
+
+
+@dataclass
+class Chat:
+    id: int
+    type: str = "private"          # private | group | supergroup | channel
+    title: Optional[str] = None
+    username: Optional[str] = None
+    first_name: Optional[str] = None
+    last_name: Optional[str] = None
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "Chat":
+        return cls(**{k: v for k, v in d.items() if k in cls.__dataclass_fields__})
+
+
+@dataclass
+class Dice:
+    emoji: str = "🎲"
+    value: int = 0
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "Dice":
+        return cls(**{k: v for k, v in d.items() if k in cls.__dataclass_fields__})
+
+
+@dataclass
+class Message:
+    message_id: int
+    date: int = 0
+    text: Optional[str] = None
+    caption: Optional[str] = None
+    from_user: Optional[User] = None       # فیلد اصلی API: from
+    chat: Optional[Chat] = None
+    dice: Optional[Dice] = None
+    photo: Optional[List[Dict[str, Any]]] = None
+    document: Optional[Dict[str, Any]] = None
+    video: Optional[Dict[str, Any]] = None
+    audio: Optional[Dict[str, Any]] = None
+    voice: Optional[Dict[str, Any]] = None
+    sticker: Optional[Dict[str, Any]] = None
+    animation: Optional[Dict[str, Any]] = None
+    reply_to_message: Optional["Message"] = None
+    successful_payment: Optional[Dict[str, Any]] = None
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "Message":
+        d = dict(d)
+        if "from" in d:
+            d["from_user"] = d.pop("from")
+        if d.get("from_user"):
+            d["from_user"] = User.from_dict(d["from_user"])
+        if d.get("chat"):
+            d["chat"] = Chat.from_dict(d["chat"])
+        if d.get("dice"):
+            d["dice"] = Dice.from_dict(d["dice"])
+        if d.get("reply_to_message"):
+            d["reply_to_message"] = Message.from_dict(d["reply_to_message"])
+        allowed = {k: v for k, v in d.items() if k in cls.__dataclass_fields__}
+        return cls(**allowed)
+
+
+@dataclass
+class CallbackQuery:
+    id: str
+    from_user: Optional[User] = None
+    message: Optional[Message] = None
+    data: Optional[str] = None
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "CallbackQuery":
+        d = dict(d)
+        if "from" in d:
+            d["from_user"] = d.pop("from")
+        if d.get("from_user"):
+            d["from_user"] = User.from_dict(d["from_user"])
+        if d.get("message"):
+            d["message"] = Message.from_dict(d["message"])
+        allowed = {k: v for k, v in d.items() if k in cls.__dataclass_fields__}
+        return cls(**allowed)
+
+
+@dataclass
+class Update:
+    update_id: int
+    message: Optional[Message] = None
+    edited_message: Optional[Message] = None
+    callback_query: Optional[CallbackQuery] = None
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "Update":
+        d = dict(d)
+        if d.get("message"):
+            d["message"] = Message.from_dict(d["message"])
+        if d.get("edited_message"):
+            d["edited_message"] = Message.from_dict(d["edited_message"])
+        if d.get("callback_query"):
+            d["callback_query"] = CallbackQuery.from_dict(d["callback_query"])
+        return cls(**d)
+
+
+@dataclass
+class StarBalance:
+    amount: int = 0
+    nanostar_amount: int = 0
+
+    @classmethod
+    def from_dict(cls, d: dict) -> "StarBalance":
+        return cls(**{k: v for k, v in d.items() if k in cls.__dataclass_fields__})

gitbin_bot-1.0.0/gitbin_bot.egg-info/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: gitbin-bot
+Version: 1.0.0
+Summary: کتابخانه پایتون برای GitBin Bot API
+Author-email: MMD <ammmd219@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/MMD-C0DE/gitbin-bot
+Project-URL: Documentation, https://github.com/MMD-C0DE/gitbin-bot#readme
+Project-URL: Issues, https://github.com/MMD-C0DE/gitbin-bot/issues
+Keywords: gitbin,bot,api,telegram,messenger
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+
+# gitbin-bot
+
+کتابخانه پایتون برای GitBin Bot API.
+
+## نصب
+
+```bash
+pip install gitbin-bot
+```
+
+## استفاده
+
+```python
+from gitbin import Bot
+
+bot = Bot(token="YOUR_TOKEN")
+
+# اطلاعات ربات
+me = bot.get_me()
+print(me["first_name"])
+
+# ارسال پیام
+bot.send_message(chat_id=123, text="سلام 👋")
+
+# موجودی استارز
+bal = bot.get_my_star_balance()
+print(f"{bal['amount']:,} استارز")
+```
+
+## متدهای موجود
+
+getMe, getUpdates, sendMessage, sendPhoto, sendDocument, sendVideo, sendAudio, sendVoice, sendAnimation, sendVideoNote, sendSticker, sendDice, sendLocation, sendVenue, sendContact, editMessageText, deleteMessage, answerCallbackQuery, banChatMember, unbanChatMember, restrictChatMember, promoteChatMember, pinChatMessage, unpinChatMessage, getChatAdministrators, getChatMember, setMyCommands, getMyCommands, setChatMenuButton, getChatMenuButton, getFile, setWebhook, deleteWebhook, getWebhookInfo, getMyStarBalance, transferStars, sendGift, giftPremiumSubscription, getAvailableGifts, refundStarPayment, sendInvoice, answerPreCheckoutQuery, answerShippingQuery, answerWebAppQuery, savePreparedInlineMessage, setUserEmojiStatus
+
+**جمعاً ۴۵ متد.**
+
+## لایسنس
+
+MIT

gitbin_bot-1.0.0/gitbin_bot.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+gitbin/__init__.py
+gitbin/client.py
+gitbin/errors.py
+gitbin/methods.py
+gitbin/types.py
+gitbin_bot.egg-info/PKG-INFO
+gitbin_bot.egg-info/SOURCES.txt
+gitbin_bot.egg-info/dependency_links.txt
+gitbin_bot.egg-info/requires.txt
+gitbin_bot.egg-info/top_level.txt
+tests/test_basic.py

gitbin_bot-1.0.0/gitbin_bot.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gitbin_bot-1.0.0/gitbin_bot.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28

gitbin_bot-1.0.0/gitbin_bot.egg-info/top_level.txt

@@ -0,0 +1 @@
+gitbin

gitbin_bot-1.0.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gitbin-bot"
+version = "1.0.0"
+description = "کتابخانه پایتون برای GitBin Bot API"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "MMD", email = "ammmd219@gmail.com" }]
+keywords = ["gitbin", "bot", "api", "telegram", "messenger"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Communications :: Chat",
+]
+dependencies = ["requests>=2.28"]
+
+[project.urls]
+Homepage = "https://github.com/MMD-C0DE/gitbin-bot"
+Documentation = "https://github.com/MMD-C0DE/gitbin-bot#readme"
+Issues = "https://github.com/MMD-C0DE/gitbin-bot/issues"
+
+[tool.setuptools.packages.find]
+include = ["gitbin*"]

gitbin_bot-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gitbin_bot-1.0.0/tests/test_basic.py

@@ -0,0 +1,20 @@
+"""تست ساده کتابخانه"""
+import os
+from gitbin import Bot
+
+TOKEN = os.environ.get("GITBIN_TOKEN", "")
+
+
+def test_import():
+    """کتابخانه نصب شده"""
+    from gitbin import Bot
+    assert Bot is not None
+
+
+def test_get_me():
+    """اتصال به API"""
+    if not TOKEN:
+        return  # اگه توکن نداری، رد شو
+    bot = Bot(token=TOKEN)
+    me = bot.get_me()
+    assert me["is_bot"] is True