⚠️ Deprecation Notice

About

Installation

use {'pianocomposer321/yabs.nvim',requires= {'nvim-lua/plenary.nvim'}}

Plug'nvim-lua/plenary.nvim'`Plug'pianocomposer321/yabs.nvim'`

Setup

require('yabs'):setup({languages= {-- List of languages in vim's `filetype` formatlua= {tasks= {run= {command='luafile %',-- The command to run (% and other-- wildcards will be automatically-- expanded)type='vim',-- The type of command (can be `vim`, `lua`, or-- `shell`, default `shell`)        },      },    },c= {default_task='build_and_run',tasks= {build= {command='gcc main.c -o main',output='quickfix',-- Where to show output of the-- command. Can be `buffer`,-- `consolation`, `echo`,-- `quickfix`, `terminal`, or `none`opts= {-- Options for output (currently, there's only-- `open_on_run`, which defines the behavior-- for the quickfix list opening) (can be-- `never`, `always`, or `auto`, the default)open_on_run='always',          },        },run= {-- You can specify as many tasks as you want per-- filetypecommand='./main',output='consolation',        },build_and_run= {-- Setting the type to lua means the command-- is a lua functioncommand=function()-- The following api can be used to run a task when a-- previous one finishes-- WARNING: this api is experimental and subject to-- changesrequire('yabs'):run_task('build', {-- Job here is a plenary.job object that represents-- the finished task, read more about it here:-- https://github.com/nvim-lua/plenary.nvim#plenaryjobon_exit=function(Job,exit_code)-- The parameters `Job` and `exit_code` are optional,-- you can omit extra arguments or-- skip some of them using _ for the nameifexit_code==0thenrequire('yabs').languages.c:run_task('run')endend,            })end,type='lua',        },      },    },  },tasks= {-- Same values as `language.tasks`, but globalbuild= {command='echo building project...',output='consolation',    },run= {command='echo running project...',output='echo',    },optional= {command='echo runs on condition',-- You can specify a condition which determines whether to enable a-- specific task-- It should be a function that returns boolean,-- not a boolean directly-- Here we use a helper from yabs that returns such function-- to check if the files existscondition=require('yabs.conditions').file_exists('filename.txt'),    },  },opts= {-- Same values as `language.opts`output_types= {quickfix= {open_on_run='always',      },    },  },})

Usage

localyabs=require('yabs')-- runs the task `build` for the current language, falling back to a global-- task with that name if it is not found for the current languageyabs:run_task('build')-- runs the task that is specified as the default (see configuration section-- above), or the first one if not specifiedyabs:run_default_task()-- Run command `echo hello, world` directly. Output is specified by the second-- argument (same possible values as `output` option for tasks above), and-- additional arguments are defined with the third argument (same as-- `task.opts` above)yabs.run_command('echo hello, world','quickfix', {open_on_run='always'})

.yabs files

return {languages= {python= {tasks= {run= {command='python %',output='quickfix',        },      },    },  },tasks= {build= {command='cargo build',output='consolation',    },  }}

Telescope integration

Advanced configuration

Chaining tasks

Screenshots