*/
    public abstract void invalidate();

    /**
     * Generate local key for this memory region
     *
     * @return local key
     */
    protected abstract int generateLocalKey();

    /**
     * Generate remote key for this memory region
     *
     * @return remote key
     */
    protected abstract int generateRemoteKey();

// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//

      generator.addSampleInstances((Class) entry.getKey(), entry.getValue());
    }
    return generator;
  }

  private static @Nullable Object generateDummyArg(Parameter param, FreshValueGenerator generator)
      throws ParameterNotInstantiableException {
    if (isNullable(param)) {
      return null;
    }
    Object arg = generator.generateFresh(param.getType());

     * @return true if the thumbnail was successfully generated, false otherwise
     */
    boolean generate(String thumbnailId, File outputFile);

    /**
     * Checks if this generator can handle the given document.
     * @param docMap The document map containing metadata.
     * @return True if this generator can handle the document, false otherwise.
     */
    boolean isTarget(Map<String, Object> docMap);

    /**

    }

    // Test offer with valid generator
    public void test_offer_withValidGenerator() {
        TestThumbnailGenerator generator = new TestThumbnailGenerator();
        generator.available = true;
        generator.target = true;
        generator.task = new Tuple3<>("generator1", "docid1", "path1");
        thumbnailManager.add(generator);

        Map<String, Object> docMap = new HashMap<>();

  public static <E> QueueTestSuiteBuilder<E> using(TestQueueGenerator<E> generator) {
    return new QueueTestSuiteBuilder<E>().usingGenerator(generator);
  }

  private boolean runCollectionTests = true;

  /**
   * Specify whether to skip the general collection tests. Call this method when testing a

    checkArgument(buckets > 0, "buckets must be positive: %s", buckets);
    LinearCongruentialGenerator generator = new LinearCongruentialGenerator(input);
    int candidate = 0;
    int next;

    // Jump from bucket to bucket until we go out of range
    while (true) {
      next = (int) ((candidate + 1) / generator.nextDouble());
      if (next >= 0 && next < buckets) {
        candidate = next;
      } else {

        emptyInstanceGenerated.put(type.getType(), freshness.get());
        return emptyInstance;
      }
    }
    Method generate = GENERATORS.get(rawType);
    if (generate != null) {
      ImmutableList<Parameter> params = Invokable.from(generate).getParameters();
      List<Object> args = Lists.newArrayListWithCapacity(params.size());
      TypeVariable<?>[] typeVars = rawType.getTypeParameters();

        return null;
    }

    /**
     * Adds a thumbnail generator to the manager.
     *
     * @param generator the thumbnail generator to add
     */
    public void add(final ThumbnailGenerator generator) {
        if (generator.isAvailable()) {
            if (logger.isDebugEnabled()) {
                logger.debug("{} is available.", generator.getName());
            }
            generatorList.add(generator);

import org.jspecify.annotations.Nullable;

/**
 * The subject-generator interface accepted by Collection testers, for testing a Collection at one
 * particular {@link CollectionSize}.
 *
 * <p>This interface should not be implemented outside this package; {@link
 * PerCollectionSizeTestSuiteBuilder} constructs instances of it from a more general {@link
 * TestCollectionGenerator}.
 *
 * @author George van den Driessche
 */