File: //lib/python3/dist-packages/gi/__pycache__/docstring.cpython-310.pyc
o
��b] � @ s d dl mZmZmZmZmZmZmZ dadd� Z dd� Z
dd� Z i ej e
�eje�eje�eje�eje�eje�eje�eje�eje�eje�eje�eje�ej e�ej e�ej e �ej e!�ej"e!�ej#e!ej$dej%dej&dej'di�Z(d d
� Z)d d � 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 �./usr/lib/python3/dist-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 �}|rt|d�r|jS |tjkr/| �� }|�� }|s'| � � 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�r dg}n t | t�r| �� rdg}| �� }d}t� }t� }|D ]}|�|�� � |�|�� � � � |�|�
� � q%t |�D ]?\}}|� � t
jkrOqC||v rTqC|�� }t|�� �} | |vrh|d| 7 }|�� sp||v ru|d7 }n|�� r}|d7 }|�|� qCd�|�}
g } t| �� �} | �� s�| r�| |vr�| }| �� r�|d7 }| �|� t |�D ]*\}}|� � t
jkr�q�||v r�q�|�� }t|�� �} | |vr�|d| 7 }| �|� q�| r�d| j|
d�| �f S d | j|
f S )
N�self)Zvoid�:z=Nonez =<optional>z, z or Nonez %s(%s) -> %sz%s(%s))�
isinstancer r Z is_methodZ
get_arguments�set�addZ get_destroyZget_typeZget_array_lengthZ get_closure� enumerateZ
get_directionr ZOUTr r Z may_be_nullZ is_optional�append�joinZget_return_typeZ skip_returnZmay_return_null�INr )
r Z in_args_strs�argsZhint_blacklistZignore_indicesZuser_data_indices�arg�iZargstrZhintZ in_args_strZ
out_args_strsZ return_hintr r r
�_generate_callable_info_docn sb
r& c C s� d}d}t | t�r| �� dkr|d| �� d 7 }n
|d| �� d 7 }| �� D ]}|�� r8|dt|� d 7 }q(|r?|| S dS )Nz
:Constructors:
::
� � z z()
z(**properties)
�
)r r Zget_sizer Z get_methodsZis_constructorr& )r �header�docZ method_infor r r
�_generate_class_info_doc� s
� �r, c C s, t | ttf�r t| �S t | t�rt| �S dS )Nr' )r r r r, r r& r r r r
�_generate_doc_dispatch� s
r- )-Z_gir r r r r r r r
r r r ZBOOLEAN�boolZINT8�intZUINT8ZINT16ZUINT16ZINT32ZUINT32ZINT64ZUINT64ZFLOAT�floatZDOUBLEZGLIST�listZGSLISTZARRAYZGHASH�dictZUTF8�strZFILENAMEZUNICHARr ZGTYPEZERRORZVOIDr r r& r, r- r r r r
�<module> sb $
�������� �
� � �
�����@