#1213: changed the tool installation log and added new method to get latest tool version

Author: ylindenb-cap

cli/src/main/java/com/devonfw/tools/ide/tool/LocalToolCommandlet.java

@@ -242,9 +242,10 @@ protected Path downloadTool(String edition, ToolRepository toolRepository, Versi
    *
    * @param version the required {@link VersionRange}. See {@link ToolDependency#versionRange()}.
    * @param processContext the {@link ProcessContext}.
+   * @param toolParent the parent tool name needing the dependency
    * @return {@code true} if the tool was newly installed, {@code false} otherwise (installation was already present).
    */
-  public boolean installAsDependency(VersionRange version, ProcessContext processContext) {
+  public boolean installAsDependency(VersionRange version, ProcessContext processContext, String toolParent) {
 
     VersionIdentifier configuredVersion = getConfiguredVersion();
     if (version.contains(configuredVersion)) {
@@ -257,8 +258,9 @@ public boolean installAsDependency(VersionRange version, ProcessContext processC
                 + " and this tool does not support the software repository.");
       }
       this.context.info(
-          "Configured version of tool {} is {} but does not match version to install {} - need to use different version from software repository.",
-          this.tool, configuredVersion, version);
+          "The tool {} requires {} in the version range {}, but your project uses version {}, which does not match."
+              + " Therefore, we install an additional version {} to run it.",
+          toolParent, this.tool, version, configuredVersion, getLatestToolVersion());
     }
     ToolInstallation toolInstallation = installTool(version, processContext);
     return toolInstallation.newInstallation();
@@ -272,7 +274,7 @@ private void installToolDependencies(VersionIdentifier version, String edition,
     for (ToolDependency dependency : dependencies) {
       this.context.trace("Ensuring dependency {} for tool {}", dependency.tool(), toolWithEdition);
       LocalToolCommandlet dependencyTool = this.context.getCommandletManager().getRequiredLocalToolCommandlet(dependency.tool());
-      dependencyTool.installAsDependency(dependency.versionRange(), processContext);
+      dependencyTool.installAsDependency(dependency.versionRange(), processContext, toolWithEdition);
     }
   }
 
@@ -424,5 +426,13 @@ public void setEnvironment(EnvironmentContext environmentContext, ToolInstallati
     }
   }
 
+  /**
+   * @return {@link VersionIdentifier} with latest version of the tool}.
+   */
+  public VersionIdentifier getLatestToolVersion() {
+
+    return this.context.getDefaultToolRepository().resolveVersion(this.tool, getConfiguredEdition(), VersionIdentifier.LATEST, this);
+  }
+
 
 }

cli/src/test/java/com/devonfw/tools/ide/tool/tomcat/TomcatTest.java

@@ -48,18 +48,18 @@ public void testTomcat() {
     assertThat(context.getSoftwarePath().resolve("tomcat/.ide.software.version")).exists().hasContent(tomcatVersion);
     assertThat(javaTomcatPath.resolve(".ide.software.version")).exists().hasContent(javaVersionTomcat);
     assertThat(context).log().hasEntries(
-        new IdeLogEntry(IdeLogLevel.SUCCESS, "Successfully installed java in version " + javaVersionProject), //
-        new IdeLogEntry(IdeLogLevel.INFO, "OpenJDK version " + javaVersionProject), //
+        new IdeLogEntry(IdeLogLevel.SUCCESS, "Successfully installed java in version " + javaVersionProject),
+        new IdeLogEntry(IdeLogLevel.INFO, "OpenJDK version " + javaVersionProject),
         new IdeLogEntry(IdeLogLevel.INFO,
-            "Configured version of tool java is 8u402b06 but does not match version to install [11,22) - need to use different version from software repository."),
-        //
+            "The tool tomcat requires java in the version range [11,22), but your project uses version 8u402b06, which does not match."
+                + " Therefore, we install an additional version 21_35 to run it."),
         new IdeLogEntry(IdeLogLevel.DEBUG, "Installed java in version " + javaVersionTomcat + " at ", true),
-        new IdeLogEntry(IdeLogLevel.SUCCESS, "Successfully installed tomcat in version " + tomcatVersion), //
-        new IdeLogEntry(IdeLogLevel.INFO, "OpenJDK version " + javaVersionTomcat), //
-        new IdeLogEntry(IdeLogLevel.INFO, "JAVA_HOME=" + javaTomcatPath), //
-        new IdeLogEntry(IdeLogLevel.INFO, "tomcat run"), //
-        new IdeLogEntry(IdeLogLevel.INFO, "Tomcat is running at localhost on HTTP port " + tomcatPort + ":"), //
-        new IdeLogEntry(IdeLogLevel.INFO, "http://localhost:" + tomcatPort) //
+        new IdeLogEntry(IdeLogLevel.SUCCESS, "Successfully installed tomcat in version " + tomcatVersion),
+        new IdeLogEntry(IdeLogLevel.INFO, "OpenJDK version " + javaVersionTomcat),
+        new IdeLogEntry(IdeLogLevel.INFO, "JAVA_HOME=" + javaTomcatPath),
+        new IdeLogEntry(IdeLogLevel.INFO, "tomcat run"),
+        new IdeLogEntry(IdeLogLevel.INFO, "Tomcat is running at localhost on HTTP port " + tomcatPort + ":"),
+        new IdeLogEntry(IdeLogLevel.INFO, "http://localhost:" + tomcatPort)
     );
   }