ó mÜJ]c@`sÚdZddlmZmZmZmZddlZejeƒZ ddl Z ddl Z ddl m Z ddlmZddlmZdd lmZmZdd lmZdZd efd„ƒYZd„ZdS(u Thoroughly document Bokeh options classes. The ``bokeh-options`` directive will automatically document all the properties of a Bokeh Options class under a heading of "Keyword Args". This directive takes the name of a Bokeh Options subclass as the argument, and its module as an option: .. code-block:: rest .. bokeh-options:: Opts :module: bokeh.sphinxext.sample Examples -------- For the following definition of ``bokeh.sphinxext.sample.Opts``: .. code-block:: python 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 i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t unchanged(t SphinxErrori(tOptionsi(tBokehDirectivet py_sig_re(tOPTIONS_DETAILuBokehOptionsDirectiveusetuptBokehOptionsDirectivecB`s0eZeZdZdZied6Zd„ZRS(iumodulec C`sÎdj|jƒ}tj|ƒ}|dkr@td|ƒ‚n|jƒ\}}}}|jd}ytj |ƒ}Wn't k r¡td||fƒ‚nXt ||dƒ} | dkrÜtd|||fƒ‚nt | t ƒstd||fƒ‚n| iƒ} g} x“t| jƒƒD]} t | j| ƒ} | jtd| d| jjƒd t| j| ƒƒd | jdkrŒd ntj| jjƒƒƒƒq)Wtjd | ƒ}|j|d ƒS(Nu u/Unable to parse signature for bokeh-options: %rumoduleuEUnable to generate reference docs for %s, couldn't import module '%s'u?Unable to generate reference docs for %s, no options '%s' in %suSUnable to generate reference docs for %s, options '%s' is not a subclass of Optionstnamettypetdefaulttdocutoptsu(tjoint argumentsRtmatchtNoneRtgroupstoptionst importlibt import_modulet ImportErrortgetattrt issubclassRtsortedt propertiest __class__tappendtdicttpropertyt _sphinx_typetreprtinstance_defaultt__doc__ttextwraptdedenttrstripR trendert_parse(tselftsigtmt name_prefixt options_nametarglisttretannt module_nametmoduleRt options_objRt prop_namet descriptortrst_text((s<lib/python2.7/site-packages/bokeh/sphinxext/bokeh_options.pytrun\s4      5( t__name__t __module__tTruet has_contenttrequired_argumentstoptional_argumentsRt option_specR7(((s<lib/python2.7/site-packages/bokeh/sphinxext/bokeh_options.pyR Ss  cC`s|jddtƒdS(u+ Required Sphinx extension setup function. upyu bokeh-optionsN(tadd_directive_to_domainR (tapp((s<lib/python2.7/site-packages/bokeh/sphinxext/bokeh_options.pytsetup‚s(uBokehOptionsDirectiveusetup(R$t __future__RRRRtloggingt getLoggerR8tlogRR%tdocutils.parsers.rst.directivesRt sphinx.errorsRt util.optionsRtbokeh_directiveRRt templatesR t__all__R RA(((s<lib/python2.7/site-packages/bokeh/sphinxext/bokeh_options.pyt&s"    /