a
��b] � , @ s� d dl mZmZmZmZmZmZmZ dadd� Z dd� Z
dd� Zeje
ejeejeejeejeejeejeejeejeejeejeejeejeejeejeej e!ej"e!ej#e!ej$dej%dej&dej'diZ(d d
� Z)dd� Z*d
d� Z+dd� Z,e e,� dS )� )� VFuncInfo�FunctionInfo�CallableInfo�
ObjectInfo�
StructInfo� Direction�TypeTagNc C s | 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)�func� r �2/usr/lib64/python3.9/site-packages/gi/docstring.py�set_doc_string_generator% s r c C s t S )z6Returns the currently registered doc string generator.r r r r r
�get_doc_string_generator/ s r c C s 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 ��infor r r
�generate_doc_string4 s r c C sf | � � }t�|d �}|r(t|d�r(|jS |tjkr^| �� }|�� }|sN| � � S d|�
� |f S | � � S )N�__name__z%s.%s)Zget_tag�_type_tag_to_py_type�get�hasattrr r � INTERFACEZ
get_interface�get_nameZget_tag_as_stringZ
get_namespace)Zgi_typeZtype_tagZpy_typeZifaceZ info_namer r r
�_get_pytype_hint\ s
r c
C s� g }t | t�rdg}nt | t�r.| �� r.dg}| �� }d}t� }t� }|D ]2}|�|�� � |�|�� � � � |�|�
� � qJt|�D ]~\}}|�� t
jkr�q�||v r�q�|�� }t|�� �} | |vr�|d| 7 }|�� s�||v r�|d7 }n|�� r�|d7 }|�|� q�d�|�}
g }t| �� �}| �� �sZ|�rZ||v�rZ|}| �� �rP|d7 }|�|� t|�D ]`\}}|�� t
jk�r~�qb||v �r��qb|�� }t|�� �} | |v�r�|d| 7 }|�|� �qb|�r�d| j|
d�|�f S d | j|
f S d S )
N�self)Zvoid�:z=Nonez=<optional>z, z or Nonez%s(%s) -> %sz%s(%s))�
isinstancer r Z is_methodZ
get_arguments�set�addZget_destroyZget_typeZget_array_lengthZget_closure� enumerateZ
get_directionr ZOUTr r Zmay_be_nullZis_optional�append�joinZget_return_typeZskip_returnZmay_return_null�INr )
r Zin_args_strs�argsZhint_blacklistZignore_indicesZuser_data_indices�arg�iZargstr�hintZin_args_strZ
out_args_strsZreturn_hintr r r
�_generate_callable_info_docn sb
r'