Metadata-Version: 2.4
Name: logsandmore
Version: 1.0.0
Summary: Sistema de logs avanzado y personalizable para Python con niveles personalizados
Author: Leonardo
Project-URL: Homepage, https://github.com/Leonardo/logsandmore
Project-URL: Repository, https://github.com/Leonardo/logsandmore
Keywords: logging,logs,logger,debug,python,security,events
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown



````md
# logsandmore

Sistema de logs avanzado y personalizable para Python.

Permite crear archivos de registro con:
- Fecha y hora automática
- Nombre personalizado de aplicación
- Archivo de salida configurable
- Niveles normales y personalizados
- Eventos personalizados

## Instalación

```bash
pip install logsandmore
````

## Instalación local

Dentro de la carpeta del proyecto:

```bash
pip install .
```

## Uso básico

```python
from logsandmore import crear_logger

log = crear_logger(
    "MiAplicacion",
    "app.log"
)

log.info("Aplicación iniciada")
log.warning("Memoria alta")
log.error("Error de conexión")
log.debug("Variable comprobada")
```

Resultado:

```
[2026-09-05 14:11:32] [MiAplicacion] [INFO] Aplicación iniciada
[2026-09-05 14:11:40] [MiAplicacion] [WARNING] Memoria alta
[2026-09-05 14:11:45] [MiAplicacion] [ERROR] Error de conexión
```

---

# Niveles personalizados

logsandmore incluye niveles adicionales:

| Nivel    | Uso                             |
| -------- | ------------------------------- |
| SUCCESS  | Acción completada correctamente |
| EVENT    | Eventos del sistema             |
| SECURITY | Alertas de seguridad            |

Ejemplo:

```python
from logsandmore import crear_logger

log = crear_logger(
    "Servidor",
    "servidor.log"
)

log.success("Servidor iniciado correctamente")

log.evento("Usuario conectado")

log.seguridad("Intento de acceso detectado")
```

Salida:

```
[2026-09-05 14:12:01] [Servidor] [SUCCESS] Servidor iniciado correctamente
[2026-09-05 14:12:05] [Servidor] [EVENT] Usuario conectado
[2026-09-05 14:12:10] [Servidor] [SECURITY] Intento de acceso detectado
```

---

# Crear logs personalizados

También puedes crear tus propios niveles:

```python
log.custom(
    60,
    "Mensaje personalizado"
)
```

---

# Crear un logger

```python
crear_logger(
    nombre="NombreDelPrograma",
    archivo="nombre_del_log.log"
)
```

Ejemplo:

```python
log = crear_logger(
    "MinecraftServer",
    "minecraft.log"
)
```

Creará:

```
minecraft.log
```

con todos los eventos guardados.

---

# Características futuras

* Rotación automática de archivos
* Logs en formato JSON
* Colores en consola
* Envío de logs a servidores
* Configuración externa

```
```
