Skip to content

Gilfoyle is a report generation tool for Python which makes it quick and easy to create stylish reports or presentations using data.

License

Notifications You must be signed in to change notification settings

practical-data-science/gilfoyle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gilfoyle

Gilfoyle is a report generation tool for Python which makes it quick and easy to create stylish looking reports or presentations using data.

Installation

You can install Gilfoyle by entering pip3 install gilfoyle in your terminal.

Usage

Gilfoyle can be used within a regular Python script or from inside a Jupyter notebook. See the example.py file for some working examples.

# Load packages
import pandas as pd
from gilfoyle import report

# Define output filename
pdf = report.Report(output='example.pdf')

# Set report title
pdf.set_title('Monthly ecommerce report')

# Create payload
payload = pdf.get_payload()

# Add a cover slide
payload = pdf.add_page(payload,
                       page_type='cover',
                       page_title='Monthly report',
                       page_subheading='Matt Clarke')

# Fetch your data
df = pd.read_csv('data.csv', 
                 skiprows=1,
                 names=['Period', 'Entrances', 'Sessions', 'Pageviews',
                        'Transactions', 'Conversion Rate', 'AOV']).head(13)

payload = pdf.add_page(payload,
                       page_type='report',
                       page_layout='simple',
                       page_title='Organic search',
                       page_dataframe=df
                       )

# Save to PDF
pdf.create_report(payload, verbose=True, output='pdf')

Dependencies

Gilfoyle is written in Python 3 and uses the Jinja 2 templating engine, the Bulma HTML and CSS framework, and the Weasyprint PDF generator package. Gilfoyle is compatible with Pandas and can automatically turn your dataframes into tables.

About

Gilfoyle is a report generation tool for Python which makes it quick and easy to create stylish reports or presentations using data.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published