Difference between revisions of "D in Vim"
m (Move "Installing Vundle" up. It makes more sense to see this first.) |
(More complete and better-documented errorformat) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 42: | Line 42: | ||
It also possible to display a tagbar of all all declared functions, classes etc. | It also possible to display a tagbar of all all declared functions, classes etc. | ||
Please follow the instructions of [https://github.com/majutsushi/tagbar tagbar]'s [https://github.com/majutsushi/tagbar/wiki#d Wiki]. | Please follow the instructions of [https://github.com/majutsushi/tagbar tagbar]'s [https://github.com/majutsushi/tagbar/wiki#d Wiki]. | ||
| + | |||
| + | =Highlighting Phobos= | ||
| + | The [https://github.com/Sirsireesh/vim-dlang-phobos-highlighter vim-dlang-phobos-highlighter] plugin allows highlighting of Phobos (functions, templates and types) and user defined functions, along with version identifiers. | ||
=Neovim= | =Neovim= | ||
| − | With the rise of Neovim, [https://github.com/landaire/deoplete-d deoplete-d] can be used for auto-completion. | + | With the rise of Neovim, [https://github.com/ncm2/ncm2-d ncm2-d] or [https://github.com/landaire/deoplete-d deoplete-d] can be used for auto-completion. |
= Errorformat = | = Errorformat = | ||
| − | + | With this autocmd, Vim will parse error messages from the D compiler and from uncaught exceptions (including failed assertions in unit tests): | |
| − | <pre>autocmd FileType d | + | <pre> |
| + | " errorformat entries: | ||
| + | " - Errors from -verrors=spec (ignored) | ||
| + | " - Uncaught exceptions (e.g., from unit tests) | ||
| + | " - Errors in string mixins | ||
| + | " - Normal compile errors | ||
| + | autocmd FileType d setlocal errorformat= | ||
| + | \%-G\(spec:%*[0-9]\)\ %m, | ||
| + | \%*[^@]@%f\(%l\):\ %m, | ||
| + | \%f-mixin-%*[0-9]\(%l\\,%c\):\ %m, | ||
| + | \%f-mixin-%*[0-9]\(%l\):\ %m, | ||
| + | \%f\(%l\\,%c\):\ %m, | ||
| + | \%f\(%l\):\ %m | ||
| + | </pre> | ||
= Unit Testing = | = Unit Testing = | ||
Latest revision as of 21:46, 12 November 2021
Vim features and plugins useful for D coding.
Contents
Installing Vundle
Many Vim plugins require a plugin manager for installation. Vundle is one such plugin manager.
To install Vundle see the Quick Start section on Vundle's site.
UltiSnips
UltiSnips is a Vim snippet plugin with D support. It makes it possible to complete tasks such as writing a loop, wrapping code in try/catch or adding an operator in a few keystrokes.
Installing UltiSnips:
- Make sure you have a plugin manager such as Vundle installed.
- See the Quick Start section at UltiSnips site.
DSnips
DSnips is a (greatly) improved version of UltiSnips D snippets. It covers almost all D features and its snippets are designed to work together (e.g. can be used within one another or in chains). See DSnips reference
Installing DSnips:
- You need to have UltiSnips installed first.
git clone https://github.com/kiith-sa/DSnips.git
- Copy the d.snippets file to UltiSnips user snippets directory. On Linux this should be ~/.vim/UltiSnips.
If you don't know where the user snippets directory is, open a D file and type the :UltiSnipsEdit command (after UltiSnips is installed); this will open a user d.snippets file which you can replace by the DSnips version of d.snippets.
Dutyl
The Dutyl plugin integrates D tools such as DCD, DUB and DScanner to provide autocompletion, syntax checking, documentation search and more features.
Vebugger
The Vebugger plugin acts as a frontend for command line debuggers, and can be used to debug D programs with GDB. You'll need to use :VBGstartGDBForD to debug D programs.
Tagbar
It also possible to display a tagbar of all all declared functions, classes etc. Please follow the instructions of tagbar's Wiki.
Highlighting Phobos
The vim-dlang-phobos-highlighter plugin allows highlighting of Phobos (functions, templates and types) and user defined functions, along with version identifiers.
Neovim
With the rise of Neovim, ncm2-d or deoplete-d can be used for auto-completion.
Errorformat
With this autocmd, Vim will parse error messages from the D compiler and from uncaught exceptions (including failed assertions in unit tests):
" errorformat entries: " - Errors from -verrors=spec (ignored) " - Uncaught exceptions (e.g., from unit tests) " - Errors in string mixins " - Normal compile errors autocmd FileType d setlocal errorformat= \%-G\(spec:%*[0-9]\)\ %m, \%*[^@]@%f\(%l\):\ %m, \%f-mixin-%*[0-9]\(%l\\,%c\):\ %m, \%f-mixin-%*[0-9]\(%l\):\ %m, \%f\(%l\\,%c\):\ %m, \%f\(%l\):\ %m
Unit Testing
The following function runs unittests on the current file and displays coverage information as a split window bound to left of the source window;
function! DTest()
let l:fn = substitute(expand('%:r'), '/', '-', 'g') . '.lst'
call delete(l:fn)
cexpr system('dmd -cov -unittest -main -run ' . expand('%'))
if filereadable(l:fn)
normal gg
execute '13vsplit' l:fn
normal gg
set scrollbind
normal ^Wl
set scrollbind
endif
endfunction
(note the ^W is a an actual CTRL-W, inserted with CTRL-V, CTRL-W)
autocmd FileType d nnoremap <f8> :call DTest()<cr>
