a ©lcBã@sjdZddlmZddlmZddlmZddlmZdd„Z dd „Z d d „Z d d „Z dd„Z ddd„ZdS)a‡Machinery for documenting traitlets config options with Sphinx. This includes: - A Sphinx extension defining directives and roles for config options. - A function to generate an rst file given an Application instance. To make this documentation, first set this module as an extension in Sphinx's conf.py:: extensions = [ # ... 'traitlets.config.sphinxdoc', ] Autogenerate the config documentation by running code like this before Sphinx builds:: from traitlets.config.sphinxdoc import write_doc from myapp import MyApplication writedoc('config/options.rst', # File to write 'MyApp config options', # Title MyApplication() ) The generated rST syntax looks like this:: .. configtrait:: Application.log_datefmt Description goes here. Cross reference like this: :configtrait:`Application.log_datefmt`. é)Ú defaultdict)Údedent)Ú Undefined)ÚindentcCs|jdddddddœ}|S)z„Registers the Sphinx extension. You shouldn't need to call this directly; configure Sphinx to use this module instead. Z configtraitz Config option)ZobjnameT)Zparallel_read_safeZparallel_write_safe)Zadd_object_type)ÚappÚmetadata©rúV/var/www/html/django/DPS/env/lib/python3.9/site-packages/traitlets/config/sphinxdoc.pyÚsetup*s r cCs4|dus|turdSt|tttttfƒr0t|ƒSdS)NFT)rÚ isinstanceÚstrÚlistÚtupleÚdictÚsetÚbool)Zdvrrr Úinteresting_default_value5s rcCsBg}|D].}t|ƒdkrdnd}| d|›|›d¡qd |¡S)Néú-z--z``ú, )ÚlenÚappendÚjoin)ÚaliasesZfmtedÚaÚdashesrrr Úformat_aliases=s rc Csfg}|j}t|jdd ¡ƒD]:\}}|jj}|d|j}|d|dg7}|j ¡pZd}| t t |ƒƒd¡d|vr | t d d   d d „|j Dƒ¡ƒ¡n| t d |ƒ¡t |jƒr(z | ¡} Wntyàd} Yn0| dur(t| ƒdkr | dd…d} |  dd¡} | t d| ƒ¡||rPt||ƒ} | t d| ƒ¡| d¡qd  |¡S)zoGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. T)ÚconfigÚ.z.. configtrait:: ÚzNo descriptionÚ ÚEnumz :options: rcss|]}d|VqdS)z``%r``Nr)Ú.0Úxrrr Ú Xóz'class_config_rst_doc..z :trait type: Né@é=z...z\nz\\nz:default: ``%s``z :CLI option: )Ú__name__ÚsortedZ class_traitsÚitemsÚ __class__ÚnameÚhelpÚrstriprrrrÚvaluesrÚ default_valueZdefault_value_reprÚ ExceptionrÚreplacer) ÚclsÚ trait_aliasesÚlinesÚ classnameÚ_ÚtraitÚttypeÚfullnamer-ZdvrZ fmt_aliasesrrr Úclass_config_rst_docEs4&         r;c Cs ttƒ}|j ¡D]\}}|| |¡q|j ¡D]f\}\}}t|ƒdkr4t|ƒd}||}t|ƒdkr4t|ƒd} || dur4||d|  |¡q4|S)zBProduce a mapping of trait names to lists of command line aliases.rrTr)rr rr*rÚflagsr) rÚresÚaliasr8ÚflagÚcfgr7r6Zcls_cfgZ traitnamerrr Úreverse_aliasesus     rANcCs¢t|ƒ}t|dƒ|}| |d¡| dt|ƒd¡| d¡|durX| |d¡| ¡D]}| t||ƒ¡| d¡q`Wdƒn1s”0YdS)aWrite a rst file documenting config options for a traitlets application. Parameters ---------- path : str The file to be written title : str The human-readable title of the document app : traitlets.config.Application An instance of the application class to be documented preamble : str Extra text to add just after the title (optional) Úwr ú=Nz )rAÚopenÚwriterZ_classes_inc_parentsr;)ÚpathÚtitlerÚpreambler4ÚfÚcrrr Ú write_doc‰s   rK)N)Ú__doc__Ú collectionsrÚtextwraprZ traitletsrZtraitlets.utils.textrr rrr;rArKrrrr Ús"     0