A godot/gdscript formatter and linter extension for VSCode. It uses GDScript-formatter by GDQuest.
Features
This extension provides:
Formatting: Standard VSCode formatter capabilities including format command and autoformatting on save
Linting: Highlights style and convention issues in your GDScript files
The linter runs automatically when you save a file and displays warnings and errors inline with your code.
Requirements
This extension ships with the gdscript formatter binary for your specific platform at version 0.24.0 and uses it by default.
If you want to provide your own binary, you can retrieve the one for your platform here. You can either add it to your system's PATH for autodiscovery or specify the path to the executable in the extension settings (see below). If the binary is added to PATH, make sure to remove the version tag, platform and architecture from the filename, e.g. rename gdscript-formatter-0.17.0-windows-x86_64.exe to gdscript-formatter.exe or gdscript-formatter-0.17.0-linux-aarch64 to gdscript-formatter. Then disable the useBuiltInBinary setting.
Extension Settings
This extension supports the following settings:
godotFormatter.enable: Enable/disable formatting with this extension
godotFormatter.useBuiltInBinary: Whether to use the built-in formatter binary that ships with the extension.
godotFormatter.gdscriptFormatterPath:The path to the gdscript formatter executable. Leave this empty if it's in your system's PATH. If using PATH, make sure to remove the architecture/platform suffix if you copied the binary from the releases page. Only used if useBuiltInBinary is false.
godotFormatter.useSpaces: Whether to use spaces. If disabled will use tabs.
godotFormatter.indentSize: How many spaces to use for indentation. This is only used if useSpaces is enabled
godotFormatter.reorderCode:Whether to allow reordering code blocks, like exported variables vs constants etc. This only applies if verify structure is disabled.
godotFormatter.verifyStructure: Whether to verify formatted output has the same structure as the input. If this enabled, reorderCode is ignored. Slightly less performant.
godotFormatter.maxLineLength: Maximum line length for the formatter. Lines longer than this will be wrapped.
godotFormatter.blankLinesAroundDefinitions: Blank lines between top-level definitions
godotFormatter.continuationIndentLevel: Extra indent for line continuations.
godotFormatter.quoteStyle: Quote style for strings. Must be 'single', 'double' or 'preserve'.
godotFormatter.enableLinter: Enable/disable linting with this extension
godotFormatter.linterMaxLineLength: Configure the maximum line length for the liner.
godotFormatter.linterIgnoredRules: Comma-separated list of rules to ignore.
NOTE: Rules can also be ignored with a # gdlint-ignore-next-line (rules) above a line or # gdlint-ignore (rules) next to a line.
godotFormatter.args: Specify the arguments passed to the formatter directly. These take precedence over any conflicting settings you set via vscode settings.
godotFormatter.argsLinter: Specify the arguments passed to the linter directly. These take precedence over any conflicting settings you set via vscode settings.
All these settings have default values that preserve the underlying formatters defaults, you can freely override them though.
