feat: add completion for fail2ban-client

plugins/fail2ban/README.md

@@ -0,0 +1,37 @@
+# fail2ban-client
+
+## Description  
+
+Zsh completion for the `fail2ban-client` command.  
+This plugin provides:  
+
+- Completion for subcommands (`start`, `restart`, `reload`, `stop`, `unban`, `status`, `set`, `get`, `add`, etc.)
+- Dynamic completion of active jails  
+- Contextual completion of options for `set` and `get` (e.g., `bantime`, `maxretry`, `ignoreip`, etc.)  
+- Automatic handling of `sudo` if required  
+
+## Installation
+
+To use it, add **fail2ban** to the plugins array in your zshrc file:
+
+```bash
+plugins=(... fail2ban)
+```
+
+## Usage
+
+Type `fail2ban-client <TAB>` to trigger completion.  
+Examples:
+
+```bash
+fail2ban-client set <TAB>            # suggests jails  
+fail2ban-client set sshd <TAB>       # suggests possible actions  
+fail2ban-client get sshd <TAB>       # suggests available properties  
+fail2ban-client status <TAB>         # suggests jails or the 'extended' option  
+```
+
+## Compatibility
+
+- Zsh version 5.x or higher
+- Works with or without root access (uses `sudo` if needed)
+- Designed to be used as a plugin in Oh My Zsh