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 by todesking/vint-syntastic.

Configure

Vint will read config files on the following priority order:

• User config:
• e.g. ~/.vintrc.yaml
• Project config:
• e.g. path/to/proj/.vintrc.yaml
• Command line config:
• e.g. $ vint --error, $ vint --max-violations 10
• Comment config (highest priority):
• e.g. " vint: -ProhibitAbbreviationOption +ProhibitSetNoCompatible

User config

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

cmdargs:
  # Checking more strictly
  severity: style_problem

  # Enable coloring
  color: 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

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