§
    _÷#dÐ]  ã                   óö  — 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
mZmZmZmZmZmZ 	 ddlZe
rej        dk    re‚dZej         rdej         v r ej        d	¦  «         dZn ej        d
¦  «         dZn# e$ r dZdZY nw xY wddlmZ ddlZddlmZmZ ddlmZ ddlmZm Z m!Z!m"Z"m#Z# ddl$m%Z% ddl&m'Z'  ed ed¦  «        fd ed¦  «        fd ed¦  «        fd ed¦  «        fd ed¦  «        fd ed¦  «        fd ed¦  «        fd  ed!¦  «        fd" ed#¦  «        fd$ ed%¦  «        fg
¦  «        Z(d&dd'dd(d)ddd*œZ)d+Z*ej        dk    rd,Z+nd-Z+d.e,d/e,fd0„Z- G d1„ d2e.¦  «        Z/d3e,d/e,fd4„Z0d3e,d/e,fd5„Z1d3e,d/e,fd6„Z2d3e,d/e,fd7„Z3d8e,d/ee,ge,f         fd9„Z4d3e,d/e5fd:„Z6d3e,d/e,fd;„Z7d3e,d/e,fd<„Z8de3fd=e,d>ee,         d?ee,gef         d/ee,e5f         fd@„Z9 G dA„ dBe'¦  «        Z:dCee,ef         d/dfdD„Z;	 dOdCedEe5dFe5dGee,         d/df
dH„Z<dCed/e5fdI„Z=d/ej>        fdJ„Z?ej@        dKd…         fdLee,         d/eAfdM„ZBeCdNk    r( ejD         eBej@        dKd…         ¦  «        ¦  «         dS dS )Pz7Quickly setup documentation source to work with Sphinx.é    N)ÚOrderedDict)Úpath)ÚTYPE_CHECKINGÚAnyÚCallableÚDictÚListÚOptionalÚUnionÚwin32TÚlibeditzbind ^I rl_completeztab: completeF)Úcolumn_width)Ú__display_version__Úpackage_dir)Ú__)ÚboldÚcolor_terminalÚcolorizeÚnocolorÚred)Ú	ensuredir)ÚSphinxRendererÚautodocz,automatically insert docstrings from modulesÚdoctestz2automatically test code snippets in doctest blocksÚintersphinxz7link between Sphinx documentation of different projectsÚtodoz9write "todo" entries that can be shown or hidden on buildÚcoveragez!checks for documentation coverageÚimgmathz+include math, rendered as PNG or SVG imagesÚmathjaxz0include math, rendered in the browser by MathJaxÚifconfigz7conditional inclusion of content based on config valuesÚviewcodez=include links to the source code of documented Python objectsÚgithubpagesz=create .nojekyll file to publish the document on GitHub pagesú.Ú_ú.rstÚindex)r   ÚsepÚdotÚlanguageÚsuffixÚmasterÚmakefileÚ	batchfilez> r   ÚpurpleÚpromptÚreturnc                 ó€   — t           j        dk    r t          | d¬¦  «         t          d¦  «        S t          | ¦  «        S )Nr   Ú ©Úend)ÚsysÚplatformÚprintÚinput)r/   s    ú7/usr/lib/python3/dist-packages/sphinx/cmd/quickstart.pyÚ
term_inputr:   G   s<   € Ý
„|�wÒÐõ 	ˆf˜"ÐÑÔÐÝ�R‰yŒyÐå�V‰}Œ}Ðó    c                   ó   — e Zd ZdZdS )ÚValidationErrorzRaised for validation errors.N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__© r;   r9   r=   r=   R   s   € € € € € Ø'Ð'Ð'Ð'r;   r=   Úxc                 óŽ   — t          j        | ¦  «        } t          j        | ¦  «        st          t	          d¦  «        ¦  «        ‚| S )NzPlease enter a valid path name.)r   Ú
expanduserÚisdirr=   r   ©rC   s    r9   Úis_pathrH   V   s>   € ÝŒ˜ÑÔ€AÝŒ:�a‰=Œ=ð EÝ�bÐ!BÑCÔCÑDÔDÐDØ€Hr;   c                 ó0   — | dk    r| S t          | ¦  «        S )Nr2   )rH   rG   s    r9   Úis_path_or_emptyrJ   ]   s   € ØˆB‚w€wØˆÝ�1‰:Œ:Ðr;   c                 ó   — | S ©NrB   rG   s    r9   Úallow_emptyrM   c   ó   € Ø€Hr;   c                 óB   — | st          t          d¦  «        ¦  «        ‚| S )NzPlease enter some text.)r=   r   rG   s    r9   ÚnonemptyrP   g   s&   € Øð =Ý�bÐ!:Ñ;Ô;Ñ<Ô<Ð<Ø€Hr;   Úlc                  ó0   ‡ — dt           dt           fˆ fd„}|S )NrC   r0   c                 ót   •— | ‰vr2t          t          d¦  «        d                     ‰¦  «        z  ¦  «        ‚| S )NzPlease enter one of %s.ú, )r=   r   Újoin)rC   rQ   s    €r9   Úvalzchoice.<locals>.valn   s7   ø€ Ø�Aˆ:ˆ:Ý!¥"Ð%>Ñ"?Ô"?À$Ç)Â)ÈAÁ,Ä,Ñ"NÑOÔOÐOØˆr;   )Ústr)rQ   rV   s   ` r9   ÚchoicerX   m   s6   ø€ ð�sð •sð ð ð ð ð ð ð €Jr;   c                 ó’   — |                       ¦   «         dvrt          t          d¦  «        ¦  «        ‚|                       ¦   «         dv S )N)ÚYÚYESÚNÚNOzPlease enter either 'y' or 'n'.)rZ   r[   )Úupperr=   r   rG   s    r9   Úbooleanr_   u   s@   € Ø‡w‚w�y„yÐ/Ð/Ð/Ý�bÐ!BÑCÔCÑDÔDÐDØ�7Š7‰9Œ9˜Ð$Ð$r;   c                 ó€   — | dd…         dk    rt          | ¦  «        dk    st          t          d¦  «        ¦  «        ‚| S )Nr   é   r#   z2Please enter a file suffix, e.g. '.rst' or '.txt'.)Úlenr=   r   rG   s    r9   r*   r*   {   s=   € Øˆa�ˆcŒF�cŠMˆM�c !™fœf qšj˜jÝ�bÐ!UÑVÔVÑWÔWÐWØ€Hr;   c                 ó   — | S rL   rB   rG   s    r9   Úokrd   �   rN   r;   ÚtextÚdefaultÚ	validatorc           	      ó´  — 	 |�t           | ›d|›d�z   }nt           | z   dz   }t          rn6t          rt          t          |d¬¦  «        }nt          t          |d¬¦  «        }t          |¦  «                             ¦   «         }|r|s|}	  ||¦  «        }nC# t          $ r6}t          t          dt          |¦  «        z   ¦  «        ¦  «         Y d }~ŒÎd }~ww xY w	 |S )NTz [z]: ú: )Ú
input_modeFz* )ÚPROMPT_PREFIXÚUSE_LIBEDITÚREADLINE_AVAILABLEr   ÚCOLOR_QUESTIONr:   Ústripr=   r7   r   rW   )re   rf   rg   r/   rC   Úerrs         r9   Ú	do_promptrq   …   s  € ðØÐÝ"°D°D°D¸'¸'¸'Ð%BÑBˆFˆFå" TÑ)¨DÑ0ˆFÝð 		Hð Ýð 	Hå�n¨fÀÐFÑFÔFˆFˆFå�n¨fÀÐGÑGÔGˆFÝ�vÑÔ×$Ò$Ñ&Ô&ˆØð 	˜1ð 	ØˆAð	Ø�	˜!‘”ˆAˆAøÝð 	ð 	ð 	Ý•#�d�S ™XœX‘oÑ&Ô&Ñ'Ô'Ð'ØˆHˆHˆHˆHøøøøð	øøøð 	Ø€Hs   ÂB Â
CÂ,CÃCc                   ób   ‡ — e Zd Zd
deddfˆ fd„Zdedefd„Zdedeeef         defˆ fd	„Z	ˆ xZ
S )ÚQuickstartRendererr2   Útemplatedirr0   Nc                 óV   •— || _         t          ¦   «                              ¦   «          d S rL   )rt   ÚsuperÚ__init__)Úselfrt   Ú	__class__s     €r9   rw   zQuickstartRenderer.__init__¤   s'   ø€ Ø&ˆÔÝ‰Œ×ÒÑÔÐÐÐr;   Útemplate_namec                 ó˜   — t          j        | j        t          j        |¦  «        ¦  «        }| j        rt          j        |¦  «        rdS dS )z¸Check if custom template file exists.

        Note: Please don't use this function from extensions.
              It will be removed in the future without deprecation period.
        TF)r   rU   rt   ÚbasenameÚexists)rx   rz   Útemplates      r9   Ú_has_custom_templatez'QuickstartRenderer._has_custom_template¨   sH   € õ ”9˜TÔ-­t¬}¸]Ñ/KÔ/KÑLÔLˆØÔð 	¥¤¨HÑ 5Ô 5ð 	Ø�4à�5r;   Úcontextc                 óö   •— |                       |¦  «        rBt          j        | j        t          j        |¦  «        ¦  «        }|                      ||¦  «        S t          ¦   «                              ||¦  «        S rL   )r   r   rU   rt   r|   Úrender_from_filerv   Úrender)rx   rz   r€   Úcustom_templatery   s       €r9   rƒ   zQuickstartRenderer.render´   se   ø€ Ø×$Ò$ ]Ñ3Ô3ð 	:Ý"œi¨Ô(8½$¼-ÈÑ:VÔ:VÑWÔWˆOØ×(Ò(¨¸'ÑBÔBÐBå‘7”7—>’> -°Ñ9Ô9Ð9r;   )r2   )r>   r?   r@   rW   rw   Úboolr   r   r   rƒ   Ú__classcell__)ry   s   @r9   rs   rs   £   s­   ø€ € € € € ðð  Cð °ð ð ð ð ð ð ð
°#ð 
¸$ð 
ð 
ð 
ð 
ð: Cð :°$°s¸C°x´.ð :ÀSð :ð :ð :ð :ð :ð :ð :ð :ð :ð :r;   rs   Údc           	      ó¨  — t          t          t          d¦  «        ¦  «        t          z  ¦  «         t          ¦   «          t          t          d¦  «        ¦  «         d| v rAt          ¦   «          t          t          t          d¦  «        ¦  «        | d         z  ¦  «         nPt          ¦   «          t          t          d¦  «        ¦  «         t	          t          d¦  «        dt
          ¦  «        | d<   t          j        t          j        | d         d¦  «        ¦  «        s.t          j        t          j        | d         d	d¦  «        ¦  «        rþt          ¦   «          t          t          t          d
¦  «        ¦  «        ¦  «         t          t          d¦  «        ¦  «         t          ¦   «          t	          t          d¦  «        dt          ¦  «        | d<   | d         st          j        d¦  «         t          j        t          j        | d         d¦  «        ¦  «        °Ðt          j        t          j        | d         d	d¦  «        ¦  «        °þd| vrPt          ¦   «          t          t          d¦  «        ¦  «         t	          t          d¦  «        dt          ¦  «        | d<   d| vrPt          ¦   «          t          t          d¦  «        ¦  «         t	          t          d¦  «        dt          ¦  «        | d<   d| vrIt          ¦   «          t          t          d¦  «        ¦  «         t	          t          d¦  «        ¦  «        | d<   d| vrt	          t          d¦  «        ¦  «        | d<   d| vrPt          ¦   «          t          t          d¦  «        ¦  «         t	          t          d¦  «        dt          ¦  «        | d<   d| vr,t	          t          d ¦  «        | d         t          ¦  «        | d<   d!| vr[t          ¦   «          t          t          d"¦  «        ¦  «         t	          t          d#¦  «        d$¦  «        | d!<   | d!         d$k    rd%| d!<   d&| vrPt          ¦   «          t          t          d'¦  «        ¦  «         t	          t          d(¦  «        d)t          ¦  «        | d&<   d*| vrJt          ¦   «          t          t          d+¦  «        ¦  «         t	          t          d,¦  «        d-¦  «        | d*<   t          j        t          j        | d         | d*         | d&         z   ¦  «        ¦  «        s>t          j        t          j        | d         d	| d*         | d&         z   ¦  «        ¦  «        �rt          ¦   «          t          t          t          d.¦  «        | d*         | d&         z   z  ¦  «        ¦  «         t          t          d/¦  «        ¦  «         t          ¦   «          t	          t          d0¦  «        | d*         ¦  «        | d*<   t          j        t          j        | d         | d*         | d&         z   ¦  «        ¦  «        °Õt          j        t          j        | d         d	| d*         | d&         z   ¦  «        ¦  «        �°d1| vrÎt          t          d2¦  «        ¦  «         g | d1<   t                                ¦   «         D ]?\  }}t	          |›d3|›d4�dt          ¦  «        r| d1                              d5|z  ¦  «         Œ@d6d7h                     | d1         ¦  «        r7t          t          d8¦  «        ¦  «         | d1                              d6¦  «         d9| vrPt          ¦   «          t          t          d:¦  «        ¦  «         t	          t          d;¦  «        d<t          ¦  «        | d9<   d=| vr&t	          t          d>¦  «        d<t          ¦  «        | d=<   t          ¦   «          d%S )?a4  Ask the user for quickstart values missing from *d*.

    Values are:

    * path:      root path
    * sep:       separate source and build dirs (bool)
    * dot:       replacement for dot in _templates etc.
    * project:   project name
    * author:    author names
    * version:   version of project
    * release:   release of project
    * language:  document language
    * suffix:    source file suffix
    * master:    master document name
    * extensions:  extensions to use (list)
    * makefile:  make Makefile
    * batchfile: make command file
    z,Welcome to the Sphinx %s quickstart utility.zyPlease enter values for the following settings (just press Enter to
accept a default value, if one is given in brackets).r   zSelected root path: %sz&Enter the root path for documentation.zRoot path for the documentationr#   úconf.pyÚsourcezDError: an existing conf.py has been found in the selected root path.z>sphinx-quickstart will not overwrite existing Sphinx projects.z4Please enter a new root path (or just Enter to exit)r2   ra   r'   zÉYou have two options for placing the build directory for Sphinx output.
Either, you use a directory "_build" within the root path, or you separate
"source" and "build" directories within the root path.z+Separate source and build directories (y/n)Únr(   zêInside the root directory, two more directories will be created; "_templates"
for custom HTML templates and "_static" for custom stylesheets and other static
files. You can enter another prefix (such as ".") to replace the underscore.z(Name prefix for templates and static dirr$   ÚprojectzIThe project name will occur in several places in the built documentation.zProject nameÚauthorzAuthor name(s)Úversiona-  Sphinx has the notion of a "version" and a "release" for the
software. Each version can have multiple releases. For example, for
Python the version is something like 2.5 or 3.0, while the release is
something like 2.5.1 or 3.0a1. If you don't need this dual structure,
just set both to the same value.zProject versionÚreleasezProject releaser)   a3  If the documents are to be written in a language other than English,
you can select a language here by its language code. Sphinx will then
translate text that it generates into that language.

For a list of supported codes, see
https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.zProject languageÚenNr*   z‡The file name suffix for source files. Commonly, this is either ".txt"
or ".rst". Only files with this suffix are considered documents.zSource file suffixr%   r+   a  One document is special in that it is considered the top node of the
"contents tree", that is, it is the root of the hierarchical structure
of the documents. Normally, this is "index", but if your "index"
document is a custom template, you can also set this to another filename.z-Name of your master document (without suffix)r&   zKError: the master file %s has already been found in the selected root path.z7sphinx-quickstart will not overwrite the existing file.zIPlease enter a new file name, or rename the existing file and press EnterÚ
extensionszDIndicate which of the following Sphinx extensions should be enabled:ri   z (y/n)úsphinx.ext.%szsphinx.ext.imgmathzsphinx.ext.mathjaxzZNote: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.r,   z—A Makefile and a Windows command file can be generated for you so that you
only have to run e.g. `make html' instead of invoking sphinx-build
directly.zCreate Makefile? (y/n)Úyr-   z"Create Windows command file? (y/n))r7   r   r   r   rq   rH   r   ÚisfilerU   rJ   r5   Úexitr_   rd   rM   r*   Ú
EXTENSIONSÚitemsÚappendÚissubsetÚremove)r‡   ÚnameÚdescriptions      r9   Úask_userr�   ¼   s®  € õ( 
�$�rÐ@ÑAÔAÑ
BÔ
BÕEXÑ
XÑYÔYÐYÝ	�G„G€GÝ	�"ð Eñ Fô Fñ Gô Gð Gð �€{€{Ý‰ŒˆÝ�d•2Ð.Ñ/Ô/Ñ0Ô0°1°V´9Ñ<Ñ=Ô=Ð=Ð=å‰ŒˆÝ�bÐ9Ñ:Ô:Ñ;Ô;Ð;Ý�bÐ!BÑCÔCÀSÍ'ÑRÔRˆˆ&‰	å
Œ+•d”i  &¤	¨9Ñ5Ô5Ñ
6Ô
6ð 
ÝŒK�œ	 ! F¤)¨X°yÑAÔAÑBÔBð
å‰ŒˆÝ�d•2ð ,ñ -ô -ñ .ô .ñ 	/ô 	/ð 	/å�bÐQÑRÔRÑSÔSÐSÝ‰ŒˆÝ�bÐ!WÑXÔXØ Õ"2ñ4ô 4ˆˆ&‰	à�Œyð 	ÝŒH�Q‰KŒKˆKõ Œ+•d”i  &¤	¨9Ñ5Ô5Ñ
6Ô
6ð 
ÝŒK�œ	 ! F¤)¨X°yÑAÔAÑBÔBð
ð �A€~€~Ý‰ŒˆÝ�bð Jñ Kô Kñ 	Lô 	Lð 	Lõ �RÐ MÑNÔNÐPSÕU\Ñ]Ô]ˆˆ%‰à�A€~€~Ý‰ŒˆÝ�bð `ñ aô añ 	bô 	bð 	bõ �RÐ JÑKÔKÈSÕRTÑUÔUˆˆ%‰à˜ÐÐÝ‰ŒˆÝ�bÐ\Ñ]Ô]Ñ^Ô^Ð^Ý ¥ NÑ!3Ô!3Ñ4Ô4ˆˆ)‰Ø�qÐÐÝ¥Ð#3Ñ 4Ô 4Ñ5Ô5ˆˆ(‰à˜ÐÐÝ‰ŒˆÝ�bð 4ñ 5ô 5ñ 	6ô 	6ð 	6õ
 !¥Ð$5Ñ!6Ô!6¸½KÑHÔHˆˆ)‰Ø˜ÐÐÝ ¥Ð$5Ñ!6Ô!6¸¸)¼ÅkÑRÔRˆˆ)‰à˜ÐÐÝ‰ŒˆÝ�bð cñ dô dñ 	eô 	eð 	eõ "¥"Ð%7Ñ"8Ô"8¸$Ñ?Ô?ˆˆ*‰ØˆZŒ=˜DÒ Ð Ø ˆAˆj‰Mà�qÐÐÝ‰ŒˆÝ�bð Tñ Uô Uñ 	Vô 	Vð 	Vå¥Ð#7Ñ 8Ô 8¸&Å&ÑIÔIˆˆ(‰à�qÐÐÝ‰ŒˆÝ�bð ]ñ ^ô ^ñ 	_ô 	_ð 	_õ  ¥Ð#RÑ SÔ SÐU\Ñ]Ô]ˆˆ(‰å
Œ+•d”i  &¤	¨1¨X¬;¸¸8¼Ñ+DÑEÔEÑ
FÔ
Fð RÝŒK�œ	 ! F¤)¨X°q¸´{ÀQÀxÄ[Ñ7PÑQÔQÑRÔRñRå‰ŒˆÝ�d•2ð ,ñ -ô -Ø01°(´¸aÀ¼kÑ0IñKñ Lô Lñ 	Mô 	Mð 	Må�bÐJÑKÔKÑLÔLÐLÝ‰ŒˆÝ¥ð $Cñ !Dô !DØEFÀxÄ[ñRô Rˆˆ(‰õ Œ+•d”i  &¤	¨1¨X¬;¸¸8¼Ñ+DÑEÔEÑ
FÔ
Fð RÝŒK�œ	 ! F¤)¨X°q¸´{ÀQÀxÄ[Ñ7PÑQÔQÑRÔRñRð ˜1ÐÐÝ�bÐWÑXÔXÑYÔYÐYØˆˆ,‰Ý!+×!1Ò!1Ñ!3Ô!3ð 	?ð 	?ÑˆD�+Ý¨4¨4¨4°°°Ð=¸sÅGÑLÔLð ?Ø�,”×&Ò& ¸Ñ'=Ñ>Ô>Ð>øð !Ð"6Ð7×@Ò@ÀÀ<ÄÑQÔQð 	9Ý•"ð 4ñ 5ô 5ñ 6ô 6ð 6àˆlŒO×"Ò"Ð#7Ñ8Ô8Ð8à˜ÐÐÝ‰ŒˆÝ�bð ñ ô ñ 	ô 	ð 	õ "¥"Ð%=Ñ">Ô">ÀÅWÑMÔMˆˆ*‰à˜!ÐÐÝ"¥2Ð&JÑ#KÔ#KÈSÕRYÑZÔZˆˆ+‰Ý	�G„G€G€G€Gr;   Ú	overwriteÚsilentrt   c           	      óÊ
  ‡ ‡— t          |pd¦  «        }d‰ vrd‰ d<   d‰ vrd‰ d<   ‰ d         ‰ d<   t          j        ¦   «         ‰ d<   t          ‰ d         ¦  «        d	z  ‰ d
<   ‰                      dg ¦  «         t          j        d¦  «        dz   ‰ d         z   ‰ d<   t          j                             ‰ d         ¦  «        ‰ d<   t          ‰ d         ¦  «         ‰ d         rt          j
        ‰ d         d¦  «        n‰ d         }t          |¦  «         ‰ d         r!t          j
        ‰ d         d¦  «        }d‰ d<   nWt          j
        |‰ d         dz   ¦  «        }t          t          ‰ d         dz   ddg¦  «        }d 
                    |¦  «        ‰ d<   t          |¦  «         t          t          j
        |‰ d         dz   ¦  «        ¦  «         t          t          j
        |‰ d         dz   ¦  «        ¦  «         d?dt          dt          dt          t                   ddfˆ ˆfd„}|r t          j         
                    |d ¦  «        nd}	|	rt          j        |	¦  «        s't          j         
                    t           dd!d ¦  «        }	t#          |	d"¬#¦  «        5 }
|
                     ¦   «         }ddd¦  «         n# 1 swxY w Y    |t          j
        |d$¦  «        |                     |‰ ¦  «        ¦  «         t          j
        |‰ d         ‰ d%         z   ¦  «        }|                     d&¦  «        r@d'}t+          t-          d(|¦  «        ¦  «          |||                     d&‰ ¦  «        ¦  «         n  |||                     d)‰ ¦  «        ¦  «         ‰                      d*¦  «        d+u rd,}d-}nd.}d/}‰ d0         d+u ra‰ d         rdnd1‰ d2<   ‰ d         rdn
‰ d         dz   ‰ d3<    |t          j
        ‰ d         d4¦  «        |                     |‰ ¦  «        d5¦  «         ‰ d6         d+u ra‰ d         rdnd1‰ d2<   ‰ d         rdn
‰ d         dz   ‰ d3<    |t          j
        ‰ d         d7¦  «        |                     |‰ ¦  «        d8¦  «         |rdS t+          ¦   «          t+          t3          t5          d9¦  «        ¦  «        ¦  «         t+          ¦   «          t+          t5          d:¦  «        |z  d¬;¦  «         ‰ d0         s‰ d6         rt+          t5          d<¦  «        ¦  «         n!t+          t5          d=¦  «        ||fz  ¦  «         t+          t5          d>¦  «        ¦  «         t+          ¦   «          dS )@z(Generate project based on values in *d*.r2   ÚmastertoctreeÚmastertocmaxdepthé   r+   Úroot_docÚnowrŒ   ú=Úproject_underliner‘   z%YrT   r�   Ú	copyrightr   r'   rŠ   ÚbuildÚexclude_patternsr(   z	Thumbs.dbz	.DS_StoreÚ	templatesÚstaticNÚfpathÚcontentÚnewliner0   c                 óJ  •— ‰st          j        | ¦  «        sfd‰vrt          t          d¦  «        | z  ¦  «         t	          | dd|¬¦  «        5 }|                     |¦  «         d d d ¦  «         d S # 1 swxY w Y   d S d‰vr!t          t          d¦  «        | z  ¦  «         d S d S )NÚquietzCreating file %s.Úwtúutf-8)Úencodingr¯   z!File %s already exists, skipping.)r   r”   r7   r   ÚopenÚwrite)r­   r®   r¯   Úfr‡   rž   s       €€r9   Ú
write_filezgenerate.<locals>.write_filek  s  ø€ Øð 	G�DœK¨Ñ.Ô.ð 	GØ˜aÐÐÝ•bÐ,Ñ-Ô-°Ñ5Ñ6Ô6Ð6Ý�e˜T¨G¸WÐEÑEÔEð !ÈØ—’˜Ñ Ô Ð ð!ð !ð !ñ !ô !ð !ð !ð !ð !ð !ð !ð !øøøð !ð !ð !ð !ð !ð !ð ˜aÐÐÝ•bÐ<Ñ=Ô=ÀÑEÑFÔFÐFÐFÐFð  Ðs   ÁA1Á1A5Á8A5z	conf.py_tÚ
quickstartr³   )r´   r‰   r*   zquickstart/master_doc.rst_tz{A custom template `master_doc.rst_t` found. It has been renamed to `root_doc.rst_t`.  Please rename it on your project too.r   zquickstart/root_doc.rst_tÚ	make_modeTzquickstart/Makefile.new_tzquickstart/make.bat.new_tzquickstart/Makefile_tzquickstart/make.bat_tr,   r#   ÚrsrcdirÚ	rbuilddirÚMakefileú
r-   úmake.batz
z:Finished: An initial directory structure has been created.zYYou should now populate your master file %s and create other documentation
source files. r3   z<Use the Makefile to build the docs, like so:
   make builderzYUse the sphinx-build command to build the docs, like so:
   sphinx-build -b builder %s %szPwhere "builder" is one of the supported builders, e.g. html, latex or linkcheck.rL   )rs   ÚtimeÚasctimer   Ú
setdefaultÚstrftimeÚosr   Úabspathr   rU   ÚmapÚreprrW   r
   r”   r   rµ   ÚreadÚrender_stringr   r7   r   rƒ   Úgetr   r   )r‡   rž   rŸ   rt   r~   ÚsrcdirÚbuilddirrª   r¸   Ú	conf_pathr·   Ú	conf_textÚ
masterfileÚmsgÚmakefile_templateÚbatchfile_templates   ``              r9   ÚgeneraterÓ   F  s(  øø€ õ " +Ð"3°Ñ4Ô4€Hà˜aÐÐØˆˆ/ÑØ !Ð#Ð#Ø!"ˆÐ
Ñà�h”K€A€j�MÝŒ|‰~Œ~€A€e�HÝ)¨!¨I¬,Ñ7Ô7¸#Ñ=€AÐÑØ‡L‚L�˜rÑ"Ô"Ð"Ý”] 4Ñ(Ô(¨4Ñ/°!°H´+Ñ=€A€k�Nå”—’  &¤	Ñ*Ô*€A€f�IÝˆa�ŒiÑÔÐà/0°¬xÐF�TŒY�q˜”y (Ñ+Ô+Ð+¸Q¸v¼Y€FåˆfÑÔÐØˆ„xð 	<Ý”9˜Q˜vœY¨Ñ0Ô0ˆØ "ˆÐ
ÑÐå”9˜V Q u¤X°Ñ%7Ñ8Ô8ˆÝ�tØˆeŒH�wÑØ˜ð&
ñ ô Ðð !%§	¢	Ð*:Ñ ;Ô ;ˆÐ
ÑÝˆhÑÔÐÝ�dŒi˜  %¤¨;Ñ 6Ñ7Ô7Ñ8Ô8Ð8Ý�dŒi˜  %¤¨8Ñ 3Ñ4Ô4Ñ5Ô5Ð5ðGð G�#ð G­ð Gµh½s´mð GÈtð Gð Gð Gð Gð Gð Gð Gð ;FÐO•”—’˜[¨+Ñ6Ô6Ð6È4€IØð V�DœK¨	Ñ2Ô2ð VÝ”G—L’L¥¨k¸<ÈÑUÔUˆ	Ý	ˆi 'Ð	*Ñ	*Ô	*ð ¨aØ—F’F‘H”Hˆ	ðð ð ñ ô ð ð ð ð ð ð øøøð ð ð ð ð €J�tŒy˜ Ñ+Ô+¨X×-CÒ-CÀIÈqÑ-QÔ-QÑRÔRÐRå”˜6 1 X¤;°°8´Ñ#<Ñ=Ô=€JØ×$Ò$Ð%BÑCÔCð PðJˆå�h�u˜cÑ"Ô"Ñ#Ô#Ð#Øˆ
�:˜xŸšÐ/LÈaÑPÔPÑQÔQÐQÐQàˆ
�:˜xŸšÐ/JÈAÑNÔNÑOÔOÐOà‡u‚uˆ[ÑÔ˜TÐ!Ð!Ø7ÐØ8ÐÐà3ÐØ4Ðàˆ„}˜ÐÐØ#$ U¤8Ð4�x�x°ˆˆ)‰Ø$% e¤HÐD˜˜°!°E´(¸WÑ2Dˆˆ+‰àˆ
•4”9˜Q˜vœY¨
Ñ3Ô3Ø—?’?Ð#4°aÑ8Ô8¸$ñ	@ô 	@ð 	@ð 	ˆ„~˜ÐÐØ#$ U¤8Ð4�x�x°ˆˆ)‰Ø$% e¤HÐD˜˜°!°E´(¸WÑ2Dˆˆ+‰Øˆ
•4”9˜Q˜vœY¨
Ñ3Ô3Ø—?’?Ð#5°qÑ9Ô9¸6ñ	Cô 	Cð 	Cð ð ØˆÝ	�G„G€GÝ	�$�rÐNÑOÔOÑ
PÔ
PÑQÔQÐQÝ	�G„G€GÝ	�"ð ñ ô Ø!+ñ,Ø13ð5ñ 5ô 5ð 5àˆ„}ð K˜˜+œð KÝ�bð #ñ $ô $ñ 	%ô 	%ð 	%ð 	%õ 	�bð 4ñ 5ô 5Ø8>ÀÐ7IñJñ 	Kô 	Kð 	Kå	�"ð .ñ /ô /ñ 0ô 0ð 0å	�G„G€G€G€Gs   ÊJ4Ê4J8Ê;J8c                 ó  — | d         }t          j        |¦  «        sdS t          j        |¦  «        sdS ddht          t	          j        |¦  «        ¦  «        z  rdS | d         rLt          j                              d|¦  «        }t          j        |¦  «        sdS t          j        |¦  «        sdS d| d	         d
z   | d	         dz   | d         | d         z   g}t          |¦  «        t          t	          j        |¦  «        ¦  «        z  rdS dS )Nr   TFr½   r¿   r'   rŠ   r‰   r(   r¬   r«   r+   r*   )r   r}   rF   ÚsetrÄ   ÚlistdirrU   )r‡   ÚdirÚreserved_namess      r9   Ú	valid_dirrÙ   ¬  s  € Ø
ˆFŒ)€CÝŒ;�sÑÔð ØˆtÝŒ:�c‰?Œ?ð Øˆuà�JÐ¥#¥b¤j°¡o¤oÑ"6Ô"6Ñ6ð Øˆuàˆ„xð ÝŒg�lŠl˜8 SÑ)Ô)ˆÝŒ{˜3ÑÔð 	Ø�4ÝŒz˜#‰Œð 	Ø�5ð 	Ø	ˆ%Œ�8ÑØ	ˆ%Œ�;ÑØ	ˆ(Œ�a˜”kÑ!ð	€Nõ ˆ>ÑÔ�S¥¤¨C¡¤Ñ1Ô1Ñ1ð Øˆuàˆ4r;   c            
      ó 	  — t          d¦  «        } t          j        dt          d¦  «        | ¬¦  «        }|                     ddddd t          d	¦  «        ¬
¦  «         |                     ddddt          z  ¬¦  «         |                     ddddt          d¦  «        ¬¦  «         |                     t          d¦  «        ¦  «        }|                     dddd t          d¦  «        ¬
¦  «         |                     dddt          d¦  «        ¬¦  «         |                     ddd t          d!¦  «        ¬"¦  «         |                     t          d#¦  «        ¦  «        }|                     d$d%d&d't          d(¦  «        ¬)¦  «         |                     d*d+d,d-t          d.¦  «        ¬)¦  «         |                     d/d0dd1t          d2¦  «        ¬3¦  «         |                     d4d5d6d7t          d8¦  «        ¬)¦  «         |                     d9d:d;d<t          d=¦  «        ¬)¦  «         |                     d>d?d@t          dA¦  «        ¬"¦  «         |                     dBdCdDt          dE¦  «        ¬"¦  «         |                     dFddGt          dH¦  «        ¬I¦  «         |                     t          dJ¦  «        ¦  «        }t          D ]2}|                     dK|z  dLdM|z  dNt          dO¦  «        |z  ¬P¦  «         Œ3|                     dQdRdNdSt          dT¦  «        ¬U¦  «         |                     t          dV¦  «        ¦  «        }|                     dWddXdYt          dZ¦  «        ¬
¦  «         |                     d[ddXt          d\¦  «        ¬¦  «         |                     d]dd^dYt          d_¦  «        ¬
¦  «         |                     d`dd^t          da¦  «        ¬¦  «         |                     dbdcddddYt          de¦  «        ¬
¦  «         |                     dfdgdddt          dh¦  «        ¬¦  «         |                     t          di¦  «        ¦  «        }|                     djdkdldmt          dn¦  «        ¬)¦  «         |                     dodpdSdqt          dr¦  «        ¬s¦  «         |S )tNzí
Generate required files for a Sphinx project.

sphinx-quickstart is an interactive tool that asks some questions about your
project and then generates a complete documentation directory and sample
Makefile to be used with sphinx-build.
z %(prog)s [OPTIONS] <PROJECT_DIR>z:For more information, visit <https://www.sphinx-doc.org/>.)ÚusageÚepilogrœ   z-qz--quietÚ
store_truer±   z
quiet mode)ÚactionÚdestrf   Úhelpz	--versionrŽ   Úshow_versionz%%(prog)s %s)rÞ   rß   rŽ   r   ÚPROJECT_DIRr#   ú?zproject root)Úmetavarrf   Únargsrà   zStructure optionsz--sepr'   z,if specified, separate source and build dirsz--no-sepÚstore_falsez/if specified, create build dir under source dir)rÞ   rß   rà   z--dotÚDOTr$   z&replacement for dot in _templates etc.)rä   rf   rà   zProject basic optionsz-pz	--projectÚPROJECTrŒ   zproject name)rä   rß   rà   z-az--authorÚAUTHORr�   zauthor namesz-vÚVERSIONr2   zversion of project)rä   rß   rf   rà   z-rz	--releaseÚRELEASEr�   zrelease of projectz-lz
--languageÚLANGUAGEr)   zdocument languagez--suffixÚSUFFIXr%   zsource file suffixz--masterÚMASTERr&   zmaster document namez--epubFzuse epub)rÞ   rf   rà   zExtension optionsz--ext-%sÚappend_constr’   r‘   zenable %s extension)rÞ   Úconstrß   rà   z--extensionsr–   r˜   zenable arbitrary extensions)rä   rß   rÞ   rà   zMakefile and Batchfile creationz
--makefiler,   Tzcreate makefilez--no-makefilezdo not create makefilez--batchfiler-   zcreate batchfilez--no-batchfilezdo not create batchfilez-mz--use-make-moderº   z#use make-mode for Makefile/make.batz-Mz--no-use-make-modez*do not use make-mode for Makefile/make.batzProject templatingz-tz--templatedirÚTEMPLATEDIRrt   z%template directory for template filesz-dz
NAME=VALUEÚ	variableszdefine a template variable)rä   rÞ   rß   rà   )r   ÚargparseÚArgumentParserÚadd_argumentr   Úadd_argument_groupr–   )rœ   ÚparserÚgroupÚexts       r9   Ú
get_parserrú   É  s»  € Ýð	3ñô €Kõ Ô$Ø0ÝÐNÑOÔOØð!ñ !ô !€Fð
 ×Ò˜˜i°À7Ø $Ý Ñ-Ô-ð ñ /ô /ð /ð ×Ò˜¨I¸NØ .Õ1DÑ Dð ñ Fô Fð Fð ×Ò˜¨¸sÈ#Ý Ñ/Ô/ð ñ 1ô 1ð 1ð ×%Ò%¥bÐ)<Ñ&=Ô&=Ñ>Ô>€EØ	×Ò�w |¸%ÈÝÐMÑNÔNð ñ Pô Pð Pà	×Ò�z¨-¸eÝÐPÑQÔQð ñ Sô Sð Sà	×Ò�w¨°sÝÐGÑHÔHð ñ Jô Jð Jð ×%Ò%¥bÐ)@Ñ&AÔ&AÑBÔB€EØ	×Ò�t˜[°)À)Ý˜~Ñ.Ô.ð ñ 0ô 0ð 0à	×Ò�t˜Z°ÀÝ˜~Ñ.Ô.ð ñ 0ô 0ð 0à	×Ò�t Y°YÈÝÐ3Ñ4Ô4ð ñ 6ô 6ð 6à	×Ò�t˜[°)À)ÝÐ3Ñ4Ô4ð ñ 6ô 6ð 6à	×Ò�t˜\°:ÀJÝÐ2Ñ3Ô3ð ñ 5ô 5ð 5à	×Ò�z¨8¸VÝÐ3Ñ4Ô4ð ñ 6ô 6ð 6à	×Ò�z¨8¸WÝÐ5Ñ6Ô6ð ñ 8ô 8ð 8à	×Ò�x¨¸eÝ˜z™NœNð ñ ,ô ,ð ,ð ×%Ò%¥bÐ)<Ñ&=Ô&=Ñ>Ô>€EÝð Að AˆØ×Ò˜:¨Ñ+°NØ!0°3Ñ!6¸\Ý "Ð#8Ñ 9Ô 9¸CÑ ?ð 	ñ 	Aô 	Að 	Að 	Að 
×Ò�~¨|À,Ø&­RÐ0MÑ-NÔ-Nð ñ Pô Pð Pð ×%Ò%¥bÐ)JÑ&KÔ&KÑLÔL€EØ	×Ò�|¨L¸zÐSWÝÐ0Ñ1Ô1ð ñ 3ô 3ð 3à	×Ò�¨}À:ÝÐ7Ñ8Ô8ð ñ :ô :ð :à	×Ò�}¨\ÀÐUYÝÐ1Ñ2Ô2ð ñ 4ô 4ð 4à	×ÒÐ'°Ø'ÝÐ8Ñ9Ô9ð ñ ;ô ;ð ;ð 
×Ò�tÐ.°|Ø'°ÝÐDÑEÔEð ñ Gô Gð Gð 
×Ò�tÐ1¸-Ø'ÝÐKÑLÔLð ñ Nô Nð Nð ×%Ò%¥bÐ)=Ñ&>Ô&>Ñ?Ô?€EØ	×Ò�t˜_°mØ)ÝÐFÑGÔGð ñ Iô Ið Ið 
×Ò�t \¸(Ø'ÝÐ;Ñ<Ô<ð ñ >ô >ð >ð €Mr;   ra   Úargvc                 ó˜  — t           j                             t          j        d¦  «         t           j                             t
          j                             t          d¦  «        d¦  «         t          ¦   «         st          ¦   «          t          ¦   «         }	 |                     | ¦  «        }n# t          $ r}|j        cY d }~S d }~ww xY wt          |¦  «        }d„ |                     ¦   «         D ¦   «         }|                     dg ¦  «         |d         d d …         D ]O}d|v rI|d                              |¦  «         |d                              |                     d¦  «        ¦  «         ŒP	 d|v r5dd	h                     |¦  «        st-          t/          d
¦  «        ¦  «         dS h d£                     |¦  «        rÇ|                     dd¦  «         |                     d|d         ¦  «         t0                               ¦   «         }|                     |¦  «         |}t7          |¦  «        sUt-          ¦   «          t-          t9          t/          d¦  «        ¦  «        ¦  «         t-          t/          d¦  «        ¦  «         dS nt;          |¦  «         n5# t<          t>          f$ r! t-          ¦   «          t-          d¦  «         Y dS w xY w|                      dg ¦  «        D ]O}	 |                     d¦  «        \  }}	|	||<   Œ!# tB          $ r" t-          t/          d¦  «        |z  ¦  «         Y ŒLw xY wtE          |d|j#        ¬¦  «         dS )Nr2   ÚlocaleÚsphinxc                 ó   — i | ]
\  }}|®||“ŒS rL   rB   )Ú.0ÚkÚvs      r9   ú
<dictcomp>zmain.<locals>.<dictcomp>.  s   € Ð5Ð5Ð5‘$�!�Q q }ˆˆA } } }r;   r‘   ú,r±   rŒ   r�   zH"quiet" is specified, but any of "project" or "author" is not specified.ra   >   r±   r�   rŒ   rŽ   r�   zHError: specified path is not a directory, or sphinx files already exist.zWsphinx-quickstart only generate into a empty directory. Please specify a new root path.z[Interrupted.]é‚   rò   r¦   zInvalid template variable: %sF)rž   rt   r   )$rþ   rý   Ú	setlocaleÚLC_ALLÚinit_consolerÄ   r   rU   r   r   r   rú   Ú
parse_argsÚ
SystemExitÚcodeÚvarsr—   rÂ   rš   ÚextendÚsplitr™   r7   r   ÚDEFAULTSÚcopyÚupdaterÙ   r   r�   ÚKeyboardInterruptÚEOFErrorrÊ   Ú
ValueErrorrÓ   rt   )
rû   r÷   Úargsrp   r‡   rù   Úd2Úvariabler›   Úvalues
             r9   Úmainr    so  € Ý
„M×Ò�FœM¨2Ñ.Ô.Ð.Ý
„M×Ò�rœwŸ|š|­K¸ÑBÔBÀHÑMÔMÐMåÑÔð Ý‰	Œ	ˆ	õ ‰\Œ\€FðØ× Ò  Ñ&Ô&ˆˆøÝð ð ð ØŒxˆˆˆˆˆˆøøøøðøøøõ 	ˆT‰
Œ
€Aà5Ð5˜!Ÿ'š'™)œ)Ð5Ñ5Ô5€Að ‡L‚L�˜rÑ"Ô"Ð"Ø�Œ˜q˜q˜qÔ!ð 3ð 3ˆØ�#ˆ:ˆ:ØˆlŒO×"Ò" 3Ñ'Ô'Ð'ØˆlŒO×"Ò" 3§9¢9¨S¡>¤>Ñ2Ô2Ð2øðØ�aˆ<ˆ<Ø˜xÐ(×1Ò1°!Ñ4Ô4ð Ý•bð 6ñ 7ô 7ñ 8ô 8ð 8à�qà)Ð)Ð)×2Ò2°1Ñ5Ô5ð 	à�LŠL˜ BÑ'Ô'Ð'Ø�LŠL˜ A i¤LÑ1Ô1Ð1Ý—’‘”ˆBØ�IŠI�a‰LŒLˆLØˆAå˜Q‘<”<ð Ý‘”�Ý•d�2ð 6ñ 7ô 7ñ 8ô 8ñ 9ô 9ð 9å•bð <ñ =ô =ñ >ô >ð >à�qðõ �Q‰KŒKˆKøøÝ�xÐ(ð ð ð Ý‰ŒˆÝÐÑÔÐØˆsˆsðøøøð
 —E’E˜+ rÑ*Ô*ð Bð Bˆð	BØ"Ÿ.š.¨Ñ-Ô-‰KˆD�%ØˆAˆd‰GˆGøÝð 	Bð 	Bð 	BÝ•"Ð4Ñ5Ô5¸Ñ@ÑAÔAÐAÐAÐAð	Bøøøõ ˆQ˜%¨TÔ-=Ð>Ñ>Ô>Ð>Øˆ1sO   ÂB/ Â/
C
Â9CÂ?C
ÃC
Å17J Æ*CJ ÊJ Ê.K
Ë	K
Ë&LÌ)L0Ì/L0Ú__main__)TFN)ErA   ró   rý   rÄ   r5   rÀ   Úcollectionsr   r   Útypingr   r   r   r   r	   r
   r   Úreadliner6   ÚImportErrorrm   Úparse_and_bindrl   Údocutils.utilsr   Úsphinx.localerþ   r   r   r   Úsphinx.util.consoler   r   r   r   r   Úsphinx.util.osutilr   Úsphinx.util.templater   r–   r  rk   rn   rW   r:   Ú	Exceptionr=   rH   rJ   rM   rP   rX   r…   r_   r*   rd   rq   rs   r�   rÓ   rÙ   rô   rú   rû   Úintr  r>   r•   rB   r;   r9   ú<module>r'     s  ðØ =Ð =à €€€Ø €€€Ø 	€	€	€	Ø 
€
€
€
Ø €€€Ø #Ð #Ð #Ð #Ð #Ð #Ø Ð Ð Ð Ð Ð Ø LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LðØ€O€O€OØð ˜œ¨Ò0Ð0ØÐØÐØÔð ˜I¨Ô)9Ð9Ð9ØˆÔÐ 5Ñ6Ô6Ð6ØˆˆàˆÔ Ñ0Ô0Ð0ØˆøøØð ð ð ØÐØ€K€K€Kðøøøð (Ð 'Ð 'Ð 'Ð 'Ð 'à Ð Ð Ð Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ø Ð Ð Ð Ð Ð Ø LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LÐ LØ (Ð (Ð (Ð (Ð (Ð (Ø /Ð /Ð /Ð /Ð /Ð /àˆ[Ø��ÐAÑBÔBÐCØ��ÐGÑHÔHÐIØ�B�BÐPÑQÔQÐRØˆRˆRÐKÑLÔLÐMØ��Ð7Ñ8Ô8Ð9Ø��Ð@ÑAÔAÐBØ��ÐEÑFÔFÐGØ��ÐMÑNÔNÐOØ��ÐSÑTÔTÐUØ�B�BÐVÑWÔWÐXðñ ô €
ð ØØØØØØØð	ð 	€ð €à„<�7ÒÐà€N€Nà€Nð�sð ˜sð ð ð ð ð(ð (ð (ð (ð (�iñ (ô (ð (ðˆsð �sð ð ð ð ð˜ð  ð ð ð ð ð�3ð ˜3ð ð ð ð ð�ð ˜ð ð ð ð ðˆsð �x   s 
Ô+ð ð ð ð ð%ˆsð %�tð %ð %ð %ð %ðˆcð �cð ð ð ð ðˆ#ð �#ð ð ð ð ð
 )-ÐPXðð Ø
ðØ  œðØ9AÀ3À%ÈÀ*Ô9Mðà
ˆ3�ˆ9Ôðð ð ð ð<:ð :ð :ð :ð :˜ñ :ô :ð :ð2G��S˜#�X”ð G 4ð Gð Gð Gð GðV Y]ðcð cØðcØðcØ-1ðcØHPÐQTÌðcà	ðcð cð cð cðL�ð ˜$ð ð ð ð ð:R�HÔ+ð Rð Rð Rð Rðj œ8 A B Bœ<ð >ð >ˆt�CŒyð >¨Cð >ð >ð >ð >ðB ˆzÒÐØ€C„HˆTˆT�#”(˜1˜2˜2”,ÑÔÑ Ô Ð Ð Ð ð Ðs   ¶A
B Â	BÂB