Skip to main content

macros for Jupyter Notebooks

Project description

JPConvert

JPConvert is a simple tool to split up Jupyter Notebooks based on macros and remove unnecessary metadata.

Installation

JPConvert does not need any libraries. It is probably a good idea to use nbstripout with it though.

The preferred way to use JPConvert is in a virtual environment:

python -m venv venv
source venv/bin/activate

Use pip to download and install JPConvert:

pip install jpconvert

Usage

python -m jpconvert <input> [<options>] [<output>]

If no output file is specified, stdout is used instead.

Macros and Options

Multiple macros can be used per cell. Only code cells with the macro matching the output options are kept. Macros themselves are removed from the code cells.

macro option
#jp-practice --practice / -p
#jp-teaching --teaching / -t
#jp-solution --solution / -s

One may decide what happens to code cells without any macros. By default they are removed if --allow-skip is not used.

Example

Image two code cells inside your notebook:

#jp-solution
a = a + 1
#jp-practice
a = ...

If you call JPConvert with the --practice option, the first cell is removed and the second cell is kept:

a = ...

If you call JPConvert with the --solution option, the first cell is kept and the second cell is removed:

a = a + 1

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

jpconvert-0.2.1.tar.gz (2.6 kB view hashes)

Uploaded Source

Built Distribution

jpconvert-0.2.1-py3-none-any.whl (2.6 kB view hashes)

Uploaded Python 3

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