assertNotNull(
        rootLocaleFormat("%s must be annotated with @TesterAnnotation.", annotationClass),
        annotationClass.getAnnotation(TesterAnnotation.class));
    Retention retentionPolicy = annotationClass.getAnnotation(Retention.class);
    assertNotNull(
        rootLocaleFormat("%s must have a @Retention annotation.", annotationClass),
        retentionPolicy);
    assertEquals(

 * @since 20.0
 */
@Beta
public interface MutableValueGraph<N, V> extends ValueGraph<N, V> {

  /**
   * Adds {@code node} if it is not already present.
   *
   * <p><b>Nodes must be unique</b>, just as {@code Map} keys must be. They must also be non-null.
   *
   * @return {@code true} if the graph was modified as a result of this call
   */
  @CanIgnoreReturnValue
  boolean addNode(N node);

  /**

     *            A disposable resource. Must not be {@literal null}.
     */
    public static synchronized void addFirst(final Disposable disposable) {
        assertArgumentNotNull("disposable", disposable);
        disposables.addFirst(disposable);
    }

    /**
     * Unregisters a disposable resource.
     *
     * @param disposable
     *            A disposable resource. Must not be {@literal null}.
     */

     *
     * @param rawClass
     *            The raw class. Must not be {@literal null}.
     */
    public ParameterizedClassDescImpl(final Class<?> rawClass) {
        assertArgumentNotNull("rawClass", rawClass);

        this.rawClass = rawClass;
    }

    /**
     * Constructs an instance.
     *
     * @param rawClass
     *            The raw class. Must not be {@literal null}.
     * @param arguments

     * For example, resolves "1.0-SNAPSHOT" to "1.0-20090208.132618-23".
     *
     * @param session The repository session, must not be {@code null}.
     * @param artifactCoordinates The artifact coordinates for which the version needs to be resolved, must not be {@code null}
     * @return The version result, never {@code null}.
     * @throws VersionResolverException If the metaversion could not be resolved.
     */

package zip

import (
	"compress/flate"
	"errors"
	"io"
	"sync"
)

// A Compressor returns a new compressing writer, writing to w.
// The WriteCloser's Close method must be used to flush pending data to w.
// The Compressor itself must be safe to invoke from multiple goroutines
// simultaneously, but each returned writer will be used only by
// one goroutine at a time.
type Compressor func(w io.Writer) (io.WriteCloser, error)

     *
     * @param session The session to use, must not be {@code null}.
     * @param local The local repository, must not be {@code null}.
     * @param artifact The artifact for which to determine the path, must not be {@code null}.
     * @param remote – The source repository of the artifact, must not be {@code null}.
     * @return The path, relative to the local repository's base directory.
     */

        supplied[0] = 1;
        supplied[1] = 2;

        // Release must not throw and must zero the supplied array
        assertDoesNotThrow(() -> impl.releaseBuffer(supplied));
        for (byte value : supplied) {
            assertEquals(0, value, "Released buffer must be zeroed even if not cached");
        }

        // Since cache cannot store, getBuffer must create a new buffer of configured size
        byte[] got = impl.getBuffer();

     *
     * @param path
     *            The file path. Must not be {@literal null} or empty.
     * @param encoding
     *            The encoding. Must not be {@literal null} or empty.
     * @return The text read from the file.
     */
    public static String readText(final String path, final String encoding) {
        assertArgumentNotEmpty("path", path);

  val decoded = Punycode.decode(bufferA.readUtf8()) ?: return null

  // 4.1 Validate.

  // Must be NFC.
  if (decoded != normalizeNfc(decoded)) return null

  // TODO: Must not begin with a combining mark.
  // TODO: Each character must be 'valid' or 'deviation'. Not mapped.
  // TODO: CheckJoiners from IDNA 2008
  // TODO: CheckBidi from IDNA 2008, RFC 5893, Section 2.