Metadata-Version: 2.4
Name: toDus-API
Version: 1.5.6
Summary: Cliente Python para ToDus (mensajería cubana) — chat, grupos, archivos, stickers y más
Author: ElJoker63
License-Expression: MIT
Project-URL: Homepage, https://github.com/ElJoker63/toDus-API
Project-URL: Repository, https://github.com/ElJoker63/toDus-API
Project-URL: Issues, https://github.com/ElJoker63/toDus-API/issues
Project-URL: Changelog, https://github.com/ElJoker63/toDus-API/blob/main/CHANGELOG.md
Keywords: todus,cuba,xmpp,messaging,chat
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: pysocks
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
Dynamic: license-file

<h1 align="center">📱 toDus-API</h1>
<center><img src="https://raw.githubusercontent.com/ElJoker63/todus-API/main/examples/avatar.png" width="20%" height="20%"></center>

<p align="center">
  <a href="https://pypi.org/project/todus-api/"><img src="https://img.shields.io/pypi/v/todus-api" alt="PyPI"></a>
  <a href="https://pypi.org/project/todus-api/"><img src="https://img.shields.io/pypi/pyversions/todus-api" alt="Python"></a>
  <a href="https://github.com/ElJoker63/toDus-API/actions/workflows/ci.yml"><img src="https://github.com/ElJoker63/todus-api/actions/workflows/ci.yml/badge.svg?branch=main" alt="Tests"></a>
  <a href="https://github.com/ElJoker63/todus-api/actions/workflows/pypi-publish.yml"><img src="https://github.com/ElJoker63/todus-api/actions/workflows/pypi-publish.yml/badge.svg?branch=main" alt="Publish"></a>
  <a href="https://eljoker63.github.io/todus-api"><img src="https://img.shields.io/badge/docs-MkDocs-blueviolet" alt="Docs"></a>
  <a href="https://github.com/ElJoker63/todus-api/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"></a>
</p>

<p align="center"><strong>Cliente Python para ToDus</strong> — la plataforma de mensajería instantánea cubana.</p>

<p align="center">
  <a href="https://eljoker63.github.io/toDus-API"><b>📖 LEER LA DOCUMENTACIÓN COMPLETA AQUÍ 📖</b></a>
</p>

---

## ⚡ ¿Qué es toDus-API?

Es una librería moderna, asíncrona y orientada a eventos para interactuar con la red de ToDus. Te permite crear bots interactivos, manejar grupos y canales, enviar contenido multimedia y ver o publicar historias, todo usando Python puro.

**Cobertura del protocolo:** 100% de las funciones de la app oficial.

---

## 📦 Instalación

```bash
pip install todus-API
```

---

## 🚀 Uso Rápido (Tu primer bot)

```python
from todus import ToDusClient

# 1. Configura tus credenciales
client = ToDusClient("5350000000", token="tu_token_aqui")

# 2. Crea manejadores de eventos (handlers)
@client.on_message
def responder_mensajes(client: ToDusClient, msg):
    if not msg.is_own and msg.text:
        client.send_text_message(msg.sender, f"¡Hola! Recibí: {msg.text}")

# 3. Ponlo a escuchar
print("Bot en ejecución...")
client.run()
```

---

## 📚 Documentación y Recursos

Toda la información detallada sobre **autenticación, subida de archivos, historias, canales, grupos, bloqueos y más** la encontrarás en nuestro sitio web oficial de documentación:

👉 **[https://eljoker63.github.io/toDus-API](https://eljoker63.github.io/toDus-API)**

- **ToDus oficial:** [ToDus Web](https://web.todus.cu)
- **PyPI:** [toDus-API](https://pypi.org/project/toDus-API/)
- **Changelog:** [CHANGELOG.md](CHANGELOG.md)
- **Contribuir:** [CONTRIBUTING.md](CONTRIBUTING.md)

---
<p align="center">Desarrollado con ❤️ por ElJoker63.</p>
