jaq-nvim

jaq-nvim is Just Another Quickrun plugin for Neovim that was inspired by quickrun.vim. In short, it is a plugin that lets you run the code of any language with a single command.

Demo:

Type Info	Demonstration
Internal: Runs a vim command using `:`.
Float: Opens a floating window with `vim.api.nvim_open_win()`
Terminal: Opens a terminal with `:terminal`
Bang: Opens a small window with `:!`
Quickfix: Command output is placed in a quickfix window

Installation:

packer.nvim:

use {"is0n/jaq-nvim"}

Example Lua Config:

require('jaq-nvim').setup{
  cmds = {
    -- Uses vim commands
    internal = {
      lua = "luafile %",
      vim = "source %"
    },

    -- Uses shell commands
    external = {
      markdown = "glow %",
      python   = "python3 %",
      go       = "go run %",
      sh       = "sh %"
    }
  },

  behavior = {
    -- Default type
    default     = "float",

    -- Start in insert mode
    startinsert = false,

    -- Use `wincmd p` on startup
    wincmd      = false,

    -- Auto-save files
    autosave    = false
  },

  ui = {
    float = {
      -- See ':h nvim_open_win'
      border    = "none",

      -- See ':h winhl'
      winhl     = "Normal",
      borderhl  = "FloatBorder",

      -- See ':h winblend'
      winblend  = 0,

      -- Num from `0-1` for measurements
      height    = 0.8,
      width     = 0.8,
      x         = 0.5,
      y         = 0.5
    },

    terminal = {
      -- Window position
      position = "bot",

      -- Window size
      size     = 10,

      -- Disable line numbers
      line_no  = false
    },

    quickfix = {
      -- Window position
      position = "bot",

      -- Window size
      size     = 10
    }
  }
}

Example JSON Config:

{
  "internal": {
    "lua": "luafile %",
    "vim": "source %"
  },

  "external": {
    "markdown": "glow %",
    "python": "python3 %",
    "go": "go run %",
    "sh": "sh %"
  }
}

In the current working directory, Jaq will search for a file called .jaq.json.

This config file will be used for running commands, both external and internal.

Usage:

:Jaq by default uses the float type to run code. The default can be changed (see Example Lua Config).

To use any other type, provide any of the arguments seen in Demonstration.

Example: :Jaq bang

The commands for :Jaq also have certain variables that can help in running code.

You can put any of the following in require('jaq-nvim').setup() or .jaq.json ...

% / $file • Current File
# / $altFile • Alternate File
$dir • Current Working Directory
$filePath • Path to Current File
$fileBase • Basename of File (no extension)
$moduleName • Python Module Name