YouCompleteMe - A code-completion engine for Vim

http://valloric.github.io/YouCompleteMe/

by albertzeyer • 13 years ago

173 74 13 years ago

valloric.github.io

hawkharris• 13 years ago

Great name

RVijay007• 13 years ago

Love the name!

zerooneinfinity• 13 years ago

Haha, yea it's pretty great.

Ironballs• 13 years ago

What colour scheme is he using?

swah• 13 years ago

Vividchalk or vibrantink IIRC.

mynegation• 13 years ago

Most probably author's custom scheme: https://github.com/Valloric/vim-valloric-colorscheme/blob/ma...

terhechte• 13 years ago

Sadly, it is still not working too well with Objective-C, which is currently my main language (1). Luckily, unofficial VIM plugins for XCode like XVim (2) or VIEmu (3) are getting better and better, so at least I can use vim bindings for objective-c now, too. Nevertheless, good clang support in Vim would still be great, so that I could tap into the huge amount of vim plugins during objc development.

[1] https://github.com/Valloric/YouCompleteMe/issues/84

[2] https://github.com/JugglerShu/XVim

[3] http://www.viemu.com/

rjzzleep2• 13 years ago

you might want to consider clang_complete with ultisnips. it generates tab triggers for objective-c methods.

i tried to add that functionality to youcompleteme, but the main problem with it is that youcompleteme tries to be very generic in completions, therefore there is no real way of knowing what kind of methods you get back from your completion backend. you could hack it to do some regex parsing on method names, but i'd really suggest that if objective-c is your main target go for clangcomplete+ultisnips.

https://github.com/Rip-Rip/clang_complete

https://github.com/SirVer/ultisnips

skue3• 13 years ago

Thanks, that's good to know. I have been using XVim for a while now. It can be quirky, but it's amazing what JugglerShu has been able to pull off.

Have you used both Xvim and ViEmu? How does ViEmu compare?

syncontrol5• 13 years ago

Better Objective-C triggering support (the issue you linked to) is coming soon.

swombat5• 13 years ago

How the hell is that a "super-quick installation" for Mac OS?

Can anyone figure out an actually quick way to install it with Pathogen?

PS: the plugin looks great - I'm just bitching about the installation docs because I'm in the middle of 10 different things at the moment and don't have the time to engage in a potential yak shaving expedition...

fooqux• 13 years ago

But you had plenty of time to bitch about it? ;-)

Edit: It suddenly occurred to me just how reliant everyone now is on package managers. Once upon a time, I would think installing a dependency or two before compiling a new toy commonplace, if not expected. Nowadays... it's yak shaving.

Not that I'm no less guilty of this. I've even downloaded AUR helper tools because I'm too lazy to even wget a package and do a makepkg any longer.

Timothee• 13 years ago

The yak shaving part is not the steps described, but the steps not described that will end up being required.

Where you follow the given steps carefully and one fails because whichever version of something is not the right one, then you end up in a weird state where you have a hard time going back to how your setup was before, and you have to google things like "Compiler error: missing dependency foo.h" even though you can see that foo.h is right there. You then finally fixed the foo.h error to discover that you need to update Ruby for whatever reason, but the system doesn't pick up the version you installed with Homebrew anymore but is using the old default one, you then start updating Homebrew. Etc., etc. until you don't even know what you were trying to achieve in the first place and you are now super irritable.

(yes, I had a recent experience with that kind of yak shaving :))

nilkn• 13 years ago

I'm pretty sure you can install it with Pathogen as normal. There are just two other points: (1) make sure you have the latest version of vim; (2) you just need to run an install script to finalize it. The script is in the bundle folder you create when cloning the git repo.

bowmessage• 13 years ago

You better thank your lucky stars you aren't installing on Windows! Took me many days of tinkering to get this working correctly with clang support, and its still not all the way there yet.

Regardless, amazing vim plugin!

skue3• 13 years ago

Ditto. Here was my "super-quick installation" experience on OS X:

1. Read through the full page of installation instructions.

2. Update to latest version of MacVim.

3. Go research Vundle because up until now, I've been happily using Pathogen. Install Vundle.

4. Update vimrc file for Vundle, add YCM.

5. Launch vim, note error saying YCM needs installation.

6. Run :BundleInstall, which tells me I should compile and impolitely adding "Read the docs!" (Which docs? The GitHub docs, which tell me I should only need to recompile in rare cases? Or the bundle's vim docs, which didn't exist on my system prior to running this command?)

7. Back to terminal, launch ./install.sh --clang-completer in the YCM directory.

8. Go fix breakfast, return. Compilation eventually completes, no errors.

9. Launch vim, which immediately crashes with error: Vim: Caught deadly signal ABRT

10. Give up and delete any trace of YCM.

In a perfect world maybe I would have an extra hour or two to debug this, run through some regressions but right now I don't. Sounds like a nice plugin, maybe I'll try again in the future.

kybernetyk• 13 years ago

9. Launch vim, which immediately crashes with error: Vim: Caught deadly signal ABRT

Had the same problem. There's something about this in the FAQ: One should delete and re-install python if it was installed through brew. (Doing this and recompiling YCM worked for me.)

The other gripe was: "Add YCM to vundle" ... without any mention of what exactly to add.

Then the thing started complaining about the missing .extra_ycm_something.py ...

Spiritus• 13 years ago

1. brew install vim cmake

2. git clone https://github.com/Valloric/YouCompleteMe.git ~/.vim/bundle/YouCompleteMe

3. cd ~/.vim/bundle/YouCompleteMe

4. ./install.sh --clang-completer

Jgrubb2• 13 years ago

I just had to rename vim in /usr/bin so it'd pick up the /usr/local/bin homebrewed version instead, but yeah, this.

skue3• 13 years ago

I already have the latest version of cmake installed via homebrew.

The problem appeared to be that YCM's install.sh script goes out of its way to determine the active version of python and link against its libraries[1].

For anyone with python installed via homebrew, that means it links to 2.7.3. Unfortunately, both MacVim and the homebrew version of vim link against the system python (2.7.2). As a result, loading YCM triggers an error resolving urandom and crashes vim.

[1] https://github.com/Valloric/YouCompleteMe/blob/master/instal...

jasonkostempski• 13 years ago

Hate the name. I can't help picturing Tom Cruise and Renee Zellweger's crying faces.

AYBABTME• 13 years ago

I found that other solutions for Vim completion tend tomake Vim slowish when they index a lot of data, for medium~large codebases.

How does your pluggin scale?

rjzzleep2• 13 years ago

it's "kinda" async. and it very much depends on the language of your choice.

cks• 13 years ago

I highly recommend this plugin! I find it really snappy on my projects.

I haven't had the opportunity to try it on any gigantic projects, but I have found configuration files for YCM in the Chromium source tree which suggests that it scales nicely (assuming it's usable on the Chromium tree).

McUsr• 13 years ago

I haven't tried it on anything but rather small projects in C: 10-15 source files/modules, but I prefer vim and ycm to XCode for coding. As a matter of fact, all other code completion thingy's I use seem a bit crappy in comparision, with the excempt of bbautocomplete.

Time to install the new beta of vim, and check out ycm! :)

meunier• 13 years ago

I've been using this for Python development for a few months now and it's by far the best completion solution I've found in vim and I've tried most. Jedi by itself is great but the actual interface to it was always lacking and YCM's fuzzy matching makes it breeze.

jaroslavj2• 13 years ago

If you are a ruby or javascript developer, just use Supertab, because you will waste more time installing it than getting any substantial benefits over default vim completion.

VeejayRampay• 13 years ago

How do you achieve completion in Ruby with vim? I'd be interested cause the only things doing completion I've seen for vim so far are always extremely limited (completion on stuff you have in your buffer).

jaroslavj2• 13 years ago

  autocmd FileType ruby,eruby set omnifunc=rubycomplete#Complete
  autocmd FileType ruby,eruby let g:rubycomplete_buffer_loading = 1
  autocmd FileType ruby,eruby let g:rubycomplete_rails = 1
  autocmd FileType ruby,eruby let g:rubycomplete_classes_in_global = 1

and for Supertab

  let g:SuperTabDefaultCompletionType = "<c-x><c-o>"

  autocmd FileType ruby let g:SuperTabDefaultCompletionType = "context"

That way you will get omni completion with supertab.

I compiled this from http://www.cuberick.com/2008/10/ruby-autocomplete-in-vim.htm... and some SO answers.

SteveDeFacto• 13 years ago

Works pretty nice but is there anyway I can get it to display function parameters as I type?

tmister• 13 years ago

I could not install it in my work machine as the OS is windows. As a replacement I use neocomplete.vim[1]. It is very fast, responsive, has fuzzy auto-complete. But it requires vim version greater than 7.3.885 and vim compiled with lua bindings. Still it is small annoyance compared to YCM installation procedure.

[1]https://github.com/Shougo/neocomplete.vim

hyperbling• 13 years ago

neocomplete is also my preferred autocomplete plugin. it integrates very well with all of shougo's other plugins, and it works on windows. YCM officially does not support windows and it's not uncommon for it to be broken for a week or two.

djeikyb• 13 years ago

I use this with Eclim to enhance java writing. The Vrapper plugin for Eclipse is getting very good, but sometimes it's nice to work directly in vim.

arianvanp• 13 years ago

I've never gotten eclim to fully work before. I don't do a lot of java nowadays but I just got back into a project where parts of the codebase are in java. So I might try it once again. What has your experience been so far?

no_gravity• 13 years ago

This takes "super-quick installation" to a new level...

* compile Vim from source

* install and understand Vundle

* depending on some library issues maybe recompile ycm

* Install development tools and CMake

* Make sure you have Python headers installed

How is the usual "unzip it to ~/.vim" installation called these days?

jlgreco• 13 years ago

YouCompleteMe has an unusually complex installation. These days most vim plugins allow you to simply:

  cd ~/.vim/bundle
  git clone ....

and you are good to go. YouCompleteMe isn't this nice, and suffers for it I think. The "unzip it to ~/.vim" is usually called "a real pain in the ass to keep up to date and disabled or uninstall."

umarrana• 13 years ago

what!! no dude

city41• 13 years ago

YouCompleteMe is included with subvim[0], which I have found to be a great flavor of vim. I just forked subvim and tweaked it how I liked from there. Which gets around the painful install of YCM.

[0] https://github.com/fatih/subvim

syncontrol5• 13 years ago

I'm the main YCM developer.

Most complaints here are about the installation procedure. I tried to make it as easy as possible, but the root of the problem is that you _have to_ compile the ycm_core module so that completion is fast. There's no going around it. The compiled module is the main reason why YCM is so fast when you get it configured.

Other than complicated/rare configurations, installing YCM is IMO not that difficult. The _only_ difference between installing any "average" plugin with Vundle/Pathogen and YCM is running ./install.sh from the YCM directory after you pull it in. That's it. The script will download dependencies for you (libclang), run cmake, make and all the other tools so that everything is installed correctly. It will clean up after itself too. It's pretty hand-holdy so it will tell you if you need to install something (like CMake).

The docs are pretty extensive so you should not get stuck anywhere even if you encounter problems.

I'm happy to hear suggestions on how to further improve the installation procedure. As always, pull requests are welcome too.

YCM too goes out of its way to inform you if you missed something you needed to do, like create a ycm_extra_conf.py file with your build flags (if you want the C-family semantic completion to work) because YCM can't conjure out of the air all the include paths and such needed to compile your project. There's no going around this, a real compiler is used to build the AST so we need the compiler flags.

All in all, if the installation procedure is the main complaint, I'm happy (not really, but you get the point) because that means that actually _using_ the plugin is a good experience (I hope). The installation you go through once and forget about; you use the plugin every day.

Here are excerpts from the FAQ about some of the other things people have brought up:

# Why isn't YCM just written in plain VimScript, FFS?

Because of the identifier completion engine and subsequence-based filtering. Let's say you have many dozens of files open in a single Vim instance (I often do); the identifier-based engine then needs to store thousands (if not tens of thousands) of identifiers in its internal data-structures. When the user types, YCM needs to perform subsequence-based filtering on all of those identifiers (every single one!) in less than 10 milliseconds.

I'm sorry, but that level of performance is just plain impossible to achieve with VimScript. I've tried, and the language is just too slow. No, you can't get acceptable performance even if you limit yourself to just the identifiers in the current file and simple prefix-based fitering.

# Why does YCM demand such a recent version of Vim?

During YCM's development several show-stopper bugs were encountered in Vim. Those needed to be fixed upstream (and were). A few months after those bugs were fixed, Vim trunk landed the pyeval() function which improved YCM performance even more since less time was spent serializing and deserializing data between Vim and the embedded Python interpreter. A few critical bugfixes for pyeval() landed in Vim 7.3.584 (and a few commits before that).

muyuu• 13 years ago

Just don't advertise it as "super-quick installation", that's quite simply taking the piss.

syncontrol5• 13 years ago

"Super-quick" was intended to be a bit tongue-in-cheek, although compared to the Full Installation Guide (it's in the docs), trust me, the "super-quick" installation really is super-quick.

lynndylanhurley3• 13 years ago

Are you familiar with NeoBundle? It's mostly a drop-in replacement for Vundle, but it has support for post-installation hooks. This could potentially make it a one-step install (assuming NeoBundle was already installed).

For example, here is the install snippet from vimproc, which also requires compiling: https://gist.github.com/lynndylanhurley/5951180.

https://github.com/Shougo/neobundle.vim

Legion• 13 years ago

I use NeoBundle to run the YouCompleteMe module build upon installation. Works great. Especially since the build is triggered by a single simple command. (People really complain about that being hard?)

klibertp• 13 years ago

you _have to_ compile the ycm_core

Couldn't you ship a several already compiled binaries for major OSes? What do you do during compilation (and do you have to do this during compilation instead of on runtime) that makes it impossible?

I'm not using VIM anymore, so the question is just at out of curiosity :)

swombat5• 13 years ago

Indeed, and if it's about saving on duplicating libraries, that's less important to me than saving on installation time. I don't care if it loads up 20 megs of duplicated libraries because you had to hard-link them in. I have loads of RAM, very little time to set things up.

malandrew• 13 years ago

Anyone know of a tool or system out there that automates the creation of binaries for several systems and then adds them to a key-value file with arch : binary_file_name pairs that can be consumed by an install script or curl pipe to shell install.

swombat5• 13 years ago

Except, I don't. I haven't installed it because I have a feeling this will be way more hassle than it looks (a feeling validated by several comments in this thread) and I don't have the time to do that kind of stuff.

syncontrol5• 13 years ago

That's perfectly fine. To each his own! :)

StavrosK• 13 years ago

To be honest, I found it completely reasonable, and as quick as a compilation step could be. I didn't install it yet due to the new Vim version dependency, but I will as soon as I get the new Vim version.

fixxer2• 13 years ago

Looks like an awesome project, really.

I would love to use it.

Please let us know when installation is less of a kluge.

I followed your full install directions to a T and I'm getting "YouCompleteMe unavailable: ycm_core too old, PLEASE RECOMPILE ycm_core" on Vim start-up. This doesn't appear to be a Python version issue (everything is showing 2.7) and I downloaded the Clang binaries as directed.

_b• 13 years ago

YCM developer - thank you. I spent about 45 hours a week actively coding C++ using YCM. It is wonderful. Your work is appreciated.

mmgutz• 13 years ago

Could not get it to install on Debian. Depends on newer libs than found on conservative Wheezy. Mac was easier but still somewhat arduous. It's necessary complex to install because he's using C++ to get the speed boost. VimScript was too slow.

Once you get it working. It's amazing with Go :)

anonymous• 13 years ago

Just one question. Where do I give money?

randy909• 13 years ago

This is an absolutely fantastic plugin. The minor installation pain is paid back easily after a few hours of use. Fast, fuzzy matching autocomplete people!!

freshhawk• 13 years ago

So I cloned the repo, ran install.sh and got prompted to run the git submodule checkout for jedi the first time I opened a python file.

Seems like a pretty excellent installation process (on linux anyway) despite the "hackers" complaining in other comment threads.

But the important part is that I'm really impressed by the completion ability, I've only played with it a bit but I'm leaving the rest of my plugins for that turned off and staying with ycm for now. Excellent plugin, thank you!

syncontrol5• 13 years ago

So I cloned the repo, ran install.sh and got prompted to run the git submodule checkout for jedi the first time I opened a python file.

Yep, I added that check to better support the use case of people checking out the repo themselves instead of using Vundle (which will checkout the git submodules for you automatically).

I'm happy you enjoy the plugin!

lynndylanhurley3• 13 years ago

I agree. I've used both AutoComplPop and NeoComplCache extensively (1-2 years each) and YCM is superior to both in terms of speed. NeoComplCache has great completion ability, but it lacks fuzzy matching, and the configuration was a total rat's nest. I've been using YCM for like 2 months and I haven't looked back.

ras_hatak• 13 years ago

So, after building vim from source, python from source, and cmake from source (damn old repos...), I'm finally getting stuff to build. and I hit this: Linking CXX static library libBoostParts.a [ 89%] Built target BoostParts Scanning dependencies of target ycm_core [ 90%] [ 92%] Building CXX object ycm/CMakeFiles/ycm_core.dir/LetterNode.cpp.o Building CXX object ycm/CMakeFiles/ycm_core.dir/Utils.cpp.o [ 93%] Building CXX object ycm/CMakeFiles/ycm_core.dir/ycm_core.cpp.o [ 93%] Building CXX object ycm/CMakeFiles/ycm_core.dir/Candidate.cpp.o [ 94%] Building CXX object ycm/CMakeFiles/ycm_core.dir/PythonSupport.cpp.o cc1plus: warnings being treated as errors /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/BoostParts/boost/python/converter/pyobject_type.hpp: In static member function ‘static bool boost::python::converter::pyobject_type<Object, pytype>::check(PyObject) [with Object = boost::python::list, PyTypeObject pytype = (& PyList_Type)]’: /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/BoostParts/boost/python/converter/obj_mgr_arg_from_python.hpp:101: instantiated from ‘bool boost::python::converter::detail::object_manager_ref_check(const T&) [with T = boost::python::list]’ /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/BoostParts/boost/python/converter/obj_mgr_arg_from_python.hpp:109: instantiated from ‘bool boost::python::converter::object_manager_ref_arg_from_python<Ref>::convertible() const [with Ref = const boost::python::list&]’ /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/BoostParts/boost/preprocessor/iteration/detail/local.hpp:34: instantiated from ‘PyObject* boost::python::detail::caller_arity<3u>::impl<F, Policies, Sig>::operator()(PyObject, PyObject) [with F = boost::python::list ()(const boost::python::list&, const std::string&, const std::string&), Policies = boost::python::default_call_policies, Sig = boost::mpl::vector4<boost::python::list, const boost::python::list&, const std::string&, const std::string&>]’ /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/BoostParts/boost/python/object/py_function.hpp:38: instantiated from ‘PyObject boost::python::objects::caller_py_function_impl<Caller>::operator()(PyObject, PyObject) [with Caller = boost::python::detail::caller<boost::python::list ()(const boost::python::list&, const std::string&, const std::string&), boost::python::default_call_policies, boost::mpl::vector4<boost::python::list, const boost::python::list&, const std::string&, const std::string&> >]’ /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/ycm/ycm_core.cpp:186: instantiated from here /home/zdrillings/.vim/bundle/YouCompleteMe/cpp/BoostParts/boost/python/converter/pyobject_type.hpp:21: warning: dereferencing type-punned pointer will break strict-aliasing rules make[3]: [ycm/CMakeFiles/ycm_core.dir/ycm_core.cpp.o] Error 1 make[3]: * Waiting for unfinished jobs.... make[2]: * [ycm/CMakeFiles/ycm_core.dir/all] Error 2 make[1]: * [ycm/CMakeFiles/ycm_core.dir/rule] Error 2 make: * [ycm_core] Error 2

Now, I went in and removed the -Werror flag from the makefiles and that got around it, but I get a ton of errors when i start vim, doing that:

Error detected while processing function youcompleteme#Enable: line 11: Traceback (most recent call last): Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 11: File "<string>", line 1, in ? Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 11: File "/home/zdrillings/.vim/bundle/YouCompleteMe/autoload/../python/ycm/base.py", line 28 Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 11: except ImportError as e: Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 11: ^ Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 11: SyntaxError: invalid syntax Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 13: Traceback (most recent call last): Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 13: File "<string>", line 0, in ? Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 13: NameError: name 'base' is not defined Press ENTER or type command to continue Error detected while processing function youcompleteme#Enable: line 13: E858: Eval did not return a valid python object Press ENTER or type command to continue YouCompleteMe unavailable: ycm_core too old, PLEASE RECOMPILE ycm_core

I'm guessing it's related. Does anyone have any advice on fixing some of this, so I can try this plugin? it sounds fantastic.

thanks in advance.

SmileyKeith• 13 years ago

Can't wait until this is resolved. https://github.com/Valloric/YouCompleteMe/issues/84

steven5158• 13 years ago

Had latest vim installed from source already on Mac with +python support.

I already use Pathogen so I didn't use the suggested Vundle.

Just placed YouCompleteMe in ~/.vim/bundle/

ran the ./install.sh in the YouCompleteMe bundle directory and it worked.

Thank you guys, this seems awesome so far! :)

general_failure• 13 years ago

I think this thread is a perfect example of why cloud apps are all the rage these days. The installation hassle is a big turn off.

davidbanham• 13 years ago

I've been using YCM for a few months now and I love it. It's a big part of my coding experience now. It's a bit of a pain to get a supported vim version up and running, but completely worth it.

binbrain2• 13 years ago

Easy to install actually. Worked pretty much out of the box for me. Does anyone know how to change the autocompletion popup background color? A black popup window on black background make things a little harder to read.

binbrain2• 13 years ago

Answered, Pmenu color

lsiebert• 13 years ago

I love YCM.

My only issue with installation was that I would prefer to actually upgrade my systems clang, instead of just installing it in my home dir, and there aren't step by step instructions for doing so.

Once it is installed it is great for C lang stuff and python. It makes me wish other languages had equally good support you could integrate. Perl omni complete is super slow for example. But I know that isn't you.

YouCompleteMe - A code-completion engine for Vim

Related Stories