feat: add bash shell utility functions

12 funciones Bash del dominio shell: utilidades de scripting (bash_log,
bash_colors, bash_check_deps, bash_confirm, bash_handle_error, bash_safe_run),
manipulacion de texto (convert_text_case), estructura de proyectos
(create_project_structure), y operaciones git (git_clean_branches,
git_log_visual, git_push_all_remotes, git_repo_status). Cada una con su
.sh y .md de frontmatter.
This commit is contained in:
2026-04-12 13:54:15 +02:00
parent 61c9042392
commit 61d8460149
24 changed files with 1522 additions and 0 deletions
+41
View File
@@ -0,0 +1,41 @@
---
name: git_repo_status
kind: function
lang: bash
domain: shell
version: "1.0.0"
purity: impure
signature: "git_repo_status() -> void"
description: "Muestra el estado completo de un repositorio Git: rama actual, upstream (ahead/behind), cambios pendientes, stash, remotes y últimos 8 commits. Sale con exit code 1 si el directorio actual no es un repo Git."
tags: [bash, git, status, repo, branch]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
- name: "(ninguno)"
desc: "opera sobre el directorio de trabajo actual (cwd)"
output: "imprime el estado completo del repo a stdout; exit code 1 si no es un repo Git"
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/shell/git_repo_status.sh"
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
source_license: "MIT"
source_file: "scripts/linux/git_utils/estado_repo.sh"
---
## Ejemplo
```bash
# Desde un directorio con repo git
cd /home/user/my-project
source bash/functions/shell/git_repo_status.sh
git_repo_status
```
## Notas
No requiere dependencias externas más allá de git. Los colores del log de commits usan `--color=always` de git directamente. No produce output en stdout en caso de error — los mensajes de error van a stderr.