+
    i5                         R t ^ RIt^ RIHt ^ RIHt ^ RIHt  ! R R4      t]! ]P                  ! 4       R7      t	R tR# )	aS  A database of Python protocol buffer generated symbols.

SymbolDatabase is the MessageFactory for messages generated at compile time,
and makes it easy to create new instances of a registered type, given only the
type's protocol buffer symbol name.

Example usage::

  db = symbol_database.SymbolDatabase()

  # Register symbols of interest, from one or multiple files.
  db.RegisterFileDescriptor(my_proto_pb2.DESCRIPTOR)
  db.RegisterMessage(my_proto_pb2.MyMessage)
  db.RegisterEnumDescriptor(my_proto_pb2.MyEnum.DESCRIPTOR)

  # The database can be used as a MessageFactory, to generate types based on
  # their name:
  types = db.GetMessages(['my_proto.proto'])
  my_message_instance = types['MyMessage']()

  # The database's underlying descriptor pool can be queried, so it's not
  # necessary to know a type's filename to be able to generate it:
  filename = db.pool.FindFileContainingSymbol('MyMessage')
  my_message_instance = db.GetMessages([filename])['MyMessage']()

  # This functionality is also provided directly via a convenience method:
  my_message_instance = db.GetSymbol('MyMessage')()
N)api_implementation)descriptor_pool)message_factoryc                   n   a  ] tR t^,t o Rt/ tRR ltR tR tR t	R t
R tR	 tR
 tR tR tR t	RtV tR# )SymbolDatabasez'A database of Python generated symbols.Nc                N    T;'       g    \         P                  ! 4       V n        R# )z!Initializes a new SymbolDatabase.N)r   DescriptorPoolpool)selfr	   s   &&r/Users/igloo/.openclaw/workspace/scratch/fb_ad_env/lib/python3.14/site-packages/google/protobuf/symbol_database.py__init__SymbolDatabase.__init__2   s    88668DI    c                Z    \         P                  ! R 4       \        P                  ! V4      # )zSymbolDatabase.GetPrototype() is deprecated. Please use message_factory.GetMessageClass() instead. SymbolDatabase.GetPrototype() will be removed soon.)warningswarnr   GetMessageClassr
   
descriptors   &&r   GetPrototypeSymbolDatabase.GetPrototype6   s(    MM H I **:66r   c                Z    \         P                  ! R 4       \        P                  ! V4      # )zDirectly call CreatePrototype() is wrong. Please use message_factory.GetMessageClass() instead. SymbolDatabase.CreatePrototype() will be removed soon.)r   r   r   _InternalCreateMessageClassr   s   &&r   CreatePrototypeSymbolDatabase.CreatePrototype<   s(    MM K L 66zBBr   c                n    \         P                  ! R 4       \        P                  ! WP                  4      # )zSymbolDatabase.GetMessages() is deprecated. Please use message_factory.GetMessageClassedForFiles() instead. SymbolDatabase.GetMessages() will be removed soon.)r   r   r   GetMessageClassedForFilesr	   )r
   filess   &&r   GetMessagesSymbolDatabase.GetMessagesB   s,    MM G H 44UIIFFr   c                \    VP                   pWP                  V&   V P                  V4       V# )a$  Registers the given message type in the local database.

Calls to GetSymbol() and GetMessages() will return messages registered here.

Args:
  message: A :class:`google.protobuf.message.Message` subclass (or
    instance); its descriptor will be registered.

Returns:
  The provided message.
)
DESCRIPTOR_classesRegisterMessageDescriptor)r
   messagedescs   && r   RegisterMessageSymbolDatabase.RegisterMessageH   s.     D!MM$""4(Nr   c                t    \         P                  ! 4       R8X  d   V P                  P                  V4       R# R# )zRegisters the given message descriptor in the local database.

Args:
  message_descriptor (Descriptor): the message descriptor to add.
pythonN)r   Typer	   _AddDescriptor)r
   message_descriptors   &&r   r#   (SymbolDatabase.RegisterMessageDescriptorZ   s-      H,
ii12 -r   c                p    \         P                  ! 4       R8X  d   V P                  P                  V4       V# )zRegisters the given enum descriptor in the local database.

Args:
  enum_descriptor (EnumDescriptor): The enum descriptor to register.

Returns:
  EnumDescriptor: The provided descriptor.
r)   )r   r*   r	   _AddEnumDescriptor)r
   enum_descriptors   &&r   RegisterEnumDescriptor%SymbolDatabase.RegisterEnumDescriptord   s-      H,
ii""?3r   c                t    \         P                  ! 4       R8X  d   V P                  P                  V4       R# R# )zRegisters the given service descriptor in the local database.

Args:
  service_descriptor (ServiceDescriptor): the service descriptor to
    register.
r)   N)r   r*   r	   _AddServiceDescriptor)r
   service_descriptors   &&r   RegisterServiceDescriptor(SymbolDatabase.RegisterServiceDescriptorr   s-      H,
ii%%&89 -r   c                t    \         P                  ! 4       R8X  d   V P                  P                  V4       R# R# )zRegisters the given file descriptor in the local database.

Args:
  file_descriptor (FileDescriptor): The file descriptor to register.
r)   N)r   r*   r	   _InternalAddFileDescriptor)r
   file_descriptors   &&r   RegisterFileDescriptor%SymbolDatabase.RegisterFileDescriptor}   s,      H,
ii**?; -r   c                Z    V P                   V P                  P                  V4      ,          # )aS  Tries to find a symbol in the local database.

Currently, this method only returns message.Message instances, however, if
may be extended in future to support other symbol types.

Args:
  symbol (str): a protocol buffer symbol.

Returns:
  A Python class corresponding to the symbol.

Raises:
  KeyError: if the symbol could not be found.
)r"   r	   FindMessageTypeByName)r
   symbols   &&r   	GetSymbolSymbolDatabase.GetSymbol   s"      ==88@AAr   c                $  a V3R lo/ pV Fn  pV P                   P                  V4      pVP                  P                  4        F2  pS! V4       F#  p V P                  V,          W&P
                  &   K%  	  K4  	  Kp  	  V#   \         d     K?  i ; i)a  Gets all registered messages from a specified file.

Only messages already created and registered will be returned; (this is the
case for imported _pb2 modules)
But unlike MessageFactory, this version also returns already defined nested
messages, but does not register any message extensions.

Args:
  files (list[str]): The file names to extract messages from.

Returns:
  A dictionary mapping proto names to the message classes.

Raises:
  KeyError: if a file could not be found.
c              3  d   <"   V x  V P                    F  pS! V4       F  pVx  K	  	  K  	  R# 5i)zCWalk a message Descriptor and recursively yields all message names.N)nested_types)r%   msg_descnested_desc_GetAllMessagess   &  r   rG   3SymbolDatabase.GetMessages.<locals>._GetAllMessages   s0     j''(*84K
 5 (s   -0)r	   FindFileByNamemessage_types_by_namevaluesr"   	full_nameKeyError)r
   r   result	file_name	file_descrE   r%   rG   s   &&     @r   r   r      s    & F	))**95i55<<>(#H-D%)]]4%8F>>" . ?  M  s   B  B	B	r	   )N)__name__
__module____qualname____firstlineno____doc__r"   r   r   r   r   r&   r#   r1   r6   r;   r@   __static_attributes____classdictcell__)__classdict__s   @r   r   r   ,   sN     / (97CG$3	:<B$$ $r   r   rQ   c                     \         # )z#Returns the default SymbolDatabase.)_DEFAULT r   r   Defaultr]      s    	/r   )
rV   r   google.protobuf.internalr   google.protobufr   r   r   r]   r[   r\   r   r   <module>r`      s?   :  7 + +Q Qh 6689r   