databooks is a package to ease the collaboration between data scientists using
Jupyter notebooks, by reducing the number of git conflicts between
different notebooks and resolution of git conflicts when encountered.
The key features include:
- CLI tool
- Clear notebook metadata
- Resolve git conflicts
- Simple to use
- Simple API for using modelling and comparing notebooks using Pydantic
Requirements
databooks is built on top of:
Installation
pip install databooks
Usage
Clear metadata
Simply specify the paths for notebook files to remove metadata. By doing so, we can already avoid many of the conflicts.
$ databooks meta [OPTIONS] PATHS...
Fix git conflicts for notebooks
Specify the paths for notebook files with conflicts to be fixed. Then, databooks finds
the source notebooks that caused the conflicts and compares them (so no JSON manipulation!)
$ databooks fix [OPTIONS] PATHS...
Assert notebook metadata
Specify paths of notebooks to be checked, an expression or recipe of what you'd like to
enforce. databooks will run your checks and raise errors if any notebook does not
comply with the desired metadata values. This advanced feature allows users to enforce
cell tags, sequential cell execution, maximum number of cells, among many other things!
Check out our docs for more!
$ databooks assert [OPTIONS] PATHS...
Show rich notebook
Instead of launching Jupyter and opening the browser to inspect notebooks, have a quick look at them in the terminal. All you need is to specify the path(s) of the notebook(s).
$ databooks show [OPTIONS] PATHS...
Show rich notebook diffs
Similar to git diff, but for notebooks! Show a rich diff of the notebooks in the terminal. Works for comparing git index with the current working directory, comparing branches or blobs.
$ databooks diff [OPTIONS] [REF_BASE] [REF_REMOTE] [PATHS]...
License
This project is licensed under the terms of the MIT license.
1 maintainer
Metadata
1 maintainer
Release files for databooks 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| databooks-1.4.0.tar.gz | 26.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| databooks-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 58.2 kB
Release files / databooks-1.4.0.tar.gz
| Download URL | databooks-1.4.0.tar.gz |
|---|---|
| Size | 26.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d322a442e80f0de86ea1b71e548eabbaf2aacba9e55b92f6f0281129db3d4000
|
|
BLAKE2b-256 checksum How to use checksums |
913e2481ecc0e559b4309bb8f52f87e7578daffa25a1cac15be4d72369f03f48
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / databooks-1.4.0-py3-none-any.whl
| Download URL | databooks-1.4.0-py3-none-any.whl |
|---|---|
| Size | 32.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ebc8c812d229e0929297092a3d585d0ba4b82754287f927f038e2670c5c98830
|
|
BLAKE2b-256 checksum How to use checksums |
27405124ddf958015d89498e45ba5fe2f014b96c64c97bca67b00e34cb9a8549
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for databooks 1.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
