B .Kc["@s4dZddlZddlZddlmZmZmZmZmZm Z m Z m Z m Z m Z ddlmZddlmZmZddlmZddlmZddlmZdd lmZdd lmZdd lmZerdd lm Z dd l!m"Z"ddl#m$Z$ddl%m&Z&e'e(Z)e*dej+Z,e,Z-GdddZ.ee/dddZ0dee1e/dddZ2eddddZ3ej4ej5ej6ej7fZ8ee9dddZ:ee9dddZ;ej5ej6ejej?fZ@ejAfZBeee ee/fd d!d"ZCee e/dd#d$ZDee e1dd%d&ZEdeeeed'd(d)ZFee edd*d+ZGeee eed,fd d-d.ZHeeee/d/d0d1ZIee/dd2d3ZJe/e e9e/e/fd4d5d6ZKd7d8d9d:d;dd?ZMd@e e/e/ejNeee/ejNdAdBdCZOe/e/dDdEdFZPe*dGZQe*dHZRdIdJdKdLdMdNdOdOdPdJdQdRdMdSdTdNdNdUdVdWdVdMdSdNdXdPdYdVdZdXd[d\dUd]!ZSd^d_d`dadbdcZTddeejNe/e e/e/dfdgdhZUejVe/e edidjdkZWdd@e/e/e/e eeefe e/ejXdldmdnZYeeddodpdqZZee1eddrdsdtZ[eeddudvdwZ\ej]ej^ej_ej?ej=ej`ejafZbee9ddxdyZcedzdd{d|d}Zdeed~ddZeeeej_fdS)z3Docutils node-related utility functions for Sphinx.N) TYPE_CHECKINGAnyCallableIterableListOptionalSetTupleTypeUnion)nodes)ElementNode) Directive)Inliner) StringList)addnodes)__)logging)Builder) IndexEntry)BuildEnvironment)Tagsz^(.+?)\s*(?$c@sFeZdZdZeeeddddZeedddZ eedd d Z dS) NodeMatchera"A helper class for Node.findall(). It checks that the given node is an instance of the specified node-classes and has the specified node-attributes. For example, following example searches ``reference`` node having ``refdomain`` and ``reftype`` attributes:: matcher = NodeMatcher(nodes.reference, refdomain='std', reftype='citation') doctree.findall(matcher) # => [, , ...] A special value ``typing.Any`` matches any kind of node-attributes. For example, following example searches ``reference`` node having ``refdomain`` attributes:: from typing import Any matcher = NodeMatcher(nodes.reference, refdomain=Any) doctree.findall(matcher) # => [, , ...] N) node_classesattrsreturncOs||_||_dS)N)classesr)selfrrr0lib/python3.7/site-packages/sphinx/util/nodes.py__init__6szNodeMatcher.__init__)nodercCsyr|jrt||jsdS|jrpt|tjs.dSx@|jD]2\}}||krNdS|tkrZq:q:|||kr:dSq:WdStk rdSXdS)NFT) r isinstancerr r itemsrget Exception)rr"keyvaluerrr match:s  zNodeMatcher.matchcCs ||S)N)r))rr"rrr __call__PszNodeMatcher.__call__) __name__ __module__ __qualname____doc__r rrr!boolr)r*rrrr r sr)r"rcCsd|j|jjS)z Return full module dotted path like: 'docutils.nodes.paragraph' :param nodes.Node node: target node :return: full module dotted path z{}.{})formatr, __class__r+)r"rrr get_full_module_nameTsr2P)r"lengthrcCsRy|}Wntk r,t|}YnX|rNt||krN|d|d}|S)a return DOM XML representation of the specified node like: 'New in version...' :param nodes.Node node: target node :param int length: length of return value to be striped. if false-value is specified, repr_domxml returns full of DOM XML representation. :return: DOM XML representation Nz...)ZasdomZtoxmlr&strlen)r"r4textrrr repr_domxml^s r8cCs4t|tjrN|jsNtdt|t||j}|j |_ |j d|_ | |_nt|tjrj|j sj|jj |_ t|tj r|j dkrtdt|t||jj |jj |_ |_ t|tj r|j dkrtdt|t||jj |jj |_ |_ t|tjrTtdt|t|x@tt|jtjD]&}tdt| d|j|_q*Wt|tjr|j dkrtdt|t||jj |jj |_ |_ t|tjr|j dkrt||_ |js| |_|j r|jrdSt|tjtj tj tjfr0tdt|t|t|p"d|_ d |_ dSdS) Nz7[i18n] PATCH: %r to have source, line and rawsource: %sz)[i18n] PATCH: %r to have source, line: %sz#[i18n] PATCH: %r to have source: %sz&[i18n] PATCH: %r to have rawsource: %sz \s*:\s*%sz,[i18n] PATCH: %r to have source and line: %sr)r#r classifier rawsourceloggerdebugr2r8parentsourcelineastextimagetitletermreversedlistfindallresubescapeZtopic literal_blockget_node_sourceZrubric field_name)r"Zdefinition_list_itemr;rrr apply_source_workaroundrsV      rOcCs4t|tjr,t|jddgdtjr,dSdSdS)Nr rTF)r#r pendingdetailsr%rmeta)r"rrr is_pending_metas rScCs:t|tjrdSt|tjr4|ds0|dr4dSt|tjrLd|krLdSt|tjr|jszt dt |t |dSt|t rd|krt dt |t |dS|ddst dt |t |dSt|tjr|jdd krt d t |t |dSdSt|s t|tjr$dSt|tjr6dSdS) NT translatablealtFz)[i18n] SKIP %r because no node.source: %szO[i18n] SKIP %r because node is in IGNORED_NODES and no node['translatable']: %sz3[i18n] SKIP %r because not node['translatable']: %srZorphanz&[i18n] SKIP %r because orphan node: %s)r#rrTr rCr%ZInlineZ TextElementr@r=r>r2r8 IGNORED_NODESrNchildrenrSrR docutils_meta)r"rrr is_translatables:   rY)doctreerccsx |tD]}t|tjrd}|dd}x |D]P}||drF|t|dd}||d|}|d |||dfPqFWxtD]L}||dr|t|dd}|d krd }|||||dfPqWxZ|d D]L}|}d}|dr,d}|dd}|s4q|d |||dfqW|S) Nr)pairindextypesr:!mainr9:z; ryrz,rx) Zsphinx.domains.pythonr}ra startswithlstripr6append indextypessplit)r{r|r}Z indexentriesZoentryrtyper(rrr process_index_entryqs>     rr)builder docnamesetdocnametree colorfunc traversedrc Cs|}xt|tjD]}g}tt|d}x|D]} | |kr8yH|| tj || dddt ||| |j | ||} | | Wn(tk rtjtd| |dYq8Xtj| d} | j| _x$| tjD]} d| kr| | d<qW|| q8W|j||qW|S) zwInline all toctrees in the *tree*. Record all docnames in *docnameset*, and output docnames with *colorfunc*. includefilesr]T)Znonlz+toctree contains ref to nonexisting file %r)location)rr)rprGrHrZtoctreemapr5rr=infoinline_all_toctreesenvZ get_doctreeaddr&warningrZ start_of_filerWr sectionr?r`) rrrrrrZ toctreenodeZnewnodesrZ includefileZsubtreeZsofZ sectionnoderrr rs0      r)stringrcCsX|t}|t}td|ddd}tdd | }t d|}t |S)aConvert `string` into an identifier and return it. This function is a modified version of ``docutils.nodes.make_id()`` of docutils-0.16. Changes: * Allow to use capital alphabet characters * Allow to use dots (".") and underscores ("_") for an identifier without a leading character. # Author: David Goodger # Maintainer: docutils-develop@lists.sourceforge.net # Copyright: This module has been placed in the public domain. ZNFKDasciiignore-r]r:) translate_non_id_translate_digraphs_non_id_translate unicodedata normalizeencodedecode _non_id_charsrJjoinr_non_id_at_endsr5)ridrrr _make_ids    rz[^a-zA-Z0-9._]+z^[-0-9._]+|-+$odhiltbcfknpyzgjseqr)!ii'i1iBigiiiiiiiiiiiiiii%i4i5i6i7i<i?i@iGiIiKiMiOZszZaeZoeZdbZqp)iSi8i9r:r)rdocumentprefixrErcCsd}|r|d}n|jjpdd}|rD|rDt||}||kr\d}n|r\t|}|dkr\d}x$|dksp||jkr|||}q^W|S)z>Generate an appropriate node_id for given *prefix* and *term*.Nz-%srz%sr:)ZsettingsZ id_prefixrZidsZ new_serialno)rrrrEZnode_idZidformatrrr make_ids  r)r" conditionrcCs4x.|D]"}t|tjr|d|kr|SqWdSdS)zBPick matched pending_xref_condition node up from the pending_xref.rN)r#rZpending_xref_conditionr%)r"rZsubnoderrr find_pending_xref_conditions   r)r fromdocname todocnamer|childrDrcCsltjdddd}||kr&|r&||d<n.|rD|||d||d<n||||d<|r`||d<||7}|S)z$Shortcut to create a reference node.r:T)ZinternalZrefid#ZrefuriZreftitle)r referenceZget_relative_uri)rrrr|rrDr"rrr make_refnode(s  r) directiver"rcCs|j|j\|_|_dS)N)Z state_machineget_source_and_linelinenor@rA)rr"rrr set_source_info;sr)inlinerrr"rcCs|j|\|_|_dS)N)Zreporterrr@rA)rrr"rrr set_role_source_info@sr)srcdstrcCst||_t||_dS)N)rMr@rfrA)rrrrr copy_source_infoDs rcCsNx4t|jD]&}t|trdS|dddkr dSq Wt|dddkrJdSdS)z0Check whether the node is smart-quotable or not.FZsupport_smartquotesNT)rdr?r#NON_SMARTQUOTABLE_PARENT_NODESr%getattr)r"rerrr is_smartquotableTs rr)rtagsrc Csx|tjD]}y||d}WnJtk rn}z,tjtd||d||j pZt Wdd}~XYqX|r||j pt q|t qWdS)z0Filter ``only`` nodes which do not match *tags*.exprz8exception while evaluating only directive expression: %s)rN) rHrZonlyZeval_conditionr&r=rrZ replace_selfrWr comment)rrr"reterrrrr process_only_nodesbs &r)rrcCs2|j|jf|j}t|tjr.|j|_|j|_|S)zmonkey-patch Element.copy to copy the rawsource and line for docutils-0.16 or older versions. refs: https://sourceforge.net/p/docutils/patches/165/ )r1r<Z attributesr#r r r@rA)rZnewnoderrr _new_copyvs  r)r3)N)r:N)N)gr.rIrtypingrrrrrrrr r r Zdocutilsr Zdocutils.nodesr rZdocutils.parsers.rstrZdocutils.parsers.rst.statesrZdocutils.statemachinerZsphinxrZ sphinx.localerZ sphinx.utilrZsphinx.buildersrZ sphinx.domainrZsphinx.environmentrZsphinx.util.tagsrZ getLoggerr+r=compileDOTALLruZcaption_ref_rerr5r2intr8rOZ InvisiblerLZ doctest_blockZversionmodifiedrVr/rSrYZ math_blockrqr^rCZIMAGE_TYPE_NODESrRr_rcrMrfrdrjrlrorsrwrrrrrrrrrrZ pending_xrefrrrrrrZFixedTextElementliteralZmathZ problematicZnot_smartquotablerrrrcopyrrrr s0            4 ?.#   $&