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 Ypy-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.ydoc.YBlob'>,
#     'file': <class 'jupyter_ydoc.ydoc.YFile'>,
#     'notebook': <class 'jupyter_ydoc.ydoc.YNotebook'>,
#     'unicode': <class 'jupyter_ydoc.ydoc.YUnicode'>
# }

Which is just a shortcut to:

import pkg_resources

ydocs = {ep.name: ep.load() for ep in pkg_resources.iter_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-0.3.1.tar.gz (148.4 kB view details)

Uploaded Source

Built Distribution

jupyter_ydoc-0.3.1-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: jupyter_ydoc-0.3.1.tar.gz
  • Upload date:
  • Size: 148.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.9

File hashes

Hashes for jupyter_ydoc-0.3.1.tar.gz
Algorithm Hash digest
SHA256 23948daf60a0c3c0a4b3715a66cb6ccad2de56694864842534fb1b1564b9b56b
MD5 9d267660caf30ae2250fc2ca7b73cef9
BLAKE2b-256 06cba38b4a227b407c17483964537765ab5b99734960ac8293c922c3a8b55b9c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for jupyter_ydoc-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e65f638d1ab59ca44cfd1aa3a3cd711253f2a78552f6ece9e8d739145f50e375
MD5 6a8321591ad3839c159f1edf54febaee
BLAKE2b-256 5d43aa44c5d2591af1cc019bb337443f3b70f08805d459e298e6b9546c2c20e1

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