/cognee/infrastructure/engine/utils/parse_id.py

from typing import Any
from uuid import UUID


def parse_id(id: Any) -> Any:
    """
    Parse the input ID and convert it to a UUID object if it is a valid string
    representation.

    If the input is not a string or if the string cannot be converted to a UUID, return the
    input unchanged. This function catches exceptions that may arise from invalid string
    formats during conversion, but does not raise those exceptions further.

    Parameters:
    -----------

        - id (any): The input ID, which can be of any type and may be a string
          representation of a UUID.

    Returns:
    --------

        The original input ID if it is not a string or cannot be converted to a UUID;
        otherwise, a UUID object if the conversion is successful.
    """
    if isinstance(id, str):
        try:
            return UUID(id)
        except Exception:
            pass
    return id