refactor(cli): migrate argument parsing from Click to Cyclopts

docs/cli.md

@@ -222,14 +222,17 @@ Interactive prompts from deploy code (e.g. `input(...)`) will still block, so av
 
 ## Shell Autocompletion
 
-Add the following to your `~/.bash_profile` or `~/.profile` files:
+pyinfra can install shell completion for you:
 
-+ **bash** `source scripts/pyinfra-complete.sh`.
-+ **zsh** `source scripts/pyinfra-complete.zsh`.
+```
+pyinfra --install-completion
+```
+
+This auto-detects your current shell (`bash`, `zsh` and `fish` are supported), then generates and installs the completion script to the shell-specific default location. After installation you may need to restart your shell or source your shell configuration file.
 
-These files were generated using these commands:
+You can also target a specific shell or output path:
 
 ```
-env _PYINFRA_COMPLETE=bash_source pyinfra > pyinfra-complete.sh
-env _PYINFRA_COMPLETE=zsh_source pyinfra > pyinfra-complete.zsh
+pyinfra --install-completion --shell zsh
+pyinfra --install-completion --shell bash --output ~/.pyinfra-complete.bash
 ```

pyproject.toml

@@ -15,6 +15,7 @@ dependencies = [
     "gevent>=1.5",
     "paramiko>=2.11,<5", # 2.11 (2022) adds Transport.open_channel(timeout=...) for ProxyJump timeout (#971)
     "click>2",
+    "cyclopts>=4,<5",
     "jinja2>3,<4",
     "python-dateutil>2,<3",
     "typeguard>=4,<5",