hy-fancy-repl 1.2.1

🦑 hy-fancy-repl

A Hy enhanced REPL.

Compatible with Hy 1.2.0 and later.

Install

$ pip install -U hy-fancy-repl

The REPL

The REPL implements multi-line editing, completion, live input validation, live syntax highlighting, bracket matching, enhanced tracebacks, and interactive matplotlib plots.

$ hy-repl

or

$ hy-fancy-repl

Features

• Multi-line editing with smart indentation
• Syntax highlighting via Pygments
• Bracket matching that ignores brackets inside strings and comments
• Tab completion with Hy's native completer
• Live validation - shows a red 'x' when parentheses are unbalanced
• Enhanced tracebacks - shows syntax-highlighted source snippets
• Interactive matplotlib - async plot updates when available
• History persistence - saved to ~/.hy-history by default

Environment Variables

The REPL's behaviour may be modified with the following environment variables:

Traceback Filtering

By default, the REPL hides infrastructure files in tracebacks to show your code. The default ignore list includes Hy internals, funcparserlib, and multimethod.

Override with HY_TRACEBACK_IGNORE:

$ HY_TRACEBACK_IGNORE="hy/repl.py,code.py" hy-fancy-repl

Or modify at runtime:

from hy_fancy_repl.repl import TRACEBACK_IGNORE
# TRACEBACK_IGNORE is a tuple of file path suffixes to ignore

Acknowledgements

The REPL uses pygments, prompt-toolkit, colorist, and Hy.

Contributing

See CONTRIBUTING.md for development setup and contribution guidelines.

Docs

Try clicking below.