vscode-jupytext
Links
Description
You can check out those extensions README's for more info on what this one does. The specific changes this one introduces are included below.
Changes
- Bug Fix: You can now save markdown files again.
- Feature Loss: The only file extension you can open as a jupyter notebook is are
.md files.
- The option is still there for other types, they just won't save.
- This works well enough for me, but if you use this and would like a fix, just submit a GitHub issue and I'll address it time permitting.
Patch
A quick patch for the vscode-jupytext VSCode plugin, assuming that the following error is the issue:
jupytext.formats.JupytextFormatError: Format 'percent' is not associated to extension '.md'. Please choose one of: markdown, pandoc, myst.
Solution
The source of the error is in the formats.py file in the following directory (may vary slightly on your machine).
~/.vscode/extensions/congyiwu.vscode-jupytext-0.1.2/python-libs/jupytext/formats.py
Specifically, with the following function:
def get_format_implementation(ext, format_name=None):
"""Return the implementation for the desired format"""
# remove pre-extension if any
ext = "." + ext.split(".")[-1]
formats_for_extension = []
for fmt in JUPYTEXT_FORMATS:
if fmt.extension == ext:
if fmt.format_name == format_name or not format_name:
return fmt
formats_for_extension.append(fmt.format_name)
if formats_for_extension:
raise JupytextFormatError(
"Format '{}' is not associated to extension '{}'. "
"Please choose one of: {}.".format(
format_name, ext, ", ".join(formats_for_extension)
)
)
raise JupytextFormatError("No format associated to extension '{}'".format(ext))
We can see that this function should be returning fmt but instead it doesn't, and thus raises the exception.
I looked at the JUPYTEXT_FORMATS variable, and the first one is markdown - which is actually the only one I care about.
Accordingly, replacing the above function with the following function seems to fix the error:
def get_format_implementation(ext, format_name=None):
"""Return the markdown format"""
return JUPYTEXT_FORMATS[0]
Caveats
- I don't really understand the codebase, the above solution just seemed like it might intuitively work and it did. Pure luck really.
- The above solution will probably break all other jupytext formats besides markdown (files ending in
.md) in the VSCode jupytext extension. I haven't checked, but that's my guess.
