@;fc&<ddlZddlZddlmZddlZGddZy)N)utilscReZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zy )MdCodeGeneratorz+Generates documentation in Markdown format.c2||_|jy)N)ifaces_generate_expand_dicts)selfrs $share/glib-2.0/codegen/codegen_md.py__init__zMdCodeGenerator.__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|jdddzdzSN`rrgroupms r z)MdCodeGenerator._expand..'cAGGAJqrN2S8r z%[a-zA-Z0-9_]*c6d|jdddzdzSrrrs r rz)MdCodeGenerator._expand..-rr ) textwrapdedentsplitrstripappend_expand_member_dict_keysreplace_expand_member_dict_expand_iface_dict_keys_expand_iface_dictresubjoin)r sexpandParamsAndConstantsreslinekeys r _expandzMdCodeGenerator._expandsOOA&,,T2 D;;=Drz 244 H||C)A)A#)FG H33 G||C)@)@)EF G'vv$8 vv$8 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.#rz`_.z():::T)reverseN) r"r$rnamemethodssignals propertiessortedkeysr r#)r ir,valuerr(ps r r z&MdCodeGenerator._generate_expand_dicts3s#% "$ 6AaffX,CxrNE+0D # #C (YY 6#$661662AFF81QVVHB/05((- 6 YY 6#$661662AFF82affXR005((- 6 \\ 6"#&&!&&1AFF81QVVHB/05((- 6 6,)/  $ $ ) ) +T) %(.  # # ( ( *D( $r c t|j}d|jdd|jdd|jzddd|jj d|j |j ddg }|jr|d|jd dgz }|jr|d dgz }|dgz }d j|S) z2Generates the header and preamble of the document.zTitle: z D-Bus InterfacezSlug: rz# z## DescriptionTzInterface available since: r0z(*Warning*: This interface is deprecated.r) lenr4name_without_prefixdoc_string_briefstripr- doc_stringsince deprecatedr')r iface header_lenr*s r _generate_headerz MdCodeGenerator._generate_headerTs_ ejj\!1 2UZZL !  5,, ,     " " ( ( *  LL))4 0    ;; -ekk]!< C    : C t yy~r c2d|zdg}dj|S)z)Generates a section with the given title.### rr)r')r titler4r*s r _generate_sectionz!MdCodeGenerator._generate_sectionqs% UN  yy~r c g}|jD]}|jd|j}|jr|jrd}n|jrd}nd}|d|zddd|jd |d |jdd|j |j d dgz }|jr|d |jd dgz }|jr|d dgz }|dgz }dj|S)z!Generates the properties section.r2 readwritewritablereadablerIr```  TzProperty available since: r0z'*Warning*: This property is deprecated.r) r7r4rOrN signaturer-rBrCrDr')r rEr*r<rJaccesss r _generate_propertiesz$MdCodeGenerator._generate_propertiesys!! Azzl!AFF8,Ezzajj$## qvvhaxq 6 Q\\40  Cww0 ;||= B4KC9 :yy~r cdg}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 gz }|dgz }d j |S) z/Generates the method signature as a code block.rPrrQ () (rz IN rR,z OUT  )r)r>in_argsout_argsr4 enumeraterSr')r methodr* n_in_args n_out_argsidxargs r _generate_method_signaturez*MdCodeGenerator._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 wyy~r c g}|jD]}|jd|j}|d|zd|j|d|j|jddgz }|j D]5}|j|jd}|d|jd|dgz }7|dgz }|j r|d|j ddgz }|jr|ddgz }|dgz }d j|S) zGenerates the methods section.r0rIrTz* z: zMethod available since: z%*Warning*: This method is deprecated.r) r5r4rcr-rBr[rCrDr')r rEr*rrJaarg_descs r _generate_methodsz!MdCodeGenerator._generate_methodss1 Azzl!AFF8,E //2 Q\\40  CYY << d;8*-  B4KCww.qwwiq9||; B4KC7 8yy~r cdg}t|j}|dk(r|d|jdgz }n|d|jdgz }t|jD]O\}}||dz k(r!|d|jd|jgz }/|d|jd|jd gz }Q|d gz }|dgz }d j |S) zGenerates the signal signature.rPrrQrWrXrz rRrYrZr)r>argsr4r]rSr')r signalr*n_argsrarbs r _generate_signal_signaturez*MdCodeGenerator._generate_signal_signatures  V[[! Q; v{{m3' C v{{m2& C&fkk2 S&1*$  !CMM?;C  !CMM?!<C    C wyy~r c g}|jD]}|jd|j}|d|zd|j|d|j|jddgz }|j D]4}|j|jd}||jd|dgz }6|dgz }|j r|d|j ddgz }|jr|ddgz }|dgz }d j|S) zGenerates the signals section.r1rIrTz zSignal available since: r0z%*Warning*: This signal is deprecated.r) r6r4rlr-rBrirCrDr')r rEr*r(rJrerfs r _generate_signalsz!MdCodeGenerator._generate_signalss/ Azzl"QVVH-E //2 Q\\40  CVV << d;vvh O  B4KCww.qwwiq9||; B4KC9 :yy~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) z/Generates the Markdown file for each interface.-z.mdwr PropertiesMethodsSignalsN)ropenospathr'r4writerGr>r7rKrUr5rgr6rn)r mdoutdirr:outfiles r generatezMdCodeGenerator.generate"s? =Abggll6bT166(#+>?E = 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 rGrKrUrcrgrlrnr|r r rrsA5&8 B: D%NB: D =r r)rvr%rrrrrr r rs   _=_=r