Skip to main content

Document structures for collaborative editing using Ypy

Project description

Build Status Code style: black PyPI npm (scoped)

jupyter_ydoc

jupyter_ydoc provides pycrdt-based data structures for various documents used in the Jupyter ecosystem. Built-in documents include:

  • YBlob: a generic immutable binary document.
  • YUnicode: a generic UTF8-encoded text document (YFile is an alias to YUnicode).
  • YNotebook: a Jupyter notebook document.

These documents are registered via an entry point under the "jupyter_ydoc" group as "blob", "unicode" (or "file"), and "notebook", respectively. You can access them as follows:

from jupyter_ydoc import ydocs

print(ydocs)
# {
#     'blob': <class 'jupyter_ydoc.yblob.YBlob'>,
#     'file': <class 'jupyter_ydoc.yfile.YFile'>,
#     'notebook': <class 'jupyter_ydoc.ynotebook.YNotebook'>,
#     'unicode': <class 'jupyter_ydoc.yunicode.YUnicode'>
# }

Which is just a shortcut to:

from importlib.metadata import entry_points
# for Python < 3.10, install importlib_metadata and do:
# from importlib_metadata import entry_points

ydocs = {ep.name: ep.load() for ep in entry_points(group="jupyter_ydoc")}

Or directly import them:

from jupyter_ydoc import YBlob, YUnicode, YNotebook

The "jupyter_ydoc" entry point group can be populated with your own documents, e.g. by adding the following to your package's pyproject.toml:

[project.entry-points.jupyter_ydoc]
my_document = "my_package.my_file:MyDocumentClass"

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jupyter_ydoc-3.0.0b0.tar.gz (956.5 kB view details)

Uploaded Source

Built Distribution

jupyter_ydoc-3.0.0b0-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file jupyter_ydoc-3.0.0b0.tar.gz.

File metadata

  • Download URL: jupyter_ydoc-3.0.0b0.tar.gz
  • Upload date:
  • Size: 956.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.11.10

File hashes

Hashes for jupyter_ydoc-3.0.0b0.tar.gz
Algorithm Hash digest
SHA256 619bf2c1611f01b3876cac8e2b75b10355d2f8a5fab91175c18b71ed451cf256
MD5 1bf09814500c164c6c56d85a980482aa
BLAKE2b-256 073a7da69ef157ca7d91c1855e5f2e7637b13d82300cfb9e92c415540e6dbb8c

See more details on using hashes here.

File details

Details for the file jupyter_ydoc-3.0.0b0-py3-none-any.whl.

File metadata

File hashes

Hashes for jupyter_ydoc-3.0.0b0-py3-none-any.whl
Algorithm Hash digest
SHA256 63e7bf734753ac6c103cbccbaa069d6c4f4abda6dcf6905ca26b72d516e1ad14
MD5 9b891b2f5d037ec559bc98dcb0b090c1
BLAKE2b-256 d7bb29f3f729ca5212a217270ef0cf5e9e08c507748127be7fab0092f34cf6be

See more details on using hashes here.

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