blob: 5689472991db3e9bc2ca4373f4924b1abda00333 [file] [log] [blame]
#!/usr/bin/env python
import re
import yaml
import sphinx
from sphinx.application import Sphinx
__version__ = '1.0'
# Variables substitutions. Uses {VAR} subst using variables defined in poky.yaml
# Each .rst file is processed after source-read event (subst_vars_replace runs once per file)
subst_vars = {}
def subst_vars_replace(app: Sphinx, docname, source):
result = source[0]
for k in subst_vars:
result = result.replace("&"+k+";", subst_vars[k])
source[0] = result
PATTERN = re.compile(r'&(.*?);')
def expand(val, src):
return PATTERN.sub(lambda m: expand(src.get(m.group(1), ''), src), val)
def setup(app: Sphinx):
#FIXME: if poky.yaml changes, files are not reprocessed.
with open("poky.yaml") as file:
subst_vars.update(yaml.load(file, Loader=yaml.FullLoader))
for k in subst_vars:
subst_vars[k] = expand(subst_vars[k], subst_vars)
app.connect('source-read', subst_vars_replace)
return dict(
version = __version__,
parallel_read_safe = True,
parallel_write_safe = True
)