Document wildcard dependency matching in DependencyFilter (#1596)

* Update `excludeDependencyUsingWildcardSyntax`

* Add more examples for `Using Regex Patterns to Filter Dependencies`

Author: Goooler

docs/configuration/dependencies/README.md

@@ -229,7 +229,14 @@ Any of the individual fields can be safely absent and will function as though a
 
 The above code snippet is functionally equivalent to the previous example.
 
-This same pattern can be used for any of the dependency notation fields.
+This same pattern can be used for any of the dependency notation fields. e.g.
+
+- `org.apache.logging.log4j:.*`
+- `org.apache.logging.log4j:log4j.*`
+- `org.apache.logging.log4j:log4j-core:.*`
+- `org.apache.logging.*:log4j-core:.*`
+- `.*:log4j-core:.*`
+- ...
 
 === "Kotlin"
 

src/functionalTest/kotlin/com/github/jengelman/gradle/plugins/shadow/FilteringTest.kt

@@ -8,6 +8,7 @@ import org.junit.jupiter.api.BeforeAll
 import org.junit.jupiter.api.BeforeEach
 import org.junit.jupiter.api.Test
 import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.MethodSource
 import org.junit.jupiter.params.provider.ValueSource
 
 class FilteringTest : BasePluginTest() {
@@ -73,16 +74,17 @@ class FilteringTest : BasePluginTest() {
     commonAssertions()
   }
 
-  @Test
-  fun excludeDependencyUsingWildcardSyntax() {
+  @ParameterizedTest
+  @MethodSource("wildcardDepProvider")
+  fun excludeDependencyUsingWildcardSyntax(wildcard: String) {
     projectScriptPath.appendText(
       """
         dependencies {
           implementation 'my:d:1.0'
         }
         $shadowJar {
           dependencies {
-            exclude(dependency('my:d:.*'))
+            exclude(dependency('$wildcard'))
           }
         }
       """.trimIndent(),
@@ -240,4 +242,16 @@ class FilteringTest : BasePluginTest() {
       )
     }
   }
+
+  private companion object {
+    @JvmStatic
+    fun wildcardDepProvider() = listOf(
+      "my:d",
+      "m.*:d",
+      "my:d:.*",
+      "m.*:d:.*",
+      "m.*:d.*:.*",
+      ".*:d:.*",
+    )
+  }
 }