Skip to main content

Custom Auto Report Generator for Python Program

Project description

HK-journalist: Custom Automatic Report Generator for Python program!

Python Versions PyPI Version License PyPI - Downloads code size panodc TeXLive documents status

It is a light and useful Python module, helping you generate a small size, pretty report as PDF slides (or any other format documents which human can directly read and hand out) each time after your programs finish. All you need to do is to customize a report template using MarkDown with variables name which used in your Python program, and maintain a dict to store those variables. Then, A few lines of code added before end of programs can automatically fetch and display them in final report file. Also, code deal with frequent structure/arguments changes or data source changes can benefit from the package if the report can play a role of 'snapshot' (with timestamp) of each code version.

Table of Contents

Quick Start

Before installing hkjournalist, please make sure pandoc and pdflatex are already properly installed in the environment. (install instruction)

Install

pip install hkjournalist

Customize your report template

Write such a md file, use a pair of {} to wrap every variable which will be assigned specified value in your code. save it to template.md

% Hello World
% Xinyi Li
% 2019-12-19

---

### sine plot

![]({sin_plot})

### sine table

{sin_table}

### sine function

```{{.python}}
{sin_func}
```

Run a Journalist() in your code to fetch variables

First, you should define a dict to record mapping with variable names and their value

from hkjournalist import Journalist

config = {}

Then, start your programming, and do not forget to assign value to corresponding variable names in config:

def sin_2x_and_cos_2x(x):
    y = np.sin(x) * np.sin(x) + np.cos(x) *  np.cos(x)
    return y

x = np.arange(0, 4 * np.pi, 0.1)
y1 = np.sin(x)
y2 = np.cos(x)

df = pd.DataFrame({'x': x, 'sin(x)': y1, 'cos(x)': y2})
df['sin^2^(x)+cos^2^(x)'] = sin_2x_and_cos_2x(df['x']).values
df = df.set_index('x')

# plot sine curve as sin_plot
ax = df.plot()
plt.tight_layout()
config['sin_plot'] = ax

# random select 5 point (x,y) as sin_table
config['sin_table'] = df.sample(5)

# sin_2x_and_cos_2x as sin_func
config['sin_func'] = sin_2x_and_cos_2x

Invite a journalist to make a big news report

Last but not least, attach 3 lines critical code below to have your Journalist make a report and save it to big_news.pdf (you can get all code above in demo and the output file big_news.pdf)

# HK journalist runs faster than everyone! hear variable and make a report
reporter = Journalist(template_file='template.md')
reporter.hear(config)
reporter.report(output_file='big_news.pdf', beamer=True, overwrite=True)

Report slides display as below:

I am too lazy to write a md template

If you have too many variables to report, which make write a template a big project, or simply don't want to write a md template, No problem! hkjournalist can generate a report template with each variable on one slide page automatically. With slight modification or directly using it as a template, you can get your real report.

Example

import numpy as np
import matplotlib.pyplot as plt
import seaborn as sns
from hkjournalist import Journalist

config = {}

for i in range(1, 4):
    uniform_data = np.random.rand(10, 12)
    plt.figure(figsize=(10, 8))
    ax = sns.heatmap(uniform_data, cmap='Blues', annot=True, linewidth=.5)
    plt.tight_layout()
    config[f'Plot_{i}'] = ax

reporter = Journalist(fig_height='80%')
reporter.hear(config)
reporter.generate_template('auto_generate_template.md')
reporter.report(output_file='auto_report.pdf', beamer=True, overwrite=True)

Output (raw file ):

What will my variables on slides look like?

All variables pass to Journalist via hear will display as strings just like what their __str__ method do.

Except for 4 types with special support:

  • pandas.DataFrame: -> a 3-line table (TeX default style)
  • matplotlib.axes.SubplotBase (known as base figure object ax in matplotlib): -> a figure print on report (with high quality and small size as pdf)
  • function: -> its full definition
  • list(str): -> len(list) followed by a sentance with all words concatenated.

More examples and instructions

Tips

  • before pass plt.Axes object (figure object used in matplotlib) to dict, use plt.tight_layout()statement to adjust its size.
  • use double curly braces {{}} to escape {} in template.
  • turn off parameter overwrite in Journalist.report(), you will get a file name with a timestamp in it. All these reports generated by such a method serve as snapshots.

Prerequirements

And if you use some IDE like PyCharm, you need to add their path (use which tex and which pandoc in bash environment to find them) to environment variables $PATH in IDE run options. (e.g. in Pycharm,run-> edit configuration -> environment variables)

For Jupyter Notebook users, final output file may not be opened on Chrome (see this question). So, for convenience, you can download Firefox to write notebooks and view pdf reports right after generating.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for hkjournalist, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size hkjournalist-0.0.4-py3-none-any.whl (8.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size hkjournalist-0.0.4.tar.gz (3.2 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page