SmbSessionImpl session = spy(newSession());
        when(configuration.getLogonShare()).thenReturn("LOGON$");

        // Mock tree and ensure it is returned by getSmbTree
        SmbTreeImpl tree = mock(SmbTreeImpl.class);
        doReturn(tree).when(session).getSmbTree(eq("LOGON$"), isNull());

        // Act
        session.treeConnectLogon();

 * </pre>
 */
public abstract class AbstractUpgradeStrategy implements UpgradeStrategy {

    /**
     * Template method that handles common logging and error handling.
     * Subclasses implement the actual upgrade logic in doApply().
     */
    @Override
    public final UpgradeResult apply(UpgradeContext context, Map<Path, Document> pomMap) {
        context.info(getDescription());
        context.indent();

        try {

Use dependencies when the logic can't be declared in Pydantic validation, depends on external resources, needs cleanup (with `yield`), or is shared across endpoints.

Apply shared dependencies at the router level via `dependencies=[Depends(...)]`.

## Async vs Sync *path operations*

        if (!logList.isEmpty()) {
            final String logId = (String) logList.get(0).get("id");
            response = checkMethodBase(new HashMap<>()).get("/api/admin/crawlinginfo/log/" + logId).asString();
            jsonPath = JsonPath.from(response);
            assertEquals(0, jsonPath.getInt("response.status"));
            assertEquals(logId, jsonPath.getString("response.log.id"));

        when(tree.unwrap(SmbTreeInternal.class)).thenReturn(tree);

        doReturn(mockTransport).when(poolSpy).getSmbTransport(eq(ctx), eq(address), anyInt(), eq(false), anyBoolean());

        // When: Perform logon
        poolSpy.logon(ctx, address);

        // Then: Should connect to IPC$ share
        verify(tree).connectLogon(ctx);
    }

    @Test
    @DisplayName("Should sort addresses by fail count and failover")

    }
}

include("architecture-docs")
include("build-environment")
include("configuration-cache-compatibility")
include("default-settings-plugins")
include("version-catalogs")

This may help you better understand and contribute to Gradle.

### Debugging Gradle

See the [Debugging Gradle](./contributing/Debugging.md) guide for tips on debugging Gradle.

If you made changes to build logic in the `build-logic` included build, you can run its tests by executing `./gradlew :build-logic:check`.

### Fixing DCO failures/Signing Off Commits After Submitting a Pull Request

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

/**
 * Tests for {@link DosError}.  Since {@link DosError} only contains
 * constants, the tests exercise the data and small helper logic in this
 * test class.
 */
public class DosErrorTest {
    private static Optional<Integer> findNtStatus(int dosErrorCode) {

 * interaction with {@link SmbFile} instances. The tests make heavy use of
 * Mockito to guarantee that implementation classes do not inadvertently
 * bypass the filter logic.
 */
public class SmbFileFilterTest {

    /**
     * A minimal implementation that accepts every {@link SmbFile}.
     */
    private final SmbFileFilter ALWAYSACTIVE = new SmbFileFilter() {
        @Override

        assertEquals("Service", result[0]);
        assertEquals("ServiceImpl", result[1]);
        assertEquals("Facade", result[2]);
        assertEquals("FacadeImpl", result[3]);
        assertEquals("Logic", result[4]);
        assertEquals("LogicImpl", result[5]);
    }

    // Test toBeDisposable with null process
    @Test
    public void test_toBeDisposable_nullProcess() {
        // Should not throw exception