Fixup license headers

Author: vjovanov

.github/workflows/checkstyle.yml

@@ -24,4 +24,4 @@ jobs:
           distribution: 'graalvm'
           java-version: '21'
 
-      - run: ./gradlew checkstyle
+      - run: ./gradlew spotlessCheck checkstyle

build.gradle

@@ -1,3 +1,9 @@
+/*
+ * Copyright and related rights waived via CC0
+ *
+ * You should have received a copy of the CC0 legalcode along with this
+ * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
+ */
 import java.util.concurrent.Executors
 import java.util.concurrent.TimeUnit
 
@@ -40,6 +46,50 @@ spotless {
                 .sortByKeys()
                 .version("2.9.0")
     }
+    java {
+        target('**/*.java')
+        targetExclude(
+                'metadata/**', // only JSON there
+                '**/build/**',
+                'gradle/header.java')
+        // Place header before package/import/module
+        licenseHeaderFile("$rootDir/gradle/header.java", "package |import |module ")
+    }
+
+    String[] noHeaderDirs = [
+            'docs/**',     // only .md files
+            'metadata/**', // only .json files
+            '**/build/**', // not relevant
+            'gradle/wrapper/**', // not relevant
+    ]
+    groovy {
+        target('**/*.groovy')
+        targetExclude(noHeaderDirs)
+        // Place header before package/import
+        licenseHeaderFile("$rootDir/gradle/header.java", "package |import ")
+    }
+    groovyGradle {
+        // Build scripts (*.gradle)
+        target('**/*.gradle')
+        targetExclude(noHeaderDirs)
+        targetExclude('tests/**')
+        // Insert header at file start (works for any Gradle script layout)
+        licenseHeaderFile("$rootDir/gradle/header.java", "(?m)^(import\\b|plugins\\b|buildscript\\b|apply\\b|rootProject\\b|pluginManagement\\b|dependencyResolutionManagement\\b)")
+    }
+    format('shell') {
+        target('**/*.sh')
+        targetExclude(noHeaderDirs)
+        // Ensure header appears after shebang if present, else at the very top.
+        def shHeader = file("$rootDir/gradle/header.sh").text
+        // If file starts with a shebang and is missing the header, insert it after the shebang
+        replaceRegex('insert-license-after-shebang',
+                     '(?s)\\A(#!.*\\n)(?!# Copyright and related rights waived via CC0\\n)',
+                     '$1' + shHeader + "\n")
+        // If file has no shebang and is missing the header, insert it at the start
+        replaceRegex('insert-license-at-start',
+                     '(?s)\\A(?!#!)(?!# Copyright and related rights waived via CC0\\n)',
+                     shHeader + "\n")
+    }
 }
 
 // gradle package

docs/DEVELOPING.md

@@ -38,6 +38,11 @@ Tip: When debugging locally, add `--stacktrace` for better error output.
     ```console
    ./gradlew spotlessCheck
     ```
+3. Auto-fix license headers and formatting locally:
+    ```console
+    ./gradlew spotlessApply
+    ```
+   Spotless enforces the CC0 license header on Java, Groovy, Gradle build scripts, and shell scripts. The metadata/** directory is excluded from header checks.
 
 ### Testing one library locally
 
@@ -128,6 +133,7 @@ These tasks support the scheduled workflow that checks newer upstream library ve
 
 - Style: `./gradlew checkstyle`
 - Format check: `./gradlew spotlessCheck`
+- Format apply: `./gradlew spotlessApply`
 - Pull images (single lib): `./gradlew pullAllowedDockerImages -Pcoordinates=[group:artifact:version|k/n|all]`
 - Check metadata (single lib): `./gradlew checkMetadataFiles -Pcoordinates=[group:artifact:version|k/n|all]`
 - Test (single lib): `./gradlew test -Pcoordinates=[group:artifact:version|k/n|all]`

gradle/header.java

@@ -0,0 +1,6 @@
+/*
+ * Copyright and related rights waived via CC0
+ *
+ * You should have received a copy of the CC0 legalcode along with this
+ * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
+ */

gradle/header.sh

@@ -0,0 +1,4 @@
+# Copyright and related rights waived via CC0
+#
+# You should have received a copy of the CC0 legalcode along with this
+# work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.

settings.gradle

@@ -1,3 +1,9 @@
+/*
+ * Copyright and related rights waived via CC0
+ *
+ * You should have received a copy of the CC0 legalcode along with this
+ * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
+ */
 pluginManagement {
     includeBuild("tests/tck-build-logic")
 }

tests/src/com.zaxxer/HikariCP/5.0.1/src/test/java/com/zaxxer/hikaricp/test/HikariCPTest.java

@@ -4,7 +4,6 @@
  * You should have received a copy of the CC0 legalcode along with this
  * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
  */
-
 package com.zaxxer.hikaricp.test;
 
 import com.zaxxer.hikari.HikariConfig;

tests/src/com.zaxxer/HikariCP/5.0.1/src/test/java/com/zaxxer/hikaricp/test/driver/CustomConnection.java

@@ -4,7 +4,6 @@
  * You should have received a copy of the CC0 legalcode along with this
  * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
  */
-
 package com.zaxxer.hikaricp.test.driver;
 
 import java.sql.Array;

tests/src/com.zaxxer/HikariCP/5.0.1/src/test/java/com/zaxxer/hikaricp/test/driver/CustomDriver.java

@@ -4,7 +4,6 @@
  * You should have received a copy of the CC0 legalcode along with this
  * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
  */
-
 package com.zaxxer.hikaricp.test.driver;
 
 import java.sql.Connection;

tests/src/com.zaxxer/HikariCP/6.0.0/src/test/java/com/zaxxer/hikaricp/test/HikariCPTest.java

@@ -4,7 +4,6 @@
  * You should have received a copy of the CC0 legalcode along with this
  * work. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
  */
-
 package com.zaxxer.hikaricp.test;
 
 import com.zaxxer.hikari.HikariConfig;