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

linux_commands_guide-2.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Serber1990
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

linux_commands_guide-2.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: linux-commands-guide
+Version: 2.1.0
+Summary: Bilingual ES/EN interactive Linux command reference — 50+ tools with keyword search
+Author-email: Serber1990 <serber1990@pm.me>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/serber1990/linux-commands-guide
+Project-URL: Bug Tracker, https://github.com/serber1990/linux-commands-guide/issues
+Project-URL: Source Code, https://github.com/serber1990/linux-commands-guide
+Project-URL: Changelog, https://github.com/serber1990/linux-commands-guide/blob/main/CHANGELOG.md
+Keywords: linux,cheatsheet,commands,reference,sysadmin,bilingual,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Spanish
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: shellcolorize>=1.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# linux-commands-guide — `lh`
+
+[![CI](https://github.com/serber1990/linux-commands-guide/actions/workflows/ci.yml/badge.svg)](https://github.com/serber1990/linux-commands-guide/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/linux-commands-guide.svg)](https://badge.fury.io/py/linux-commands-guide)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/serber1990/linux-commands-guide?style=social)](https://github.com/serber1990/linux-commands-guide/stargazers)
+
+**Bilingual ES/EN Linux command reference for the terminal.** 51 tools covered, keyword search across all of
+them, one short command: `lh`. Like a cheat sheet that is always one keystroke away — and works over SSH.
+
+*Guía de comandos Linux bilingüe (español / inglés) para la terminal.*
+
+---
+
+## ✨ Features
+
+- 🌐 **Bilingual** — Spanish or English, picked from your locale (`--lang es|en` to force it)
+- 🔍 **Cross-tool search** — `lh -s port` finds every command mentioning "port", in both languages
+- 📦 **51 tools** — awk, grep, find, git, docker, ssh, tmux, jq, ss, rsync, tar, systemctl, iptables and more
+- ✅ **Checked content** — every entry is tested for both translations; examples are real, working commands
+- 🔇 **Pipe-friendly** — plain text when piped (`lh tar | less`), honours `NO_COLOR`
+
+---
+
+## 📥 Installation
+
+```bash
+pip install linux-commands-guide
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/serber1990/linux-commands-guide.git
+cd linux-commands-guide
+pip install -e .
+```
+
+---
+
+## 🛠 Usage
+
+```bash
+lh <tool>                  # Show commands for a tool
+lh -s <keyword>            # Search across all tools
+lh --lang en <tool>        # Force English (or --lang es for Spanish)
+lh --help                  # Help and the full tool list
+lh --version
+```
+
+### Examples
+
+```bash
+lh ssh
+```
+
+```
+  ╔══════════════════════════════════════════════╗
+  ║  SSH Options                                 ║
+  ╚══════════════════════════════════════════════╝
+
+  Command                                             Description
+  ──────────────────────────────────────────────────────────────────────────────────────────────
+  ssh user@host                                       Connect to host as the given user
+  ssh -p <port> user@host                             Connect using the specified port
+  ssh -i key.pem user@host                            Use a private key for authentication
+  ssh -L 8080:localhost:80 user@host                  Local tunnel: forward local port 8080 to host port 80
+  ssh -R 9090:localhost:8080 user@host                Remote tunnel: forward host port 9090 to local port 8080
+  …
+```
+
+```bash
+lh -s port
+```
+
+```
+  ╔══════════════════════════════════════════════════╗
+  ║  Search: port                                    ║
+  ╚══════════════════════════════════════════════════╝
+
+  34 results
+
+  ▶  docker
+    docker run -p 8080:80 image_name
+    Map host port to container port
+  ▶  firewall-cmd
+    firewall-cmd --zone=zone --add-port=80/tcp --permanent
+    Permanently open TCP port 80
+    firewall-cmd --zone=zone --remove-port=80/tcp --permanent
+  …
+```
+
+---
+
+## 🔧 Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `awk` | Column-based text processing |
+| `cat` | Display and concatenate file contents |
+| `chmod` | Change file permissions |
+| `chown` | Change file owner and group |
+| `crontab` | Periodic task scheduling |
+| `curl` | Transfer data with URLs |
+| `cut` | Extract sections from each line |
+| `df` | Display disk space usage |
+| `docker` | Docker container management |
+| `du` | Display directory space usage |
+| `descriptors` | File descriptors and redirections |
+| `find` | Search for files and directories |
+| `firewall-cmd` | Manage the firewalld firewall |
+| `free` | Display system memory usage |
+| `git` | Version control with Git |
+| `grep` | Search for patterns in files |
+| `head` | Display the beginning of a file |
+| `htop` | Interactive process monitor |
+| `ifconfig` | Network interface configuration (legacy) |
+| `ip` | Modern network interface and routing management |
+| `iptables` | Kernel firewall rule management |
+| `jq` | Command-line JSON processor |
+| `logs` | Important log file paths in Linux |
+| `lsblk` | List block devices |
+| `lsof` | List open files by processes |
+| `lxc` | LXC container management |
+| `nc` | TCP/IP Swiss army knife |
+| `netstat` | Network connection statistics |
+| `nmap` | Network and port scanner |
+| `ps` | Information about running processes |
+| `regex` | Regular expression patterns |
+| `rsync` | Efficient file synchronization |
+| `scp` | Secure file copy over SSH |
+| `sed` | Stream text editor |
+| `shortcuts` | Terminal keyboard shortcuts |
+| `sort` | Sort lines of text |
+| `ss` | Socket statistics (replaces netstat) |
+| `ssh` | Secure Shell client |
+| `system` | Basic system commands |
+| `systemctl` | Manage services with systemd |
+| `tail` | Display the end of a file |
+| `tar` | File archiving and compression |
+| `tee` | Read stdin and write to stdout and files |
+| `tmux` | Terminal multiplexer |
+| `top` | Real-time process monitor |
+| `tr` | Translate or delete characters |
+| `uname` | System and kernel information |
+| `uniq` | Filter adjacent duplicate lines |
+| `vim` | Modal terminal text editor |
+| `watch` | Execute a command periodically |
+| `xargs` | Build and execute commands from stdin |
+
+---
+
+## 🧪 Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .
+pytest
+```
+
+Each tool is a small module in `guia_linux/tools/` with a `COMMANDS` list. To add one, copy an existing
+module, register it in `guia_linux/tools/__init__.py`, add it to the table above, and run `pytest` —
+the test suite checks that every entry has both translations and that the README lists every tool.
+
+See [CHANGELOG.md](CHANGELOG.md) for release notes.
+
+---
+
+## 📝 License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+## 💬 Feedback
+
+Open an issue or reach out via GitHub.
+
+## 🌐 Connect
+
+[![GitHub](https://img.shields.io/badge/GitHub-@serber1990-181717?style=flat-square&logo=github)](https://github.com/serber1990)

linux_commands_guide-2.1.0/README.md

@@ -0,0 +1,181 @@
+# linux-commands-guide — `lh`
+
+[![CI](https://github.com/serber1990/linux-commands-guide/actions/workflows/ci.yml/badge.svg)](https://github.com/serber1990/linux-commands-guide/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/linux-commands-guide.svg)](https://badge.fury.io/py/linux-commands-guide)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/serber1990/linux-commands-guide?style=social)](https://github.com/serber1990/linux-commands-guide/stargazers)
+
+**Bilingual ES/EN Linux command reference for the terminal.** 51 tools covered, keyword search across all of
+them, one short command: `lh`. Like a cheat sheet that is always one keystroke away — and works over SSH.
+
+*Guía de comandos Linux bilingüe (español / inglés) para la terminal.*
+
+---
+
+## ✨ Features
+
+- 🌐 **Bilingual** — Spanish or English, picked from your locale (`--lang es|en` to force it)
+- 🔍 **Cross-tool search** — `lh -s port` finds every command mentioning "port", in both languages
+- 📦 **51 tools** — awk, grep, find, git, docker, ssh, tmux, jq, ss, rsync, tar, systemctl, iptables and more
+- ✅ **Checked content** — every entry is tested for both translations; examples are real, working commands
+- 🔇 **Pipe-friendly** — plain text when piped (`lh tar | less`), honours `NO_COLOR`
+
+---
+
+## 📥 Installation
+
+```bash
+pip install linux-commands-guide
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/serber1990/linux-commands-guide.git
+cd linux-commands-guide
+pip install -e .
+```
+
+---
+
+## 🛠 Usage
+
+```bash
+lh <tool>                  # Show commands for a tool
+lh -s <keyword>            # Search across all tools
+lh --lang en <tool>        # Force English (or --lang es for Spanish)
+lh --help                  # Help and the full tool list
+lh --version
+```
+
+### Examples
+
+```bash
+lh ssh
+```
+
+```
+  ╔══════════════════════════════════════════════╗
+  ║  SSH Options                                 ║
+  ╚══════════════════════════════════════════════╝
+
+  Command                                             Description
+  ──────────────────────────────────────────────────────────────────────────────────────────────
+  ssh user@host                                       Connect to host as the given user
+  ssh -p <port> user@host                             Connect using the specified port
+  ssh -i key.pem user@host                            Use a private key for authentication
+  ssh -L 8080:localhost:80 user@host                  Local tunnel: forward local port 8080 to host port 80
+  ssh -R 9090:localhost:8080 user@host                Remote tunnel: forward host port 9090 to local port 8080
+  …
+```
+
+```bash
+lh -s port
+```
+
+```
+  ╔══════════════════════════════════════════════════╗
+  ║  Search: port                                    ║
+  ╚══════════════════════════════════════════════════╝
+
+  34 results
+
+  ▶  docker
+    docker run -p 8080:80 image_name
+    Map host port to container port
+  ▶  firewall-cmd
+    firewall-cmd --zone=zone --add-port=80/tcp --permanent
+    Permanently open TCP port 80
+    firewall-cmd --zone=zone --remove-port=80/tcp --permanent
+  …
+```
+
+---
+
+## 🔧 Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `awk` | Column-based text processing |
+| `cat` | Display and concatenate file contents |
+| `chmod` | Change file permissions |
+| `chown` | Change file owner and group |
+| `crontab` | Periodic task scheduling |
+| `curl` | Transfer data with URLs |
+| `cut` | Extract sections from each line |
+| `df` | Display disk space usage |
+| `docker` | Docker container management |
+| `du` | Display directory space usage |
+| `descriptors` | File descriptors and redirections |
+| `find` | Search for files and directories |
+| `firewall-cmd` | Manage the firewalld firewall |
+| `free` | Display system memory usage |
+| `git` | Version control with Git |
+| `grep` | Search for patterns in files |
+| `head` | Display the beginning of a file |
+| `htop` | Interactive process monitor |
+| `ifconfig` | Network interface configuration (legacy) |
+| `ip` | Modern network interface and routing management |
+| `iptables` | Kernel firewall rule management |
+| `jq` | Command-line JSON processor |
+| `logs` | Important log file paths in Linux |
+| `lsblk` | List block devices |
+| `lsof` | List open files by processes |
+| `lxc` | LXC container management |
+| `nc` | TCP/IP Swiss army knife |
+| `netstat` | Network connection statistics |
+| `nmap` | Network and port scanner |
+| `ps` | Information about running processes |
+| `regex` | Regular expression patterns |
+| `rsync` | Efficient file synchronization |
+| `scp` | Secure file copy over SSH |
+| `sed` | Stream text editor |
+| `shortcuts` | Terminal keyboard shortcuts |
+| `sort` | Sort lines of text |
+| `ss` | Socket statistics (replaces netstat) |
+| `ssh` | Secure Shell client |
+| `system` | Basic system commands |
+| `systemctl` | Manage services with systemd |
+| `tail` | Display the end of a file |
+| `tar` | File archiving and compression |
+| `tee` | Read stdin and write to stdout and files |
+| `tmux` | Terminal multiplexer |
+| `top` | Real-time process monitor |
+| `tr` | Translate or delete characters |
+| `uname` | System and kernel information |
+| `uniq` | Filter adjacent duplicate lines |
+| `vim` | Modal terminal text editor |
+| `watch` | Execute a command periodically |
+| `xargs` | Build and execute commands from stdin |
+
+---
+
+## 🧪 Development
+
+```bash
+pip install -e ".[dev]"
+ruff check .
+pytest
+```
+
+Each tool is a small module in `guia_linux/tools/` with a `COMMANDS` list. To add one, copy an existing
+module, register it in `guia_linux/tools/__init__.py`, add it to the table above, and run `pytest` —
+the test suite checks that every entry has both translations and that the README lists every tool.
+
+See [CHANGELOG.md](CHANGELOG.md) for release notes.
+
+---
+
+## 📝 License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+## 💬 Feedback
+
+Open an issue or reach out via GitHub.
+
+## 🌐 Connect
+
+[![GitHub](https://img.shields.io/badge/GitHub-@serber1990-181717?style=flat-square&logo=github)](https://github.com/serber1990)

linux_commands_guide-2.1.0/guia_linux/__init__.py

@@ -0,0 +1,5 @@
+__version__ = "2.1.0"
+
+from guia_linux.cli import main  # noqa: E402  (after __version__: cli imports it)
+
+__all__ = ["main", "__version__"]

linux_commands_guide-2.1.0/guia_linux/__main__.py

@@ -0,0 +1,3 @@
+from guia_linux.cli import run
+
+run()

{linux_commands_guide-2.0.1 → linux_commands_guide-2.1.0}/guia_linux/cli.py

@@ -1,11 +1,22 @@
 #!/usr/bin/env python3
 import argparse
+import os
 import sys
 from shellcolorize import Color
+from guia_linux import __version__
 from guia_linux.tools import TOOLS
 from guia_linux.utils import search_all, strip_ansi
 
 
+def default_lang() -> str:
+    """Spanish for es_* locales, English otherwise."""
+    for var in ('LC_ALL', 'LC_MESSAGES', 'LANG', 'LANGUAGE'):
+        value = os.environ.get(var)
+        if value:
+            return 'es' if value.lower().startswith('es') else 'en'
+    return 'en'
+
+
 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)
@@ -13,7 +24,7 @@ def _help_header(lang: str) -> None:
     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)
+          + ' ' * max(0, w - len(title) - 4)
           + f"  {Color.CYAN}║{Color.RESET}")
     print(f"  {Color.CYAN}╚{border}╝{Color.RESET}")
 
@@ -28,6 +39,7 @@ def _print_help(lang: str) -> None:
     {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.GREEN}lh{Color.RESET} --version                Show version
 
   {Color.BOLD}Examples{Color.RESET}
     {Color.GREEN}lh grep{Color.RESET}                     All grep options
@@ -41,6 +53,7 @@ def _print_help(lang: str) -> None:
     {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.GREEN}lh{Color.RESET} --version                  Muestra la versión
 
   {Color.BOLD}Ejemplos{Color.RESET}
     {Color.GREEN}lh grep{Color.RESET}                       Todas las opciones de grep
@@ -71,7 +84,7 @@ def _search(query: str, lang: str) -> None:
     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)
+          + ' ' * max(0, w - len(header) - 4)
           + f"  {Color.CYAN}║{Color.RESET}")
     print(f"  {Color.CYAN}╚{border}╝{Color.RESET}")
 
@@ -96,15 +109,17 @@ def _search(query: str, lang: str) -> None:
     print()
 
 
-def main() -> None:
-    parser = argparse.ArgumentParser(add_help=False)
+def main(argv=None) -> None:
+    parser = argparse.ArgumentParser(prog='lh', 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('--lang', choices=['es', 'en'], default=None)
     parser.add_argument('-h', '--help', action='store_true')
-    args = parser.parse_args()
+    parser.add_argument('-V', '--version', action='version', version=f'lh (linux-commands-guide) {__version__}')
+    args = parser.parse_args(argv)
+    Color.auto()
 
-    lang = args.lang
+    lang = args.lang or default_lang()
 
     if args.help or (args.tool is None and args.search is None):
         _print_help(lang)
@@ -119,11 +134,22 @@ def main() -> None:
         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")
+        print(f"\n  {Color.RED}✖  {msg}{Color.RESET}\n", file=sys.stderr)
         sys.exit(1)
 
     TOOLS[key].show(lang)
 
 
+def run() -> None:
+    """Console entry point: like main(), but quiet when the output pipe is closed early (| head)."""
+    try:
+        main()
+        sys.stdout.flush()
+    except BrokenPipeError:
+        devnull = os.open(os.devnull, os.O_WRONLY)
+        os.dup2(devnull, sys.stdout.fileno())
+        sys.exit(141)
+
+
 if __name__ == '__main__':
-    main()
+    run()

{linux_commands_guide-2.0.1 → linux_commands_guide-2.1.0}/guia_linux/tools/cat.py

@@ -16,11 +16,11 @@ COMMANDS = [
     {"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"},
+    {"command": f"{Color.GREEN}bat{Color.RESET} -r N:M filename", "description": "Muestra solo las líneas N a M (bat/batcat)", "description_en": "Show only lines N to M (bat/batcat)"},
+    {"command": f"{Color.GREEN}bat{Color.RESET} --theme=<theme> filename", "description": "Resalta la sintaxis con el tema indicado (bat)", "description_en": "Highlight syntax with the given theme (bat)"},
+    {"command": f"{Color.GREEN}bat{Color.RESET} --paging=never filename", "description": "Muestra el archivo sin paginador (bat)", "description_en": "Print the file without a pager (bat)"},
+    {"command": f"{Color.GREEN}cat{Color.RESET} -u filename", "description": "Ignorada por GNU cat (se mantiene por compatibilidad POSIX)", "description_en": "Ignored by GNU cat (kept for POSIX compatibility)"},
+    {"command": f"{Color.GREEN}bat{Color.RESET} --list-languages", "description": "Lista los lenguajes con resaltado de sintaxis (bat)", "description_en": "List languages with syntax highlighting (bat)"},
 ]
 
 

{linux_commands_guide-2.0.1 → linux_commands_guide-2.1.0}/guia_linux/tools/chown.py

@@ -12,7 +12,7 @@ COMMANDS = [
     {"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} --from=old_user new_user filename", "description": "Cambia a new_user solo si el propietario actual es old_user", "description_en": "Change owner to new_user only if the current owner is old_user"},
     {"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"},
 ]
 

{linux_commands_guide-2.0.1 → linux_commands_guide-2.1.0}/guia_linux/tools/ifconfig.py

@@ -17,7 +17,7 @@ COMMANDS = [
     {"command": f"{Color.GREEN}ifconfig{Color.RESET} <iface> promisc", "description": "Activa el modo promiscuo", "description_en": "Enable promiscuous mode"},
     {"command": f"{Color.GREEN}ifconfig{Color.RESET} <iface> -promisc", "description": "Desactiva el modo promiscuo", "description_en": "Disable promiscuous mode"},
     {"command": f"{Color.GREEN}ifconfig{Color.RESET} <iface> hw ether <mac>", "description": "Cambia la dirección MAC", "description_en": "Change the MAC address"},
-    {"command": f"{Color.GREEN}ifconfig{Color.RESET} <iface> add <ip>", "description": "Añade una dirección IP secundaria", "description_en": "Add a secondary IP address"},
+    {"command": f"{Color.GREEN}ifconfig{Color.RESET} <iface> add <ipv6>/<prefix>", "description": "Añade una dirección IPv6 (en IPv4 se usan alias <iface>:N)", "description_en": "Add an IPv6 address (IPv4 uses <iface>:N aliases)"},
     {"command": f"{Color.GREEN}ifconfig{Color.RESET} <iface> del <ip>", "description": "Elimina una dirección IP secundaria", "description_en": "Remove a secondary IP address"},
     {"command": f"{Color.GREEN}ifconfig{Color.RESET} -a", "description": "Muestra todas las interfaces, activas e inactivas", "description_en": "Show all interfaces, active and inactive"},
 ]

{linux_commands_guide-2.0.1 → linux_commands_guide-2.1.0}/guia_linux/tools/iptables.py

@@ -14,7 +14,7 @@ COMMANDS = [
     {"command": f"{Color.GREEN}iptables{Color.RESET} -A INPUT -p tcp --dport 443 -j ACCEPT", "description": "Permite tráfico HTTPS entrante (puerto 443)", "description_en": "Allow incoming HTTPS traffic (port 443)"},
     {"command": f"{Color.GREEN}iptables{Color.RESET} -A OUTPUT -d IP -j DROP", "description": "Bloquea el tráfico saliente hacia una IP", "description_en": "Block outgoing traffic to an IP"},
     {"command": f"{Color.GREEN}iptables{Color.RESET} -A INPUT -p icmp --icmp-type 8 -j ACCEPT", "description": "Permite ping (ICMP tipo 8)", "description_en": "Allow ping (ICMP type 8)"},
-    {"command": f"{Color.GREEN}iptables{Color.RESET} -A INPUT -m state --state RELATED,ESTABLISHED -j ACCEPT", "description": "Permite tráfico de conexiones existentes", "description_en": "Allow traffic from established connections"},
+    {"command": f"{Color.GREEN}iptables{Color.RESET} -A INPUT -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT", "description": "Permite el tráfico de conexiones ya establecidas", "description_en": "Allow traffic from established connections"},
     {"command": f"{Color.GREEN}iptables{Color.RESET} -P INPUT DROP", "description": "Política por defecto DROP en INPUT", "description_en": "Set default DROP policy for INPUT"},
     {"command": f"{Color.GREEN}iptables{Color.RESET} -P OUTPUT ACCEPT", "description": "Política por defecto ACCEPT en OUTPUT", "description_en": "Set default ACCEPT policy for OUTPUT"},
     {"command": f"{Color.GREEN}iptables{Color.RESET} -D INPUT -s IP -j ACCEPT", "description": "Elimina una regla específica de INPUT", "description_en": "Delete a specific rule from INPUT"},

linux_commands_guide-2.1.0/guia_linux/tools/lxc.py

@@ -0,0 +1,33 @@
+from shellcolorize import Color
+from guia_linux.utils import print_table
+
+TITLE = "Opciones de LXC"
+TITLE_EN = "LXC Options"
+BRIEF = "Gestión de contenedores LXC"
+BRIEF_EN = "LXC container management"
+
+COMMANDS = [
+    {"command": f"{Color.GREEN}lxc-ls{Color.RESET} -f", "description": "Lista los contenedores con estado, IP y tipo", "description_en": "List containers with state, IP and type"},
+    {"command": f"{Color.GREEN}lxc-create{Color.RESET} -n name -t download", "description": "Crea un contenedor desde una imagen (asistente interactivo)", "description_en": "Create a container from an image (interactive)"},
+    {"command": f"{Color.GREEN}lxc-create{Color.RESET} -n name -t download -- -d debian -r bookworm -a amd64", "description": "Crea un contenedor Debian sin preguntas", "description_en": "Create a Debian container non-interactively"},
+    {"command": f"{Color.GREEN}lxc-start{Color.RESET} -n name", "description": "Inicia un contenedor en segundo plano", "description_en": "Start a container in the background"},
+    {"command": f"{Color.GREEN}lxc-stop{Color.RESET} -n name", "description": "Detiene un contenedor", "description_en": "Stop a container"},
+    {"command": f"{Color.GREEN}lxc-stop{Color.RESET} -n name -r", "description": "Reinicia un contenedor", "description_en": "Reboot a container"},
+    {"command": f"{Color.GREEN}lxc-attach{Color.RESET} -n name", "description": "Abre una shell dentro del contenedor", "description_en": "Open a shell inside the container"},
+    {"command": f"{Color.GREEN}lxc-attach{Color.RESET} -n name -- command", "description": "Ejecuta un comando dentro del contenedor", "description_en": "Run a command inside the container"},
+    {"command": f"{Color.GREEN}lxc-console{Color.RESET} -n name", "description": "Conecta a la consola (salir: Ctrl+A Q)", "description_en": "Attach to the console (exit: Ctrl+A Q)"},
+    {"command": f"{Color.GREEN}lxc-info{Color.RESET} -n name", "description": "Muestra estado, PID, IP y uso de recursos", "description_en": "Show state, PID, IP and resource usage"},
+    {"command": f"{Color.GREEN}lxc-freeze{Color.RESET} -n name", "description": "Congela todos los procesos del contenedor", "description_en": "Freeze all processes in the container"},
+    {"command": f"{Color.GREEN}lxc-unfreeze{Color.RESET} -n name", "description": "Descongela el contenedor", "description_en": "Unfreeze the container"},
+    {"command": f"{Color.GREEN}lxc-copy{Color.RESET} -n name -N new_name", "description": "Clona un contenedor", "description_en": "Clone a container"},
+    {"command": f"{Color.GREEN}lxc-snapshot{Color.RESET} -n name", "description": "Crea un snapshot (el contenedor debe estar parado)", "description_en": "Create a snapshot (container must be stopped)"},
+    {"command": f"{Color.GREEN}lxc-snapshot{Color.RESET} -n name -L", "description": "Lista los snapshots", "description_en": "List snapshots"},
+    {"command": f"{Color.GREEN}lxc-destroy{Color.RESET} -n name", "description": "Elimina un contenedor y su sistema de archivos", "description_en": "Delete a container and its filesystem"},
+    {"command": f"{Color.GREEN}lxc-config{Color.RESET} lxc.lxcpath", "description": "Muestra dónde se guardan los contenedores", "description_en": "Show where containers are stored"},
+    {"command": f"{Color.GREEN}lxc-checkconfig{Color.RESET}", "description": "Comprueba el soporte del kernel para LXC", "description_en": "Check kernel support for LXC"},
+]
+
+
+def show(lang: str = "es") -> None:
+    title = TITLE_EN if lang == "en" else TITLE
+    print_table(title, COMMANDS, lang)

{linux_commands_guide-2.0.1 → linux_commands_guide-2.1.0}/guia_linux/tools/nc.py

@@ -7,7 +7,7 @@ BRIEF = "Navaja suiza de TCP/IP"
 BRIEF_EN = "TCP/IP Swiss army knife"
 
 COMMANDS = [
-    {"command": f"{Color.GREEN}nc{Color.RESET} -l -p <port>", "description": "Escucha en el puerto especificado (modo servidor)", "description_en": "Listen on the specified port (server mode)"},
+    {"command": f"{Color.GREEN}nc{Color.RESET} -l -p <port>", "description": "Escucha en el puerto (netcat tradicional; en OpenBSD: nc -l <port>)", "description_en": "Listen on a port (traditional netcat; OpenBSD: nc -l <port>)"},
     {"command": f"{Color.GREEN}nc{Color.RESET} <host> <port>", "description": "Conecta al host y puerto (modo cliente)", "description_en": "Connect to host and port (client mode)"},
     {"command": f"{Color.GREEN}nc{Color.RESET} -z <host> <port>", "description": "Escanea puertos sin enviar datos", "description_en": "Port scan without sending data"},
     {"command": f"{Color.GREEN}nc{Color.RESET} -z <host> 20-80", "description": "Escanea un rango de puertos", "description_en": "Scan a port range"},
@@ -16,7 +16,7 @@ COMMANDS = [
     {"command": f"{Color.GREEN}nc{Color.RESET} -n", "description": "Omite la resolución DNS", "description_en": "Skip DNS resolution"},
     {"command": f"{Color.GREEN}nc{Color.RESET} -k", "description": "Mantiene la conexión abierta tras desconexión", "description_en": "Keep listening after client disconnects"},
     {"command": f"{Color.GREEN}nc{Color.RESET} -w <timeout>", "description": "Tiempo de espera en segundos", "description_en": "Connection timeout in seconds"},
-    {"command": f"{Color.GREEN}nc{Color.RESET} -e <command>", "description": "Ejecuta un comando tras la conexión", "description_en": "Execute command after connection"},
+    {"command": f"{Color.GREEN}nc{Color.RESET} -e <command>", "description": "Ejecuta un comando tras la conexión (solo netcat tradicional/ncat)", "description_en": "Execute a command after connecting (traditional netcat/ncat only)"},
     {"command": f"{Color.GREEN}nc{Color.RESET} -x <proxy>", "description": "Usa un proxy SOCKS para la conexión", "description_en": "Use a SOCKS proxy for the connection"},
     {"command": f"{Color.GREEN}nc{Color.RESET} -q <seconds>", "description": "Espera N segundos tras EOF antes de cerrar", "description_en": "Wait N seconds after EOF before closing"},
 ]