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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: jupyter_ydoc-0.3.2.tar.gz
  • Upload date:
  • Size: 148.9 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.2.tar.gz
Algorithm Hash digest
SHA256 f64493c26bb3ae68a0c83135d4bb02ec2f1a0fd7c52a2d78413b1c578cf0bec9
MD5 573dc989a8f13b29a1595e3bbd55bcb4
BLAKE2b-256 9beba12d87f1712e4184e0fab77e4388867be47d968dc2811c73766440928cde

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jupyter_ydoc-0.3.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bc1024e60439dc109ead095161a1e882cc4daeea422026487123d7ffb0e26185
MD5 bf45a9fab4db1ae799ab5419640381e1
BLAKE2b-256 2bf239c57c271b96a1413188fa2f24296556b4ff732e690baba3a1797557c1e9

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