davidwilemski / aniseed

Configure and extend Neovim with Fennel

Aniseed

Aniseed bridges the gap between Fennel (a Lisp that compiles to Lua) and Neovim. Allowing you to easily write plugins or configuration in a Clojure-like Lisp with great runtime performance.

Further documentation can be found in :help aniseed. There you can learn about the scripts, macros, functions and use cases of Aniseed.

Installation

Use your favourite plugin manager, I recommend vim-plug if you don’t have one already.

Plug 'Olical/aniseed', { 'tag': 'v3.8.0' }
Plug 'bakpakin/fennel.vim'

For interactive evaluation you need to install Conjure. It’ll allow you to send portions of your code off for evaluation as well as see the results in an interactive log buffer.

You may also be interested in nvim-local-fennel which is essentially a Fennel based version of localvimrc.

Setting up a plugin project

scripts/seed.sh is provided to make it a little easier to get a plugin up and running. In anew directory (because it will overwrite your .gitignore and Makefile etc) run the following command.

It will name the plugin after the directory you’re currently running it from. Make sure the directory name doesn’t include any spaces or special characters because it will be inserted at some points in the seed code for you.

curl -fL https://raw.githubusercontent.com/Olical/aniseed/master/scripts/seed.sh | sh

This will create some example Fennel source and tests as well as a Makefile to help you compile and run it all. This should be enough to get you started without being overly opinionated.

Unlicenced

The following files are excluded from my license and ownership:

• lua/aniseed/deps/fennel.lua

• lua/aniseed/deps/fennelview.lua

• lua/aniseed/deps/nvim.lua

These files come from Fennel and nvim.lua, I did not write them, all other files are from me and unlicenced. The aforementioned files should be considered under their respective project licences. They are copied into this repo to allow the plugin to work with systems that don’t support symlinks correctly.

Find the full unlicense in the UNLICENSE file, but here’s a snippet.

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.