Skip to content

Latest commit

 

History

History
87 lines (64 loc) · 2.99 KB

README.md

File metadata and controls

87 lines (64 loc) · 2.99 KB
Raw

Snippets for SaltStack

This repository contains snippets files for SaltStack state files.

Contents

  • gen-snippets.py: script used for generating snippets from salt source
  • snippets/*: generated snippets go here

Installation

You need to install a snippet engine first. Currently neosnippet is supported, and thanks to neosnippet's compatibility to vim-snipmate, it is also supported.

I will only cover configuration for neosnippet, since I only use this. You are welcome to help me complete this instruction.

  1. Save the snippets/ directory somewhere vim can find, like:

    cd ~/.vim/
git clone https://github.com/StephenPCG/vim-snippets-salt/
# you may also only copy the snippets/ directory here

  2. Add the snippets/ directory to g:neosnippet#snippets_directory:

    " g:neosnippet#snippets_directory is a comma-seperated string or list,
" I prefer using list.
let g:neosnippet#snippets_directory = [$HOME . "/.vim/vim-snippets-salt/snippets/"]

  3. Since different versions of salt have different amount of states functions, you can generate snippets for each version you need. Snippets are named as sls-$version.sls, so you need to set g:neosnippet#scope_alias to tell neosnippet which file to use. e.g.

    " g:neosnippet#scope_aliases is a dictionary, initialize it if you haven't done it
let g:neosnippet#scope_aliases = {}
let g:neosnippet#scope_aliases['sls'] = 'sls-0.17.2'

    scope_aliases[filetype] is a comma-seperated string, all listed variant snippets will be loaded, so make sure you only list one here, or multiple versions if you realy need.

    For vim-snipmate, there is also a g:snipMate.scope_aliases which does the same thing.

Generating Snippets

You can generate snippets by yourself. You have to get saltstack source code and make sure salt is importable. The gen-snippets.py will import salt.states.* and find functions for each module, if any required library is missing, the generation will fail.

# This will try to import salt from system, detect its version, and save output to snippets/sls-$version.snippets
./gen-snippets.py

If you have salt source stored elsewhere, or want to generate for a specific version, you can do like this:

cd ~/salt/
git checkout v0.17.2
/path/to/gen-snippets.py -p ~/salt/

Sometimes, we would like to ignore function argument name, since in most cases we don't need it, you can ignore it:

./gen-snippets.py -i name

-i may be specified multiple times to ignore multiple args.

I have added two pre-generated snippets for version 0.17.2 and 2014.1.5 with name ignored.

Screenshot

ScreenShot