Metadata-Version: 2.4
Name: apklis-downloader
Version: 0.0.1
Summary: A Python library to retrieve metadata and download APKs from Apklis, with progress monitoring support.
Author-email: El Joker <eljoker@example.com>
Project-URL: Homepage, https://github.com/ElJoker63/apklis-downloader
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.20.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"

<h1 align="center">📥 apklis-downloader</h1>

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

<p align="center"><strong>Cliente Python Asíncrono para Apklis.cu</strong> — descarga APKs de forma rápida y sencilla con monitoreo de progreso.</p>

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

---

## ⚡ ¿Qué es apklis-downloader?

Es una librería moderna, asíncrona y de alto rendimiento para interactuar con la plataforma cubana **Apklis.cu**. Te permite consultar información detallada de aplicaciones, obtener datos del último lanzamiento y descargar archivos APK con una barra de progreso integrada altamente personalizable.

Además, cuenta con resolución automática de enlaces de descarga protegidos (Forbidden) usando una cuenta pública (`gid`).

---

## 📦 Instalación

```bash
pip install apklis-downloader
```

---

## 🚀 Uso Rápido

El siguiente ejemplo muestra cómo descargar un APK de forma asíncrona:

```python
import asyncio
import sys
import apklis

# Configura la terminal para soportar caracteres unicode en Windows
if hasattr(sys.stdout, 'reconfigure'):
    sys.stdout.reconfigure(encoding='utf-8')

async def main():
    package = "cu.todus.android"
    
    # 1. Obtener información de la app
    icon, name, description, updated = await apklis.get_info(package)
    print(f"Nombre: {name}")
    
    # 2. Resolver la URL de descarga automáticamente (incluye bypass si es Forbidden)
    download_url = await apklis.get_apk_url(package)
    print(f"URL de descarga: {download_url}")
    
    # 3. Descargar mostrando la barra de progreso
    await apklis.download_apk(download_url)

if __name__ == "__main__":
    asyncio.run(main())
```

---

## 📚 Documentación y Recursos

Toda la información detallada sobre **autenticación, callbacks de progreso personalizados (ej. para bots de Telegram), referencia completa de APIs y utilidades** la encontrarás en nuestro sitio web oficial de documentación:

👉 **[https://eljoker63.github.io/apklis-downloader](https://eljoker63.github.io/apklis-downloader)**

- **Apklis oficial:** [Apklis](https://www.apklis.cu)
- **PyPI:** [apklis-downloader](https://pypi.org/project/apklis-downloader/)
- **Contribuir:** [CONTRIBUTING.md](CONTRIBUTING.md)

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