-eYdZddlmZddlZejeZddlZddlZddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZmZdd lmZd ZGd deZdZdS)a Thoroughly document Bokeh options classes. The ``bokeh-options`` directive will automatically document all the properties of a Bokeh Options class under a heading of "Keyword Args". This directive takes the name of a Bokeh Options subclass as the argument, and its module as an option: .. code-block:: rest .. bokeh-options:: Opts :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Opts``: .. code-block:: python class Opts(Options): ''' This is an Options class ''' host = String(default="localhost", help="a host to connect to") port = Int(default=5890, help="a port to connect to") the above usage yields the output: .. bokeh-options:: Opts :module: bokeh.sphinxext.sample To enable this extension, add `"bokeh.sphinxext.bokeh_options"` to the extensions list in your Sphinx configuration module. ) annotationsN) unchanged) SphinxError) type_link)Options) PARALLEL_SAFE)BokehDirective py_sig_re)OPTIONS_DETAIL)BokehOptionsDirectivesetupc(eZdZdZdZdZdeiZdZdS)r Trmodulec d|j}tj|}|t d||\}}}}|jd} tj|}n##t$rt d|d|wxYwt||d} | t d|d|t| tst d|d | i} g} t| D]} | | } | t#| t%| jt)| | | jd n*t/j| j t5j| }||d S)N z-Unable to parse signature for bokeh-options: rz.Unable to generate options reference docs for z, couldn't import module z6Unable to generate options reference docs: no options z in module z+Unable to generate options reference docs: z is not a subclass of Options)nametypedefaultdoc)optsz)join argumentsr matchrgroupsoptions importlib import_module ImportErrorgetattr issubclassrsorted propertieslookupappenddictrpropertyreprinstance_default__doc__textwrapdedentrstripr renderparse)selfsigm name_prefix options_namearglistretann module_namerr options_objr prop_name descriptorrst_texts =lib/python3.11/site-packages/bokeh/sphinxext/bokeh_options.pyrunzBokehOptionsDirective.runbs,hht~&& OC  9UcUUVV V56XXZZ2 \7Fl8,  E,[99FF E E ED|DDwBDDEE E E&,55 ?}Wc}}p{}}~~ ~'7++ ywLwwwxx xgbkk  6 6 8 899  I$++I66J KK"":#677 !j>j     "(d333zz($5666s *A?? BN) __name__ __module__ __qualname__ has_contentrequired_argumentsoptional_argumentsr option_specr>r=r r [s>KY'K&7&7&7&7&7rGr cH|ddttS)z+ Required Sphinx extension setup function. pyz bokeh-options)add_directive_to_domainr r )apps r=rrs!o7LMMM rG)r+ __future__rlogging getLoggerr?logrr,docutils.parsers.rst.directivesr sphinx.errorsrbokeh.core.property._sphinxrbokeh.util.optionsrrr bokeh_directiver r templatesr __all__r rrFrGr=rWs+""N#"""""g!!655555%%%%%%211111&&&&&&66666666%%%%%%  -7-7-7-7-7N-7-7-7`rG