Metadata-Version: 2.1
Name: nb-prep
Version: 1.0.1
Summary: Prepare jupyter notebooks for storing in git and sharing as HTML
Home-page: https://github.com/allianz-direct/nb_prep
Author: Tim Vink
Author-email: tim.vink@allianzdirect.nl
License: MIT
Keywords: precommit nbconvert nbstripout jupyter notebook python
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

[![Unit tests](https://github.com/allianz-direct/nb_prep/actions/workflows/unit_tests.yml/badge.svg)](https://github.com/allianz-direct/nb_prep/actions/workflows/unit_tests.yml)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/nb-prep)
![PyPI](https://img.shields.io/pypi/v/nb-prep)
![PyPI - Downloads](https://img.shields.io/pypi/dm/nb-prep)
![GitHub contributors](https://img.shields.io/github/contributors/timvink/nb-prep)
![PyPI - License](https://img.shields.io/pypi/l/nb-prep)

# nb_prep

`nb_prep` makes it easier to prepare jupyter notebooks for storing in git and sharing with stakeholders. 

You can use the `nb_prep` CLI to:

- Convert jupyter notebooks to HTML (using [`nbconvert`](https://nbconvert.readthedocs.io/)) and:
    - add a date prefix to the filename.
    - add a git hash suffix to the filename.
    - move the HTML file to a configured output directory
- Strip all cell outputs (using [`nbstripout`](https://github.com/kynan/nbstripout))

You can also configure `nb_prep` once as a pre-commit hook and have notebook output automatically prepared every time you `git commit`.

## Installation

```bash
pip install nb_prep
```

## Documentation

See [allianz-direct.github.io/nb_prep](https://allianz-direct.github.io/nb_prep).

