*
 * @since 4.0.0
 */
@Experimental
public interface Options {
    /** Constant indicating that the options source is the command-line interface. */
    String SOURCE_CLI = "CLI";

    /**
     * Returns a simple designator of the options source, such as "cli", "maven.conf", etc.
     *
     * @return a string representing the source of the options
     */
    @Nonnull
    String source();

    /**

    /**
     * Locate and parse the model in the specified directory.
     * This is equivalent to {@code locate(dir).map(s -> parse(s, options))}.
     *
     * @param dir the directory to locate the pom for, never {@code null}
     * @param options possible parsing options, may be {@code null}
     * @return an optional parsed {@link Model} or {@code null} if none could be found

        final Options options = new Options();

        final CmdLineParser parser = new CmdLineParser(options);
        try {
            parser.parseArgument(args);
        } catch (final CmdLineException e) {
            System.err.println(e.getMessage());
            System.err.println("java " + ThumbnailGenerator.class.getCanonicalName() + " [options...] arguments...");

    @Nonnull
    Optional<CIInfo> ciInfo();

    /**
     * Returns the options associated with this invocation request.
     *
     * @return the options optional. It will be absent if {@link #parsingFailed()} return {@code true}.
     */
    @Nonnull
    Optional<Options> options();

    /**
     * This method returns "verbose" option value derived from multiple places: CLI options, but also CI detection,

import java.util.List;
import java.util.Optional;

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.annotations.Nonnull;
import org.apache.maven.api.cli.Options;

/**
 * Defines the options specific to the Maven upgrade tool.
 * This interface extends the general {@link Options} interface, adding upgrade-specific configuration options.
 *
 * @since 4.0.0
 */
@Experimental

        }
        if (this.options == null) {
            this.options = new HashMap<>();
        }
        this.options.put(key, val);
    }

    Object getOption(final String key) {
        if (key.equals("endpoint")) {
            return this.endpoint;
        }
        if (this.options != null) {
            return this.options.get(key);
        }
        return null;
    }

    private Map<String, ?> options;

    /**
     * Initialize a static JAAS configuration with default settings
     */
    public StaticJAASConfiguration() {
        this.options = new HashMap<>();
    }

    /**
     * Initialize a static JAAS configuration with custom settings
     *
     * @param options
     */
    public StaticJAASConfiguration(Map<String, ?> options) {

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.cli.Options;

/**
 * Defines the options specific to the Maven Shell tool.
 * This interface extends the general {@link Options} interface, adding shell-specific configuration options.
 *
 * @since 4.0.0
 */
@Experimental

    options:
        members:
            - chunk_size
            - charset
            - status_code
            - media_type
            - body
            - background
            - raw_headers
            - render
            - init_headers
            - headers
            - set_cookie
            - delete_cookie

::: fastapi.responses.HTMLResponse
    options:
        members:

        }
        if (options == null) {
            options = new HashMap();
        }
        options.put(key, val);
    }

    Object getOption(final String key) {
        if (key.equals("endpoint")) {
            return endpoint;
        }
        if (options != null) {
            return options.get(key);
        }
        return null;
    }

    @Override