rabbitmqadmin 2.31.0

rabbitmqadmin v2 is a modern CLI tool for the RabbitMQ HTTP API
Documentation
// Copyright (C) 2023-2026 RabbitMQ Core Team (teamrabbitmq@gmail.com)
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use crate::test_helpers::*;
use predicates::prelude::*;
use std::error::Error;

#[test]
fn test_runtime_parameters_across_groups() -> Result<(), Box<dyn Error>> {
    let vh = "rabbitmqadmin.runtime_parameters.test1";
    delete_vhost(vh).expect("failed to delete a virtual host");

    run_succeeds(["declare", "vhost", "--name", vh]);
    run_succeeds([
        "-V",
        vh,
        "declare",
        "parameter",
        "--component",
        "federation-upstream",
        "--name",
        "my-upstream",
        "--value",
        "{\"uri\":\"amqp://target.hostname\"}",
    ]);
    await_metric_emission(200);

    run_succeeds([
        "-V",
        vh,
        "list",
        "parameters",
        "--component",
        "federation-upstream",
    ])
    .stdout(output_includes("my-upstream"));

    run_succeeds([
        "-V",
        vh,
        "delete",
        "parameter",
        "--component",
        "federation-upstream",
        "--name",
        "my-upstream",
    ]);

    run_succeeds([
        "-V",
        vh,
        "list",
        "parameters",
        "--component",
        "federation-upstream",
    ])
    .stdout(output_includes("my-upstream").not());

    delete_vhost(vh).expect("failed to delete a virtual host");

    Ok(())
}

#[test]
fn test_runtime_parameters_cmd_group() -> Result<(), Box<dyn Error>> {
    let vh = "rabbitmqadmin.runtime_parameters.test2";
    delete_vhost(vh).expect("failed to delete a virtual host");

    run_succeeds(["vhosts", "declare", "--name", vh]);
    run_succeeds([
        "-V",
        vh,
        "parameters",
        "set",
        "--component",
        "federation-upstream",
        "--name",
        "my-upstream",
        "--value",
        "{\"uri\":\"amqp://target.hostname\",\"ack-mode\":\"on-confirm\"}",
    ]);
    await_metric_emission(200);

    run_succeeds(["parameters", "list_all"]).stdout(output_includes("my-upstream"));

    run_succeeds([
        "-V",
        vh,
        "parameters",
        "list",
        "--component",
        "federation-upstream",
    ])
    .stdout(output_includes("my-upstream"));

    run_succeeds([
        "-V",
        vh,
        "parameters",
        "list_in",
        "--component",
        "federation-upstream",
    ])
    .stdout(output_includes("my-upstream"));

    run_succeeds([
        "-V",
        vh,
        "parameters",
        "delete",
        "--component",
        "federation-upstream",
        "--name",
        "my-upstream",
    ]);

    run_succeeds([
        "-V",
        vh,
        "parameters",
        "list",
        "--component",
        "federation-upstream",
    ])
    .stdout(output_includes("my-upstream").not());

    delete_vhost(vh).expect("failed to delete a virtual host");

    Ok(())
}

#[test]
fn test_global_runtime_parameters_cmd_group() -> Result<(), Box<dyn Error>> {
    run_succeeds([
        "global_parameters",
        "set",
        "--name",
        "cluster_tags",
        "--value",
        "{\"region\": \"ca-central-1\"}",
    ]);

    run_succeeds(["global_parameters", "list"])
        .stdout(output_includes("region").and(output_includes("ca-central-1")));

    run_succeeds(["global_parameters", "delete", "--name", "cluster_tags"]);

    run_succeeds(["global_parameters", "list"]).stdout(output_includes("cluster_tags").not());

    Ok(())
}

#[test]
fn test_parameters_clear_idempotently() -> Result<(), Box<dyn Error>> {
    let vh = "rabbitmqadmin.runtime_parameters.test3";
    let param_name = "test_param_delete_idempotently";
    let component = "federation-upstream";

    // Create vhost
    delete_vhost(vh).expect("failed to delete a virtual host");
    run_succeeds(["declare", "vhost", "--name", vh]);

    // Try clearing a non-existent parameter with --idempotently (should succeed)
    run_succeeds([
        "-V",
        vh,
        "parameters",
        "clear",
        "--name",
        param_name,
        "--component",
        component,
        "--idempotently",
    ]);

    // Set the parameter
    run_succeeds([
        "-V",
        vh,
        "parameters",
        "set",
        "--name",
        param_name,
        "--component",
        component,
        "--value",
        r#"{"uri": "amqp://localhost"}"#,
    ]);

    // Clear it normally
    run_succeeds([
        "-V",
        vh,
        "parameters",
        "clear",
        "--name",
        param_name,
        "--component",
        component,
    ]);

    // Try clearing it again with --idempotently (should succeed)
    run_succeeds([
        "-V",
        vh,
        "parameters",
        "clear",
        "--name",
        param_name,
        "--component",
        component,
        "--idempotently",
    ]);

    delete_vhost(vh).expect("failed to delete a virtual host");

    Ok(())
}

#[test]
fn test_global_parameters_clear_idempotently() -> Result<(), Box<dyn Error>> {
    let param_name = "test_global_param_delete_idempotently";

    // Set the global parameter first
    run_succeeds([
        "global_parameters",
        "set",
        "--name",
        param_name,
        "--value",
        r#"{"test": "value"}"#,
    ]);

    // Clear it normally
    run_succeeds(["global_parameters", "clear", "--name", param_name]);

    // Set it again
    run_succeeds([
        "global_parameters",
        "set",
        "--name",
        param_name,
        "--value",
        r#"{"test": "value2"}"#,
    ]);

    // Clear it with --idempotently (should succeed)
    run_succeeds([
        "global_parameters",
        "clear",
        "--name",
        param_name,
        "--idempotently",
    ]);

    Ok(())
}