Skip to main content
https://travis-ci.org/python-openxml/python-docx.svg?branch=master

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.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 from DocumentPart

    Refactor docx.Document from an object into a factory function for new docx.document.Document object. Extract methods from prior docx.Document and docx.parts.document.DocumentPart to form the new API class and retire docx.Document class.

  • Migrate Document.numbering_part to DocumentPart.numbering_part. The numbering_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 like Document.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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tp-python-docx-0.8.5.tar.gz (5.2 MB view details)

Uploaded Source

File details

Details for the file tp-python-docx-0.8.5.tar.gz.

File metadata

File hashes

Hashes for tp-python-docx-0.8.5.tar.gz
Algorithm Hash digest
SHA256 7241fc5d84c3386a22bed2284207d1e19faec01347f08a630231243e1ed10496
MD5 437a717da356371e8ffcb7f4e3267747
BLAKE2b-256 43c87079e77aa11a3b0e389c1231ad2b056df4e8f3185b24115504b10fd393b2

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.8.5 This release

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page