[OpenStack-docs] [doc-tools] Switching to jinja for automated file generation
Gauvain Pocentek
gauvain.pocentek at objectif-libre.com
Mon Nov 9 05:45:54 UTC 2015
Hi,
We have several scripts in openstack-doc-tools that generate files
(openstack-auto-commands, autohelp.py and related tools). These scripts
either use lxml or `print` statements to build the output. Updates are
often painful, and the migration to RST will probably not make things
easier.
I've updated diff_branches.py to use jinja templating instead of lxml
as a POC, and I'm quite happy with the result. The code is shorter,
easier to read, and the template system gives a much better view of
whatt the output will look like. The RST migration will now be very easy
to handle. Here's the patch: https://review.openstack.org/#/c/242936/
Do you think it's a good idea to migrate the other tools to jinja?
Thanks,
Gauvain
More information about the OpenStack-docs
mailing list