}

  public void testInputFutureToString() throws Throwable {
    assertThat(resultFuture.toString()).contains(inputFuture.toString());
  }

  /**
   * Override to return a chaining listenableFuture that returns the result of getSuccessfulResult()
   * when inputFuture returns VALID_INPUT_DATA, and sets the exception to EXCEPTION in all other
   * cases.
   */

name: Enhancement Tracking Issue
description: Provide supporting details for a feature in development
labels: kind/feature
body:
  - type: textarea
    id: feature
    attributes:
      label: What would you like to be added?
      description: |
        Feature requests are unlikely to make progress as issues. Please consider engaging with SIGs on slack and mailing lists, instead.

    return from(CacheBuilderSpec.parse(spec));
  }

  /**
   * Enables lenient parsing. Useful for tests and spec parsing.
   *
   * @return this {@code CacheBuilder} instance (for chaining)
   */
  @GwtIncompatible // To be supported
  @CanIgnoreReturnValue
  CacheBuilder<K, V> lenientParsing() {
    strictParsing = false;
    return this;
  }

  /**

            /*
             * Samba has a tendency to return pathConsumed values so that they consume a trailing slash of the
             * requested path. Normalize this here.
             */
            if (reqPath.charAt(consumed - 1) == '\\') {
                if (log.isDebugEnabled()) {
                    log.debug("Server consumed trailing slash of request path, adjusting");
                }
                dr.pathConsumed--;

     * @param value the context value
     * @return this exception for chaining
     */
    public SmbException withContext(String key, Object value) {
        this.context.put(key, value);
        return this;
    }

    /**
     * Sets a recovery hint for the error
     *
     * @param hint the recovery hint
     * @return this exception for chaining
     */
    public SmbException withRecoveryHint(String hint) {

     * the root URL <code>smb://</code> is also <code>smb://</code>. If this
     * <code>SmbFile</code> refers to a workgroup, server, share, or directory,
     * the name will include a trailing slash '/' so that composing new
     * <code>SmbFile</code>s will maintain the trailing slash requirement.
     *
     * @return The last component of the URL associated with this SMB
     *         resource or <code>smb://</code> if the resource is <code>smb://</code>

     */
    public static ResourceManager getInstance() {
        return INSTANCE;
    }

    /**
     * Register a resource for tracking
     *
     * @param resource the resource to track
     * @return resource ID for tracking
     */
    public String registerResource(AutoCloseable resource) {
        if (resource == null) {

    private final int maxAttemptsPerIp;
    private final int maxGlobalAttemptsPerMinute;
    private final Duration lockoutDuration;
    private final Duration cleanupInterval;

    // Tracking maps
    private final Map<String, AccountAttempts> accountAttempts = new ConcurrentHashMap<>();
    private final Map<String, IpAttempts> ipAttempts = new ConcurrentHashMap<>();

     * The namespace is used to organize and identify crawling activities.
     *
     * @param namespace the namespace identifier for the crawling session
     * @return this CrawlJob instance for method chaining
     */
    public CrawlJob namespace(final String namespace) {
        this.namespace = namespace;
        return this;
    }

    /**
     * Sets the document expiration period in days.

    @Nested
    @DisplayName("doShareEnum early validation")
    class DoShareEnumValidation {

        static Stream<Arguments> invalidShareEnumCases() {
            return Stream.of(
                    // Missing trailing slash -> should complain about directory ending
                    Arguments.of("smb://server/share", "/share", true),
                    // Not a server root -> invalid list operation