#!/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 )