}c8dddlZddlmZmZmZmZmZddlmZddl m Z m Z ddl m Z ddlmZddlmZddlmZdd lmZdd lmZdd lmZmZdd lmZmZmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z'erddl(m)Z)ej*dZ+ej,e-Z.de/de0fdZ1Gdde Z2Gdde Z3GddeZ4Gdde Z5Gdde Z6Gd d!e Z7Gd"d#e Z8Gd$d%e Z9Gd&d'ee Zd(d)dee/effd*Z:dS)+N) TYPE_CHECKINGAnyDictListcast)nodes)ElementNode) directives)BaseAdmonition)Class)Include)addnodes) VersionChange)___) docname_joinloggingurl_re)SphinxDirective)Matcher patfilter)explicit_title_re) OptionSpec)Sphinxz .*[*?\[].*argumentreturnc(|sdSt|S)Ni)int)rs 7lib/python3.11/site-packages/sphinx/directives/other.pyint_or_nothingr!s s x==c eZdZdZdZdZdZdZee j e j e j e j e j e e j e j d ZdeefdZdejdeefd Zd S) TocTreez Directive to notify Sphinx about the hierarchical structure of the docs, and to include a table-of-contents like tree in the current document. TrF) maxdepthnamecaptionglobhidden includehiddennumbered titlesonlyreversedrcntj}|jj|d<g|d<g|d<|jdd|d<|jd|d<d|jv|d<d|jv|d<d |jv|d <|jd d |d <d |jv|d <||tjd g}| || || |}| ||S)Nparententries includefilesr%r'r(r)r*r+rr,ztoctree-wrapper)classes) rtoctreeenvdocnameoptionsgetset_source_inforcompoundappendadd_name parse_content)selfsubnode wrappernoderets r runz TocTree.run7sD"$$ H,  "$"l..z2>> !\--i88  DL0$ 4#2dl#B "l..z1==  , <  W%%%n.?-@AAA 7### k"""  )) ; r"r4c&|jj}|jj}||jjg}t|jj}|j D]}|stj |}|drt |r|stj |st|jj|}tt!||} | D]O} || |dd| f|d| P| s*t$t)d|| |r-|d} |d} | } n|x} } d} |D]1} | | r| dt/|  } n2t|jj| } tj | s| dkr|d| | f| |jjvr||j| drt)d }d }nt)d }d }t$|| d |||jT| |vr|| n*t$t)d| ||d| | f|d| d|jvrJt7t9|d|d<t7t9|d|d<|S)Nr(r0r1z2toctree glob pattern %r didn't match any documentslocationr>z2toctree contains reference to excluded document %rexcludedz5toctree contains reference to nonexisting document %r not_readabletoc)typesubtyperEz%duplicated entry found in toctree: %sr-)config source_suffixr5 found_docscopyremover6rexclude_patternscontentrmatchglob_rerrsortedrr;loggerwarningrgroupendswithlendoc2path note_rereadr7listr-)r>r4suffixes all_docnamesrArHentryexplicitpatnamedocnamesr6reftitlesuffixmessagerLs r r=zTocTree.parse_contentOs;,x*//11 DH,---4;788\4 <4 >>N+227;;;;<NN2&[#\#\#(7#<<<!"..++C$NN1--E!GG$))C' E&F''//")-CKK<-"8'tx'7AA<$$<v <I&--ucl;;;;DH$77<x 1 1'4 @ @AA1"$%Y"Z"Z","$%\"]"]"0NN7G%,3#555H((****,.9$++G4444r*Q'R'RT[07'999I&--ug.>???N+227;;;;  % N!%hwy/A&B&B!C!CGI &*8GN4K+L+L&M&MGN # r"N)__name__ __module__ __qualname____doc__ has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacerr unchangedunchanged_requiredflagr! option_specrr rBrr4r=r"r r$r$"sK %$0/#" oO  KT$Z0DX%5D$t*DDDDDDr"r$cJeZdZUdZdZdZdZdZiZe e d<de e fdZ d S) Authorz Directive to give the name of the author of the current document or section. Shown in the output only if the show_authors option is on. FrGrTrtrc|jjsgStjd}tj}||z }|jdkrt d}nE|jdkrt d}n*|jdkrt d}nt d }|tj|z }|j |j d |j \}}| ||g}||z }|S) NF) translatable sectionauthorzSection author: moduleauthorzModule author: codeauthorz Code author: zAuthor: r) rM show_authorsr paragraphemphasisr&rTextstate inline_text argumentslinenoextend)r>paraemphtextinodesmessagesrAs r rBz Author.runs{' IU;;;~   9 ' !'((DD Y. ( !&''DD Y, & !_%%DDZ==D  4   :11$.2CT[QQ F& x r"Nrirjrkrlrmrnrorprtr__annotations__rr rBrur"r rwrwshK $ K   T$Zr"rwc eZdZdZejZdS)SeeAlsozB An admonition mentioning things to look at as reference. N)rirjrkrlrseealso node_classrur"r rrs"!JJJr"rcJeZdZUdZdZdZdZdZiZe e d<de e fdZ d S) TabularColumnszL Directive to give an explicit tabulary column definition to LaTeX. FrGrTrtrcxtj}|jd|d<|||gS)Nrspec)rtabular_col_specrr9r>nodes r rBzTabularColumns.runs;(**~a(V  T"""v r"Nrrur"r rrshK $ K   T$Zr"rcJeZdZUdZdZdZdZdZiZe e d<de e fdZ d S) Centeredz; Directive to create a centered line of bold text. FrGrTrtrc|jsgStj}|j|jd|j\}}|||g}||z }|S)Nr)rrcenteredrrrr)r>r?rrrAs r rBz Centered.runsk~ I#,..:11$.2CT[QQv") x r"Nrrur"r rrshK $ K    T$Z      r"rcJeZdZUdZdZdZdZdZiZe e d<de e fdZ dS) Acksz( Directive for a list of names. TrFrtrctj}|jj|_|j|j|j|t|jdks%t|jdtj s>%)X%5t{$C  E E EIv r"Nrrur"r rrshK % K    T$Z      r"rcNeZdZUdZdZdZdZdZdeiZ e e d<de e fdZd S) HListz@ Directive for a list that gets compacted horizontally. TrFcolumnsrtrc.|jdd}tj}|jj|_|j|j|j|t|j dks%t|j dtj srrfulllistnpercolnmoreindexnewnodecolumnendindexrs r rBz HList.runs<##Iq11   +   d.A4HHH t}   " *T]15E5:5F+H+H  NN2>??%)X%5t{$C  E E EI=#H x88.""!(mm Hoo  F% L1WMH+--K 8,U8^< rrsurrounding_title_stylessurrounding_section_levelr current_depthr/ title_style nested_depthn_sects_to_raise_is r rBzOnly.run+s} +  T"""~a(V JO#'#4 $($6! ; J # #DL$2E$(t $ = = =,L, $  O+CC  )  v,!9D !:D  +MZ&F '"  ' Q M&q/K788L66 K7==kJJ  -|;a? %-):;;F,-- + +=+#]F MM$    8D !:D  !9D !:D  : : : :s3A F B5FF!Nrrur"r rr!shK $ K   -;T$Z-;-;-;-;-;-;r"rc4eZdZdZdeeffd ZxZS)rz Like the standard "Include" directive, but interprets absolute paths "correctly", i.e. relative to source directory. rc|jddr@|jddr tS|j|jd\}}||jd<|j|tS)Nr<>)r startswithrZsuperrBr5 relfn2path note_included)r> rel_filenamefilename __class__s r rBz Include.runas >!  ' ' , , ! >!  % %c * * !77;;== !%!4!4T^A5F!G!G h$q x(((ww{{}}r")rirjrkrlrr rB __classcell__)rs@r rr[sR T$Zr"rapprctjdttjdttjdttjdttjdttjdt tjdt tjdttjd ttjd ttjd ttjd ttjd tddddS)Nr4rzr{r|rtabularcolumnsrrrrincludecssclassz rst-classbuiltinT)versionparallel_read_safeparallel_write_safe) r register_directiver$rwrrrrrrrr )rs r setuprls!)W555!/6:::!.&999!,777!)W555!"2NCCC!*h777!&$///!'5111!&$///!)W555!*e444!+u555"#  r");retypingrrrrrdocutilsrdocutils.nodesr r docutils.parsers.rstr +docutils.parsers.rst.directives.admonitionsr $docutils.parsers.rst.directives.miscr r BaseIncludesphinxrsphinx.domains.changesetr sphinx.localerr sphinx.utilrrrsphinx.util.docutilsrsphinx.util.matchingrrsphinx.util.nodesrsphinx.util.typingrsphinx.applicationrcompilerU getLoggerrirWrrr!r$rwrrrrrrrrur"r rso 77777777777777((((((((++++++FFFFFF666666GGGGGG222222555555555500000033333333//////))))))*)))))) "*] # #  8 $ $SS qqqqqoqqqh_D"""""n"""_",?,"""""O"""J7;7;7;7;7;?7;7;7;tk?"xDcNr"