bevy_event_bus 1.2.0

A Bevy plugin that connects Bevy's event system to external message brokers like Kafka
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use std::any::Any;
use std::collections::HashMap;
use std::time::Instant;

/// Generic message metadata that works across all backends
#[derive(Debug, Clone)]
pub struct MessageMetadata {
    pub source: String, // topic/queue/stream name
    pub timestamp: Instant,
    pub key: Option<String>, // Generic message key
    pub backend_specific: Option<Box<dyn BackendMetadata>>,
}

/// Trait for backend-specific metadata extensions
pub trait BackendMetadata: Send + Sync + std::fmt::Debug {
    fn as_any(&self) -> &dyn Any;
    fn clone_box(&self) -> Box<dyn BackendMetadata>;
}

// Implement Clone for Box<dyn BackendMetadata>
impl Clone for Box<dyn BackendMetadata> {
    fn clone(&self) -> Self {
        self.clone_box()
    }
}

/// Kafka-specific metadata
#[derive(Debug, Clone)]
pub struct KafkaMetadata {
    pub topic: String,
    pub partition: i32,
    pub offset: i64,
    pub consumer_group: Option<String>,
    pub manual_commit: bool,
    pub headers: HashMap<String, String>,
}

impl BackendMetadata for KafkaMetadata {
    fn as_any(&self) -> &dyn Any {
        self
    }
    fn clone_box(&self) -> Box<dyn BackendMetadata> {
        Box::new(self.clone())
    }
}

/// Redis-specific metadata
#[derive(Debug, Clone)]
pub struct RedisMetadata {
    pub stream: String,
    pub entry_id: String,
    pub consumer_group: Option<String>,
    pub manual_ack: bool,
}

impl BackendMetadata for RedisMetadata {
    fn as_any(&self) -> &dyn Any {
        self
    }

    fn clone_box(&self) -> Box<dyn BackendMetadata> {
        Box::new(self.clone())
    }
}

/// Extension methods for easy access to backend-specific metadata
impl MessageMetadata {
    /// Create new metadata with backend-specific data
    pub fn new(
        source: String,
        timestamp: Instant,
        key: Option<String>,
        backend_specific: Option<Box<dyn BackendMetadata>>,
    ) -> Self {
        Self {
            source,
            timestamp,
            key,
            backend_specific,
        }
    }

    /// Get Kafka-specific metadata if available
    pub fn kafka_metadata(&self) -> Option<&KafkaMetadata> {
        self.backend_specific
            .as_ref()?
            .as_any()
            .downcast_ref::<KafkaMetadata>()
    }

    /// Get Redis-specific metadata if available
    pub fn redis_metadata(&self) -> Option<&RedisMetadata> {
        self.backend_specific
            .as_ref()?
            .as_any()
            .downcast_ref::<RedisMetadata>()
    }
}