Value Objects¶

def __post_init__(self):
    """
    Validates KO ID format after initialization.

    Raises
    ------
    ValueError
        If ID is invalid (does not start with 'K' or length != 6).
    """
    if not self.id:
        logger.warning("KO validation failed: Empty ID")
        raise ValueError("KO ID cannot be empty")

    if not self.id.startswith("K"):
        logger.warning(
            "KO validation failed: Invalid prefix", extra={"ko_id": self.id}
        )
        raise ValueError(f"Invalid KO ID: {self.id}. Must start with 'K'")

    if len(self.id) != 6:
        logger.warning(
            "KO validation failed: Invalid length",
            extra={"ko_id": self.id, "length": len(self.id)},
        )
        raise ValueError(
            f"Invalid KO ID: {self.id}. Must have exactly 6 characters"
        )

    # Verifica se os 5 últimos caracteres são dígitos
    if not self.id[1:].isdigit():
        logger.warning(
            "KO validation failed: Non-numeric suffix", extra={"ko_id": self.id}
        )
        raise ValueError(
            f"Invalid KO ID: {self.id}. Last 5 characters must be digits"
        )

    logger.debug("KO created successfully", extra={"ko_id": self.id})

def __str__(self) -> str:
    """
    Returns string representation of KO.

    Returns
    -------
    str
        The KO ID.
    """
    return self.id

def __repr__(self) -> str:
    """
    Returns debug representation of KO.

    Returns
    -------
    str
        Representation in format "KO('KXXXXX')".
    """
    return f"KO('{self.id}')"

def __hash__(self) -> int:
    """
    Allows using KO as dictionary key or in sets.

    Returns
    -------
    int
        Hash of the ID.
    """
    return hash(self.id)

def __post_init__(self):
    """
    Validates the identifier after initialization.

    Raises
    ------
    ValueError
        If value is empty or None.
    """
    if not self.value or not self.value.strip():
        raise ValueError("Sample ID cannot be empty")

def __str__(self) -> str:
    """
    Returns string representation of Sample ID.

    Returns
    -------
    str
        The identifier value.
    """
    return self.value

def __repr__(self) -> str:
    """
    Returns debug representation of Sample ID.

    Returns
    -------
    str
        Representation in format "SampleId('value')".
    """
    return f"SampleId('{self.value}')"

def __hash__(self) -> int:
    """
    Allows using SampleId as dictionary key.

    Returns
    -------
    int
        Hash of the value.
    """
    return hash(self.value)

def __post_init__(self):
    """
    Validates pathway fields.

    Raises
    ------
    ValueError
        If ID or name are invalid.
    """
    if not self.id or not self.id.strip():
        raise ValueError("Pathway ID cannot be empty")

    if not self.name or not self.name.strip():
        raise ValueError("Pathway name cannot be empty")

def __str__(self) -> str:
    """
    Returns string representation of pathway.

    Returns
    -------
    str
        Pathway name.
    """
    return self.name

def __repr__(self) -> str:
    """
    Returns debug representation of pathway.

    Returns
    -------
    str
        Representation in format "Pathway('id', 'name')".
    """
    return f"Pathway('{self.id}', '{self.name}')"

def __hash__(self) -> int:
    """
    Hash based on pathway ID.

    Returns
    -------
    int
        Hash of the ID.
    """
    return hash(self.id)

def __post_init__(self):
    """
    Validates required compound fields.

    Raises
    ------
    ValueError
        If cpd or name are invalid.
    """
    if not self.cpd or not self.cpd.strip():
        raise ValueError("Compound code (cpd) cannot be empty")

    if not self.name or not self.name.strip():
        raise ValueError("Compound name cannot be empty")

def __str__(self) -> str:
    """
    Returns string representation of compound.

    Returns
    -------
    str
        Compound name.
    """
    return self.name

def __repr__(self) -> str:
    """
    Returns debug representation of compound.

    Returns
    -------
    str
        Representation with cpd and name.
    """
    return f"Compound('{self.cpd}', '{self.name}')"

def __hash__(self) -> int:
    """
    Hash based on compound code.

    Returns
    -------
    int
        Hash of cpd.
    """
    return hash(self.cpd)

def has_structure(self) -> bool:
    """
    Checks if compound has structural information (SMILES).

    Returns
    -------
    bool
        True if SMILES is defined.
    """
    return self.smiles is not None and len(self.smiles.strip()) > 0

def has_chebi(self) -> bool:
    """
    Checks if compound has ChEBI reference.

    Returns
    -------
    bool
        True if ChEBI is defined.
    """
    return self.chebi is not None and len(self.chebi.strip()) > 0