jina.types.mixin module

class jina.types.mixin.ProtoTypeMixin[source]

Bases: object

The base mixin class of all Jina types.

Note

  • All Jina types should inherit from this class.

  • All subclass should have self._pb_body

  • All subclass should implement __init__ with the possibility of initializing from None, e.g.:

    1. class MyJinaType(ProtoTypeMixin):
    2. def __init__(self, proto: Optional[jina_pb2.SomePbMsg] = None):
    3. self._pb_body = proto or jina_pb2.SomePbMsg()
  • to_json()[source]

    Return the object in JSON string

    • Return type

      str

      Returns

      JSON string of the object

  • to_dict()[source]

    Return the object in Python dictionary.

    Note

    Array like object such as numpy.ndarray (i.e. anything described as jina_pb2.NdArrayProto) will be converted to Python list.

    • Return type

      Dict

      Returns

      dict representation of the object

  • property proto: jina_pb2._reflection.GeneratedProtocolMessageType

    Return the underlying Protobuf object

    • Return type

      jina_pb2._reflection.GeneratedProtocolMessageType

      Returns

      Protobuf representation of the object

  • to_bytes()[source]

    Return the serialized the message to a string.

    For more Pythonic code, please use bytes(...).

    • Return type

      bytes

      Returns

      binary string representation of the object

  • property nbytes: int

    Return total bytes consumed by protobuf.

    • Return type

      int

      Returns

      number of bytes

  • MergeFrom(other)[source]

    Merge the content of target

    • Parameters

      other (~T) – the document to merge from

      Return type

      None

  • CopyFrom(other)[source]

    Copy the content of target

    • Parameters

      other (~T) – the document to copy from

      Return type

      None

  • clear()[source]

    Remove all values from all fields of this Document.

    • Return type

      None

  • pop(\fields*)[source]

    Remove the values from the given fields of this Document.

    • Parameters

      fields – field names

      Return type

      None

  • dict(\*kwargs*)

  • json(\*kwargs*)

  • binary_str(\*kwargs*)