Status
Ubuntu 14.04

C/C++/Objective-C/Objective-C++ source for deoplete.nvim

Asynchronous C/C++/Objective-C/Objective-C++ completion for Neovim.
Using,

Shougo/deoplete.nvim

Dark powered asynchronous completion framework for neovim.
Fastetst, Fully asynchronous, Nonblocking user interface, Customizable source for each languages, and more.
The Nextgen word completion.

zchee/libclang-python3

Clang compiler bindings for python.
but llvm official bindings are Python2 only. It was ported to Python3.
Original author is @Anteru. I was fork it, and follow the latest of llvm clang.

https://github.com/neovim/neovim
https://github.com/neovim/python-client

https://github.com/Shougo/deoplete.nvim

http://llvm.org
https://github.com/apple/swift-clang

See Neovim wiki.

• Installing Neovim
• Following HEAD
• Building

Neovim remonte client for python.
See https://github.com/neovim/python-client

pip2 install --upgrade neovim
pip3 install --upgrade neovim

for linux, e.g. apt family,

apt-get install clang

for OS X, Homebrew way

brew install llvm --with-clang

but not tested. recommend is build from source.
See http://clang.llvm.org/get_started.html
or try build-llvm script. Need cmake, ninja or Xcode

Build llvm for OS X

" dein.vim (fastest)
call dein#add('Shougo/deoplete.nvim')
call dein#add('zchee/deoplete-clang')
" NeoBundle
NeoBundle 'Shougo/deoplete.nvim'
NeoBundle 'zchee/deoplete-clang'
" vim-plug
Plug 'Shougo/deoplete.nvim'
Plug 'zchee/deoplete-clang'

libclang shared object (dynamic library) file path.
In linux, libclang.so. In OS X, libclang.dylib.

Find commands,

# In linux
(sudo) find / -name libclang.so
# In OS X
mdfind -name libclang.dylib

clang built-in include header directory path.
Not clang-c. and not required clang version.
deoplete-clang always use latest clang version.

e.g.,

/opt/llvm/lib/clang
└── 3.9.0
    ├── include
    │   ├── Intrin.h
    │   ├── __clang_cuda_cmath.h
    │   ├── __clang_cuda_runtime_wrapper.h
    │   ├── __stddef_max_align_t.h
    │   ├── __wmmintrin_aes.h
    │   ├── __wmmintrin_pclmul.h
    │   ├── adxintrin.h
    │   ├── altivec.h
    │   ├── ammintrin.h
    │   ├── arm_acle.h
    │   ├── arm_neon.h
    .
    .
    .
    │   ├── stdalign.h
    │   ├── stdarg.h
    │   ├── stdatomic.h
    │   ├── stdbool.h
    │   ├── stddef.h
    │   ├── stdint.h
    .
    .
    .
    │   ├── xsavecintrin.h
    │   ├── xsaveintrin.h
    │   ├── xsaveoptintrin.h
    │   ├── xsavesintrin.h
    │   └── xtestintrin.h
    ├── lib
    │   └── darwin
    └── vtables_blacklist.txt

Each C family language standard version.
By default, use clang supported latest version.

C(XX)FLAGS for generate completion word.
Setting value other than default. Not needs -x c or etc.

If you want to know default clang build flags, try

# C
echo | clang -v -E -x c -
# C++
echo | clang -v -E -x c++ -
# Objective-C
echo | clang -v -E -x objective-c -
# Objective-C++
echo | clang -v -E -x objective-c++ -

e.g. In OS X,

let g:deoplete#sources#clang#flags = [
      \ "-cc1",
      \ "-triple", "x86_64-apple-macosx10.11.0",
      \ "-isysroot", "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk",
      .
      .
      .
      \ "-fmax-type-align=16",
      \ ]

libclang completion result sort algorism. Available value are priority or alphabetical.

By defalut(''), use deoplete.nvim sort algorism.
priority, Sort by libclang determine priority.
alphabetical, Sort by alphabetical order.

Support Clang JSON Compilation Database Format Specification.
See http://clang.llvm.org/docs/JSONCompilationDatabase.html.

Setting value are must be exists compile_commands.json directory.
This setting is optional.

If set it, use instead of g:deoplete#sources#clang#flags.
but, Currently parse compile_commands.json will take time.
Please set only if you really need support compilation database.

I'm planning more parse speed rewrite in Go.
Just moments.