O&ivoUdZddlZddlZddlZddlmZddlmZddlmZddlmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZddlZddlmZdd lmZdd lmZdd lmZdd lmZdd lm Z ddl!m"Z"ddl#m$Z$m%Z%m&Z&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1m2Z2m3Z3ddl4m5Z5ddl6m7Z7m8Z8ddl9m:Z:ddl;mm?Z?ddl@mAZAe3jBeCZDddddddd dd!dddd"dgd#ZEe eFe feGd$<ejHdd%d&krdeEd'<d(ZId)ZJd%ZKd*ZLd+ZMeKe+d,eLe+d-eMe+d.iZNde:d/ZOe eFeePe ffeGd0<e rmdd1lQmRZRdd2lSmTZTmUZUdd3lVmWZWdd4lXmYZYdd5lZm[Z[dd6l\m]Z]dd7l^m_Z_dd8l`maZadd9lbmcZcdd:ldmeZedd;lfmgZgddllmmZmGd?d@eReFe fZnneoZnGdAdBZpdS)CzGlobal creation environment.N) defaultdict)copy)datetime)path) TYPE_CHECKINGAnyCallableDict GeneratorIteratorListOptionalSetTupleUnion)nodes)Node)addnodes)Config)RemovedInSphinx60Warning)Domain)TocTree)BuildEnvironmentError DocumentErrorExtensionError SphinxError) EventManager)__)Project)SphinxTransformer) DownloadFilesFilenameUniqDictlogging)LoggingReporter)CatalogRepositorydocname_to_domain)is_translatable) canon_pathos_path)Sphinx)BuilderidlinkFTzhttps://peps.python.org/z&https://datatracker.ietf.org/doc/html/z utf-8-sig)auto_id_prefix image_loadingembed_stylesheetcloak_email_addresses pep_base_urlpep_references rfc_base_urlrfc_referencesinput_encodingdoctitle_xformsectsubtitle_xformsection_self_link halt_levelfile_insertion_enabledsmartquotes_localesdefault_settings)r embed_images9z new configzconfig changedzextensions changed)nonetextversioning_conditions)MutableMapping)Literaloverload)CDomain)ChangeSetDomain)CitationDomain) CPPDomain) IndexDomain)JavaScriptDomain) MathDomain) PythonDomain) ReSTDomain)StandardDomain)DurationDomain) TodoDomainc\eZdZededdefdZededdefdZededdefdZeded de fd Zeded de fd Zeded de fdZededde fdZededde fdZededdefdZededdefdZededdefdZededdefdZededefdZdZdZdZdZd Zd!S)" _DomainsTypekeycreturncdSNselfrZs h/home/geonatureadmin/si_en_reseau/tutos/venv/lib/python3.11/site-packages/sphinx/environment/__init__.py __getitem__z_DomainsType.__getitem__es=@ScppcdSr^r_r`s rbrcz_DomainsType.__getitem__gsADrd changesetcdSr^r_r`s rbrcz_DomainsType.__getitem__isMPSrdcitationcdSr^r_r`s rbrcz_DomainsType.__getitem__kKN3rdindexcdSr^r_r`s rbrcz_DomainsType.__getitem__msEHSrdjscdSr^r_r`s rbrcz_DomainsType.__getitem__osGJsrdmathcdSr^r_r`s rbrcz_DomainsType.__getitem__qCF3rdpycdSr^r_r`s rbrcz_DomainsType.__getitem__srrrdrstcdSr^r_r`s rbrcz_DomainsType.__getitem__usBE#rdstdcdSr^r_r`s rbrcz_DomainsType.__getitem__wsFIcrddurationcdSr^r_r`s rbrcz_DomainsType.__getitem__yrkrdtodocdSr^r_r`s rbrcz_DomainsType.__getitem__{rrrdcdSr^r_r`s rbrcz_DomainsType.__getitem__}s363rdctr^NotImplementedErrorr`s rbrcz_DomainsType.__getitem__*=$=rdctr^r)rarZvalues rb __setitem__z_DomainsType.__setitem__s1D+Drdctr^rr`s rb __delitem__z_DomainsType.__delitem__rrdctr^rras rb__iter__z_DomainsType.__iter__s"55rdctr^rrs rb__len__z_DomainsType.__len__s!44rdN)__name__ __module__ __qualname__rKrJrLrcrOrMrNrPrQrRrSrTrUrVrWstrrrrrrr_rdrbrYrYds @73<@G@@@ @ D75>DiDDD D P7;#7POPPP P N7:#6N>NNN N H77#3H HHH H J74=J5EJJJ J F76?FzFFF F F74=F\FFF F E75>EjEEE E I75>InIII I N7:#6N>NNN N F76?FzFFF F 6366666 6===DDD===55544444rdrYceZdZUdZeed<dAdedfdZdefdZ d eddfd Z dBd Z d e ddfd Z d e ddfdZdeeefdeddfdZdeddfdZdeeddddddfdZdedeefdZdCdededefdZdAdedeedeeeffdZedeefdZd e ddddfd Zd!edeeeeeeeffd"Zddd#eede eddffd$Z!deddfd%Z"edefd&Z#dDd(ede$fd)Z%deddfd*Z&deddfd+Z'dEd,Z(d-ede)fd.Z*dede+j,fd/Z- dFdeddd1ee+j,d2ed3ede+j,f d4Z. dGdeddd6e/j0d7ed8e$d9ed:ed3edee1fd;Z2d1e+j,dZ4deeeeeffd?Z5dEd@Z6dS)HBuildEnvironmentz The environment in which the ReST files are translated. Stores an inventory of cross-file targets and provides doctree transformations to resolve links to them. domainsNappr*cd|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_ t|_ t|_||jd<i|_t#t$|_t#t$|_t%|_t#t,|_i|_i|_i|_i|_i|_i|_i|_i|_t%|_ t%|_!i|_"tG|_$tK|_&i|_'i|_(i|_)|r|*|dStWj,dtZddS)Nenvz?The 'app' argument for BuildEnvironment() becomes required now.r?) stacklevel).r doctreedirsrcdirconfig config_statusconfig_status_extraeventsprojectversionversioning_conditionversioning_comparerYrr>rsettingsall_docsrset dependenciesincluded reread_alwaysdictmetadatatitles longtitlestocstoc_num_entriestoc_secnumberstoc_fignumberstoctree_includesfiles_to_rebuild glob_toctreesnumbered_toctrees domaindatar"imagesr!dlfilesoriginal_image_uri temp_data ref_contextsetupwarningswarnr)rars rb__init__zBuildEnvironment.__init__s# " "&(, $( $ '+ <@!(,$~~ )--// # e+- 2=S1A1A.9-=-= '*uu4?t3D3D /1 3524 /1 FHPR7957'*uu+.55,.)9(:(: &3oo 35*,,.  B JJsOOOOO M[2q B B B B B Brdr\ch|j}|did|S)z'Obtains serializable data for pickling.N)rrr)__dict__rupdate)rars rb __getstate__zBuildEnvironment.__getstate__s2=%%''D"T:::rdstatec:|j|dSr^)rr)rars rb __setstate__zBuildEnvironment.__setstate__s U#####rdc6|jr?|j|j|krtt d|jr,|j|jkrtt d|jr|j|j||_|j |_ |j |_ |j|_|j|_|j||_t|_ |j |D]}||j |j<|j D]}|||j||jdS)zSet up BuildEnvironment object.z%build environment version not currentzsource directory has changedN)rregistryget_envversionrrrrrestorerrrrYrcreate_domainsnamevaluesr_update_configr_update_settings)rardomains rbrzBuildEnvironment.setupsu < LDLCL,G,G,L,LLL'+R(S(STT T [ LT[CJ66'+I(J(JKK K < . K   - - -.j j { |22377 $~~ l11$77 / /F(.DL % %l))++  F LLNNNN CJ''' cj)))))rdrc2t|_d|_|j t|_n|jj|jkrt |_tt|jjt|jz }t|dkr |d}ndt|fz}d|d|_nQ| dD];}|j|j |j krt|_d|j d|_n<||_dS) z!Update configurations by new one.NrCrz%dz ()r) CONFIG_OKrrr CONFIG_NEW extensionsCONFIG_EXTENSIONS_CHANGEDsortedrlenfilterrrCONFIG_CHANGED)rarr extensionitems rbrzBuildEnvironment._update_configs&#% ; !+D   [ #v'8 8 8!:D DK*++c&2C.D.DDFFJ:!##&qM  C OO#55 2;))'=D $ $ e,,  ;ty)TZ77)7D&&:>)))/ED,E8  rdc|j|jd<|j|jd<|j|jd<|jdddS)zUpdate settings by new config.r7trim_footnote_reference_space language_code smart_quotesTN)source_encodingrrlanguage setdefault)rars rbrz!BuildEnvironment._update_settings5sP*0*@ &'9?9] 56)/ o&   66666rdmethodcomparect|r|}n(|tvrtd|zt|}|jd|fvrt t d||_||_dS)aXThis sets the doctree versioning method for this environment. Versioning methods are a builder property; only builders with the same versioning method can share the same doctree directory. Therefore, we raise an exception if the user tries to use an environment with an incompatible versioning method. zinvalid versioning method: %rNzdThis environment is incompatible with the selected builder, please choose another doctree directory.)callablerH ValueErrorrrrr)rarr conditions rbset_versioning_methodz&BuildEnvironment.set_versioning_method>s F   6II222 !@6!IJJJ-f5I  $T9,= = =b"67788 8%.!")rddocnamec||jvrP|j|d|j|d|j||jD]}||dS)z4Remove all traces of a source file in the inventory.N)rpoprrdiscardrr clear_doc)rarrs rbrzBuildEnvironment.clear_docUs dm # # M  gt , , , M  gt , , ,   & &w / / /l))++ & &F   W % % % % & &rddocnamesotherct|}|D]O}|j||j|<|j||j|<||jvr|j|P|jD]&\}}|||j|'|j d|||dS)zMerge global information gathered about *docnames* while reading them from the *other* environment. This possibly comes from a parallel build process. zenv-merge-infoN) rrrraddritemsmerge_domaindatarremit)rarrrr domainnamers rbmerge_info_fromz BuildEnvironment.merge_info_from_sx== 0 0G%*^G%z.J K K K K )45AAAAArdfilenamec6|j|S)zReturn the docname for the filename if the file is document. *filename* should be absolute or relative to the source directory. )rpath2docrars rbrzBuildEnvironment.path2docqs |$$X...rdTbasec8|j||S)zReturn the filename for the document name. If *base* is True, return absolute path under self.srcdir. If *base* is False, return relative path to self.srcdir. )rdoc2path)rarrs rbrzBuildEnvironment.doc2pathxs |$$Wd333rdct|}|ds|tjr |dd}nEt j||p|jd}t j||}tt j |t j t j|j |fS)a+Return paths to a file referenced from a document, relative to documentation root and absolute. In the input "filename", absolute filenames are taken as relative to the source dir, while relative filenames are relative to the dir of the containing document. /rCNF)r) r) startswithosseprdirnamerrjoinr(normpathr)rarrrel_fndocdirs rb relfn2pathzBuildEnvironment.relfn2paths8$$   s # # 1x':':26'B'B 1abb\FF\$--0G4<5:#0#<#<==FYvx00F4=0011 di V<<==? ?rdc|jjS)zcontains all existing docnames.)rrrs rb found_docszBuildEnvironment.found_docss|$$rdbuilderr+cZ |jj|jjz|z}|j||jj|jrt|j |jj |jj |jj }d|j D}|jD]H}t||jj}||vr&|j|||GdSdS#t&$r,}t)t+d|j |fz|d}~wwxYw)zYFind all source files in the source dir and put them in self.found_docs. c(i|]}|j|jSr_)rmo_path).0r[s rb z/BuildEnvironment.find_files..sGGGAAHaiGGGrdz"Failed to scan documents in %s: %rN)rexclude_patternstemplates_pathget_asset_pathsrdiscoverinclude_patternsuse_message_catalogr%r locale_dirsrrcatalogsr r&gettext_compactrrOSErrorrr) rarr  exclude_pathsrepomo_pathsrrexcs rb find_fileszBuildEnvironment.find_filess[ =![9![78$44667M L ! !-1M N N N* I(dk6M)-)=t{?Z\\GGGGG#IIG.w 8STTF)))'266x7GHHH I I II = = =#G H H!%c 2!3449< = =sC.C44 D*>'D%%D*config_changedc t|j|jz }t}t}|r |j}n!|jD]}||jvr1td|||=t j|j|dz}t j |s1td|||||j vr1td||||j|}t j | |}||krXtd|tj|tj|||k|j|D]} t j|j| } t j | s||nXt j | } | |kr||n'z#t"$r||YnwxYw|||fS)z&Return (added, changed, removed) sets.z[build target] added %r.doctreez[build target] changed %rz$[build target] outdated %r: %s -> %s)rrr loggerdebugrrrrisfilergetmtimerrutcfromtimestamprrr) rar removedaddedchangedrrmtimenewmtimedepdeppathdepmtimes rbget_outdated_filesz#BuildEnvironment.get_outdated_filessidm$$t6%%EE - OEE?) ) $-//LL!:GDDDIIg&&&9T_g 6JKK{8,,LL! 9>ctj|j|dz}t|d5}t j|}dddn #1swxYwY||j_t| ||_ |S)z:Read the doctree for a file from the pickle and return it.r"rbN) rrropenpickleloadrrr$rreporter)rarrfdoctrees rb get_doctreezBuildEnvironment.get_doctree7s9T_g .BCC (D ! ! %Qk!nnG % % % % % % % % % % % % % % %#*4==+A+ABBsAAAFrSprune_toctrees includehiddencL|||}||||tjD]V}t ||||||}||gA||W|S)zgRead the doctree from the pickle, resolve cross-references and toctrees and return it. N)prunerV)rTapply_post_transformsfindallrtoctreerresolve replace_self)rarr rSrUrV toctreenoderesults rbget_and_resolve_doctreez(BuildEnvironment.get_and_resolve_doctree@s ?&&w//G ""7G444#??8+;<< 1 1KT]]**7G[1?9F+HHF~((,,,,((0000rdrr[rXmaxdepth titles_onlycollapsec Tt|||||||||S)aResolve a *toctree* node into individual bullet lists with titles as items, returning None (if no containing titles are found) or a new node. If *prune* is True, the tree is pruned to *maxdepth*, or if that is 0, to the value of the *maxdepth* option on the *toctree* node. If *titles_only* is True, only toplevel document titles will be in the resulting tree. If *collapse* is True, all branches not containing docname will be collapsed. )rr\) rarr r[rXrarbrcrVs rbresolve_toctreez BuildEnvironment.resolve_toctree]s4t}}$$Wgw%-{H%244 4rd fromdocnamec2|||dSr^)rY)rarSrfr s rbresolve_referencesz#BuildEnvironment.resolve_referencesos ""7K88888rdcv t|j}||jd<t|}||||jj|||_n #||_wxYw|j d||dS)zApply all post-transforms.rzdoctree-resolvedN) rrr set_environmentadd_transformsrrget_post_transformsapply_transformsrr)rarSrbackup transformers rbrYz&BuildEnvironment.apply_post_transformsss $$.))F(/DN9 %+G44K  ' ' - - -  & &tx'8'L'L'N'N O O O  ( ( * * *#DNNVDN # # # # +Wg>>>>>s BB Bc \ t dttdtdtttttff fd i}djj}d}t|\}}|D]\}}|||g||<|}|}|}||dg||<|S)Nparentrr\c3HK||kr-ttd|dddS||fV|j|pgD]3}||D]$\}}|vr||fV|%4dS)Nz'self referenced toctree found. Ignored.toccircular)locationtypesubtype)r#warningrrrr9)rqrchild subparent subdocnameratraverse_toctree traverseds rbr|z.traverse_toctrees  r"KLL(/e'1333'/ ! ! ! MM' " " "/33G<<B 2 2-=-=gu-M-M22)Iz!22'3333! j1112 2 2rd)rrrr rrroot_docnext) ra relationsrprevdocrqr nextparentnextdocr|r}s ` @@rbcollect_relationsz"BuildEnvironment.collect_relationssEE  2SM 2,/ 2 eHSM3./ 0 2 2 2 2 2 2 2 2& ##D$+*>??x..#+  J"('7!;Ig GGFF$gt4 'rdctj|j}t |jD]Z}||jvrO||jjkr||vr!d|j |vr1t td|[|j D]}||jd|dS)zDo consistency checks.orphanz&document isn't included in any toctree)ruzenv-check-consistencyN)runionrrrrrrr~rr#rxrrcheck_consistencyrr)rarrrs rbrz"BuildEnvironment.check_consistencys355; 4 4 6 67dm,, 1 1Gd333dk222h&&t}W555r"KLL(/111l))++ ' 'F  $ $ & & & & 0$77777rdr^)rr*r\N)T)r)r\N)NTF)TrFFF)7rrr__doc__rY__annotations__rrr rrrrrrrrr boolrrr rrrrrpropertyrr rr0r r5r;rintrArCrFrHrrKrdocumentrTr`rr[rrerhrYrrr_rdrbrrsu \B\BHX.\B\B\B\B|d $$$4$$$$****@V47v7$7777*E#x-,@*4*TX****.&&&&&&BS B:LB%B*.BBBB$//#////4444434444??3?#?%PSUXPX/????&%CH%%%X%==)=====:7'7'%C#c(TWX[T\@\:]7'7'7'7'rHs3xIcSWY]oD^999999))))X)S#666666 1c 1d 1 1 1 1---- ZSZVZZZZ35>-1## %.)      <TYFK44s4Y4IY4#4694LP4"&4?C4PXY]P^4444$9%.9s9$-9269999?U^?c?d????""4T(3--@(@#A""""H888888rdr)qrrrOr collectionsrrrrtypingrrr r r r r rrrrdocutilsrdocutils.nodesrsphinxr sphinx.configrsphinx.deprecationrsphinx.domainsr#sphinx.environment.adapters.toctreer sphinx.errorsrrrr sphinx.eventsr sphinx.localersphinx.projectrsphinx.transformsr sphinx.utilr!r"r#sphinx.util.docutilsr$sphinx.util.i18nr%r&sphinx.util.nodesr'sphinx.util.osutilr(r)sphinx.applicationr*sphinx.buildersr+ getLoggerrr#r>rr__version_info__ ENV_VERSIONrrrrCONFIG_CHANGED_REASONrHrcollections.abcrItyping_extensionsrJrKsphinx.domains.crLsphinx.domains.changesetrMsphinx.domains.citationrNsphinx.domains.cpprOsphinx.domains.indexrPsphinx.domains.javascriptrQsphinx.domains.mathrRsphinx.domains.pythonrSsphinx.domains.rstrTsphinx.domains.stdrUsphinx.ext.durationrVsphinx.ext.todorWrYrrr_rdrbrs+""" ######'''''''''''''''''''''''''' 777777!!!!!!777777[[[[[[[[[[[[&&&&&&""""""//////@@@@@@@@@@000000AAAAAAAA------22222222())))))''''''  8 $ $!.<!"$$$sCx." RaR G++',^$    <  BB'((rr"677  ;;tCtX~!667 4......33333333((((((888888666666,,,,,,000000::::::......222222------111111222222******55555~c6k25555DLr8r8r8r8r8r8r8r8r8r8rd