pc(<ddlZddlZddlmZGddZdS)N)utilscTeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd S)RstCodeGeneratorz3Generates documentation in reStructuredText format.c<||_|dS)N)ifaces_generate_expand_dicts)selfrs */usr/share/glib-2.0/codegen/codegen_rst.py__init__zRstCodeGenerator.__init__s!  ##%%%%%cg}|dD]}|}|dkr|d2|jD]#}|||j|}$|jD]#}|||j|}$|r.tj dd|}tj dd|}||d |S)z)Expands parameters and constant literals. z@[a-zA-Z0-9_]*cHd|dddzdzSNz``rrgroupms r z*RstCodeGenerator._expand..%"dQWWQZZ^3d:r z%[a-zA-Z0-9_]*cHd|dddzdzSrrrs r rz*RstCodeGenerator._expand..+rr ) splitstripappend_expand_member_dict_keysreplace_expand_member_dict_expand_iface_dict_keys_expand_iface_dictresubjoin)r sexpandParamsAndConstantsreslinekeys r _expandzRstCodeGenerator._expandsGGDMM  D::<rz This property is deprecated.rrr) r5r2rOrNr? signaturer*rArBrCr$)r rDr'r:rJaccesss r _generate_propertiesz%RstCodeGenerator._generate_propertiess6!! ! Az,,AF,,Ez $aj $$ $## c%jj 6qv666666 Q\400  Cw ;;;;|  B4KCCyy~~r cDddg}t|j}t|j}|dkr|dkr|d|jdgz }n|d|jdgz }t |jD]B\}}||dz kr|dkr|d|jd |jgz }+|d|jd |jd gz }Ct |jD]<\}}||dz kr|d |jd |jgz }%|d |jd |jd gz }=|d dgz }|dgz }d |S)z/Generates the method signature as a code block.r/rrrQ () (rz IN rI,z OUT  )r)r?in_argsout_argsr2 enumeraterRr$)r methodr' n_in_args n_out_argsidxargs r _generate_method_signaturez+RstCodeGenerator._generate_method_signatures   '' )) >>jAoo 'v{''' CC &v{&&& C&fn55  S)a-''J!OO>CH>>s}>>CC?CH??s}???CC&fo66  S*q.((?SX?? ??CC@SX@@ @@@CC  C t yy~~r c g}|jD]}|jd|j}||dt|zd||d||jddgz }|jD].}||jd}||jd|dgz }/|dgz }|jr|d|jddgz }|jr|gdz }|dgz }d |S) zGenerates the methods section.r.rPrT zMethod available since: )r>rz This method is deprecated.rrr) r3r2r?rbr*rArZrBrCr$)r rDr'rrJaarg_descs r _generate_methodsz"RstCodeGenerator._generate_methodssE  Az,,AF,,E c%jj //22 Q\400 CY  << d;;vK#OO B4KCw 9qw999|  B4KCCyy~~r cbddg}t|j}|dkr|d|jdgz }ng|d|jdgz }t|jD]<\}}||dz kr|d|jd |jgz }%|d|jd |jd gz }=|d dgz }|dgz }d |S) zGenerates the signal signature.r/rrrQrVrWrz rIrXrYr)r?argsr2r\rRr$)r signalr'n_argsr`ras r _generate_signal_signaturez+RstCodeGenerator._generate_signal_signatures$   V[!! Q;; 'v{''' CC &v{&&& C&fk22  S&1*$$;;;CM;;CC<<rz This signal is deprecated.rrr) r4r2r?rlr*rArirBrCr$)r rDr'r%rJrerfs r _generate_signalsz"RstCodeGenerator._generate_signalssE  Az--QV--E c%jj //22 Q\400 CV  << d;;vK#OO B4KCw 9qw999|  B4KCCyy~~r c |jD]}ttj||d|jdd5}|||t|j dkrV|| d|j|| |t|j dkrV|| d|j|| |t|jdkrV|| d|j|||dddn #1swxYwYdS) z7Generates the reStructuredText file for each interface.rHz.rstwr PropertiesMethodsSignalsN)ropenospathr$r2writerFr?r5rKrTr3rgr4rn)r rstoutdirr8outfiles r generatezRstCodeGenerator.generate?s = =Abgll6c+@+@AF+@+@+@AA3GG =7 d33A66777q|$$q((MM$"8"8qv"N"NOOOMM$";";A">">???qy>>A%%MM$"8"8AF"K"KLLLMM$"8"8";";<<<qy>>A%%MM$"8"8AF"K"KLLLMM$"8"8";";<<< = = = = = = = = = = = = = = = = =sE3GG G N)__name__ __module__ __qualname____doc__r r*r rFrKrTrbrgrlrnr{r r rrs==&&&8   B###J   %%%N'''R$$$L>$$$L = = = = =r r)rur"rrrrr r rsg   ~=~=~=~=~=~=~=~=~=~=r