~Tiq:dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z m Z ddlmZmZmZmZdd lmZerdd lmZmZdd lmZdd lmZehd ZeehdzZddZ ddZ ddZ ddZ!y)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_optionsc2tj|j}|jj}|j}|j }t jttdt|D]\}}t|||||y)zRun the apidoc extension.zRunning apidocoptionsdefaultssrcdirconfdirN) r from_configconfigapidoc_modulesr!r"r inforr enumerate_run_apidoc_module)appr r%r!r"imodule_optionss O/home/agent/.local/lib/python3.12/site-packages/sphinx/ext/apidoc/_extension.py run_apidocr-+s))#**5H/2zz/H/HN::FKKG KKR()*+'~6 > "   ct|||||}|y|jDcgc]*}tjt j |,}}t |j|||j\}} |jr1|jt| ||j|j|jr"t||j|jyycc}w)zRun apidoc for a single module.rN)_parse_module_optionsexclude_patternrecompilefnmatch translater module_path template_dirtoc_fileappendr remove_oldr dest_dirsuffix) r*rr r!r"argsexcludeexclude_patterns_compiled written_filesmoduless r,r(r(?s ! 7Xfg D |?C>R>R83: 7$$W-.88* 3T4;L;LM7 }} #GT4==$BSBS T  - D8s/C$ct|ts"tjt d|dy t |d}||z }|js#tjt d||dy t |d}|jr"tjt d |dy||z } |jd d t||d|jD cgc]} t|| z } } |j } d|vr;t|dt"s#tjt d|ddn|d} i} t%t&D]c}||vrt)||| |<t||t*s2tjt d||dt)||| |<\||| |<et-t||d|j.}|j1t2z x}r:tjt d|dj5t%|dt7||| | d | d| d| d| d| d| d||j8 S#t $r$tjt d|dYyt$r$tjt d|dYywxYw#t $r$tjt d |dYyt$r$tjt d |dYywxYw#t$r6} tjt d|| jdYd} ~ yd} ~ wwxYwcc} w)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: %sr)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) r;r6r1rquietrrrrrrrheader) isinstancedictr warningr rKeyError TypeErroris_dir is_absolutemkdirOSErrorstrerror_check_collection_of_stringsrstrrintsorted _BOOL_KEYSgetattrbool frozensetrkeys _ALLOWED_KEYSjoinr name)r*rr r!r"rr6r dest_pathexcpatternrr bool_optionsrHrdiffs r,r0r0]s gt $rABAHU GFO$D.K     L M   7=12   O P  $I t44 w.8Q8Q #  Gg ##""Ig'+.4 NN?@   ,I$&Lj! - g  '# 6L GCL$/ NNBC   !(# 6L  ' L  -#$ w0(:U:U  ||~ --t- ? @ IIfTl #   (!.1%&89$%67 /!.1()>?- Y  > ?   ? @!(  $  E F    F G   "  O P LL  #sMI1;K L'/M)1*K )K K  *L$8)L$#L$' M&0,M!!M&c&||vr|St||ttttfs$t j td||d|S||D]8}t|trt j td||d|cS||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 sequencerCrDz0apidoc_modules item %i '%s' must contain strings) rLlisttuplesetr]r rNr rW)indexrrHrIitems r,rVrVs ' gclT5#y$A B ? @     $$ NNEF   N 3<r.)r)rreturnNone) r*rXrdict[str, Any]r r r!rr"rrmrn) r*rXrror r r!rr"rrmzApidocOptions | None) rkrXrrorHrWrICollection[str]rmrp)"__doc__ __future__rr4r2pathlibrtypingrsphinx._cli.util.colourrsphinx.ext.apidoc._generaterrsphinx.ext.apidoc._sharedr r r r sphinx.localer collections.abcrrrsphinx.applicationrr]rZr_r-r(r0rVr.r,r|s$="  (M 4)  Y(  (E EE E  E  E E