*
 * @param <O> the type of {@link Options} used for this request, extending the base {@link Options} interface
 *
 * @since 4.0.0
 */
@Immutable
@Experimental
public interface InvokerRequest<O extends Options> {
    /**
     * The parser request this instance was created from.
     */
    @Nonnull
    ParserRequest parserRequest();

    /**
     * Shorthand for {@link Logger} to use.
     */

    @SuppressWarnings("MethodLength")
    @Override
    public int invoke(ForkedMavenInvokerRequest invokerRequest) throws InvokerException {
        requireNonNull(invokerRequest);
        validate(invokerRequest);

        ArrayList<String> cmdAndArguments = new ArrayList<>();
        cmdAndArguments.add(invokerRequest
                .installationDirectory()
                .resolve("bin")
                .resolve(

 * This interface is responsible for interpreting the command-line input and constructing
 * the appropriate {@link InvokerRequest} object.
 *
 * @param <R> the type of {@link InvokerRequest} produced by this parser, extending {@link InvokerRequest}
 *
 * @since 4.0.0
 */
@Experimental
public interface Parser<R extends InvokerRequest<? extends Options>> {
    /**

            super(invoker, invokerRequest);
        }
    }

    public DefaultLocalMavenInvoker(ProtoLookup protoLookup) {
        super(protoLookup);
    }

    @Override
    protected LocalContext createContext(MavenInvokerRequest<MavenOptions> invokerRequest) {
        return new LocalContext(this, invokerRequest);
    }

    protected LocalContext createContext(MavenInvokerRequest<MavenOptions> invokerRequest) {
        return residentContext
                .computeIfAbsent(getContextId(invokerRequest), k -> new LocalContext(this, invokerRequest))
                .copy(invokerRequest);
    }

    protected String getContextId(MavenInvokerRequest<MavenOptions> invokerRequest) {

 * under the License.
 */
package org.apache.maven.api.cli.mvnenc;

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

/**
 * Represents a request to invoke the Maven encryption tool.
 * This interface extends the general InvokerRequest, specializing it for encryption-related operations.
 *
 * <p>An EncryptInvokerRequest encapsulates all the necessary information needed to perform

 *
 * @since 4.0.0
 */
@Experimental
public interface Invoker<R extends InvokerRequest<? extends Options>> extends AutoCloseable {
    /**
     * Invokes the Maven application using the provided {@link InvokerRequest}.
     * This method is responsible for executing the Maven command or build

     *
     * @param invokerRequest the request containing all necessary information for the Maven invocation
     * @return an integer representing the exit code of the Maven invocation (0 typically indicates success)
     * @throws InvokerException if an error occurs during the Maven invocation process
     */
    @Override
    int invoke(@Nonnull R invokerRequest) throws InvokerException;

            if (context.invokerRequest.options().goals().isEmpty()
                    || context.invokerRequest.options().goals().get().size() != 1) {
                return badGoalsErrorMessage("No goal or multiple goals specified, specify only one goal.", context);
            }

            String goalName = context.invokerRequest.options().goals().get().get(0);

 * under the License.
 */
package org.apache.maven.api.cli.mvn;

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

/**
 * Represents a request to invoke Maven.
 * This interface extends the general {@link InvokerRequest}, specializing it for Maven-specific operations.
 *
 * <p>A {@link MavenInvokerRequest} encapsulates all the necessary information needed to perform