hurricanehrndz.nvim

Ansible role to set up my Neovim configuration.

Requirements

None.

Role Variables

Below are the variables you can set for this role, including those found in defaults/main.yml and vars/main.yml, as well as any that can be set through role parameters.

nvim_user: "{{ ansible_user | default(lookup('env', 'USER')) }}"

The user for whom the Neovim configuration and dependencies will be installed. The default is ansible_user.

nvim_git_repo: "https://github.com/hurricanehrndz/nvim"

URL of the git repository containing the Neovim configuration to be installed.

nvim_python_ver: 3.8.0

The Python version to install using pyenv, to support Python-based plugins in Neovim.

nvim_python_mods:
  - pynvim
  - neovim-remote
  - vim-vint
  - flake8
  - yamllint
  - jedi
  - ansible
  - testinfra
  - docker
  - molecule

nvim_python_mods is a list of Python modules to install for completion engines and other Neovim features. At a minimum, it should include pynvim.

nvim_fzf_bin_only: false

Set to true to prevent changes to nvim_user's shell configuration during fzf installation.

nvim_fnm_root_suffix: ".local/share/fnm"

Where fnm will be installed in nvim_user's home directory. Defaults to .local/share/fnm.

nvim_pyenv_root_suffix: ".local/share/pyenv"

Where pyenv will be installed in nvim_user's home directory. Defaults to .local/share/pyenv.

nvim_nodejs_version: "latest-v12.x"

The Node.js version to install.

nvim_npm_global_pkgs: []

A list of global npm packages to install; by default, it includes only neovim.

Dependencies

hurricanehrndz.pyenv
hurricanehrndz.fnm
hurricanehrndz.rustup

Example Playbook

Here is an example of how to use this role (with variables passed as parameters):

- name: Install neovim configuration
  hosts: all
  vars:
    nvim_user: hurricanehrndz
  tasks:
    - name: Update repo cache
      action: >
        {{ ansible_pkg_mgr }} update_cache=yes

    - name: Add hurricanehrndz user
      user:
        name: "{{ nvim_user }}"
        create_home: yes
        shell: /bin/bash

    - name: Run nvim role
      include_role:
        name: ansible-nvim