Metadata-Version: 2.1
Name: docx-report
Version: 0.1.0
Summary: A wrapper for the python-docx library that simplifies creating Word documents in Python
Author: Chris Hacker
Author-email: 49451910+christopher-hacker@users.noreply.github.com
Requires-Python: >=3.9,<3.13
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: matplotlib (>=3.8.0,<4.0.0)
Requires-Dist: pandas (>=2.1.1,<3.0.0)
Requires-Dist: pydata-sphinx-theme (>=0.14.1,<0.15.0)
Requires-Dist: pyjanitor (>=0.26.0,<0.27.0)
Requires-Dist: python-docx (>=1.0.1,<2.0.0)
Requires-Dist: recommonmark (>=0.7.1,<0.8.0)
Requires-Dist: sphinx-autodoc-typehints (>=1.24.0,<2.0.0)
Requires-Dist: sphinx-click (>=5.0.1,<6.0.0)
Description-Content-Type: text/x-rst

docx-report
===========

This is a simple wrapper for the `python-docx`_ package that makes creating Word documents in Python easier. It contains convenience methods for creating tables and inserting data visualizations directly from Pandas dataframes, as well as simpler syntax for generally writing text to a document.

Installation
------------

.. code-block:: bash

    pip install docx-report

Usage
-----

.. code-block:: python

    from docx_report import DocxReport

    # Create a new document
    doc = DocxReport(title="My Report")

    # Add a heading
    doc.add_heading("My Heading")

    # Add a paragraph
    doc.add_paragraph("This is a paragraph.")

    # Add a table
    doc.add_table(df)  # assuming you have a pandas dataframe called df

    # Add a plot
    doc.add_plot(df)  # assuming you have a pandas dataframe called df

    # Save the document
    doc.save("my_report.docx")

Contributing
------------

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

.. _python-docx: https://python-docx.readthedocs.io/en/latest/

