* @throws IllegalArgumentException if {@code k < 0} or {@code k > Integer.MAX_VALUE / 2}
   */
  public static <T extends @Nullable Object> TopKSelector<T> least(
      int k, Comparator<? super T> comparator) {
    return new TopKSelector<>(comparator, k);
  }

  /**
   * Returns a {@code TopKSelector} that collects the greatest {@code k} elements added to it,

                newEntry.setLink("new-link-" + i);
                newEntry.replaceCache();
            }

            // Verify replacements
            assertEquals(10, cache.size());
            for (int i = 0; i < 5; i++) {
                DfsReferralDataInternal entry = cache.get("key-" + i);
                assertEquals("new-link-" + i, entry.getLink());
            }
        }

 * meaningful error messages for troubleshooting.
 */
public class SearchEngineClientException extends FessSystemException {

    private static final long serialVersionUID = 1L;

    /**
     * Constructs a new SearchEngineClientException with the specified message and cause.
     *
     * @param message the detail message explaining the exception
     * @param cause   the underlying cause of the exception
     */

    @Resource
    protected FessConfig fessConfig;

    /**
     * Adds a URL to a user's favorite list.
     * This method looks up the user by their code and creates a new favorite log entry
     * using the provided lambda function to populate the favorite log data.
     *
     * @param userCode the unique code identifying the user

   */
  static BigInteger randomNonNegativeBigInteger(int numBits) {
    int digits = RANDOM_SOURCE.nextInt(numBits);
    if (digits == 0) {
      return new BigInteger(1, RANDOM_SOURCE);
    } else {
      return new BigInteger(digits, RANDOM_SOURCE).setBit(digits);
    }
  }

  /**
   * Equivalent to calling randomPositiveBigInteger(numBits) and then flipping the sign with 50%
   * probability.

        List<MavenOptions> o = options.stream().filter(Objects::nonNull).toList();
        if (o.isEmpty()) {
            throw new IllegalArgumentException("No options specified (or all were null)");
        } else if (o.size() == 1) {
            return o.get(0);
        } else {
            return new LayeredMavenOptions<>(o);
        }
    }

    protected LayeredMavenOptions(List<O> options) {
        super(options);
    }

 */
public class CharMappingCreator extends DictionaryCreator {
    private static final Logger logger = LogManager.getLogger(CharMappingCreator.class);

    /**
     * Constructs a new CharMappingCreator with the mapping file pattern.
     */
    public CharMappingCreator() {
        super("mapping.*\\.txt");
    }

    /**
     * Registers this creator with the dictionary manager after construction.

    this.inetSocketAddress = (InetSocketAddress) endpoint;
    super.connect(new UnixSocketAddress(path), 0);
  }

  @Override public void connect(SocketAddress endpoint, int timeout) throws IOException {
    this.inetSocketAddress = (InetSocketAddress) endpoint;
    super.connect(new UnixSocketAddress(path), timeout);
  }

  @Override public InetAddress getInetAddress() {

class OrArtifactFilterTest {

    private ArtifactFilter newSubFilter() {
        return artifact -> false;
    }

    @Test
    void testEquals() {
        OrArtifactFilter filter1 = new OrArtifactFilter();

        OrArtifactFilter filter2 = new OrArtifactFilter(Arrays.asList(newSubFilter()));

        assertFalse(filter1.equals(null), "Expected " + filter1 + " to not equal " + null);

                    addRule(KotlinModifiersBreakingChangeRule, ruleParams)
                    addRule(JApiChangeStatus.NEW, IncubatingMissingRule, ruleParams)
                    addRule(JApiChangeStatus.NEW, SinceAnnotationRule, ruleParams)
                    addRule(JApiChangeStatus.NEW, NewIncubatingAPIRule, ruleParams)

                    addSetupRule(AcceptedRegressionsRuleSetup, [acceptedApiChanges: acceptedChanges])