This plugin activates itself for files that belong to some ROS package.

Sets &makeprg to catkin_make, catkin build, or rosmake <package-name> so that the package, to which the file being edited belongs, could be built with :make.

• :A to alternate between different kinds of C/C++ files (.cpp, .cc, .h, .hh, .hpp, .impl) in the current package
• :Roscd to cd to an arbitrary ROS package (with tab-completion)
• :Rosed/:TabRosed to open arbitrary files (with tab-completion of both package and filenames)

• syntax highlighting
• omni-completion for message types
• goto message definition with gd command

• syntax highlighting (as xml)
• syntax check (if Syntastic is available)
• omni-completion
  • package names
  • node names
  • substitution args
  • environment variables
  • paths with $(find ...) substitution
• goto file with gf command when the cursor is on a tag
  • with 'file' attribute
  • with an attribute that has a value matching $(find ... pattern

• syntax highlighting (as xml)
• goto file with gf command (when the cursor is on a tag with 'filename' attribute)

• syntax highlighting (as python)

vim-ros integrates with several other plugins out of the box. This section lists the plugins and explains suggested configuration.

YouCompleteMe is is a fast, as-you-type, fuzzy-search code completion engine for Vim.

vim-ros provides semantic completion for ROS filetypes via omni-complete functions. YouCompleteMe will automatically use them, however if you want the completion to be magically triggered as you type, you have to associate proper triggers with ROS filetypes in your .vimrc:

let g:ycm_semantic_triggers = {
\   'roslaunch' : ['="', '$(', '/'],
\   'rosmsg,rossrv,rosaction' : ['re!^', '/'],
\ }

It is recommended to instal vim-ros using vim-plug. The (somewhat dated) alternatives are Vundle or pathogen.

• g:ros_make [current|all] Controls which package to build
• g:ros_build_system [catkin|rosbuild|catkin-tools] Which build system to use
• g:ros_catkin_make_options Additional options for catkin_make (i.e '-j4 -DCMAKE_BUILD_TYPE=Debug' ...)

The plugin is written in Python and includes a shim to make interfacing with Vim as easy as it could possibly be. Therefore, extending the plugin does not require knowledge of the peculiarities of Vim Script. Contributions are welcome!

Inspired by the vim-rails plugin.

MIT License. Copyright (c) 2013-2015 Sergey Alexandrov.