
    Fe>i                       d Z ddlm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
 ddlm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mZ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dl(m)Z)m*Z*m+Z+ ddl,m-Z-m.Z.m/Z/m0Z0 ddl1m2Z2m3Z3m4Z4m5Z5 ddl6m7Z7 ddl6m8Z8 e	r,ddl9m:Z:m;Z; ddl<m=Z= ddl>m?Z? ddl@mAZA ddlBmCZC ddlDmEZE ddlFmGZG  ej                  eI      ZJ G d d      ZKy)z$Builder superclass for all builders.    )annotationsN)path)TYPE_CHECKINGAny)nodes)DependencyList)CONFIG_CHANGED_REASON	CONFIG_OKBuildEnvironment)ImageAdapter)SphinxError)__)UnicodeDecodeErrorHandlerget_filetypeimport_objectloggingrst)
BuildPhase)bold)progress_messagestatus_iterator)sphinx_domains)CatalogInfoCatalogRepositorydocname_to_domain)SEP	ensuredirrelative_urirelpath)ParallelTasksSerialTasksmake_chunksparallel_available)
directives)roles)IterableSequence)Node)Sphinx)Config)EventManager)Tags)NoneTypec                     e Zd ZU dZdZdZdZded<   dZdZ	dZ
dZg Zded	<   dZdZd-d
Zd.dZd/dZd0dZd0dZd1d2dZd1d3dZd4dZd5dZd6dZd7dZd0dZd8dZd0dZd0dZd9dZd0dZ	 	 d:	 	 	 	 	 	 	 d;dZ d5dZ!d<dZ"d=dZ#dd d>d!Z$dd 	 	 	 	 	 	 	 d?d"Z%	 d@	 	 	 	 	 	 	 dAd#Z&dBd$Z'dCd%Z(dDd&Z)d0d'Z*dEd(Z+dEd)Z,d0d*Z-d0d+Z.dFd,Z/y)GBuilderz6
    Builds target formats from the reST sources.
     type[nodes.NodeVisitor]default_translator_classnoneFT	list[str]supported_image_typesc                   |j                   | _         |j                  | _        |j                  | _        |j                  | _        t	        | j                         || _        || _        | j                  j                  | j                  | j                         |j                  | _
        |j                  | _        |j                  | _        | j                  j                  | j                         | j                  j                  | j                         | j                  j                  d| j                  z         | j                  j                  d| j                  z         i | _        d| _        d| _        d| _        d | _        y )Nz	format_%sz
builder_%sr0   F)srcdirconfdiroutdir
doctreedirr   appenvset_versioning_methodversioning_methodversioning_compareeventsconfigtagsaddformatnameimagesimagedirimgpathparallel_okfinish_tasks)selfr;   r<   s      :/usr/lib/python3/dist-packages/sphinx/builders/__init__.py__init__zBuilder.__init__O   s   jj{{jj..$//"%(&&t'='='+'>'>	@$'JJ!jj((			dkk"		dii 		kDKK/0		lTYY./ ') !!%    c                L    | j                   j                  j                  |       S )zReturn a class of translator.)r;   registryget_translator_classrK   argss     rL   rQ   zBuilder.get_translator_classm   s    xx  55d;;rN   c                P     | j                   j                  j                  | g| S )zReturn an instance of translator.

        This method returns an instance of ``default_translator_class`` by default.
        Users can replace the translator class with ``app.set_translator()`` API.
        )r;   rP   create_translatorrR   s     rL   rU   zBuilder.create_translatorq   s&     3txx  224?$??rN   c                     y)zoLoad necessary templates and perform initialization.  The default
        implementation does nothing.
        N rK   s    rL   initzBuilder.initz        	rN   c                    | j                   j                  r+ t        | j                   j                  d             | _        yddlm}  |       | _        y)z&Return the template bridge configured.ztemplate_bridge settingr   )BuiltinTemplateLoaderN)rA   template_bridger   	templatessphinx.jinja2gluer\   )rK   r\   s     rL   create_template_bridgezBuilder.create_template_bridge   sF    ;;&&F]4;;+F+F+DF HDN @24DNrN   Nc                    t         )zReturn the target URI for a document name.

        *typ* can be used to qualify the link characteristic for individual
        builders.
        NotImplementedError)rK   docnametyps      rL   get_target_urizBuilder.get_target_uri   s
     "!rN   c                X    t        | j                  |      | j                  ||            S )zReturn a relative URI between two source filenames.

        May raise environment.NoUri if there's no way to return a sensible URI.
        )r   rf   )rK   from_tore   s       rL   get_relative_urizBuilder.get_relative_uri   s.    
 D//6 //C8: 	:rN   c                    t         )aD  Return an iterable of output files that are outdated, or a string
        describing what an update build will build.

        If the builder does not output individual files corresponding to
        source files, return a string here.  If it does, return an iterable
        of those files that need to be written.
        rb   rX   s    rL   get_outdated_docszBuilder.get_outdated_docs   s
     "!rN   c                    g S )z;Return list of paths for assets (ex. templates, CSS, etc.).rW   rX   s    rL   get_asset_pathszBuilder.get_asset_paths   s    	rN   c                   t        | j                        }|j                  t        j                        D ]  }d|d   v rd|d   vr| j
                  D ]  }|d   j                  |d      }|s n t        |d         }|j                  |d         }|r.t        j                  t        d      | j                  |||       n,t        j                  t        d      | j                  ||       ||d<   n|d   }|| j                  j                  vr| j                  j                  |   d	   | j                  |<    y)
z+Pick the best candidate for all image URIs.?
candidates*Nuriz2a suitable image for %s builder not found: %s (%s))locationz-a suitable image for %s builder not found: %s   )r   r<   findallr   imager5   getsortedget_original_image_uriloggerwarningr   rE   rF   )rK   doctreerF   nodeimgtype	candidate	mimetypes	image_uris           rL   post_process_imageszBuilder.post_process_images   s@   dhh'OOEKK0 	CDd<(($|,,#99 G $\ 2 6 6w EI 
 !'tL'9 :I & = =d5k JI r +4 (5'+yy)YQU ' W r*Y'Z'+yy)d ' L'U K	/%)XX__Y%?%BDKK	"5	CrN   c                     j                   j                  sy d fd}t        j                  t	        t        d            |z          t        |t        d      dt        |       j                  j                  |      D ]<  }|j                   j                   j                   j                   j                         > y )Nc                    t        | j                  j                  j                        j	                  t
        j                  t              S N)r   mo_pathr<   r7   replacer   sepr   )catrK   s    rL   cat2relpathz-Builder.compile_catalogs.<locals>.cat2relpath   s-    3;;8@@3OOrN   zbuilding [mo]: writing output... 	darkgreen)stringify_func)r   r   returnstr)rA   gettext_auto_buildr{   infor   r   r   lenr;   	verbositywrite_molanguage gettext_allow_fuzzy_translations)rK   catalogsmessager   catalogs   `    rL   compile_catalogszBuilder.compile_catalogs   s    {{--	P 	D-./'9:&x4H1I;'*8}dhh6H6H6AC 	KG T[[11![[IIK	KrN   c                J   t        | j                  | j                  j                  | j                  j                  | j                  j
                        }t        d      t        t        |j                              z  }| j                  t        |j                        |       y )Nzall of %d po files)r   r7   rA   locale_dirsr   source_encodingr   r   listr   r   set)rK   repor   s      rL   compile_all_catalogszBuilder.compile_all_catalogs   so     dkk.E.E!%!5!5t{{7R7RT)*Sdmm1D-EEc$--0':rN   c                    d fd}t               }t        t        ||            }t         j                   j                  j
                   j                  j                   j                  j                        }|j                  D ]3  }|j                  |v s|j                         s#|j                  |       5 t        d      t        |      z  } j                  ||       y )Nc                    j                   j                  t        j                  |             }|r t	        |j
                  j                        S y r   )r<   path2docr   abspathr   rA   gettext_compact)fpathrd   rK   s     rL   	to_domainz4Builder.compile_specific_catalogs.<locals>.to_domain   s=    hh''U(;<G($++2M2MNNrN   z*targets for %d po files that are specified)r   r   r   
str | None)r   mapr   r7   rA   r   r   r   r   domainis_outdatedrC   r   r   r   )rK   specified_filesr   r   domainsr   r   r   s   `       rL   compile_specific_catalogsz!Builder.compile_specific_catalogs   s    	 5c)_56 dkk.E.E!%!5!5t{{7R7RT}} 	&G~~(W-@-@-BW%	& ABS]Rh0rN   c                \   t        | j                  | j                  j                  | j                  j                  | j                  j
                        }|j                  D ch c]  }|j                         s| }}t        d      t        |      z  }| j                  ||       y c c}w )Nz,targets for %d po files that are out of date)r   r7   rA   r   r   r   r   r   r   r   r   )rK   r   cr   r   s        rL   compile_update_catalogszBuilder.compile_update_catalogs   s     dkk.E.E!%!5!5t{{7R7RT#}}@!A@@CDs8}Th0 As   #B)9B)c                ^    | j                          | j                  dt        d      d       y)zBuild all source files.Nzall source filesall)summarymethod)r   buildr   rX   s    rL   	build_allzBuilder.build_all   s&    !!#

4$6!7
FrN   c                h   g }|D ]  }t        j                  t        j                  |            }t        j                  |      s t        j                  t        d      |       `|j                  t        | j                              s t        j                  t        d      |       | j                  j                  |      }|s t        j                  t        d      |       |j                  |        | j                  |       | j                  |dt        d      t        |      z         y)z>Only rebuild as much as needed for changes in the *filenames*.z.file %r given on command line does not exist, zIfile %r given on command line is not under the source directory, ignoringz?file %r given on command line is not a valid document, ignoringspecificz%%d source files given on command line)r   r   N)r   normpathr   isfiler{   r|   r   
startswithr   r7   r<   r   appendr   r   r   )rK   	filenamesdocnamesfilenamerd   s        rL   build_specificzBuilder.build_specific   s    ! 	%H}}T\\(%;<H;;x(r"RS')&&s4;;'78r #?  @AIKhh''1Gr #7  89ACOOG$'	%* 	&&y1

8JEFXV 	 	XrN   c                    | j                          | j                         }t        |t              r| j	                  dg|       yt        |      }| j	                  |t        d      t        |      z         y)z8Only rebuild what was changed or added since last build.__all__z0targets for %d source files that are out of date)r   N)r   rl   
isinstancer   r   r   r   r   )rK   to_builds     rL   build_updatezBuilder.build_update  sg    $$&))+h$JJ	{H-H~HJJx!"TU8} %  &rN   c                   |r7t         j                  t        t        d      | j                  z        |z          t        j                         5  t        | j                               }ddd       t              }t         j                  t        t        d            d       | j                  j                  | j                  |      D ]  }|j                  |        t        |      |z
  }|r t         j                  t        d      |       nt         j                  t        d             |rdd	lm} t!        t        d
            5  t#        t%        j&                  | j(                  |      d      5 }	t+        j,                  | j                  |	t*        j.                         ddd       ddd       t0        j2                  | j                  _        t!        t        d            5  | j                  j7                          ddd       n/|dk(  r*|s(t         j                  t        t        d                   yt0        j8                  | j                  _        |r(|dgk7  r"t        |      | j                  j:                  z  }t<        rF| j                  j>                  dkD  r-| j@                  r!| j                  jC                  d      | _"        nd| _"        tG               | _$        | jK                  |tM        |      |       | jO                          | jH                  j'                          y# 1 sw Y   xY w# 1 sw Y   xY w# 1 sw Y   xY w# 1 sw Y   #xY w)zjMain build method.

        First updates the environment, and then calls
        :meth:`!write`.
        zbuilding [%s]: Nz"looking for now-outdated files... Tnonlz%d foundz
none foundr   )ENV_PICKLE_FILENAMEzpickling environmentwbzchecking consistencyupdatezno targets are out of date.r   ru   writeF)(r{   r   r   r   rE   r   pending_warningsr   readr   r<   check_dependentsr;   rC   sphinx.applicationr   r   openr   joinr:   pickledumpHIGHEST_PROTOCOLr   CONSISTENCY_CHECKphasecheck_consistency	RESOLVING
found_docsr#   parallelallow_parallelis_parallel_allowedrI   r!   rJ   r   r   finish)
rK   r   r   r   updated_docnamesdoccountrd   outdatedr   fs
             rL   r   zBuilder.build)  s    KKR 12TYY>?'IJ %%' 	0"499;/	0 '(D@ABNxx00;KL 	*G  )	*'(83KK:1KK<()>!"%;"<= B4??4GH$OBSTDHHa)@)@AB B
 (99DHHN!"%;"<= -**,- - !(D$A!BCD#--
 YK/8}txx':'::H $(("3"3a"7D<O<O#xx;;GDD$D (M 	

8T"23V< 	 	 s	0 	0 B B B B- -s<   L-
+M50L:%M(M-L7:M	?MMMc                    t         j                  t        t        d            d       | j                  j                  | j                  |        | j                  j                  t        k7  }| j                  j                  |      \  }}}| j                  j                  d| j                  |||      D ]3  }|j                  t        |      | j                  j                  z         5 |s|r<|j                  | j                  j                  | j                  j                  z         |r]t!        j"                  | j                  j                  d      | j                  j$                  xs dz   }t         j                  d|d       t         j                  t        d      t'        |      t'        |      t'        |             |D ]D  }| j                  j                  d| j                  |       | j                  j)                  |       F t+        ||z        }| j                  j                  d	| j                  |       t,        rCt'        |      d
kD  r5| j.                  j0                  dkD  r| j.                  j3                  d      }	nd}	|	r(| j5                  || j.                  j0                         n| j7                  |       | j                  j8                  | j                  j:                  vr;t=        d| j                  j?                  | j                  j8                        z        | j                  j                  d| j                        D ]  }
|
|jA                  |
        t        | j                  _        t+        |      S )z(Re-)read all files new or changed since last update.

        Store all environment docnames in the canonical format (ie using SEP as
        a separator in place of os.path.sep).
        zupdating environment: Tr   zenv-get-outdatedr0   z[%s] z %s added, %s changed, %s removedenv-purge-doczenv-before-read-docs   ru   r   Fnproczroot file %s not foundzenv-updated)!r{   r   r   r   r<   
find_filesrA   config_statusr
   get_outdated_filesr@   emitr   r   r   glob_toctreesr	   rx   config_status_extrar   	clear_docry   r#   r;   r   r   _read_parallel_read_serialroot_docall_docsr   doc2pathextend)rK   updatedaddedchangedremoveddocsreasonrd   r   par_okretvals              rL   r   zBuilder.reads  s    	D456TBDKK.88))Y6"&(("="=g"Fw KK$$%75'SZ[ 	<DNN3t9txx':'::;	<
 GNN48811DHH4G4GGH+//0F0FKxx339r;FKKdK3B9:JGc'l	<  	(GKK_dhh@HHw'	(
 %'/*/8D #h-!"38I8IA8MXX11&9FF0A0ABh';;txx'8'886"hh//0D0DEF G G kk&&}dhh? 	(F!'	(
 "+hrN   c                   t        |t        d      dt        |      | j                  j                        D ]U  }| j
                  j                  d| j                  |       | j                  j                  |       | j                  |       W y )Nreading sources... purpler   )
r   r   r   r;   r   r@   r   r<   r   read_doc)rK   r   rd   s      rL   r   zBuilder._read_serial  sp    &x4I1JH'*8}dhh6H6HJ 	#G KK_dhh@HHw'MM'"	#rN   c                   	 t        ||      }t        |t        d      dt        |       j                  j
                        	|D ]D  } j                  j                  d j                  |        j                  j                  |       F d fd}d	 fd}t        |      }|D ]  }|j                  |||        |j                          t        j                  d       y )	Nr  r  r   c                    j                   j                  _         | D ]  }j                  |d        t        j                  j                  t        j
                        S )NF_cache)r;   r<   r  r   dumpsr   )r   rd   rK   s     rL   read_processz,Builder._read_parallel.<locals>.read_process  sN    88DHHL 5ge45 <<&*A*ABBrN   c                    t        j                  |      }j                  j                  | |j                         t               y r   )r   loadsr<   merge_info_fromr;   next)r   otherenvr<   progressrK   s      rL   mergez%Builder._read_parallel.<locals>.merge  s2    ,,x(CHH$$T39NrN   r0   )r   r4   r   bytes)r   r4   r  r  r   None)r"   r   r   r   r;   r   r@   r   r<   r   r    add_taskr   r{   r   )
rK   r   r   chunksrd   r	  r  taskschunkr  s
   `        @rL   r   zBuilder._read_parallel  s    Xu- #62.C+Dh#&v;0B0BD   	(GKK_dhh@HHw'	(	C	 e$ 	7ENN<6	7 	

BrN   r  c               v   | j                   j                  |       t        j                  | j                  d      }t        j
                  |      r| j                   j                  |       | j                   j                  |      }t        | j                  j                  j                  |      }| j                  j                  j                  | j                  |      }t               |j                  _        t#        | j                         5  t%        j&                  || j                  j&                        5  t)        j*                  dt-        |             |j/                  |       |j1                          |j2                  }ddd       ddd       t5        j6                         dz  | j                   j8                  |<   | j                   j:                  j=                          | j                   j>                  j=                          | jA                  ||       y# 1 sw Y   xY w# 1 sw Y   xY w)z>Parse a file and add/update inventory entries for the doctree.zdocutils.confsphinx)source_pathNi  r  )!r<   prepare_settingsr   r   r8   r   note_dependencyr   r   r;   rA   source_suffixrP   get_publisherr   settingsrecord_dependenciesr   r   default_rolecodecsregister_errorr   
set_sourcepublishdocumenttimetime_nsr   	temp_dataclearref_contextwrite_doctree)rK   rd   r  docutilsconfr   filetype	publisherr}   s           rL   r  zBuilder.read_doc  s   !!'* yy?;;|$HH$$\288$$W- = =xHHH%%33DHHhG	 2@1A	.DHH% 	)s'7'7AYAY'Z 	)!!(";G"DF   X 6((G	) 	) &*\\^u%<'" 	  """$7GF;!	) 	) 	) 	)s%   +H/:AH#H/#H,	(H//H8c               
   d|_         d|_        |j                  j                         |_        d|j                  _        d|j                  _        d|j                  _        t        j                  | j                  |dz         }t        t        j                  |             t        |d      5 }t        j                  ||t        j                         ddd       |r|| j
                  j                   |<   yy# 1 sw Y   &xY w)zWrite the doctree to a file.Nz.doctreer   )reportertransformerr  copywarning_streamr<   r  r   r   r:   r   dirnamer   r   r   r   _write_doc_doctree_cache)rK   rd   r}   r  doctree_filenamer   s         rL   r+  zBuilder.write_doctree  s    
  " #++002*.'#/3,99T__g
6JK$,,/01"D) 	=QKKF$;$;<	= 9@DHH--g6 	= 	=s   .&C99Dc                   ||dgk(  r| j                   j                  }|dk(  rt        |      t        |      z  }nt        |      }t        j	                  t        d      dj                  t        |                   t        |      D ]_  }| j                   j                  j                  |t                     D ],  }|| j                   j                  v s|j                  |       . a |j                  | j                  j                         t        t        d            5  | j                  |       d d d        t        t        d            5  | j!                          d d d        | j"                  r4| j%                  t        |      | j&                  j(                  dz
         y | j+                  t        |             y # 1 sw Y   xY w# 1 sw Y   pxY w)	Nr   r   zdocnames to write: %sz, zpreparing documentszcopying assetsru   r   )r<   r   r   r{   debugr   r   ry   r   files_to_rebuildrx   rC   rA   r   r   prepare_writingcopy_assetsrI   _write_parallelr;   r   _write_serial)rK   build_docnamesr   r   r   rd   
tocdocnames          rL   r   zBuilder.write  s    !^	{%B!XX00NX>*S1A-BBH>*HR/0$))F8<L2MN H~ 	-G"hh77;;GSUK -
!4!44LL,-	- 	T[[))*b!678 	+  *	+ b!123 		    !1'+xx'8'81'< ! > vh/0	+ 	+	 	s   $GGGGc           	        t        j                         5  t        |t        d      dt	        |      | j
                  j                        D ]  }t        j                  | j
                  _	        | j                  j                  ||       }t        j                  | j
                  _	        | j                  ||       | j                  ||        	 d d d        y # 1 sw Y   y xY w)Nr   r   )r   r   r   r   r   r;   r   r   r   r   r<   get_and_resolve_doctreeWRITINGwrite_doc_serialized	write_doc)rK   r   rd   r}   s       rL   r=  zBuilder._write_serial=  s    %%' 	1*8R8L5M{+.x=$((:L:LN 1!+!5!5((::7DI!+!3!3))'7;w01	1 	1 	1s   B9CC!c                    d fd}|d   |dd  }}t         j                   j                  _         j                  j                  |       }t         j                   j                  _         j                  ||        j                  ||       t        |      }t        ||      }t        |t        d      dt        |       j                  j                        d	fd}t         j                   j                  _        |D ]_  }	g }
|	D ]C  } j                  j                  |       } j                  ||       |
j                  ||f       E |j!                  ||
|       a |j#                          t$        j'                  d       y )
Nc                |    t         j                  j                  _        | D ]  \  }}j	                  ||        y r   )r   rB  r;   r   rD  )r   rd   r}   rK   s      rL   write_processz.Builder._write_parallel.<locals>.write_processH  s6    '//DHHN$( 1 w01rN   r   ru   r   r   c                    t               y r   )r  )rS   resultr  s     rL   on_chunk_donez.Builder._write_parallel.<locals>.on_chunk_done]  s
    NrN   r0   )r   z list[tuple[str, nodes.document]]r   r  )rS   zlist[tuple[str, NoneType]]rI  r-   r   r  )r   r   r;   r   r<   rA  rB  rC  rD  r    r"   r   r   r   r   r   r  r   r{   r   )rK   r   r   rG  	firstnamer}   r  r  rJ  r  argrd   r  s   `           @rL   r<  zBuilder._write_parallelG  sO   	1 'qk8AB<8	#--((229dC#++!!)W5y'*e$Xu- #62.B+C[#&v;0B0BD	 $-- 	>EC  /((::7DI))'7;

GW-./ NN=#}=	> 	

BrN   c                    t         )z?A place where you can add logic before :meth:`write_doc` is runrb   )rK   r   s     rL   r:  zBuilder.prepare_writingm      !!rN   c                     y)zBWhere assets (images, static files, etc) are copied before writingNrW   rX   s    rL   r;  zBuilder.copy_assetsq  s    rN   c                    t         )z5Where you actually write something to the filesystem.rb   rK   rd   r}   s      rL   rD  zBuilder.write_docu  rN  rN   c                     y)zoHandle parts of write_doc that must be called in the main process
        if parallel build is active.
        NrW   rQ  s      rL   rC  zBuilder.write_doc_serializedy  rZ   rN   c                     y)zWFinish the building process.

        The default implementation does nothing.
        NrW   rX   s    rL   r   zBuilder.finish      
 	rN   c                     y)zQCleanup any resources.

        The default implementation does nothing.
        NrW   rX   s    rL   cleanupzBuilder.cleanup  rT  rN   c                    	 | j                    d| }t        | j                  |      S # t        $ r  | d| }t        | j                  |      cY S w xY w)zReturn a builder specific option.

        This method allows customization of common builder settings by
        inserting the name of the current builder in the option key.
        If the key does not exist, use default as builder name.
        _)rE   getattrrA   AttributeError)rK   optiondefaultoptnames       rL   get_builder_configzBuilder.get_builder_config  s\    	11VH-G4;;00 	1 	6(+G4;;00	1s   &) &AA)r;   r)   r<   r   r   r  )rS   r   r   r1   )rS   r   r   znodes.NodeVisitor)r   r  r   )rd   r   re   r   r   r   )rh   r   ri   r   re   r   r   r   )r   zstr | Iterable[str])r   r4   )r}   r(   r   r  )r   zset[CatalogInfo]r   r   r   r  )r   r4   r   r  )r   r4   r   r  )Nr   )r   Iterable[str] | Noner   r   r   r   r   r  )r   r4   r   r  )r   r4   r   intr   r  )rd   r   r  boolr   r  )rd   r   r}   nodes.documentr  ra  r   r  )r   )r>  r_  r   Sequence[str]r   r   r   r  )r   rc  r   r  )r   rc  r   r`  r   r  )r   zset[str]r   r  )rd   r   r}   rb  r   r  )r[  r   r\  r   r   r   )0__name__
__module____qualname____doc__rE   rD   epilog__annotations__r>   r?   r   use_message_catalogr5   supported_remote_imagessupported_data_uri_imagesrM   rQ   rU   rY   r`   rf   rj   rl   rn   r   r   r   r   r   r   r   r   r   r   r   r   r  r+  r   r=  r<  r:  r;  rD  rC  r   rV  r^  rW   rN   rL   r/   r/   .   s   
 DF F 65N (*9)# %&<<@5":"CBK;1&1GX<&  #	H!&H! H! 	H!
 
H!T> @# D 8< <D HLAA%3A@DA	A< 	#1,#1 (#1 	#1
 
#1J1$L""1rN   r/   )Lrg  
__future__r   r!  r   r&  osr   typingr   r   docutilsr   docutils.utilsr   sphinx.environmentr	   r
   r   !sphinx.environment.adapters.assetr   sphinx.errorsr   sphinx.localer   sphinx.utilr   r   r   r   r   sphinx.util.build_phaser   sphinx.util.consoler   sphinx.util.displayr   r   sphinx.util.docutilsr   sphinx.util.i18nr   r   r   sphinx.util.osutilr   r   r   r   sphinx.util.parallelr    r!   r"   r#   r  r$   r%   collections.abcr&   r'   docutils.nodesr(   r   r)   sphinx.configr*   sphinx.eventsr+   sphinx.util.tagsr,   sphinx.util.typingr-   	getLoggerrd  r{   r/   rW   rN   rL   <module>r     s    * "     %  ) Q Q : %  \ \ . $ A / N N D D \ \  2#)$*%+ 
		8	$m	1 m	1rN   