Published
A hatch plugin to help build Jupyter packages
pip install hatch-jupyter-builder
Package Downloads
Authors
Project URLs
Requires Python
>=3.8
Dependencies
- hatchling
>=1.17 - hatch-jupyter-builder
; extra == 'docs' - myst-parser
; extra == 'docs' - pydata-sphinx-theme
; extra == 'docs' - sphinx-autodoc-typehints
; extra == 'docs' - sphinxcontrib-spelling
; extra == 'docs' - hatch
; extra == 'test' - pytest
; extra == 'test' - pytest-cov
; extra == 'test' - pytest-mock
; extra == 'test' - tomli
; (python_version < '3.11') and extra == 'test' - twine
; extra == 'test'
hatch-jupyter-builder
This provides a build hook plugin for Hatch that adds a build step for use with Jupyter packages.
Table of Contents
Documentation
The full documentation is available on Read The Docs.
Installation
pip install hatch-jupyter-builder
Local Development
To test this package locally with another package, use the following:
[tool.hatch.build.hooks.jupyter-builder]
dependencies = ["hatch-jupyter-builder@file://<path_to_this_repo>"]
Skipping the Build
You can skip the build by setting the SKIP_JUPYTER_BUILDER environment
variable.
Migration
This library can be used to migrate from a setuptools based package to
use hatch_jupyter_builder. It will attempt to migrate jupyter-packaging
config as well, if present.
To migrate, run the following:
python -m hatch_jupyter_builder.migrate .
The migration script will do most of the migration automatically, but will prompt you for anything it cannot do itself.
To compare dist files with a reference checkout, run the following:
python -m hatch_jupyter_builder.compare_migration <source_dir> <target_dir> sdist
Use wheel to compare wheel file contents.
See the documentation for more information on migration for more details.
License
hatch-jupyter-builder is distributed under the terms of the MIT license.