.gradle
/build
/*/build
/*/*/build
/*/*/*/build
/*/*/*/*/*/build
/**/docs/src/samples/**/build
/**/docs/src/snippets/**/build
/*/internal-android-performance-testing/build-android-libs
test-splits/
/gradle/verification-keyring.gpg

# Kotlin
# ------
.kotlin

# IDEA
# ----
!/.idea
/.idea/*

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package gradlebuild.docs.dsl.docbook;

public interface GenerationListener {
    void warning(String message);

    void start(String context);

    void finish();

- [ ] Ensure that tests pass sanity check: `./gradlew sanityCheck`.
- [ ] Ensure that tests pass locally: `./gradlew <changed-subproject>:quickTest`.

### Reviewing cheatsheet

Before merging the PR, comments starting with 
- ❌ ❓**must** be fixed
- 🤔 💅 **should** be fixed
- 💭 **may** be fixed

internal
fun scrapeRichReport(richReportFile: File): RichReport =

    Jsoup.parse(richReportFile, "UTF-8").run {
        RichReport(
            scrapeMessagesForSeverity("error"),
            scrapeMessagesForSeverity("warning"),
            scrapeMessagesForSeverity("info"),
            scrapeMessagesForSeverity("accepted")
        )
    }


private
fun Document.scrapeMessagesForSeverity(severity: String): List<ReportMessage> =

            // Should not throw exception but log warning
        } catch (Exception e) {
            fail("writeThreadDump should handle invalid paths gracefully: " + e.getMessage());
        }
    }

    @Test
    public void test_writeThreadDump_withNullPath() {
        try {
            ThreadDumpUtil.writeThreadDump(null);
            // Should not throw exception but log warning
        } catch (Exception e) {

                                </div>
                            </div>
                            <div class="card-footer">
                                <button type="button" class="btn btn-warning ${f:h(editableClass)}"
                                        data-toggle="modal" data-target="#confirmToRebuildConfigIndex">
                                    <i class="fa fa-sync" aria-hidden="true"></i>

---

### 🎓 **Learning Resources for Gradle**

Kickstart your Gradle knowledge with courses, guides, and community support tailored to various experience levels:

- **[DPE University Free Courses](https://dpeuniversity.gradle.com/app/catalog)**: A collection of hands-on courses for learning Gradle, complete with project-based tasks to improve real-world skills.

    protected abstract Property<Integer> getPort();

    @Nested
    protected abstract Property<JavaLauncher> getJavaLauncher();

    @TaskAction
    public void startApplication() {
        System.out.println("serving docs at http://localhost:" + getPort().get());
        DeploymentRegistry registry = getDeploymentRegistry();
        JavaApplicationHandle handle = registry.get(getPath(), JavaApplicationHandle.class);
        if (handle == null) {

                if (suite.parent == null) {
                    forEachJavaProcess { pid, _ ->
                        // processes that exist before the test suite execution should
                        // not trigger a warning
                        daemonPids += pid
                    }
                }
            }

            override fun afterSuite(suite: TestDescriptor, result: TestResult) {

        // Verify the ALLOW_UNSEC_BASIC setting is documented with security warnings
        SpnegoAuthenticator authenticator = new SpnegoAuthenticator();
        assertNotNull(authenticator);

        // The security warning comments should guide users to disable this in production
        // This is a compile-time check that the code structure is correct
        assertTrue(true);
    }

    @Test
    public void test_constantsExist() {