{"id":27139757,"url":"https://github.com/maralla/validator.vim","last_synced_at":"2025-07-19T09:32:21.406Z","repository":{"id":29562044,"uuid":"33101387","full_name":"maralla/validator.vim","owner":"maralla","description":"Check syntax on the fly asynchronously.","archived":false,"fork":false,"pushed_at":"2020-08-23T10:13:39.000Z","size":167,"stargazers_count":214,"open_issues_count":23,"forks_count":14,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-08T04:59:24.952Z","etag":null,"topics":["linter","python","syntax-checker","vim","vim-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maralla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-30T03:30:24.000Z","updated_at":"2025-02-16T17:01:54.000Z","dependencies_parsed_at":"2022-08-31T00:51:05.725Z","dependency_job_id":null,"html_url":"https://github.com/maralla/validator.vim","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maralla/validator.vim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maralla%2Fvalidator.vim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maralla%2Fvalidator.vim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maralla%2Fvalidator.vim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maralla%2Fvalidator.vim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maralla","download_url":"https://codeload.github.com/maralla/validator.vim/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maralla%2Fvalidator.vim/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265909775,"owners_count":23847502,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linter","python","syntax-checker","vim","vim-plugin"],"created_at":"2025-04-08T04:59:29.066Z","updated_at":"2025-07-19T09:32:21.362Z","avatar_url":"https://github.com/maralla.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Validator\n=========\n\n[![Build Status](https://travis-ci.org/maralla/validator.vim.svg?branch=master)](https://travis-ci.org/maralla/validator.vim)\n\nSyntax check framework for vim which checks syntax on the fly asynchronously.\n\n\u003cimg src=\"https://i.imgur.com/L8eu6Zb.gif\" width=\"684\" height=\"482\"\u003e\n\nRequirements\n------------\n\nYou should have a relatively new version of vim which supports such features:\n`job`, `timers` and `lambda`.\n\nYour vim should be compiled with `python` or `python3`.\n\nValidator relies on external syntax checkers, so you need to install the checkers\nfit for the files you are editting.\n\nBuiltin Checkers\n----------------\n\n* c/c++, `clang-tidy`\n* python, `flake8`\n* cython, `cython`\n* css, `csslint`\n* javascript, `jshint`, `eslint`, `jscs`\n* ruby, `mri`, `rubocop`\n* json, `jsonlint`\n* lua, `luac`, `luacheck`\n* sh, `sh`, `shellcheck`\n* rst, `rst2pseudoxml`\n* vim, `vint`, `vimlparser`\n* go, `gofmt`, `golint`, `gometalinter`\n* rust, `cargo check` (not instant)\n\nConfiguration\n-------------\n\nSelect checkers for a file type:\n\n```vim\nlet g:validator_{filetype}_checkers = ['\u003cchecker_name\u003e']\n\n\" for example, choose eslint to check javascript:\nlet g:validator_javascript_checkers = ['eslint']\n```\n\nTo customize error message:\n\n```vim\nlet g:validator_error_msg_format = \"[ ● %d/%d issues ]\"\n```\n\nTo auto open quickfix window:\n\n```vim\nlet g:validator_auto_open_quickfix = 1\n```\n\nTo handle file type alias:\n\n```vim\nlet g:validator_filetype_map = {'\u003calias\u003e': '\u003cfiletype_supported\u003e'}\n\n\" for example\nlet g:validator_filetype_map = {\"python.django\": \"python\"}\n```\n\nIgnore file types:\n\n```vim\nlet g:validator_ignore = ['\u003cfiletype\u003e']\n```\n\nTo customize the signs colors, you can use the following groups:\n\n```vim\n\" For syntax errors \u0026 warnings\nValidatorErrorSign\nValidatorWarningSign\n\n\" For style errors \u0026 warnings\n\" (By default, use the same colors as the 2 groups above)\nValidatorStyleErrorSign\nValidatorStyleWarningSign\n```\n\nTo show permanently the sign column and prevent annonying behavior when the\nsign column appear and then it disappears.\n\n![sign](https://i.imgur.com/nGXEijq.jpg)\n\n```vim\nlet g:validator_permament_sign = 1\n```\n\nTo specify the checker executable path or pass checker arguments manually:\n\n```vim\n\" If not specified `\u003cargs_name\u003e` is `\u003cfiletype\u003e_\u003cchecker\u003e`.\nlet g:validator_\u003cargs_name\u003e_args = '\u003cargs\u003e'\n\" If not specified `\u003cbinary_name\u003e` is `\u003cfiletype\u003e_\u003cchecker\u003e`.\nlet g:validator_\u003cbinary_name\u003e_binary = '/path/to/executable'\n\n\" For c/c++\nlet g:validator_clang_tidy_binary = '/path/to/executable'\n\n\" For flake8\nlet g:validator_python_flake8_args = '--max-line-length=120'\nlet g:validator_python_flake8_binary = '/Users/maralla/.dotfiles/virtualenvs/py27/bin/flake8'\n\n\" For rubocop\nlet g:validator_ruby_rubocop_args = '-f s -c .rubocop.yml'\nlet g:validator_ruby_rubocop_binary = '/Users/maralla/.rvm/gems/ruby-2.3.0/bin/rubocop'\n```\n\nInstall\n-------\n\n* [pack](https://github.com/maralla/pack)\n\n```bash\n$ pack install maralla/validator.vim\n```\n\n* [vim-plug](https://github.com/junegunn/vim-plug)\n\n```vim\nPlug 'maralla/validator.vim'\n```\n\nUsage\n-----\n\nValidator.vim automatically checks syntax in the background when file content\nchanges, so no need to do any trigger manually. If you do want to do a check\nmanually use this command `ValidatorCheck`. This command is especially useful\nwhen you set the file type manually.\n\nDebugging\n-----\n\nEnable the debugging with:\n\n```vim\nlet g:validator_debug = 1\n```\n\nThe output is logged in plugin installation directory:\n\ne.g.  `/path/to/validator.vim/pythonx/validator.log`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaralla%2Fvalidator.vim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaralla%2Fvalidator.vim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaralla%2Fvalidator.vim/lists"}