-e dZddlmZddlZejeZddlmZddl Z ddl m Z m Z ddl mZddlmZdd lmZd Zd Zdd Zdd ZddZddZddZddZdZddZdS)ag Simplify linking to Bokeh Github resources. This module provides roles that can be used to easily reference information from various sources in the Bokeh project structure: ``:bokeh-commit:`` : link to a specific commit ``:bokeh-issue:`` : link to an issue ``:bokeh-minpy:`` : provide the minimum supported Python version ``:bokeh-pull:`` : link to a pull request ``:bokeh-requires:`` : list the install requires from pyproject.toml ``: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. To enable this extension, add `"bokeh.sphinxext.bokeh_roles"` to the extensions list in your Sphinx configuration module. ) annotationsN)join)nodesutils) set_classes) PARALLEL_SAFE) _REPO_TOP) bokeh_commit bokeh_issue bokeh_minpy bokeh_pullbokeh_requires bokeh_treesetupzhttps://github.com/bokeh/bokehc b|jjjj}t ||ddd||}|ggfS)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. commitzcommit )documentsettingsenvapp_make_gh_link_node) namerawtexttextlinenoinlineroptionscontentrnodes ;lib/python3.11/site-packages/bokeh/sphinxext/bokeh_roles.pyr r `s;   # ' +C c7Hi4QX Y YD 62:c R|jjjj} t |}|dkrt nM#t $r@|jd|d|} |||| } | g| gfcYSwxYwt||dddt||} | ggfS)rrzAGithub issue number must be a number greater than or equal to 1; is invalid.lineissue#issues rrrrint ValueErrorreportererror problematicrstr rrrrrrr r issue_nummsgprbr!s r"r r ms   # ' +CII >>   $$%}im%}%}%}EK$LL!!'7C88use| c7GS(C NNT[ \ \D 62:5AA?>A?ctjttd}t j|ddd}|ggfS)zProvide the minimum supported Python version from pyproject.toml. 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. pyproject.tomlprojectzrequires-pythonz>=)tomlloadrr rTextlstrip) rrrrrrr pyprojectr!s r"r r sR $y*:;;<>   $$&Ept&E&E&ELR$SS!!'7C88use| c7FOVSQZ^^]d e eD 62:r6ctjttd}t j}|ddD],} |t jdt j| z }-|ggfS)zProvide the list of required package dependencies for Bokeh. 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. r8r9 dependencies)r:r;rr r bullet_list list_itemr<) rrrrrrr r>r!deps r"rrsq $y*:;;<222LLz*** r#ctd|d|}|pi}t|tj||t j|fd|i|}|S)aReturn 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 rKrL)rNrrrOrunescape) rrrolekindapi_typeidrrQr!s r"rrso ' ' ' '2 ' 'CmG ?7t$AU^B-?-?$A$A Y Y# YQX Y YD Kr#)NN)N)__doc__ __future__rlogging getLogger__name__logos.pathrr:docutilsrrdocutils.parsers.rst.rolesrrCr utilr __all__rNr r r rrrrrr#r"rfsa%%T#"""""g!! !!!!!!!!222222   ,    *    *    <    r#