Skip to content
play

GitHub Action

nbmake

v0.2.1 Latest version

nbmake

play

nbmake

Test notebooks

Installation

Copy and paste the following snippet into your .yml file.

              

- name: nbmake

uses: treebeardtech/[email protected]

Learn more about this action in treebeardtech/nbmake-action

Choose a version

⚠️ Please use nbmake instead

nbmake-action

(repo renamed from 'treebeard').

What? A GitHub Action for testing notebooks, runs them from top-to-bottom

Why? To raise the quality of scientific material through better automation

Who is this for? Scientists/Developers who have written docs in notebooks and want to CI test them after every commit

Functionality

Tests notebooks using nbmake via pytest.

Note: If you have some experience setting up GitHub actions already you will probably prefer the flexibility of using the nbmake pip package directly.

Quick Start

      - uses: actions/checkout@v2
      - uses: actions/setup-python@v2
      - uses: "treebeardtech/[email protected]"
        with:
          path: "./examples"
          path-output: .
          notebooks: |
            nb1.ipynb
            'sub dir/*.ipynb'

See action.yml for the parameters you can pass to this action, and see unit tests and integ tests for example invocations.

Developing

Install local package

npm install

Run checks and build

npm run all

See Also