Skip to main content

Transfer XML to well formatted PDF table.

Project description

CircleCI pipeline status badge ReadTheDocs badge Codacy badge pypi Python Version PyPI - license badge

Convert your XML into a Pdf table

Generate a multi-page PDF file from an XML file with the contents displayed in several tables based on filter criteria.

Table of content

💫Quickstart

As a starting point you could call

$ python -m pyxml2pdf.main input/template.xml

which will download a publicly available XML file into the folder input and process it as desired to produce the output files (one file containing all generated pages in landscape and additionally one file per page rotated into portrait) and place them in the subfolder output.

The intended way of using this software is calling main.py with the following command line parameters

  • positional arguments:

    • <local_file> The local file path to the XML file. If this file is not present, the optional input parameter '--url' needs to be provided with the URL from which the file shall be downloaded.
  • optional arguments:

👓Example

As an example we look at our input/template.xml and the processed result. Imagine you have an XML file with similar groups of tags and subtags.

<main_tag>
    <row_tag>
        <name_tag>Name 1</name_tag>
        <info_tag>Info 1</info_tag>
        <filter_tag>filter_1, filter_2</filter_tag>
    </row_tag>
    <row_tag>
        <name_tag>Name 2</name_tag>
        <info_tag>Info 2</info_tag>
        <filter_tag>filter_2, filter_3</filter_tag>
    </row_tag>
    <row_tag>
        <name_tag>Name 3</name_tag>
        <info_tag>Info 3</info_tag>
        <filter_tag>filter_2</filter_tag>
    </row_tag>
    <row_tag>
        <name_tag>Name 4</name_tag>
        <info_tag>Info 4</info_tag>
        <filter_tag>filter_1, filter_3</filter_tag>
    </row_tag>
    <row_tag>
        <name_tag>Name 5</name_tag>
        <info_tag>Info 5</info_tag>
        <filter_tag>filter_1</filter_tag>
    </row_tag>
</main_tag>

Now you want to visualize all row_tags with their subtags name_tag and info_tag fed into separate columns. And lastly you want to group those row_tags which satisfy certain filter criteria, that is their filter_tag contains certain combinations of comma-separated texts. Those groups of row_tags are extracted into several subtables each with a separating heading line and the corresponding column headings.

page one of the processed template.xml

📖Documentation

The API reference you can find on ReadTheDocs.

💻Installation

The installation of pyxml2pdf is as straightforward as the Python ecosystem suggests. Just create a virtual environment and install it via:

(venv) $ pip install pyxml2pdf

💨Coming soon

The next big step will be the deployment on Heroku.

👋Get in touch

In case you have any questions on this project do not hesitate to get in touch with us.

💎Acknowledgement

This project was prepared by Wojciech Kur in his repository XMLtoPDFConverter. We are grateful for his effort in designing the basic structure and built upon his main ideas. At some point our project diverged as much from his original work, as for us to justify to decouple our project from his. The fork is still kept (and maintained) as a special case in pyacb2pdf.

⚠Disclaimer

This software is developed in sole responsibility of Björn Ludwig. The software is made available "as is" free of cost. The author assumes no responsibility whatsoever for its use by other parties, and makes no guarantees, expressed or implied, about its quality, reliability, safety, suitability or any other characteristic. In no event will the author be liable for any direct, indirect or consequential damage arising in connection with the use of this software.

©License

pyxml2pdf is distributed under the GPLv3 license.

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

pyxml2pdf-0.3.2.tar.gz (461.7 kB view hashes)

Uploaded Source

Built Distribution

pyxml2pdf-0.3.2-py3-none-any.whl (394.6 kB view hashes)

Uploaded Python 3

Supported by

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