python/laymesh/ipython.py 1"""IPython extension: %laymesh and %%laymesh."""2 3import argparse4import shlex5from pathlib import Path6 7from IPython.core.magic import Magics, line_cell_magic, magics_class8from IPython.display import Image, display9 10from .bridge import _render_notebook11 12 13def _options(line: str, *, cell: bool) -> argparse.Namespace:14 parser = argparse.ArgumentParser(prog="%%laymesh" if cell else "%laymesh")15 if not cell:16 parser.add_argument("file", type=Path)17 parser.add_argument("--page", type=int)18 parser.add_argument("-o", "--output", type=Path)19 parser.add_argument("--dpi", type=float)20 parser.add_argument("--quality", type=float)21 parser.add_argument("--compression")22 parser.add_argument("--background")23 parser.add_argument("--preview-dpi", type=float, default=192)24 parser.add_argument("--preview-quality", type=int, default=95)25 parser.add_argument("--preview-background", default="#ffffff")26 parser.add_argument("--webp-lossless", choices=("true", "false"))27 parser.add_argument("--webp-method", type=int)28 parser.add_argument("--webp-alpha-quality", type=int)29 parser.add_argument("--webp-near-lossless", type=int)30 parser.add_argument("--config", type=Path)31 parser.add_argument("--pdf-image-compression", choices=("auto", "lossless", "jpeg"))32 parser.add_argument("--pdf-jpeg-quality", type=int)33 parser.add_argument("--pdf-downsample", choices=("true", "false"))34 parser.add_argument("--pdf-preserve-16bit", choices=("true", "false"))35 parser.add_argument("--pdf-preserve-alpha", choices=("true", "false"))36 parser.add_argument("--pdf-alpha-background")37 parser.add_argument("--pdf-recompress-jpeg", choices=("true", "false"))38 parser.add_argument("--pdf-auto-palette-limit", type=int)39 parser.add_argument("--pdf-auto-flatness-threshold", type=float)40 parser.add_argument("--plot-dpi", type=float, default=300)41 parser.add_argument("--save-source", type=Path)42 parser.add_argument("--warnings", choices=("show", "hide"))43 return parser.parse_args(shlex.split(line))44 45 46@magics_class47class LayMeshMagics(Magics):48 @line_cell_magic49 def laymesh(self, line: str, cell: str | None = None) -> None:50 options = _options(line, cell=cell is not None)51 encoding = dict(quality=options.quality, compression=options.compression, background=options.background,52 webp_lossless=None if options.webp_lossless is None else options.webp_lossless == "true",53 webp_method=options.webp_method, webp_alpha_quality=options.webp_alpha_quality,54 webp_near_lossless=options.webp_near_lossless,55 pdf_image_compression=options.pdf_image_compression, pdf_jpeg_quality=options.pdf_jpeg_quality, pdf_downsample=None if options.pdf_downsample is None else options.pdf_downsample == "true", pdf_preserve_16bit=None if options.pdf_preserve_16bit is None else options.pdf_preserve_16bit == "true", pdf_preserve_alpha=None if options.pdf_preserve_alpha is None else options.pdf_preserve_alpha == "true", pdf_alpha_background=options.pdf_alpha_background, pdf_recompress_jpeg=None if options.pdf_recompress_jpeg is None else options.pdf_recompress_jpeg == "true", pdf_auto_palette_limit=options.pdf_auto_palette_limit, pdf_auto_flatness_threshold=options.pdf_auto_flatness_threshold)56 if cell is None:57 result = _render_notebook(58 file=options.file, namespace=self.shell.user_ns, output=options.output, config=options.config,59 page=options.page,60 dpi=options.dpi, plot_dpi=options.plot_dpi,61 preview_dpi=options.preview_dpi, preview_quality=options.preview_quality,62 preview_background=options.preview_background,63 save_source=options.save_source,64 show_warnings=None if options.warnings is None else options.warnings == "show",65 **encoding,66 )67 else:68 result = _render_notebook(69 source=cell, namespace=self.shell.user_ns, output=options.output, config=options.config,70 dpi=options.dpi, plot_dpi=options.plot_dpi,71 preview_dpi=options.preview_dpi, preview_quality=options.preview_quality,72 preview_background=options.preview_background,73 save_source=options.save_source,74 show_warnings=None if options.warnings is None else options.warnings == "show",75 **encoding,76 )77 # Two physical pixels per CSS pixel, without increasing export DPI.78 display(Image(data=result.preview_jpeg, format="jpeg", retina=True))79 80 81def load_ipython_extension(ipython) -> None:82 ipython.register_magics(LayMeshMagics)