@;f*<ddlZddlZddlmZddlZGddZy)N)utilscReZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zy )RstCodeGeneratorz3Generates documentation in reStructuredText format.c2||_|jy)N)ifaces_generate_expand_dicts)selfrs %share/glib-2.0/codegen/codegen_rst.py__init__zRstCodeGenerator.__init__s  ##%cg}tj|jdD]}|j}|dk(r|j d*|j D]!}|j ||j|}#|jD]!}|j ||j|}#|r0tjdd|}tjdd|}|j |dj|S)z)Expands parameters and constant literals. z@[a-zA-Z0-9_]*c6d|jdddzdzSNz``rrgroupms r z*RstCodeGenerator._expand..&dQWWQZ^3d:r z%[a-zA-Z0-9_]*c6d|jdddzdzSrrrs r rz*RstCodeGenerator._expand..,rr ) textwrapdedentsplitrstripappend_expand_member_dict_keysreplace_expand_member_dict_expand_iface_dict_keys_expand_iface_dictresubjoin)r sexpandParamsAndConstantsreslinekeys r _expandzRstCodeGenerator._expandsOOA&,,T2 D;;=Drz 244 H||C)A)A#)FG H33 G||C)@)@)EF G'vv$: vv$: JJt - .yy~r c`i|_i|_|jD]<}d|j}d|jd}||j|<|jD]J}|jd|jd}d|jd|jd}||j|<L|j D]J}d|jd|j}d|jd|jd}||j|<L|j D]J}d|jd|j}d|jd|jd}||j|<L?t|jjd |_ t|jjd |_ y ) z9Generates the dictionaries used to expand gtk-doc sigils.#`z`_.z():::T)reverseN) r!r#rnamemethodssignals propertiessortedkeysrr")r ir+valuerr'ps r r z'RstCodeGenerator._generate_expand_dicts2s#% "$ 6AaffX,CxrNE+0D # #C (YY 6#$661662AFF81QVVHB/05((- 6 YY 6#$661662AFF82affXR005((- 6 \\ 6"#&&!&&1AFF81QVVHB/05((- 6 6,)/  $ $ ) ) +T) %(.  # # ( ( *D( $r c|j}t|}d|jddd|z|d|zdddddd|jdd|jj d|j |j ddg}|jr|d |jd dgz }|jr|gd z }|dgz }d j|S) z2Generates the header and preamble of the document... _r2r=z ----------- Descriptionz Description:TzInterface available since: r0) .. warning::rz This interface is deprecated.rrr) name_without_prefixlenr4doc_string_briefstripr, doc_stringsince deprecatedr&)r iface iface_name header_lenr)s r _generate_headerz!RstCodeGenerator._generate_headerSs.. _ 5::,a  *   *      5::,m ,   " " ( ( *  LL))4 0 ! $ ;; -ekk]!< C     C t yy~r ctd|d|dddt|z|dt|zddg}dj|S)z)Generates a section with the given title.r> r2r-r)rCr&)r titler4r)s r _generate_sectionz"RstCodeGenerator._generate_sectionysQ4&% "  #e*   #e*    yy~r cg}|jD]}|jd|j}|jr|jrd}n|jrd}nd}|d|dd|dt |zdddd |jd |d |j dd|j |jd dg z }|jr|d |jd dgz }|jr|gdz }|dgz }dj|S)z!Generates the properties section.r2 readwritewritablereadabler>r^r1 rNTzProperty available since: r0)rArz This property is deprecated.rrr) r7r4rUrTrC signaturer,rFrGrHr&)r rIr)r<rPaccesss r _generate_propertiesz%RstCodeGenerator._generate_propertiess'!!# Azzl!AFF8,Ezzajj$## ugQc%j qvvhaxq 6 Q\\40  Cww0 ;|| B4KCG# Hyy~r cddg}t|j}t|j}|dk(r|dk(r|d|jdgz }n|d|jdgz }t |jD]T\}}||dz k(r&|dk(r!|d|jd |j gz }4|d|jd |j d gz }Vt |jD]O\}}||dz k(r!|d |jd |j gz }/|d |jd |j d gz }Q|d dgz }|dgz }d j |S)z/Generates the method signature as a code block.r1rrrW () (rz IN rN,z OUT  )r)rCin_argsout_argsr4 enumeraterXr&)r methodr) n_in_args n_out_argsidxargs r _generate_method_signaturez+RstCodeGenerator._generate_method_signatures   ' ) >jAo v{{m3' C v{{m2& C&fnn5 S)a-'J!O#CHH:Qs}}o>C#CHH:Qs}}oQ?C  &foo6 S*q.($SXXJa ?C$SXXJa a@C    C t yy~r c g}|jD]+}|jd|j}|d|dd|dt|zd|j|d|j |j ddg z }|j D]4}|j |j d}||jd|dgz }6|jD]4}|j |j d}||jd|dgz }6|dgz }|jr|d|jddgz }|jr|gd z }|dgz }.d j|S) zGenerates the methods section.r0r>r2rrVT zMethod available since: )rArz This method is deprecated.rrr) r5r4rCrhr,rFr`rarGrHr&)r rIr)rrPaarg_descs r _generate_methodsz"RstCodeGenerator._generate_methodss) Azzl!AFF8,E ugQc%j //2 Q\\40  CYY << d;vvh O ZZ << d;vvh O  B4KCww.qwwiq9|| B4KCS) Tyy~r cddg}t|j}|dk(r|d|jdgz }n|d|jdgz }t|jD]O\}}||dz k(r!|d|jd |jgz }/|d|jd |jd gz }Q|d dgz }|dgz }d j |S) zGenerates the signal signature.r1rrrWr\r]rz rNr^r_r)rCargsr4rbrXr&)r signalr)n_argsrfrgs r _generate_signal_signaturez+RstCodeGenerator._generate_signal_signatures   V[[! Q; v{{m3' C v{{m2& C&fkk2 S&1*$  !CMM?;C  !CMM?!<C    C t yy~r c g}|jD]}|jd|j}|d|dd|dt|zd|j|d|j |j ddg z }|j D]4}|j |j d}||jd|dgz }6|dgz }|jr|d|jd dgz }|jr|gd z }|dgz }d j|S) zGenerates the signals section.r1r>r2rrVTrjzSignal available since: r0)rArz This signal is deprecated.rrr) r6r4rCrrr,rFrorGrHr&)r rIr)r'rPrkrls r _generate_signalsz"RstCodeGenerator._generate_signals&sA" Azzl"QVVH-E ugQc%j //2 Q\\40  CVV << d;vvh O  B4KCww.qwwiq9|| B4KCE" Fyy~r c \|jD]}ttjj ||d|j dd5}|j |j|t|jdkDrK|j |jd|j |j |j|t|jdkDrK|j |jd|j |j |j|t|jdkDrK|j |jd|j |j |j|dddy#1swYxYw) z7Generates the reStructuredText file for each interface.rOz.rstwr PropertiesMethodsSignalsN)ropenospathr&r4writerLrCr7rQrZr5rmr6rt)r rstoutdirr:outfiles r generatezRstCodeGenerator.generateNs? =Abggll6cU!AFF84+@A3G =7 d33A67q||$q(MM$"8"8qvv"NOMM$";";A">?qyy>A%MM$"8"8AFF"KLMM$"8"8";<qyy>A%MM$"8"8AFF"KLMM$"8"8";< = = = = =s E F!!F+ N)__name__ __module__ __qualname____doc__r r,r rLrQrZrhrmrrrtrr r rrsB=&8 B$L 'R'R-^>&P =r r)r{r$rrrrrr r rs   L=L=r