U /e@sdZddlmZddlZeeZddlZddlZddl m Z ddl m Z ddl mZddlmZdd lmZdd lmZmZdd lmZd ZGd ddeZddZdS)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 ) annotationsN) unchanged) SphinxError) type_link)Options) PARALLEL_SAFE)BokehDirective py_sig_re)OPTIONS_DETAIL)BokehOptionsDirectivesetupc@s(eZdZdZdZdZdeiZddZdS)r Trmodulec CsBd|j}t|}|dkr,td||\}}}}|jd}zt|}Wn(t k r|td|d|YnXt ||d} | dkrtd|d|t | t std|d | i} g} t | D]P} | | } | t| t| jt| | | jdkrd nt| jd qtj| d }||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 issubclassrsortedZ propertieslookupappenddictrpropertyreprZinstance_default__doc__textwrapdedentrstripr renderparse)selfsigmZ name_prefixZ options_nameZarglistZretann module_namerrZ options_objrZ prop_nameZ descriptorZrst_textr0A/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/sphinxext/bokeh_options.pyrun_s:        zBokehOptionsDirective.runN) __name__ __module__ __qualname__Z has_contentZrequired_argumentsZoptional_argumentsrZ option_specr2r0r0r0r1r Xs r cCs|ddttS)z+ Required Sphinx extension setup function. pyz bokeh-options)Zadd_directive_to_domainr r)Zappr0r0r1r sr )r& __future__rlogging getLoggerr3logrr'Zdocutils.parsers.rst.directivesrZ sphinx.errorsrZbokeh.core.property._sphinxrZbokeh.util.optionsrrrZbokeh_directiver r Z templatesr __all__r r r0r0r0r1s$        0