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.0.tar.gz (956.7 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: jupyter_ydoc-3.0.0.tar.gz
  • Upload date:
  • Size: 956.7 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.0.tar.gz
Algorithm Hash digest
SHA256 9cf394ee7c6955287eead11126ad836083a9ca3cdef2e27221dc4dfe05bb6ab1
MD5 b856e2603275ba5e671c189a095598c4
BLAKE2b-256 ed81724ef71592f9a4e696af8db1de2bd2716689c8f3d54bfbf2255c0133d4d9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jupyter_ydoc-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 11.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.11.10

File hashes

Hashes for jupyter_ydoc-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 db451319917a7c409f08844aa6452fbee9462f6c3653b2d6b31efc633ada1140
MD5 742360290266cba69215a62e1027abd4
BLAKE2b-256 2f71872c32cb3b5140d0fa58efdc8d3475e74839cdbc38070845e9c673266d05

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