mwouts/jupytext 1.0.0-rc5

Version 1.0.0 rc5

on GitHub

Improvements

• Jupytext command line has more arguments: --paired-paths to list the paths for the paired representations of the notebook, and --sync to synchronise the content of all paired paths based on the most recent file (#146). In addition, the --from argument is optional even when the notebook is read from stdin (#148).
• The pairing information, and more generally the notebook metadata can be edited with the CLL, see the --set-formats and the --update-metadata arguments (#141).
• Jupytext can --pipe the text representation of a notebook to external programs like black or flake8 (#154, #142)
• The Python representation of notebooks containing PEP8 cells is now expected to be PEP8 compliant (#154).
• Format specification allow prefix and suffix for path and file name (#138, #142). Use ipynb,prefix/suffix.py:percent to pair the current notebook named notebook.ipynb to a script named prefixnotebooksuffix.py. Suffix and prefix can also be configured on the ipynb file, with the same syntax.
• Introducing a new hydrogen format for scripts, which derives from percent. In that format Jupyter magic commands are not commented (#59, #126, #132).
• Introducing a new bare format for scripts, which derives from light. That format has no cell marker. Use a notebook metadata filter {"jupytext": {"notebook_metadata_filter":"-all"}} if you want no YAML header (#152).
• The default format for R script is now light, as for the other languages.
• Added support for q/kdb+ notebooks (#161)
• Python scripts or Markdown documents that have no Jupyter metadata receive a metadata filter that ensures that metadata is not exported back to the text representation (#124).
• Metadata filters are represented as strings rather than dictionaries to make YAML headers shorter. Previous syntax from #105 is still supported. They were also renamed to notebook_metadata_filter and cell_metadata_filter.
• Markdown and RMarkdown formats have a new option split_at_heading to split Markdown cells at heading (#130)

BugFixes

• Main language of scripts is inferred from script extension. Fixes a round trip conversion issue for Python notebooks with a Javascript cell.
• Non-Python scripts opened as notebooks in Jupyter are now correctly saved even when no matching kernel is found.
• Jupyter magic commands like ls are commented in the light and R markdown format (#149).

vs 1.0.0-rc0

• Fixed support for notebooks with jupytext metadata from previous versions of Jupytext (#163)
• Fixed round-trip conversion (#164 , #165)

vs 1.0.0-rc1

• Added new line when writing ipynb, just like nbformat (#165)
• Improved matching of preferred format when using prefixes/suffixes (#170)
• Piping a notebook (e.g. in percent format) preserves the pairing information (e.g. light format)
• Writing a notebook does not change the notebook object

vs 1.0.0-rc2

• Better support for the auto extension, used by our two notebook extensions https://github.com/mwouts/jupyterlab-jupytext and https://github.com/mwouts/jupytext_nbextension
• Fix incorrect handling of user metadata filters (#139)

rc3 vs 1.0.0-rc2

• Sorry, there was no rc3...

rc4 vs 1.0.0-rc2

• Pairing of notebooks to a different folder even when notebook is at the root #174
• Jupyter notebook and lab extensions are distributed with Jupytext #86

rc5 vs 1.0.0-rc4

• Pairing folder is created when missing #176
• Jupyter notebook and lab extensions are distributed with Jupytext #176
• Html and Latex cell magics are supported #179