/*
    * Licensed to the Apache Software Foundation (ASF) under one
    * or more contributor license agreements.  See the NOTICE file
    * distributed with this work for additional information
    * regarding copyright ownership.  The ASF licenses this file
    * to you under the Apache License, Version 2.0 (the
    * "License"); you may not use this file except in compliance
    * with the License.  You may obtain a copy of the License at
    *
   *   http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing,
   * software distributed under the License is distributed on an
   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   * KIND, either express or implied.  See the License for the
   * specific language governing permissions and limitations
   * under the License.
   */
  package org.apache.maven.artifact;
  
  import java.io.File;
  import java.util.Collection;
  import java.util.List;
  import java.util.regex.Pattern;
  
  import org.apache.maven.artifact.handler.ArtifactHandler;
  import org.apache.maven.artifact.metadata.ArtifactMetadata;
  import org.apache.maven.artifact.repository.ArtifactRepository;
  import org.apache.maven.artifact.resolver.filter.ArtifactFilter;
  import org.apache.maven.artifact.versioning.ArtifactVersion;
  import org.apache.maven.artifact.versioning.OverConstrainedVersionException;
  import org.apache.maven.artifact.versioning.VersionRange;
  
  /**
   * Maven Artifact interface. Notice that it mixes artifact definition concepts (groupId, artifactId, version)
   * with dependency information (version range, scope).
   */
  public interface Artifact extends Comparable<Artifact> {
  
      /**
       * @deprecated The use of the {@code RELEASE} version is discouraged because it results
       * in non-reproducible builds and exposes projects to supply chain attacks.
       * Use explicit versions instead.
       */
      @Deprecated(since = "4.0.0")
      String RELEASE_VERSION = "RELEASE";
  
      /**
       * @deprecated The use of the {@code LATEST} version is discouraged because it results
       * in non-reproducible builds and exposes projects to supply chain attacks.
       * Use explicit versions instead.
       */
      @Deprecated(since = "4.0.0")
      String LATEST_VERSION = "LATEST";
  
      String SNAPSHOT_VERSION = "SNAPSHOT";
  
      Pattern VERSION_FILE_PATTERN = Pattern.compile("^(.*)-(\\d{8}\\.\\d{6})-(\\d+)$");
  
      // TODO into artifactScope handler
  
      String SCOPE_COMPILE = "compile";
  
      String SCOPE_COMPILE_PLUS_RUNTIME = "compile+runtime";
  
      String SCOPE_TEST = "test";
  
      String SCOPE_RUNTIME = "runtime";
  
      String SCOPE_RUNTIME_PLUS_SYSTEM = "runtime+system";
  
      String SCOPE_PROVIDED = "provided";
  
      String SCOPE_SYSTEM = "system";
  
      String SCOPE_IMPORT = "import"; // Used to import dependencyManagement dependencies
  
      String getGroupId();
  
      String getArtifactId();
  
      String getVersion();
  
      void setVersion(String version);
  
      String getScope();
  
      String getType();
  
      String getClassifier();
  
      boolean hasClassifier();
  
      File getFile();
  
      void setFile(File destination);
  
      String getBaseVersion();
  
     void setBaseVersion(String baseVersion);
 
     String getId();
 
     String getDependencyConflictId();
 
     void addMetadata(ArtifactMetadata metadata);
 
     Collection<ArtifactMetadata> getMetadataList();
 
     void setRepository(ArtifactRepository remoteRepository);
 
     ArtifactRepository getRepository();
 
     void updateVersion(String version, ArtifactRepository localRepository);
 
     String getDownloadUrl();
 
     void setDownloadUrl(String downloadUrl);
 
     ArtifactFilter getDependencyFilter();
 
     void setDependencyFilter(ArtifactFilter artifactFilter);
 
     ArtifactHandler getArtifactHandler();
 
     List<String> getDependencyTrail();
 
     void setDependencyTrail(List<String> dependencyTrail);
 
     void setScope(String scope);
 
     VersionRange getVersionRange();
 
     void setVersionRange(VersionRange newRange);
 
     void selectVersion(String version);
 
     void setGroupId(String groupId);
 
     void setArtifactId(String artifactId);
 
     boolean isSnapshot();
 
     void setResolved(boolean resolved);
 
     boolean isResolved();
 
     void setResolvedVersion(String version);
 
     void setArtifactHandler(ArtifactHandler handler);
 
     boolean isRelease();
 
     void setRelease(boolean release);
 
     List<ArtifactVersion> getAvailableVersions();
 
     void setAvailableVersions(List<ArtifactVersion> versions);
 
     boolean isOptional();
 
     void setOptional(boolean optional);
 
     ArtifactVersion getSelectedVersion() throws OverConstrainedVersionException;
 
     boolean isSelectedVersionKnown() throws OverConstrainedVersionException;
 }