σ mάJ]c@`sΚdZddlmZmZmZmZddlZejeƒZ ddl m Z m Z ddl mZdZddd „Zddd „Zddd „Zddd„Zd„ZdZdd„ZdS(uZ Simplify linking to Bokeh Github resources. This module proved four new roles that can be uses to easily link to various resources in the Bokeh Github repository: ``:bokeh-commit:`` : link to a specific commit ``:bokeh-issue:`` : link to an issue ``:bokeh-pull:`` : link to a pull request ``:bokeh-tree:`` : (versioned) link to a source tree URL Examples -------- The following code: .. code-block:: rest The repo history shows that :bokeh-commit:`bf19bcb` was made in in :bokeh-pull:`1698`, which closed :bokeh-issue:`1694`. This included updating all of the files in the :bokeh-tree:`examples` subdirectory. yields the output: The repo history shows that :bokeh-commit:`bf19bcb` was made in in :bokeh-pull:`1698`,which closed :bokeh-issue:`1694`. This included updating all of the files in the :bokeh-tree:`examples` subdirectory. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tnodestutils(t set_classesu bokeh_commitu bokeh_issueu bokeh_pullu bokeh_treeusetupc C`s=|jjjj}t||ddd||ƒ}|ggfS(uΉ Link to a Bokeh Github issue. Returns 2 part tuple containing list of nodes to insert into the document and a list of system messages. Both are allowed to be empty. ucommitucommit (tdocumenttsettingstenvtappt_make_gh_link_node( tnametrawtextttexttlinenotinlinertoptionstcontentR tnode((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pyt bokeh_commitOsc C`sΊ|jjjj}y%t|ƒ}|dkr6t‚nWnOtk rˆ|jjd|d|ƒ} |j||| ƒ} | g| gfSXt ||dddt |ƒ|ƒ} | ggfS(uΉ Link to a Bokeh Github issue. Returns 2 part tuple containing list of nodes to insert into the document and a list of system messages. Both are allowed to be empty. iuQGithub issue number must be a number greater than or equal to 1; "%s" is invalid.tlineuissueu#uissues( RRR R tintt ValueErrortreporterterrort problematicR tstr( R R RRRRRR t issue_numtmsgtprbR((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pyt bokeh_issue[s     $c C`sΊ|jjjj}y%t|ƒ}|dkr6t‚nWnOtk rˆ|jjd|d|ƒ} |j||| ƒ} | g| gfSXt ||dddt |ƒ|ƒ} | ggfS(uΉ Link to a Bokeh Github issue. Returns 2 part tuple containing list of nodes to insert into the document and a list of system messages. Both are allowed to be empty. iuXGithub pull request number must be a number greater than or equal to 1; "%s" is invalid.Rupullu pull request ( RRR R RRRRRR R( R R RRRRRR RRRR((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pyt bokeh_pullqs     $c C`sˆ|jjjj}|jjd}d|kr7d}ndt||f} |pSi}t|ƒtj||d| |} | ggfS(uς Link to a URL in the Bokeh GitHub tree, pointing to appropriate tags for releases, or to master otherwise. The link text is simply the URL path supplied, so typical usage might look like: .. code-block:: none All of the examples are located in the :bokeh-tree:`examples` subdirectory of your Bokeh checkout. Returns 2 part tuple containing list of nodes to insert into the document and a list of system messages. Both are allowed to be empty. uversionu-umasteru %s/tree/%s/%strefuri( RRR R tconfigt _BOKEH_GHRRt reference( R R RRRRRR ttagturlR((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pyt bokeh_tree‡s    cC`sD|jdtƒ|jdtƒ|jdtƒ|jdtƒdS(u+ Required Sphinx extension setup function. u bokeh-commitu bokeh-issueu bokeh-pullu bokeh-treeN(tadd_roleRRR R'(R ((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pytsetup€suhttps://github.com/bokeh/bokehc C`sUdt||f}|pi}t|ƒtj||tj|ƒd||}|S(u– Return a link to a Bokeh Github resource. Args: app (Sphinx app) : current app rawtext (str) : text being replaced with link node. role (str) : role name kind (str) : resource type (issue, pull, etc.) api_type (str) : type for api link id : (str) : id of the resource to link to options (dict) : options dictionary passed to role function u%s/%s/%sR!(R#RRR$Rtunescape( R R troletkindtapi_typetidRR&R((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pyR ±s   "(u bokeh_commitu bokeh_issueu bokeh_pullu bokeh_treeusetup(t__doc__t __future__RRRRtloggingt getLoggert__name__tlogtdocutilsRRtdocutils.parsers.rst.rolesRt__all__tNoneRRR R'R)R#R (((s;lib/python2.7/site-packages/bokeh/sphinxext/bokeh_github.pyt%s""