---
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]
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.