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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file jupyter_ydoc-0.3.0a5.tar.gz.

File metadata

  • Download URL: jupyter_ydoc-0.3.0a5.tar.gz
  • Upload date:
  • Size: 144.3 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.0a5.tar.gz
Algorithm Hash digest
SHA256 af16a7c75bac4840fb4a9b202273db0b1c2d1b09f4de1bf18d5e0410969a5b19
MD5 b923cb23c809071ac3f871746b67c68d
BLAKE2b-256 60d0e1663602bf0926a4f3be47a3f57100e8c4fa91f2ff664a3f1f58003f12c2

See more details on using hashes here.

File details

Details for the file jupyter_ydoc-0.3.0a5-py3-none-any.whl.

File metadata

File hashes

Hashes for jupyter_ydoc-0.3.0a5-py3-none-any.whl
Algorithm Hash digest
SHA256 965ce9e8394fbce2ef4cd8f6d0bbe8b1bd5324a8280779bad0dd6bf7658bd00e
MD5 a06330641b80e9d9634fb0a60fad7efd
BLAKE2b-256 35009f9ee2128b277b01c8f46ab8613832c368d46fd236374441410072d45015

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