arri_repr 1.3.4

Rust representations of Arri types
Documentation
use std::ops::BitOr;

use ronky_derive::Serializable as SerializableDerive;

/// Macro to merge fields from one struct into another.
///
/// This macro checks if a field in the source struct (`$other`) is `Some`
/// and, if so, clones its value into the corresponding field of the target
/// struct (`$self`).
macro_rules! merge_fields {
    ($self:expr, $other:expr, $($field:ident),*) => {
        $(
            if let Some(value) = &$other.$field {
                $self.$field = Some(value.clone());
            }
        )*
    };
}

/// Represents metadata schema for Arri.
///
/// This struct defines the metadata schema, including optional fields
/// such as `id`, `description`, and deprecation-related information.
#[derive(Default, Debug, Clone, PartialEq, Eq, SerializableDerive)]
#[arri_disable(metadata, nullable)]
pub struct MetadataSchema {
    /// Unique identifier for the metadata schema.
    pub id: Option<String>,
    /// Description of the metadata schema.
    pub description: Option<String>,
    /// Indicates whether the schema is deprecated.
    pub is_deprecated: Option<bool>,
    /// Version since which the schema is deprecated.
    pub deprecated_since: Option<String>,
    /// Message explaining the deprecation.
    pub deprecated_message: Option<String>,
}

impl MetadataSchema {
    /// Creates a new, empty `MetadataSchema`.
    pub fn new() -> Self {
        Self::default()
    }

    /// Sets the `id` field of the metadata schema.
    ///
    /// # Arguments
    ///
    /// * `id` - A value that can be converted to a `String`.
    pub fn set_id(&mut self, id: impl ToString) -> &mut Self {
        self.id = Some(id.to_string());
        self
    }

    /// Sets the `description` field of the metadata schema.
    ///
    /// # Arguments
    ///
    /// * `description` - A value that can be converted to a `String`.
    pub fn set_description(&mut self, description: impl ToString) -> &mut Self {
        self.description = Some(description.to_string());
        self
    }

    /// Sets the `is_deprecated` field of the metadata schema.
    ///
    /// # Arguments
    ///
    /// * `flag` - A boolean indicating whether the schema is deprecated.
    pub fn set_deprecated(&mut self, flag: bool) -> &mut Self {
        self.is_deprecated = Some(flag);
        self
    }

    /// Sets the `deprecated_since` field of the metadata schema.
    ///
    /// # Arguments
    ///
    /// * `version` - A value that can be converted to a `String` representing the version.
    pub fn set_deprecated_since(&mut self, version: impl ToString) -> &mut Self {
        self.deprecated_since = Some(version.to_string());
        self
    }

    /// Sets the `deprecated_message` field of the metadata schema.
    ///
    /// # Arguments
    ///
    /// * `message` - A value that can be converted to a `String` explaining the deprecation.
    pub fn set_deprecated_message(&mut self, message: impl ToString) -> &mut Self {
        self.deprecated_message = Some(message.to_string());
        self
    }

    /// Merges another `MetadataSchema` into this one.
    ///
    /// Fields in the other schema take precedence if they are `Some`.
    ///
    /// # Arguments
    ///
    /// * `other` - A reference to another `MetadataSchema` to merge.
    ///
    /// # Returns
    ///
    /// A new `MetadataSchema` with merged fields.
    pub fn merge(mut self, other: &Self) -> Self {
        merge_fields!(
            self,
            other,
            id,
            description,
            deprecated_since,
            deprecated_message
        );

        // Handle non-String fields separately
        if let Some(is_deprecated) = other.is_deprecated {
            self.is_deprecated = Some(is_deprecated);
        }

        self
    }
}

impl BitOr for MetadataSchema {
    type Output = Self;

    fn bitor(self, other: Self) -> Self::Output {
        self.merge(&other)
    }
}

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

    #[test]
    fn test_metadata_schema_defaults() {
        let schema = MetadataSchema::new();
        assert_eq!(schema.id, None);
        assert_eq!(schema.description, None);
        assert_eq!(schema.is_deprecated, None);
        assert_eq!(schema.deprecated_since, None);
        assert_eq!(schema.deprecated_message, None);
    }

    #[test]
    fn test_metadata_schema_setters() {
        let mut schema = MetadataSchema::new();
        schema
            .set_id("123")
            .set_description("Test description")
            .set_deprecated(true)
            .set_deprecated_since("1.0.0")
            .set_deprecated_message("Deprecated for testing");

        assert_eq!(schema.id, Some("123".to_string()));
        assert_eq!(schema.description, Some("Test description".to_string()));
        assert_eq!(schema.is_deprecated, Some(true));
        assert_eq!(schema.deprecated_since, Some("1.0.0".to_string()));
        assert_eq!(
            schema.deprecated_message,
            Some("Deprecated for testing".to_string())
        );
    }

    #[test]
    fn test_metadata_schema_merge() {
        let mut schema1 = MetadataSchema::new();
        schema1.set_id("123").set_description("Schema 1");

        let mut schema2 = MetadataSchema::new();
        schema2
            .set_description("Schema 2")
            .set_deprecated(true)
            .set_deprecated_since("2.0.0");

        let merged = schema1.merge(&schema2);

        assert_eq!(merged.id, Some("123".to_string()));
        assert_eq!(merged.description, Some("Schema 2".to_string()));
        assert_eq!(merged.is_deprecated, Some(true));
        assert_eq!(merged.deprecated_since, Some("2.0.0".to_string()));
        assert_eq!(merged.deprecated_message, None);
    }

    #[test]
    fn test_metadata_schema_serialization() {
        let mut schema = MetadataSchema::new();
        schema
            .set_id("123")
            .set_description("Test description")
            .set_deprecated(true)
            .set_deprecated_since("1.0.0")
            .set_deprecated_message("Deprecated for testing");

        let serialized = schema.serialize();
        assert!(serialized.is_some());
        let serialized_str = serialized.unwrap();
        assert!(serialized_str.contains("\"id\":\"123\""));
        assert!(serialized_str.contains("\"description\":\"Test description\""));
        assert!(serialized_str.contains("\"isDeprecated\":true"));
        assert!(serialized_str.contains("\"deprecatedSince\":\"1.0.0\""));
        assert!(serialized_str.contains("\"deprecatedNote\":\"Deprecated for testing\""));
    }

    #[test]
    fn test_metadata_schema_bitor_operator() {
        let mut schema1 = MetadataSchema::new();
        schema1.set_id("123");

        let mut schema2 = MetadataSchema::new();
        schema2.set_description("Schema 2");

        let merged = schema1 | schema2;

        assert_eq!(merged.id, Some("123".to_string()));
        assert_eq!(merged.description, Some("Schema 2".to_string()));
    }
}