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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for jupyter_ydoc-1.0.1.tar.gz
Algorithm Hash digest
SHA256 322f7e8c2943d3926fd1add3b923547e31bb33acc87cee0c5ce752b6a1eeae1b
MD5 082849cad5413d0a27daa0f45639e14f
BLAKE2b-256 bede798cff01789088b145d0f9888cb57ddee4269f5e6c8d54f141c74912e387

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jupyter_ydoc-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 10.8 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-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3bb0bbe5caeaa28ce2b4b600489e3a0b1f90fd0c20f3f6335c37bdf14ef60cf4
MD5 b4f62ab251226154a88b8d6a841fc72d
BLAKE2b-256 e67d48d193d2bbc95a08fa6cd7e457df7eacd635dd9cd350394c51ff7a4af419

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