Create and update Microsoft Word .docx files.
Project Description
python-docx is a Python library for creating and updating Microsoft Word (.docx) files.
More information is available in the python-docx documentation.
Release History
0.8.6 (2016-06-22)
- Add #257: add Font.highlight_color
- Add #261: add ParagraphFormat.tab_stops
- Add #303: disallow XML entity expansion
0.8.5 (2015-02-21)
- Fix #149: KeyError on Document.add_table()
- Fix #78: feature: add_table() sets cell widths
- Add #106: feature: Table.direction (i.e. right-to-left)
- Add #102: feature: add CT_Row.trPr
0.8.4 (2015-02-20)
- Fix #151: tests won’t run on PyPI distribution
- Fix #124: default to inches on no TIFF resolution unit
0.8.3 (2015-02-19)
- Add #121, #135, #139: feature: Font.color
0.8.2 (2015-02-16)
Fix #94: picture prints at wrong size when scaled
Extract
docx.document.Document
object fromDocumentPart
Refactor
docx.Document
from an object into a factory function for newdocx.document.Document object
. Extract methods from priordocx.Document
anddocx.parts.document.DocumentPart
to form the new API class and retiredocx.Document
class.Migrate
Document.numbering_part
toDocumentPart.numbering_part
. Thenumbering_part
property is not part of the published API and is an interim internal feature to be replaced in a future release, perhaps with something likeDocument.numbering_definitions
. In the meantime, it can now be accessed using Document.part.numbering_part.
0.8.1 (2015-02-10)
- Fix #140: Warning triggered on Document.add_heading/table()
0.8.0 (2015-02-08)
- Add styles. Provides general capability to access and manipulate paragraph, character, and table styles.
- Add ParagraphFormat object, accessible on Paragraph.paragraph_format, and
providing the following paragraph formatting properties:
- paragraph alignment (justfification)
- space before and after paragraph
- line spacing
- indentation
- keep together, keep with next, page break before, and widow control
- Add Font object, accessible on Run.font, providing character-level
formatting including:
- typeface (e.g. ‘Arial’)
- point size
- underline
- italic
- bold
- superscript and subscript
The following issues were retired:
- Add feature #56: superscript/subscript
- Add feature #67: lookup style by UI name
- Add feature #98: Paragraph indentation
- Add feature #120: Document.styles
Backward incompatibilities
Paragraph.style now returns a Style object. Previously it returned the style
name as a string. The name can now be retrieved using the Style.name
property, for example, paragraph.style.name
.
0.7.6 (2014-12-14)
- Add feature #69: Table.alignment
- Add feature #29: Document.core_properties
0.7.5 (2014-11-29)
- Add feature #65: _Cell.merge()
0.7.4 (2014-07-18)
- Add feature #45: _Cell.add_table()
- Add feature #76: _Cell.add_paragraph()
- Add _Cell.tables property (read-only)
0.7.3 (2014-07-14)
- Add Table.autofit
- Add feature #46: _Cell.width
0.7.2 (2014-07-13)
- Fix: Word does not interpret <w:cr/> as line feed
0.7.1 (2014-07-11)
- Add feature #14: Run.add_picture()
0.7.0 (2014-06-27)
- Add feature #68: Paragraph.insert_paragraph_before()
- Add feature #51: Paragraph.alignment (read/write)
- Add feature #61: Paragraph.text setter
- Add feature #58: Run.add_tab()
- Add feature #70: Run.clear()
- Add feature #60: Run.text setter
- Add feature #39: Run.text and Paragraph.text interpret ‘n’ and ‘t’ chars
0.6.0 (2014-06-22)
- Add feature #15: section page size
- Add feature #66: add section
- Add page margins and page orientation properties on Section
- Major refactoring of oxml layer
0.5.3 (2014-05-10)
- Add feature #19: Run.underline property
0.5.2 (2014-05-06)
- Add feature #17: character style
0.5.1 (2014-04-02)
- Fix issue #23,
Document.add_picture()
raises ValueError when document contains VML drawing.
0.5.0 (2014-03-02)
- Add 20 tri-state properties on Run, including all-caps, double-strike, hidden, shadow, small-caps, and 15 others.
0.4.0 (2014-03-01)
- Advance from alpha to beta status.
- Add pure-python image header parsing; drop Pillow dependency
0.3.0a5 (2014-01-10)
- Hotfix: issue #4, Document.add_picture() fails on second and subsequent images.
0.3.0a4 (2014-01-07)
- Complete Python 3 support, tested on Python 3.3
0.3.0a3 (2014-01-06)
- Fix setup.py error on some Windows installs
0.3.0a1 (2014-01-05)
- Full object-oriented rewrite
- Feature-parity with prior version
- text: add paragraph, run, text, bold, italic
- table: add table, add row, add column
- styles: specify style for paragraph, table
- picture: add inline picture, auto-scaling
- breaks: add page break
- tests: full pytest and behave-based 2-layer test suite
0.3.0dev1 (2013-12-14)
- Round-trip .docx file, preserving all parts and relationships
- Load default “template” .docx on open with no filename
- Open from stream and save to stream (file-like object)
- Add paragraph at and of document
Release history Release notifications
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size & hash SHA256 hash help | File type | Python version | Upload date |
---|---|---|---|
python-docx-0.8.6.tar.gz (5.3 MB) Copy SHA256 hash SHA256 | Source | None | Jun 22, 2016 |