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

Uploaded Source

Built Distribution

jupyter_ydoc-2.1.1-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: jupyter_ydoc-2.1.1.tar.gz
  • Upload date:
  • Size: 955.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for jupyter_ydoc-2.1.1.tar.gz
Algorithm Hash digest
SHA256 1dcbf13861b3678000d69af4ef38b49e3a12f8081ba851c680393c2e18bc4b84
MD5 d6bd5767d6bc4180ce0e1a0717e72335
BLAKE2b-256 fa5d369982304bf0c3af38463deabcae995a7b990b50be61896c64221d914a21

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for jupyter_ydoc-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4f0aa4e9624ab9328e6ebcc26df0a0a42017cf790267e52fbe38fb163f96d6b4
MD5 feaab3146b1a1fdd08ee73a64861d0b5
BLAKE2b-256 f327fb3be2ecbd04a2bae440915ca95e0453ef31652d4def1897f50bd4a00834

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