q 0.1.1

Q is a Rust GDExtension crate for Godot, offering a Game Manager, Music Manager, Bevy ECS, and Tokio-powered multi-threading. It simplifies and enhances game development with efficient tools and scalable performance.
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
133
134
135
136
137
138
139
140
141
142
143

use crate::data::abstract_data_map::AbstractDataMap;
use crate::debug_print;
use dashmap::DashMap;
use godot::prelude::*;
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct UserData {
    pub username: String,
    pub email: String,
    pub opacity: f32,
    pub fullscreen: bool,
    pub theme: Option<String>,
    pub global_music_volume: f32,
    pub global_effects_volume: f32,
    pub global_sfx_volume: f32,
}

impl AbstractDataMap for UserData {}

impl UserData {
    #[allow(clippy::too_many_arguments)]
    pub fn new(
        username: &str,
        email: &str,
        opacity: f32,
        fullscreen: bool,
        theme: Option<String>,
        global_music_volume: f32,
        global_effects_volume: f32,
        global_sfx_volume: f32,
    ) -> Self {
        Self {
            username: username.to_string(),
            email: email.to_string(),
            opacity,
            fullscreen,
            theme,
            global_music_volume,
            global_effects_volume,
            global_sfx_volume,
        }
    }
}

pub struct UserDataCache {
    map: DashMap<String, Variant>,
}

impl UserDataCache {
    pub fn new() -> Self {
        Self {
            map: DashMap::new(),
        }
    }

    pub fn insert<T: ToGodot>(&self, key: &str, value: T) {
        self.map.insert(key.to_string(), value.to_variant());
    }

    pub fn get<T: FromGodot>(&self, key: &str) -> Option<T> {
        self.map
            .get(&key.to_string())
            .map(|r| T::from_variant(r.value()))
    }

    pub fn contains(&self, key: &str) -> bool {
        self.map.contains_key(&key.to_string())
    }

    pub fn remove(&self, key: &str) -> Option<Variant> {
        self.map.remove(&key.to_string()).map(|(_, v)| v)
    }

    pub fn update<T: ToGodot>(&self, key: &str, value: T) -> bool {
        if self.contains(key) {
            self.insert(key, value);
            true
        } else {
            false
        }
    }

    // User Saving + File
    pub fn save_new_user_data(&mut self, file_path: &str) -> UserData {
        godot_warn!("[UserDataCache] Creating new default user data...");

        let default_data = UserData::new(
            "Player",
            "guest@kbve.com",
            0.55,
            false,
            Some("dark".to_string()),
            0.0,
            0.0,
            0.0,
        );

        self.save_user_data(&default_data);
        self.save_to_file(file_path, &default_data);

        debug_print!("[UserDataCache] New user data saved successfully.");

        default_data
    }

    pub fn save_to_file(&self, file_path: &str, user_data: &UserData) {
        if user_data.to_save_gfile_json(file_path) {
            debug_print!("[UserDataCache] Successfully saved user settings.");
        } else {
            godot_error!(
                "[UserDataCache] ERROR: Failed to save user settings to `{}`!",
                file_path
            );
        }
    }

    pub fn load_from_file(&mut self, file_path: &str) -> Option<UserData> {
        debug_print!("[UserDataCache] Loading file: {}", file_path);

        if let Some(user_data) = UserData::from_load_gfile_json(file_path) {
            debug_print!("[UserDataCache] Settings loaded.");
            self.save_user_data(&user_data);
            Some(user_data)
        } else {
            godot_error!(
                "[UserDataCache] ERROR: Failed to load from file: {}!",
                file_path
            );
            None
        }
    }

    pub fn save_user_data(&mut self, user_data: &UserData) {
        let new_map = user_data.to_variant_map();
        self.map = new_map;
        debug_print!("[UserDataCache] User data cached.");
    }

    pub fn load_user_data(&self) -> Option<UserData> {
        UserData::from_variant_map(&self.map)
    }
}