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

Uploaded Source

Built Distribution

jupyter_ydoc-0.3.3-py3-none-any.whl (10.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for jupyter_ydoc-0.3.3.tar.gz
Algorithm Hash digest
SHA256 9ba0975f2016e0c94e3200aeb713032ae255ad8ad035905bd0574cae42240b73
MD5 384ed7530cd361c7068fd47a4f233a39
BLAKE2b-256 8ec565e20de677e9735db190e861620ca4b204fbf50c70cc78a2382cc06f0b1c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jupyter_ydoc-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 10.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.10

File hashes

Hashes for jupyter_ydoc-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7e91a7c62d68a2a020af9da00801c19fade3ecb9811a7720c28b6e7af7d7345e
MD5 a8d997d2af59a849b6c805d2d449647b
BLAKE2b-256 4c81273c2cdbba56bcf32c4e518a455cb3119c51f6734e99f748e4172d0373a9

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