qubit-mixin 0.2.0

Trait mixins for domain objects, providing common properties and behaviors
Documentation
////////////////////////////////////////////////////////////////////////////////
//
//  Copyright (C) 2025 Haixing Hu
//
//  This program is free software: you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation, either version 3 of the License, or
//  (at your option) any later version.
//
//  This program is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.
//
//  You should have received a copy of the GNU General Public License
//  along with this program. If not, see <https://www.gnu.org/licenses/>.
//
////////////////////////////////////////////////////////////////////////////////

//! Traits for code property functionality
//!
//! # Author
//!
//! Haixing Hu

/// A trait indicating that an entity class has a code property
///
/// This trait provides access and setting functionality for the code of
/// domain objects, where the code is usually a globally unique identifier.
///
/// # Example
///
/// ```rust
/// use qubit_mixin::WithCode;
///
/// struct Product {
///     code: String,
///     name: String,
/// }
///
/// impl WithCode for Product {
///     fn code(&self) -> &str {
///         &self.code
///     }
///
///     fn set_code(&mut self, code: &str) {
///         self.code = code.to_string();
///     }
/// }
///
/// let mut product = Product {
///     code: "PROD001".to_string(),
///     name: "Widget".to_string(),
/// };
/// assert_eq!(product.code(), "PROD001");
///
/// product.set_code("PROD002");
/// assert_eq!(product.code(), "PROD002");
/// ```
///
/// # Author
///
/// Haixing Hu
pub trait WithCode {
    /// Gets the code of the current object
    ///
    /// # Returns
    ///
    /// The code of the current object
    fn code(&self) -> &str;

    /// Sets the code of the current object
    ///
    /// # Parameters
    ///
    /// * `code` - The new code to be set
    fn set_code(&mut self, code: &str);
}