NAME¶

pkgos-gen-completion - generate and install bash completion for an OpenStack client

SYNOPSIS¶

pkgos-gen-completion [--py3|--py2] <client>

DESCRIPTION¶

pkgos-gen-completion is meant to be called from debian/rules, usually from the override_dh_auto_install target of an OpenStack client package, from the root of the source tree. It runs the <client>client.shell module with the complete argument to obtain the bash completion script of the <client> command, rewrites the shell occurrences into <client>, and installs the result as debian/<python>-<client>client/usr/share/bash-completion/completions/<client>.

If the module doesn't output a completion script (which is detected by looking for a _shell() function definition), nothing is installed.

OPTIONS¶

--py3

Generate the completion using python3. This is the default.

--py2

Generate the completion using python2 (legacy). The options must be written before the client name.

EXIT STATUS¶

Returns 0 even when the client doesn't provide a completion script (in which case nothing is installed), and non-zero if an underlying command fails.

EXAMPLES¶

pkgos-gen-completion --py3 openstack

pkgos-gen-completion --py3 vitrage

SEE ALSO¶

pkgos-dh_auto_install(1), bash(1).

AUTHOR¶

This script and its man page: (c) 2026, Thomas Goirand <zigo@debian.org>, released under the Apache-2.0 license.