feat: logger_new y logger_with sobre log/slog (infra)
- logger_new (impuro): construye *Logger con handler JSON/text segun formato - logger_with (puro): clona el Logger anadiendo campos contextuales via slog.With Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
---
|
||||
name: logger_with
|
||||
kind: function
|
||||
lang: go
|
||||
domain: infra
|
||||
version: "1.0.0"
|
||||
purity: pure
|
||||
signature: "func LoggerWith(logger *Logger, fields map[string]any) *Logger"
|
||||
description: "Retorna una copia del Logger con campos contextuales adicionales. No muta el logger original — los campos se apilan sobre los existentes y aparecen en cada entrada del nuevo logger."
|
||||
tags: [logging, log, slog, logger, context, pure, infra]
|
||||
uses_functions: []
|
||||
uses_types: [Logger_go_infra]
|
||||
returns: [Logger_go_infra]
|
||||
returns_optional: false
|
||||
error_type: ""
|
||||
imports: [sort]
|
||||
params:
|
||||
- name: logger
|
||||
desc: "Logger base a clonar. Si es nil retorna nil"
|
||||
- name: fields
|
||||
desc: "mapa de campos key-value a anadir al logger (ej: {\"app\": \"api\", \"request_id\": \"abc\"})"
|
||||
output: "nuevo Logger con los fields combinados (los del parametro tienen precedencia sobre los del logger base)"
|
||||
tested: true
|
||||
tests: ["anade campos al logger", "no muta el logger original", "apila fields sobre un logger ya contextualizado", "retorna nil si recibe nil"]
|
||||
test_file_path: "functions/infra/logger_test.go"
|
||||
file_path: "functions/infra/logger_with.go"
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```go
|
||||
base, _ := LoggerNew(LogLevelInfo, os.Stdout, "json")
|
||||
appLog := LoggerWith(base, map[string]any{"app": "sqlite_api", "version": "1.0.0"})
|
||||
reqLog := LoggerWith(appLog, map[string]any{"request_id": "abc-123"})
|
||||
|
||||
LogInfo(reqLog, "evento")
|
||||
// {"...","msg":"evento","app":"sqlite_api","version":"1.0.0","request_id":"abc-123"}
|
||||
```
|
||||
|
||||
## Notas
|
||||
|
||||
Funcion pura — no hace I/O, no muta estado. Internamente llama a `slog.Logger.With()` que ya retorna un nuevo logger. Los campos se pasan en orden alfabetico a `With()` para que el output sea determinista (util para tests). El campo `Fields` del `*Logger` mantiene la union combinada (base + nuevos) para permitir inspeccion programatica.
|
||||
Reference in New Issue
Block a user