linux-commands-guide 2.0.0__py3-none-any.whl

guia_linux/__init__.py

@@ -0,0 +1,4 @@
+from guia_linux.cli import main
+
+__version__ = "2.0.0"
+__all__ = ["main"]

guia_linux/cli.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+import argparse
+import sys
+from shellcolorize import Color
+from guia_linux.tools import TOOLS
+from guia_linux.utils import search_all, strip_ansi
+
+
+def _print_help(lang: str) -> None:
+    if lang == "en":
+        print(f"\n{Color.CYAN}{Color.BOLD}Linux Command Reference{Color.RESET} — usage:\n")
+        print(f"  {Color.GREEN}lh{Color.RESET} <tool>              Show commands for a tool")
+        print(f"  {Color.GREEN}lh{Color.RESET} -s <keyword>        Search across all tools")
+        print(f"  {Color.GREEN}lh{Color.RESET} --lang en <tool>    Force English output")
+        print(f"  {Color.GREEN}lh{Color.RESET} --lang es <tool>    Force Spanish output\n")
+    else:
+        print(f"\n{Color.CYAN}{Color.BOLD}Guía de Comandos Linux{Color.RESET} — uso:\n")
+        print(f"  {Color.GREEN}lh{Color.RESET} <herramienta>        Muestra comandos de una herramienta")
+        print(f"  {Color.GREEN}lh{Color.RESET} -s <término>         Busca en todas las herramientas")
+        print(f"  {Color.GREEN}lh{Color.RESET} --lang en <tool>     Fuerza salida en inglés")
+        print(f"  {Color.GREEN}lh{Color.RESET} --lang es <tool>     Fuerza salida en español\n")
+
+    label_tool = "Tool" if lang == "en" else "Herramienta"
+    label_desc = "Description" if lang == "en" else "Descripción"
+    print(f"  {Color.YELLOW}{label_tool:<16}{label_desc}{Color.RESET}")
+    print(f"  {'-' * 60}")
+    for name, module in sorted(TOOLS.items()):
+        desc = getattr(module, 'TITLE_EN' if lang == 'en' else 'TITLE', name.upper())
+        brief = getattr(module, 'BRIEF_EN' if lang == 'en' else 'BRIEF', '')
+        print(f"  {Color.GREEN}{name:<16}{Color.RESET}{brief}")
+    print()
+
+
+def _search(query: str, lang: str) -> None:
+    results = search_all(query, TOOLS, lang)
+    desc_key = "description_en" if lang == "en" else "description"
+    if not results:
+        msg = f"No results for '{query}'" if lang == "en" else f"Sin resultados para '{query}'"
+        print(f"\n{Color.RED}{msg}{Color.RESET}\n")
+        return
+
+    header = f"Results for '{query}'" if lang == "en" else f"Resultados para '{query}'"
+    print(f"\n{Color.CYAN}{Color.BOLD}{header}{Color.RESET} ({len(results)}):\n")
+    current_tool = None
+    for tool_name, entry in results:
+        if tool_name != current_tool:
+            print(f"\n  {Color.YELLOW}[{tool_name}]{Color.RESET}")
+            current_tool = tool_name
+        display = str(entry.get("command") or entry.get("logfile") or entry.get("pattern") or "")
+        desc = entry.get(desc_key, "")
+        clean = strip_ansi(display)
+        print(f"    {Color.GREEN}{clean}{Color.RESET}")
+        print(f"      {Color.RED}{desc}{Color.RESET}")
+    print()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(add_help=False)
+    parser.add_argument("tool", nargs="?", default=None)
+    parser.add_argument("-s", "--search", metavar="KEYWORD", default=None)
+    parser.add_argument("--lang", choices=["es", "en"], default="es")
+    parser.add_argument("-h", "--help", action="store_true")
+    args = parser.parse_args()
+
+    lang = args.lang
+
+    if args.help or (args.tool is None and args.search is None):
+        _print_help(lang)
+        return
+
+    if args.search:
+        _search(args.search, lang)
+        return
+
+    tool_key = args.tool.lower()
+    if tool_key not in TOOLS:
+        msg = (
+            f"Tool '{args.tool}' not found. Run 'lh --help' for the full list."
+            if lang == "en"
+            else f"Herramienta '{args.tool}' no encontrada. Ejecuta 'lh --help' para ver la lista."
+        )
+        print(f"\n{Color.RED}{msg}{Color.RESET}\n")
+        sys.exit(1)
+
+    TOOLS[tool_key].show(lang)
+
+
+if __name__ == "__main__":
+    main()

guia_linux/tools/__init__.py

@@ -0,0 +1,62 @@
+from guia_linux.tools import (
+    awk, cat, chmod, chown, crontab, curl, cut, df, docker, du,
+    file_descriptors, find, firewall_cmd, free, git, grep, head,
+    htop, ifconfig, ip, iptables, jq, logs, lsblk, lsof, lxc,
+    nc, netstat, nmap, ps, regex, rsync, scp, sed, shortcuts,
+    sort, ss, ssh, system, systemctl, tail, tar, tee, tmux,
+    top, tr, uname, uniq, vim, watch, xargs,
+)
+
+TOOLS = {
+    "awk":         awk,
+    "cat":         cat,
+    "chmod":       chmod,
+    "chown":       chown,
+    "crontab":     crontab,
+    "curl":        curl,
+    "cut":         cut,
+    "df":          df,
+    "docker":      docker,
+    "du":          du,
+    "descriptors": file_descriptors,
+    "find":        find,
+    "firewall-cmd": firewall_cmd,
+    "free":        free,
+    "git":         git,
+    "grep":        grep,
+    "head":        head,
+    "htop":        htop,
+    "ifconfig":    ifconfig,
+    "ip":          ip,
+    "iptables":    iptables,
+    "jq":          jq,
+    "logs":        logs,
+    "lsblk":       lsblk,
+    "lsof":        lsof,
+    "lxc":         lxc,
+    "nc":          nc,
+    "netstat":     netstat,
+    "nmap":        nmap,
+    "ps":          ps,
+    "regex":       regex,
+    "rsync":       rsync,
+    "scp":         scp,
+    "sed":         sed,
+    "shortcuts":   shortcuts,
+    "sort":        sort,
+    "ss":          ss,
+    "ssh":         ssh,
+    "system":      system,
+    "systemctl":   systemctl,
+    "tail":        tail,
+    "tar":         tar,
+    "tee":         tee,
+    "tmux":        tmux,
+    "top":         top,
+    "tr":          tr,
+    "uname":       uname,
+    "uniq":        uniq,
+    "vim":         vim,
+    "watch":       watch,
+    "xargs":       xargs,
+}

guia_linux/tools/awk.py

@@ -0,0 +1,39 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de AWK"
+TITLE_EN = "AWK Options"
+BRIEF = "Procesamiento de texto por columnas"
+BRIEF_EN = "Column-based text processing"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{print $1}}' filename", "description": "Imprime la primera columna de cada línea", "description_en": "Print the first column of each line"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{print $1, $3}}' filename", "description": "Imprime la primera y tercera columna", "description_en": "Print the first and third columns"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '$3 > 100' filename", "description": "Imprime líneas donde la tercera columna > 100", "description_en": "Print lines where the third column > 100"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} -F',' '{{print $1}}' filename", "description": "Usa ',' como delimitador de campo", "description_en": "Use ',' as field delimiter"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} 'NR==5' filename", "description": "Imprime solo la quinta línea", "description_en": "Print only the fifth line"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} 'NR>5 && NR<10' filename", "description": "Imprime las líneas del 6 al 9", "description_en": "Print lines 6 through 9"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '/word/' filename", "description": "Imprime líneas que contienen 'word'", "description_en": "Print lines containing 'word'"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '!/word/' filename", "description": "Imprime líneas que NO contienen 'word'", "description_en": "Print lines NOT containing 'word'"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{sum+=$1}} END {{print sum}}' filename", "description": "Suma la primera columna", "description_en": "Sum the first column"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{count++}} END {{print count}}' filename", "description": "Cuenta el número de líneas", "description_en": "Count the number of lines"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} 'BEGIN {{print \"Start\"}}' filename", "description": "Imprime texto antes de procesar", "description_en": "Print text before processing"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} 'END {{print \"End\"}}' filename", "description": "Imprime texto después de procesar", "description_en": "Print text after processing"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{print NR, $0}}' filename", "description": "Imprime número de línea seguido de la línea completa", "description_en": "Print line number followed by full line"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{print NF}}' filename", "description": "Imprime el número de campos de cada línea", "description_en": "Print the number of fields per line"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '$1 ~ /regex/' filename", "description": "Imprime líneas donde el campo 1 coincide con regex", "description_en": "Print lines where field 1 matches regex"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} 'length($0) > 20' filename", "description": "Imprime líneas con más de 20 caracteres", "description_en": "Print lines longer than 20 characters"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{print tolower($0)}}' filename", "description": "Convierte a minúsculas", "description_en": "Convert to lowercase"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{print toupper($0)}}' filename", "description": "Convierte a mayúsculas", "description_en": "Convert to uppercase"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{sub(/old/,\"new\"); print}}' filename", "description": "Reemplaza la primera ocurrencia de 'old' por 'new'", "description_en": "Replace first occurrence of 'old' with 'new'"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{gsub(/old/,\"new\"); print}}' filename", "description": "Reemplaza todas las ocurrencias de 'old' por 'new'", "description_en": "Replace all occurrences of 'old' with 'new'"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{if ($1>50) print $1}}' filename", "description": "Imprime campo 1 solo si es mayor a 50", "description_en": "Print field 1 only if greater than 50"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} 'BEGIN {{OFS=\",\"}} {{print $1,$2}}' filename", "description": "Usa ',' como separador de salida", "description_en": "Use ',' as output field separator"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{total+=$3}} END {{print total/NR}}' filename", "description": "Calcula el promedio de la tercera columna", "description_en": "Calculate the average of the third column"},
+    {"command": f"{Color.GREEN}awk{Color.RESET} '{{if ($2>max) max=$2}} END {{print max}}' filename", "description": "Encuentra el valor máximo de la segunda columna", "description_en": "Find the maximum value of the second column"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/cat.py

@@ -0,0 +1,29 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de CAT"
+TITLE_EN = "CAT Options"
+BRIEF = "Muestra y concatena contenido de archivos"
+BRIEF_EN = "Display and concatenate file contents"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}cat{Color.RESET} filename", "description": "Muestra el contenido del archivo", "description_en": "Display file contents"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} file1 file2 > output", "description": "Concatena file1 y file2 en output", "description_en": "Concatenate file1 and file2 into output"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -n filename", "description": "Muestra el contenido con números de línea", "description_en": "Show content with line numbers"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -b filename", "description": "Numera solo las líneas no vacías", "description_en": "Number only non-empty lines"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -s filename", "description": "Suprime líneas vacías consecutivas", "description_en": "Squeeze consecutive blank lines"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -T filename", "description": "Muestra tabulaciones como ^I", "description_en": "Show tabs as ^I"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -E filename", "description": "Muestra $ al final de cada línea", "description_en": "Show $ at end of each line"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -v filename", "description": "Muestra caracteres no imprimibles", "description_en": "Show non-printable characters"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -A filename", "description": "Muestra todos los caracteres especiales", "description_en": "Show all special characters"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -r, --line-range N:M filename", "description": "Muestra solo las líneas N a M (batcat)", "description_en": "Show only lines N to M (batcat)"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} --theme <theme>", "description": "Establece el tema de resaltado de sintaxis (batcat)", "description_en": "Set syntax-highlighting theme (batcat)"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} --paging never filename", "description": "Desactiva el paginador en batcat", "description_en": "Disable pager in batcat"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -u, --unbuffered", "description": "Desactiva el buffering (compatibilidad POSIX)", "description_en": "Disable buffering (POSIX compatibility)"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -L, --list-languages", "description": "Lista los lenguajes soportados para resaltado", "description_en": "List supported syntax-highlighting languages"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/chmod.py

@@ -0,0 +1,28 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de CHMOD"
+TITLE_EN = "CHMOD Options"
+BRIEF = "Cambia permisos de archivos y directorios"
+BRIEF_EN = "Change file and directory permissions"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}chmod{Color.RESET} 755 filename", "description": "rwx para propietario, rx para grupo y otros", "description_en": "rwx for owner, rx for group and others"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} 644 filename", "description": "rw para propietario, r para grupo y otros", "description_en": "rw for owner, r for group and others"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} +x filename", "description": "Añade permiso de ejecución a todos", "description_en": "Add execute permission for everyone"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} -x filename", "description": "Revoca permiso de ejecución a todos", "description_en": "Remove execute permission for everyone"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} u+w filename", "description": "Añade escritura solo al propietario", "description_en": "Add write permission for owner only"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} g-w filename", "description": "Revoca escritura al grupo", "description_en": "Remove write permission from group"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} o+r filename", "description": "Añade lectura a otros", "description_en": "Add read permission for others"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} u=rwx,g=rx,o= filename", "description": "Permisos exactos para cada categoría", "description_en": "Set exact permissions per category"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} -R 755 directory", "description": "Aplica permisos recursivamente", "description_en": "Apply permissions recursively"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} a+x filename", "description": "Añade ejecución para todos (all)", "description_en": "Add execute for all (all)"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} ug=rw filename", "description": "Lectura y escritura para propietario y grupo", "description_en": "Read and write for owner and group"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} 400 filename", "description": "Solo lectura para el propietario", "description_en": "Read-only for owner"},
+    {"command": f"{Color.GREEN}chmod{Color.RESET} 777 filename", "description": "Todos los permisos para todos los usuarios", "description_en": "All permissions for all users"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/chown.py

@@ -0,0 +1,22 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de CHOWN"
+TITLE_EN = "CHOWN Options"
+BRIEF = "Cambia propietario y grupo de archivos"
+BRIEF_EN = "Change file owner and group"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}chown{Color.RESET} user filename", "description": "Cambia el propietario a 'user'", "description_en": "Change owner to 'user'"},
+    {"command": f"{Color.GREEN}chown{Color.RESET} user:group filename", "description": "Cambia propietario y grupo", "description_en": "Change owner and group"},
+    {"command": f"{Color.GREEN}chown{Color.RESET} :group filename", "description": "Cambia solo el grupo", "description_en": "Change group only"},
+    {"command": f"{Color.GREEN}chown{Color.RESET} -R user directory", "description": "Cambia propietario recursivamente", "description_en": "Change owner recursively"},
+    {"command": f"{Color.GREEN}chown{Color.RESET} -R user:group directory", "description": "Cambia propietario y grupo recursivamente", "description_en": "Change owner and group recursively"},
+    {"command": f"{Color.GREEN}chown{Color.RESET} --from=old_user:new_user filename", "description": "Cambia solo si coincide con el propietario actual", "description_en": "Change only if current owner matches"},
+    {"command": f"{Color.GREEN}chown{Color.RESET} --reference=ref_file filename", "description": "Copia propietario y grupo de otro archivo", "description_en": "Copy owner and group from another file"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/crontab.py

@@ -0,0 +1,40 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de CRONTAB"
+TITLE_EN = "CRONTAB Options"
+BRIEF = "Programación de tareas periódicas"
+BRIEF_EN = "Periodic task scheduling"
+
+COMMANDS = [
+    {"section": "Gestión de crontab", "section_en": "Crontab Management"},
+    {"command": f"{Color.GREEN}crontab{Color.RESET} -e", "description": "Edita el crontab del usuario actual", "description_en": "Edit the current user's crontab"},
+    {"command": f"{Color.GREEN}crontab{Color.RESET} -l", "description": "Lista las tareas del crontab actual", "description_en": "List current crontab entries"},
+    {"command": f"{Color.GREEN}crontab{Color.RESET} -r", "description": "Elimina el crontab del usuario actual", "description_en": "Remove the current user's crontab"},
+    {"command": f"{Color.GREEN}crontab{Color.RESET} -u user -l", "description": "Lista el crontab de otro usuario (requiere root)", "description_en": "List another user's crontab (requires root)"},
+    {"command": f"{Color.GREEN}crontab{Color.RESET} file.cron", "description": "Instala un crontab desde un archivo", "description_en": "Install a crontab from a file"},
+
+    {"section": "Sintaxis de los campos  [min hora día mes día_semana]", "section_en": "Field Syntax  [min hour day month weekday]"},
+    {"command": f"{Color.YELLOW}* * * * *{Color.RESET} command", "description": "Ejecuta cada minuto", "description_en": "Run every minute"},
+    {"command": f"{Color.YELLOW}0 * * * *{Color.RESET} command", "description": "Ejecuta cada hora (al minuto 0)", "description_en": "Run every hour (at minute 0)"},
+    {"command": f"{Color.YELLOW}0 0 * * *{Color.RESET} command", "description": "Ejecuta cada día a medianoche", "description_en": "Run every day at midnight"},
+    {"command": f"{Color.YELLOW}0 9 * * 1{Color.RESET} command", "description": "Ejecuta cada lunes a las 9:00", "description_en": "Run every Monday at 9:00"},
+    {"command": f"{Color.YELLOW}0 0 1 * *{Color.RESET} command", "description": "Ejecuta el primer día de cada mes", "description_en": "Run on the first day of every month"},
+    {"command": f"{Color.YELLOW}*/15 * * * *{Color.RESET} command", "description": "Ejecuta cada 15 minutos", "description_en": "Run every 15 minutes"},
+    {"command": f"{Color.YELLOW}0 8-18 * * 1-5{Color.RESET} command", "description": "Ejecuta cada hora de 8 a 18, de lunes a viernes", "description_en": "Run hourly from 8 to 18, Monday to Friday"},
+    {"command": f"{Color.YELLOW}30 23 * * 0,6{Color.RESET} command", "description": "Ejecuta a las 23:30 los sábados y domingos", "description_en": "Run at 23:30 on Saturdays and Sundays"},
+
+    {"section": "Variables especiales", "section_en": "Special Variables"},
+    {"command": f"{Color.GREEN}MAILTO{Color.RESET}=user@example.com", "description": "Envía la salida por correo al usuario especificado", "description_en": "Send output by email to the specified user"},
+    {"command": f"{Color.GREEN}PATH{Color.RESET}=/usr/local/bin:/usr/bin:/bin", "description": "Define el PATH para los comandos del crontab", "description_en": "Set PATH for crontab commands"},
+    {"command": f"{Color.GREEN}@reboot{Color.RESET} command", "description": "Ejecuta el comando al arrancar el sistema", "description_en": "Run command at system boot"},
+    {"command": f"{Color.GREEN}@hourly{Color.RESET} command", "description": "Alias de '0 * * * *'", "description_en": "Alias for '0 * * * *'"},
+    {"command": f"{Color.GREEN}@daily{Color.RESET} command", "description": "Alias de '0 0 * * *'", "description_en": "Alias for '0 0 * * *'"},
+    {"command": f"{Color.GREEN}@weekly{Color.RESET} command", "description": "Alias de '0 0 * * 0'", "description_en": "Alias for '0 0 * * 0'"},
+    {"command": f"{Color.GREEN}@monthly{Color.RESET} command", "description": "Alias de '0 0 1 * *'", "description_en": "Alias for '0 0 1 * *'"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/curl.py

@@ -0,0 +1,29 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de CURL"
+TITLE_EN = "CURL Options"
+BRIEF = "Transfiere datos con URLs"
+BRIEF_EN = "Transfer data with URLs"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}curl{Color.RESET} https://example.com", "description": "Realiza una petición HTTP GET", "description_en": "Perform an HTTP GET request"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -I https://example.com", "description": "Muestra solo los encabezados de respuesta (HEAD)", "description_en": "Show only response headers (HEAD)"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -o file.txt https://example.com/file", "description": "Guarda la respuesta en un archivo", "description_en": "Save response to a file"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -O https://example.com/file.zip", "description": "Guarda con el nombre original del archivo", "description_en": "Save with the original filename"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -L https://example.com", "description": "Sigue redirecciones HTTP", "description_en": "Follow HTTP redirects"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -u user:pass https://example.com", "description": "Autenticación básica HTTP", "description_en": "HTTP basic authentication"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -d 'key=value' https://example.com", "description": "Envía datos POST", "description_en": "Send POST data"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -H 'Content-Type: application/json' URL", "description": "Añade una cabecera personalizada", "description_en": "Add a custom request header"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -X PUT https://example.com", "description": "Usa el método HTTP especificado", "description_en": "Use the specified HTTP method"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -s https://example.com", "description": "Modo silencioso — sin barra de progreso", "description_en": "Silent mode — no progress bar"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -v https://example.com", "description": "Modo verbose — muestra detalles de la conexión", "description_en": "Verbose mode — show connection details"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -k https://self-signed.example.com", "description": "Acepta certificados SSL no verificados", "description_en": "Accept unverified SSL certificates"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} --limit-rate 100K https://example.com", "description": "Limita la velocidad de transferencia", "description_en": "Limit transfer speed"},
+    {"command": f"{Color.GREEN}curl{Color.RESET} -x proxy:8080 https://example.com", "description": "Usa un proxy HTTP", "description_en": "Use an HTTP proxy"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/cut.py

@@ -0,0 +1,21 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de CUT"
+TITLE_EN = "CUT Options"
+BRIEF = "Extrae secciones de cada línea"
+BRIEF_EN = "Extract sections from each line"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}cut{Color.RESET} -d',' -f2 filename", "description": "Extrae la 2ª columna usando ',' como delimitador", "description_en": "Extract 2nd column using ',' as delimiter"},
+    {"command": f"{Color.GREEN}cut{Color.RESET} -f1,3 filename", "description": "Extrae la 1ª y 3ª columna (tabulación)", "description_en": "Extract 1st and 3rd column (tab-delimited)"},
+    {"command": f"{Color.GREEN}cut{Color.RESET} -c1-5 filename", "description": "Extrae los primeros 5 caracteres de cada línea", "description_en": "Extract the first 5 characters of each line"},
+    {"command": f"{Color.GREEN}cut{Color.RESET} -d':' -f1 /etc/passwd", "description": "Extrae el primer campo de /etc/passwd", "description_en": "Extract the first field from /etc/passwd"},
+    {"command": f"{Color.GREEN}cut{Color.RESET} -d' ' -f1-3 filename", "description": "Extrae los tres primeros campos separados por espacio", "description_en": "Extract the first three space-separated fields"},
+    {"command": f"{Color.GREEN}cut{Color.RESET} -s -d',' -f2 filename", "description": "Muestra solo líneas que contienen el delimitador", "description_en": "Show only lines containing the delimiter"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/df.py

@@ -0,0 +1,30 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de DF"
+TITLE_EN = "DF Options"
+BRIEF = "Muestra el uso de espacio en disco"
+BRIEF_EN = "Display disk space usage"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}df{Color.RESET}", "description": "Muestra el espacio en disco de todos los sistemas de archivos", "description_en": "Show disk space for all filesystems"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -h", "description": "Formato legible (KB, MB, GB)", "description_en": "Human-readable format (KB, MB, GB)"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -H", "description": "Formato legible usando potencias de 1000", "description_en": "Human-readable using powers of 1000"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -a", "description": "Incluye sistemas de archivos de tamaño 0", "description_en": "Include 0-block filesystems"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -T", "description": "Muestra el tipo de sistema de archivos", "description_en": "Show filesystem type"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -t TYPE", "description": "Muestra solo sistemas de archivos del tipo indicado", "description_en": "Show only filesystems of the given type"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -x TYPE", "description": "Excluye sistemas de archivos del tipo indicado", "description_en": "Exclude filesystems of the given type"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -i", "description": "Muestra uso de inodos en lugar de bloques", "description_en": "Show inode usage instead of blocks"},
+    {"command": f"{Color.GREEN}df{Color.RESET} --total", "description": "Añade una línea con el total al final", "description_en": "Add a grand total line"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -l", "description": "Muestra solo sistemas de archivos locales", "description_en": "Show only local filesystems"},
+    {"command": f"{Color.GREEN}df{Color.RESET} --output=source,size,used,avail", "description": "Muestra solo los campos especificados", "description_en": "Show only the specified fields"},
+    {"command": f"{Color.GREEN}df{Color.RESET} --block-size=1M", "description": "Muestra tamaños en bloques de 1 MB", "description_en": "Show sizes in 1 MB blocks"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -k", "description": "Muestra tamaños en bloques de 1024 bytes", "description_en": "Show sizes in 1024-byte blocks"},
+    {"command": f"{Color.GREEN}df{Color.RESET} -m", "description": "Muestra tamaños en megabytes", "description_en": "Show sizes in megabytes"},
+    {"command": f"{Color.GREEN}df{Color.RESET} --inodes", "description": "Muestra información de inodos", "description_en": "Show inode information"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/docker.py

@@ -0,0 +1,39 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de DOCKER"
+TITLE_EN = "DOCKER Options"
+BRIEF = "Gestión de contenedores Docker"
+BRIEF_EN = "Docker container management"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}docker{Color.RESET} ps", "description": "Lista los contenedores en ejecución", "description_en": "List running containers"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} ps -a", "description": "Lista todos los contenedores (incluidos detenidos)", "description_en": "List all containers (including stopped)"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} images", "description": "Lista todas las imágenes disponibles", "description_en": "List all available images"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} run image_name", "description": "Inicia un contenedor desde la imagen", "description_en": "Start a container from an image"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} run -d image_name", "description": "Inicia un contenedor en segundo plano", "description_en": "Start a container in background (detached)"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} run -it image_name bash", "description": "Inicia un contenedor interactivo con shell", "description_en": "Start an interactive container with shell"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} run -p 8080:80 image_name", "description": "Mapea puerto del host al contenedor", "description_en": "Map host port to container port"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} start container_id", "description": "Inicia un contenedor detenido", "description_en": "Start a stopped container"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} stop container_id", "description": "Detiene un contenedor en ejecución", "description_en": "Stop a running container"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} restart container_id", "description": "Reinicia un contenedor", "description_en": "Restart a container"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} rm container_id", "description": "Elimina un contenedor detenido", "description_en": "Remove a stopped container"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} rmi image_id", "description": "Elimina una imagen", "description_en": "Remove an image"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} pull image_name", "description": "Descarga una imagen desde Docker Hub", "description_en": "Pull an image from Docker Hub"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} build -t name .", "description": "Construye una imagen desde un Dockerfile", "description_en": "Build an image from a Dockerfile"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} exec -it container_id bash", "description": "Ejecuta un shell interactivo en el contenedor", "description_en": "Run an interactive shell inside a container"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} logs container_id", "description": "Muestra los logs de un contenedor", "description_en": "Show container logs"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} logs -f container_id", "description": "Sigue los logs en tiempo real", "description_en": "Follow container logs in real time"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} inspect container_id", "description": "Muestra información detallada del contenedor", "description_en": "Show detailed container information"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} network ls", "description": "Lista las redes de Docker", "description_en": "List Docker networks"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} volume ls", "description": "Lista los volúmenes de Docker", "description_en": "List Docker volumes"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} system prune", "description": "Limpia recursos no utilizados", "description_en": "Remove unused containers, images, and networks"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} stats", "description": "Muestra el uso de recursos en tiempo real", "description_en": "Show live resource usage stats"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} compose up -d", "description": "Lanza servicios definidos en docker-compose.yml", "description_en": "Start services defined in docker-compose.yml"},
+    {"command": f"{Color.GREEN}docker{Color.RESET} compose down", "description": "Detiene y elimina los servicios de compose", "description_en": "Stop and remove compose services"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/du.py

@@ -0,0 +1,32 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de DU"
+TITLE_EN = "DU Options"
+BRIEF = "Muestra el uso de espacio de directorios"
+BRIEF_EN = "Display directory space usage"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}du{Color.RESET}", "description": "Muestra el tamaño de archivos y directorios actuales", "description_en": "Show size of files and directories"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -a", "description": "Incluye archivos individuales en la salida", "description_en": "Include individual files in output"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -h", "description": "Formato legible (KB, MB, GB)", "description_en": "Human-readable format (KB, MB, GB)"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -s", "description": "Muestra solo el total de cada argumento", "description_en": "Show only the total for each argument"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -c", "description": "Muestra un total acumulado al final", "description_en": "Show a grand total at the end"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -k", "description": "Muestra tamaños en bloques de 1024 bytes", "description_en": "Show sizes in 1024-byte blocks"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -m", "description": "Muestra tamaños en megabytes", "description_en": "Show sizes in megabytes"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -b", "description": "Muestra tamaños en bytes", "description_en": "Show sizes in bytes"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -L", "description": "Sigue enlaces simbólicos", "description_en": "Follow symbolic links"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -x", "description": "Omite directorios en otros sistemas de archivos", "description_en": "Skip directories on other filesystems"},
+    {"command": f"{Color.GREEN}du{Color.RESET} -d N", "description": "Muestra hasta N niveles de profundidad", "description_en": "Show up to N levels of depth"},
+    {"command": f"{Color.GREEN}du{Color.RESET} --max-depth=N", "description": "Similar a -d N", "description_en": "Same as -d N"},
+    {"command": f"{Color.GREEN}du{Color.RESET} --threshold=SIZE", "description": "Muestra solo entradas mayores o iguales a SIZE", "description_en": "Show only entries >= SIZE"},
+    {"command": f"{Color.GREEN}du{Color.RESET} --exclude=PATTERN", "description": "Excluye archivos que coincidan con PATTERN", "description_en": "Exclude files matching PATTERN"},
+    {"command": f"{Color.GREEN}du{Color.RESET} --apparent-size", "description": "Muestra el tamaño aparente en lugar de bloques usados", "description_en": "Show apparent size instead of disk usage"},
+    {"command": f"{Color.GREEN}du{Color.RESET} --inodes", "description": "Cuenta inodos en lugar de tamaño", "description_en": "Count inodes instead of size"},
+    {"command": f"{Color.GREEN}du{Color.RESET} --time", "description": "Muestra la fecha de última modificación", "description_en": "Show last modification time"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/file_descriptors.py

@@ -0,0 +1,32 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Descriptores de Archivo y Redirecciones"
+TITLE_EN = "File Descriptors and Redirections"
+BRIEF = "Redirecciones de stdin, stdout y stderr"
+BRIEF_EN = "stdin, stdout and stderr redirections"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}command{Color.RESET} > file", "description": "Redirige stdout a un archivo (sobreescribe)", "description_en": "Redirect stdout to file (overwrite)"},
+    {"command": f"{Color.GREEN}command{Color.RESET} >> file", "description": "Agrega stdout al final de un archivo", "description_en": "Append stdout to file"},
+    {"command": f"{Color.GREEN}command{Color.RESET} 2> file", "description": "Redirige stderr a un archivo", "description_en": "Redirect stderr to file"},
+    {"command": f"{Color.GREEN}command{Color.RESET} 2>> file", "description": "Agrega stderr al final de un archivo", "description_en": "Append stderr to file"},
+    {"command": f"{Color.GREEN}command{Color.RESET} > file 2>&1", "description": "Redirige stdout y stderr al mismo archivo", "description_en": "Redirect both stdout and stderr to file"},
+    {"command": f"{Color.GREEN}command{Color.RESET} &> file", "description": "Redirige stdout y stderr (forma corta)", "description_en": "Redirect stdout and stderr (shorthand)"},
+    {"command": f"{Color.GREEN}command{Color.RESET} < file", "description": "Usa un archivo como stdin", "description_en": "Use file as stdin"},
+    {"command": f"{Color.GREEN}command{Color.RESET} 2> /dev/null", "description": "Descarta stderr", "description_en": "Discard stderr"},
+    {"command": f"{Color.GREEN}command{Color.RESET} > /dev/null", "description": "Descarta stdout", "description_en": "Discard stdout"},
+    {"command": f"{Color.GREEN}command{Color.RESET} > /dev/null 2>&1", "description": "Descarta stdout y stderr", "description_en": "Discard both stdout and stderr"},
+    {"command": f"{Color.GREEN}command{Color.RESET} 3> file", "description": "Redirige el descriptor 3 a un archivo", "description_en": "Redirect file descriptor 3 to file"},
+    {"command": f"{Color.GREEN}command{Color.RESET} 3>&-", "description": "Cierra el descriptor de archivo 3", "description_en": "Close file descriptor 3"},
+    {"command": f"{Color.GREEN}exec{Color.RESET} 3> file", "description": "Abre el descriptor 3 para escritura", "description_en": "Open fd 3 for writing"},
+    {"command": f"{Color.GREEN}exec{Color.RESET} 3< file", "description": "Abre el descriptor 3 para lectura", "description_en": "Open fd 3 for reading"},
+    {"command": f"{Color.GREEN}command1{Color.RESET} | command2", "description": "Conecta stdout de command1 a stdin de command2", "description_en": "Pipe stdout of command1 to stdin of command2"},
+    {"command": f"{Color.GREEN}command{Color.RESET} | tee file", "description": "Escribe stdout en un archivo y en pantalla", "description_en": "Write stdout to file and screen simultaneously"},
+    {"command": f"{Color.GREEN}command{Color.RESET} | tee -a file", "description": "Agrega stdout al archivo y lo muestra en pantalla", "description_en": "Append stdout to file and display on screen"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

guia_linux/tools/find.py

@@ -0,0 +1,38 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de FIND"
+TITLE_EN = "FIND Options"
+BRIEF = "Busca archivos y directorios"
+BRIEF_EN = "Search for files and directories"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}find{Color.RESET} /path", "description": "Busca todos los archivos y directorios en la ruta", "description_en": "List all files and directories under path"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -name 'file'", "description": "Busca por nombre exacto", "description_en": "Search by exact name"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -iname 'file'", "description": "Busca por nombre ignorando mayúsculas", "description_en": "Case-insensitive name search"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -type f", "description": "Busca solo archivos", "description_en": "Find regular files only"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -type d", "description": "Busca solo directorios", "description_en": "Find directories only"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -size +100M", "description": "Busca archivos mayores de 100 MB", "description_en": "Find files larger than 100 MB"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -size -100M", "description": "Busca archivos menores de 100 MB", "description_en": "Find files smaller than 100 MB"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -mtime -7", "description": "Archivos modificados en los últimos 7 días", "description_en": "Files modified in the last 7 days"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -atime -7", "description": "Archivos accedidos en los últimos 7 días", "description_en": "Files accessed in the last 7 days"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -mmin -30", "description": "Archivos modificados en los últimos 30 minutos", "description_en": "Files modified in the last 30 minutes"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -user username", "description": "Archivos pertenecientes a un usuario", "description_en": "Files owned by a specific user"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -group groupname", "description": "Archivos pertenecientes a un grupo", "description_en": "Files belonging to a group"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -perm 755", "description": "Archivos con permisos exactos 755", "description_en": "Files with exact permissions 755"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -empty", "description": "Archivos o directorios vacíos", "description_en": "Find empty files or directories"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -exec cmd {{}} \\;", "description": "Ejecuta un comando en cada resultado", "description_en": "Execute a command on each result"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -delete", "description": "Elimina los archivos encontrados", "description_en": "Delete found files"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -name '*.txt' -o -name '*.log'", "description": "Busca archivos .txt o .log", "description_en": "Find .txt or .log files"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -not -name '*.txt'", "description": "Excluye archivos con el nombre especificado", "description_en": "Exclude files matching name"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -maxdepth 2", "description": "Limita la búsqueda a 2 niveles de profundidad", "description_en": "Limit search depth to 2 levels"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -mindepth 2", "description": "Omite los primeros 2 niveles de profundidad", "description_en": "Skip the first 2 directory levels"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -newer file", "description": "Archivos más recientes que 'file'", "description_en": "Files newer than 'file'"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -type f -exec chmod 644 {{}} \\;", "description": "Cambia permisos de archivos encontrados a 644", "description_en": "Set permissions of found files to 644"},
+    {"command": f"{Color.GREEN}find{Color.RESET} /path -type f -print0 | xargs -0 grep 'pat'", "description": "Busca un patrón en el contenido de los archivos", "description_en": "Search for a pattern inside found files"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)