linux-commands-guide 2.0.0__tar.gz → 2.0.1__tar.gz

{linux_commands_guide-2.0.0 → linux_commands_guide-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linux-commands-guide
-Version: 2.0.0
+Version: 2.0.1
 Summary: Bilingual ES/EN interactive Linux command reference — 50+ tools with keyword search
 Author-email: Serber1990 <serber1990@pm.me>
 License-Expression: MIT

{linux_commands_guide-2.0.0 → linux_commands_guide-2.0.1}/guia_linux/__init__.py

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

linux_commands_guide-2.0.1/guia_linux/cli.py

@@ -0,0 +1,129 @@
+#!/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 _help_header(lang: str) -> None:
+    title = 'Linux Command Reference' if lang == 'en' else 'Guía de Comandos Linux'
+    w = max(46, len(title) + 6)
+    border = '═' * w
+    print()
+    print(f"  {Color.CYAN}╔{border}╗{Color.RESET}")
+    print(f"  {Color.CYAN}║{Color.RESET}  {Color.BOLD}{Color.CYAN}{title}{Color.RESET}"
+          + ' ' * max(0, w - len(title) - 2)
+          + f"  {Color.CYAN}║{Color.RESET}")
+    print(f"  {Color.CYAN}╚{border}╝{Color.RESET}")
+
+
+def _print_help(lang: str) -> None:
+    _help_header(lang)
+
+    if lang == 'en':
+        print(f"""
+  {Color.BOLD}Usage{Color.RESET}
+    {Color.GREEN}lh{Color.RESET} <tool>                  Show commands for a tool
+    {Color.GREEN}lh{Color.RESET} <tool> --lang en         Force English output
+    {Color.GREEN}lh{Color.RESET} -s <keyword>             Search across all tools
+    {Color.GREEN}lh{Color.RESET} -s <keyword> --lang en   Search with English descriptions
+
+  {Color.BOLD}Examples{Color.RESET}
+    {Color.GREEN}lh grep{Color.RESET}                     All grep options
+    {Color.GREEN}lh --lang en docker{Color.RESET}         Docker commands in English
+    {Color.GREEN}lh -s recursive{Color.RESET}             Find every command mentioning "recursive"
+""")
+    else:
+        print(f"""
+  {Color.BOLD}Uso{Color.RESET}
+    {Color.GREEN}lh{Color.RESET} <herramienta>              Muestra comandos de una herramienta
+    {Color.GREEN}lh{Color.RESET} <herramienta> --lang es    Fuerza salida en español
+    {Color.GREEN}lh{Color.RESET} -s <término>               Busca en todas las herramientas
+    {Color.GREEN}lh{Color.RESET} -s <término> --lang en     Busca con descripciones en inglés
+
+  {Color.BOLD}Ejemplos{Color.RESET}
+    {Color.GREEN}lh grep{Color.RESET}                       Todas las opciones de grep
+    {Color.GREEN}lh --lang en docker{Color.RESET}           Comandos docker en inglés
+    {Color.GREEN}lh -s recursivo{Color.RESET}               Busca comandos con "recursivo"
+""")
+
+    label = 'Tool' if lang == 'en' else 'Herramienta'
+    desc  = 'Description' if lang == 'en' else 'Descripción'
+    print(f"  {Color.BOLD}{Color.GREEN}{label:<18}{desc}{Color.RESET}")
+    print(f"  {Color.DIM}{'─' * 60}{Color.RESET}")
+    for name, module in sorted(TOOLS.items()):
+        brief = getattr(module, 'BRIEF_EN' if lang == 'en' else 'BRIEF', '')
+        print(f"  {Color.GREEN}{name:<18}{Color.RESET}{Color.DIM}{brief}{Color.RESET}")
+    print()
+
+
+def _search(query: str, lang: str) -> None:
+    results  = search_all(query, TOOLS, lang)
+    desc_key = 'description_en' if lang == 'en' else 'description'
+
+    w = 50
+    border = '═' * w
+    header = f"Search: {query}" if lang == 'en' else f"Búsqueda: {query}"
+    count  = f'{len(results)} result{"s" if len(results) != 1 else ""}' if lang == 'en' \
+             else f'{len(results)} resultado{"s" if len(results) != 1 else ""}'
+
+    print()
+    print(f"  {Color.CYAN}╔{border}╗{Color.RESET}")
+    print(f"  {Color.CYAN}║{Color.RESET}  {Color.BOLD}{Color.CYAN}{header}{Color.RESET}"
+          + ' ' * max(0, w - len(header) - 2)
+          + f"  {Color.CYAN}║{Color.RESET}")
+    print(f"  {Color.CYAN}╚{border}╝{Color.RESET}")
+
+    if not results:
+        msg = f"No results for '{query}'" if lang == 'en' else f"Sin resultados para '{query}'"
+        print(f"\n  {Color.DIM}{msg}{Color.RESET}\n")
+        return
+
+    print(f"\n  {Color.DIM}{count}{Color.RESET}\n")
+
+    current_tool = None
+    for tool_name, entry in results:
+        if tool_name != current_tool:
+            print(f"  {Color.CYAN}▶  {Color.BOLD}{tool_name}{Color.RESET}")
+            current_tool = tool_name
+        display = strip_ansi(str(
+            entry.get('command') or entry.get('logfile') or entry.get('pattern') or ''
+        ))
+        desc = entry.get(desc_key, '')
+        print(f"    {Color.GREEN}{display}{Color.RESET}")
+        print(f"    {Color.DIM}{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
+
+    key = args.tool.lower()
+    if 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[key].show(lang)
+
+
+if __name__ == '__main__':
+    main()

linux_commands_guide-2.0.1/guia_linux/utils.py

@@ -0,0 +1,97 @@
+import re
+from shellcolorize import Color
+
+_ANSI = re.compile(r'\033\[[0-9;]*m')
+
+
+def strip_ansi(text: str) -> str:
+    return _ANSI.sub('', text)
+
+
+def ansi_ljust(text: str, width: int) -> str:
+    """Pad text to visible width, ignoring ANSI escape codes."""
+    visible = len(strip_ansi(text))
+    return text + ' ' * max(0, width - visible)
+
+
+# ── Shared visual primitives ──────────────────────────────────────────────────
+
+def _header(title: str) -> None:
+    w = max(46, len(title) + 6)
+    border = '═' * w
+    print()
+    print(f"  {Color.CYAN}╔{border}╗{Color.RESET}")
+    print(f"  {Color.CYAN}║{Color.RESET}  {Color.BOLD}{Color.CYAN}{title}{Color.RESET}"
+          + ' ' * max(0, w - len(title) - 2)
+          + f"  {Color.CYAN}║{Color.RESET}")
+    print(f"  {Color.CYAN}╚{border}╝{Color.RESET}")
+    print()
+
+
+def _column_headers(cmd_label: str, desc_label: str, cmd_width: int = 50) -> None:
+    print(f"  {Color.BOLD}{Color.GREEN}{cmd_label:<{cmd_width}}{Color.RESET}"
+          f"  {Color.BOLD}{Color.GREEN}{desc_label}{Color.RESET}")
+    print(f"  {Color.DIM}{'─' * (cmd_width + 2 + 42)}{Color.RESET}")
+
+
+def _section(text: str) -> None:
+    print()
+    print(f"  {Color.CYAN}▶  {Color.BOLD}{text}{Color.RESET}")
+    print(f"  {Color.DIM}{'─' * 94}{Color.RESET}")
+
+
+# ── Main table printer ────────────────────────────────────────────────────────
+
+def print_table(title: str, commands: list, lang: str = 'es') -> None:
+    desc_key   = 'description_en' if lang == 'en' else 'description'
+    cmd_label  = 'Command'     if lang == 'en' else 'Comando'
+    desc_label = 'Description' if lang == 'en' else 'Descripción'
+    CMD_WIDTH  = 50
+
+    _header(title)
+    has_sections = any('section' in e or 'category' in e for e in commands)
+
+    if not has_sections:
+        _column_headers(cmd_label, desc_label, CMD_WIDTH)
+
+    for entry in commands:
+        # ── Section / category header ──────────────────────────────────────
+        if 'section' in entry or 'category' in entry:
+            key  = 'section' if 'section' in entry else 'category'
+            text = entry.get(f'{key}_en' if lang == 'en' else key, entry.get(key, ''))
+            if text:
+                if not any(e for e in commands[:commands.index(entry)]
+                           if 'section' in e or 'category' in e):
+                    _column_headers(cmd_label, desc_label, CMD_WIDTH)
+                _section(strip_ansi(str(text)))
+            continue
+
+        display = entry.get('command') or entry.get('logfile') or entry.get('pattern') or ''
+        desc    = entry.get(desc_key, '')
+
+        if display or desc:
+            padded = ansi_ljust(str(display), CMD_WIDTH)
+            print(f"  {padded}  {Color.DIM}{desc}{Color.RESET}")
+
+    print()
+
+
+# ── Cross-tool search ─────────────────────────────────────────────────────────
+
+def search_all(query: str, tools: dict, lang: str = 'es') -> list:
+    desc_key = 'description_en' if lang == 'en' else 'description'
+    results  = []
+    q        = query.lower()
+    for tool_name, module in tools.items():
+        for entry in getattr(module, 'COMMANDS', []):
+            if 'section' in entry or 'category' in entry:
+                continue
+            display = strip_ansi(str(
+                entry.get('command') or
+                entry.get('logfile') or
+                entry.get('pattern') or ''
+            ))
+            desc = entry.get(desc_key, '')
+            if q in display.lower() or q in desc.lower():
+                results.append((tool_name, entry))
+    return results

{linux_commands_guide-2.0.0 → linux_commands_guide-2.0.1}/linux_commands_guide.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linux-commands-guide
-Version: 2.0.0
+Version: 2.0.1
 Summary: Bilingual ES/EN interactive Linux command reference — 50+ tools with keyword search
 Author-email: Serber1990 <serber1990@pm.me>
 License-Expression: MIT

{linux_commands_guide-2.0.0 → linux_commands_guide-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "linux-commands-guide"
-version = "2.0.0"
+version = "2.0.1"
 description = "Bilingual ES/EN interactive Linux command reference — 50+ tools with keyword search"
 readme = "README.md"
 license = "MIT"

linux_commands_guide-2.0.0/guia_linux/cli.py

@@ -1,89 +0,0 @@
-#!/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()

linux_commands_guide-2.0.0/guia_linux/utils.py

@@ -1,59 +0,0 @@
-import re
-from shellcolorize import Color
-
-_ANSI_RE = re.compile(r'\033\[[0-9;]*m')
-
-
-def strip_ansi(text: str) -> str:
-    return _ANSI_RE.sub('', text)
-
-
-def ansi_ljust(text: str, width: int) -> str:
-    visible = len(strip_ansi(text))
-    return text + ' ' * max(0, width - visible)
-
-
-def print_table(title: str, commands: list, lang: str = "es") -> None:
-    desc_key = "description_en" if lang == "en" else "description"
-    cmd_label = "Command" if lang == "en" else "Comando"
-    desc_label = "Description" if lang == "en" else "Descripción"
-    sep = "-" * 132
-
-    print(f"\n{Color.CYAN}{Color.BOLD}{title}{Color.RESET}:\n")
-    print(f"{cmd_label:<50} | {desc_label}")
-    print(sep)
-
-    for entry in commands:
-        # Section / category headers
-        if "section" in entry or "category" in entry:
-            key = "section" if "section" in entry else "category"
-            text = entry.get(f"{key}_en" if lang == "en" else key, entry.get(key, ""))
-            if text:
-                print(f"\n{Color.CYAN}{strip_ansi(str(text))}{Color.RESET}")
-                print(sep)
-            continue
-
-        display = entry.get("command") or entry.get("logfile") or entry.get("pattern") or ""
-        desc = entry.get(desc_key, "")
-
-        if display or desc:
-            print(f"{ansi_ljust(str(display), 59)} | {Color.RED}{desc}{Color.RESET}")
-
-
-def search_all(query: str, tools: dict, lang: str = "es") -> list:
-    desc_key = "description_en" if lang == "en" else "description"
-    results = []
-    q = query.lower()
-    for tool_name, module in tools.items():
-        for entry in getattr(module, 'COMMANDS', []):
-            if "section" in entry or "category" in entry:
-                continue
-            display = strip_ansi(str(
-                entry.get("command") or
-                entry.get("logfile") or
-                entry.get("pattern") or ""
-            ))
-            desc = entry.get(desc_key, "")
-            if q in display.lower() or q in desc.lower():
-                results.append((tool_name, entry))
-    return results