Skip to content

v2.0.0

Latest
Latest
Compare
Choose a tag to compare
@github-actions github-actions released this 31 Mar 20:40
· 11 commits to main since this release
v2.0.0
9cd7fcf
This commit was signed with the committer’s verified signature.
michaelklishin Michael Klishin
GPG key ID: 44BF2725475205B2
Verified
Learn about vigilant mode.

v2.0.0 (Mar 31, 2024)

Enhancements

Subcommand and Long Option Inference

If the RABBITMQADMIN_NON_INTERACTIVE_MODE is not set to true, this tool
now can infer subcommand and --long-option names.

This means that a subcommand can be referenced with its unique prefix,
that is,

  • 'del queue' will be inferred as 'delete queue'
  • 'del q --nam "a.queue"' will be inferred as 'delete queue --name "a.queue"'

To enable each feature, set the following environment variables to
'true':

  • RABBITMQADMIN_INFER_SUBCOMMANDS
  • RABBITMQADMIN_INFER_LONG_OPTIONS

This feature is only mean to be used interactively. For non-interactive
use, it can be potentially too dangerous to allow.

Intentionally Restricted Environment Variable Support

Environment variables have a number of serious downsides compared to a rabbitmqadmin.conf
and the regular --long-options on the command line:

  1. Non-existent support for value types and validation ("everything is a string")
  2. Subprocess inheritance restrictions that can be very time-consuming to debug
  3. Different syntax for setting them between the classic POSIX-era shells (such as bash, zsh) and modern ones (such as nushell)

For these reasons and others, rabbitmqadmin v2 intentionally uses the configuration file and the
CLI options over the environment variables.

rabbitmqadmin v2 does, however, supports a number of environment variables for a few
global settings that cannot be configured any other way (besides a CLI option),
or truly represent an environment characteristic, e.g. either the non-interactive mode
should be enabled.

These environment variables are as follows:

Environment variable Type When used Description
RABBITMQADMIN_CONFIG_FILE_PATH Local filesystem path Pre-flight (before command execution) Same meaning as the global --confg-file argument
RABBITMQADMIN_NON_INTERACTIVE_MODE Boolean Command execution Enables the non-interactive mode.

Same meaning as the global --non-interactive argument
RABBITMQADMIN_QUIET_MODE
 Boolean Command execution Instructs the tool to produce less output.

Same meaning as the global --quiet argument
RABBITMQADMIN_INFER_SUBCOMMANDS Boolean Pre-flight (before command execution) Enables inference (completion of partial names) of subcommands. Does not apply to the non-interactive mode.
RABBITMQADMIN_INFER_LONG_OPTIONS Boolean Pre-flight (before command execution) Enables inference (completion of partial names) of --long-options. Does not apply to the non-interactive mode.
RABBITMQADMIN_NODE_ALIAS String Command execution Same meaning as the global --node argument
RABBITMQADMIN_TARGET_HOST String Command execution Same meaning as the global --host argument
RABBITMQADMIN_TARGET_PORT Positive integer Command execution Same meaning as the global --port argument
RABBITMQADMIN_API_PATH_PREFIX String Command execution Same meaning as the global --path-prefix argument
RABBITMQADMIN_TARGET_VHOST String Command execution Same meaning as the global --vhost argument
RABBITMQADMIN_BASE_URI String Command execution Same meaning as the global --base-uri argument
RABBITMQADMIN_USE_TLS Boolean Command execution Same meaning as the global --tls argument
RABBITMQADMIN_USERNAME String Command execution Same meaning as the global --username argument
RABBITMQADMIN_PASSWORD String Command execution Same meaning as the global --password argument
RABBITMQADMIN_TABLE_STYLE Enum, see --table-style in rabbitmqadmin help Command execution Same meaning as the global --table-style argument
Assets 6
Loading