id          = "rabbitmqadmin"
name        = "rabbitmqadmin"
homepage    = "https://www.rabbitmq.com/docs/management-cli"
description = "Command-line client for the RabbitMQ HTTP API."
executables      = ["rabbitmqadmin"]

[dotfiles]

# RabbitMQ's official management CLI documentation names ~/.rabbitmqadmin.conf
# as the default configuration file and shows it holding hostname, vhost,
# username, and password. The whole file is therefore credential-bearing.
# https://www.rabbitmq.com/docs/management-cli
paths       = []
secret      = ["~/.rabbitmqadmin.conf"]
side_effect = false

[commands]
format = 1
label = "RabbitMQ HTTP API client"
description = "Pick a virtual host, then list or declare queues. Connection options (host, port, credentials) come from the config file and are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "manual"
url = "https://github.com/rabbitmq/rabbitmqadmin-ng/blob/main/README.md"
revision = "2026-10-27"
evidence = """
rabbitmqadmin --vhost "monitoring" queues list
rabbitmqadmin --non-interactive show overview
"""

[[commands.field]]
id = "vhost"
label = "Virtual host"
type = "string"
option = ["--vhost"]
sources = ["readme"]

[[commands.field]]
id = "non_interactive"
label = "Non-interactive (script-friendly output)"
type = "boolean"
option = ["--non-interactive"]
sources = ["readme"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["vhost", "non_interactive"]

[[commands.subcommand]]
path = ["queues", "list"]
label = "List queues"
description = "List queues in the selected virtual host."

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/rabbitmq/rabbitmqadmin-ng/blob/main/README.md"
revision = "2026-10-27"
evidence = """
rabbitmqadmin queues list --columns name,queue_type,message_count
"""

[[commands.subcommand.field]]
id = "columns"
label = "Columns"
description = "Comma-separated, e.g. name,queue_type,message_count."
type = "string"
option = ["--columns"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "list"
label = "List queues"
fields = ["columns"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["columns"]

[[commands.subcommand]]
path = ["queues", "declare"]
label = "Declare a queue or stream"
description = "Declare a queue or stream in the selected virtual host."

[[commands.subcommand.source]]
id = "readme"
kind = "manual"
url = "https://github.com/rabbitmq/rabbitmqadmin-ng/blob/main/README.md"
revision = "2026-10-27"
evidence = """
# => Usage: rabbitmqadmin queues declare [OPTIONS] --name <name>
rabbitmqadmin --vhost "events" queues declare --name "target.quorum.queue.name" --type "quorum" --durable true
rabbitmqadmin --vhost "events" queues declare --name "target.stream.name" --type "stream" --durable true
rabbitmqadmin --vhost "events" queues declare --name "target.classic.queue.name" --type "classic" --durable true --auto-delete false
"""

[[commands.subcommand.field]]
id = "name"
label = "Name"
type = "string"
option = ["--name"]
sources = ["readme"]

[[commands.subcommand.field]]
id = "type"
label = "Type"
type = "enum"
option = ["--type"]
choices = [{ value = "quorum", label = "Quorum" }, { value = "stream", label = "Stream" }, { value = "classic", label = "Classic" }]
sources = ["readme"]

[[commands.subcommand.field]]
id = "durable"
label = "Durable"
type = "enum"
option = ["--durable"]
choices = [{ value = "true", label = "Yes" }, { value = "false", label = "No" }]
sources = ["readme"]

[[commands.subcommand.field]]
id = "auto_delete"
label = "Auto-delete"
type = "enum"
option = ["--auto-delete"]
choices = [{ value = "true", label = "Yes" }, { value = "false", label = "No" }]
sources = ["readme"]

[[commands.subcommand.task]]
id = "quorum"
label = "Durable quorum queue"
set = { type = ["quorum"], durable = ["true"] }
fields = ["name", "type", "durable"]
required = ["name"]

[[commands.subcommand.task]]
id = "stream"
label = "Durable stream"
set = { type = ["stream"], durable = ["true"] }
fields = ["name", "type", "durable"]
required = ["name"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["name", "type", "durable", "auto_delete"]