vim-vint 0.3.13

Lint tool for Vim script Language

---

Vint is a Vim script Language Lint. The goal to reach for Vint is:

• Highly extensible

• Highly customizable

• High performance

But now, Vint is under development. We hope you develop a policy to help us.

Quick start

You can install with pip.

$ pip install vim-vint

You can use Vint with scrooloose/syntastic:

let g:syntastic_vim_checkers = ['vint']

Configure

Vint will read config files on the following priority order:

• User config:

• e.g. ~/.vintrc.yaml (the filename can be .vintrc.yml or .vintrc)

• Project config:

• e.g. path/to/proj/.vintrc.yaml (the filename can be .vintrc.yml or .vintrc)

• Command line config:

• e.g. $ vint --error, $ vint --max-violations 10

• Comment config (highest priority):

• e.g. " vint: -ProhibitAbbreviationOption +ProhibitSetNoCompatible

You can see all options on Wiki.

User config

You can configure global Vint config by ~/.vintrc.yaml as following:

cmdargs:
  # Checking more strictly
  severity: style_problem

  # Enable coloring
  color: true

  # Enable Neovim syntax
  env:
    neovim: true

policies:
  # Disable a violation
  ProhibitSomethingEvil:
    enabled: false

  # Enable a violation
  ProhibitSomethingBad:
    enabled: true

You can see all policy names on Vint linting policy summary.

Project config

You can configure project local Vint config by .vintrc.yaml as following:

cmdargs:
  # Checking more strictly
  severity: style_problem

  # Enable coloring
  color: true

  # Enable Neovim syntax
  env:
    neovim: true

policies:
  # Disable a violation
  ProhibitSomethingEvil:
    enabled: false

  # Enable a violation
  ProhibitSomethingBad:
    enabled: true

You can see all policy names on Vint linting policy summary.

Command line config

You can configure linting severity, max errors, … as following:

$ vint --color --style ~/.vimrc

Comment config

You can enable/disable linting policies by a comment as following:

“ vint: -ProhibitAbbreviationOption

let s:save_cpo = &cpo set cpo&vim

“ vint: +ProhibitAbbreviationOption

“ do something…

“ vint: -ProhibitAbbreviationOption

let &cpo = s:save_cpo unlet s:save_cpo

This syntax is: " vint: [+-]<PolicyName> [+-]<PolicyName> ....

You can see all policy names on Vint linting policy summary.

Code health

License

MIT

Acknowledgement

• ynkdir/vim-vimlparser

• Google Vimscript Style Guide

• Anti-pattern of vimrc