feagi-structures 0.0.11

The most core library, defines the basic data types used by FEAGI, as well as some processors to modify them
Documentation
use crate::FeagiDataError;

// TODO serialize from json serializable directly

/// A wrapper around serde_json::Value for handling JSON data in FEAGI.
///
/// Provides methods to create, parse, and manipulate JSON data with error handling.
#[derive(Clone, Debug, Hash)]
pub struct FeagiJSON {
    json: serde_json::Value,
}

impl FeagiJSON {
    /// Creates an empty JSON object.
    ///
    /// # Example
    /// ```
    /// use feagi_structures::FeagiJSON;
    ///
    /// let json = FeagiJSON::new_empty();
    /// println!("{}", json); // prints: {}
    /// ```
    pub fn new_empty() -> FeagiJSON {
        FeagiJSON {
            json: serde_json::json!({}),
        }
    }

    /// Parses a JSON string into a FeagiJSON wrapper.
    ///
    /// # Example
    /// ```
    /// use feagi_structures::FeagiJSON;
    ///
    /// let json = FeagiJSON::from_json_string(r#"{"key": "value"}"#.to_string()).unwrap();
    /// ```
    pub fn from_json_string(string: String) -> Result<FeagiJSON, FeagiDataError> {
        match serde_json::from_str(&string) {
            Ok(json_value) => Ok(FeagiJSON { json: json_value }),
            Err(e) => Err(FeagiDataError::BadParameters(format!(
                "Failed to parse JSON string: {}",
                e
            ))),
        }
    }

    /// Creates a FeagiJSON from an existing serde_json::Value.
    pub fn from_json_value(value: serde_json::Value) -> FeagiJSON {
        FeagiJSON { json: value }
    }

    /// Returns a reference to the internal JSON value.
    pub fn borrow_json_value(&self) -> &serde_json::Value {
        &self.json
    }

    /// Updates the internal JSON value.
    pub fn update_json_value(&mut self, new_value: serde_json::Value) {
        self.json = new_value;
    }
}

impl std::fmt::Display for FeagiJSON {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "{}", self.json)
    }
}