rabbitmq_http_client 0.88.0

RabbitMQ HTTP API client
Documentation
// Copyright (C) 2023-2025 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::responses::*;
use serde_json::Map;
use std::fmt;
use std::fmt::Display;

impl Display for ObjectTotals {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(f, "connections: {}", self.connections)?;
        writeln!(f, "channels: {}", self.channels)?;
        writeln!(f, "queues: {}", self.queues)?;
        writeln!(f, "exchanges: {}", self.exchanges)?;

        Ok(())
    }
}

impl Display for Rate {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{:.2}", self.rate)
    }
}

impl Display for ChurnRates {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(f, "connection_created: {}", self.connection_created)?;
        writeln!(f, "connection_closed: {}", self.connection_closed)?;
        writeln!(f, "queue_declared: {}", self.queue_declared)?;
        writeln!(f, "queue_created: {}", self.queue_created)?;
        writeln!(f, "queue_deleted: {}", self.queue_deleted)?;
        writeln!(f, "channel_created: {}", self.channel_created)?;
        writeln!(f, "channel_closed: {}", self.channel_closed)?;

        Ok(())
    }
}

impl Display for QueueTotals {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(f, "all messages: {}", self.messages)?;
        writeln!(
            f,
            "messages ready for delivery: {}",
            self.messages_ready_for_delivery
        )?;
        writeln!(
            f,
            "messages delivered but unacknowledged by consumer: {}",
            self.messages_delivered_but_unacknowledged_by_consumers
        )?;

        Ok(())
    }
}

impl Display for MessageStats {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(
            f,
            "publishing (ingress) rate: {}",
            display_option_details_rate(&self.publishing_details)
        )?;
        writeln!(
            f,
            "delivery plus polling (egress) rate: {}",
            display_option_details_rate(&self.delivery_details)
        )?;

        Ok(())
    }
}

impl Display for TagList {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt_comma_separated_list(f, &self.0)
    }
}

impl Display for TagMap {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt_map_as_colon_separated_pairs(f, &self.0)
    }
}

impl Display for DeprecatedFeatureList {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        for name in &self.0 {
            writeln!(f, "{name}")?;
        }
        Ok(())
    }
}

impl Display for DeprecatedFeature {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(f, "name: {}", self.name)?;
        writeln!(f, "description: {}", self.description)?;
        writeln!(f, "deprecation_phase: {}", self.deprecation_phase)?;

        Ok(())
    }
}

impl Display for PluginList {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt_vertical_list_with_bullets(f, &self.0)
    }
}

impl Display for XArguments {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt_map_as_colon_separated_pairs(f, &self.0)
    }
}

impl Display for FeatureFlag {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(f, "name: {}", self.name)?;
        writeln!(f, "description: {}", self.description)?;
        writeln!(f, "doc URL: {}", self.doc_url)?;
        writeln!(f, "stability: {}", self.stability)?;
        writeln!(f, "provided by: {}", self.provided_by)?;

        Ok(())
    }
}

impl Display for FeatureFlagList {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        for item in &self.0 {
            writeln!(f, "{item}")?;
        }
        Ok(())
    }
}

impl Display for MessageList {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        for item in &self.0 {
            writeln!(f, "{item}")?;
        }
        Ok(())
    }
}

impl Display for MessageRouted {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        let message = if self.routed {
            "Message published and routed successfully"
        } else {
            "Message published but NOT routed"
        };
        write!(f, "{}", message)
    }
}

impl Display for MessageProperties {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt_map_as_colon_separated_pairs(f, &self.0)
    }
}

impl Display for GetMessage {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(f, "payload: {}", self.payload)?;
        writeln!(f, "exchange: {}", self.exchange)?;
        writeln!(f, "routing key: {}", self.routing_key)?;
        writeln!(f, "redelivered: {}", self.redelivered)?;
        writeln!(f, "properties: {}", self.properties)?;

        Ok(())
    }
}

impl Display for SchemaDefinitionSyncState {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let state = match self {
            SchemaDefinitionSyncState::Recover => "recover",
            SchemaDefinitionSyncState::Connected => "connected",
            SchemaDefinitionSyncState::PublisherInitialized => "publisher initialized",
            SchemaDefinitionSyncState::Syncing => "syncing",
            SchemaDefinitionSyncState::Disconnected => "disconnected",
        };
        write!(f, "{}", state)
    }
}

impl Display for OperatingMode {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let mode = match self {
            OperatingMode::Upstream => "upstream",
            OperatingMode::Downstream => "downstream",
        };
        write!(f, "{}", mode)
    }
}

impl Display for HostnamePortPairs {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt_vertical_list_without_bullets(f, &self.0)
    }
}

pub fn fmt_list<T: Display>(
    f: &mut fmt::Formatter<'_>,
    items: &[T],
    separator: &str,
    prefix: &str,
) -> fmt::Result {
    for (i, item) in items.iter().enumerate() {
        if i > 0 {
            write!(f, "{}", separator)?;
        }
        write!(f, "{}{}", prefix, item)?;
    }
    Ok(())
}

pub fn fmt_comma_separated_list(f: &mut fmt::Formatter<'_>, xs: &[String]) -> fmt::Result {
    fmt_list(f, xs, ", ", "")
}

pub fn fmt_vertical_list_with_bullets(f: &mut fmt::Formatter<'_>, xs: &[String]) -> fmt::Result {
    fmt_list(f, xs, "\n", "* ")
}

pub fn fmt_vertical_list_without_bullets(f: &mut fmt::Formatter<'_>, xs: &[String]) -> fmt::Result {
    fmt_list(f, xs, "\n", "")
}

pub fn fmt_map_as_colon_separated_pairs(
    f: &mut fmt::Formatter<'_>,
    xs: &Map<String, serde_json::Value>,
) -> fmt::Result {
    for (k, v) in xs.iter() {
        writeln!(f, "{k}: {v}")?;
    }

    Ok(())
}

pub fn display_option<T: Display>(opt: &Option<T>) -> String {
    opt.as_ref().map_or_else(String::new, |val| val.to_string())
}

pub fn display_option_details_rate(opt: &Option<Rate>) -> String {
    opt.as_ref()
        .map_or_else(String::new, |val| val.rate.to_string())
}

pub fn display_arg_table(xs: &XArguments) -> String {
    xs.0.iter()
        .map(|(k, v)| format!("{k}: {v}"))
        .collect::<Vec<_>>()
        .join("\n")
}

pub fn display_tag_map_option(opt: &Option<TagMap>) -> String {
    opt.as_ref().map_or_else(String::new, |val| {
        val.0
            .iter()
            .map(|(k, v)| format!("\"{k}\": {v}"))
            .collect::<Vec<_>>()
            .join("\n")
    })
}

pub fn display_tag_list_option(opt: &Option<TagList>) -> String {
    opt.as_ref().map_or_else(String::new, |val| {
        val.0
            .iter()
            .map(|t| t.to_string())
            .collect::<Vec<_>>()
            .join("\n")
    })
}