@DisplayName("Decode Method Tests")
    class DecodeMethodTests {

        @Test
        @DisplayName("Should decode buffer with typical values correctly")
        void shouldDecodeBufferWithTypicalValues() throws SMBProtocolDecodingException {
            // Given - prepare buffer with typical file system values
            ByteBuffer buffer = ByteBuffer.allocate(24);
            buffer.order(ByteOrder.LITTLE_ENDIAN);

    @DisplayName("Decode Method Tests")
    class DecodeMethodTests {

        @Test
        @DisplayName("Should decode buffer with typical values correctly")
        void shouldDecodeBufferWithTypicalValues() throws SMBProtocolDecodingException {
            // Given - prepare buffer with typical file system values
            ByteBuffer buffer = ByteBuffer.allocate(32);
            buffer.order(ByteOrder.LITTLE_ENDIAN);

	//
	// Note: The size of the security token that STS APIs return is not fixed. We
	// strongly recommend that you make no assumptions about the maximum size. As
	// of this writing, the typical size is less than 4096 bytes, but that can vary.
	// Also, future updates to AWS might require larger sizes.
	Credentials auth.Credentials `xml:",omitempty"`

            assertEquals(buffer2[i], buffer3[i], "Mismatch at position " + i);
        }
    }

    @Test
    @DisplayName("Test with typical Windows pipe name format")
    void testWithTypicalWindowsPipeName() {
        // Test with typical Windows named pipe format
        String pipeName = "\\pipe\\TestPipe";
        FsctlPipeWaitRequest request = new FsctlPipeWaitRequest(pipeName, 30000L);

        // TODO: Staging directory should be a part of the Javadocs extension
        // TODO: Pull out more of this configuration into the extension if it makes sense
        // TODO: in a typical project, this may need to be the regular javadoc task vs javadocAll

        var groovyPackageListBucket = project.getConfigurations().dependencyScope("groovyPackageListBucket");

     * Reads an entry from an input stream. A typical entry looks like this:
     *
     * ```
     * http://google.com/foo
     * GET
     * 2
     * Accept-Language: fr-CA
     * Accept-Charset: UTF-8
     * HTTP/1.1 200 OK
     * 3
     * Content-Type: image/png
     * Content-Length: 100
     * Cache-Control: max-age=600
     * ```
     *
     * A typical HTTPS file looks like this:
     *

    }

    @Test
    @DisplayName("EmptyIterator should follow Iterator contract for empty collections")
    void testIteratorContract() {
        // Given - typical Iterator usage pattern

        // When & Then - verify empty collection behavior
        assertFalse(emptyIterator.hasNext(), "Empty iterator should have no next element");

        File file = cos.getFile();
        assertTrue(file.exists());
        cos.close();
    }

    @Test
    public void testLargeData() throws IOException {
        // Test with large data exceeding typical threshold
        ContentOutputStream cos = new ContentOutputStream(100, Curl.tmpDir);
        byte[] largeData = new byte[500];
        for (int i = 0; i < largeData.length; i++) {

            // Note: In real implementation, free > capacity might be invalid,
            // but interface doesn't enforce this constraint
        }

        @Test
        @DisplayName("Should handle typical file system sizes")
        void shouldHandleTypicalFileSystemSizes() {
            // Test common file system sizes
            long[] typicalSizes = { 1024L * 1024L * 1024L, // 1 GB

        when(messageBlock.getCommand()).thenReturn(command);
        when(messageBlock.getDigest()).thenReturn(digest);
        when(messageBlock.getResponse()).thenReturn(response);

        // When - simulate a typical usage sequence
        messageBlock.setMid(mid);
        messageBlock.setCommand(command);
        messageBlock.setUid(uid);
        messageBlock.setSessionId(sessionId);
        messageBlock.setExtendedSecurity(true);