Files
fn_registry/bash/functions/shell/find_free_port.md
T
egutierrez 988e901066 docs: params/output semántico en 506 funciones para composabilidad
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.
2026-04-05 18:45:16 +02:00

1.0 KiB

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
name kind lang domain version purity signature description tags uses_functions uses_types returns returns_optional error_type imports params output tested tests test_file_path file_path
find_free_port function bash shell 1.0.0 impure find_free_port([start_port: int], [end_port: int]) -> int Busca el primer puerto TCP libre en un rango dado usando ss y lsof. Retorna el numero de puerto a stdout.
network
port
shell
utility
false error_go_core
name desc
start_port puerto inicial del rango (default: 8888)
name desc
end_port puerto final del rango (default: 8899)
número de puerto TCP libre false
bash/functions/shell/find_free_port.sh

Ejemplo

source find_free_port.sh
port=$(find_free_port 8888 8899)
echo "Puerto libre: $port"

# Con defaults (8888-8899)
port=$(find_free_port)

Notas

Usa ss -tln como primer intento y lsof como fallback. Ambos deben confirmar que el puerto no esta en uso. Si ningun puerto esta libre en el rango, sale con exit code 1.