We adhere to the keepachangelog format (starting after version 3.27.0
).
licenseHeader
andlicenseHeaderFile
accidentally returned a package-private config object, which is now public, fixes (#505).
- Added method
FormatExtension.createIndependentTask(String taskName)
which allows creating a Spotless task outside of thecheck
/apply
lifecycle. See javadoc for details. (#500) - Running
clean
andspotlessCheck
during a parallel build could cause exceptions, fixed by (#501). - Fixed Gradle 7 deprecation warnings that started being emitted in Gradle 6. (#503)
- Even if you're using a pre-6.0 version of Gradle, you will probably see small performance and stability improvements. The PR above finally fixed the root problems of (#372).
- Revert the change in console display of errors from 3.26.0 (#485) because of these problems.
- Bugfix: Fix NPE in EclipseXmlFormatterStepImpl (#489)
- Fix project URLs in poms. (#478)
- Fix
ImportSorter
crashing with empty files. (#474)- Fixes #305 StringIndexOutOfBoundsException for empty Groovy file when performing importOrder
- Bugfix: CDT version
4.12.0
now properly uses9.8
, whereas before it used9.7
. (#482) - Updated default eclipse-wtp from 4.12.0 to 4.13.0 (#482).
- Updated default eclipse-groovy from 4.12.0 to 4.13.0 (#482).
- Updated default eclipse-jdt from 4.12.0 to 4.13.0 (#482).
- Updated default eclipse-cdt from 4.12.0 to 4.13.0 (#482).
- Bump default version of KtLint from
0.34.2
to0.35.0
. (#473) - Several improvements to the console display of formatting errors. (#465)
- Spotless no longer breaks configuration avoidance for other tasks (specifically the
check
task and all of its dependees) (#463).- Important change: Formerly, Spotless did not create its tasks until the
afterEvaluate
phase. Spotless now creates them as soon as the plugin is applied, and it creates the format-specific tasks as soon as the formats are defined. There is no performance degradation associated with this change, and it makes configuring Spotless easier.
- Important change: Formerly, Spotless did not create its tasks until the
- Add support for ktlint
0.34+
, and bump default version from0.32.0
to0.34.2
. (#469)
- Update jgit from
5.3.2.201906051522-r
to5.5.0.201909110433-r
. (#445)- Fixes #410 AccessDeniedException in MinGW/GitBash.
- Also fixes occasional hang on NFS due to filesystem timers.
- Eclipse-based formatters used to leave temporary files around (#447). This is now fixed, but only for eclipse 4.12+, no back-port to older Eclipse formatter versions is planned. (#451)
- Fixed a bad but simple bug in
paddedCell()
(#455)- if a formatter was behaving correctly on a given file (was idempotent)
- but the file was not properly formatted
spotlessCheck
would improperly say "all good" even thoughspotlessApply
would properly change them- combined with up-to-date checking, could lead to even more confusing results, (#338)
- Fixed now!
- When you specify
targetExclude()
, spotless no longer silently removesbuild
directories from the exclusion (#457). - Bumped
scalafmt
default version from1.1.0
to2.0.1
, since there are bugs in the old default (#458).
- Fixed
Warning deprecated usage found: Using the incremental task API without declaring any outputs has been deprecated.
that started appearing in Gradle 5.5 (#434).
- Fixes class loading issue with Java 9+ (#426).
- Updated default eclipse-wtp from 4.8.0 to 4.12.0 (#423).
- Updated default eclipse-groovy from 4.10 to 4.12.0 (#423).
- Updated default eclipse-jdt from 4.11.0 to 4.12.0 (#423).
- Updated default eclipse-cdt from 4.11.0 to 4.12.0 (#423).
- KNOWN BUG - accidentally published CDT 9.7 rather than 9.8 - fixed in 3.26.0
- Added new maven coordinates for scalafmt 2.0.0+, maintains backwards compatability (#415)
- Fixes incorrect M2 cache directory path handling of Eclipse based formatters (#401)
- Update jgit from
4.9.0.201710071750-r
to5.3.2.201906051522-r
because gradle project is sometimes broken byapache httpcomponents
in transitive dependency. (#407)
- Updated default ktlint from 0.21.0 to 0.32.0, and Maven coords to com.pinterest (#394)
- Updated default eclipse-cdt from 4.7.3a to 4.11.0 (#390).
- Fixes incorrect plugin and pom metadata in
3.21.0
(#388).
- Updated default eclipse-wtp from 4.7.3b to 4.8.0 (#382).
- Updated default eclipse-groovy from 4.8.1 to 4.10.0 (#382).
- Updated default eclipse-jdt from 4.10.0 to 4.11.0 (#384).
- Fixed intermittent concurrency error while downloading formatter dependencies in multi-project builds (#372).
- Made npm package versions of
prettier
andtsfmt
(and its internal packages) configurable. (#363)- Updated default npm package version of
prettier
from 1.13.4 to 1.16.4 - Updated default npm package version of internally used typescript package from 2.9.2 to 3.3.3 and tslint package from 5.1.0 to 5.12.0 (both used by
tsfmt
)
- Updated default npm package version of
- Updated default eclipse-wtp from 4.7.3a to 4.7.3b (#371).
- Default behavior of XML formatter changed to ignore external URIs (#369).
- WARNING RESOLVED: By default, xml formatter no longer downloads external entities. You can opt-in to resolve external entities by setting resolveExternalURI to true. However, if you do opt-in, be sure that all external entities are referenced over https and not http, or you may be vulnerable to XXE attacks.
WARNING: xml formatter in this version may be vulnerable to XXE attacks, fixed in 3.20.0 (see #358).
- Security fix: Updated groovy, c/c++, and eclipse WTP formatters so that they download their source jars securely using
https
rather thanhttp
(#360). - Updated default eclipse-jdt from 4.9.0 to 4.10.0 (#368)
WARNING: xml formatter in this version may be vulnerable to XXE attacks, fixed in 3.20.0 (see #358).
- Provided eclipse-wtp formatters in generic formatter extension. (#325). This change obsoletes the CSS and XML extensions.
- Improved configuration times for large projects (thanks to @oehme for finding #348).
- Updated default google-java-format from 1.5 to 1.7 (#335).
- Replacing a step no longer triggers early evaluation (#219).
importOrderFile(Object file)
for java and groovy is now lazy (#218).- added
targetExclude(Object...)
which excludes the given files from processing (#353).- This resolves several related issues:
- Our answer for a long time had been "just use
target(Object...)
to fix this" but there is clearly sufficient demand to justifytargetExclude
.
WARNING: xml formatter in this version may be vulnerable to XXE attacks, fixed in 3.20.0 (see #358).
- Updated default eclipse-jdt from 4.7.3a to 4.9.0 (#316). New version addresses enum-tab formatting bug in 4.8 (#314).
- Added
-spotlessFiles
switch to allow targeting specific files (#322)
WARNING: xml formatter in this version may be vulnerable to XXE attacks, fixed in 3.20.0 (see #358).
- Added support for Eclipse's CSS formatter from WTP (#311).
WARNING: xml formatter in this version may be vulnerable to XXE attacks, fixed in 3.20.0 (see #358).
- Added
xml
support (#140) using formatter of Eclipse WTP 3.9.5 (#241). - Added
prettier
andtsfmt
support (#283). - Added C/C++ support using formatter of Eclipse CDT 9.4.3 (#232).
- Updated default groovy-eclipse from 4.8.0 to 4.8.1 (#288). New version is based on Groovy-Eclipse 3.0.0.
- LicenseHeaderStep now wont attempt to add license to
module-info.java
(#272). - Updated JSR305 annotation from 3.0.0 to 3.0.2 (#274)
- Migrated from FindBugs annotations 3.0.0 to SpotBugs annotations 3.1.6 (#274)
- Gradle/Groovy
importOrder
no longer adds semicolons. (#237)
- Updated default eclipse-jdt from 4.7.2 to 4.7.3a (#263). New version fixes a bug preventing Java code formatting within JavaDoc comments (#191).
- Updated default groovy-eclipse from 4.6.3 to 4.8.0 (#244). New version allows to ignore internal formatter errors/warnings.
- Fixed integration with latest versions of scalafmt. (#260)
- Add line and column numbers to ktlint errors. (#251)
- Migrated
plugin-gradle
's tests away fromTaskInternal#execute
to a custom method to help with Gradle 5.0 migration later on. (#208) - Fixed a bug in
LicenseHeaderStep
which caused an exception with some malformed date-aware licenses. (#222) - Updated default ktlint from 0.14.0 to 0.21.0
- Add ability to pass custom options to ktlint. See README for details.
- Added interface
HasBuiltinDelimiterForLicense
to language extensions that have pre-defined licence header delimiter. (#235)
- LicenseHeaderStep now supports customizing the year range separator in copyright notices. (#199)
- Updated default ktlint from 0.6.1 to 0.14.0
- Updated default google-java-format from 1.3 to 1.5
- Updated default eclipse-jdt from 4.7.1 to 4.7.2
- Added a configuration option to
googleJavaFormat
to switch the formatter style (#193)- Use
googleJavaFormat().aosp()
to use AOSP-compliant style (4-space indentation) instead of the default Google Style
- Use
- Bugfix: if the specified target of a spotless task was reduced, Spotless could keep giving warnings until the cache file was deleted.
- LicenseHeader now supports time-aware license headers. (docs, #179, thanks to @baptistemesta)
- Updated default eclipse-jdt version to
4.7.1
from4.6.3
. - All spotless tasks now run before the
clean
task. (#159) - Added
sql
(#166) anddbeaverSql
. (#166)- Many thanks to Baptiste Mesta for porting to Spotless.
- Many thanks to DBeaver and the DBeaver contributors for building the implementation.
- Fix licenseHeader so it works with Kotlin files starting with
@file:...
instead ofpackage ...
(#136).
- Fixed
kotlinGradle
linting Gradle Kotlin DSL files throwingParseException
(#132).
- Changed
importOrder
interface from array to varargs (#125). - The
kotlin
extension was mis-spelled askotin
. - Added
kotlinGradle
method toSpotlessExtension
for linting Gradle Kotlin DSL files with ktlint (#115) - Added dedicated
groovyGradle
for formatting of Gradle files.
- Default eclipse version for
EclipseFormatterStep
bumped to4.6.3
from4.6.1
. (#116) - Default scalafmt version for
ScalaFmtStep
bumped to1.1.0
from0.5.7
(#124)- Also added support for the API change to scalafmt introduced in
0.7.0-RC1
- Also added support for the API change to scalafmt introduced in
- Fixed wildcard targets for
includeFlat
subprojects (#121) - When spotless needs to download a formatter, it now uses the buildscript repositories specified in the root buildscript. (#123, #120)
ImportOrderStep
can now handle multi-line comments and misplaced imports.- Groovy extension now checks for the
groovy
plugin to be applied. - Deprecated the old syntax for the the eclipse formatter:
- New syntax better separates the version from the other configuration options, and is more consistent with the other
eclipseFormatFile('format.xml')
->eclipse().configFile('format.xml')
eclipseFormatFile('4.4.0', 'format.xml')
->eclipse('4.4.0').configFile('format.xml')
- Fixed a bug in
paddedCell()
which causedspotlessCheck
to fail even afterspotlessApply
for cases where a rule is misbehaving and causing a cycle.
- Added support for groovy formatting (huge thanks to Frank Vennemeyer! #94, #89, #88, #85)
- When special-purpose formatters need to be downloaded from maven, they are now resolved using the buildscript repositories rather than the project repositories. (thanks to cal101 #100)
- Update default KtLint from 0.3.1 to 0.6.1 (thanks to @kvnxiao #93).
- This means we no longer look for rules in the typo package
com.gihub.shyiko
, now only incom.github.shyiko
(note thet
).
- This means we no longer look for rules in the typo package
- Added an
enforceCheck
property which allows users to disable addingspotlessCheck
as a dependency ofcheck
(thanks to @gdecaso #95). - Any errors in a step will now fail the build] - 201x-xx-xx previously they were only warned.
- We claimed that we implemented this in 3.1.0, but it was broken. We really fixed it this time.
- Added support for Scala via scalafmt.
- Added support for Kotlin via ktlint.
- Added
FormatExtension::replaceStep
. paddedCell()
is no longer required if a misbehaving rule converges.- Any errors in a step will now fail the build] - 201x-xx-xx previously they were only warned.
- Added
FormatExtension::ignoreErrorForStep
andFormatExtension::ignoreErrorForPath
. - Bumped
google-java-format
to1.3
.
- BREAKING CHANGE:
customReplace
andcustomReplaceRegex
renamed to justreplace
andreplaceRegex
. - BREAKING CHANGE: Plugin portal ID is still
com.diffplug.gradle.spotless
, but maven coordinate has changed tocom.diffplug.spotless:spotless-plugin-gradle
. - HUGE SPEEDUP: Now supports incremental build / up-to-date-checking.
- If you are using
custom
orcustomLazy
, you might want to take a look at this javadoc.
- If you are using
- BREAKING CHANGE:
freshmark
no longer includes all project properties by default. All properties must now be added manually:
spotless {
freshmark {
propertiesFile('gradle.properties')
properties {
it.put('key', 'value')
}
}
}
- Fixed googleJavaFormat so that it can now sort imports and remove unused imports.
- Added an à la carte
removeUnusedImports()
step.
- Java files under the
src/main/groovy
folder are now formatted by default. (Issue #59, PR #60, thanks @ajoberstar).
- If a formatter step throws an
Error
or any of its subclasses, such as theAssertionError
s thrown by JUnit, AssertJ, etc. that error will kill the build (#46)- This allows custom rules like this:
custom 'no swearing', {
if (it.toLowerCase().contains('fubar')) {
throw new AssertionError('No swearing!');
}
}
- When
spotlessCheck
fails, the error message now contains a short diff of what is neccessary to fix the issue (#10, thanks to Jonathan Bluett-Duncan). - Added a padded-cell mode which allows spotless to band-aid over misbehaving rules, and generate error reports for these rules (See #37 for an example).
- Character encoding is now configurable (spotless-global or format-by-format).
- Line endings were previously only spotless-global, they now also support format-by-format.
- Upgraded eclipse formatter from 4.6.0 to 4.6.1
- Added support for google-java-format.
spotless {
java {
googleJavaFormat() // googleJavaFormat('1.1') to specify a specific version
}
}
- Added the method
FormatExtension::customLazyGroovy
which fixes the Groovy closure problem.
spotlessApply
now writes out a file only if it needs to be changed (big performance improvement).- Java import sorting now removes duplicate imports.
- Eclipse formatter now warns if the formatter xml contains multiple profiles.
- Updated eclipse formatter to Eclipse Neon (4.6).
- BREAKING CHANGE: Eclipse formatter now formats javadoc comments.
- You might want to look at the following settings in your
spotless.eclipseformat.xml
:
- You might want to look at the following settings in your
org.eclipse.jdt.core.formatter.join_lines_in_comments=true/false
org.eclipse.jdt.core.formatter.comment.format_javadoc_comments=true/false
org.eclipse.jdt.core.formatter.comment.format_line_comments=true/false
org.eclipse.jdt.core.formatter.comment.format_block_comments=true/false
The most important breaking change of 2.0 is the new default line ending mode, GIT_ATTRIBUTES
. This line ending mode copies git's behavior exactly. This change should require no intervention from users, and should be significantly easier to adopt for users who are already using .gitattributes
or the core.eol
property.
If you aren't using git, you can still use .gitattributes
files for fine-grained control of line endings. If no git information is found, it behaves the same as PLATFORM_NATIVE (the old default).
Below is the algorithm used by git and spotless to determine the proper line ending for a file. As soon as a step succeeds in finding a line ending, the other steps will not take place.
- If the code is a git repository, look in the
$GIT_DIR/info/attributes
file for theeol
attribute. - Look at the
.gitattributes
in the file's directory, going up the directory tree. - Look at the global
.gitattributes
file, if any. - Look at the
core.eol
property in the git config (looking first at repo-specific, then user-specific, then system-specific). - Use the PLATFORM_NATIVE line ending.
- Upgraded Eclipse formatter to 4.5.2, which fixes 37 bugs compared to the previous 4.5.0.
- If you have been using
custom 'Lambda fix', { it.replace('} )', '})').replace('} ,', '},') }
, you don't need it anymore.
- Spotless no longer clobbers package-info.java, fixes #1.
- Added some infrastructure which allows
FormatterStep
s to peek at the filename if they really need to.
- Bumped the FreshMark dependency to 1.3.0, because it offers improved error reporting.
- Added native support for FreshMark.
- Updated from Eclipse 4.5 M6 to the official Eclipse 4.5 release, which fixes several bugs in the formatter.
- Fixed a bug in the import sorter which made it impossible to deal with "all unmatched type imports".
- Formatting is now relative to the project directory rather than the root directory.
- Improved the logging levels.
- No functional changes, probably not worth the time for an upgrade.
- First version which is available on plugins.gradle.org as well as jcenter.
- Removed some code that was copy-pasted from Durian, and added a Durian dependency.
- Initial release.
- First release, to test out that we can release to jcenter and whatnot.