B @\@@sdZddlmZmZmZmZddlZeeZ ddl Z ddl Z ddl m Z ddlmZddlmZddlmZd ZGd d d eZd d ZdS)a Thoroughly document Bokeh property attributes. The ``bokeh-prop`` directive generates useful type information for the property attribute, including cross links to the relevant property types. Additionally, any per-attribute docstrings are also displayed. This directive takes the path to an attribute on a Bokeh model class as an argument:: .. bokeh-prop:: Bar.thing :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Bar``:: class Bar(Model): ''' This is a Bar model. ''' thing = List(Int, help="doc for thing") the above usage yields the output: .. bokeh-prop:: Bar.thing :module: bokeh.sphinxext.sample )absolute_importdivisionprint_functionunicode_literalsN) unchanged) SphinxError)BokehDirective) PROP_DETAIL)BokehPropDirectivesetupc@s(eZdZdZdZdZdeiZddZdS)r TrmodulecCs|jdd\}}yt|jd}Wn0tk rXtd|jd|jdfYnXt||d}|dkrtd|jd||jdf|}yt|j|}Wn,t k rtd|jd||fYnXt j ||jd|j |jdkrdn t|jd}||d S) Nr.rzDCould not generate reference docs for %r: could not import module %rz=Unable to generate reference docs for %s, no model '%s' in %sz@Unable to generate reference docs for %s, no property '%s' in %s)namerZ type_infodocz )Z argumentsrsplit importlib import_moduleZoptions ImportErrorrgetattr __class__AttributeErrorr ZrenderpropertyZ _sphinx_type__doc__textwrapdedent_parse)selfZ model_nameZ prop_namerZmodelZ model_objZ descriptorZrst_textr 9lib/python3.7/site-packages/bokeh/sphinxext/bokeh_prop.pyrunXs&" zBokehPropDirective.runN) __name__ __module__ __qualname__Z has_contentZrequired_argumentsZoptional_argumentsrZ option_specr"r r r r!r Ns r cCs|ddtdS)Npyz bokeh-prop)Zadd_directive_to_domainr )Zappr r r!r usr )rZ __future__rrrrZloggingZ getLoggerr#logrrZdocutils.parsers.rst.directivesrZ sphinx.errorsrZbokeh_directiver Z templatesr __all__r r r r r r!"s      '