cwonrails / vint

Fast and Highly Extensible Vim script Language Lint implemented by Python.

---

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:

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