import org.jspecify.annotations.Nullable;

/**
 * A class that can supply objects of a single type; a pre-Java-8 version of {@link
 * java.util.function.Supplier java.util.function.Supplier}. Semantically, this could be a factory,
 * generator, builder, closure, or something else entirely. No guarantees are implied by this
 * interface.
 *
 * <p>The {@link Suppliers} class provides common suppliers and related utilities.
 *

// each authentication attempt.
type XDGSCRAMClient struct {
	*scram.Client
	*scram.ClientConversation
	scram.HashGeneratorFcn
}

// Begin constructs a SCRAM client component based on a given hash.Hash
// factory receiver.  This constructor will normalize the username, password
// and authzID via the SASLprep algorithm, as recommended by RFC-5802.  If
// SASLprep fails, the method returns an error.

```

### Gradle Dependency
```gradle
implementation 'org.codelibs:corelib:0.7.0'
```

## 📖 Usage Examples

### Bean Utilities
```java
import org.codelibs.core.beans.*;
import org.codelibs.core.beans.factory.BeanDescFactory;
import org.codelibs.core.beans.util.BeanUtil;
import org.codelibs.core.beans.util.CopyOptions;

// Bean metadata introspection
BeanDesc beanDesc = BeanDescFactory.getBeanDesc(MyBean.class);

   * parameter.
   */
  private fun sampleValuesMap(): Map<Class<*>, Any> {
    TestValueFactory().use { factory ->
      val address = factory.newAddress("a")
      val route = factory.newRoute(address)
      val pool = factory.newConnectionPool()
      val url = "https://example.com/".toHttpUrl()
      val request = Request(url = url)
      val response =
        Response

    ms.add(Color.RED, 2);

    Set<Object> uniqueEntries = Sets.newIdentityHashSet();
    uniqueEntries.addAll(ms.entrySet());
    assertEquals(3, uniqueEntries.size());
  }

  // Wrapper of EnumMultiset factory methods, because we need to skip create(Class).
  // create(Enum1.class) is equal to create(Enum2.class) but testEquals() expects otherwise.
  // For the same reason, we need to skip create(Iterable, Class).

            }
        }
    }
    afterEvaluate {
        // Without afterEvaluate, configurations.all runs before the configurations' roles are set.
        // This is yet another reason we need configuration factory methods.
        // workaround for https://github.com/gradle/gradle/issues/12459
        // note: constraints can't be used here because they end up in gradle module metadata

   * collections. If not specified, the collection tests will examine the value returned by {@link
   * Object#toString}.
   */
  NON_STANDARD_TOSTRING,

  /**
   * Indicates that the constructor or factory method of a collection, usually an immutable set,
   * throws an {@link IllegalArgumentException} when presented with duplicate elements instead of

  public void testNewLinkedListEmpty() {
    @SuppressWarnings("UseCollectionConstructor") // test of factory method
    LinkedList<Integer> list = Lists.newLinkedList();
    assertEquals(emptyList(), list);
  }

  public void testNewLinkedListFromCollection() {
    @SuppressWarnings("UseCollectionConstructor") // test of factory method
    LinkedList<Integer> list = Lists.newLinkedList(SOME_COLLECTION);

  private Iterable<LoadingCache<Object, Object>> caches() {
    // lots of different ways to configure a LoadingCache
    CacheBuilderFactory factory = cacheFactory();
    return Iterables.transform(
        factory.buildAllPermutations(),
        new Function<CacheBuilder<Object, Object>, LoadingCache<Object, Object>>() {
          @Override

    fun match(kmProperty: KmProperty): Boolean
    fun match(kmFunction: KmFunction): Boolean
    fun match(kmPropertyAccessorAttributes: KmPropertyAccessorAttributes): Boolean

    companion object Factory {
        fun visibility(visibility: Visibility): AttributePredicate = object: AttributePredicate {
            override fun match(kmClass: KmClass) = kmClass.visibility == visibility