import org.apache.maven.api.annotations.Immutable;

/**
 * An {@link Artifact} that has been resolved, i.e. downloaded to the local repository.
 *
 * @since 4.0.0
 */
@Experimental
@Immutable
public interface DownloadedArtifact extends Artifact {

    /**
     * {@return the a path to the file that has been downloaded to the file system}.
     */
    Path getPath();

    /**
     * Returns a collection of resolved artifacts.
     *
     * @return A collection of {@link DownloadedArtifact} instances representing the resolved artifacts.
     */
    @Nonnull
    Collection<DownloadedArtifact> getArtifacts();

    /**
     * Retrieves the file system path associated with a specific artifact.
     *

     *
     * @see org.apache.maven.api.services.ArtifactResolver#resolve(Session, Collection)
     */
    @Nonnull
    DownloadedArtifact resolveArtifact(@Nonnull ArtifactCoordinates coordinates);

    /**
     * Shortcut for {@code getService(ArtifactResolver.class).resolve(...)}.
     *

/**
 * A {@link Dependency} that has been resolved, i.e. downloaded to the local repository.
 *
 * @since 4.0.0
 */
@Experimental
@Immutable

 * Resolving is the process that selects a {@linkplain #getVersion() particular version}
 * and downloads the artifact in the local repository.  This operation returns a {@link DownloadedArtifact}.
 * </p>
 *
 * @since 4.0.0
 */
@Experimental
@Immutable
public interface Artifact {
    /**
     * {@return a unique identifier for this artifact}.

 * that selects a particular version and downloads the artifact into the local repository.
 * The {@link org.apache.maven.api.DownloadedArtifact} sub-interface is used when
 * an artifact has been resolved and the {@link org.apache.maven.api.ProducedArtifact} sub-interface when
 * an artifact is being produced by a project.</p>
 *