ó mÜJ]c@`sÚdZddlmZmZmZmZddlZejeƒZ ddl Z ddl Z ddl m Z ddlmZddlmZdd lmZmZdd lmZdZd efd„ƒYZd„ZdS(uç Thoroughly document Bokeh model classes. The ``bokeh-model`` directive will automatically document all the attributes (including Bokeh properties) of a Bokeh Model subclass. A JSON prototype showing all the possible JSON fields will also be generated. This directive takes the name of a Bokeh model class as an argument and its module as an option: .. code-block:: rest .. bokeh-model:: Foo :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Foo``: .. code-block:: python 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 The ``bokeh-model`` 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(t MetaModeli(tBokehDirectivet py_sig_re(t MODEL_DETAILuBokehModelDirectiveusetuptBokehModelDirectivecB`s0eZeZdZdZied6Zd„ZRS(iumodulec C`skdj|jƒ}tj|ƒ}|dkr@td|ƒ‚n|jƒ\}}}}|jd}ytj |ƒ}Wn't k r¡td||fƒ‚nXt ||dƒ} | dkrÜtd|||fƒ‚nt | ƒt krtd||fƒ‚n| ƒ} tj| jdtƒdtd d d dƒ} tjd|d|d| ƒ} |j| dƒS(Nu u-Unable to parse signature for bokeh-model: %rumoduleuEUnable to generate reference docs for %s, couldn't import module '%s'u=Unable to generate reference docs for %s, no model '%s' in %suMUnable to generate reference docs for %s, model '%s' is not of type MetaModeltinclude_defaultst sort_keystindentit separatorsu,u: tnamet module_namet model_jsonu (u,u: (tjoint argumentsRtmatchtNoneRtgroupstoptionst importlibt import_modulet ImportErrortgetattrttypeRtjsontdumpstto_jsontTrueR trendert_parse( tselftsigtmt name_prefixt model_nametarglisttretannRtmoduletmodelt model_objRtrst_text((s:lib/python2.7/site-packages/bokeh/sphinxext/bokeh_model.pytrun`s4        ( t__name__t __module__R t has_contenttrequired_argumentstoptional_argumentsRt option_specR.(((s:lib/python2.7/site-packages/bokeh/sphinxext/bokeh_model.pyR Ws  cC`s|jddtƒdS(u+ Required Sphinx extension setup function. upyu bokeh-modelN(tadd_directive_to_domainR (tapp((s:lib/python2.7/site-packages/bokeh/sphinxext/bokeh_model.pytsetup‡s(uBokehModelDirectiveusetup(t__doc__t __future__RRRRtloggingt getLoggerR/tlogRRtdocutils.parsers.rst.directivesRt sphinx.errorsRR+Rtbokeh_directiveRRt templatesR t__all__R R7(((s:lib/python2.7/site-packages/bokeh/sphinxext/bokeh_model.pyt*s"    0