python-docx-ng

python-docx-ng is a Python library for creating and updating Microsoft Word (.docx) files. It was originally designed and developed by scanny as python-docx. As he is not actively developing his repo and there are soo many useful pull requests, bringing together a more powerful tool. This repo should merge a lot of those things and create a more powerful version, hopefully bearing the original structure of scanny in mind.

A new documentation section will be build up soon based on Markdown in the docs section. Examples can be found here: examples Older information is available in the python-docx Documentation.

Installation

pip install python-docx-ng

Hint: The library is called docx in python scripts, so use imports like import docx.

Features

• Word 16 (Office 2019) Template (54a1269)
• Faster & improved tables (#1)
• SVG support (#4)
• Font scaling (#6)
• Outline level (#7) - shows outline in navigation (e.g. Word or PDF application - not affecting the document itself)
• RGB color font highlighting (#14)
• Hyperlink text (#16)
• .docm file support (#19) - enables marco documents
• Form fields & AltChunk support (#20)
• Custom namespaces (#21)
• Performance improvements
  • Paragraph.text ([#3}(toxicphreAK#3)
  • Cache for table cells (#8)
• Fixes
  • add_picture (#10) - fix next_id to support multiple pictures
  • Heading 1 key error due to style capitalization (e.g. in LibreOffice) (#12)
  • Fix XPath for sectPr in document (#15)
  • Reproducible documents (#17) - same binary output with same data
  • AttValue too long in etree xml parser (#24)

Roadmap

• Document all functionallities building a new sample document with all (most) features included
• Remove code references to original repo of python-docx
• Setup new docs (markdown based)
• Add missing tests