hSrSSKJr SSKrSSKJr SSKJr SSK J r J r SSK J r SSKJr SS jrSS jrSS jrSS jrSS jrSSSjjrg)aMachinery 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`. ) annotationsN) defaultdict)dedent) HasTraits Undefined) Application)indentc.URSSSS9 SSS.$)zxRegisters the Sphinx extension. You shouldn't need to call this directly; configure Sphinx to use this module instead. configtraitz Config option)objnameT)parallel_read_safeparallel_write_safe)add_object_type)apps mC:\Users\julio\OneDrive\Documentos\Trabajo\Ideas Frescas\venv\Lib\site-packages\traitlets/config/sphinxdoc.pysetupr.s$  }oN"&t DDcUb U[Lag[U[[[[ [ 45(a [U5$g)NFT)r isinstancestrlisttupledictsetbool)dvs rinteresting_default_valuer8s4 i"sD%s344Bx rc/nUH-n[U5S:XaSOSnURSUUS35 M/ SRU5$)N-z--z``, )lenappendjoin)aliasesfmtedadashess rformat_aliasesr)@sL E A!  r&!B'( 99U rc /nURn[URSS9R55GHupEURRnUS-UR =(d S-nUSU-S/- nUR R5=(d SnUR[[U55S-5 SU;a>UR[S S RS UR55-55 OUR[S U-55 [UR5(aZUR5n U bF[#U 5S:aU S SS-n U R%SS5n UR[SU -55 X(a*['X5n UR[SU -55 URS5 GM SRU5$![ a S n Nf=f)zgGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. T)config.z.. configtrait:: zNo description Enumz :options: r!c3,# UH nSU-v M g7f)z``%r``N).0xs r 'class_config_rst_doc..[s8\|!A|sz :trait type: N@=z...z\nz\\nz:default: ``%s``z :CLI option: )__name__sorted class_traitsitems __class__namehelprstripr#r rr$valuesr default_valuedefault_value_repr Exceptionr"replacer)) cls trait_aliaseslines classname_traitttypefullnamer>dvr fmt_aliasess rclass_config_rst_docrOHs E I3++4+8>>@A((s?ejj&6B7 %0"55zz  "6&6 VF4L)D01 U? LL tyy8\u||8\/\ \] ^ LL% 78 9 %U%8%8 9 9 ..0s8b=cr(U*Ckk%1 V$6$<=>  "()@AK LL+ => ?  RIBL 99U #  s;G.. G=<G=c[[5nURR5Hup#XR U5 M UR R5HxunupV[ U5S:XdM[[U55nXWn[ U5S:XdMB[[U55n XSLdM_XS-U -R U5 Mz U$)zBProduce a mapping of trait names to lists of command line aliases.rTr,) rrr%r;r#flagsr"nextiter) rresaliasrJflagcfgrIrHcls_cfg traitnames rreverse_aliasesrZxs d C ))+  % , ))//+hs s8q=T#YInG7|q  g/ %-C)34;;DA, Jrc[U5n[US5nURUS-5 URS[U5-S-5 URS5 UbURUS-5 UR 5H.nUR[ Xd55 URS5 M0 SSS5 g!,(df  g=f)aaWrite 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 )rZopenwriter"_classes_inc_parentsrO)pathtitlerpreamblerFfcs r write_docrfs$C(M dCA   s5z!T)*    GGHv% &))+A GG(: ; GGDM, s BC C)rt.Anyreturndict[str, t.Any])rrgrhr)r%z list[str]rhr)rEztype[HasTraits]rFrirhr)rrrhzdict[str, list[str]])N) rarrbrrrrcz str | NonerhNone)__doc__ __future__rtypingt collectionsrtextwrapr traitletsrrtraitlets.config.applicationrtraitlets.utils.textr rrr)rOrZrfr1rrrtsB!D##*4'E-`(r