And it will be annotated / documented accordingly too.

## Nested Models { #nested-models }

Each attribute of a Pydantic model has a type.

But that type can itself be another Pydantic model.

So, you can declare deeply nested JSON "objects" with specific attribute names, types and validations.

All that, arbitrarily nested.

### Define a submodel { #define-a-submodel }

        @Test
        @DisplayName("Should initialize remaining to zero")
        void testInitialRemainingValue() {
            assertEquals(0, response.getRemaining());
        }
    }

    @Nested
    @DisplayName("Getter Tests")
    class GetterTests {

        @Test
        @DisplayName("Should get count value")
        void testGetCount() {
            // Initial value should be 0

        }
    }

    // Helper method to create a mock SmbFile for more advanced tests if needed
    private SmbFile createMockSmbFile(String url, NtlmPasswordAuthentication auth) throws MalformedURLException {
        // This is complex due to the class structure. A better approach would be
        // to refactor SmbFile to be more testable (e.g., dependency injection).

        }

        @Test
        @DisplayName("Test TID property")
        void testTidProperty() {
            assertEquals(0xFFFF, testBlock.getTid());
            testBlock.setTid(0x1234);
            assertEquals(0x1234, testBlock.getTid());
        }

        @Test
        @DisplayName("Test PID property")
        void testPidProperty() {
            testBlock.setPid(0x5678);

        @DisplayName("Should initialize totalBytesWritten to zero")
        void testInitialTotalBytesWrittenValue() {
            assertEquals(0, response.getTotalBytesWritten());
        }
    }

    @Nested
    @DisplayName("Getter Tests")
    class GetterTests {

        @Test
        @DisplayName("Should get chunksWritten value")
        void testGetChunksWritten() {
            // Initial value should be 0

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Nested;
import org.junit.jupiter.api.Test;
import org.mockito.Mockito;

import jcifs.smb.SmbPipeHandleInternal;

/**
 * Unit tests for a class that implements the {@link SmbPipeHandle} interface.
 * This test class uses a mock implementation to ensure any class adhering to the
 * SmbPipeHandle contract is tested for correctness.
 */
public class SmbPipeHandleTest {

    }

    @ParameterizedTest(name = "Int getter {2} returns {1}")
    @MethodSource("intGetterProvider")
    void intGetters_edgeCases(IntGetter getter, int value, String label) {
        // Arrange
        FileEntry e = new TestFileEntry("n", value, value, 0L, 0L, 0L, 0L, value);
        // Act
        int actual = getter.apply(e);
        // Assert
        assertEquals(value, actual, label);
    }

            assertTrue(bytesRead > 0);
            assertEquals(numReferrals, response.getDfsResponse().getNumReferrals());
        }
    }

    @Nested
    @DisplayName("DfsResponse Getter Tests")
    class DfsResponseGetterTests {

        @Test
        @DisplayName("Should return same DfsResponse instance")
        void testGetDfsResponseReturnsSameInstance() {

        void testGetTid() {
            // Given
            when(mockResponse.getTid()).thenReturn(12345);

            // When
            int tid = mockResponse.getTid();

            // Then
            assertEquals(12345, tid, "Should return the configured tree ID");
            verify(mockResponse).getTid();
        }

        @Test
        @DisplayName("Should return service type")

                    "Should throw DcerpcException for missing endpoint");
        }
    }

    @Nested
    @DisplayName("Getter Method Tests")
    class GetterTests {

        @Test
        @DisplayName("Should return correct transport context")
        void testGetTransportContext() throws Exception {