VSCode Any Lint

VSCode Any Lint allows you to lint any files with any command line tools.

Features

• Any file type
• Any command line tool

Security

This extension can execute any command line tool. If the workspace (repository) you are trying to open is completely trustworthy, it is safe to run this extension. But if not, it is very dangerous (e.g., running rm -rf / as a linter).

To eliminate such risks, this extension asks the user for authorization for each linter. The result of this authorization is stored with the linter's name, path, and argument information as keys, so if you change any of them, you will be asked to confirm again. You can reset this authorization by command Reset allowed/disallowed linter to run in this workspace.

You can disable this authorization by any-linter.disableConfirmToAllowToRun: true, but you will be asked once if you trust this workspace.

Extension Settings

• any-lint.linters: Linter settings. Please see below Linter Configuration

Linter Configuration

Key	Type	Required	Detail
name	string	✔️	the linter name. This is used for Diagnostic.source.
binPath	string	✔️	the command line tool path.
args	Array<string>		the command line tool arguments.
extraArgs	map<string, Array<string>>		the command line tool extra arguments depends on on setting.
cwd	string		the current working directory. default is file's directory.
condition	string		if this JavaScript expression returns truthy value, linter starts.
on	Array<string>		change: on file changed. save: on file saved.
disabled	boolean		force disable linting. this is usedful for debug when you have multiple linters.
diagnostic	DiagnosticConfiguration		the diagnostic configuration

When change is used for on, current editing buffer is passed to spawned process by STDIN.

condition

You can write any JavaScript expression in condition. You can access below context by $ variable like $.file. This is based on VSCode Variables Reference.

Example supposes following requirements.

1. A file located at /home/your-username/your-project/folder/file.ext opened in your editor;
2. The directory /home/your-username/your-project opened as your root workspace.

Key	Detail	Example
workspaceFolder	the path of the folder opened in VS Code	/home/your-username/your-project
workspaceFolderBasename	the name of the folder opened in VS Code without any slashes (/)	your-project
file	the current opened file	/home/your-username/your-project/folder/file.ext
fileWorkspaceFolder	the current opened file's workspace folder	/home/your-username/your-project
relativeFile	the current opened file relative to workspaceFolder	folder/file.ext
relativeFileDirname	the current opened file's dirname relative to workspaceFolder	folder
fileBasename	the current opened file's basename	file.ext
fileBasenameNoExtension	the current opened file's basename with no file extension	file
fileDirname	the current opened file's dirname	/home/your-username/your-project/folder
fileExtname	the current opened file's extension	.ext
cwd	the same as fileDirname	/home/your-username/your-project/folder
lineNumber	the line number of the cursor
selectedText	the selected text in your code editor
pathSeparator	/ on macOS or linux, \\ on Windows
languageId	the current opened file's languageId

Diagnostic Configuration

Key	Type	Required	Detail
output	string		the output type. stdout or stderr. default is stderr
type	string		the output format type. lines, json or yaml. default is lines
format	string		the lines format option. default is ${file}:${startLine}:${startColumn}: ${message}
selectors	DiagnosticSelectors		the json or yaml selectors option.
lineZeroBased	boolean		the reported diagnostic line is zero based or not. default is false
columnZeroBased	boolean		the reported diagnostic column is zero based or not. default is false
columnCharacterBased	boolean		the reported diagnostic column unit is character or not. default is false (i.e. bytes)
endColumnInclusive	boolean		the reported diagnostic end column is inclusive. default is false (i.e. exclusive)
severity	string		the severity. error, warning, info or hint. default is error
severityMap	Map<string, DiagnosticSeverity>\		the severity mapping. key is arbitrary, value must be error, warning, info or hint.
actions	Array<DiagnosticAction>		the code actions.

format

format supports below reserved placeholders

Key	Required	Detail
file		the file path. document filename is used if unspecfied
startLine	✔️	the start line of diagnostic
startColumn		the start column of diagnostic
endLine		the end line of diagnostic
endColumn		the end column of diagnostic
message		the message of diagnostic
severity		the severity of diagnostic

Placeholders not in above list are treated as user defined placeholders.

DiagnosticSelectors

You can write any JavaScript expression as selector. You can access below context by $ variable like $.file.

Key	Required	Detail
diagnostics	✔️	the diagnostics selector. result must be Array
file	✔️	the file path selector. result must be string
subDiagnostics		the sub diagnostics selector. result must be Array
startLine	✔️	the start line selector. result must be number
startColumn	✔️	the start column selector. result must be number
endLine		the end line selector. result must be number
endColumn		the end column selector. result must be number
message		the message selector. result must be string
severity		the severity selector. result must be string

// routine pseudo code
diagnostics = []
for (diagnostic of $[`diagnostics`]) {
    file = diagnostic[`file`]
    if (diagnostic[`subDiagnostics`]) {
        for (subDiagnostic of diagnostic[`subDiagnostics`]) {
            file = subDiangostic[`file`] || file
            diagnostics.push(
                file,
                subDiangostic[`startLine`],
                subDiangostic[`startColumn`],
                subDiangostic[`endLine`],
                subDiangostic[`endColumn`],
                subDiangostic[`message`]
            )
        } 
    } else {
        diagnostics.push(
            file,
            diangostic[`startLine`],
            diangostic[`startColumn`],
            diangostic[`endLine`],
            diangostic[`endColumn`],
            diangostic[`message`]
        )
    }
}

DiagnosticAction

This is code action setting for diagnostic. There are several types supported

• openUri: this is for opening lint rule documentation
• ignore: this is for inserting ignore rule comment
• run: this is for running command to auto fix errors

You can use two variables in configurations which support JavaScript expression.

• $: the same as condition setting
• $$: diagnostic object
  • format=lines: object which consists of reserved placeholders and user defined placeholders.
  • format=json or format=yaml: When you specify subDiagnostics selector, this is sub diagnostic.

Common Configuration

Key	Type	Required	Detail
type	string	✔️	openUri or ignore or run
title	string	✔️	the title of code action. JavaScript expression. result must be string

openUri

Key	Type	Required	Detail
uri	string	✔️	the opening uri for openUri. JavaScript expression. result must be string

ignore

Key	Type	Required	Detail
comment	string		the inserting comment for ignore. JavaScript expression. result must be string
location	string		the inserting comment location for ignore. startFile, previousLine, currentLine, nextLine or rewriteLine. default is previousLine

Please see below example for comment location.

// startLine

// previousLine
foo // currentLine
// nextLine

rewriteLine has a different behavior. It rewrites a whole text in diagnostic range. You can access text by $$.content, line indent by $$.indent and eol by $$.eol. Typically, use below example configuration.

{
    "location": "rewriteLine",
    "comment": "`${$$.indent}// DISABLE RULE${$$.eol}${$$.content}${$$.eol}${$$.indent}// ENABLE RULE`"
}

run

Key	Type	Required	Detail
binPath	string	✔️	the running command line tool path. JavaScript expression. result must be string
args	Array<string>		the running command line tool arguments. JavaScript expressions. result must be Array<string>
cwd	string		the current working directory. JavaScript expression. result must be string. default is file's directory.
lintAfterRun	string		after running command line tool, lint again for the reported file. JavaScript expression. default is false

Examples

Please see examples