egutierrez
8bc721d53b
7 funciones Go del dominio tui: apply_gradient (gradiente de color en texto), draw_box y draw_separator (renderizado de cajas y separadores con box_chars), load_ascii_art (carga de arte ASCII desde archivos), normalize_terminal_output y strip_ansi (limpieza de salida de terminal), read_dir_autocomplete (autocompletado de rutas de directorio). Incluye box_chars.go como helper de caracteres Unicode para bordes.
45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
---
|
|
name: read_dir_autocomplete
|
|
kind: function
|
|
lang: go
|
|
domain: tui
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func ReadDirAutocomplete(searchDir, prefix string) ([]AutocompleteCandidate, error)"
|
|
description: "Lee entradas de un directorio filtradas por prefijo (case-insensitive). Retorna candidatos ordenados por nombre, utiles para autocompletado de rutas en TUIs."
|
|
tags: [tui, autocomplete, directory, path, filter, completion]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [os, sort, strings]
|
|
params:
|
|
- name: searchDir
|
|
desc: "directorio donde buscar entradas"
|
|
- name: prefix
|
|
desc: "prefijo para filtrar nombres (case-insensitive); vacio retorna todas"
|
|
output: "slice de AutocompleteCandidate con Name y IsDir, ordenados alfabeticamente"
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "functions/tui/read_dir_autocomplete.go"
|
|
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
|
|
source_license: "MIT"
|
|
source_file: "launcher/middleware/command_fs.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
candidates, err := tui.ReadDirAutocomplete("/home/user", "doc")
|
|
// candidates podria ser: [{Name:"Documents" IsDir:true}, {Name:"docker-compose.yml" IsDir:false}]
|
|
|
|
// Sin prefijo retorna todas las entradas
|
|
all, _ := tui.ReadDirAutocomplete("/tmp", "")
|
|
```
|
|
|
|
## Notas
|
|
|
|
El struct `AutocompleteCandidate` se define en el mismo archivo. El campo `IsDir` permite al caller diferenciar directorios de archivos para renderizar iconos o sufijos distintos.
|