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

Uploaded Source

Built Distribution

jupyter_ydoc-1.1.1-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for jupyter_ydoc-1.1.1.tar.gz
Algorithm Hash digest
SHA256 00f8b33a6e7d55cbe12b91b87a6a86b673e2933d77c3a1261bba8b24753645dd
MD5 4def7e3216cf3b8617d4f367f256e334
BLAKE2b-256 d815472565b582c6eb4eb8febe1e86636e19127499daa98164aed292e00b8799

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for jupyter_ydoc-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 296f33c97af03637a2bb3ba5ce30d10415f12e0cdea6578a275bafa133c0b6a1
MD5 a3b3fb20b878e045176a6b738226b571
BLAKE2b-256 0fc97931d96b5262793454cde7b7d200c9708bc015b808ca670848deeedaa012

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