U \Sh0 @sUdZddlmZddlZddlZddlZddlZddlZddlm Z ddlm Z ddl m Z m Z ddlmZmZmZmZmZddlmZmZdd lmZdd lmZdd lmZdd lmZdd lm Z ddlm!Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(m)Z)m*Z*m+Z+ddl,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4e 5e6Z7e8dZ9de:d<e8dZ;de:d<ddddddZZ?d[d#d$Z@d\d%d&ZAGd'd(d(e>ZBddd)d*d+d,ZCe8d-ZDGd.d/d/ZEGd0d1d1ZFdd2d3d4d5d6ZGd2ddd7d8d9d:ZHddd7d;dd?d@dAZJddBdCdDdEZKdddFdGdHZLddIdJdKdLZMdMdNZNe"jOdOfejPdPfejQdQfejRdRfejSdSfejTdTfejUdTfejVdUfejWdVfeNdWfdX ZXdYdZZYdS)^zUtility functions for Sphinx.) annotationsN) import_module)path)IOAny) parse_qsl quote_plus urlencodeurlsplit urlunsplit)ExtensionErrorFiletypeNotFoundError)__)display) exceptions) http_date)logging)osutil) strip_colors) patfilter)caption_ref_reexplicit_title_renested_parse_with_titlessplit_explicit_title)SEPcopyfile copytimes ensuredir make_filenamemtimes_of_filesos_path relative_uriz\s+zre.Pattern[str]ws_rez(?P.+)://.*url_restr) basedocnamedocnamereturncCs ttd|d|ddS)N/z..) posixpathnormpathjoin)r%r&r-G/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/util/__init__.py docname_join5s r/zdict[str, str]) source_suffixfilenamer'cCs0|D]\}}||r|p dSqtdS)Nrestructuredtext)itemsendswithr )r0r1suffixfiletyper-r-r. get_filetype:s r7c@speZdZdZddddZdddddd Zddd d d Zd dddddZd dddZd ddddZ dS)FilenameUniqDictz A dictionary that automatically generates unique names for its keys, interpreted as filenames, and keeps track of a set of docnames they appear in. Used for images and downloadable files in the environment. Noner'cCs t|_dSN)set _existingselfr-r-r.__init__HszFilenameUniqDict.__init__r$)r&newfiler'cCs||kr&||d|||dSt|}t|\}}d}||jkrf|d7}|||}qB|h|f||<|j||S)Nrr))addrbasenamesplitextr=)r?r&rAZ uniquenamebaseextir-r-r.add_fileKs    zFilenameUniqDict.add_filer&r'cCs>t|D],\}\}}|||s ||=|j|q dSr;)listr3discardr=)r?r&r1docsuniquer-r-r. purge_docYs  zFilenameUniqDict.purge_docset[str]dict[str, tuple[set[str], Any]]docnamesotherr'cCs8|D]*\}\}}|t|@D]}|||q qdSr;r3r<rH)r?rRrSr1rL_uniquedocr-r-r. merge_other`szFilenameUniqDict.merge_othercCs|jSr;r=r>r-r-r. __getstate__eszFilenameUniqDict.__getstate__)stater'cCs ||_dSr;rX)r?rZr-r-r. __setstate__hszFilenameUniqDict.__setstate__N) __name__ __module__ __qualname____doc__r@rHrNrWrYr[r-r-r-r.r8Bsr8cKs.tjdddkr tj|ddStj|f|S)z\Wrapper around hashlib.md5 Attempt call with 'usedforsecurity=False' if supported. NFZusedforsecurity)sys version_infohashlibmd5datakwargsr-r-r.rilsricKs.tjdddkr tj|ddStj|f|S)z]Wrapper around hashlib.sha1 Attempt call with 'usedforsecurity=False' if supported. NrarbFre)rfrgrhsha1rjr-r-r.rmwsrmc@sDeZdZdZddddddZddddd Zd d dd d dZdS) DownloadFileszA special dictionary for download files. .. important:: This class would be refactored in nearly future. Hence don't hack this directly. r$)r&r1r'cCsZ||kr>>s<<<)location?) objectrfindstartfindlencountloggerwarningrendr&)r?rZ linestartZlineendlinenor-r-r.__call__s   z"UnicodeDecodeErrorHandler.__call__N)r\r]r^r_r@rr-r-r-r.r~sr~c@s@eZdZdZddddddZdddd d Zdd d d ZdS)Teez2 File-like object writing to two streams. rr9)stream1stream2r'cCs||_||_dSr;)rr)r?rrr-r-r.r@sz Tee.__init__r$)textr'cCs|j||j|dSr;)rwriter)r?rr-r-r.rs z Tee.writer:cCs0t|jdr|jt|jdr,|jdS)Nflush)hasattrrrrr>r-r-r.rs   z Tee.flushN)r\r]r^r_r@rrr-r-r-r.rsrintz list[int])spectotalr'c Csg}|d}|D]}z|d}ddg|kr6tt|dkrZ|t|ddnXt|dkrt|dprd}t|dpt||}||krt|t|d|ntWqt k r}ztd||W5d}~XYqXq|S) z_Parse a line number spec (such as "1,2,4-6") and return a list of wanted line numbers. ,-r)rrazinvalid line number spec: %rN) rxstrip ValueErrorrappendrmaxextendrange Exception) rrr3partspartZbegendrrexcr-r-r. parselinenoss&    "rz list[str])ntyper{r'cCsHdd|d|dD}tttd||krDtd|d||S)z@Split an index entry into a given number of parts at semicolons.cSsg|] }|qSr-)r).0xr-r-r. szsplit_into..;r)Ninvalid index entry )rxrrJfilterr)rrr{rr-r-r. split_intosr) entry_typer{r'cCs|dkr8ztdd|WStk r6tdd|YSX|dkrLtdd|S|dkr`tdd|S|dkrttdd|Std |d |dS) NZsinglerar)pairZtriplerc>seeseealsorrr)rr)rr{r-r-r.split_index_msgs   rr)objnamesourcer'c Cszd|d}|d}t|}|D]<}|d|7}zt||}Wq"tk r\t|}Yq"Xq"|WSttfk r}z,|rtd||f||td|||W5d}~XYnXdS)z!Import python object by qualname.rwrz#Could not import %s (needed for %s)zCould not import %sN)rxpoprryAttributeError ImportErrorr )rrZobjpathruobjnamerr-r-r. import_objects*   rztuple[str | None, str])rr'c Cs|d}t|dD]\}}zd|d|}t|Wqtk r|d|drd|d|dd||ddfYSdd|fYSYqtk rYqXq|dfS)aSplit full qualified name to a pair of modname and qualname. A qualname is an abbreviation for "Qualified name" introduced at PEP-3155 (https://peps.python.org/pep-3155/). It is a dotted path name from the module top-level. A "full" qualified name means a string containing both module name and qualified name. .. note:: This function actually imports the module to check its existence. Therefore you need to mock 3rd party modules if needed before calling this function. rwr)Nr)rx enumerater,rr IndexError)rrrGZ_partrur-r-r.split_full_qualified_name$s  4r)urir'cCsdtt|}|ddd|d<t|dd|d<ddt|dD}t||d<t|S) Nr)idnaasciirar(cSsg|]\}}||fqSr-)ro)rqvr-r-r.rFszencode_uri..rc)rJr rodecoderrr r )rrxqueryr-r-r. encode_uriBs   rbool)urlr'cCst|od|kS)zCheck *url* is URL or not.z://)r)rr-r-r.isurlKsrcCsddlm}|S)Nr_XML_NAME_PATTERN)Zsphinx.builders.epub3rrr-r-r._xml_name_checkerPs rz!sphinx.util.osutil.path_stabilizez!sphinx.util.display.display_chunkz#sphinx.util.display.status_iteratorz'sphinx.util.display.SkipProgressMessagez!sphinx.http_date.epoch_to_rfc1123z!sphinx.http_date.rfc1123_to_epochz sphinx.exceptions.save_tracebackz-sphinx.exceptions.format_exception_cut_framesz'sphinx.builders.epub3._XML_NAME_PATTERN) path_stabilize display_chunkstatus_iteratorSkipProgressMessageprogress_messageepoch_to_rfc1123rfc1123_to_epochsave_tracebackformat_exception_cut_framesZxmlname_checkercCsH|tkrtdtd|ddlm}t|\}}|t||dd|S)Nzmodule z has no attribute r)_deprecation_warning)rdr)remove)_DEPRECATED_OBJECTSrr\Zsphinx.deprecationr)rrZdeprecated_objectcanonical_namer-r-r. __getattr__hs   r)r`)r`)N)Zr_ __future__rrhrqr*rerf importlibrrtypingrr urllib.parserrr r r Z sphinx.errorsr r Z sphinx.localerZ sphinx.utilr_displayr _exceptionsrZ _http_daterrZ_osutilZsphinx.util.consolerZsphinx.util.matchingrZsphinx.util.nodesrrrrZsphinx.util.osutilrrrrrrr r! getLoggerr\rcompiler"__annotations__r#r/r7dictr8rirmrnr}Z _coding_rer~rrrrrrrrrrrrrrrrrrrrr-r-r-r.st            ( *