o Ni@@sddlmZddlZddlmZmZddlmZddlm Z m Z m Z m Z ddl mZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZddl m!Z!m"Z"m#Z#ddl$m%Z%ddl&m'Z'm(Z(ddl)m*Z*e rddl+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddl2m3Z3m4Z4e5dZ6e"7e8Z9d5ddZ:Gddde%Z;Gd d!d!e%ZGd&d'd'e%Z?Gd(d)d)e%Z@Gd*d+d+e%ZAGd,d-d-e%ZBGd.d/d/ee%Zd6d3d4ZCdS)7) annotationsN)abspathrelpath)Path) TYPE_CHECKINGAnyClassVarcast)nodes) directives)BaseAdmonition)Class)Include) StateMachine)addnodes)StandardDomain)___) docname_joinloggingurl_re)SphinxDirective)Matcher patfilter)explicit_title_re)Sequence)ElementNode)Sphinx)ExtensionMetadata OptionSpecz .*[*?\[].*argumentstrreturnintcCs|sdSt|S)Ni)r$)r!r%K/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/directives/other.pyint_or_nothing$sr'c @s^eZdZdZdZdZdZdZee j e j e j e j e j e j ee j e j d Zddd Zdd dZdS)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) maxdepthnameclasscaptionglobhidden includehiddennumbered titlesonlyreversedr# list[Node]cCst}|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 <||||tj d g|jddd}| || ||gS)Nparententries includefilesr)r,r-r.r/r0rr1ztoctree-wrapperr+r%)classes) rtoctreeenvdocnameoptionsgetset_source_info parse_contentr compoundappendadd_name)selfsubnode wrappernoder%r%r&runAs&     z TocTree.runr9addnodes.toctreeNonecsVttj|jj}|jj}|d}|jjB}| |t|}t |jj }|j D]}|s0q+t |} t|du} |rt|r| s| st||} tfddt|| D} | sftjtd||d| D]} | | |dd| f|d| qhq+| r| d }| d }|} n|}} d}|D]}| |r| |} nqt|| } | s|d kr|d||fq+| |vr|t|j| d rtd }d}ntd}d}tj|| d||d|jq+| |vr| | n tjtd| |d|d|| f|d| q+d|jvr)tt |d|d<tt |d|d<dSdS)z_ Populate ``toctree['entries']`` and ``toctree['includefiles']`` from content. r-Nc3s|] }|vr|VqdS)Nr%).0r;generated_docnamesr%r& rsz(TocTree.parse_content..z2toctree glob pattern %r didn't match any documentslocationr5r6rCFz2toctree contains reference to excluded document %rexcludedz5toctree contains reference to nonexisting document %r not_readabletoc)typesubtyperNz%duplicated entry found in toctree: %sr2)! frozensetr_virtual_doc_namesconfig source_suffixr:r; found_docscopyremoverexclude_patternscontentrmatchrglob_rersortedrloggerwarningrrAgroupendswith removesuffixr"doc2path note_rereadr<listr2)rCr9suffixescurrent_docnamer- all_docnamesfrozen_all_docnamesrQentryexplicit url_matchpat_name doc_namesr;reftitlesuffixmsgrUr%rJr&r?Zs                  zTocTree.parse_contentNr#r3)r9rGr#rH)__name__ __module__ __qualname____doc__ has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer$r unchanged class_optionunchanged_requiredflagr' option_specrFr?r%r%r%r&r(*s& r(c@8eZdZUdZdZdZdZdZiZde d<d d d Z 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. FrPrTClassVar[OptionSpec]rr#r3cCs|jjsgStjdd}t}||7}|jdkrtd}n|jdkr(td}n|jdkr2td}ntd }|t|7}||j d \}}| ||g}||7}|S) NF) translatable sectionauthorzSection author: moduleauthorzModule author: codeauthorz Code author: zAuthor: r) rX show_authorsr paragraphemphasisr*rText parse_inline argumentsextend)rCparaemphtextinodesmessagesretr%r%r&rFs$        z Author.runNrw rxryrzr{r|r}r~rr__annotations__rFr%r%r%r&rs  rc@seZdZdZejZdS)SeeAlsozB An admonition mentioning things to look at as reference. N)rxryrzr{rseealso node_classr%r%r%r&rs rc@r)TabularColumnszL Directive to give an explicit tabulary column definition to LaTeX. FrPrTrrr#r3cCs&t}|jd|d<|||gS)Nrspec)rtabular_col_specrr>)rCnoder%r%r&rFs zTabularColumns.runNrwrr%r%r%r&r  rc@r)Centeredz; Directive to create a centered line of bold text. FrPrTrrr#r3cCsB|jsgSt}||jd\}}|||g}||7}|S)Nr)rrcenteredrr)rCrDrrrr%r%r&rFs z Centered.runNrwrr%r%r%r&rrrc@s8eZdZUdZdZdZdZdZiZde d<d d d Z d S) Acksz( Directive for a list of names. TrFrrr#r3cCsX|}t|dkst|dtjs"tjtd|jj |j fdgSt j dg|RgS)NrPrz.. acks content is not a listrM) parse_content_to_nodeslen isinstancer bullet_listrbrcrr:r;linenoracks)rCchildrenr%r%r&rFs zAcks.runNrwrr%r%r%r&r rrc@s<eZdZUdZdZdZdZdZdeiZ de d<d d d Z d S)HListz@ Directive for a list that gets compacted horizontally. TrFcolumnsrrr#r3c Cs|jdd}|}t|dkst|dtjs)tjt d|j j |j fdgS|d}t t||\}}d}t}t||d<t|D]%}|||krQ|dn|} t} | |j|| 7} |td| 7}| }qF|gS) NrrOrPrz.. hlist content is not a listrMncolumnsr)r<r=rrrr rrbrcrr:r;rdivmodrhlistr"rangerhlistcol) rCrrfulllistnpercolnmoreindexnewnodecolumnendindexrr%r%r&rF0s(   z HList.runNrw) rxryrzr{r|r}r~rr$rrrFr%r%r%r&r#s  rc@s8eZdZUdZdZdZdZdZiZde d<d d d Z d S) OnlyzI Directive to only include text if the given tag(s) are enabled. TrPrrrr#r3c CsFt}|jj|_|||jd|d<|jj}|j}|j}g|_d|_zv|jj |j |j |dd|j}|rC|rC|d|vsC|jj sM|gW||_||_Sd}|jj }|r^|d7}|j }|sU|d8}|d}t |} ||vrs||} || d} ttj|jj }t| D]} |j r|j }q||gW||_||_S||_||_w)NrexprT) match_titlesrPrO)ronlystatedocumentr>rmemo title_styles section_level nested_parser^content_offsetr4rrr r rrrA) rCrrsurrounding_title_stylessurrounding_section_levelr current_depthr4 title_style nested_depthn_sects_to_raise_ir%r%r&rFSs^        zOnly.runNrwrr%r%r%r&rHrrcs"eZdZdZdfdd ZZS)rz Like the standard "Include" directive, but interprets absolute paths "correctly", i.e. relative to source directory. r#Sequence[Node]csd fdd }jjjjd r|j_jd d r)jd  d r)t Sj jd \}}|jd <j |t S)N include_lines list[str]sourcer"r#rHcszd|dd}ttt|jjd}jj}|g}jjj d||||d}| |dd}t j ||S)N )start include-readr)joinrrrr:srcdirr;appeventsemit splitlinesr insert_input state_machine)rrrpathr;argrCr%r& _insert_inputsz"Include.run.._insert_inputrr<>)rrrr"r#rH)r:rr listenersr=rrr startswithresuperrF relfn2path note_included)rCr rel_filenamefilename __class__rr&rFs     z Include.run)r#r)rxryrzr{rF __classcell__r%r%rr&rsrrrrcCstdttdttdttdttdttdttdttdttd ttd t td t td t td t ddddS)Nr9rrrrtabularcolumnsrrrrincludecssclassz rst-classbuiltinT)versionparallel_read_safeparallel_write_safe) r register_directiver(rrrrrrrrr )rr%r%r&setups"             r)r!r"r#r$)rrr#r)D __future__rreos.pathrrpathlibrtypingrrrr docutilsr docutils.parsers.rstr +docutils.parsers.rst.directives.admonitionsr $docutils.parsers.rst.directives.miscr r BaseIncludedocutils.statemachinersphinxrsphinx.domains.stdr sphinx.localerr sphinx.utilrrrsphinx.util.docutilsrsphinx.util.matchingrrsphinx.util.nodesrcollections.abcrdocutils.nodesrrsphinx.applicationrsphinx.util.typingrr compiler` getLoggerrxrbr'r(rrrrrrrrr%r%r%r&sJ                 #%>2