Skip to main content

Create and update Microsoft Word .docx files.

Project description

.. image:: https://travis-ci.org/python-openxml/python-docx.svg?branch=master :target: https://travis-ci.org/python-openxml/python-docx

python-docx-valutico is a Python library for creating and updating Microsoft Word (.docx) files.

This is basically the same as python-docx, but with added support for charts.

More information is available in the python-docx documentation_.

.. _python-docx documentation: https://python-docx.readthedocs.org/en/latest/

.. :changelog:

Release History

0.8.11.1 (2022-03-21) +++++++++++++++++++

  • Add add_chart to document.

0.8.11 (2021-05-15) +++++++++++++++++++

  • Small build changes and Python 3.8 version changes like collections.abc location.

0.8.10 (2019-01-08) +++++++++++++++++++

  • Revert use of expanded package directory for default.docx to work around setup.py problem with filenames containing square brackets.

0.8.9 (2019-01-08) ++++++++++++++++++

  • Fix gap in MANIFEST.in that excluded default document template directory

0.8.8 (2019-01-07) ++++++++++++++++++

  • Add support for headers and footers

0.8.7 (2018-08-18) ++++++++++++++++++

  • Add _Row.height_rule
  • Add _Row.height
  • Add _Cell.vertical_alignment
  • Fix #455: increment next_id, don't fill gaps
  • Add #375: import docx failure on --OO optimization
  • Add #254: remove default zoom percentage
  • Add #266: miscellaneous documentation fixes
  • Add #175: refine MANIFEST.ini
  • Add #168: Unicode error on core-props in Python 2

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 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

Project details


Download files

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

Source Distribution

python-docx-valutico-0.8.11.6.tar.gz (5.5 MB view details)

Uploaded Source

Built Distribution

python_docx_valutico-0.8.11.6-py3-none-any.whl (185.6 kB view details)

Uploaded Python 3

File details

Details for the file python-docx-valutico-0.8.11.6.tar.gz.

File metadata

  • Download URL: python-docx-valutico-0.8.11.6.tar.gz
  • Upload date:
  • Size: 5.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.26.0 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/18.0.1 rfc3986/2.0.0 colorama/0.4.3 CPython/3.9.0+

File hashes

Hashes for python-docx-valutico-0.8.11.6.tar.gz
Algorithm Hash digest
SHA256 fe64fed90a88e3ecbd4e225b6cdf783cfacd4a4e02fb4e069cbbb04168065bbe
MD5 18811646fa695332d8fd0ea27e4fb8b3
BLAKE2b-256 3381d51ea24e7dbf929a91361c0a7a21878fed455630e46916bf1b21fecc8c0b

See more details on using hashes here.

File details

Details for the file python_docx_valutico-0.8.11.6-py3-none-any.whl.

File metadata

  • Download URL: python_docx_valutico-0.8.11.6-py3-none-any.whl
  • Upload date:
  • Size: 185.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.26.0 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/18.0.1 rfc3986/2.0.0 colorama/0.4.3 CPython/3.9.0+

File hashes

Hashes for python_docx_valutico-0.8.11.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8ce5715143d1d80fe5c1904c3b2bdc3b29981ae0e28b17b2ecc58edbbdc13783
MD5 447e0ce4458ea13970d62c0c92a3e8ef
BLAKE2b-256 9e7f5fe61f94974c82056ae91c146844b272d547e53f155e1ae66e6b288252de

See more details on using hashes here.

Supported by

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