Add completion support

Signed-off-by: Gaëtan Lehmann <gaetan.lehmann@vates.tech>

Author: glehmann

README.md

@@ -54,6 +54,20 @@ like `pipx install --editable .`
 If you do not want this behaviour, use: `uv tool install --from . xcp-ng-dev`
 or `pipx install .`
 
+## Completion
+
+### Bash
+
+To install the completion, add `eval "$(register-python-argcomplete xcp-ng-dev)"` to `~/.bash_completion` and relaunch Bash.
+
+### Zsh
+
+To install the completion, add `eval "$(register-python-argcomplete xcp-ng-dev)"` to `~/.zshrc` and relaunch Zsh.
+
+### Fish
+
+To install the completion, run `register-python-argcomplete --shell fish xcp-ng-dev > ~/.config/fish/completions/xcp-ng-dev.fish` and relaunch fish.
+
 ## Building the container image(s)
 
 You need one container image per target version of XCP-ng.

pyproject.toml

@@ -6,6 +6,9 @@ requires-python = ">=3.11"
 license = "MIT"
 license-files = ["LICENSE"]
 dynamic = ["version"]
+dependencies = [
+    "argcomplete",
+]
 
 [project.scripts]
 xcp-ng-dev = "xcp_ng_dev.cli:main"

src/xcp_ng_dev/cli.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# PYTHON_ARGCOMPLETE_OK
 
 """
 Thin wrapper around "docker run" or "podman run".
@@ -13,6 +14,7 @@
 import shutil
 import sys
 import uuid
+import argcomplete
 
 CONTAINER_PREFIX = "ghcr.io/xcp-ng/xcp-ng-build-env"
 
@@ -221,6 +223,8 @@ def main():
     """ Main entry point. """
     parser = buildparser()
 
+    argcomplete.autocomplete(parser)
+
     args = parser.parse_args()
 
     return_code = args.func(args)