Metadata-Version: 2.3
Name: sincpro-async-worker
Version: 0.2.1
Summary: Componente asíncrono para sincpro_framework que permite ejecutar tareas asíncronas en un entorno mayoritariamente sincrónico
License: SINCPRO S.R.L.
Author: Gutierrez, Andres
Author-email: andru1236@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Description-Content-Type: text/markdown

# Sincpro Async Worker

Una solución simple para ejecutar tareas asíncronas desde código síncrono.

## Propósito

Esta librería está diseñada para escenarios donde necesitas ejecutar operaciones asíncronas desde código síncrono, sin la complejidad de implementar una solución completa de colas de mensajes.

## Casos de Uso Principales

1. **Ejecución de tareas asíncronas desde frameworks síncronos**
   - Ejecutar operaciones I/O asíncronas desde frameworks web síncronos
   - Manejar operaciones de red sin bloquear el hilo principal

2. **Aislamiento de operaciones asíncronas**
   - Ejecutar tareas asíncronas en un hilo separado
   - Mantener el código síncrono limpio y simple

3. **Despacho simple de tareas**
   - Para escenarios donde una cola de mensajes sería excesivo
   - Tareas que no requieren persistencia o garantías de entrega

## Cuándo NO usar esta librería

Esta librería NO está diseñada para:
- Sistemas distribuidos
- Tareas que requieren garantías de entrega
- Escenarios que necesitan persistencia de mensajes
- Sistemas que requieren alta disponibilidad

Para estos casos, considera usar soluciones más robustas como:
- RabbitMQ
- Apache Kafka
- Celery

## Instalación

```bash
pip install sincpro-async-worker
```

## Uso Básico

```python
from sincpro_async_worker import run_async_task

# Ejecutar tarea asíncrona
async def mi_tarea():
    await asyncio.sleep(1)
    return "hecho"

resultado = run_async_task(mi_tarea())

# Opcionalmente, puedes especificar un timeout
resultado = run_async_task(mi_tarea(), timeout=5.0)
```

## Características

- **Ejecución en hilo separado**: Las tareas se ejecutan en un hilo dedicado
- **Manejo de timeouts**: Soporte para timeouts en la ejecución de tareas
- **Propagación de excepciones**: Las excepciones se propagan correctamente al hilo principal
- **Limpieza automática**: Los recursos se liberan automáticamente

## Contribuciones

Las contribuciones son bienvenidas. Por favor, asegúrate de:
1. Seguir las guías de estilo del proyecto
2. Incluir tests para nuevas funcionalidades
3. Actualizar la documentación según sea necesario

## Licencia

SINCPRO S.R.L.