mirror of
https://github.com/github/codeql.git
synced 2025-12-16 16:53:25 +01:00
77 lines
2.5 KiB
Python
77 lines
2.5 KiB
Python
""" template renderer module, wrapping around `pystache.Renderer`
|
|
|
|
`pystache` is a python mustache engine, and mustache is a template language. More information on
|
|
|
|
https://mustache.github.io/
|
|
"""
|
|
|
|
import hashlib
|
|
import logging
|
|
import pathlib
|
|
|
|
import pystache
|
|
|
|
from . import paths
|
|
|
|
log = logging.getLogger(__name__)
|
|
|
|
|
|
def _md5(data):
|
|
return hashlib.md5(data).digest()
|
|
|
|
|
|
class Renderer:
|
|
""" Template renderer using mustache templates in the `templates` directory """
|
|
|
|
def __init__(self, dryrun=False):
|
|
""" Construct the renderer, which will not write anything if `dryrun` is `True` """
|
|
self.r = pystache.Renderer(search_dirs=str(paths.lib_dir / "templates"), escape=lambda u: u)
|
|
self.generator = paths.exe_file.relative_to(paths.swift_dir)
|
|
self.dryrun = dryrun
|
|
self.written = set()
|
|
self.skipped = set()
|
|
self.erased = set()
|
|
|
|
@property
|
|
def done_something(self):
|
|
return bool(self.written or self.erased)
|
|
|
|
@property
|
|
def rendered(self):
|
|
return self.written | self.skipped
|
|
|
|
def render(self, data, output: pathlib.Path):
|
|
""" Render `data` to `output`.
|
|
|
|
`data` must have a `template` attribute denoting which template to use from the template directory.
|
|
|
|
If the file is unchanged, then no write is performed (and `done_something` remains unchanged)
|
|
"""
|
|
mnemonic = type(data).__name__
|
|
output.parent.mkdir(parents=True, exist_ok=True)
|
|
data = self.r.render_name(data.template, data, generator=self.generator)
|
|
if output.is_file():
|
|
with open(output, "rb") as file:
|
|
if _md5(data.encode()) == _md5(file.read()):
|
|
log.debug(f"skipped {output.name}")
|
|
self.skipped.add(output)
|
|
return
|
|
if self.dryrun:
|
|
log.error(f"would have generated {mnemonic} {output.name}")
|
|
else:
|
|
with open(output, "w") as out:
|
|
out.write(data)
|
|
log.info(f"generated {mnemonic} {output.name}")
|
|
self.written.add(output)
|
|
|
|
def cleanup(self, existing):
|
|
""" Remove files in `existing` for which no `render` has been called """
|
|
for f in existing - self.written - self.skipped:
|
|
if f.is_file():
|
|
if self.dryrun:
|
|
log.error(f"would have removed {f.name}")
|
|
else:
|
|
f.unlink()
|
|
log.info(f"removed {f.name}")
|
|
self.erased.add(f)
|