Metadata-Version: 2.4
Name: pyeitaa
Version: 0.1.2
Summary: A simple Python SDK for Eitaa API
Author-email: MohammadReza Karimi <kreza6517@email.com>
Project-URL: Homepage, https://github.com/Satrap18/pyeitaa
Project-URL: Repository, https://github.com/Satrap18/pyeitaa
Project-URL: Issues, https://github.com/Satrap18/pyeitaa/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Dynamic: license-file

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)
