Highly opinionated setup of plugins to start programming in Elixir in minutes.
Aim of the project is to give reasonable preset of defaults for Elixir-based development to avoid laborious task of finding and tuning of plugins/themes.
I’m a sucker for feedback. What do you think of this plugin after using it? Tell me! I have when things do nto work 'out-of-box' and eager to fix it!
Please take 1 minute and subscribe to mailing list to receive updates about the project.
You can contact me on twitter and by email gasparch at gmail dot com.
- Navigation
- Jump to module/function definitions
- Module/function/callback list window for navigating in single file
- Fuzzy search by function/module name in file
- Fuzzy filename search in project
- Navigation to Elixir/Erlang source code
- Jump between source and ExUnit test files automatically
- Editing
- Automatic folding of functions and tests
- Line comment/uncomment shortcuts
- Autocompletion of module/function names
- Autodetection of spacing format in your project (tab/spaces)
- Removal of trailing spaces
- Reformatting code (hashes, assignments, etc)
- Compile and testing
- Compile project from and jump to errors/warnings
- Run ExUnit tests and jump to errors
- Run ExUnit tests on source save and just to errors
- Tracing
- Run trace on selected ExUnit test or text selection
- Quickly navigate in trace file
- Profiling
- Syntax highlight for
eprofoutput - On-fly sorting of profiler results
- Other
- Colorschemes for Elixir programming
- Git integration directly from Vim
- Viewing of Module/function documentation
- Restore buffer position on load
- Clutter free vim-airline settings
See cheat sheet for quick overview of functionality and shortcuts offered. Read below for detailed usage instructions.
Finding, installing and tuning Vim plugins can be quite frustating and time consuming task. Especially making sure they do not conflict with each other and that they use consistent shortcuts.
Also it is easy to miss some useful ones in a wast variety of Vim plugins. Vim-Ide-Elixir offers curated set of plugins, which are tuned to seamlessly work together. Also some new pluging/settings provided for more comfortable work.
Plugin updates also come in (tested) bundles, which assures that changes in one plugin will not break others.
Right now only pathogen installation is supported. Manual and Vundle methods are not supported. Following command with download plugin and all extras it uses.
cd ~/.vim/bundle
git clone https://github.com/gasparch/vim-ide-elixir.git vim-ide-elixir
cd ~/.vim/bundle/vim-ide-elixir
./install.shFollow instructions of install script to complete install.
Manually install
Update your ~/.vimrc to contain following line instead of just pathogen#infect.
execute pathogen#infect("bundle/{}", "bundle/vim-ide-elixir/bundle/{}")Also in the very end of the file add
call vimide#init()In order to properly work this plugin requires number of additional programs installed.
For now you will need Exuberant Ctags in order to get function search & tagbar working. Version 5.5 or higher is required.
Ubuntu installation
sudo apt-get install -y exuberant-ctagsIn order to be able to just to Elixir/Erlang core libraries sources, you need them checked out from github. Run provided script to automatically check out matching Erlang/OTP and Elixir versions.
./get_otp_elixir_sources.shcd ~/.vim/bundle/vim-ide-elixir
./update.shBy default Vim-Elixir-IDE is setup to check once a day updates from production branch.
You can control update check period by changing g:vimide_update_check_period time in seconds.
E.g. for a once-a-week check:
let g:vimide_update_check_period = 7*24*60*60Also you can control which update channel it will be checking. There are 3 possible channels available:
productionwill be released once in 6-8 weeks, most stable version.betawill be released every 1-3 weeks, some things may break.devfollows master branch of repository, fetches updates as soon as they available. Things may break more often.
Set update channel by setting in your .vimrc
let g:vimide_update_channel = 'beta'Vim-Elixir-IDE tries to smart guess your tabulation settings and set it for the file using vim-sleuth.
Tagbar most of the time shows correct arity on functions and does not report multiple function clauses. GenServer callbacks moved to separate group.
F4will toggle Tagbar window visibility.
Compiler and ExUnit integration provided with vim-elixir-exunit module, which
is designed to work with vim-elixir-ide. All commands can be executed in any
subdirectory of project, it will find closest mix.exs in file hierarchy.
Following commands and shortcuts are available:
:makewill invokemix compileand show only errors in quickfix list. Normal:cl:copen:cnext:cprevcommands are available, but use of[eand]eis recommended.:cwis redefined to show quickfix window always at bottom, even if split exists.:MixCompilewill compile files (mix compile) and show errors and warnings. All messages are loaded in quickfix.:MixCompile!will recompile all project (mix compile --force) and show errors and warnings. All messages are loaded in quickfix.<Leader>xcand<Leader>x!invoke:MixCompileand:MixCompile!respectively[eand]eprovide smart navigation between errors/warnings in quickfix, also trying to jump to correct column name (e.g. identificator if warning is 'variable foo is not used').
All ExUnit commands suppress warning messages in quickfix window. If you want to check warnings in project - use compile commands above. ExUnit output is cluttered by itself, so no need to add more information with warnings.
I recommend Vim8.x + XTerm as you can have much more with it - see below.
Functionality for Vim version 7.x:
ExUnitQfRunAllor<Leader>xaruns ExUnit tests on whole project (mix test) and shows output in quickfix windowExUnitQfRunFileor<Leader>xfruns ExUnit tests on current file (mix test path/to/file) and shows output in quickfix windowExUnitQfRunLineor<Leader>xlruns ExUnit tests on current line of current file, effectively running just one test. (mix test path/to/file.exs:123) and shows output in quickfix windowExUnitQfRunRerunor<Leader>xxrepeats last executed command (ExUnitQfRunAll/File/Line)
You can navigate with [e and ]e between errors. Both test name and exact
failed assert lines are available in quickfix list. Latter is more useful most of the time.
Use :copen or :cw to check quickfix window, because most relevant ExUnit
output is available there as well, g.e. assert failure messages, crash messages
and etc.
Some less relevant ExUnit output (like GenServer crash logs and etc) are stripped to preserve space in quickfix window.
Functionality for Vim version 8.x:
Vim 8 brings asynchronous jobs and allows to build much more real IDE-like experience.
This mode allows you to start XTerm (or any other terminal emulator) next to your Vim/GVim instance and have all output of ExUnit shown there, while also having possiblity to jump over errors using quickfix. This also allows you to close/reopen Vim/GVim without closing XTerm and still have output in it. Basically you position it once on your screen and then you are free to run open and close Vim as much times as you want.
Also this mode automatically re-runs your tests on any Elixir files saved in the project, removing hassle of switching and running them by hand.
Test run status is shown in status line, so you don't need to check it manually.
To check which test is executing now, especially if you just re-run it, see XTerm window title - it shows text like 'ExUnit test/foo_test.esx'.
If you combine that with ex_unit_notifier it becomes very easy to see if your tests fail or pass.
Available commands:
ExUnitWatchAllor<Leader>waruns ExUnit tests on whole project (mix test) and shows output in xterm + quickfix windowExUnitWatchFileor<Leader>wfruns ExUnit tests on current file (mix test path/to/file) and shows output xterm + in quickfix windowExUnitWatchLineor<Leader>wlruns ExUnit tests on current line of current file, effectively running just one test. (mix test path/to/file.exs:123) and shows output in xterm + quickfix windowExUnitWatchRerunor<Leader>wwruns again last executed command (ExUnitWatchAll/File/Line). Most probably you do not need to run it manually, as it is executed on each save of Elixir file in current project.ExUnitWatchStopor<Leader>wsor<Leader>wc(both stop/cancel mnemonics) stops automatic execution of tests on save.
Use [e and ]e to navigate test errors.
Note
All mix test commands executed with --seed 0 parameter which forces
execution from top to down of test file. If you want randomized execution
sequence to check hidden errors in tests - you will need to run tests
manually.
Erlang runtime has amazing tools to understand what happens in code using trace and profiling. Unfortumately they have just command line interface and sometimes output is hard to understand. Vim-Elixir-IDE aims to boost developer efficiency while using this tools.
You can run trace on arbitrary piece of code or existing ExUnit test case. I would recommend running it on ExUnit test, which assures that all aliases, variables are resolved. If you run trace on code selection it should be self-sufficient (it will be copied to separate .exs file).
So, once again, run ExUnit tests under tracing, not the selection :)
Tracing support removes some number of redundant messages appearing in trace log file and tries to make output more readable to human eyes and for inspection.
Also navigating around trace may be difficult, as there is so much information present, so navigation shortcuts are provided for that.
Available commands:
ErlTraceTestor<Leader>teruns ExUnit test under cursor with tracing enabled and shows resulting trace in separate window.ErlTraceSelectionor<Leader>tyruns selected test with tracing enabled and shows resulting trace in separate window.
In tracing window there are shortcuts available:
<Enter>opens file with module/function under cursor and switches windowpopens file with module/function under cursor and stays in trace window%jumps to matching call/return lines;,,jumps back/forward to same function call(,)jumps back/forward to next function call/return (skips messages){,}jumps back/forward over repeated function callsF3opens arguments fold; also when cursor is on function call/ret line
Includes initial support for viewing profiler files and navigating around them.
- Files with extension
.eprofare recognized as eprof profiler output - Erlang module names translated to Elixir module names convention
- Supports re-sorting file with shortcuts
See more on vim-elixir-profiler page.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent