ó mÜJ]c@`sÄdZddlmZmZmZmZddlZejeƒZ ddl Z ddl Z ddl m Z ddlmZddlmZddlmZdZd efd „ƒYZd „ZdS(u  Thoroughly document Bokeh property attributes. The ``bokeh-prop`` directive generates documentation for Bokeh model properties, including cross links to the relevant property types. Additionally, any per-attribute help strings are also displayed. This directive takes the name *(class.attr)* of a Bokeh property as its argument and the module as an option: .. code-block:: rest .. bokeh-prop:: Bar.thing :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Bar``: .. code-block:: python 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 The ``bokeh-prop`` direction may be used explicitly, but it can also be used in conjunction with the :ref:`bokeh.sphinxext.bokeh_autodoc` extension. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t unchanged(t SphinxErrori(tBokehDirective(t PROP_DETAILuBokehPropDirectiveusetuptBokehPropDirectivecB`s0eZeZdZdZied6Zd„ZRS(iumodulec C`sn|jdjdƒ\}}ytj|jdƒ}Wn5tk rmtd|jd|jdfƒ‚nXt||dƒ}|dkr¶td|jd||jdfƒ‚n|ƒ}yt|j |ƒ}Wn1t k rtd|jd||fƒ‚nXt j d|d|jdd |j jƒd |jdkrId ntj|jƒƒ}|j|d ƒS( Niu.umoduleuDCould not generate reference docs for %r: could not import module %ru=Unable to generate reference docs for %s, no model '%s' in %su@Unable to generate reference docs for %s, no property '%s' in %stnametmodulet type_infotdocuu (t argumentstrsplitt importlibt import_moduletoptionst ImportErrorRtgetattrtNonet __class__tAttributeErrorRtrendertpropertyt _sphinx_typet__doc__ttextwraptdedentt_parse(tselft model_namet prop_nameR tmodelt model_objt descriptortrst_text((s9lib/python2.7/site-packages/bokeh/sphinxext/bokeh_prop.pytrun^s& ( *  $  *( t__name__t __module__tTruet has_contenttrequired_argumentstoptional_argumentsRt option_specR%(((s9lib/python2.7/site-packages/bokeh/sphinxext/bokeh_prop.pyRUs  cC`s|jddtƒdS(u+ Required Sphinx extension setup function. upyu bokeh-propN(tadd_directive_to_domainR(tapp((s9lib/python2.7/site-packages/bokeh/sphinxext/bokeh_prop.pytsetup{s(uBokehPropDirectiveusetup(Rt __future__RRRRtloggingt getLoggerR&tlogRRtdocutils.parsers.rst.directivesRt sphinx.errorsRtbokeh_directiveRt templatesRt__all__RR/(((s9lib/python2.7/site-packages/bokeh/sphinxext/bokeh_prop.pyt)s"    &