* 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>> {
    /**
     * Parses the given Maven arguments to create an InvokerRequest.
     * This is a convenience method that internally creates a ParserRequest using

     */
    @Nonnull
    Optional<Source> locate(@Nonnull Path dir);

    /**
     * Parse the model obtained previously by a previous call to {@link #locate(Path)}.
     *
     * @param source the source to parse, never {@code null}
     * @param options possible parsing options, may be {@code null}
     * @return the parsed {@link Model}, never {@code null}

        assertEquals(incremental, artifactVersion.getIncrementalVersion(), parsed + "check incremental version");
        assertEquals(buildnumber, artifactVersion.getBuildNumber(), parsed + "check build number");
        assertEquals(qualifier, artifactVersion.getQualifier(), parsed + "check qualifier");
        assertEquals(version, artifactVersion.toString(), "check " + version + " string value");
    }

     * @return The deserialized model, never {@code null}.
     * @throws IOException If the model could not be deserialized.
     * @throws ModelParseException If the input format could not be parsed.
     * @deprecated Use {@link #read(Path, Map)} instead.
     */
    @Deprecated
    Model read(File input, Map<String, ?> options) throws IOException, ModelParseException;

    /**

     * @return The deserialized metadata, never {@code null}.
     * @throws IOException If the metadata could not be deserialized.
     * @throws MetadataParseException If the input format could not be parsed.
     */
    Metadata read(File input, Map<String, ?> options) throws IOException, MetadataParseException;

    /**

     * @return The deserialized settings, never {@code null}.
     * @throws IOException If the settings could not be deserialized.
     * @throws SettingsParseException If the input format could not be parsed.
     */
    Settings read(File input, Map<String, ?> options) throws IOException, SettingsParseException;

    /**

     * @return The deserialized toolchains, never {@code null}.
     * @throws IOException If the toolchains could not be deserialized.
     * @throws ToolchainsParseException If the input format could not be parsed.
     */
    PersistedToolchains read(File input, Map<String, ?> options) throws IOException, ToolchainsParseException;

    /**

     * The supplied request may also refer to a single concrete version rather than a version range.
     * In this case though, the result contains simply the (parsed) input version, regardless of the
     * repositories and their contents.
     *
     * @param session the session to use
     * @param artifactCoordinates t
     * @return the version range resolution result

    /**
     * Parses the given ParserRequest to create an EncryptInvokerRequest.
     * This method is responsible for interpreting the contents of the ParserRequest
     * and constructing the appropriate EncryptInvokerRequest object for encryption operations.
     *
     * @param parserRequest the request containing all necessary information for parsing
     * @return the parsed EncryptInvokerRequest

 *
 * @since 4.0.0
 */
@Experimental
public interface MavenParser<R extends MavenInvokerRequest<? extends MavenOptions>> extends Parser<R> {
    /**
     * Parses the given {@link ParserRequest} to create a {@link MavenInvokerRequest}.
     * This method is responsible for interpreting the contents of the ParserRequest
     * and constructing the appropriate {@link MavenInvokerRequest} object for Maven operations.
     *