vsh: Introduce '--completers-missing' for 'self-test' command

Make it simple to spot which options of which commands are missing
autocompletion functions by introducing this hidden option.

In the future when we'll have completers for everything this can be also
used as a hard fail so that completers are always added.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
This commit is contained in:
Peter Krempa 2021-03-04 15:47:28 +01:00
parent 7f72ed0707
commit 8f5b8fac33
2 changed files with 26 additions and 5 deletions

View File

@ -261,11 +261,13 @@ vshCmddefGetInfo(const vshCmdDef * cmd, const char *name)
/* Check if the internal command definitions are correct */ /* Check if the internal command definitions are correct */
static int static int
vshCmddefCheckInternals(vshControl *ctl, vshCmddefCheckInternals(vshControl *ctl,
const vshCmdDef *cmd) const vshCmdDef *cmd,
bool missingCompleters)
{ {
size_t i; size_t i;
const char *help = NULL; const char *help = NULL;
bool seenOptionalOption = false; bool seenOptionalOption = false;
g_auto(virBuffer) complbuf = VIR_BUFFER_INITIALIZER;
/* in order to perform the validation resolve the alias first */ /* in order to perform the validation resolve the alias first */
if (cmd->flags & VSH_CMD_FLAG_ALIAS) { if (cmd->flags & VSH_CMD_FLAG_ALIAS) {
@ -309,6 +311,11 @@ vshCmddefCheckInternals(vshControl *ctl,
return -1; /* too many options */ return -1; /* too many options */
} }
if (missingCompleters &&
(opt->type == VSH_OT_STRING || opt->type == VSH_OT_DATA) &&
!opt->completer)
virBufferStrcat(&complbuf, opt->name, ", ", NULL);
switch (opt->type) { switch (opt->type) {
case VSH_OT_STRING: case VSH_OT_STRING:
case VSH_OT_BOOL: case VSH_OT_BOOL:
@ -391,6 +398,12 @@ vshCmddefCheckInternals(vshControl *ctl,
break; break;
} }
} }
virBufferTrim(&complbuf, ", ");
if (missingCompleters && virBufferUse(&complbuf) > 0)
vshPrintExtra(ctl, "%s: %s\n", cmd->name, virBufferCurrentContent(&complbuf));
return 0; return 0;
} }
@ -3250,6 +3263,13 @@ cmdQuit(vshControl *ctl, const vshCmd *cmd G_GNUC_UNUSED)
* Command self-test * Command self-test
* ----------------- */ * ----------------- */
const vshCmdOptDef opts_selftest[] = {
{.name = "completers-missing",
.type = VSH_OT_BOOL,
.help = N_("output the list of options which are missing completers")
},
{.name = NULL}
};
const vshCmdInfo info_selftest[] = { const vshCmdInfo info_selftest[] = {
{.name = "help", {.name = "help",
.data = N_("internal command for testing virt shells") .data = N_("internal command for testing virt shells")
@ -3261,15 +3281,15 @@ const vshCmdInfo info_selftest[] = {
}; };
bool bool
cmdSelfTest(vshControl *ctl, cmdSelfTest(vshControl *ctl, const vshCmd *cmd)
const vshCmd *cmd G_GNUC_UNUSED)
{ {
const vshCmdGrp *grp; const vshCmdGrp *grp;
const vshCmdDef *def; const vshCmdDef *def;
bool completers = vshCommandOptBool(cmd, "completers-missing");
for (grp = cmdGroups; grp->name; grp++) { for (grp = cmdGroups; grp->name; grp++) {
for (def = grp->commands; def->name; def++) { for (def = grp->commands; def->name; def++) {
if (vshCmddefCheckInternals(ctl, def) < 0) if (vshCmddefCheckInternals(ctl, def, completers) < 0)
return false; return false;
} }
} }

View File

@ -375,6 +375,7 @@ extern const vshCmdOptDef opts_echo[];
extern const vshCmdInfo info_echo[]; extern const vshCmdInfo info_echo[];
extern const vshCmdInfo info_pwd[]; extern const vshCmdInfo info_pwd[];
extern const vshCmdInfo info_quit[]; extern const vshCmdInfo info_quit[];
extern const vshCmdOptDef opts_selftest[];
extern const vshCmdInfo info_selftest[]; extern const vshCmdInfo info_selftest[];
extern const vshCmdOptDef opts_complete[]; extern const vshCmdOptDef opts_complete[];
extern const vshCmdInfo info_complete[]; extern const vshCmdInfo info_complete[];
@ -445,7 +446,7 @@ bool cmdComplete(vshControl *ctl, const vshCmd *cmd);
{ \ { \
.name = "self-test", \ .name = "self-test", \
.handler = cmdSelfTest, \ .handler = cmdSelfTest, \
.opts = NULL, \ .opts = opts_selftest, \
.info = info_selftest, \ .info = info_selftest, \
.flags = VSH_CMD_FLAG_NOCONNECT | VSH_CMD_FLAG_HIDDEN, \ .flags = VSH_CMD_FLAG_NOCONNECT | VSH_CMD_FLAG_HIDDEN, \
} }