}c'dZddlZddlmZmZmZmZmZmZm Z m Z ddl m Z ddl mZddlmZmZddlmZddlmZdd lm Z dd lmZmZmZdd lmZdd lmZerdd lm Z ej!dZ"ej!dZ#e dZ$de%de&fdZ'Gddeee$Z(GddeZ)GddeZ*dddee%effdZ+dS)z(Handlers for additional ReST directives.N) TYPE_CHECKINGAnyDictGenericListTupleTypeVarcast)nodes)Node) directivesroles)addnodes)desc_signature)docutils)DocFieldTransformerField TypedField)SphinxDirective) OptionSpec)Sphinxz\\\nz\\(.)TargumentreturncV|dSt|}|dkrtd|S)zS Check for an integer argument or None value; raise ``ValueError`` if not. Nrz(negative value; must be positive or zero)int ValueError)rvalues :lib/python3.11/site-packages/sphinx/directives/__init__.py optional_intr s=tH  19 IGHH H cneZdZUdZdZdZdZdZdej iZ e e d<gZ eee d<dZee d <dZee d <dZeje d <iZeeeeeffe d <d eeeeefffdZd eefdZdeded efdZdededed dfdZddZ dej!d dfdZ"ddZ#d ee$fdZ%dS)ObjectDescriptionz Directive to describe a class, function or similar object. Not used directly, but subclassed (in domain-specific directives) to add custom behavior. Trnoindex option_specdoc_field_typesNdomainobjtype indexnode_doc_field_type_maprc|jikrYi|_|jD]J}|jD]}|df|j|<|jr+t t |}|jD]}|df|j|<K|jS)NFT)r+r'namesis_typedr r typenames)selffieldname typed_fields rget_field_type_mapz$ObjectDescription.get_field_type_mapAs  #r ) G')D $- G G!KDDD6;U^D,T22>G"&z5"9"9K + 5GG:?066''r!ctd|jdd}|jjr d|DSd|DS)z Retrieve the signatures to document from the directive arguments. By default, signatures are given as arguments, one per line. r chg|]/}td|0S)z\1)strip_backslash_resubstrip.0lines r z4ObjectDescription.get_signatures..Ws1RRRD&**5$**,,??RRRr!c6g|]}|S)r;r<s rr?z4ObjectDescription.get_signatures..Ys 333TDJJLL333r!) nl_escape_rer: argumentssplitconfigstrip_signature_backslash)r0liness rget_signaturesz ObjectDescription.get_signaturesOsc   T^A%677==dCC ; 0 4RRERRR R33U333 3r!sigsignodect)a Parse the signature *sig* into individual nodes and append them to *signode*. If ValueError is raised, parsing is aborted and the whole *sig* is put into a single desc_name node. The return value should be a value that identifies the object. It is passed to :meth:`add_target_and_index()` unchanged, and otherwise only used to skip duplicates. )r)r0rIrJs rhandle_signaturez"ObjectDescription.handle_signature[s r!r2cdS)z Add cross-reference IDs and entries to self.indexnode, if applicable. *name* is whatever :meth:`handle_signature()` returned. NrA)r0r2rIrJs radd_target_and_indexz&ObjectDescription.add_target_and_indexgs r!cdS)z Called before parsing content. Used to set information about the current directive context on the build environment. NrAr0s rbefore_contentz ObjectDescription.before_contento r! contentnodecdS)z Called after creating the content through nested parsing, but before the ``object-description-transform`` event is emitted, and before the info-fields are transformed. Can be used to manipulate the content. NrA)r0rSs rtransform_contentz#ObjectDescription.transform_contentvs  r!cdS)z Called after parsing content. Used to reset information about the current directive context on the build environment. NrArPs r after_contentzObjectDescription.after_contentrRr!cd|jvr)|jdd\|_|_nd|jc|_|_t jg|_t j}|jj |_ |j|d<|jx|d<|d<d|j vx|d<}|jr |d  |j|d  |dg|_ | }|D]}t j|d}||| | |||}n<#t"$r/||t j||z }YwxYw||j vr3|j ||s||||t j}| ||j r|j d |jjd <||j|j|j||||jjd |j|j|t?| |d |jjd <|!|j|gS)a Main directive entry function, called by docutils upon encountering the directive. This directive is meant to be quite easily subclassable, so it delegates to several additional methods. What it does: * find out if called as a domain-specific directive, set self.domain * create a `desc` node to fit all description inside * parse standard options, currently `noindex` * create an index node if needed as self.indexnode * parse all given signatures (as returned by self.get_signatures()) using self.handle_signature(), which should either return a name or raise ValueError * add index entries using self.add_target_and_index() * parse the content and handle doc fields in it :r$r6)entriesr(r)desctyper%classesrobjectobject-description-transformN)"r2rDr(r)rindexr*descstatedocumentoptionsappendr-rHrset_source_inforLrclear desc_namerN desc_contentenv temp_datarQ nested_parsecontentcontent_offsetrUappemitr transform_allrW)r0noder% signaturesrIrJr2rSs rrunzObjectDescription.runs$ $)  6(, Q(?(? %DK(*DI %DK!333} + X-1\9Y$z*%.$,%>?Y' ; 0 O " "4; / / / YtI///  ((**  B BC-c266G   ) ) ) KK  ,,S'::    8-c3777   4:% B !!$'''B--dCAAA+--  K   : 9+/:a=DH x (   d.A;OOO {+++  8+t|[ B B BD!!// <<<'+8$ %%sE**6F#"F#)rN)&__name__ __module__ __qualname____doc__ has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer flagr&r__annotations__r'rrr(strr)r*rr_r+rrboolr4rHrrrLrNrQrhrUrWr rsrAr!rr#r#)s K $:?K $&OT%[%%%FCGS $Ix~$$$:<c5#556;;; (DeE4K.@)@$A ( ( ( ( 4S 4 4 4 4 C . Q    ~RV     X-B t        H&T$ZH&H&H&H&H&H&r!r#c2eZdZdZdZdZdeefdZdS) DefaultRolezK Set the default interpreted text role. Overridden from docutils. r$Frc|jstjdgS|jd}tj||jj|j|jj \}}|r%tj d|||j j d<nQtj|j|j}|jj }|d|z||j}||gz }t#t$tj|S)Nr6r default_rolez#Unknown interpreted text role "%s".)r>)rCrunregister_rolerrole state_machinelanguagelinenorareporter register_rolerirjr literal_block block_texterrorr rr )r0 role_namermessagesrrrs rrszDefaultRole.runs~   $R ( ( (IN1% It/A/J$(K1DFFh   "2t , , ,1:DH ~ . .!/QQMz*HNN#H9#T#0t{#DDE  HD$h///r!N) rtrurvrwrzr{rr rsrAr!rrrsK %0T$Z000000r!rcJeZdZUdZdZdZdZdZiZe e d<de e fdZ dS) DefaultDomainzH Directive to (re-)set the default domain for this source file. Fr$rr&rc|jd}|jj||jjd<gS)Nrdefault_domain)rClowerridomainsgetrj)r0 domain_names rrszDefaultDomain.runsDnQ'--// 04x/?/C/CK/P/P+, r!N)rtrurvrwrxryrzr{r&rr}rr rsrAr!rrrshK % K    T$Z      r!rrnrc6|dddtjdttjdttjdt tjdt |dd d d d S) NrFFriz default-rolezdefault-domaindescriber]r^builtinT)versionparallel_read_safeparallel_write_safe)add_config_valuer register_directiverrr# add_event)rns rsetuprs4eUCCC!.+>>>!"2MBBB!*.?@@@!(,=>>>MM0111"#  r!),rwretypingrrrrrrr r rr docutils.nodesr docutils.parsers.rstr rsphinxrsphinx.addnodesr sphinx.utilsphinx.util.docfieldsrrrsphinx.util.docutilsrsphinx.util.typingrsphinx.applicationrcompilerBr9rr~rr r#rrrrAr!rrs3.. PPPPPPPPPPPPPPPPPPPP22222222****** HHHHHHHHHH000000))))))*))))))rz'"" RZ)) GCLL 3 3    e&e&e&e&e&e&e&e&P00000/0008O.xDcNr!