B @\C@sdZddlmZmZmZmZddlZeeZ ddl m Z m Z ddl mZdZdZddd Zdd d Zdd d ZdddZddZdddZdS)aE 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:: 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. )absolute_importdivisionprint_functionunicode_literalsN)nodesutils) set_classeszhttps://github.com/bokeh/bokeh)BOKEH_GH bokeh_commit bokeh_issue bokeh_pull bokeh_treesetupc Cs*|jjjj}t||ddd||}|ggfS)z 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. Zcommitzcommit )documentsettingsenvapp_make_gh_link_node) namerawtexttextlinenoinlineroptionscontentrnoder;lib/python3.7/site-packages/bokeh/sphinxext/bokeh_github.pyr Ps r c Cs|jjjj}yt|}|dkr"tWn>tk rb|jjd||d} |||| } | g| gfSXt ||dddt ||} | ggfS)z 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. rzQGithub issue number must be a number greater than or equal to 1; "%s" is invalid.)lineZissue#Zissues) rrrrint ValueErrorreportererror problematicrstr) rrrrrrrr issue_nummsgprbrrrrr \s  r c Cs|jjjj}yt|}|dkr"tWn>tk rb|jjd||d} |||| } | g| gfSXt ||dddt ||} | ggfS)z 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. rzXGithub pull request number must be a number greater than or equal to 1; "%s" is invalid.)rZpullz pull request ) rrrrr r!r"r#r$rr%) rrrrrrrrr&r'r(rrrrr rs  r c Csd|jjjj}|jjd}d|kr$d}dt||f} |p8i}t|tj||fd| i|} | ggfS)a 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. version-Zmasterz %s/tree/%s/%srefuri) rrrrZconfigr rr reference) rrrrrrrrtagurlrrrrr s  r cCs4|dt|dt|dt|dtdS)Nz bokeh-commitz bokeh-issuez bokeh-pullz bokeh-tree)Zadd_roler r r r )rrrrrs   rc CsDdt||f}|pi}t|tj||t|fd|i|}|S)a 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 z%s/%s/%sr+)r rrr,rZunescape) rrZroleZkindZapi_typeidrr.rrrrrs r)NN)NN)NN)NN)N)__doc__Z __future__rrrrZloggingZ getLogger__name__logZdocutilsrrZdocutils.parsers.rst.rolesrr __all__r r r r rrrrrr#s