Package: wordinserter
WordinserterThis module allows you to insert HTML into a Word Document, as well as
allowing you to programmatically build word documents in pure Python
(Python 3.x only at the moment). After runningpip install wordinserteryou can use thewordinserterCLI to
quickly generate test documents:# Download https://raw.githubusercontent.com/orf/wordinserter/master/tests/docs/table_widths.htmlwordinsertertable_widths.html--style="table { background-color: red }"This should open Word and insert three tables, each of them styled with
a red background.The library is stable and has been used to generate tens of thousands of
reports, and currently supports many features (all controlled through
HTML):Common tags, including tables, lists, code blocks, images,
hyperlinks, footnotes, headers, paragraphs, styles (biem)Named bookmarks in documents via elementidattributesA subset of CSS for elements, with more that can be easily added as
neededIncluding document-wide stylesheets while adding elementsIn-built syntax highlighting for<pre>and<code>blocksSupports complex merged tables, with rowspans and colspansArbitrarily nested lists of differing types (bullet, numbered, roman
numerals)Hyperlinks to bookmarks within the document using classic links or
using Word ‘fields’Images, with support for footnotes, 404 and embedded base64 data-uri
imagesBasic whitespace handlingThere is acomparison
documentshowing the output of WordInserter against Chrome, check it out to see
what the library can do.APIThe API is really simple to use:fromwordinserterimportparse,insertoperations=parse(html,parser="html")insert(operations,document=document,constants=constants)Inserting HTML into a Word document is a two step process: first the
input has to be parsed into a sequence of operations, which is theninsertedinto a Word document. This library currently only supports
inserting using the Word COM interface which means it is Windows
specific at the moment.Below is a more complex example including starting word that will insert
a representation of the HTML code into the new word document, including
the image, caption and list.fromwordinserterimportinsert,parsefromcomtypes.clientimportCreateObject# This opens Microsoft Word and creates a new document.word=CreateObject("Word.Application")word.Visible=True# Don't set this to True in production!document=word.Documents.Add()fromcomtypes.genimportWordasconstantshtml="""
<h3>This is a title</h3>
<p><img src="http://placehold.it/150x150" alt="I go below the image as a caption"></p>
<p><i>This is <b>some</b> text</i> in a <a href="http://google.com">paragraph</a></p>
<ul>
    <li>Boo! I am a <b>list</b></li>
</ul>
"""# Parse the HTML into a list of operations then feed them into insert.operations=parse(html,parser="html")insert(operations,document=document,constants=constants)What’s with the constants part? Wordinserter is agnostic to the COM
library you use. Each library exposes constant values that are needed by
Wordinserter in a different way: the pywin32 library exposes it as
win32com.client.constants whereas the comtypes library exposes them as a
module that resides in comtypes.gen. Rather than guess which one you are
using Wordinserter requires you to pass the right one in explicitly. If
you need to mix different constant groups you can use theCombinedConstantsclass:fromwordinserter.utilsimportCombinedConstantsfromcomtypes.genimportWordasword_constantsfromcomtypes.genimportOfficeasoffice_constantsconstants=CombinedConstants(word_constants,office_constants)InstallGet itfrom PyPi here,
usingpip install wordinserter. This has been built with word 2010
and 2013, older versions may produce different results.Supported OperationsWordInserter currently supports a range of different operations,
including code blocks, font size/colors, images, hyperlinks, numbered
and bullet lists, table borders and padding.Stylesheets?Wordinserter has support for stylesheets! Every element can be styled
with inline styles (style='whatever') but this gets tedious at
scale. You can pass CSS stylesheets to theparsefunction:html="<p class="mystyle">Hello Word</p>"stylesheet="""
.mystyle {
    color: red;
}
"""operations=parse(html,parser="html",stylesheets=[stylesheet])insert(operations,document=document,constants=constants)This will render “Hello Word” in red. Inheritance is respected, so child
styles override parent ones.Why aren’t my lists showing up properly?There are two ways people write lists in HTML, one with each sub-list as
a child of the parent list, or as a child of a list element. Below is a
sample of the two different ways, both of which display correctly in all
browsers:<ol><li>I'm a list element</li><ul><li>I'm a sub list!</li></ul></ol><ol><li>I'm a list element<ul><li>I'm a sub list!</li></ul></li></ol>The second way is correct according to the HTML specification.lxmlparses the first structure incorrectly in some cases, which leads to
weird list behavior. There isn’t much this library can do about that, so
make sure your lists are in the second format.One other thing to note: Word does not support lists with mixed
list-types on a single level. i.e this HTML will render incorrectly:<ol><li><ul><li>Unordered List On Level #1</li></ul><ol><li>Ordered List On Level #1</li></ul></li></ol>