sponsor Vim development Vim logo Vim Book Ad

UltiSnips : The ultimate snippet solution for python enabled Vim.

 script karma  Rating 680/196, Downloaded by 5194    Comments, bugs, improvements  Vim wiki

created by
Holger Rapp
script type
UltiSnips is the Ultimate solution for snippets under Vim.

install details
The recommended way of getting ultisnips is to track SirVer/ultisnips on
github. The master branch is always stable.

Using Pathogen:

If you are a pathogen user, you can track the official mirror of UltiSnips on
github: >

   $ cd ~/.vim/
   $ git submodule add git://github.com/SirVer/ultisnips.git bundle/ultisnips

If you also want the default snippets, also track >

   $ git submodule add https://github.com/honza/vim-snippets.git

See the pathogen documentation for more details on how to update a bundle.

Using a downloaded packet:

Download the packet and unpack into a directory of your choice. Then add this
directory to your Vim runtime path by adding this line to your vimrc file. >
   set runtimepath+=~/.vim/ultisnips_rep

UltiSnips also needs that Vim sources files from the ftdetect/ directory.
Unfortunately, Vim only allows this directory in the .vim directory. You
therefore have to symlink/copy the files: >
   mkdir -p ~/.vim/ftdetect/
   ln -s ~/.vim/ultisnips_rep/ftdetect/* ~/.vim/ftdetect/

Restart Vim and UltiSnips should work. To access the help, use >
   :helptags ~/.vim/ultisnips_rep/doc
   :help UltiSnips

UltiSnips comes without snippets. The default snippets can be found here:

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
UltiSnips-3.0.tar.gz 3.0 2014-03-22 7.3 Holger Rapp - Organisational changes: The project is now hosted on github. Snippets are
  now shipped separately - please track honza/vim-snippets.
- UltiSnips is now a drop in replacement for snipMate - it parses snipMate
  snippets and expands them emulating snipMates smaller feature set.
- Filetype tab completion for UltiSnipsEdit.
- UltiSnipsEdit now only edits private snippet files. Use UltiSnipsEdit! if
  you want to edit shipped files.
- New option 's' which strips trailing whitespace before jumping to next
- New option 'a' which converts non-ascii characters into ascii characters
  in transformations.
- New keyword in snippet files: priority defines which snippets should
  overwrite others. This deprecates the '!' option.
- Remove common whitespace of visual line selections before inserting in an
  indented tabstop.
- Support for overwriting the snippet directory name on a per buffer basis
  to support per project snippets. *UltiSnips-snippet-search-path*
- The keymaps for jumping in snippets are now only mapped when a snippet is
  active, allowing them to be used for something else otherwise.
- Expanding and jumping no longer overwrites the unnamed register.
- Integration with Valloric/YouCompleteMe and Shougo/neocomplete.vim.
- Other plugins can add sources for snippets to create snippets on the fly.
- Vim functions now indicates if it did any work.
- For python extensions: UltiSnips adds itself to the sys.path and can be
  easily imported if it is available. *UltiSnips-python-module-path*
- A new function giving programmatic access to the snippets currently
  available for expansion for other plugins integrating with UltiSnips.
- New or improved snippets (now in a different repo): all, bib, c, cpp, cs,
  d, django, eruby, go, haskell, html, html, htmljinja, java, javascript,
  js, ledger, ocaml, perl, php, puppet, python, ruby, scss, sh, tex, vim,
  xml, zsh.
UltiSnips-2.2.tar.gz 2.2 2012-09-01 7.0 Holger Rapp Smaller Bug fixes and improvements to shipped snippets.

- Support to silence Python-not-found warnings. *UltiSnips-python-warning*
- Matchit support for snippet files.
- Improvements to syntax file.
- Various smaller bug fixes.
- New command to manually add a filetype to the list for the current
  buffer. *:UltiSnipsAddFiletypes*
- New or improved snippets: all, snippets, haskell, bindzone, python, golang,
  json, html, coffee, coffee_jasmine, javascript_jasmine, ruby, php,
UltiSnips-2.1.tar.gz 2.1 2012-02-14 7.0 Holger Rapp This brings two small features related to ${VISUAL} which was introduce in 2.0: access to the content in python code via snip.v and transformations: ${VISUAL/foo/bar/g}. As expected, 2.0's new features introduced new bugs as, all known are fixed in 2.1.

- Python interpolation access to text from visual selection via snip.v.
- Support for transformations of ${VISUAL} texts.
- New or improved snippets: python, tex, texmath, ruby, rails, html, django
UltiSnips-2.0.tar.gz 2.0 2012-02-05 7.0 Holger Rapp Significant rewrite with new features and less bugs. It also has some minor backwards incompatible changes marked below.

- Backwards incompatible change: Support for normal mode editing. Snippets
  are no longer exited when leaving insert mode but only by leaving the
  text span of the snippets. This allows usage of normal mode commands and
  autoformatting. It also increases compatibility with other plugins.
- Backwards incompatible change: Changed glob patterns for snippets to
  behave more like Vim *UltiSnips-adding-snippets*
- Backwards incompatible change: Zero Tabstop is no longer removed in
  nested snippets
- Support for ${VISUAL:default text} placeholder. *UltiSnips-visual-placeholder*
- Improved handling of utf-8 characters in files and snippet definitions.
- Full support for :py3. UltiSnips now works with python >= 2.6 or >= 3.2.
- New or improved snippets: python, all
UltiSnips-1.6.tar.gz 1.6 2011-12-30 7.0 Holger Rapp Bug fix release. We also accept contributions on GitHub now (main development stays on launchpad though): https://github.com/SirVer/ultisnips/

- Significant speed improvements and a few bugs fixed.
- Better handling of non ASCII chars in snippets by assuming UTF-8 encoding
  when no other information is available.
- Contributions for UltiSnips are now also accepted on GitHub: https://github.com/SirVer/ultisnips/
- New or improved snippets: ruby, rails, xhtml
UltiSnips-1.5.tar.gz 1.5 2011-09-24 7.0 Holger Rapp This is mainly a bug-fix release. Very little user visible changes.

- Some critical bug fixes for new vim versions.
- New or improved snippets: tex, texmath, python, jinja2, go, puppet, xhtml
- Configuration of search path for snippets *UltiSnips-snippet-search-path*
- New parser implementation: A little faster, more flexible and less bugged.

UltiSnips-1.4.tar.gz 1.4 2011-07-17 7.0 Holger Rapp This release packs a bunch of new features and a lot of bug fixes. It also comes with new snippets and for the first time ever: windows support.

- New or improved snippets: php, html, djangohtml, mako, lua
- Snippets are now listed alphabetically by their trigger, no longer in
  order of appearance
- Snippet files are now automatically reloaded when they change.
- Support for other directory names for snippets beside
  "UltiSnips" *UltiSnips-snippet-search-path*
- Errors are now shown in a scratch window.
- Now fully supports Windows with python >= 2.6. UltiSnips should now work
  on all systems that Vim runs on.
- a syntax file was added for snippets files with nice highlighting.
- snippets definition files now have the filetype 'snippets'. It used to be
UltiSnips-1.3.tar.gz 1.3 2011-02-14 7.0 Holger Rapp UltiSnips is becoming a community project, the ChangeLog tells the story:

- Erlang snippets (g0rdin)
- Other VimScripts can now define and immediately expand anonymous snippets
  ( *UltiSnips_Anon* ) (Ryan Wooden)
- Other VimScripts can now define new snippets via a function
  ( *UltiSnips_AddSnippet* ) (Ryan Wooden)
- New Snippets for eruby and rails (Ches Martin).
- A new Option 't' has been added to snippets that avoid expanding tabstops.
  Be also more consistent with how indenting is handled. (Ryan Wooden)
- Added a ftplugin script for .snippets files. Syntax highlighting still
  missing. (Rupa Deadwyler)
- Added UltiSnipsReset and UltiSnipsEdit (Idea by JCEB)
UltiSnips-1.2.tar.gz 1.2 2010-08-24 7.0 Holger Rapp - many bugs were fixed
- smode mappings for printable characters are now removed before expanding a
  snippet. This is configurable. *UltiSnips-warning-smappings*
- all shipped snippets are now fully compatible with UltiSnips
- added support for global snippets which enhance python interpolation even
  more *UltiSnips-globals*
- added support for multi word and regular expression triggers. Very
  powerful in combination with python interpolation.
- Python interpolation became much more powerful *UltiSnips-python*
- added support for clearsnippets command *UltiSnips-clearing-snippets*
- added support for option w which is a little more strict than i.
- added support for listing of valid triggers. Defaults to <c-tab>.
- added support for option i (inword expansion)
- extends keyword is now supported on the first line of snippet files. This makes it easy to
       define special cases, for example cpp extends c: a cpp trigger is useless
       in c, but a c trigger is valuable for cpp.
- UltiSnips now adheres to expandtab and tabstop options of vim
UltiSnips-1.1.tar.gz 1.1 2009-07-21 7.0 Holger Rapp Made triggers configurable. You can also use the same trigger for expanding and tabbing. The TextMate configuration <tab> and <s-tab> is now possible.
Conditional Inserts can now be nested
Added support for b option. This only considers a snippet at the beginning of a line ( *UltiSnips-adding-snippets* )
Added support for ! option. This overwrites previously defined snippets with the same tab trigger ( *UltiSnips-adding-snippets* )
Support for dotted filetype syntax. Now snippets for more than one filetype can be active ( *UltiSnips-adding-snippets* )
Minor bug fixing.
UltiSnips-1.0.tar.gz 1.0 2009-07-16 7.0 Holger Rapp Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.
SourceForge.net Logo