-PhrdZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z m Z ddlmZmZmZmZdd lmZerdd lmZmZdd lmZdd lmZehd ZeehdzZd&dZd'dZd(dZ d)d%Z!dS)*z7Sphinx extension for auto-generating API documentation.) annotationsN)Path) TYPE_CHECKING)bold)create_modules_toc_file recurse_tree)LOGGERApidocDefaults ApidocOptions_remove_old_files)__) CollectionSequence)Any)Sphinx> no_headings follow_links module_firstinclude_privateseparate_modulesimplicit_namespaces>path max_depth destinationexclude_patternsautomodule_optionsapprreturnNonectj|j}|jj}|j}|j}t jttdt|D]\}}t|||||dS)zRun the apidoc extension.zRunning apidocoptionsdefaultssrcdirconfdirN) r from_configconfigapidoc_modulesr$r%r inforr enumerate_run_apidoc_module)rr#r(r$r%imodule_optionss \/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/ext/apidoc/_extension.py run_apidocr/+s)#*55H/2z/HN:FKG KR())**+++'~66  > "        r,intr"dict[str, Any]r#r r$rr%cJt|||||}|dSd|jD}t|j|||j\}}|jr/|t|||j|j|jrt||j |j dSdS)zRun apidoc for a single module.r!NcZg|](}tjtj|)S)recompilefnmatch translate).0excludes r. z&_run_apidoc_module..Ns:8883: 7$W--..888r0) _parse_module_optionsexclude_patternr module_path template_dirtoc_fileappendr remove_oldr dest_dirsuffix) r,r"r#r$r%argsexclude_patterns_compiled written_filesmoduless r.r+r+?s ! 7Xfg   D |88>B>R888* 3T4;LM7 }  #GT4=$BS T T    E- DDDDDEEr0ApidocOptions | Nonect|ts&tjt d|ddS t |d}ne#t $r(tjt d|dYdSt$r(tjt d|dYdSwxYw|z }|s'tjt d||ddS t |d}ne#t $r(tjt d |dYdSt$r(tjt d |dYdSwxYw| r&tjt d |ddS||z } | d d nB#t$r5} tjt d|| j dYd} ~ dSd} ~ wwxYwfdt||d|jD} |j} d|vrIt|dt s&tjt d|ddn|d} i} t#t$D]y} | |vrt'|| | | <t|| t(s9tjt d|| dt'|| | | <n|| | | <zt+t||d|j}|t0z x}rEtjt d|dt#|dt5||| | d | d| d| d| d| d| d||j S)Nz%apidoc_modules item %i must be a dictapidoctyperz-apidoc_modules item %i must have a 'path' keyz.apidoc_modules item %i 'path' must be a stringz;apidoc_modules item %i 'path' is not an existing folder: %srz4apidoc_modules item %i must have a 'destination' keyz5apidoc_modules item %i 'destination' must be a stringz>apidoc_modules item %i 'destination' should be a relative pathT)parentsexist_okz>apidoc_modules item %i cannot create destination directory: %sc4g|]}t|z Sr5)str)r:patternr%s r.r<z)_parse_module_options..s6###  Gg ###r0r)keydefaultrz*apidoc_modules item %i '%s' must be an intz-apidoc_modules item %i '%s' must be a booleanrz.apidoc_modules item %i has unexpected keys: %sz, rrrrrr) rDr?r>rquietrrrrrrrheader) isinstancedictr warningr rKeyError TypeErroris_dir is_absolutemkdirOSErrorstrerror_check_collection_of_stringsrrr1sorted _BOOL_KEYSgetattrbool frozensetrkeys _ALLOWED_KEYSjoinr name)r,r"r#r$r%rr?r dest_pathexcrr bool_optionsrTrdiffs ` r.r=r=]s gt $ $rABBAHUUUUt GFO$$  > ? ?    tt  ? @ @!(    tt  D.K      L M M      t7=122  E F F     tt  F G G     tt    O P P     t$I t4444  O P P L     ttttt####3 w.8Q   ###"Ig'+.44 - N?@@       ,I$&Lj!! - - g   '# 6 6L  GCL$// - NBCC      !(# 6 6L   ' L  #$ w0(:U    ||~~ --t  ? @ @ IIfTll # #      (!.1%&89$%67 /!.1()>?-   sGA.B6-B65B6:D.E2-E21E25G H *HH indexrTrRrUCollection[str]cd||vr|St||ttztztzs't jtd||d|S||D]@}t|ts)t jtd||d|cSA||S)zCheck that a key's value is a collection of strings in the options. :returns: The value of the key, or None if invalid. z.apidoc_modules item %i '%s' must be a sequencerLrMz0apidoc_modules item %i '%s' must contain strings) rXlisttuplesetrgr rZr rR)rpr"rTrUitems r.rbrbs ' gclD5L3$6$B C C ? @ @        $$$  NEFF      NNN  3<r0)rrrr) r,r1r"r2r#r r$rr%rrr) r,r1r"r2r#r r$rr%rrrJ) rpr1r"r2rTrRrUrqrrq)"__doc__ __future__rr8r6pathlibrtypingrsphinx._cli.util.colourrsphinx.ext.apidoc._generaterrsphinx.ext.apidoc._sharedr r r r sphinx.localer collections.abcrrrsphinx.applicationrrgrdrir/r+r=rbr5r0r.rs==""""""  ((((((MMMMMMMM *44444444)))))) Y YY(((     (EEEE