gnebbia / vimi

A vimscript interpreter for GNU/Linux, MacOS and *BSDs

vimi

This project is an attempt at creating a simple vimscript interpreter. Vimi is able to take as input a vimscript and execute it, and hence it makes vim more similar to any other full-fledged programming language.

Installation

In order to install vimi we can simply clone this repo and execute the install.sh script by doing:

git clone https://github.com/gnebbia/vimi

and then:

cd vimi/
bash install.sh

Executing a script

Like other programming languages, we can execute our vim script by calling the vimscript interpreter like this:

vimi myscript.vim

As a demo example, let's create a simple script which we will call example.vim with the following content:

"take user input
let ciao = Input("Type something: ")

"print to screen what user inserted
echo "You inserted: " . ciao


"print to screen arguments passed"
let passed_args = Argv()
echo(passed_args)

vimi will execute the script by executing:

vimi example.vim --arg1 value1 --arg2 value2 -v

License

The vimi interpreter is under GPLv3 license. Please see LICENSE file for more details.