B @\K@sdZddlmZmZmZmZddlZeeZ ddl Z ddl Z ddl m Z ddlmZddlmZdd lmZmZdd lmZd ZGd d d eZddZdS)a Thoroughly document Bokeh model classes. The ``bokeh-model`` directive will automatically document all the attributes (including Bokeh properties) of a Bokeh model class. A JSON prototype showing all the possible JSON fields will also be generated. This directive takes the path to a Bokeh model class as an argument:: .. bokeh-model:: Foo :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Foo``:: class Foo(Model): ''' This is a Foo model. ''' index = Either(Auto, Enum('abc', 'def', 'xzy'), help="doc for index") value = Tuple(Float, Float, help="doc for value") the above usage yields the output: .. bokeh-model:: Foo :module: bokeh.sphinxext.sample )absolute_importdivisionprint_functionunicode_literalsN) unchanged) SphinxError) MetaModel)BokehDirective py_sig_re) MODEL_DETAIL)BokehModelDirectivesetupc@s(eZdZdZdZdZdeiZddZdS)rTr rmodulec Csd|j}t|}|dkr*td||\}}}}|jd}yt|}Wn$t k rvtd||fYnXt ||d} | dkrtd|||ft | t krtd||f| } t j| jdddd d d } tj||| d } || d S)N z-Unable to parse signature for bokeh-model: %rrzEUnable to generate reference docs for %s, couldn't import module '%s'z=Unable to generate reference docs for %s, no model '%s' in %szMUnable to generate reference docs for %s, model '%s' is not of type MetaModelT)Zinclude_defaultsr),z: )Z sort_keysindentZ separators)name module_name model_jsonz )joinZ argumentsr matchrgroupsZoptions importlib import_module ImportErrorgetattrtyper jsondumpsZto_jsonr Zrender_parse) selfZsigmZ name_prefixZ model_nameZarglistZretannrrmodelZ model_objrZrst_textr%:lib/python3.7/site-packages/bokeh/sphinxext/bokeh_model.pyrun[s4       zBokehModelDirective.runN) __name__ __module__ __qualname__Z has_contentZrequired_argumentsZoptional_argumentsrZ option_specr'r%r%r%r&rQs rcCs|ddtdS)Npyz bokeh-model)Zadd_directive_to_domainr)Zappr%r%r&rsr)__doc__Z __future__rrrrZloggingZ getLoggerr(logrrZdocutils.parsers.rst.directivesrZ sphinx.errorsrr$r Zbokeh_directiver r Z templatesr __all__rrr%r%r%r&$s      1