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.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:

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-1.1.0a0.tar.gz (954.6 kB view details)

Uploaded Source

Built Distribution

jupyter_ydoc-1.1.0a0-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file jupyter_ydoc-1.1.0a0.tar.gz.

File metadata

  • Download URL: jupyter_ydoc-1.1.0a0.tar.gz
  • Upload date:
  • Size: 954.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for jupyter_ydoc-1.1.0a0.tar.gz
Algorithm Hash digest
SHA256 b9e139b7723484ff08779ef44c26e45d16f9c4ebf620d3c3bc528a5300ee56f7
MD5 ae32945afbf91e8a72f81fe170f3816c
BLAKE2b-256 0a7f2e2ca7b20ee3af97aafe9bb3631ba6f7145d7aef2ba43f9635fa4f26b0f7

See more details on using hashes here.

File details

Details for the file jupyter_ydoc-1.1.0a0-py3-none-any.whl.

File metadata

File hashes

Hashes for jupyter_ydoc-1.1.0a0-py3-none-any.whl
Algorithm Hash digest
SHA256 af1496412538b87b630f44bd1b248021e607b496ff6539be35a117375db702ea
MD5 16ee6ae818bd9b14643332f06c460186
BLAKE2b-256 b2c53cc5ee7baf4843a762c8ab48c0a0d4fa76801e204b546c794ae7030a8b26

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