---
name: bash_safe_run
kind: function
lang: bash
domain: shell
version: "1.0.0"
purity: impure
signature: "safe_run(cmd: string, [error_code: string], [error_desc: string]) -> void; setup_error_trap() -> void; error_trap_handler(exit_code: int, line_number: int) -> void"
description: "Ejecuta comandos con manejo de errores integrado. Incluye trap handler que captura fallos con numero de linea y codigo de salida."
tags: [bash, safe, run, error, trap, handler]
uses_functions: [bash_log_bash_shell]
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: cmd
    desc: "comando a ejecutar via eval"
  - name: error_code
    desc: "codigo identificador del error en caso de fallo; default COMMAND_FAILED"
  - name: error_desc
    desc: "descripcion del error a mostrar; default 'El comando fallo: CMD'"
output: "exit code 0 si el comando tuvo exito; exit code 1 con mensaje de error formateado si fallo"
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/shell/bash_safe_run.sh"
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
source_license: "MIT"
source_file: "scripts/lib/common.sh"
---

## Ejemplo

```bash
source bash/functions/shell/bash_safe_run.sh
bash_log_init
setup_error_trap

safe_run "go build ./..." "BUILD_FAILED" "La compilacion fallo"
safe_run "docker compose up -d" "DOCKER_FAILED" "No se pudo iniciar Docker Compose"
safe_run "npm install" "NPM_FAILED"
```

## Notas

`safe_run` usa `eval` internamente para ejecutar el comando, lo que permite pasar comandos con pipes y redirecciones como string. Usar con precaucion en entornos con input no confiable.

`setup_error_trap` instala un trap `ERR` que llama a `error_trap_handler` automaticamente en cualquier comando fallido del script, mostrando numero de linea y codigo de salida.

`error_trap_handler` no llama a `exit` — el caller decide si continuar o abortar. Muestra la ruta al log para debugging.