Make artifacts parameter possible to point at a file (#134)

That is the loaded up. File should contain artifact strings in
expected format, each on new line.

Add ITs for new mojo.

Author: cstamas

it/extension-its/pom.xml

@@ -23,7 +23,7 @@
   <name>${project.groupId}:${project.artifactId}</name>
 
   <properties>
-    <maven39Version>3.9.9</maven39Version>
+    <maven39Version>3.9.10</maven39Version>
     <maven4Version>4.0.0-rc-3</maven4Version>
 
     <!-- We need to skip this on Java lower than 17 (see profiles below) -->

it/extension-its/src/it/check-artifacts-availability-manual-pom/.mvn/extensions.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    Copyright (c) 2023-2024 Maveniverse Org.
+    All rights reserved. This program and the accompanying materials
+    are made available under the terms of the Eclipse Public License v2.0
+    which accompanies this distribution, and is available at
+    https://www.eclipse.org/legal/epl-v20.html
+
+-->
+<extensions>
+    <extension>
+        <groupId>eu.maveniverse.maven.njord</groupId>
+        <artifactId>extension</artifactId>
+        <version>@project.version@</version>
+    </extension>
+</extensions>

it/extension-its/src/it/check-artifacts-availability-manual-pom/README.md

@@ -0,0 +1,3 @@
+# Check Artifacts Availability
+
+Tests njord:check-artifacts-availability.

it/extension-its/src/it/check-artifacts-availability-manual-pom/invoker.properties

@@ -0,0 +1,15 @@
+#
+# Copyright (c) 2023-2024 Maveniverse Org.
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v2.0
+# which accompanies this distribution, and is available at
+# https://www.eclipse.org/legal/epl-v20.html
+#
+
+# from CLI
+invoker.goals.1 = -V -e njord:${project.version}:check-artifacts-availability -DwaitSleep=PT1S -DwaitDelay=PT1S -DwaitTimeout=PT10S "-Dartifacts=junit:junit:jar:4.13.2,junit:junit:pom:4.13.2" -DremoteRepository=central::https://repo.maven.apache.org/maven2/
+# from file
+invoker.goals.2 = -V -e njord:${project.version}:check-artifacts-availability -DwaitSleep=PT1S -DwaitDelay=PT1S -DwaitTimeout=PT10S  -Dartifacts=list.txt -DremoteRepository=central::https://repo.maven.apache.org/maven2/
+# from CLI (failing)
+invoker.goals.3 = -V -e njord:${project.version}:check-artifacts-availability -DwaitSleep=PT1S -DwaitDelay=PT1S -DwaitTimeout=PT10S  "-Dartifacts=junit:junit:jar:4.13.2,junit:junit:pom:4.13.2,nonexistent:nonexistent:1.0" -DremoteRepository=central::https://repo.maven.apache.org/maven2/
+invoker.buildResult.3 = failure

it/extension-its/src/it/check-artifacts-availability-manual-pom/list.txt

@@ -0,0 +1,3 @@
+# list of artifacts to check
+junit:junit:jar:4.13.2
+junit:junit:pom:4.13.2

it/extension-its/src/it/check-artifacts-availability-manual-pom/pom.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    Copyright (c) 2023-2024 Maveniverse Org.
+    All rights reserved. This program and the accompanying materials
+    are made available under the terms of the Eclipse Public License v2.0
+    which accompanies this distribution, and is available at
+    https://www.eclipse.org/legal/epl-v20.html
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>eu.maveniverse.maven.njord.it</groupId>
+    <artifactId>check-artifacts-availability-manual-pom</artifactId>
+    <version>1.0.0</version>
+
+    <name>${project.groupId}:${project.artifactId}</name>
+    <description>Unused, just load up extension/plugin and have invoker copy this project</description>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>eu.maveniverse.maven.plugins</groupId>
+                <artifactId>njord</artifactId>
+                <version>@project.version@</version>
+            </plugin>
+        </plugins>
+    </build>
+</project>

plugin/src/main/java/eu/maveniverse/maven/njord/plugin3/CheckArtifactsAvailabilityMojo.java

@@ -13,6 +13,10 @@
 import eu.maveniverse.maven.njord.shared.store.ArtifactStore;
 import eu.maveniverse.maven.njord.shared.store.RepositoryMode;
 import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.InvalidPathException;
+import java.nio.file.Path;
+import java.nio.file.Paths;
 import java.time.Duration;
 import java.time.Instant;
 import java.util.ArrayList;
@@ -89,6 +93,10 @@ public class CheckArtifactsAvailabilityMojo extends PublisherSupportMojo {
      * The comma separated list of artifacts to check availability for. If this parameter is set, the mojo
      * will use this list instead to go for {@link ArtifactStore}. The comma separated list should contain
      * artifacts in form of {@code <groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>}.
+     * <p>
+     * Parameter may point to an existing text file as well, which contains on each line an artifact string
+     * in format above. The file may contain empty lines and lines starting with {@code #} (comments) that
+     * are ignored.
      */
     @Parameter(property = "artifacts")
     private String artifacts;
@@ -107,8 +115,24 @@ public class CheckArtifactsAvailabilityMojo extends PublisherSupportMojo {
     @Override
     protected void doWithSession(Session ns) throws IOException, MojoFailureException {
         if (artifacts != null) {
+            try {
+                Path artifactsFile = Paths.get(artifacts);
+                if (Files.exists(artifactsFile) && !Files.isDirectory(artifactsFile)) {
+                    logger.debug("Mojo parameter artifacts points to an existing file; loading it up");
+                    this.artifacts = Files.readAllLines(artifactsFile).stream()
+                            .map(String::trim)
+                            .filter(l -> !l.isEmpty())
+                            .filter(line -> !line.startsWith("#"))
+                            .collect(Collectors.joining(","));
+                }
+            } catch (InvalidPathException e) {
+                // ignore
+            }
+            logger.debug("Artifacts list: {}", this.artifacts);
             HashSet<Boolean> snaps = new HashSet<>();
-            List<Artifact> artifacts = Arrays.stream(this.artifacts.split(","))
+            List<Artifact> artifacts = Arrays.stream(this.artifacts.split("[,\\s]"))
+                    .map(String::trim)
+                    .filter(l -> !l.isEmpty())
                     .map(DefaultArtifact::new)
                     .peek(a -> snaps.add(a.isSnapshot()))
                     .collect(Collectors.toList());