TestCharSource okSource = new TestCharSource(STRING);
      assertThrows(IOException.class, () -> okSource.copyTo(new TestCharSink(option)));
      // ensure reader was closed IF it was opened (depends on implementation whether or not it's
      // opened at all if sink.newWriter() throws).
      assertTrue(
          "stream not closed when copying to sink with option: " + option,

			// avoiding S3’s heuristic-driven issues.
			//
			// For MinIO developers, decode S3 metadata with mime.WordDecoder, validate outputs,
			// report encoding bugs to AWS, and use ASCII-only metadata to ensure reliable S3 API
			// compatibility.
			if needsMimeEncoding(v) {
				// see https://github.com/golang/go/blob/release-branch.go1.24/src/net/mail/message.go#L325
				if strings.ContainsAny(v, "\"#$%&'(),.:;<>@[]^`{|}~") {

- **Code of Conduct**: Gradle enforces a [Code of Conduct](https://gradle.org/conduct/) to ensure a welcoming and supportive community for all contributors.

---

### 🔗 **Additional Resources**

To make the most out of Gradle, take advantage of these additional resources:

saveddir=`pwd`

MAVEN_HOME=`dirname "$PRG"`/..

# make it fully qualified
MAVEN_HOME=`cd "$MAVEN_HOME" && pwd`

cd "$saveddir"

CLASSWORLDS_CONF="$MAVEN_HOME/bin/m2.conf"

# For Cygwin and MinGW, ensure paths are in Unix format before anything is touched
if $cygwin || $mingw ; then
  [ -n "$JAVA_HOME" ] &&
    JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
fi

if [ -n "$JAVA_HOME" ] ; then

            throw new CrawlingAccessException("Failed to parse file ownership attributes: file=" + file.getAbsolutePath(), e);
        }
    }

    /**
     * Preprocesses a URI to ensure it's in the correct format for file system access.
     *
     * @param uri the URI to preprocess
     * @return the preprocessed URI
     * @throws CrawlerSystemException if the URI is empty
     */

            inOrder.verify(mockCtx).verifyMIC(any(byte[].class), any(byte[].class));
            inOrder.verify(mockCtx).isMICAvailable();
            inOrder.verify(mockCtx).dispose();

            // Also ensure no unexpected calls
            verifyNoMoreInteractions(mockCtx);
        }

        @Test
        @DisplayName("Never calculates MIC when integrity unsupported")

        // Utility class - no instances allowed
    }

    /**
     * Determines if the given address string represents an IPv6 address.
     * This method validates the address using InetAddress to ensure it's a valid IPv6 address.
     *
     * @param address the IP address string to check
     * @return true if the address is a valid IPv6 address, false otherwise
     */

 *   <li>Events for the different listeners are dispatched concurrently.
 *   <li>All events for a given listener dispatch on the provided executor.
 *   <li>It is easy for the user to ensure that listeners are never invoked while holding locks.
 * </ul>
 *
 * The last point is subtle. Often the observable object will be managing its own internal state

    void testTreeConnectLogonValid() throws Exception {
        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();

The client does not wait for the remote handler to finish before returning.
Returning any error will also cancel the stream remotely.

CAREFUL: When utilizing two-way communication, it is important to ensure that the remote handler is not blocked on a send.
If the remote handler is blocked on a send, and the client is trying to send without the remote receiving,
the operation would become deadlocked if the channels are full.