mariadb-cli 0.1.1

One-shot agent-native command line client for MariaDB servers
Documentation
# Prose of the failures whose cause is the caller's own input.
#
# One entry per stable failure code: the dots and underscores of the code
# become hyphens, because a message name carries neither. `err-` carries the
# message and `hint-` the next action; the code, the category and the exit
# number never appear here, because a caller branches on them.
#
# A message the source builds around a measured value renders as { $detail },
# which is that built sentence. Nothing measured is lost in translation: a
# language that words the sentence itself still carries { $detail } inside it.

err-usage-invalid-arguments = the arguments given do not match the accepted form
hint-usage-invalid-arguments = run with --help to see the accepted form

err-usage-not-a-flow = this command has no rows to stream

err-usage-not-yet-served = the command is published, yet this build does not serve it ({ $detail })
hint-usage-not-yet-served = run `meta commands` to see which commands this build serves

err-usage-served-without-a-connection = the command is served without a connection ({ $detail })
hint-usage-served-without-a-connection = route it through the path that opens no connection

err-usage-no-statement = no statement was given
hint-usage-no-statement = write the statement, or pass --stdin to read it from the standard input

err-usage-malformed-declaration = the parameter declaration is malformed ({ $detail })
hint-usage-malformed-declaration = write the declaration as name:kind, such as mes:date

err-usage-malformed-argument = the argument gives no name and value ({ $detail })
hint-usage-malformed-argument = write the argument as name=value

err-usage-missing-argument = a declared parameter was left without a value ({ $detail })
hint-usage-missing-argument = give every declared parameter as --arg name=value

err-usage-argument-kind = the value given is not of the declared kind ({ $detail })
hint-usage-argument-kind = give a value of the declared kind

err-usage-undeclared-argument = an argument was given that this statement does not declare ({ $detail })
hint-usage-undeclared-argument = run `query named list` to see what this statement accepts

err-usage-needs-a-connection = running a stored statement reaches the server
hint-usage-needs-a-connection = route this action through the path that opens a connection

err-usage-empty-delimiter = the statement separator is empty, so it could never separate anything
hint-usage-empty-delimiter = give a separator such as ; or $$

err-usage-not-a-routine-name = a statement was given where this command expects the name of a routine ({ $detail })
hint-usage-not-a-routine-name = give the routine name alone, and its arguments with --param

err-usage-unknown-parameter-kind = that is not a kind a parameter can have ({ $detail })
hint-usage-unknown-parameter-kind = one of: text, integer, decimal, boolean, date

err-usage-parameter-count = the number of values does not match the number of markers ({ $detail })
hint-usage-parameter-count = give exactly one --param for each marker, in order

err-usage-command-withdrawn = this host does not offer that command ({ $detail })
hint-usage-command-withdrawn = set server.observability_visible to true to offer it again

err-usage-resume-mark-unreadable = that is not a resume mark ({ $detail })
hint-usage-resume-mark-unreadable = a mark is the number of rows to pass over, as answered in `next_cursor`

err-usage-summary-with-a-flow = a profile of the whole set cannot be written as a continuous flow
hint-usage-summary-with-a-flow = drop --summary, or ask for a shape that carries one answer

err-meta-shell-missing = completion support is generated for a shell, and none was named
hint-meta-shell-missing = name one of bash, zsh, fish, elvish or powershell, as in `meta completions bash`

err-input-refused = reading that value would wait for somebody to type, and this invocation refuses to ask ({ $detail })
hint-input-refused = pipe the value in, or drop --no-input

err-filter-no-operator = the filter has no operator ({ $detail })
hint-filter-no-operator = use key=value, key!=value or key~substring

err-filter-empty-key = the filter has an empty key ({ $detail })

err-usage-field-not-in-projection = the answer is to be arranged by a field the projection drops ({ $field })
hint-usage-field-not-in-projection = add the field to --select, or arrange by one it keeps
err-usage-count-of-a-change = `{ $detail }` changes the server, and a count is asked of a reading
hint-usage-count-of-a-change = drop --count-only, or ask the count of the reading that selects the same rows
err-usage-cell-ceiling-of-nothing = the cell ceiling asked for is zero, which would cut every cell to nothing
hint-usage-cell-ceiling-of-nothing = write a ceiling above zero, or leave the flag out to keep whole cells
err-usage-projection-kept-nothing = no field named by the projection is carried by the answer ({ $asked })
hint-usage-projection-kept-nothing = name a field the answer carries, or leave --select out