IMPORTANT: This plugin now allow version based completion
Changelog
Provider Versions
Community Provider Versions
Terraform Module is supported(though there might be bugs)
Overview
Block Completions
(R) for Require , (O) for Optional and (B) for Block
Dependencies
- vim-terraform (For FileType) (Optional not require for completion)
- vim-syntastic (Only for Linter)
- neomake (Only for Linter, Neovim)
- Deoplete (Neovim only, for completion)
- Ctags & tagbar (Optional for Tag Sidebar)
Installation
Require +ruby or +ruby/dyn for vim & json gem for ruby as well
Snippets completion is done through <C-X><C-K>
NeoBundle
NeoBundle 'hashivim/vim-terraform' NeoBundle 'vim-syntastic/syntastic' NeoBundle 'juliosueiras/vim-terraform-completion'
Vim-Plug
Plug 'hashivim/vim-terraform' Plug 'vim-syntastic/syntastic' Plug 'juliosueiras/vim-terraform-completion'
Minimal Configuration
" Minimal Configuration set nocompatible syntax on filetype plugin indent on call plug#begin('~/.vim/plugged') " (Optinal) for Tag Sidebar " Plug 'majutsushi/tagbar' Plug 'hashivim/vim-terraform' Plug 'vim-syntastic/syntastic' Plug 'juliosueiras/vim-terraform-completion' call plug#end() " Syntastic Config set statusline+=%#warningmsg# set statusline+=%{SyntasticStatuslineFlag()} set statusline+=%* let g:syntastic_always_populate_loc_list = 1 let g:syntastic_auto_loc_list = 1 let g:syntastic_check_on_open = 1 let g:syntastic_check_on_wq = 0 " (Optional)Remove Info(Preview) window set completeopt-=preview " (Optional)Hide Info(Preview) window after completions autocmd CursorMovedI * if pumvisible() == 0|pclose|endif autocmd InsertLeave * if pumvisible() == 0|pclose|endif " (Optional) Enable terraform plan to be include in filter let g:syntastic_terraform_tffilter_plan = 1 " (Optional) Default: 0, enable(1)/disable(0) plugin's keymapping let g:terraform_completion_keys = 1 " (Optional) Default: 1, enable(1)/disable(0) terraform module registry completion let g:terraform_registry_module_completion = 0
Deoplete config
put this in your init.vim
let g:deoplete#omni_patterns = {} let g:deoplete#omni_patterns.terraform = '[^ *\t"{=$]\w*' let g:deoplete#enable_at_startup = 1 call deoplete#initialize()
NOTE: For newer version of deoplete if the above doesn't work
let g:deoplete#omni_patterns = {} call deoplete#custom#option('omni_patterns', { \ 'complete_method': 'omnifunc', \ 'terraform': '[^ *\t"{=$]\w*', \}) call deoplete#initialize()
Version config file
by default , all providers uses the latest version, but you can add a file call .tfcompleterc under working directory, and content can be this:
using the syatax of <provider>=<version>
Community Providers
By default no community providers is enable, to use one, first refer to COMMUNITY_PROVIDER_VERSIONS.md , then add a .tfcompleterc to your current working dir , for ex. to use Generic REST Api Provider, the .tfcompleterc would look like
Specific Providers
Google Beta Provider
To use completion for google beta provider, please use .tfcompleterc and put google=beta_<version>
General Todo
Todolist
- Adapt to Upcoming terraform 0.10
- Added a bot for auto pushing of new provider version
- (WIP) Refactoring Regex for linter and completion, and Trying out on api based(so it can integrade with other editor) solution
- (WIP) More test cases
- Support for Neomake(Require further testing)
- Run terraform plan and output to a new window(
<leader>rr) - Async Run support(For Neovim/Vim 8)
- Move regex code to a json(for easier extension)
- Test from zero to useful setup using Docker
- Jump Reference (Ctrl-L first time to jump to resource definition, second time on the same line to jump back)
- Show Doc (Ctrl-K)
- Provide config and example
- Integrate Basic
terraform validateandtflintinto Synstatic - Added a custom linter for providing a better error
- (WIP) Better linter
- (WIP) Full Snippets
NOTE: enabling deep check for tflint can be a bit slow
NOTE: To use tffilter please add export PATH=$PATH:/path/to/this/plugin/bin to your bashrc or zshrc
Todo for Terraform completion
Todolist
- (Require more work) Lookup Attributes data using terraform.tfstate
- Evaluate Interpolation
- (WIP) Custom Provider completion, might do Rest API style due to unstable custom provider
- Provider
- Completion for functions(file,etc) and basic resource arguments(count,lifecyle, etc)
- Module (Make sure you run
terraform getbeforehand) - Data
- Resource(with Provider)
- Parameter
- Adding Info to Argument and Attribute(Type not including ,since Info already indicate it)
- Variable
- Cleaner code
- local/offline
- Add completion tags, ingress, and other subblock
- Further seperate data source from resource
Todo for HCL
- Add Completion for hcl
- Completion for Sublock(Indicate by
Type(B))
Todo for Improvement
- Add Travis-CI for testing, and ensuring the completion is outputing the right completion
- Look into the new module registry (Now support module name completion)
- Add config for allowing multiple version for providers
Credits
- Provider Model Extraction script adapted from Intellij-hcl
- Completion data is from Terraform Official Documentation and Model data from Intellij-HCL
- Folding adapted from vim-terraform



