egutierrez
47fac22230
- .claude/CLAUDE.md - .claude/commands/subagentes.md - .claude/rules/INDEX.md - .mcp.json - bash/functions/cybersecurity/analyze_dns.md - bash/functions/cybersecurity/audit_http_headers.md - bash/functions/cybersecurity/audit_ssh_config.md - bash/functions/cybersecurity/check_firewall.md - bash/functions/cybersecurity/detect_suspicious_users.md - bash/functions/cybersecurity/encrypt_file.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
---
|
|
name: env_require
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func EnvRequire(key string) (string, error)"
|
|
description: "Lee una variable de entorno con os.Getenv y retorna error descriptivo si esta vacia o no seteada. Fail-fast para variables obligatorias al arrancar la app."
|
|
tags: [env, config, os, infra, required, pendiente-usar]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [fmt, os]
|
|
params:
|
|
- name: key
|
|
desc: "nombre de la variable de entorno requerida (ej: DATABASE_URL, API_KEY)"
|
|
output: "valor de la variable si esta presente y no vacia, error descriptivo si falta"
|
|
tested: true
|
|
tests:
|
|
- "retorna valor cuando variable esta seteada"
|
|
- "retorna error con mensaje descriptivo si variable no existe"
|
|
- "variable vacia se trata como no seteada"
|
|
test_file_path: "functions/infra/env_require_test.go"
|
|
file_path: "functions/infra/env_require.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
dbURL, err := EnvRequire("DATABASE_URL")
|
|
if err != nil {
|
|
log.Fatal(err) // "env_require: environment variable \"DATABASE_URL\" is not set or empty"
|
|
}
|
|
```
|
|
|
|
## Notas
|
|
|
|
Wrapper minimo sobre os.Getenv. Trata vacio y no-seteado igual (ambos son error). Para multiples variables, usar EnvRequireAll que acumula todos los errores en una sola llamada.
|