3
<_ , @ s d dl mZmZmZmZmZmZmZ dadd Z dd Z
dd Z ej e
ejeejeejeejeejeejeejeejeejeejeejeej eej eej e ej e!ej"e!ej#e!ej$dej%dej&dej'diZ(d d
Z)d d Z*d
d Z+dd Z,e e, dS ) ) VFuncInfo FunctionInfo CallableInfo
ObjectInfo
StructInfo DirectionTypeTagNc C s | a dS )zSet 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/lib64/python3.6/docstring.pyset_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 | j }tj|d }|r(t|dr(|jS |tjkr^| j }|j }|sN| j S d|j
|f S | j S )N__name__z%s.%s) Zget_tag_type_tag_to_py_typegethasattrr r INTERFACEZ
get_interfaceget_nameZget_tag_as_stringZ
get_namespace)Zgi_typeZtype_tagZpy_typeZifaceZ info_namer r r _get_pytype_hint\ s
r c
C s g }t | trdg}nt | tr.| j r.dg}| j }d
}t }t }x:|D ]2}|j|j |j|j j |j|j
qLW xt |D ]\}}|j t
jkrq||krq|j }t|j } | |kr|d| 7 }|j s||kr|d7 }n|j r|d7 }|j| qW dj|}
g } t| j } | j rf| rf| |krf| }| j r\|d7 }| j| xlt |D ]`\}}|j t
jkrqp||krqp|j }t|j } | |kr|d| 7 }| j| qpW | rd| j|
dj| f S d | j|
f S d S ) Nselfvoid:z=Nonez =z, z or Nonez %s(%s) -> %sz%s(%s))r )
isinstancer r Z is_methodZ
get_argumentssetaddZ get_destroyZget_typeZget_array_lengthZ get_closure enumerateZ
get_directionr ZOUTr r Z may_be_nullZ is_optionalappendjoinZget_return_typeZ skip_returnZmay_return_nullINr )
r Z in_args_strsargsZhint_blacklistZignore_indicesZuser_data_indicesargiZargstrZhintZ in_args_strZ
out_args_strsZ return_hintr r r _generate_callable_info_docn sb
r% c C s d}d}t | tr4| j dkrH|d| j d 7 }n|d| j d 7 }x,| j D ] }|j rR|dt| d 7 }qRW |r|| S dS d S )Nz
:Constructors:
::
z z()
z(**properties)
)r r Zget_sizer Z get_methodsZis_constructorr% )r headerdocZ method_infor r r _generate_class_info_doc s
r+ c C s, t | ttfrt| S t | tr(t| 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 ZBOOLEANboolZINT8intZUINT8ZINT16ZUINT16ZINT32ZUINT32ZINT64ZUINT64ZFLOATfloatZDOUBLEZGLISTlistZGSLISTZARRAYZGHASHdictZUTF8strZFILENAMEZUNICHARr ZGTYPEZERRORZVOIDr r r% r+ r, r r r r s> $
@