feat: log_debug, log_info, log_warn, log_error (infra)
Funciones de nivel que delegan al *slog.Logger interno del Logger. Todas son impuras y soportan logger nil sin panic (no-op). Los fields se pasan como pares key-value variadicos estilo slog. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
---
|
||||
name: log_error
|
||||
kind: function
|
||||
lang: go
|
||||
domain: infra
|
||||
version: "1.0.0"
|
||||
purity: impure
|
||||
signature: "func LogError(logger *Logger, msg string, fields ...any)"
|
||||
description: "Emite un log a nivel error en el Logger. Los fields son pares key-value variadicos. Nivel maximo de severidad, siempre se emite salvo que el logger tenga un handler que lo filtre explicitamente."
|
||||
tags: [logging, log, error, slog, infra]
|
||||
uses_functions: []
|
||||
uses_types: [Logger_go_infra]
|
||||
returns: []
|
||||
returns_optional: false
|
||||
error_type: "error_go_core"
|
||||
imports: []
|
||||
params:
|
||||
- name: logger
|
||||
desc: "Logger al que emitir el mensaje. Si es nil la funcion no hace nada"
|
||||
- name: msg
|
||||
desc: "mensaje principal del log"
|
||||
- name: fields
|
||||
desc: "pares key-value variadicos (ej: \"err\", err.Error(), \"table\", \"users\", \"query\", sql)"
|
||||
output: "nada (side effect: escribe al Output del Logger)"
|
||||
tested: true
|
||||
tests: ["LogError emite nivel ERROR", "logger nil no hace panic en las funciones de log"]
|
||||
test_file_path: "functions/infra/logger_test.go"
|
||||
file_path: "functions/infra/log_error.go"
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```go
|
||||
logger, _ := LoggerNew(LogLevelInfo, os.Stdout, "json")
|
||||
err := db.QueryRow(...).Scan(&x)
|
||||
if err != nil {
|
||||
LogError(logger, "db query failed", "err", err.Error(), "table", "users")
|
||||
}
|
||||
// {"time":"...","level":"ERROR","msg":"db query failed","err":"connection refused","table":"users"}
|
||||
```
|
||||
|
||||
## Notas
|
||||
|
||||
Funcion impura — delega a `slog.Logger.Error()`. Usar para fallos que requieren atencion: panics capturados, errores de I/O, estados invalidos. No aborta el programa por si solo — el caller decide que hacer. Para convertir un `error` en campo se recomienda usar `err.Error()` directamente, aunque slog tambien acepta el tipo `error` como valor (lo serializa con `.Error()` internamente).
|
||||
Reference in New Issue
Block a user