new: parameter -hidden when using -mode=term to set bufhidden to hidden

improve: keep alternative window when splitting an terminal window
improve: more safe to start a terminal in a new tab

Author: skywind3000

README.md

@@ -288,6 +288,7 @@ See: [Cooperate with famous plugins](https://github.com/skywind3000/asyncrun.vim
 
 ## History
 
+- 2.2.6 (2020-02-06): new: parameter `-hidden` when using `-mode=term` to set `bufhidden` to `hidden`.
 - 2.2.5 (2020-02-05): more safe to start a terminal.
 - 2.2.4 (2020-02-05): exit when starting terminal failed in current window with `-pos=curwin`.
 - 2.2.3 (2020-02-05): new `-program=wsl` to run command in wsl (windows 10 only).

plugin/asyncrun.vim

@@ -3,7 +3,7 @@
 " Maintainer: skywind3000 (at) gmail.com, 2016, 2017, 2018, 2019, 2020
 " Homepage: http://www.vim.org/scripts/script.php?script_id=5431
 "
-" Last Modified: 2020/02/05 06:36
+" Last Modified: 2020/02/06 14:43
 "
 " Run shell command in background and output to quickfix:
 "     :AsyncRun[!] [options] {cmd} ...
@@ -44,8 +44,10 @@
 "     $VIM_COLUMNS   - How many columns in vim's screen
 "     $VIM_LINES     - How many lines in vim's screen
 "
-"     parameters also accept these environment variables wrapped by
-"     "$(...)", and "$(VIM_FILEDIR)" will be expanded as file directory
+"     Parameters also accept these environment variables wrapped by
+"     "$(...)", and "$(VIM_FILEDIR)" will be expanded as file directory.
+"
+"     It is safe to use "$(...)" than "%:xx" when filenames contain spaces.
 "
 " There can be some options before [cmd]:
 "     -mode=0/1/2  - start mode: 0(async, default), 1(makeprg), 2(!)
@@ -83,15 +85,25 @@
 "
 " Requirements:
 "     vim 7.4.1829 is minimal version to support async mode
+"     vim 8.1.1 is minial version to use "-mode=term"
 "
 " Examples:
 "     :AsyncRun gcc % -o %<
 "     :AsyncRun make
-"     :AsyncRun -raw python $(VIM_FILEPATH)
+"     :AsyncRun -raw -cwd=$(VIM_FILEDIR) python "$(VIM_FILEPATH)"
 "     :AsyncRun -cwd=<root> make
-"     :AsyncRun! grep -R <cword> .
+"     :AsyncRun! grep -n -R <cword> .
 "     :noremap <F7> :AsyncRun gcc % -o %< <cr>
 "
+" Run in the internal terminal:
+"     :AsyncRun -mode=term bash
+"     :AsyncRun -mode=term -pos=tab bash
+"     :AsyncRun -mode=term -pos=curwin bash
+"     :AsyncRun -mode=term -pos=top -rows=15 bash
+"     :AsyncRun -mode=term -pos=bottom -rows=15 bash
+"     :AsyncRun -mode=term -pos=left -cols=40 bash
+"     :AsyncRun -mode=term -pos=right -cols=40 bash
+"
 " Additional:
 "     AsyncRun uses quickfix window to show job outputs, in order to
 "     see the outputs in realtime, you need open quickfix window at
@@ -1061,6 +1073,7 @@ endfunc
 function! s:start_in_terminal(opts)
 	let command = a:opts.command
 	let pos = get(a:opts, 'pos', 'bottom')
+	let hidden = get(a:opts, 'hidden', 0)
 	if has('patch-8.1.1') == 0 && has('nvim-0.3') == 0
 		call s:ErrorMsg("Terminal is not available in this vim")
 		return -1
@@ -1083,47 +1096,50 @@ function! s:start_in_terminal(opts)
 		endif
 	endfor
 	if pos == 'tab'
+		exec "tab split"
 		if has('nvim') == 0
-			let cmd = 'tab term ++noclose ++norestore'
+			let cmd = 'tab term ++noclose ++norestore ++curwin'
 			if has('patch-8.1.2255') || v:version >= 802
-				exec cmd . ' ++shell ' . command
+				exec cmd . ' ++shell ++kill=term ' . command
 			else
-				exec cmd . ' ' . command
-			endif
-			if &bt == 'terminal'
-				setlocal nonumber signcolumn=no norelativenumber
+				exec cmd . ' ++kill=term ' . command
 			endif
 		else
-			exec 'tabe term://'. fnameescape(command)
-			if &bt == 'terminal'
-				setlocal nonumber signcolumn=no norelativenumber
-				startinsert
+			exec 'term '. command
+		endif
+		if &bt == 'terminal'
+			setlocal nonumber signcolumn=no norelativenumber
+			let b:asyncrun_cmd = command
+			exec has('nvim')? 'startinsert' : ''
+			if has_key(a:opts, 'hidden')
+				exec 'setlocal bufhidden=' .. (hidden? 'hide' : '')
 			endif
 		endif
 		return 0
 	elseif pos == 'cur' || pos == 'curwin' || pos == 'current'
 		if has('nvim') == 0
 			let cmd = 'term ++noclose ++norestore ++curwin'
 			if has('patch-8.1.2255') || v:version >= 802
-				exec cmd . ' ++shell ' . command
+				exec cmd . ' ++shell ++kill=term ' . command
 			else
-				exec cmd . ' ' . command
-			endif
-			if &bt == 'terminal'
-				setlocal nonumber signcolumn=no norelativenumber
+				exec cmd . ' ++kill=term ' . command
 			endif
 		else
 			exec 'term '. command
-			if &bt == 'terminal'
-				setlocal nonumber signcolumn=no norelativenumber
-				startinsert
+		endif
+		if &bt == 'terminal'
+			setlocal nonumber signcolumn=no norelativenumber
+			let b:asyncrun_cmd = command
+			exec has('nvim')? 'startinsert' : ''
+			if has_key(a:opts, 'hidden')
+				exec 'setlocal bufhidden=' .. (hidden? 'hide' : '')
 			endif
 		endif
 		return 0
 	endif
 	let uid = win_getid()
-	noautocmd windo call s:save_restore_view(0)
-	noautocmd call win_gotoid(uid)
+	keepalt noautocmd windo call s:save_restore_view(0)
+	keepalt noautocmd call win_gotoid(uid)
 	let focus = get(a:opts, 'focus', 1)
 	let origin = win_getid()
 	if avail < 0
@@ -1145,7 +1161,9 @@ function! s:start_in_terminal(opts)
 		exec "normal! ". avail . "\<c-w>\<c-w>"
 	endif
 	let uid = win_getid()
-	noautocmd windo call s:save_restore_view(1)
+	keepalt noautocmd call win_gotoid(origin)
+	keepalt noautocmd windo call s:save_restore_view(1)
+	keepalt noautocmd call win_gotoid(origin)
 	noautocmd call win_gotoid(uid)
 	if has('nvim') == 0
 		let cmd = 'term ++noclose ++norestore ++curwin '
@@ -1154,14 +1172,15 @@ function! s:start_in_terminal(opts)
 		else
 			exec cmd . ' ++kill=term ' . command
 		endif
-		if &bt == 'terminal'
-			setlocal nonumber signcolumn=no norelativenumber
-		endif
 	else
 		exec 'term '. command
-		if &bt == 'terminal'
-			setlocal nonumber signcolumn=no norelativenumber
-			startinsert
+	endif
+	if &bt == 'terminal'
+		setlocal nonumber signcolumn=no norelativenumber
+		let b:asyncrun_cmd = command
+		exec has('nvim')? 'startinsert' : ''
+		if has_key(a:opts, 'hidden')
+			exec 'setlocal bufhidden=' .. (hidden? 'hide' : '')
 		endif
 	endif
 	if focus == 0 && &bt == 'terminal'
@@ -1570,7 +1589,7 @@ endfunc
 " asyncrun -version
 "----------------------------------------------------------------------
 function! asyncrun#version()
-	return '2.2.5'
+	return '2.2.6'
 endfunc
 
 
@@ -1605,27 +1624,27 @@ function! asyncrun#quickfix_toggle(size, ...)
 	endfunc
 	let s:quickfix_open = 0
 	let l:winnr = winnr()
-	noautocmd windo call s:WindowCheck(0)
-	noautocmd silent! exec ''.l:winnr.'wincmd w'
+	keepalt noautocmd windo call s:WindowCheck(0)
+	keepalt noautocmd silent! exec ''.l:winnr.'wincmd w'
 	if l:mode == 0
 		if s:quickfix_open != 0
 			silent! cclose
 		endif
 	elseif l:mode == 1
 		if s:quickfix_open == 0
-			exec 'botright copen '. ((a:size > 0)? a:size : ' ')
-			wincmd k
+			keepalt exec 'botright copen '. ((a:size > 0)? a:size : ' ')
+			keepalt wincmd k
 		endif
 	elseif l:mode == 2
 		if s:quickfix_open == 0
-			exec 'botright copen '. ((a:size > 0)? a:size : ' ')
-			wincmd k
+			keepalt exec 'botright copen '. ((a:size > 0)? a:size : ' ')
+			keepalt wincmd k
 		else
 			silent! cclose
 		endif
 	endif
-	noautocmd windo call s:WindowCheck(1)
-	noautocmd silent! exec ''.l:winnr.'wincmd w'
+	keepalt noautocmd windo call s:WindowCheck(1)
+	keepalt noautocmd silent! exec ''.l:winnr.'wincmd w'
 endfunc