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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: jupyter_ydoc-1.0.0.tar.gz
  • Upload date:
  • Size: 957.1 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.0.tar.gz
Algorithm Hash digest
SHA256 6b186700f0cc10747481d33e3d2d9df6ca78f79b594bddcf8967a6440b8dbc04
MD5 a5ba82c19d0223d80b8fbd9bb62f2a9d
BLAKE2b-256 3247d8fb971d35dc5965dedc5cc5acadb9a41352f0b1655ee37b738281ea6d4d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jupyter_ydoc-1.0.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ac3f75b10f59cb01bfb0a4bfc472562c4b6bae6e212569e7379a5612df64fcc7
MD5 c05b704251e4eb817c17952d2099235b
BLAKE2b-256 de1c7a439381a3ae9fcbeca6b6463765cd4bea2b6b5b498f93992deba9db3c49

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