Metadata-Version: 2.1
Name: logscolor
Version: 1.1.0
Summary: Librería personalizada para logging con colores, con informacion de fecha - hora de ejecución y linea ejecutable (opcional)
Home-page: https://github.com/Pabl0VC/lib_logscolor
Author: Pablo Vega C
Author-email: pablovegac.93@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# LogsColor

**Logscolor** es una biblioteca de código abierto ligera y fácil de usar para crear registros (logs) con colores personalizables en Python. Ideal para desarrolladores que buscan simplificar el seguimiento y la depuración en sus proyectos.
- Colores en los mensajes de log.
- Diferentes niveles de log (`INFO`, `WARNING`, `ERROR`, `TRACE`).
- Opcional: Mostrar la línea del código donde se generó el mensaje.

## Instalación
Para instalar `logscolor`, solo ejecuta el siguiente comando:

```bash
pip install logscolor
```
Luego, en tu proyecto, importa las funciones de logging:
```python
from logscolor.logscl import info, error, trace, warning, infoL, errorL, traceL, warningL
```
Con esto, podrás utilizar los diferentes niveles de logging en tu código.

## Uso Básico
Importa logscolor en tu proyecto:
```python
from logscolor.logscl import info, error, trace, warning, infoL, errorL, traceL, warningL

info("Mensaje de información")
warning("Mensaje de advertencia")
error("Mensaje de error")
trace("Mensaje de depuración")
```

Si deseas incluir información sobre la línea donde se genera el mensaje, utiliza las funciones con sufijo **L**:
```python
from logscolor.logscolor import infoL

infoL("Información con línea de código")
```

## Características
- Colores personalizables: Cada nivel de log tiene un color único para facilitar la identificación visual.
- Formato enriquecido: Muestra la fecha, hora y línea de origen opcionalmente.
- Ligero y fácil de integrar: Ideal para proyectos grandes o pequeños.
- Soporte para niveles avanzados: Incluye trazabilidad (trace) para depuración detallada.
- Fácil integración: Diseñado para usarse como un reemplazo rápido y sencillo de `print()`.


## Niveles de Log Soportados
logscolor soporta los siguientes niveles de log, cada uno con colores personalizados para una mejor visibilidad:

| Nivel      | Descripción                              | Variantes               |
|------------|------------------------------------------|-------------------------|
| **INFO**   | Mensajes informativos.                  | `info`, `infoL`         |
| **WARNING**| Advertencias sobre posibles problemas.   | `warning`, `warningL`   |
| **ERROR**  | Mensajes de error críticos.             | `error`, `errorL`       |
| **TRACE**  | Mensajes para depuración detallada.      | `trace`, `traceL`       |

### Imágenes
![alt text](/examples/example_terminal.png)

### Real Examples
![alt text](/examples/real_ex.png)

## Requisitos
- Python 3.7 o superior
- colorama

## Licencia
Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.

## Contacto
Creado por Pablo Vega Castro. Si tienes dudas o sugerencias, no dudes en contactarme pablovegac.93@gmail.com.

