This is the source code for a plugin to add language support for Hoon to the IntelliJ IDEA IDE.
- Syntax checking
- Customizable syntax highlighting
- Comment/uncomment shortcut
- Custom Hoon file icon
- Code completion for faces (6, 10)
- Find usages of faces (11)
- Fold/collapse expressions (12)
- Structure view of file (14)
- Auto-format to code style (15, 16)
The plugin is available for download natively through the IDEA plugin marketplace. You can also manually download and install the plugin from the JetBrains Marketplace or from the releases page of this repository.
Once downloaded, files ending in .hoon will automatically be processed by the plugin. The plugin will check for syntax
errors and highlight tokens/expressions.
To help develop this plugin, please complete the prerequisites of the IntelliJ Custom Language Support Tutorial. Then, fork this repository, clone your version of the source code, and submit a pull request with whatever changes you think are needed.
My guiding principle when writing the plugin was to catch as many syntax errors as possible, while never marking a
correct expression as incorrect. It's impossible for me to capture every single language scenario without re-writing the
entire Hoon compiler in .bnf format. For that reason, some syntax errors may slip through.
With that in mind, due to tokenization issues, the following correct Hoon language features are currently marked as incorrect by the plugin:
- Some uses of irregular tisgal (
=<) (e.g.result:~(arm core arg)interpreted as poorly-formed colsig expression instead of=< result %~ arm core arg) - Some uses of irregular colhep (
:-) (e.g.-^+interpreted as poorly-formed ketlus expression instead of:- - +) - siggal (
~<) and siggar (~>) runes, with inputptaking form[p=term q=hoon], and using form%foo.hoon, wherehoonbegins with a number - Hoon 151 mold syntax (e.g.
$~) - Irregular ketcol (
^:) form on wing expressions (e.g.,+.a) - Using generic text in the tall SAIL format