Skip to main content

Execute and render notebooks as HTML reports.

Project description

Generate reproducible reports from Rmarkdown or jupyter notebooks

Build Status Documentation Status The uncompromising python formatter

Reportsrender allows to create reproducible, consistently looking HTML reports from both jupyter notebooks and Rmarkdown files. It makes use of papermill and Rmarkdown to execute notebooks and uses Pandoc to convert them to HTML.

Features:
  • two execution engines: papermill and Rmarkdown.

  • support any format supported by jupytext.

  • create self-contained HTML that can be shared easily.

  • hide inputs and/or outputs of cells.

  • parametrized reports

See the documentation for more details!

Getting started

  • Execute an rmarkdown document to HTML using the Rmarkdown engine

reportsrender --engine=rmd my_notebook.Rmd report.html
  • Execute a parametrized jupyter notebook with papermill

reportsrender --engine=papermill jupyter_notebook.ipynb report.html --params="data_file=table.tsv"

Usage from command line

reportsrender

Execute and render a jupyter/Rmarkdown notebook.
The `index` subcommand generates an index html
or markdown file that links to html documents.

Usage:
  reportsrender <notebook> <out_file> [--cpus=<cpus>] [--params=<params>] [--engine=<engine>]
  reportsrender index [--index=<index_file>] [--title=<title>] [--] <html_files>...
  reportsrender --help

Arguments and options:
  <notebook>            Input notebook to be executed. Can be any format supported by jupytext.
  <out_file>            Output HTML file.
  -h --help             Show this screen.
  --cpus=<cpus>         Number of CPUs to use for Numba/Numpy/OpenBLAS/MKL [default: 1]
  --params=<params>     space-separated list of key-value pairs that will be passed
                        to papermill/Rmarkdown.
                        E.g. "input_file=dir/foo.txt output_file=dir2/bar.html"
  --engine=<engine>     Engine to execute the notebook. [default: auto]

Arguments and options of the `index` subcommand:
  <html_files>          List of HTML files that will be included in the index. The tool
                        will generate relative links from the index file to these files.
  --index=<index_file>  Path to the index file that will be generated. Will be
                        overwritten if exists. Will auto-detect markdown (.md) and
                        HTML (.html) format based on the extension. [default: index.html]
  --title=<title>       Headline of the index. [default: Index]

Possible engines are:
  auto                  Use `rmd` engine for `*.Rmd` files, papermill otherwise.
  rmd                   Use `rmarkdown` to execute the notebook. Supports R and
                        python (through reticulate)
  papermill             Use `papermill` to execute the notebook. Works for every
                        kernel available in the jupyter installation.

Installation

Manual installation:

Get dependencies:

For the Rmarkdown render engine additionally (there is no need to install them if you are not going to use the Rmarkdown rendeirng engine):

  • R and the following packages:

rmarkdown
reticulate

then,

Install from pip:

pip install reportsrender

or,

Install from github:

pip install flit
flit installfrom github:grst/reportsrender

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

reportsrender-0.3.2.tar.gz (818.8 kB view details)

Uploaded Source

Built Distribution

reportsrender-0.3.2-py3-none-any.whl (117.6 kB view details)

Uploaded Python 3

File details

Details for the file reportsrender-0.3.2.tar.gz.

File metadata

  • Download URL: reportsrender-0.3.2.tar.gz
  • Upload date:
  • Size: 818.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.22.0

File hashes

Hashes for reportsrender-0.3.2.tar.gz
Algorithm Hash digest
SHA256 cb4ab5b7a561805a3a85b6b7d821c68783a1fbdebf9e12b82610b0b8d9beeca6
MD5 400893643d016cc634d345ae362b6091
BLAKE2b-256 01defbb8ef2c07faf38950c790a4811a6f7fec51d6a38a46d3ae84874da5eb6d

See more details on using hashes here.

Provenance

File details

Details for the file reportsrender-0.3.2-py3-none-any.whl.

File metadata

File hashes

Hashes for reportsrender-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9c6dc2f6a67fb4ea641b5aa3c5c4e8f4d3a7502b12cce392a95a190bd060d7a7
MD5 c38d5503ee290db08815cafcb555bd33
BLAKE2b-256 0c0cfe2d7441db31c3ddc44d579c3b9ef139863a80536c51d3f5cecbb09ceba4

See more details on using hashes here.

Provenance

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