U üÇ-eã@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ú[/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/traitlets/config/sphinxdoc.pyÚsetup+s r cCs4|dks|tkrdSt|tttttfƒr0t|ƒSdS)NFT)rÚ isinstanceÚstrÚlistÚtupleÚdictÚsetÚbool)Zdvrrr Úinteresting_default_value6s rcCsBg}|D].}t|ƒdkrdnd}| d|›|›d¡qd |¡S)Néú-z--z``ú, )ÚlenÚappendÚjoin)ÚaliasesZfmtedÚaÚdashesrrr Úformat_aliases>s rc Cshg}|j}t|jdd ¡ƒD]<\}}|jj}|d|j}|d|dg7}|j ¡pZd}| t t |ƒƒd¡d|kr | t d d   d d „|j Dƒ¡ƒ¡n| t d |ƒ¡t |jƒr*z | ¡} Wntk râd} YnX| dk r*t| ƒdkr | dd…d} |  dd¡} | t d| ƒ¡||rRt||ƒ} | 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 Ú Ysz'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_docFs4&        r:c Cs ttƒ}|j ¡D]\}}|| |¡q|j ¡D]f\}\}}t|ƒdkr4tt|ƒƒ}||}t|ƒdkr4tt|ƒƒ} || dkr4||d|  |¡q4|S)zBProduce a mapping of trait names to lists of command line aliases.rTr) rr rr)rÚflagsrÚnextÚiter) rÚresÚaliasr7ÚflagÚcfgr6r5Zcls_cfgZ traitnamerrr Úreverse_aliasesvs     rBNc CsŽt|ƒ}t|dƒr}| |d¡| dt|ƒd¡| d¡|dk rX| |d¡| ¡D]}| t||ƒ¡| d¡q`W5QRXdS)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 )rBÚopenÚwriterZ_classes_inc_parentsr:)ÚpathÚtitlerÚpreambler3ÚfÚcrrr Ú write_docŠs   rL)N)Ú__doc__Ú collectionsrÚtextwraprZ traitletsrZtraitlets.utils.textrr rrr:rBrLrrrr Ús#     0