B @\@sdZddlmZmZmZmZddlZeeZ ddl Z ddl Z ddl m Z ddlmZddlmZdd lmZmZdd lmZd ZGd d d eZddZdS)a Thoroughly document Bokeh options classes. The ``bokeh-options`` directive will automatically document all the properties) of a Bokeh Options class. This directive takes the path to a Bokeh model class as an argument:: .. bokeh-options:: Opts :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Opts``:: 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 )absolute_importdivisionprint_functionunicode_literalsN) unchanged) SphinxError)Options)BokehDirective py_sig_re)OPTIONS_DETAIL)BokehOptionsDirectivesetupc@s(eZdZdZdZdZdeiZddZdS)rTr rmodulec Cs@d|j}t|}|dkr*td||\}}}}|jd}yt|}Wn$t k rvtd||fYnXt ||d} | dkrtd|||ft | t std||f| i} g} xbt | D]R} t | j| } | t| | jt| | | jdkrdnt| jdqWtj| d }||d S) N z/Unable to parse signature for bokeh-options: %rrzEUnable to generate reference docs for %s, couldn't import module '%s'z?Unable to generate reference docs for %s, no options '%s' in %szSUnable to generate reference docs for %s, options '%s' is not a subclass of Options)nametypedefaultdoc)optsz)joinZ argumentsr matchrgroupsoptions importlib import_module ImportErrorgetattr issubclassr sortedZ properties __class__appenddictpropertyZ _sphinx_typereprZinstance_default__doc__textwrapdedentrstripr Zrender_parse)selfZsigmZ name_prefixZ options_nameZarglistZretannZ module_namerrZ options_objrZ prop_nameZ descriptorZrst_textr.$s      0