GNU ELPA - comint-mime

comint-mime Atom Feed

Description
Display content of various MIME types in comint buffers
Latest
comint-mime-0.6.tar (.sig), 2024-Sep-28, 40.0 KiB
Maintainer
Augusto Stoffel <arstoffel@gmail.com>
Website
https://github.com/astoff/comint-mime
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

Full description

GNU ELPA

This Emacs package provides a mechanism for REPLs (or comint buffers, in Emacs parlance) to display graphics and other types of special content.

python-shell.png

Figure 1: comint-mime in Python

The main motivation behind this package is to display plots in the Python shell. However, it does more than that.

First, it is not constrained to graphics, and can display other "MIME attachments" such as HTML and LaTeX content. In fact, the Python backend of the package implements IPython's rich display interface. A use-case beyond the displaying of graphics is to render dataframes as HTML tables; this opens up the possibility of typographical improvements over the usual pure-text representation. You can also easily define rich representations for your own classes.

Second, the package defines a flexible communication protocol between Emacs and the inferior process, and, consequently, can be extended to other comint types. Currently, besides Python, there is support for the regular (Unix) shell. In this case, a special command, mimecat, is provided to display content. Again, this works for images, HTML, LaTeX snippets, etc.

shell.png

Figure 2: comint-mime in Bash

1. Usage

To start enjoying comint-mime, simply call M-x comint-mime-setup from a supported buffer (which, at the moment, are the M-x shell and M-x run-python buffers). To apply this permanently, add that same function to the appropriate mode hook:

(add-hook 'shell-mode-hook 'comint-mime-setup)
(add-hook 'inferior-python-mode-hook 'comint-mime-setup)

For Python it is recommended to use the IPython interpreter. It can be configured to have the same look-and-feel as the classic python program as follows.

(when (executable-find "ipython3")
  (setq python-shell-interpreter "ipython3"
	python-shell-interpreter-args "--simple-prompt --classic"))

If using the regular python interpreter, only Matplotlib figures are supported, and you need to call plt.show() and plt.close() manually to display and create new figures.

Advertisement: For an even more featureful Python shell with improved completion, graphic capabilities and more, have a look at the dREPL package.

2. Customization

The follow options are available:

  • comint-mime-latex-render-method: This variable determines how LaTeX fragments are rendered. The default is nil, which means that the raw LaTeX source code is displayed. The other possibilities are:
    • mathjax: Use the mathjax-node library, which you need to ensure to be installed in such a way that Node will find it.
    • org: Use Org mode's built-in rendering machinery. Beware that, depending on your system configuration, this may allow execution of arbitrary code embedded in the LaTeX fragments.

3. Extending

To add support for new MIME types, see comint-mime-renderer-alist.

To add support for new comints, an entry should be added to comint-mime-setup-function-alist. This function should arrange for the inferior process to emit an escape sequence whenever some MIME content is to be displayed.

The escape sequence has the following shape:

ESC ] 5 1 5 1 ; header LF payload ESC \

Here, header is a JSON object containing, at least, the entry type, which should be the name of a MIME type. Other header entries can be passed; the interpretation is up to the rendering function.

The payload can be either the content of the attachment, encoded in base64 (which is decoded before being passed to the selected renderer), or a file:// URL (whose content is read and passed to the renderer), or yet a tmpfile:// URL, which indicates that the file should be deleted after it is read.

Note that it can take considerable time to insert large amounts of data in a comint buffer, specially if it contains long lines. Consider using a temporary file for large data transfers.

4. Todos

  • Improve the HTML rendering of numeric tables

5. Contributing

Discussions, suggestions and code contributions are welcome! Since this package is part of GNU ELPA, contributions require a copyright assignment to the FSF.

Old versions

comint-mime-0.5.tar.lz2024-Sep-176.77 KiB
comint-mime-0.4.tar.lz2024-Mar-316.57 KiB
comint-mime-0.3.tar.lz2023-Apr-226.49 KiB
comint-mime-0.2.tar.lz2022-Sep-176.21 KiB
comint-mime-0.1.tar.lz2022-Apr-045.73 KiB