-PhFH UdZddlmZddlmZddlmZddlmZerddl m Z ddlm Z ddlm Z dd l mZdd lmZGd d ejZGd dZGddejej eZGddej eZGddejej ZGddeejejejZGddejejejZGddejej ZGddeejejZ GddeejejejZ!Gdd eejejejZ"e"Z#Gd!d"ejejejZ$Gd#d$e$Z%Gd%d&ejejejZ&Gd'd(ejejejZ'Gd)d*ejejejZ(Gd+d,ejejejZ)Gd-d.ejejejZ*Gd/d0ejejejZ+e,Z-d1e.d2<Gd3d4ej/eZ0Gd5d6e0d78Z1Gd9d:e0d78Z2Gd;de0d78Z4Gd?d@e0d78Z5GdAdBe0d78Z6GdCdDe0d78Z7GdEdFe0d78Z8GdGdHe0d78Z9GdIdJejejZ:GdKdLejej Z;GdMdNejej Z<GdOdPejejejZ=GdQdRej>ejejZ?GdSdTejejZ@GdUdVej ZAGdWdXej ZBGdYdZej ZCGd[d\ejDZEGd]d^ej ZFGd_d`ej ZGGdadbej ZHGdcddej ZIGdedfej ZJGdgdhejej ZKGdidjejejZLGdkdlejMZNGdmdnejMZOGdodpejPeZQGdqdrejReZSGdsdtejejZTd{dyZUdzS)|zDDocument tree nodes that Sphinx defines on top of those in Docutils.) annotations) TYPE_CHECKING)nodes)document)Sequence)Any)Element)Sphinx)ExtensionMetadatac*eZdZdZd dZd dZdd Zd S) translatableaNode which supports translation. The translation goes forward with following steps: 1. Preserve original translatable messages 2. Apply translated messages from message catalog 3. Extract preserved messages (for gettext builder) The translatable nodes MUST preserve original messages. And these messages should not be overridden at applying step. Because they are used at final step; extraction. returnNonect)z(Preserve original translatable messages.NotImplementedErrorselfs O/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/addnodes.pypreserve_original_messagesz'translatable.preserve_original_messages"s!!original_messagestrtranslated_messagect)zApply translated message.r)rrrs rapply_translated_messagez%translatable.apply_translated_message&s "!r Sequence[str]ct)zjExtract translation messages. :returns: list of extracted messages or messages generator rrs rextract_original_messagesz&translatable.extract_original_messages,s "!rNrrrrrrrr)rr__name__ __module__ __qualname____doc__rrrrrr r sZ  """""""" """"""rr ceZdZdZdZdS)not_smartquotablez+A node which does not support smart-quotes.FN)r#r$r%r&support_smartquotesr'rrr)r)4s55rr)c*eZdZdZd dZd dZdd Zd S)toctreez Node for inserting a "TOC tree".rrc|dg}|dD]\}}|r|||dr |d|d<dSdS)N rawentriesentriescaption rawcaption) setdefaultappendget)rr.title_docnames rrz"toctree.preserve_original_messages=s} $ b A A #I ) )OE8 )!!%((( 88I   1!%iD    1 1rrrrct|dD]\}\}}||kr ||f|d|<|d|kr||d<dSdS)Nr/r1r0) enumerater4)rrrir5docnames rrz toctree.apply_translated_messageHsz$-T)_#=#= C C Aw(((&8'%BY" 88L ! !%5 5 50DOOO 6 5r list[str]cg}||dgd|vr||d|S)Nr.r1)extendr4r3)rmessagess rrz!toctree.extract_original_messagesTsR  r22333 4   OOD. / / /rNr r!)rr;r"r'rrr,r,:sV** 1 1 1 1 1 1 1 1      rr,c4eZdZUdZgZded<d fd ZxZS) _desc_classes_injectorz_Helper base class for injecting a fixed list of classes. Use as the first base class. r;classesargsrkwargsrrcztj|i||d|jdSNrAsuper__init__r=rA)rrBrC __class__s rrHz_desc_classes_injector.__init__ms?$)&))) Yt|,,,,,r)rBrrCrrr)r#r$r%r&rA__annotations__rH __classcell__rIs@rr@r@es\ G----------rr@ceZdZdZdS)descamNode for a list of object signatures and a common description of them. Contains one or more :py:class:`desc_signature` nodes and then a single :py:class:`desc_content` node. This node always has two classes: - The name of the domain it belongs to, e.g., ``py`` or ``cpp``. - The name of the object type in the domain, e.g., ``function``. Nr#r$r%r&r'rrrNrNvs    rrNc<eZdZdZddgZedfd ZxZS)desc_signatureaSNode for a single object signature. As default the signature is a single-line signature. Set ``is_multiline = True`` to describe a multi-line signature. In that case all child nodes must be :py:class:`desc_signature_line` nodes. This node always has the classes ``sig``, ``sig-object``, and the domain it belongs to. sigz sig-objectrrcX|drdStjS)N is_multiline )r4rGchild_text_separatorrrIs rrVz#desc_signature.child_text_separators) 88N # # 0377/ /rrr)r#r$r%r&rApropertyrVrKrLs@rrQrQs]l#G 00000X00000rrQceZdZdZdZdS)desc_signature_linezNode for a line in a multi-line object signature. It should only be used as a child of a :py:class:`desc_signature` with ``is_multiline`` set to ``True``. Set ``add_permalink = True`` for the line that should get the permalink. N)r#r$r%r&sphinx_line_typer'rrr[r[s"rr[ceZdZdZdS) desc_contentzfNode for object description content. Must be the last child node in a :py:class:`desc` node. NrOr'rrr_r_rr_c,eZdZdZddgZd fd ZxZS) desc_inlinezNode for a signature fragment in inline text. This is for example used for roles like :rst:role:`cpp:expr`. This node always has the classes ``sig``, ``sig-inline``, and the name of the domain it belongs to. rRz sig-inlinedomainrrBrrCrrcxtj|i|d|i|d|dS)NrcrA)rGrHr3)rrcrBrCrIs rrHzdesc_inline.__init__sH$8&888888 Yv&&&&&r)rcrrBrrCrrrr#r$r%r&rArHrKrLs@rrbrbsSl#G''''''''''rrbceZdZdZddgZdS) desc_namezNode for the main object name. For example, in the declaration of a Python class ``MyModule.MyClass``, the main name is ``MyClass``. This node always has the class ``sig-name``. zsig-namedescnameNr#r$r%r&rAr'rrrgrgs$:&GGGrrgceZdZdZddgZdS) desc_addnamezNode for additional name parts for an object. For example, in the declaration of a Python class ``MyModule.MyClass``, the additional name part is ``MyModule.``. This node always has the class ``sig-prename``. z sig-prename descclassnameNrir'rrrkrks$o.GGGrrkceZdZdZdS) desc_typez+Node for return types or object type names.NrOr'rrrnrns5555rrnc$eZdZdZdfd ZxZS) desc_returnsz4Node for a "returns" annotation (a la -> in Python).rrcJdtzS)Nz -> rGastextrWs rrszdesc_returns.astexts((((rrX)r#r$r%r&rsrKrLs@rrprpsC>>))))))))))rrpc(eZdZdZdZdfd ZxZS)desc_parameterlistaNode for a general parameter list. As default the parameter list is written in line with the rest of the signature. Set ``multi_line_parameter_list = True`` to describe a multi-line parameter list. In that case each parameter will then be written on its own, indented line. A trailing comma will be added on the last line if ``multi_line_trailing_comma`` is True. , rrcLdtdS)N()rrrWs rrszdesc_parameterlist.astext"&577>>##&&&&rrXr#r$r%r&rVrsrKrLs@rruruO ''''''''''rruc(eZdZdZdZdfd ZxZS)desc_type_parameter_listaNode for a general type parameter list. As default the type parameters list is written in line with the rest of the signature. Set ``multi_line_parameter_list = True`` to describe a multi-line type parameters list. In that case each type parameter will then be written on its own, indented line. A trailing comma will be added on the last line if ``multi_line_trailing_comma`` is True. rvrrcLdtdSN[]rrrWs rrszdesc_type_parameter_list.astext rzrrXr{rLs@rr~r~r|rr~ceZdZdZdS)desc_parameterzNode for a single parameter.NrOr'rrrrs&&&&rrceZdZdZdS)desc_type_parameterz!Node for a single type parameter.NrOr'rrrrs++++rrc(eZdZdZdZdfd ZxZS) desc_optionalz6Node for marking optional parts of the parameter list.rvrrcPdtzdzSrrrrWs rrszdesc_optional.astexts!UWW^^%%%++rrXr{rLs@rrrsI@@,,,,,,,,,,rrceZdZdZdS)desc_annotationz@Node for signature annotations (not Python 3-style annotations).NrOr'rrrr"sJJJJrrzset[type[desc_sig_element]] SIG_ELEMENTScJeZdZUdZgZded< ddfd ZdddfdZxZS)desc_sig_elementzsN DB8BBBzBBB Yt|,,,,,rF _sig_elementrboolrCc vtjdi||rt|dSdS)Nr')rG__init_subclass__radd)clsrrCrIs rrz"desc_sig_element.__init_subclass__DsL!!++F+++  "   S ! ! ! ! ! " "r)r\r\ rrrrrr rrrr)rrrCrrr) r#r$r%r&rArJrHrrKrLs@rrr9sFFG02------- 8=""""""""""""rrc0eZdZdZdgZ ddfd ZxZS)desc_sig_spacez Node for a space in a signature.wr\rUrrrrr rrrrcDtj||g|Ri|dS)N)rGrHrs rrHzdesc_sig_space.__init__Ts4 DB8BBBzBBBBBr)r\rUrrerLs@rrrOsb**eGCCCCCCCCCCCrrTrceZdZdZdgZdS) desc_sig_namez&Node for an identifier in a signature.nNrir'rrrr^s00eGGGrrceZdZdZdgZdS)desc_sig_operatorz$Node for an operator in a signature.oNrir'rrrrd..eGGGrrceZdZdZdgZdS)desc_sig_punctuationz$Node for punctuation in a signature.pNrir'rrrrjrrrceZdZdZdgZdS)desc_sig_keywordz*Node for a general keyword in a signature.kNrir'rrrrp44eGGGrrceZdZdZdgZdS)desc_sig_keyword_typez;Node for a keyword which is a built-in type in a signature.ktNrir'rrrrvsEEfGGGrrceZdZdZdgZdS)desc_sig_literal_numberz*Node for a numeric literal in a signature.mNrir'rrrr|rrrceZdZdZdgZdS)desc_sig_literal_stringz)Node for a string literal in a signature.sNrir'rrrrs33eGGGrrceZdZdZdgZdS)desc_sig_literal_charz,Node for a character literal in a signature.scNrir'rrrrs66fGGGrrceZdZdZdS)versionmodifiedzNode for version change entries. Currently used for "versionadded", "versionchanged", "deprecated" and "versionremoved" directives. NrOr'rrrrsrrceZdZdZdS)seealsozCustom "see also" admonition.NrOr'rrrrs''''rrceZdZdZdS)productionlistzKNode for grammar production lists. Contains ``production`` nodes. NrOr'rrrrr`rrceZdZdZdS) productionz*Node for a single grammar production rule.NrOr'rrrrs4444rrceZdZdZdS)indexaNode for index entries. This node is created by the ``index`` directive and has one attribute, ``entries``. Its value is a list of 5-tuples of ``(entrytype, entryname, target, ignored, key)``. *entrytype* is one of "single", "pair", "double", "triple". *key* is categorization characters (usually a single character) for general index page. For the details of this, please see also: :rst:dir:`glossary` and https://github.com/sphinx-doc/sphinx/pull/2320. NrOr'rrrrs    rrceZdZdZdS)centeredz Deprecated.NrOr'rrrrsrrceZdZdZdS)ackszSpecial node for "acks" lists.NrOr'rrrrs((((rrceZdZdZdS)hlistzjNode for "horizontal lists", i.e. lists that should be compressed to take up less vertical space. NrOr'rrrrrrceZdZdZdS)hlistcolz)Node for one column in a horizontal list.NrOr'rrrrs3333rrceZdZdZdS)compact_paragraphz node).NrOr'rrrrsFFFFrrceZdZdZdS)glossaryzNode to insert a glossary.NrOr'rrrrs$$$$rrceZdZdZdS)onlyzANode for "only" directives (conditional inclusion based on tags).NrOr'rrrrKKKKrrceZdZdZdS) start_of_filezANode to mark start of a new file, used in the LaTeX builder only.NrOr'rrrrrrrceZdZdZdS) highlightlangzcInserted to set the highlight language and line number options for subsequent code blocks. NrOr'rrrrrrrceZdZdZdS)tabular_col_specz;Node for specifying tabular columns, used for LaTeX output.NrOr'rrrrsEEEErrceZdZdZdZdS) pending_xrefzNode for cross-references that cannot be resolved without complete information about all documents. These nodes are resolved before writing output, in BuildEnvironment.resolve_references. r\N)r#r$r%r&rVr'rrrrs"rrceZdZdZdS)pending_xref_conditionaENode representing a potential way to create a cross-reference and the condition in which this way should be used. This node is only allowed to be placed under a :py:class:`pending_xref` node. A **pending_xref** node must contain either no **pending_xref_condition** nodes or it must only contains **pending_xref_condition** nodes. The cross-reference resolver will replace a :py:class:`pending_xref` which contains **pending_xref_condition** nodes by the content of exactly one of those **pending_xref_condition** nodes' content. It uses the **condition** attribute to decide which **pending_xref_condition** node's content to use. For example, let us consider how the cross-reference resolver acts on:: StringIO io.StringIO If the cross-reference resolver successfully resolves the cross-reference, then it rewrites the **pending_xref** as:: StringIO Otherwise, if the cross-reference resolution failed, it rewrites the **pending_xref** as:: io.StringIO The **pending_xref_condition** node should have **condition** attribute. Domains can be store their individual conditions into the attribute to filter contents on resolving phase. As a reserved condition name, ``condition="*"`` is used for the fallback of resolution failure. Additionally, as a recommended condition name, ``condition="resolved"`` represents a resolution success in the intersphinx module. .. versionadded:: 4.0 NrOr'rrrrs++++rrceZdZdZdS)number_referencez4Node for number references, similar to pending_xref.NrOr'rrrr's>>>>rrceZdZdZdS)download_referencez6Node for download references, similar to pending_xref.NrOr'rrrr+s@@@@rrceZdZdZdS)literal_emphasisz{Node that behaves like `emphasis`, but further text processors are not applied (e.g. smartypants for HTML output). NrOr'rrrr/rrrceZdZdZdS)literal_strongzyNode that behaves like `strong`, but further text processors are not applied (e.g. smartypants for HTML output). NrOr'rrrr5rrrceZdZdZdS)manpagez Node for references to manpages.NrOr'rrrr;s****rrappr rr c|t|t|t|t|t |t |t|t|t|t|t|t|t|t|t|t t"D]}|||t$|t&|t(|t*|t,|t.|t0|t2|t4|t6|t8|t:|t<|t>|t@|tB|tD|tF|tH|tJ|tLddddS)NbuiltinT)versionparallel_read_safeparallel_write_safe)'add_noder,rNrQr[r_rbrgrkrnrprur~rrrrrrrrrrrrrrrrrrrrrrrrrr)rrs rsetupr?sLLLLLL   LL$%%%LLLLLLLLLLLLLL#$$$LL)***LL   LL$%%%LLLL!!!  QLL!!!LLLL   LLLLLLLLLLLLLL"###LLLLLLLLLL!"""LLLL!"""LL#$$$LL!"""LL   LL"#  rN)rr rr )Vr& __future__rtypingrdocutilsrdocutils.nodesrcollections.abcrrr sphinx.applicationr sphinx.util.typingr Noder r)Generalr,r@ AdmonitionrNPartInline TextElementrQFixedTextElementr[r_rbrgrkdesc_classnamernrprur~rrrrsetrrJinlinerrrrrrrrrrrrrr Invisiblerrrrr paragraphrrrrrrrr referencerremphasisrstrongrrrr'rrrs JJJ"""""" ######5((((((&&&&&&))))))444444"""""5:"""@        #####emU]L###V - - - - -U],= - - -"     5 U]    00000EJ e6G000.%*elE4J5=%- ' ' ' ' '(%,8I ' ' ', ' ' ' ' 'EJ e6L ' ' ' / / / / /EJ e6L / / / 66666 EL%*@666)))))9))) ' ' ' ' 'U\53I ' ' ' ' ' ' ' 'uz5<9O ' ' ' '''''UZu/E''',,,,,%*elE4J,,,,,,,,EJ e.D,,,KKKKKej%,0FKKK-0CEE 1111"""""u|%;""", C C C C C%D C C C C$4 (t +$ 'd ,4 .T .T ,4e&(9(((((e (((U%u}55555U\5+A555     EOU\5+<   uz5,)))))5=)))EM 44444u}444GGGGGGGG%%%%%u}%%%LLLLL5=LLLLLLLLEMLLLEM FFFFFu}FFF5<,,,,,U\5+<,,,^?????u???AAAAAAAAu~'8 U\#4 +++++elE2+++111111r