pyeitaa 0.1.2

Pyeitaa

A simple Python SDK for interacting with the Eitaa API.

Lightweight and easy-to-use wrapper for Eitaa messenger API.

🚀 Installation

pip install pyeitaa

🔑 How do I get a token?

Get your token from:

"https://eitaayar.ir/" (https://eitaayar.ir/)

---

⚡ Quick Start

from pyeitaa import Eitaa

bot = Eitaa("YOUR_TOKEN")

print(bot.get_me())

---

💬 Send Message

bot.send_message( chat_id="123456", text="Hello from Pyeitaa!" )

This method sends a text message to a channel or group.

Parameters

• "chat_id" (required) Unique identifier of the channel or group. You can also use the username without "@".

  Example:

  • "chat_id="eitaayar""
  • "chat_id="1404""

• "text" (required) Message content to send.

• "title" (optional) Internal title used for search and display purposes.

• "disable_notification" (optional) Sends the message silently without notification.

• "reply_to_message_id" (optional) Sends the message as a reply.

• "date" (optional) Unix timestamp for scheduled sending.

• "pin" (optional) Pins the message after sending.

• "viewCountForDelete" (optional) Deletes the message after reaching a specific view count.

---

📎 Send File

bot.send_file( chat_id="123456", file_path="image.png", caption="Hello file" )

This method sends media or files.

Parameters

• "chat_id" (required) Channel or group identifier.

• "file_path" (required) Path to the file.

• "caption" (optional) Caption text for the file.

---

📌 Important Notes

• To send a GIF file, rename the extension to ".gif"

Example:

sample.mp4 → sample.gif

• To send a sticker, rename the extension to ".webp"

Example:

sample.png → sample.webp

---

⚠️ Exceptions

from pyeitaa.exceptions import EitaaError, EitaaAuthError

try: bot.get_me()

except EitaaAuthError: print("Invalid token")

except EitaaError: print("General error")

---

🧠 Features

• Simple and clean API
• File upload support
• Custom exceptions
• Lightweight ("httpx")
• Easy to extend

---

📦 Project Status

Alpha version ("0.1.0")

---

🛠 Requirements

• Python 3.8+
• httpx

---

📌 Roadmap

• Async support
• Webhook system
• Retry mechanism
• Rate limiting
• Better response objects

---

📄 License

This project is licensed under the MIT License.

See: "LICENSE" (LICENSE)