File: //usr/lib/python3/dist-packages/gi/__pycache__/docstring.cpython-311.pyc
�
��b] � �� � d dl mZmZmZmZmZmZmZ dad� Z d� Z
d� Z i ej e
�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e�ej e �ej e!�ej" e!�ej# e!ej$ dej% dej& dej' di�Z(d� Z)d� Z*d� Z+d � Z, e e,� � dS )
� )� VFuncInfo� FunctionInfo� CallableInfo�
ObjectInfo�
StructInfo� Direction�TypeTagNc �
� | a dS )z�Set doc string generator function
:param callable func:
Callable which takes a GIInfoStruct and returns documentation for it.
N��_generate_doc_string_func)�funcs �./usr/lib/python3/dist-packages/gi/docstring.py�set_doc_string_generatorr % s � � !%� � � � c � � t S )z6Returns the currently registered doc string generator.r � r r �get_doc_string_generatorr / s � � $�$r c � � t | � � S )aE Generate a doc string given a GIInfoStruct.
:param gi.types.BaseInfo info:
GI info instance to generate documentation for.
:returns:
Generated documentation as a string.
:rtype: str
This passes the info struct to the currently registered doc string
generator and returns the result.
r ��infos r �generate_doc_stringr 4 s � � %�T� *� *�*r c � � | � � � }t � |d � � }|rt |d� � r|j S |t
j k rW| � � � }|� � � }|s| � � � S |�
� � �d|��S | � � � S )N�__name__�.) �get_tag�_type_tag_to_py_type�get�hasattrr r � INTERFACE�
get_interface�get_name�get_tag_as_string�
get_namespace)�gi_type�type_tag�py_type�iface� info_names r �_get_pytype_hintr) \ s� � ���� � �H�"�&�&�x��6�6�G�� <�7�7�J�/�/� <�� � � �W�&� &� &��%�%�'�'���N�N�$�$� �� /��,�,�.�.� .� �-�-�/�/�/�/���;�;� � $� $� &� &�&r c �, � g }t | t � � rdg}n,t | t � � r| � � � rdg}| � � � }d}t � � }t � � }|D ]�}|� |� � � � � |� |� � � � � � � � |� |�
� � � � ��t |� � D ]�\ }}|� � � t j k r�(||v r�-|� � � }t! |� � � � � } | |vr|d| z z
}|� � � s||v r|dz
}n|� � � r|dz
}|� |� � ��d� |� � }
g } t! | � � � � � } | � � � s6| r4| |vr0| }| � � � r|dz
}| � |� � t |� � D ]�\ }}|� � � t j k r�(||v r�-|� � � }t! |� � � � � } | |vr|d| z z
}| � |� � ��| r"| j �d|
�d d� | � � ��S | j �d|
�d
�S ) N�self)�void�:z=Nonez =<optional>z, z or None�(z) -> �))�
isinstancer r � is_method�
get_arguments�set�add� get_destroy�get_type�get_array_length� get_closure� enumerate�
get_directionr �OUTr! r) � may_be_null� is_optional�append�join�get_return_type� skip_return�may_return_null�INr )
r � in_args_strs�args�hint_blacklist�ignore_indices�user_data_indices�arg�i�argstr�hint� in_args_str�
out_args_strs� return_hints
r �_generate_callable_info_docrP n s/ � ��L��$� �"�"� $� �x� � � �D�,� '� '� $� �>�>� � � $� "�8�L� � � � � �D� �N� �U�U�N������ 1� 1�����3�?�?�,�,�-�-�-����3�<�<�>�>�:�:�<�<�=�=�=�� � �c�o�o� /� /�0�0�0�0� �D�/�/� $� $���3� � � � � �)�-� /� /� � �� � � �� � � � �� �� � ���/�/�� �~� %� %� �c�D�j� �F� �?�?� � � $��%6� 6� 6� �g� �F�F�
�_�_�
�
� $� �m� #�F����F�#�#�#�#��)�)�L�)�)�K� �M�"�4�#7�#7�#9�#9�:�:�K� � � � � � %�+� %�+�^�2S�2S� �� � � � !� !� !� �j� �F�� � �V�$�$�$��D�/�/� %� %���3� � � � � �)�,� .� .� � �� � � �� � � � �� �� � ���/�/�� �~� %� %� �c�D�j� �F�� � �V�$�$�$�$�� 7�!%� � � � � � �T�Y�Y�}�=U�=U�=U�V�V� �=�=�=�+�+�+�6�6r c �r � d}d}t | t � � r6| � � � dk r |d| � � � z dz z
}n |d| � � � z dz z
}| � � � D ].}|� � � r|dt
|� � z dz z
}�/|r||z S dS )Nz
:Constructors:
::
� � z z()
z(**properties)
�
)r0 r �get_sizer! � get_methods�is_constructorrP )r �header�doc� method_infos r �_generate_class_info_docr[ � s� � �
)�F�
�C��$�
�#�#� =� �=�=�?�?�Q� � � �6�D�M�M�O�O�+�f�4� 4�C�� �v��
�
���'�*<�<�<���'�'�)�)� L� L� � � %� %� '� '� L� �6� 7� � D� D�D�t�K� K�C��
� ���|���rr c � � t | t t f� � rt | � � S t | t � � rt | � � S dS )NrR )r0 r r r[ r rP r s r �_generate_doc_dispatchr] � sL � ��$��Z�0�1�1� 1�'��-�-�-� �D�,� '� '� 1�*�4�0�0�0�
�2r )-�_gir r r r r r r r r r r �BOOLEAN�bool�INT8�int�UINT8�INT16�UINT16�INT32�UINT32�INT64�UINT64�FLOAT�float�DOUBLE�GLIST�list�GSLIST�ARRAY�GHASH�dict�UTF8�str�FILENAME�UNICHARr �GTYPE�ERROR�VOIDr r) rP r[ r] r r r �<module>rz s ��. � � � � � � � � � � � � � � � � � � !� �%� %� %�%� %� %�
+� +� +� ���� � � �c�� �
�s�� �
�s�� ��� �
�
�s� � ���
� �
�s�� ���� �
�u�� ���� �
�t�� ���� �
�t�� �
�t� � � �c� � �(�#�!�" ��� �)�4� �
�t� �
�t� � �d�+� � �2'� '� '�$=7� =7� =7�@� � �*� � � � �/� 0� 0� 0� 0� 0r