Tweak Gradle flags (#1093)

(cherry picked from commit ccc04a6)

build-logic/gradle.properties

@@ -0,0 +1 @@
+org.gradle.kotlin.dsl.allWarningsAsErrors=true

gradle.properties

@@ -1,9 +1,13 @@
-org.gradle.jvmargs=-Dfile.encoding=UTF-8 -Xmx4g -XX:MaxMetaspaceSize=2g
-org.gradle.parallel=true
+# Omit automatic compile dependency on kotlin-stdlib
+# https://kotlinlang.org/docs/gradle.html#dependency-on-the-standard-library
+kotlin.stdlib.default.dependency=false
+
 org.gradle.caching=true
 org.gradle.configuration-cache=true
 org.gradle.configuration-cache.parallel=true
-
+org.gradle.jvmargs=-Dfile.encoding=UTF-8 -Xmx4g -XX:MaxMetaspaceSize=2g
+org.gradle.kotlin.dsl.allWarningsAsErrors=true
+org.gradle.parallel=true
 
 GROUP=com.gradleup.shadow
 POM_ARTIFACT_ID=shadow-gradle-plugin

src/docs/configuration/merging/README.md

@@ -12,17 +12,22 @@ determine if it should process a particular entry and apply any modifications be
 // Adding a Transformer
 import com.github.jengelman.gradle.plugins.shadow.transformers.Transformer
 import com.github.jengelman.gradle.plugins.shadow.transformers.TransformerContext
+import javax.annotation.Nonnull
 import org.apache.tools.zip.ZipOutputStream
 import org.gradle.api.file.FileTreeElement
 
 class MyTransformer implements Transformer {
-    boolean canTransformResource(FileTreeElement element) { true }
+  @Override
+  boolean canTransformResource(@Nonnull FileTreeElement element) { return true }
 
-    void transform(TransformerContext context) {}
+  @Override
+  void transform(@Nonnull TransformerContext context) {}
 
-    boolean hasTransformedResource() { true }
+  @Override
+  boolean hasTransformedResource() { return true }
 
-    void modifyOutputStream(ZipOutputStream jos, boolean preserveFileTimestamps) {}
+  @Override
+  void modifyOutputStream(@Nonnull ZipOutputStream os, boolean preserveFileTimestamps) {}
 }
 
 tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar) {
@@ -36,20 +41,24 @@ Additionally, a `Transformer` can accept a `Closure` to configure the provided `
 // Configuring a Transformer
 import com.github.jengelman.gradle.plugins.shadow.transformers.Transformer
 import com.github.jengelman.gradle.plugins.shadow.transformers.TransformerContext
+import javax.annotation.Nonnull
 import org.apache.tools.zip.ZipOutputStream
 import org.gradle.api.file.FileTreeElement
 
 class MyTransformer implements Transformer {
+  boolean enabled
 
-    boolean enabled
+  @Override
+  boolean canTransformResource(@Nonnull FileTreeElement element) { return true }
 
-    boolean canTransformResource(FileTreeElement element) { true }
+  @Override
+  void transform(@Nonnull TransformerContext context) {}
 
-    void transform(TransformerContext context) {}
+  @Override
+  boolean hasTransformedResource() { return true }
 
-    boolean hasTransformedResource() { true }
-
-    void modifyOutputStream(ZipOutputStream jos, boolean preserveFileTimestamps) {}
+  @Override
+  void modifyOutputStream(@Nonnull ZipOutputStream os, boolean preserveFileTimestamps) {}
 }
 
 tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar) {
@@ -65,24 +74,32 @@ An instantiated instance of a `Transformer` can also be provided.
 // Adding a Transformer Instance
 import com.github.jengelman.gradle.plugins.shadow.transformers.Transformer
 import com.github.jengelman.gradle.plugins.shadow.transformers.TransformerContext
+import javax.annotation.Nonnull
 import org.apache.tools.zip.ZipOutputStream
 import org.gradle.api.file.FileTreeElement
 
 class MyTransformer implements Transformer {
+  final boolean enabled
 
-    boolean enabled
+  MyTransformer(boolean enabled) {
+    this.enabled = enabled
+  }
 
-    boolean canTransformResource(FileTreeElement element) { true }
+  @Override
+  boolean canTransformResource(@Nonnull FileTreeElement element) { return true }
 
-    void transform(TransformerContext context) {}
+  @Override
+  void transform(@Nonnull TransformerContext context) {}
 
-    boolean hasTransformedResource() { true }
+  @Override
+  boolean hasTransformedResource() { return true }
 
-    void modifyOutputStream(ZipOutputStream jos, boolean preserveFileTimestamps) {}
+  @Override
+  void modifyOutputStream(@Nonnull ZipOutputStream os, boolean preserveFileTimestamps) {}
 }
 
 tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar) {
-  transform(new MyTransformer(enabled: true))
+  transform(new MyTransformer(true))
 }
 ```
 
@@ -186,11 +203,9 @@ It must be added using the [`transform`](https://gradleup.com/shadow/api/com/git
 
 ```groovy
 // Appending a XML File
-import com.github.jengelman.gradle.plugins.shadow.transformers.XmlAppendingTransformer
-
 tasks.named('shadowJar', com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar) {
-  transform(XmlAppendingTransformer.class) {
+  transform(com.github.jengelman.gradle.plugins.shadow.transformers.XmlAppendingTransformer.class) {
     resource = 'properties.xml'
   }
 }
-```
+```