Allow repos to provide maven-metadata.xml files to list known versions.

1 files changed, 15 insertions, 0 deletions

diff --git a/src/api/java/com/amadornes/artifactural/api/repository/Repository.java b/src/api/java/com/amadornes/artifactural/api/repository/Repository.java
index da8aa69..2e1de79 100644
--- a/src/api/java/com/amadornes/artifactural/api/repository/Repository.java
+++ b/src/api/java/com/amadornes/artifactural/api/repository/Repository.java
@@ -19,6 +19,8 @@
 
 package com.amadornes.artifactural.api.repository;
 
+import java.io.File;
+
 import com.amadornes.artifactural.api.artifact.Artifact;
 import com.amadornes.artifactural.api.artifact.ArtifactIdentifier;
 
@@ -26,4 +28,17 @@ public interface Repository {
 
     Artifact getArtifact(ArtifactIdentifier identifier);
 
+    /**
+     * Returns a file in maven-metadata.xml format for the specified artifact,
+     * this is used by gradle to list all known versions, so that it can resolve wildcard
+     * dependencies such as foo:bar:1.+
+     *
+     * @param group Group
+     * @param name Artifact name
+     * @return maven-metadata.xml file listing all versions of the artifact this repo can provide. Or null if you don't want to list any.
+     */
+    default File getMavenMetadata(String group, String name) {
+        return null;
+    }
+
 }