o €j6h² ã@sdZddlTddlmZdS)aÞ This module provides low level access to the ProtoBuffer "Message" classes used by the API. **For typical usage of this SDK you do not need to use any of these classes.** ProtoBufers are Google API's serilization format. They are strongly typed and efficient. The `genai` SDK tries to be permissive about what objects it will accept from a user, but in the end the SDK always converts input to an appropriate Proto Message object to send as the request. Each API request has a `*Request` and `*Response` Message defined here. If you have any uncertainty about what the API may accept or return, these classes provide the complete/unambiguous answer. They come from the `google-ai-generativelanguage` package which is generated from a snapshot of the API definition. >>> from google.generativeai import protos >>> import inspect >>> print(inspect.getsource(protos.Part)) Proto classes can have "oneof" fields. Use `in` to check which `oneof` field is set. >>> p = protos.Part(text='hello') >>> 'text' in p True >>> p.inline_data = {'mime_type':'image/png', 'data': b'PNG'} >>> type(p.inline_data) is protos.Blob True >>> 'inline_data' in p True >>> 'text' in p False Instances of all Message classes can be converted into JSON compatible dictionaries with the following construct (Bytes are base64 encoded): >>> p_dict = type(p).to_dict(p) >>> p_dict {'inline_data': {'mime_type': 'image/png', 'data': 'UE5H'}} A compatible dict can be converted to an instance of a Message class by passing it as the first argument to the constructor: >>> p = protos.Part(p_dict) inline_data { mime_type: "image/png" data: "PNG" } Note when converting that `to_dict` accepts additional arguments: - `use_integers_for_enums:bool = True`, Set it to `False` to replace enum int values with their string names in the output - ` including_default_value_fields:bool = True`, Set it to `False` to reduce the verbosity of the output. Additional arguments are described in the docstring: >>> help(proto.Part.to_dict) é)Ú*)Ú__all__N)Ú__doc__Ú)google.ai.generativelanguage_v1beta.typesr©rrúi/var/www/html/chefvision.cloud.itp360.com/venv/lib/python3.10/site-packages/google/generativeai/protos.pyÚs;