egutierrez
5f4f1f7508
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
---
|
|
name: go_build_binary
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func GoBuildBinary(projectDir, outputPath string, ldflags string, tags string) error"
|
|
description: "Compila un binario Go desde un directorio de proyecto. Si ldflags está vacío usa -s -w (strip debug). Si outputPath está vacío usa build/{dirname} dentro del projectDir. Ejecuta con CGO_ENABLED=0."
|
|
tags: [go, build, binary, compile, infra, deploy]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [fmt, os, os/exec, path/filepath, strings]
|
|
params:
|
|
- name: projectDir
|
|
desc: "ruta del directorio Go (con main.go o go.mod)"
|
|
- name: outputPath
|
|
desc: "ruta donde guardar el binario o vacio para usar build/{dirname}"
|
|
- name: ldflags
|
|
desc: "flags de vinculacion Go o vacio para usar -s -w (strip)"
|
|
- name: tags
|
|
desc: "build tags Go (ej: fts5,cgo)"
|
|
output: "nil si la compilacion fue exitosa, error en caso contrario"
|
|
tested: true
|
|
tests: ["compila proyecto valido sin error", "outputPath vacio usa build/dirname por defecto", "ldflags vacio usa -s -w por defecto", "error si projectDir no existe"]
|
|
test_file_path: "functions/infra/go_build_binary_test.go"
|
|
file_path: "functions/infra/go_build_binary.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
// Compilar con opciones por defecto
|
|
err := GoBuildBinary("/home/user/apps/myapp", "", "", "")
|
|
// genera /home/user/apps/myapp/build/myapp
|
|
|
|
// Compilar con output y tags explícitos
|
|
err = GoBuildBinary("/home/user/apps/myapp", "/tmp/myapp-bin", "-s -w -X main.version=1.0", "fts5")
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
```
|
|
|
|
## Notas
|
|
|
|
Usa `CGO_ENABLED=0` para binarios estáticos compatibles con imágenes alpine. El flag `-trimpath` elimina rutas absolutas del binario para reproducibilidad. Los flags `-s -w` reducen el tamaño eliminando información de debug y la tabla de símbolos. Compatible con el flujo deploy_app que genera Dockerfile multi-stage.
|