cilinder / enumerion-ts

Emacs major mode for Enumerion based on tree-sitter

enumerion-ts

Emacs major mode for Enumerion based on tree-sitter.

For an introduction on how to use tree-sitter in emacs see here.

Requirements:

• An emacs version 29.1+ built with tree-sitter support

Install

Install tree-sitter grammar

First you need to install the tree-sitter grammar for Enumerion. Add this to your emacs config

(setq treesit-language-source-alist
	'((enumerion "[e-mail]:cilinder/tree-sitter-enumerion.git")))

Then install the tree-sitter grammar via M-x treesit-install-language-grammar, type enumerion and press RET.

Install major mode

You can install the major mode in emacs with

(package-vc-install "https://github.com/cilinder/enumerion-ts")

Then add the following to your config

(require 'enumerion-ts)

or if you use use-package

(use-package enumerion-ts)

Usage

Activate with M-x enumerion-ts-mode.

To set the mode to automatically activate with Enumerion files add this to your config

(setq auto-mode-alist
	(append '(("\\.enum$" . enumerion-ts-mode))
		auto-mode-alist))

This will enable syntax highlighting and indentation rules in .enum files.

Update

To update the package you can use the command package-vc-upgrade in emacs and select enumerion-ts.

To update the language grammar, use the command treesit-install-language-grammar and select enumerion.

Enumerion-repl

This package also comes with a REPL mode for Enumerion.

To set it up, you need to configure the variable enumerion-repl-file-path to point to the location of an Enumerion executable. You can do this by either adding

(setq enumerion-repl-file-path <enumerion executable location>)

to your config or customizing it by M-x customize-variable RET enumerion-repl-file-path and setting its value.

To start an repl use the command enumerion-repl. The default keybinding is C-c C-p.

Usage in .enum files

If you are editing an Enumerion file, you can do the following:

• Send a region to the repl via enumerion-repl-send-region with default keybinding C-c C-r.
• send the current toplevel expression under point to the repl via enumerion-repl-send-statement with default keybinding C-c C-e.