forestaa / vscode-spotless-gradle

A VS Code extension to lint & format your source files using Spotless & Gradle.

Spotless Gradle

A VS Code extension to lint & format your code using Spotless (via Gradle).

Features

• Provides diagnostics to show invalid formatting (with quick fixes)
• Provides a Spotless fixAll code action (Format on Save)
• Provides a Spotless formatter (Format Document)

Supports all languages that Spotless supports.

Requirements

• VS Code >= 1.45.0
• Gradle Tasks >= 3.5.2
• Spotless Gradle Plugin >= 3.30.0
• Java >= 8

Usage

Before using this extension, ensure you've configured Spotless correctly in your Gradle build file. (Run ./gradlew spotlessDiagnose to prepare & validate Spotless.)

Enabling Spotless

Spotless formatting & diagnostics are disabled by default. Change the settings to adjust this behaviour:

{
  "[java]": {
    "spotlessGradle.format.enable": true,
    "spotlessGradle.diagnostics.enable": true
  }
}

Format on Save

{
  "[java]": {
    "editor.codeActionsOnSave": {
      "source.fixAll.spotlessGradle": true
    }
  }
}

Format Document

If there are multiple formatters for a language type, set Spotless to be the default:

{
  "[java]": {
    "editor.defaultFormatter": "richardwillis.vscode-spotless-gradle"
  }
}

Other Optional Settings

Disable other formatters to improve the performance, for example:

{
  "[java]": {
    "files.trimTrailingWhitespace": false
  }
}

How it Works

This extension runs the spotlessApply Gradle task on the focused file using the Spotless IDE hook feature. Untitled/Unsaved files are ignored.

The vscode => Spotless interface is provided by the Gradle Tasks extension.

👉 Architecture Overview

Troubleshooting

View logs by selecting Spotless Gradle and/or Gradle Tasks in the output panel.

Support

• 👉 Submit a bug report
• 👉 Submit a feature request

Credits

• Thanks to Ned Twigg for adapting Spotless for better IDE integration
• Thanks to all the Spotless contributors

Release Notes

See CHANGELOG.md.

License

See LICENSE.md.