Skip to content

Spreadcat/ansible-role-nnn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Role dbv.nnn

Ansible role to install and configure a the nnn file manager.

Requirements

  • The NNN package must be available in the local file repository.
  • Rsync
  • The role requires gathered_facts: true to be set.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

nnn_path_environment_file: str
  • Path for the file to define the export for the plugin inclusion in.

    # Example:
    nnn_path_environment_file: "{{ lookup('ansible.builtin.env', 'HOME') }}/.bashrc"
nnn_plugins_install: bool
  • If set to true plugins will be fetched from nnn_url_master and installed into the plugin directory.

    # Example:
    nnn_plugins_install: true
nnn_plugins_update: bool
  • If set to true, existing plugins will be overwritten from the github source and updated on the local disk.

    # Example:
    nnn_plugins_update: true

Configuration variables

nnn_archmnt: str
  • Achive mounter for NNN.

    # Example:
    nnn_archmnt: "fuse-archive"
nnn_order: list
  • Set directory specific ordering.

    # Example:
    NNN_ORDER:
      - key: t
        path: /var/log
nnn_plug: list
  • List of plugins to install/enable.

    # Example:
    nnn_plugins:
      - key: i
        plugin: imgview
      - key: j
        plugin: imgresize

Other variables

nnn_group: str
  • Default group for NNN.

    # Example:
    nnn_group: jdoe
nnn_owner: str
  • Default user for NNN.

    # Example:
    nnn_owner: jdoe
nnn_packages: list
  • defaults file for nnn Default packages to install for NNN

    # Example:
    nnn_packages:
      - nnn
nnn_packages_state: str
  • Default state for the installed packages.

    # Example:
    nnn_packages_state: "present"
nnn_path_config_dir: str
  • Default path to the configuration directory.

    # Example:
    nnn_path_config_dir: "/home/user/.config/nnn"
nnn_url_master: str
  • URL for downloading a compressed version of the source code for nnn. This is used to fetch the plugins and install them when required.

    # Example:
    nnn_url_master: "https://github.com/jarun/nnn/archive/master.tar.gz"

Dependencies

  • None

Example Playbook

Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:

---
- hosts: all
  roles:
     - role: dbv.nnn

Limitations

The role lacks support for most of the environment variables of nnn at this point. This is due to the role growing as I need it and which parameters I need to set. But I put some effort into making it easy to extend when needed. If you miss a particular parameter, just pop me a message.

License

MIT

Author Information

  • This role is written an maintained by DBV.

About

Ansible role for managing nnn on a local machine.

Resources

Stars

Watchers

Forks

Packages

No packages published