async.vim
normalize async job control api for vim and neovim
sample usage
function! s:handler(job_id, data, event_type)
echo a:job_id . ' ' . a:event_type
echo join(a:data, "\n")
endfunction
if has('win32') || has('win64')
let argv = ['cmd', '/c', 'dir c:\ /b']
else
let argv = ['bash', '-c', 'ls']
endif
let jobid = async#job#start(argv, {
\ 'on_stdout': function('s:handler'),
\ 'on_stderr': function('s:handler'),
\ 'on_exit': function('s:handler'),
\ })
if jobid > 0
echom 'job started'
else
echom 'job failed to start'
endif
" If you want to get the process id of the job
let pid = async#job#pid(jobid)
" If you want to wait the job:
call async#job#wait([jobid], 5000) " timeout: 5 sec
" If you want to stop the job:
call async#job#stop(jobid)APIs
APIs are based on neovim's job control APIs.
Embedding
Async.vim can be either embedded with other plugins or be used as an external plugin. If you want to embed run the following vim command.
:AsyncEmbed path=./autoload/myplugin/job.vim namespace=myplugin#jobTodos
- Fallback to sync
system()calls in vim that doesn't supportjob job_stopandjob_sendis treated as noop when usingsystem()on_stderrdoesn't work when usingsystem()- Fallback to python/ruby threads and vimproc instead of using
system()for better compatibility (PRs welcome!!!)

Formed in 2009, the Archive Team (not to be confused with the archive.org Archive-It Team) is a rogue archivist collective dedicated to saving copies of rapidly dying or deleted websites for the sake of history and digital heritage. The group is 100% composed of volunteers and interested parties, and has expanded into a large amount of related projects for saving online and digital history.
