rabbitmqadmin-sdk 0.1.1

Async Rust SDK for the RabbitMQ Management HTTP API
Documentation
//! Types shared across multiple Management API responses.

use serde::{Deserialize, Deserializer};
use serde_json::Value;

/// Deserialize a `tags` field that RabbitMQ represents differently across
/// versions: RabbitMQ 3.12 returns a comma-separated string (e.g.
/// `"administrator,management"`) while RabbitMQ 4.x returns a JSON array
/// (e.g. `["administrator", "management"]`). Both shapes are normalized
/// to a `Vec<String>`; string values are split on `,` with whitespace
/// trimmed and empty segments dropped.
pub(crate) fn deserialize_tags<'de, D>(deserializer: D) -> Result<Vec<String>, D::Error>
where
    D: Deserializer<'de>,
{
    #[derive(Deserialize)]
    #[serde(untagged)]
    enum Tags {
        S(String),
        V(Vec<String>),
    }

    match Tags::deserialize(deserializer)? {
        Tags::S(s) => Ok(s
            .split(',')
            .map(str::trim)
            .filter(|t| !t.is_empty())
            .map(str::to_owned)
            .collect()),
        Tags::V(v) => Ok(v),
    }
}

/// Message rate counters as returned inside overview, queue, channel, and
/// connection payloads under the `message_stats` key.
///
/// Any counter may be absent (RabbitMQ omits stats for objects that have
/// had no traffic), so every field is optional.
#[derive(Debug, Clone, Deserialize)]
pub struct MessageStats {
    /// Total messages published.
    #[serde(default)]
    pub publish: Option<u64>,
    /// Total messages delivered to consumers plus basic.get responses.
    #[serde(default)]
    pub deliver_get: Option<u64>,
    /// Total messages acknowledged.
    #[serde(default)]
    pub ack: Option<u64>,
    /// Total messages redelivered.
    #[serde(default)]
    pub redeliver: Option<u64>,
    /// Total publisher confirms received.
    #[serde(default)]
    pub confirm: Option<u64>,
    /// Rate details for `publish` (open-ended map of `rate`, `interval`, ...).
    #[serde(default)]
    pub publish_details: Option<Value>,
    /// Rate details for `deliver_get`.
    #[serde(default)]
    pub deliver_get_details: Option<Value>,
    /// Rate details for `ack`.
    #[serde(default)]
    pub ack_details: Option<Value>,
}

/// Cluster-wide object counts, as returned by `GET /api/overview` under
/// `object_totals`. All fields are always present in the response.
#[derive(Debug, Clone, Deserialize)]
pub struct ObjectTotals {
    /// Number of channels in the cluster.
    pub channels: u64,
    /// Number of connections in the cluster.
    pub connections: u64,
    /// Number of consumers in the cluster.
    pub consumers: u64,
    /// Number of exchanges in the cluster.
    pub exchanges: u64,
    /// Number of queues in the cluster.
    pub queues: u64,
}

/// Cluster-wide message totals, as returned by `GET /api/overview` under
/// `queue_totals`. All fields are always present in the response.
#[derive(Debug, Clone, Deserialize)]
pub struct QueueTotals {
    /// Total messages across all queues (ready + unacknowledged).
    pub messages: u64,
    /// Total messages ready for delivery across all queues.
    pub messages_ready: u64,
    /// Total messages delivered but not yet acknowledged across all queues.
    pub messages_unacknowledged: u64,
}