1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
import os
import sys
from docutils import nodes, utils
from docutils.parsers.rst import Directive
from sphinx import addnodes
from sphinx.errors import SphinxError
from sphinx.util.nodes import split_explicit_title, process_index_entry, set_role_source_info
from htc_helpers import make_headerlink_node, warn
DAG_CMD_DEFS = []
def dump(obj):
for attr in dir(obj):
print("obj.%s = %r" % (attr, getattr(obj, attr)))
def dagcom_def_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
global DAG_CMD_DEFS
if text in DAG_CMD_DEFS:
docname = inliner.document.settings.env.docname
warn(f"{docname} @ {lineno} | '{text}' DAG command already defined!")
textnode = nodes.Text(text, " ")
return [textnode], []
DAG_CMD_DEFS.append(text)
# Create a new linkable target using the subcom name
targetid = text
targetnode = nodes.target('', text, ids=[targetid], classes=["dag-cmd-def"])
headerlink_node = make_headerlink_node(str(text), options)
# Automatically include an index entry for subcom definitions
indexnode = addnodes.index()
indexnode['entries'] = process_index_entry('pair: ' + text + '; DAG Commands', targetid)
set_role_source_info(inliner, lineno, indexnode)
textnode = nodes.Text(" ", " ")
return [headerlink_node, indexnode, targetnode, textnode], []
def setup(app):
app.add_role("dag-cmd-def", dagcom_def_role)
|
