feat(infra): tipos ConfigError y ConfigValidation + funciones puras Go (validate, merge, dump)
- ConfigError y ConfigValidation como tipos producto con sus .md en types/infra/ - config_validate: validacion con tags required/format/min/max/oneof via reflection - config_merge: merge no-mutante de map[string]string con precedencia de override - config_dump: serializacion de structs a map con mascara *** para campos secret - 17 tests unitarios, todos PASS Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,49 @@
|
||||
---
|
||||
name: config_dump
|
||||
kind: function
|
||||
lang: go
|
||||
domain: infra
|
||||
version: "1.0.0"
|
||||
purity: pure
|
||||
signature: "func ConfigDump(cfg any) map[string]string"
|
||||
description: "Convierte una struct de configuracion a map[string]string para logging o inspeccion. Campos con tag secret:\"true\" aparecen como \"***\". Solo campos exportados de nivel superior."
|
||||
tags: [config, dump, debug, logging, infra, reflect]
|
||||
uses_functions: []
|
||||
uses_types: []
|
||||
returns: []
|
||||
returns_optional: false
|
||||
error_type: ""
|
||||
imports: [fmt, reflect]
|
||||
params:
|
||||
- name: cfg
|
||||
desc: "struct de configuracion (valor o puntero) cuyos campos exportados se van a serializar a strings"
|
||||
output: "mapa string→string con cada campo exportado; valores secretos reemplazados con ***"
|
||||
tested: true
|
||||
tests:
|
||||
- "campos normales se incluyen como string"
|
||||
- "campos secret aparecen como tres asteriscos"
|
||||
- "campos no exportados no aparecen"
|
||||
- "puntero a struct funciona"
|
||||
- "struct con bool y float se formatean correctamente"
|
||||
test_file_path: "functions/infra/config_dump_test.go"
|
||||
file_path: "functions/infra/config_dump.go"
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```go
|
||||
type AppConfig struct {
|
||||
Host string
|
||||
Port int
|
||||
APIKey string `secret:"true"`
|
||||
}
|
||||
|
||||
cfg := AppConfig{Host: "localhost", Port: 8080, APIKey: "sk-abc123"}
|
||||
dump := ConfigDump(cfg)
|
||||
// dump = {"Host": "localhost", "Port": "8080", "APIKey": "***"}
|
||||
log.Printf("startup config: %v", dump)
|
||||
```
|
||||
|
||||
## Notas
|
||||
|
||||
Funcion pura. Usa fmt.Sprintf("%v") para formatear todos los tipos. No desciende a structs anidados. Util para logging seguro de configuracion al inicio de una app.
|
||||
Reference in New Issue
Block a user