Python docx template engine
Project description
Use a docx as a jinja2 template
Introduction
This package uses 2 major packages :
python-docx for reading, writing and creating sub documents
jinja2 for managing tags inserted into the template docx
python-docx-template has been created because python-docx is powerful for creating documents but not for modifying them.
The idea is to begin to create an example of the document you want to generate with microsoft word, it can be as complex as you want : pictures, index tables, footer, header, variables, anything you can do with word. Then, as you are still editing the document with microsoft word, you insert jinja2-like tags directly in the document. You save the document as a .docx file (xml format) : it will be your .docx template file.
Now you can use python-docx-template to generate as many word documents you want from this .docx template and context variables you will associate.
Documentation
Please, read the doc
Other projects
Have a look at some of my other projects :
python-textops3 : Chainable text operations
django-robohash-svg : Create svg robots avatars
News
0.15.2 (2022-01-12)
fix #408
0.15.1 (2021-12-20)
Multi-rendering with same DocxTemplate object is now possible see tests/multi_rendering.py
fix #392
fix #398
0.14.1 (2021-10-01)
One can now use python -m docxtpl on command line to generate a docx from a template and a json file as a context Thanks to Lcrs123@github
0.12.0 (2021-08-15)
Code has be split into many files for better readability
Use docxcomposer to attach parts when a docx file is given to create a subdoc Images, styles etc… must now be taken in account in subdocs
Some internal XML IDs are now renumbered to avoid collision, thus images are not randomly disapearing anymore.
fix #372
fix #374
fix #375
fix #369
fix #368
fix #347
fix #181
fix #61
0.11.5 (2021-05-09)
PR #351
It is now possible to put InlineImage in header/footer
fix #323
fix #320
\n, \a, \t and \f are now accepted in simple context string. Thanks to chabErch@github
0.10.5 (2020-10-15)
Remove extension testing (#297)
Fix spaces missing in some cases (#116, #227)
0.9.2 (2020-04-26)
Fix #271
Code styling
0.8.1 (2020-04-14)
fix #266
docxtpl is now able to use latest python-docx (0.8.10). Thanks to Dutchy-@github.
0.7.0 (2020-04-09)
Add replace_zipname() method to replace Excel and PowerPoint embedded files
0.6.4 (2020-04-06)
Add the possibility to add RichText to a Richtext
Prevent lxml from attempting to parse None
PR #207 and #209
Handle spaces correctly when run are split by Jinja code (#205)
PR #203
DocxTemplate now accepts file-like objects (Thanks to edufresne)
0.5.20 (2019-05-23)
Fix #199
Add support for file-like objects for replace_media (#197)
Fix #176
Delegated autoescaping to Jinja2 Environment (#175)
Force to use python-docx 0.8.7 (#170)
Add getting undeclared variables in the template (#171)
Added PAGE_BREAK feature (#168)
Fixed issue #159: autoescaped values for both str and unicode.
Fix tables with gridSpan that have less cells after the tc forloop (#164)
Smart double quotes in jinja tags are now converted into simple double quotes
Smart quotes in jinja tags are now converted into simple quotes
Add custom jinja filter example in tests/
Reformat the code to be a little more PEP8 compliant
Add {% hm %} tag for table columns horizontal merging (Thanks to nickgashkov)
Split tests/tests_files dir into templates and output dirs
autoescape support for python 2.7
fix issue #154
Render can now autoescape context dict
Fix invalid xml parse because using {% vm %}
Cast to string non-string value given to RichText or Listing objects
Import html.escape instead of cgi.escape (deprecated)
Declare package as python2 and python3 compatible for wheel distrib
Add sub/superscript in RichText
Fix table vertical merge
An hyperlink can now be used in RichText
0.4.13 (2018-06-21)
Subdocument can now be based on an existing docx
Add font option in RichText
Better tabs and spaces management for MS Word 2016
Wheel distribution
Manage autoscaping on InlineImage, Richtext and Subdoc
Purge MANIFEST.in file
Accept variables starting with ‘r’ in {{}} when no space after {{
Remove debug traces
Add {% vm %} to merge cell vertically within a loop (Thanks to Arthaslixin)
use six.iteritems() instead of iteritems for python 3 compatibility
Fixed Bug #95 on replace_pic() method
Add replace_pic() method to replace pictures from its filename (Thanks to Riccardo Gusmeroli)
Improve image attachment for InlineImage ojects
Add replace_media() method (useful for header/footer images)
Add replace_embedded() method (useful for embedding docx)
0.3.9 (2017-06-27)
Fix exception in fix_table()
Fix bug when using more than one {{r }} or {%r %} in the same run
Fix git tag v0.3.6 was in fact for 0.3.5 package version so create a tag 0.3.7 for 0.3.7 package version
Better head/footer jinja2 handling (Thanks to hugokernel)
Fix bug where one is using ‘%’ (modulo operator) inside a tag
Add Listing class to manage n and a (new paragraph) and escape text AND keep current styling
Add {%tc } tags for dynamic table columns (Thanks to majkls23)
Remove version limitation over sphinx package in setup.py
Add PNG & JPEG in tests/test_files/
You can now add images directly without using subdoc, it is much more faster.
0.2.5 (2017-01-14)
Add dynamic colspan tag for tables
Fix /n in RichText class
Add Python 3 support for footer and header
Fix bug when using utf-8 chracters inside footer or header in .docx template It now detects header/footer encoding automatically
Fix bug where using subdocs is corrupting header and footer in generated docx Thanks to Denny Weinberg for his help.
Add Header and Footer support (Thanks to Denny Weinberg)
0.1.11 (2016-03-1)
‘>’ and ‘<’ can now be used inside jinja tags
render() accepts optionnal jinja_env argument : useful to set custom filters and other things
better subdoc management : accept tables
better xml code cleaning around Jinja2 tags
python 3 support
remove debug code
add lxml dependency
fix template filter with quote
add RichText support
add subdoc support
add some exemples in tests/
First running version
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for docxtpl-0.15.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de0988b2a7a92402d6da3aa9dec474cf3cfb941ed69927248a8e97d0ff50d6f9 |
|
MD5 | 113f9d9861507f0d855f1a9f3f60c1cd |
|
BLAKE2b-256 | 60524c6d6a0bc8c5059a9e1e0c86957eb92c20671b229e6e256fab773522aa32 |