issun 0.10.0

A mini game engine for logic-focused games - Build games in ISSUN (一寸) of time
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

//! Inventory events for command and state notification

use crate::event::Event;
use serde::{Deserialize, Serialize};

use super::types::{EntityId, ItemId};

// =============================================================================
// Command Events (Request)
// =============================================================================

/// Request to add an item to an entity's inventory
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemAddRequested {
    pub entity_id: EntityId,
    pub item_id: ItemId,
    pub quantity: u32,
}

impl Event for ItemAddRequested {}

/// Request to remove an item from an entity's inventory
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemRemoveRequested {
    pub entity_id: EntityId,
    pub item_id: ItemId,
    pub quantity: u32,
}

impl Event for ItemRemoveRequested {}

/// Request to use an item from an entity's inventory
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemUseRequested {
    pub entity_id: EntityId,
    pub item_id: ItemId,
}

impl Event for ItemUseRequested {}

/// Request to transfer an item between entities
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemTransferRequested {
    pub from_entity: EntityId,
    pub to_entity: EntityId,
    pub item_id: ItemId,
    pub quantity: u32,
}

impl Event for ItemTransferRequested {}

// =============================================================================
// State Events (Notification)
// =============================================================================

/// Published when an item is added to an inventory
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemAddedEvent {
    pub entity_id: EntityId,
    pub item_id: ItemId,
    pub quantity: u32,
}

impl Event for ItemAddedEvent {}

/// Published when an item is removed from an inventory
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemRemovedEvent {
    pub entity_id: EntityId,
    pub item_id: ItemId,
    pub quantity: u32,
}

impl Event for ItemRemovedEvent {}

/// Published when an item is used
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemUsedEvent {
    pub entity_id: EntityId,
    pub item_id: ItemId,
}

impl Event for ItemUsedEvent {}

/// Published when an item is transferred between entities
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ItemTransferredEvent {
    pub from_entity: EntityId,
    pub to_entity: EntityId,
    pub item_id: ItemId,
    pub quantity: u32,
}

impl Event for ItemTransferredEvent {}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_event_serialization() {
        let event = ItemAddRequested {
            entity_id: "player_1".to_string(),
            item_id: "sword".to_string(),
            quantity: 1,
        };
        let json = serde_json::to_string(&event).unwrap();
        assert!(json.contains("player_1"));
        assert!(json.contains("sword"));

        let deserialized: ItemAddRequested = serde_json::from_str(&json).unwrap();
        assert_eq!(deserialized.entity_id, "player_1");
        assert_eq!(deserialized.item_id, "sword");
        assert_eq!(deserialized.quantity, 1);
    }

    #[test]
    fn test_item_transfer_event_serialization() {
        let event = ItemTransferredEvent {
            from_entity: "player_1".to_string(),
            to_entity: "player_2".to_string(),
            item_id: "potion".to_string(),
            quantity: 3,
        };
        let json = serde_json::to_string(&event).unwrap();
        let deserialized: ItemTransferredEvent = serde_json::from_str(&json).unwrap();
        assert_eq!(deserialized.from_entity, "player_1");
        assert_eq!(deserialized.to_entity, "player_2");
        assert_eq!(deserialized.item_id, "potion");
        assert_eq!(deserialized.quantity, 3);
    }
}