§
    _÷#dÓK  ã                   óL  — d Z ddlZddlZddlZddlZddlZddlmZ ddlmZ ddlm	Z	 ddlm
Z
 ddlmZmZmZmZmZ ddlZddlmZmZ dd	lmZ dd
lmZ ddlmZmZ ddlmZ dej        v r!ej        d                              d¦  «        Zng d¢Zd e e	¦  «        z   Z! e
j"        edd¦  «        Z#de$de%fd„Z&de$de$fd„Z'd9dee$         deee$                  de%fd„Z(de$de$deddfd„Z)	 d:de$d e$ded!ee$         ddf
d"„Z*g dfd#e$d$e$d%e$d&ee$         ded'ee$         d(e%d)ee$         d!ee$         ddfd*„Z+	 	 d;d+ee$         dede$d!ee$         ddf
d,„Z,g fde$ded)ee$         de%fd-„Z-de$ded)ee$         de%fd.„Z.d/e$d)ee$         dedeee$ee$         ee$         f         ddf         fd0„Z/d/e$d)ee$         dede%fd1„Z0	 d:d/e$d)ee$         ded!ee$         dee$         f
d2„Z1d#e$d)ee$         de%fd3„Z2dej3        fd4„Z4ej5        d5d…         fd6ee$         de6fd7„Z7e8d8k    r e7¦   «          dS dS )<u¢  Creates reST files corresponding to Python modules for code documentation.

Parses a directory tree looking for Python modules and packages and creates
ReST files appropriately to create code documentation with Sphinx.  It also
creates a modules index (named modules.<suffix>).

This is derived from the "sphinx-autopackage" script, which is:
Copyright 2008 SociÃ©tÃ© des arts technologiques (SAT),
https://sat.qc.ca/
é    N)Úcopy©Úfnmatch)ÚEXTENSION_SUFFIXES)Úpath)ÚAnyÚ	GeneratorÚListÚOptionalÚTuple)Ú__display_version__Úpackage_dir)Ú
EXTENSIONS)Ú__)ÚFileAvoidWriteÚ	ensuredir)ÚReSTRendererÚSPHINX_APIDOC_OPTIONSú,)Úmemberszundoc-memberszshow-inheritance)z.pyz.pyxÚ	templatesÚapidocÚfilenameÚreturnc                 ó„   — t          j        | ¦  «        }t          t          t          d¬¦  «        D ]}|d|z   k    r dS ŒdS )z)Check *filename* is __init__ file or not.T)ÚkeyÚreverseÚ__init__F)r   ÚbasenameÚsortedÚPY_SUFFIXESÚlen)r   r   Úsuffixs      ú3/usr/lib/python3/dist-packages/sphinx/ext/apidoc.pyÚ	is_initpyr%   .   sR   € åŒ}˜XÑ&Ô&€HÝ�­#°tÐ<Ñ<Ô<ð ð ˆØ�z FÑ*Ò*Ð*Ø�4�4ð +ð ˆuó    Úmodnamesc                  óH   — d                      t          d| ¦  «        ¦  «        S )zJoin module names with dots.ú.N)ÚjoinÚfilter)r'   s    r$   Úmodule_joinr,   8   s   € à�8Š8•F˜4 Ñ*Ô*Ñ+Ô+Ð+r&   ÚdirnameÚfilesc                 ól   — |€| €dS |€t          j        | ¦  «        }t          d„ |D ¦   «         ¦  «        S )z+Check given *files* contains __init__ file.NFc              3   ó8   K  — | ]}t          |¦  «        ¯|V — Œd S ©N©r%   ©Ú.0Úfs     r$   ú	<genexpr>z is_packagedir.<locals>.<genexpr>D   s-   è è € Ð0Ð0�Q¥9¨Q¡<¤<Ð0ˆqÐ0Ð0Ð0Ð0Ð0Ð0r&   )ÚosÚlistdirÚany)r-   r.   s     r$   Úis_packagedirr:   =   sA   € à€}˜˜Øˆuà€}Ý”
˜7Ñ#Ô#ˆÝÐ0Ð0˜%Ð0Ñ0Ô0Ñ0Ô0Ð0r&   ÚnameÚtextÚoptsc                 ó   — t          |dd¦  «        }t          j        |j        | ›d|j        ›�¦  «        }|j        r#|st          t          d¦  «        |z  ¦  «         dS |j        s9t          j	        |¦  «        r%|s!t          t          d¦  «        |z  ¦  «         dS dS |st          t          d¦  «        |z  ¦  «         t          |¦  «        5 }|                     |¦  «         ddd¦  «         dS # 1 swxY w Y   dS )z0Write the output file for module/package <name>.ÚquietNr)   zWould create file %s.z!File %s already exists, skipping.zCreating file %s.)Úgetattrr   r*   Údestdirr#   ÚdryrunÚprintr   ÚforceÚisfiler   Úwrite)r;   r<   r=   r?   Úfnamer5   s         r$   Ú
write_filerH   G   s\  € å�D˜' 4Ñ(Ô(€EåŒI�d”l¨t¨t¨t°T´[°[Ð$AÑBÔB€EØ„{ð Øð 	7Ý•"Ð,Ñ-Ô-°Ñ5Ñ6Ô6Ð6ØˆØŒ:ð �$œ+ eÑ,Ô,ð Øð 	CÝ•"Ð8Ñ9Ô9¸EÑAÑBÔBÐBÐBÐBð	Cð 	Cð ð 	3Ý•"Ð(Ñ)Ô)¨EÑ1Ñ2Ô2Ð2Ý˜EÑ"Ô"ð 	 aØ�GŠG�D‰MŒMˆMð	ð 	ð 	ñ 	ô 	ð 	ð 	ð 	ð 	ð 	ð 	ð 	øøøð 	ð 	ð 	ð 	ð 	ð 	s   ÃC3Ã3C7Ã:C7Úpackager   Úuser_template_dirc                 ó  — t          t          ¦  «        }|j        rd|vr|                     d¦  «         t	          | |¦  «        }|j         |||dœ}t          |t          g¦  «                             d|¦  «        }t          |||¦  «         dS )ú.Build the text of the file and write the file.úprivate-members)Úshow_headingsr   ÚqualnameÚautomodule_optionszmodule.rst_tN)
r   ÚOPTIONSÚincludeprivateÚappendr,   Ú
noheadingsr   Útemplate_dirÚrenderrH   )rI   r   r=   rJ   ÚoptionsrO   Úcontextr<   s           r$   Úcreate_module_filerY   Z   s¢   € õ •7‰mŒm€GØÔð *Ð0¸Ð?Ð?Ø�ŠÐ(Ñ)Ô)Ð)å˜7 HÑ-Ô-€Hà!œ_Ð,ØØØ%ð	ð €Gõ Ð*­LÐ9Ñ:Ô:×AÒAÀ.ÐRYÑZÔZ€DÝˆx˜˜tÑ$Ô$Ð$Ð$Ð$r&   ÚrootÚmaster_packageÚsubrootÚpy_filesÚsubsÚis_namespaceÚexcludesc	           
      ó2  ‡ ‡‡‡‡— ˆˆˆˆ ˆfd„|D ¦   «         }	ˆˆˆ fd„|D ¦   «         }
t          t          |
¦  «        ¦  «        }
ˆˆfd„|
D ¦   «         }
t          t          ¦  «        }‰j        rd|vr|                     d¦  «         t          ‰‰¦  «        }||	|
|‰j        ‰j        |‰j	         ‰j
        dœ	}t          |t          g¦  «                             d|¦  «        }t          ||‰¦  «         |
r‰j        r|
D ]}t          d|‰|¦  «         ŒdS dS dS )rL   c                 óz   •— g | ]7}t          t          j        ‰|¦  «        ‰‰¦  «        °&t          ‰‰|¦  «        ‘Œ8S © )Úis_skipped_packager   r*   r,   )r4   Úpkgnamer`   r[   r=   rZ   r\   s     €€€€€r$   ú
<listcomp>z'create_package_file.<locals>.<listcomp>r   sY   ø€ ð Xð Xð XØÝ,­T¬Y°t¸WÑ-EÔ-EÀtÈXÑVÔVðX•;˜~¨w¸Ñ@Ô@ð Xð Xð Xr&   c                 ó¬   •— g | ]P}t          t          j        ‰|¦  «        ‰‰¦  «        °&t          |¦  «        °5|                     d ¦  «        d         ‘ŒQS )r)   r   )Úis_skipped_moduler   r*   r%   Úsplit)r4   Úsubr`   r=   rZ   s     €€€r$   rf   z'create_package_file.<locals>.<listcomp>v   sb   ø€ ð &ð &ð &¨Ý*­4¬9°T¸3Ñ+?Ô+?ÀÀxÑPÔPð&å ‘n”nð&�#—)’)˜C‘.”. Ô#ð &ð &ð &r&   c                 ó2   •— g | ]}t          ‰‰|¦  «        ‘ŒS rc   )r,   )r4   Úmodnamer[   r\   s     €€r$   rf   z'create_package_file.<locals>.<listcomp>z   s5   ø€ ð -ð -ð -Øõ ˜n¨g°wÑ?Ô?ð -ð -ð -r&   rM   )	re   ÚsubpackagesÚ
submodulesr_   ÚmodulefirstÚseparatemodulesrP   rN   Úmaxdepthzpackage.rst_tN)r    Úsetr   rQ   rR   rS   r,   ro   rp   rT   rq   r   rU   rV   rH   rY   )rZ   r[   r\   r]   r=   r^   r_   r`   rJ   rm   rn   rW   re   rX   r<   Ú	submodules   ``` `  `        r$   Úcreate_package_filert   l   sÑ  øøøøø€ ðXð Xð Xð Xð Xð Xð Xð XØ"&ðXñ Xô X€Kð&ð &ð &ð &ð &ð &¨xð &ñ &ô &€Jõ �˜J™œÑ(Ô(€Jð-ð -ð -ð -ð -Ø!+ð-ñ -ô -€Jå•7‰mŒm€GØÔð *Ð0¸Ð?Ð?Ø�ŠÐ(Ñ)Ô)Ð)å˜.¨'Ñ2Ô2€GàØ"Ø Ø$ØÔ'ØÔ/Ø%Ø!œ_Ð,Ø”Mð
ð 
€Gõ Ð*­LÐ9Ñ:Ô:×AÒAÀ/ÐSZÑ[Ô[€DÝˆw˜˜dÑ#Ô#Ð#àð I�dÔ*ð IØ#ð 	Ið 	IˆIÝ˜t Y°Ð6GÑHÔHÐHÐHðIð Ið Ið Ið	Ið 	Ir&   Úmodulesc                 óB  — |                       ¦   «          d}| dd…         D ]2}|                     |dz   ¦  «        r|                      |¦  «         Œ0|}Œ3|j        |j        | dœ}t          |t          g¦  «                             d|¦  «        }t          |||¦  «         dS )zCreate the module's index.Ú Nr)   )Úheaderrq   Údocnamesz	toc.rst_t)	ÚsortÚ
startswithÚremoverx   rq   r   rU   rV   rH   )ru   r=   r;   rJ   Úprev_moduleÚmodulerX   r<   s           r$   Úcreate_modules_toc_filer   ”   s¼   € ð ‡L‚L�N„N€NØ€KØ˜!˜!˜!”*ð !ð !ˆà×Ò˜[¨3Ñ.Ñ/Ô/ð 	!Ø�NŠN˜6Ñ"Ô"Ð"Ð"à ˆKˆKð ”+Ø”MØðð €Gõ
 Ð*­LÐ9Ñ:Ô:×AÒAÀ+ÈwÑWÔW€DÝˆt�T˜4Ñ Ô Ð Ð Ð r&   c                 ó  ‡ ‡— t          j        ‰ ¦  «        sdS t          j        t          j        ‰ d¦  «        ¦  «        }t	          d„ |D ¦   «         ¦  «        }|s	|j        sdS t          ˆ ˆfd„|D ¦   «         ¦  «        rdS dS )ú%Check if we want to skip this module.Fz*.pyc              3   ó8   K  — | ]}t          |¦  «        ¯|V — Œd S r1   r2   r3   s     r$   r6   z%is_skipped_package.<locals>.<genexpr>¯   s-   è è € Ð;Ð; ­i¸©l¬lÐ;˜!Ð;Ð;Ð;Ð;Ð;Ð;r&   Tc              3   ó^   •K  — | ]'}t          t          j        ‰|¦  «        ‰¦  «        V — Œ(d S r1   )Úis_excludedr   r*   )r4   r5   r-   r`   s     €€r$   r6   z%is_skipped_package.<locals>.<genexpr>µ   s9   øè è € Ð
GÐ
G¸A�;•t”y ¨!Ñ,Ô,¨hÑ7Ô7Ð
GÐ
GÐ
GÐ
GÐ
GÐ
Gr&   )r   ÚisdirÚglobr*   r9   Úimplicit_namespacesÚall)r-   r=   r`   r.   Úregular_packages   ` `  r$   rd   rd   ©   s�   øø€ åŒ:�gÑÔð ØˆuåŒI•d”i ¨Ñ0Ô0Ñ1Ô1€EÝÐ;Ð; UÐ;Ñ;Ô;Ñ;Ô;€OØð  4Ô#;ð àˆtõ Ð
GÐ
GÐ
GÐ
GÐ
GÀÐ
GÑ
GÔ
GÑGÔGð àˆtàˆur&   c                 ó’   — t          j        | ¦  «        sdS t          j        | ¦  «                             d¦  «        r	|j        sdS dS )r�   TÚ_F)r   Úexistsr   r{   rR   )r   r=   r`   s      r$   rh   rh   ¼   sM   € åŒ;�xÑ Ô ð àˆtÝ	Œ�xÑ	 Ô	 ×	+Ò	+¨CÑ	0Ô	0ð ¸Ô9Lð àˆtàˆur&   Úrootpathc              #   ó&  ‡‡‡K  — t          |dd¦  «        }t          |dd¦  «        }t          j        | |¬¦  «        D ]R\  Š}}t          ˆˆfd„|D ¦   «         ¦  «        }|rdŠndŠt          ˆˆˆfd„|D ¦   «         ¦  «        |d	d	…<   ‰||fV — ŒSd	S )
z@Walk through the directory and list files and subdirectories up.ÚfollowlinksFrR   )r�   c              3   ó–   •K  — | ]C}|                      t          ¦  «        ¯t          t          j        ‰|¦  «        ‰¦  «        °?|V — ŒDd S r1   )Úendswithr!   r„   r   r*   )r4   r5   r`   rZ   s     €€r$   r6   zwalk.<locals>.<genexpr>Ð   so   øè è € ð Fð F˜QØŸ*š*¥[Ñ1Ô1ðFå&¥t¤y°°qÑ'9Ô'9¸8ÑDÔDðF�qð Fð Fð Fð Fð Fð Fr&   )r)   )r)   r‹   c              3   óŒ   •K  — | ]>}|                      ‰¦  «        °t          t          j        ‰|¦  «        ‰¦  «        °:|V — Œ?d S r1   )r{   r„   r   r*   )r4   rj   Úexclude_prefixesr`   rZ   s     €€€r$   r6   zwalk.<locals>.<genexpr>Û   so   øè è € ð Jð J °C·N²NÐCSÑ4TÔ4Tð JÝ(­¬°4¸Ñ)=Ô)=¸xÑHÔHðJ˜ð Jð Jð Jð Jð Jð Jr&   N)r@   r7   Úwalkr    )	r�   r`   r=   r�   rR   r^   r.   r“   rZ   s	    `     @@r$   r”   r”   È   s"  øøøè è € õ ˜$ ¨uÑ5Ô5€KÝ˜TÐ#3°UÑ;Ô;€NåœW X¸;ÐGÑGÔGð  ð  Ñˆˆd�Eåð Fð Fð Fð Fð F %ð Fñ Fô Fñ Fô Fˆð ð 	*Ø06ÐÐà)Ðåð Jð Jð Jð Jð Jð J¨ð Jñ Jô Jñ Jô JˆˆQˆQˆQ‰ð �D˜%ÐÐÐÐÐð! ð  r&   c                 ó@   — t          | ||¦  «        D ]\  }}}|r dS ŒdS )zACheck the given directory contains child module/s (at least one).TF)r”   )r�   r`   r=   Ú_rootÚ_subsr.   s         r$   Úhas_child_moduler˜   á   s?   € å# H¨h¸Ñ=Ô=ð ð Ñˆˆu�eØð 	Ø�4�4ð	ð ˆ5r&   c                 ó*  — t          |dd¦  «        }t          | ¦  «        s|r&|                      t          j        ¦  «        d         }nd}g }t          | ||¦  «        D �]³\  }}}	t          d|	¦  «        }
|
 o|}|
rH|	dd…         D ]<}t          |¦  «        r+|	                     |¦  «         |	                     d|¦  «         Œ=n|| k    r|s|dd…= Œt|
s|rÆ|s#t          |	¦  «        dk    st          ||¦  «        sŸ|t          | ¦  «        d…                              t          j        ¦  «                             t          j        d¦  «        }|rt          |||¦  «        r:t          ||||	|||||¦	  «	         |                     t!          ||¦  «        ¦  «         �Œ>|| k    r|�J ‚|	D ]h}t#          t          j        | |¦  «        ||¦  «        sB|                     d¦  «        d         }t'          ||||¦  «         |                     |¦  «         Œi�Œµ|S )z`
    Look for every file in the directory tree and create the corresponding
    ReST files.
    r‡   FéÿÿÿÿNr   é   r)   )r@   r:   ri   r   Úsepr”   r%   r|   Úinsertr"   rd   ÚlstripÚreplacer˜   rt   rS   r,   rh   r*   rY   )r�   r`   r=   rJ   r‡   Úroot_packageÚ	toplevelsrZ   r^   r.   Úis_pkgr_   r5   Ú
subpackageÚpy_filer~   s                   r$   Úrecurse_treer¥   ê   sv  € õ " $Ð(=¸uÑEÔEÐõ �XÑÔð Ð"5ð Ø—~’~¥d¤hÑ/Ô/°Ô3ˆˆð ˆà€IÝ! (¨H°dÑ;Ô;ð !-ñ !-Ñˆˆd�EÝ˜t UÑ+Ô+ˆØ!�zÐ9Ð&9ˆØð 		Ø˜1˜1˜1”Xð 'ð '�Ý˜Q‘<”<ð 'Ø—L’L ‘O”O�OØ—L’L  AÑ&Ô&Ð&øð'ð �XÒÐà&ð Ø˜˜˜�GØàð 	-�\ð 	-àð 	L•s˜5‘z”z A’~�~Õ-?ÀÀdÑ-KÔ-K�~Ø!¥# h¡-¤- . .Ô1×8Ò8½¼ÑBÔBß’G�DœH cÑ*Ô*ð ð $ð LÕ'7¸¸hÈÑ'MÔ'Mð LÝ'¨¨l¸JØ(-¨t°T¸<ÈØ(9ñ;ô ;ð ;ð ×$Ò$¥[°¸zÑ%JÔ%JÑKÔKÐKùð ˜8Ò#Ð#¨Ð(<Ð(<Ð(<Ø ð -ð -�Ý(­¬°8¸WÑ)EÔ)EÀtÈXÑVÔVð -Ø$Ÿ]š]¨3Ñ/Ô/°Ô2�FÝ& |°V¸TÐCTÑUÔUÐUØ×$Ò$ VÑ,Ô,Ð,øñ	-ð Ðr&   c                 ó6   — |D ]}t          | |¦  «        r dS ŒdS )zÄCheck if the directory is in the exclude list.

    Note: by having trailing slashes, we avoid common prefix issues, like
          e.g. an exclude "foo" also accidentally excluding "foobar".
    TFr   )rZ   r`   Úexcludes      r$   r„   r„      s6   € ð ð ð ˆÝ�4˜Ñ!Ô!ð 	Ø�4�4ð	àˆ5r&   c                  óü  — t          j        dt          d¦  «        t          d¦  «        ¬¦  «        } |                      ddddt          z  ¬	¦  «         |                      d
t          d¦  «        ¬¦  «         |                      ddt          d¦  «        ¬¦  «         |                      dddddt          d¦  «        ¬¦  «         |                      dddt          d¦  «        ¬¦  «         |                      ddddt
          d t          d!¦  «        ¬"¦  «         |                      d#d$dd%t          d&¦  «        ¬¦  «         |                      d'd(dd)d*t          d+¦  «        ¬,¦  «         |                      d-d.dd/t          d0¦  «        ¬¦  «         |                      d1d2dd3t          d4¦  «        ¬¦  «         |                      d5d6dd7t          d8¦  «        ¬¦  «         |                      d9dd:d;t          d<¦  «        ¬,¦  «         |                      d=d>d?d:t          d@¦  «        ¬¦  «         |                      dAdBddCt          dD¦  «        ¬¦  «         |                      dEdFddGt          dH¦  «        ¬¦  «         |                      dIddJt          dK¦  «        ¬¦  «         |                      dLdMddNdOt          dP¦  «        ¬,¦  «         |                      dQdRddSt          dT¦  «        ¬¦  «         |                      dUdVddWt          dX¦  «        ¬¦  «         |                      dYdZdd[t          d\¦  «        ¬¦  «         |                      d]d^dd_t          d`¦  «        ¬¦  «         |                      dadbddt          dc¦  «        ¬¦  «         |                      dddeddft          dg¦  «        ¬¦  «         |                      t          dh¦  «        ¦  «        }|                     didjdkdlt          dm¦  «        ¬n¦  «         t          D ]2}|                     do|z  dpdq|z  dkt          dr¦  «        |z  ¬s¦  «         Œ3|                      t          dt¦  «        ¦  «        }|                     dudvdwdxt          dy¦  «        ¬z¦  «         | S ){NzH%(prog)s [OPTIONS] -o <OUTPUT_PATH> <MODULE_PATH> [EXCLUDE_PATTERN, ...]z:For more information, visit <https://www.sphinx-doc.org/>.aE  
Look recursively in <MODULE_PATH> for Python modules and packages and create
one reST file with automodule directives per package in the <OUTPUT_PATH>.

The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be
excluded from generation.

Note: By default this script will not overwrite already created files.)ÚusageÚepilogÚdescriptionz	--versionÚversionÚshow_versionz%%(prog)s %s)ÚactionÚdestr¬   Úmodule_pathzpath to module to document)ÚhelpÚexclude_patternÚ*zGfnmatch-style file and/or directory patterns to exclude from generation)Únargsr±   z-oz--output-dirÚstorerA   Tzdirectory to place all output)r®   r¯   Úrequiredr±   z-qÚ
store_truer?   z,no output on stdout, just warnings on stderr)r®   r¯   r±   z-dz
--maxdepthrq   é   z;maximum depth of submodules to show in the TOC (default: 4))r®   r¯   ÚtypeÚdefaultr±   z-fz--forcerD   zoverwrite existing filesz-lz--follow-linksr�   FzNfollow symbolic links. Powerful when combined with collective.recipe.omelette.)r®   r¯   rº   r±   z-nz	--dry-runrB   z%run the script without creating filesz-ez
--separaterp   z1put documentation for each module on its own pagez-Pz	--privaterR   zinclude "_private" modulesz	--tocfileÚtocfileru   z0filename of table of contents (default: modules)z-Tz--no-tocÚstore_falsez%don't create a table of contents filez-Ez--no-headingsrT   zedon't create headings for the module/package packages (e.g. when the docstrings already contain them)z-Mz--module-firstro   z7put module documentation before submodule documentationz--implicit-namespacesr‡   zNinterpret module paths according to PEP-0420 implicit namespaces specificationz-sz--suffixr#   Úrstzfile suffix (default: rst)z-Fz--fullÚfullz.generate a full project with sphinx-quickstartz-az--append-syspathÚappend_syspathz9append module_path to sys.path, used when --full is givenz-Hz--doc-projectrx   z(project name (default: root module name)z-Az--doc-authorÚauthorz,project author(s), used when --full is givenz-Vz--doc-versionz*project version, used when --full is givenz-Rz--doc-releaseÚreleasezEproject release, used when --full is given, defaults to --doc-versionzextension optionsz--extensionsr   Ú
extensionsrS   zenable arbitrary extensions)Úmetavarr¯   r®   r±   z--ext-%sÚappend_constzsphinx.ext.%szenable %s extension)r®   Úconstr¯   r±   zProject templatingz-tz--templatedirÚTEMPLATEDIRÚtemplatedirz%template directory for template files)rÃ   r¯   r±   )ÚargparseÚArgumentParserr   Úadd_argumentr   ÚintÚadd_argument_groupr   )ÚparserÚgroupÚexts      r$   Ú
get_parserrÐ   ,  s*  € ÝÔ$ð'åÐNÑOÔOÝð Jñ Kô Kð	Lñ Lô L€Fð ×Ò˜¨I¸NØ .Õ1DÑ Dð ñ Fô Fð Fð ×Ò˜ÝÐ <Ñ=Ô=ð ñ ?ô ?ð ?à
×ÒÐ)°Ýð !=ñ >ô >ð ñ ?ô ?ð ?ð ×Ò˜˜n°WÀ9Ø!%ÝÐ ?Ñ@Ô@ð ñ Bô Bð Bð ×Ò˜ \¸ÝÐ NÑOÔOð ñ Qô Qð Qà
×Ò˜˜l°7ÀÝ ¨!Ýð !/ñ 0ô 0ð ñ 1ô 1ð 1ð ×Ò˜˜i°À7ÝÐ :Ñ;Ô;ð ñ =ô =ð =à
×Ò˜Ð.°|Ø*°EÝð !Cñ Dô Dð ñ Eô Eð Eð ×Ò˜˜k°,ÀXÝÐ GÑHÔHð ñ Jô Jð Jà
×Ò˜˜l°<Ø.ÝÐ SÑTÔTð ñ Vô Vð Vð ×Ò˜˜k°,Ø-ÝÐ <Ñ=Ô=ð ñ ?ô ?ð ?ð ×Ò˜¨G¸)ÈYÝÐ RÑSÔSð ñ Uô Uð Uà
×Ò˜˜j°ÀYÝÐ GÑHÔHð ñ Jô Jð Jà
×Ò˜˜o°lØ)Ýð !0ñ 1ô 1ð ñ 2ô 2ð 2ð
 ×Ò˜Ð.°|Ø*Ýð !0ñ 1ô 1ð ñ 2ô 2ð 2ð ×ÒÐ/¸Ø2Ýð !Dñ Eô Eð ñ Fô Fð Fð ×Ò˜˜j°¸xØ %ÝÐ <Ñ=Ô=ð ñ ?ô ?ð ?ð ×Ò˜˜h¨|À&ÝÐ PÑQÔQð ñ Sô Sð Sà
×Ò˜Ð0¸Ø-ÝÐ [Ñ\Ô\ð ñ ^ô ^ð ^ð ×Ò˜˜o°gÀHÝÐ JÑKÔKð ñ Mô Mð Mà
×Ò˜˜n°WÀ8ÝÐ NÑOÔOð ñ Qô Qð Qà
×Ò˜˜o°gÀIÝÐ LÑMÔMð ñ Oô Oð Oà
×Ò˜˜o°gÀIÝð !<ñ =ô =ð ñ >ô >ð >ð ×%Ò%¥bÐ)<Ñ&=Ô&=Ñ>Ô>€EØ	×Ò�~¨|À,Ø&­RÐ0MÑ-NÔ-Nð ñ Pô Pð Påð Að AˆØ×Ò˜:¨Ñ+°NØ!0°3Ñ!6¸\Ý "Ð#8Ñ 9Ô 9¸CÑ ?ð 	ñ 	Aô 	Að 	Að 	Að ×%Ò%¥bÐ)=Ñ&>Ô&>Ñ?Ô?€EØ	×Ò�t˜_°mØ)ÝÐFÑGÔGð ñ Iô Ið Ið €Mr&   r›   Úargvc                 óˆ  — t           j                             t          j        d¦  «         t           j                             t
          j                             t          d¦  «        d¦  «         t          ¦   «         }| 
                    | ¦  «        }t          j        |j        ¦  «        }|j        €*|                     t          j        ¦  «        d         |_        |j                             d¦  «        r|j        dd…         |_        t          j        |¦  «        s?t'          t)          d¦  «        |z  t*          j        ¬	¦  «         t+          j        d¦  «         |j        st3          |j        ¦  «         d
„ |j        D ¦   «         }t9          ||||j        ¦  «        }|j        �rxddlm } | !                    ¦   «          d}d}|D ]%}	|	                     |dz   ¦  «        rŒ|	}|d|	z  z  }Œ&i d|j        “dd“dd“d|j        “d|j"        pd“d|j#        pd“d|j$        p|j#        pd“dd|j        z   “dd“dd“dg d¢“dd“d d“d!d“d"|j%        “d#|“d$d%“||j&        d&œ¥}
|j'        r |
d          (                    |j'        ¦  «         |j)        rd|
d'<   |
d         dd…         D ]O}d(|v rI|
d          *                    |¦  «         |
d          (                    |                     d(¦  «        ¦  «         ŒP|j        s#| +                    |
d|j,        |j        ¬)¦  «         n#|j-        rt]          |||j-        |j        ¦  «         dS )*z+Parse and check the command line arguments.rw   ÚlocaleÚsphinxNrš   r)   r›   z%s is not a directory.)Úfilec                 ó6   — g | ]}t          j        |¦  «        ‘ŒS rc   )r   Úabspath)r4   r§   s     r$   rf   zmain.<locals>.<listcomp>¢  s"   € ÐJÐJÐJ¨'•”˜WÑ%Ô%ÐJÐJÐJr&   r   )Ú
quickstartz   %s
r   rœ   FÚdotr‹   ÚprojectrÀ   ÚAuthorr¬   rÁ   r#   ÚmasterÚindexÚepubTrÂ   )zsphinx.ext.autodoczsphinx.ext.viewcodezsphinx.ext.todoÚmakefileÚ	batchfileÚ	make_modeÚmastertocmaxdepthÚmastertoctreeÚlanguageÚen)r°   r¿   r?   r   )ÚsilentÚ	overwriterÇ   )/rÔ   rÓ   Ú	setlocaleÚLC_ALLÚinit_consoler7   r   r*   r   rÐ   Ú
parse_argsr×   r°   rx   ri   rœ   r#   r{   r…   rC   r   ÚsysÚstderrÚexitrB   r   rA   r²   r¥   rÇ   r¾   Ú
sphinx.cmdrØ   rz   rÀ   r¬   rÁ   rq   r¿   rÂ   Úextendr?   r|   ÚgeneraterD   r»   r   )rÑ   rÍ   Úargsr�   r`   ru   Úqsr}   r<   r~   ÚdrÏ   s               r$   Úmainrõ   �  sÓ  € å
„M×Ò�FœM¨2Ñ.Ô.Ð.Ý
„M×Ò�rœwŸ|š|­K¸ÑBÔBÀHÑMÔMÐMå‰\Œ\€FØ×Ò˜TÑ"Ô"€DåŒ|˜DÔ,Ñ-Ô-€Hð „{ÐØ—n’n¥T¤XÑ.Ô.¨rÔ2ˆŒØ„{×Ò˜cÑ"Ô"ð &Ø”k ! " "”oˆŒÝŒ:�hÑÔð Ý�bÐ)Ñ*Ô*¨XÑ5½C¼JÐGÑGÔGÐGÝŒ�‰ŒˆØŒ;ð  Ý�$”,ÑÔÐØJÐJ°TÔ5IÐJÑJÔJ€HÝ˜8 X¨t°TÔ5EÑFÔF€Gà„yñ .OØ/Ð/Ð/Ð/Ð/Ð/Ø�Š‰ŒˆØˆØˆØð 	'ð 	'ˆFØ× Ò  ¨sÑ!2Ñ3Ô3ð ØØ ˆKØ�I Ñ&Ñ&ˆDˆDð
Ø�D”Lð
à�5ð
ð �3ð
ð �t”{ð	
ð
 �d”kÐ- Xð
ð �t”|Ð) rð
ð �t”|Ð9 t¤|Ð9°rð
ð �c˜DœKÑ'ð
ð �gð
ð �Dð
ð ð .ð .ð .ð
ð ˜ð
ð ˜ð
ð ˜ð
ð    ¤ð!
ð" ˜Tð#
ð$ ˜ð%
ð& $Ø"Ô1ð)
ð 
ð 
ˆð, Œ?ð 	4ØˆlŒO×"Ò" 4¤?Ñ3Ô3Ð3ØŒ:ð 	ØˆAˆg‰Jà�\”? 1 1 1Ô%ð 	7ð 	7ˆCØ�cˆzˆzØ�,”×&Ò& sÑ+Ô+Ð+Ø�,”×&Ò& s§y¢y°¡~¤~Ñ6Ô6Ð6øàŒ{ð 	6Ø�KŠK˜ $°$´*Ø$(Ô$4ð ñ 6ô 6ð 6øà	Œð OÝ ¨¨t¬|¸TÔ=MÑNÔNÐNàˆ1r&   Ú__main__)NNr1   )ru   N)9Ú__doc__rÈ   r†   rÓ   r7   rì   r   r   Úimportlib.machineryr   r   Útypingr   r	   r
   r   r   Úsphinx.localerÔ   r   r   Úsphinx.cmd.quickstartr   r   Úsphinx.util.osutilr   r   Úsphinx.util.templater   Úenvironri   rQ   Útupler!   r*   rU   ÚstrÚboolr%   r,   r:   rH   rY   rt   r   rd   rh   r”   r˜   r¥   r„   rÉ   rÐ   rÑ   rË   rõ   Ú__name__rc   r&   r$   ú<module>r     sh  ðð	ð 	ð €€€Ø €€€Ø €€€Ø 	€	€	€	Ø 
€
€
€
Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð Ø 2Ð 2Ð 2Ð 2Ð 2Ð 2Ø Ð Ð Ð Ð Ð Ø 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8à Ð Ð Ð Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,Ø Ð Ð Ð Ð Ð Ø 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ð 8Ø -Ð -Ð -Ð -Ð -Ð -ð ˜bœjÐ(Ð(ØŒjÐ0Ô1×7Ò7¸Ñ<Ô<€G€Gðð ð €Gð   Ð&8Ñ 9Ô 9Ñ9€àˆtŒy˜ k°8Ñ<Ô<€ð˜ð  ð ð ð ð ð,˜3ð , 3ð ,ð ,ð ,ð ,ð
1ð 1˜8 Cœ=ð 1¸ÀÀcÄÔ8Kð 1ÐW[ð 1ð 1ð 1ð 1ð�Sð  ð ¨3ð °4ð ð ð ð ð( ;?ð%ð % ð %¨sð %¸#ð %Ø*2°3¬-ð%ØCGð%ð %ð %ð %ð( /1ÐUYð%Ið %I˜cð %I°3ð %IÀð %IÐPTÐUXÔPYð %IØ!ð%IØ)-¨c¬ð%IØBFð%Ià"& s¤)ð%IàEMÈcÄ]ð%Ið "ð%Ið %Ið %Ið %IðP HQØ?Cð!ð ! T¨#¤Yð !°cð !Àð !Ø/7¸¬}ð!ØHLð!ð !ð !ð !ð* GIð ð  ð ¨3ð ¸$¸s¼)ð ÈTð ð ð ð ð&	 ð 	¨3ð 	¸$¸s¼)ð 	Èð 	ð 	ð 	ð 	ð �3ð   $ s¤)ð  °3ð  Ø˜˜c 4¨¤9¨d°3¬iÐ7Ô8¸$ÀÐDÔEð ð  ð  ð  ð2˜sð ¨d°3¬ið ¸sð Àtð ð ð ð ð 59ð3ð 3˜3ð 3¨$¨s¬)ð 3¸3ð 3Ø$,¨S¤Mð3Ø=AÀ#¼Yð3ð 3ð 3ð 3ðl	�cð 	 T¨#¤Yð 	°4ð 	ð 	ð 	ð 	ð^�HÔ+ð ^ð ^ð ^ð ^ðB œ8 A B Bœ<ð Hð Hˆt�CŒyð H¨Cð Hð Hð Hð HðX ˆzÒÐØ€D�F„F€F€F€Fð Ðr&   