Skip to content

Id

docarray.typing.id

ID

Bases: str, AbstractType

Represent an unique ID

Source code in docarray/typing/id.py
@_register_proto(proto_type_name='id')
class ID(str, AbstractType):
    """
    Represent an unique ID
    """

    @classmethod
    def __get_validators__(cls):
        yield cls.validate

    @classmethod
    def validate(
        cls: Type[T],
        value: Union[str, int, UUID],
        field: 'ModelField',
        config: 'BaseConfig',
    ) -> T:
        try:
            id: str = str(value)
            return cls(id)
        except Exception:
            raise ValueError(f'Expected a str, int or UUID, got {type(value)}')

    def _to_node_protobuf(self) -> 'NodeProto':
        """Convert an ID into a NodeProto message. This function should
        be called when the self is nested into another Document that need to be
        converted into a protobuf

        :return: the nested item protobuf message
        """
        from docarray.proto import NodeProto

        return NodeProto(text=self, type=self._proto_type_name)

    @classmethod
    def from_protobuf(cls: Type[T], pb_msg: 'str') -> T:
        """
        read ndarray from a proto msg
        :param pb_msg:
        :return: a string
        """
        return parse_obj_as(cls, pb_msg)

from_protobuf(pb_msg) classmethod

read ndarray from a proto msg

Parameters:

Name Type Description Default
pb_msg str required

Returns:

Type Description
T

a string

Source code in docarray/typing/id.py
@classmethod
def from_protobuf(cls: Type[T], pb_msg: 'str') -> T:
    """
    read ndarray from a proto msg
    :param pb_msg:
    :return: a string
    """
    return parse_obj_as(cls, pb_msg)