datatemplates
datatemplates copied to clipboard
Sphinx plugin for generating RST on the fly from data files and templates.
When referring to an attribute that doesn't exist, no error is produced. To enable errors: ``` from jinja2 import StrictUndefined app.builder.templates.environment.undefined = StrictUndefined ``` The problem is that it enables...
This should help with #35 and with extending the CLI. - [x] Loader functions directly callable - [ ] CLI functionality directly avalable
By @dhellmann : We should also ensure that we are only exporting symbols we want someone else to import at the API level in the python code. Renaming some modules...
Add support for escaping RST for security and intuitive behaviour. - Either escape per default - then ideally something equivalent to [autoescaping](https://jinja.palletsprojects.com/en/2.10.x/api/#autoescaping) for RST. Propably writing a [Jinja extension](https://jinja.palletsprojects.com/en/2.10.x/extensions/) is...
Should we really use the Sphinx builder's Jinja Environment? At least escaping propably depends on the builder. Do we want that?
- Untrusted Sources/Templates - Memory exhaustion - Code injection - ...
Checking if the documentation can be built including examples is a test, too - but more rigorous testing should help further development.