Neovim Lua Script

Contents

• Introduction
• Installation
  • Vim Plug
  • Vim
  • Neovim
• Setup
• Usage
  • List of functions and variables
  • Converting from Vim Script

Introduction

Due to the hype of the excellent Lua support that Neovim provides, many people want to move their configuration to Lua from Vim Script. However, it is much more difficult to configure Neovim via Lua than Vim Script, despite Lua being an easy programming language. This does not change the fact that Lua is a better and more robust language, so this trade-off is worth it. What if I told you that you do not need to have a trade-off? You can actually configure Neovim easier with Lua than with Vim Script with this plugin.

Installation

Vim Plug

Plug "amarakon/nvim-lua-script"

Vim

`# user` git clone https://github.com/amarakon/nvim-sensible ~/.vim/pack/vendor/start/nvim-sensible

Neovim

`# user` git clone https://github.com/amarakon/nvim-sensible ~/.local/share/nvim/site/pack/default/start/nvim-sensible

Setup

To set up the functions and variables provided by this plugin, simply put the following line in your Lua configuration. If you are configuring Neovim with Vim, add lua in front of the following line.

require("lua-script")

Usage

List of functions and variables

Keybindings

Basic

You have to specify the mode for these functions.

• keymap(mode, lhs, rhs, opts)
• keynoremap(mode, lhs, rhs, opts)

Modal

• nmap(lhs, rhs, opts)
• imap(lhs, rhs, opts)
• vmap(lhs, rhs, opts)
• cmap(lhs, rhs, opts)
• omap(lhs, rhs, opts)

Regular

These keybindings apply to normal and visual mode.

• map(lhs, rhs, opts)
• noremap(lhs, rhs, opts)

Auto-commands

• autocmd(type, match, opts)

Options

• g = vim.g
• o = vim.o
• opt = vim.opt

Converting from Vim Script

Using the concepts provided by this plugin, I will convert the first code block (Vim Script) into the second code block (Lua).

nmap <Space> <nop>
imap <C-c> #<Space>
noremap tn <Escape>

let g:mapleader = " "
set pumheight=5

autocmd TextYankPost * lua vim.highlight.on_yank { higroup = "Visual" }

nmap("<Space>", "") -- No need to use `<nop>`
imap("<C-c>", "# ") -- No trailing whitespace by using a space character
map("tn", "<Escape>")

g.mapleader = " " -- Fewer columns of code
opt.pumheight = 5

autocmd("TextYankPost", "*", function ()
    vim.highlight.on_yank { higroup = "Visual" } -- No need to call Lua from Vim
end)