Skip to main content

LSST's notebook-based report system.

Project description

nbreport is a client for creating and publishing LSST’s notebook-based reports. Notebook-based reports are generated from template repositories, computed, and published with LSST the Docs.



nbreport is available on

pip install nbreport

nbreport is made for Python 3.6 and newer.


You can use nbreport to:

  1. Create an instance of a report from a report repository.
  2. Fill that instance in with template variables that configure the report instance.
  3. Compute the report instance.
  4. Publish the report instance.

Try this test command to get a sense for how nbreport work:

nbreport test --git-subdir tests/TESTR-000 -c title "My first report"

This test command uses the TESTR-000 example report repository in this project’s own Git repository. Next, it creates a new instance called TESTR-000-test in your current working directory and configures the notebook so that the title variable is "My first report". Finally, the test command runs the notebook to generate outputs.

Learn more about nbreport and how to create reports with LSST’s notebook-based report system at

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 nbreport, version 0.7.2
Filename, size & hash File type Python version Upload date
nbreport-0.7.2-py3-none-any.whl (25.1 kB) View hashes Wheel py3
nbreport-0.7.2.tar.gz (32.8 kB) View hashes Source None

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page