denite-z neo/vim plugin

Filter and browse z / z.lua / zoxide (jump around) data file with this denite.nvim plugin for Neovim or Vim.

Features

• Detect and use zoxide, or fallback to original rupa/j2 implementation
• Custom Denite sorter
• Manual command option

Installation

Use your favorite plugin manager, mine is dein.vim.

Requirements

• Python 3.4 or later
• Vim or Neovim
• denite.nvim
• One of z's variants:
  • zoxide
  • z.lua
  • rupa/z

Usage

:Denite z[:query[:order]]

• query can be any string to filter candidates
• order must be one of: rank, recent (default), frecent (Doesn't work when zoxide is used)

Examples:

• To list all entries: :Denite z
• Query to filter results: :Denite z:acme
• To list all entries with the rank order: :Denite z::rank

Configuration

Set the z source sorter to sorter/z for proper rank order:

call denite#custom#source('z', 'sorters', ['sorter/z'])

Create a short-cut command: (Usage: :Z foo)

command! -nargs=+ -complete=command Z
  \ call denite#start([{'name': 'z', 'args': [<q-args>]}])

Unless you're using zoxide, you can change the order option:

call denite#custom#var('z', 'order', 'frecent')

Possible options: rank, recent, and frecent.

Credits & Contribution

• rupa/z - wonderful utility
• rupa/j2 - included python implementation of z

This plugin is maintained by Rafael Bodill.

Pull requests are welcome.