Benker 0.5.4

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

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.