§
    _÷#dÉ  ã                   óø   — d Z ddlZddlZddlZddlmZ ddlmZmZm	Z	 ddl
mZ ddlmZ ddlmZ ddlmZmZ dd	lmZmZ dd
lmZ 	 ddlmZ ddlmZ n# e$ r ddlmZ ddlmZ Y nw xY w G d„ de¦  «        Z dS )z‚Setuptools/distutils commands to assist the building of sphinx documentation.

:author: Sebastian Wiesner <basti.wiesner@gmx.net>
é    N)ÚStringIO)ÚAnyÚDictÚOptional)ÚSphinx)Úhandle_exception)ÚRemovedInSphinx70Warning)Úcolor_terminalÚnocolor)Údocutils_namespaceÚpatch_docutils)Úabspath)ÚCommand)Ú	ExecError)ÚDistutilsExecErrorc                   óJ   — e Zd ZdZdZg d¢Zg d¢Zdd„Zdefd„Z	dd	„Z
dd
„ZdS )ÚBuildDoca9  
    Distutils command to build Sphinx documentation.

    The Sphinx build can then be triggered from distutils, and some Sphinx
    options can be set in ``setup.py`` or ``setup.cfg`` instead of Sphinx's
    own configuration file.

    For instance, from `setup.py`::

       # this is only necessary when not using setuptools/distribute
       from sphinx.setup_command import BuildDoc
       cmdclass = {'build_sphinx': BuildDoc}

       name = 'My project'
       version = '1.2'
       release = '1.2.0'
       setup(
           name=name,
           author='Bernard Montgomery',
           version=release,
           cmdclass=cmdclass,
           # these are optional and override conf.py settings
           command_options={
               'build_sphinx': {
                   'project': ('setup.py', name),
                   'version': ('setup.py', version),
                   'release': ('setup.py', release)}},
       )

    Or add this section in ``setup.cfg``::

       [build_sphinx]
       project = 'My project'
       version = 1.2
       release = 1.2.0
    zBuild Sphinx documentation))ú	fresh-envÚEzdiscard saved environment)ú	all-filesÚazbuild all files)zsource-dir=ÚszSource directory)z
build-dir=NzBuild directory)zconfig-dir=Úcz'Location of the configuration directory)zbuilder=Úbz]The builder (or builders) to use. Can be a comma- or space-separated list. Defaults to "html")úwarning-is-errorÚWzTurn warning into errors)zproject=NzThe documented project's name)zversion=NzThe short X.Y version)zrelease=Nz.The full version, including alpha/beta/rc tags)ztoday=NzCHow to format the current date, used as the replacement for |today|)ú
link-indexÚiz!Link index.html to the master doc)Ú	copyrightNzThe copyright string)ÚpdbNzStart pdb on exception)Ú	verbosityÚvz$increase verbosity (can be repeated))ÚnitpickyÚnz1nit-picky mode, warn about all missing references)z
keep-goingNz)With -W, keep going when getting warnings)r   r   r   r   r#   ÚreturnNc                 ó  — dx| _         | _        d| _        d | _        d | _        d| _        d| _        d| _        d| _        d| _	        d| _
        d | _        d| _        d| _        | j        j        dz
  | _        d| _        d| _        d| _        d S )NFÚhtmlÚ é   )Ú	fresh_envÚ	all_filesr    Ú
source_dirÚ	build_dirÚbuilderÚwarning_is_errorÚprojectÚversionÚreleaseÚtodayÚ
config_dirÚ
link_indexr   ÚdistributionÚverboser!   Ú	tracebackr#   Ú
keep_going)Úselfs    ú6/usr/lib/python3/dist-packages/sphinx/setup_command.pyÚinitialize_optionszBuildDoc.initialize_optionsZ   s�   € Ø*/Ð/ˆŒ˜œØˆŒØ)-ˆŒØ(,ˆŒØˆŒØ %ˆÔØˆŒØˆŒØˆŒØˆŒ
Ø)-ˆŒØˆŒØˆŒàÔ*Ô2°QÑ6ˆŒØˆŒØˆŒØˆŒˆˆó    c                 ó®   — dD ]G}t           j                             |¦  «        sŒ"t          j        |¦  «        D ]\  }}}d|v r|c c S ŒŒHt           j        S )N)ÚdocÚdocszconf.py)ÚosÚpathÚisdirÚwalkÚcurdir)r:   ÚguessÚrootÚ	_dirnamesÚ	filenamess        r;   Ú_guess_source_dirzBuildDoc._guess_source_dirn   st   € Ø$ð 	 ð 	 ˆEÝ”7—=’= Ñ'Ô'ð ØÝ.0¬g°e©n¬nð  ð  Ñ*��i Ø 	Ð)Ð)Ø�K�K�K�K�Kð *ð õ ŒyÐr=   c                 ó&  ‡ — ‰                       d¦  «         ‰ j        €6‰                      ¦   «         ‰ _        ‰                      d‰ j        z  ¦  «         ‰                      d¦  «         ‰ j        €‰ j        ‰ _        ‰ j        €L‰                      d¦  «        }t          j	         
                    t          |j        ¦  «        d¦  «        ‰ _        t          j	         
                    ‰ j        d¦  «        ‰ _        ˆ fd„‰ j        D ¦   «         ‰ _        d S )Nr.   zUsing source directory %sr,   ÚbuildÚsphinxÚdoctreesc                 ó^   •— g | ])}|t           j                             ‰j        |¦  «        f‘Œ*S © )rA   rB   Újoinr-   )Ú.0r.   r:   s     €r;   ú
<listcomp>z-BuildDoc.finalize_options.<locals>.<listcomp>‰   s@   ø€ ð $)ð $)ð $)àð •b”g—l’l 4¤>°7Ñ;Ô;Ð<ð$)ð $)ð $)r=   )Úensure_string_listr,   rJ   ÚannounceÚensure_dirnamer4   r-   Úget_finalized_commandrA   rB   rQ   r   Ú
build_baseÚdoctree_dirr.   Úbuilder_target_dirs)r:   rL   s   ` r;   Úfinalize_optionszBuildDoc.finalize_optionsw   sû   ø€ Ø×Ò 	Ñ*Ô*Ð*àŒ?Ð"Ø"×4Ò4Ñ6Ô6ˆDŒOØ�MŠMÐ5¸¼ÑGÑHÔHÐHà×Ò˜LÑ)Ô)Ð)àŒ?Ð"Ø"œoˆDŒOàŒ>Ð!Ø×.Ò.¨wÑ7Ô7ˆEÝœWŸ\š\­'°%Ô2BÑ*CÔ*CÀXÑNÔNˆDŒNåœ7Ÿ<š<¨¬¸
ÑCÔCˆÔð$)ð $)ð $)ð $)àœ<ð$)ñ $)ô $)ˆÔ Ð Ð r=   c                 ó”  — t          j        dt          d¬¦  «         t          ¦   «         st	          ¦   «          | j        st          ¦   «         }nt          j        }i }| j	        r
| j	        |d<   | j
        r
| j
        |d<   | j        r
| j        |d<   | j        r
| j        |d<   | j        r
| j        |d<   | j        r
| j        |d	<   | j        D �]|\  }}d }	 | j        p| j        }t%          |¦  «        5  t'          ¦   «         5  t)          | j        | j        || j        |||| j        | j        | j        | j        ¬
¦  «        }|                     | j        ¬¦  «         |j        rt;          d|j        j        z  ¦  «        ‚	 d d d ¦  «         n# 1 swxY w Y   d d d ¦  «         n# 1 swxY w Y   nJ# t@          $ r=}tC          || |t          j"        ¦  «         | j#        stI          d¦  «        |‚Y d }~nd }~ww xY w| j%        s�Œ4|j&        j'        |j        j(        z   }|j         )                    d¦  «        }	tU          j+        ||	¦  «         �Œ~d S )Nz$setup.py build_sphinx is deprecated.é   )Ú
stacklevelr0   r1   r2   r3   r   r#   )ÚfreshenvÚwarningiserrorr!   r9   )Ú	force_allzcaused by %s builder.r)   Úindex),ÚwarningsÚwarnr	   r
   r   r7   r   ÚsysÚstdoutr0   r1   r2   r3   r   r#   rZ   r4   r,   r   r   r   rY   r*   r/   r!   r9   rL   r+   Ú
statuscoder   r.   ÚnameÚ	Exceptionr   Ústderrr    Ú
SystemExitr5   ÚconfigÚroot_docÚ
out_suffixÚget_outfilenamerA   Úsymlink)
r:   Ústatus_streamÚconfoverridesr.   Úbuilder_target_dirÚappÚconfdirÚexcÚsrcÚdsts
             r;   ÚrunzBuildDoc.run�   s;  € ÝŒÐ<Ý.¸1ð	>ñ 	>ô 	>ð 	>õ ÑÔð 	Ý‰IŒIˆIØŒ|ð 	'Ý$™JœJˆMˆMåœJˆMØ(*ˆØŒ<ð 	4Ø'+¤|ˆM˜)Ñ$ØŒ<ð 	4Ø'+¤|ˆM˜)Ñ$ØŒ<ð 	4Ø'+¤|ˆM˜)Ñ$ØŒ:ð 	0Ø%)¤ZˆM˜'Ñ"ØŒ>ð 	8Ø)-¬ˆM˜+Ñ&ØŒ=ð 	6Ø(,¬ˆM˜*Ñ%à+/Ô+Cð 	!ñ 	!Ñ'ˆGÐ'ØˆCð1Øœ/Ð<¨T¬_�Ý# GÑ,Ô,ð 	Tð 	TÕ.@Ñ.BÔ.Bð 	Tð 	TÝ  ¤°$´/Ø!3°TÔ5EØ!(¨-¸Ø*.¬.Ø04Ô0EØ+/¬>ÀdÄoðWñ Wô W�Cð —I’I¨¬�IÑ7Ô7Ð7Ø”~ð TÝ'Ð(?À#Ä+ÔBRÑ(RÑSÔSÐSðTð	Tð 	Tð 	Tñ 	Tô 	Tð 	Tð 	Tð 	Tð 	Tð 	Tð 	Tøøøð 	Tð 	Tð 	Tð 	Tð 	Tð 	Tð 	Tñ 	Tô 	Tð 	Tð 	Tð 	Tð 	Tð 	Tð 	Tøøøð 	Tð 	Tð 	Tð 	Tøøõ ð 1ð 1ð 1Ý   d¨Cµ´Ñ<Ô<Ð<Ø”xð 1Ý$ Q™-œ-¨SÐ0ð1ð 1ð 1ð 1ð 1øøøøð1øøøð
 ”?ð Ùà”*Ô%¨¬Ô(>Ñ>ˆCØ”+×-Ò-¨gÑ6Ô6ˆCÝŒJ�s˜CÑ Ô Ð Ñ ð3	!ð 	!sa   ÃF+Ã0FÃ?A<FÅ<FÆFÆFÆFÆFÆF+ÆF#	Æ#F+Æ&F#	Æ'F+Æ+
G2Æ53G-Ç-G2)r%   N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__ÚdescriptionÚuser_optionsÚboolean_optionsr<   ÚstrrJ   r[   ry   rP   r=   r;   r   r      sŸ   € € € € € ð#ð #ðJ /€Kðð ð €Lð*1ð 1ð 1€Oð ð  ð  ð  ð( 3ð ð ð ð ð)ð )ð )ð )ð,1!ð 1!ð 1!ð 1!ð 1!ð 1!r=   r   )!r}   rA   re   rc   Úior   Útypingr   r   r   Úsphinx.applicationr   Úsphinx.cmd.buildr   Úsphinx.deprecationr	   Úsphinx.util.consoler
   r   Úsphinx.util.docutilsr   r   Úsphinx.util.osutilr   Ú
setuptoolsr   Úsetuptools.errorsr   ÚImportErrorÚdistutils.cmdÚdistutils.errorsr   r   rP   r=   r;   ú<module>r�      sˆ  ððð ð
 
€	€	€	Ø 
€
€
€
Ø €€€Ø Ð Ð Ð Ð Ð Ø &Ð &Ð &Ð &Ð &Ð &Ð &Ð &Ð &Ð &à %Ð %Ð %Ð %Ð %Ð %Ø -Ð -Ð -Ð -Ð -Ð -Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø CÐ CÐ CÐ CÐ CÐ CÐ CÐ CØ &Ð &Ð &Ð &Ð &Ð &ðAØ"Ð"Ð"Ð"Ð"Ð"Ø+Ð+Ð+Ð+Ð+Ð+Ð+øØð Að Að AØ%Ð%Ð%Ð%Ð%Ð%Ø@Ð@Ð@Ð@Ð@Ð@Ð@Ð@ðAøøøð
c!ð c!ð c!ð c!ð c!ˆwñ c!ô c!ð c!ð c!ð c!s   ÁA ÁA)Á(A)