Benker

Easily convert your CALS, HTML, Formex4, Office Open XML (docx) tables from one format to another.

Overview

To convert the tables of a .docx document to CALS format, you can process as follow:

import os
import zipfile

from benker.converters.ooxml2cals import convert_ooxml2cals

# - Unzip the ``.docx`` in a temporary directory
src_zip = "/path/to/demo.docx"
tmp_dir = "/path/to/tmp/dir/"
with zipfile.ZipFile(src_zip) as zf:
    zf.extractall(tmp_dir)

# - Source paths
src_xml = os.path.join(tmp_dir, "word/document.xml")
styles_xml = os.path.join(tmp_dir, "word/styles.xml")

# - Destination path
dst_xml = "/path/to/demo.xml"

# - Create some options and convert tables
options = {
    'encoding': 'utf-8',
    'styles_path': styles_xml,
    'width_unit': "mm",
    'table_in_tgroup': True,
}
convert_ooxml2cals(src_xml, dst_xml, **options)

Installation

To install this library, you can create and activate a virtualenv, and run:

pip install benker

Requirements

This library uses lxml library and is tested with the versions 3.8 and 4.*x*.

The following table shows the compatibility between different combinations of Python and lxml versions:

Py ╲ lxml	3.8	4.0	4.1	4.2	4.3	4.4	4.5	4.6
2.7	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
3.4	✔️!	✔️!	✔️!	✔️!	✔️!	✖️	✖️	✖️
3.5	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
3.6	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️
3.7	✖️	✖️	✔️	✔️	✔️	✔️	✔️	✔️
3.8	✖️	✖️	✖️	✖️	✔️	✔️	✔️	✔️
3.9	✖️	✖️	✖️	✖️	✔️	✔️	✔️	✔️

• ✔️ lxml is available for this version and unit tests succeed.
• ! installation succeed using "attrs < 21.1".
• ✖️ lxml is not available for this version of Python.

Usage in your library/application

You can use this library in your own library/application.

To do so, add this library in your setup.py in your project requirements:

setup(
    name="YourApp",
    install_requires=['benker'],
    ...
)

To install the dependencies, activate your virtualenv and run:

pip install -e .

And enjoy!

Licence

This library is distributed according to the MIT licence.

Users have legal right to download, modify, or distribute the library.

Authors

Benker was written by Laurent LAPORTE.