#1492: Add Spring-Boot-CLI Commandlet (#1496)

Co-authored-by: Jörg Hohwiller <hohwille@users.noreply.github.com>

Author: jan-vcapgemini

CHANGELOG.adoc

@@ -14,6 +14,7 @@ The full list of changes for this release can be found in https://github.com/dev
 
 Release with new features and bugfixes:
 
+* https://github.com/devonfw/IDEasy/issues/1492[#1492]: Add spring-boot CLI Commandlet.
 * https://github.com/devonfw/IDEasy/issues/1545[#1545]: Yarn can not be installed after corepack
 
 The full list of changes for this release can be found in https://github.com/devonfw/IDEasy/milestone/36?closed=1[milestone 2025.10.002].

cli/src/main/java/com/devonfw/tools/ide/commandlet/CommandletManagerImpl.java

@@ -45,6 +45,7 @@
 import com.devonfw.tools.ide.tool.python.Python;
 import com.devonfw.tools.ide.tool.quarkus.Quarkus;
 import com.devonfw.tools.ide.tool.sonar.Sonar;
+import com.devonfw.tools.ide.tool.spring.Spring;
 import com.devonfw.tools.ide.tool.terraform.Terraform;
 import com.devonfw.tools.ide.tool.tomcat.Tomcat;
 import com.devonfw.tools.ide.tool.uv.Uv;
@@ -133,6 +134,7 @@ public CommandletManagerImpl(IdeContext context) {
     add(new LazyDocker(context));
     add(new Python(context));
     add(new Pycharm(context));
+    add(new Spring(context));
     add(new Uv(context));
     add(new Yarn(context));
     add(new Corepack(context));

cli/src/main/java/com/devonfw/tools/ide/tool/mvn/MvnArtifact.java

@@ -10,7 +10,7 @@
 /**
  * Simple type representing a maven artifact.
  */
-public final class MvnArtifact extends SoftwareArtifact {
+public class MvnArtifact extends SoftwareArtifact {
 
   /** {@link #getGroupId() Group ID} of IDEasy. */
   public static final String GROUP_ID_IDEASY = "com.devonfw.tools.IDEasy";
@@ -260,12 +260,16 @@ public String getBaseVersion() {
    */
   public String getDownloadUrl() {
     if (this.downloadUrl == null) {
-      String baseUrl = isSnapshot() ? MvnRepository.MAVEN_SNAPSHOTS : MvnRepository.MAVEN_CENTRAL;
+      String baseUrl = getMvnBaseUrl();
       this.downloadUrl = baseUrl + "/" + getPath();
     }
     return this.downloadUrl;
   }
 
+  public String getMvnBaseUrl() {
+    return isSnapshot() ? MvnRepository.MAVEN_SNAPSHOTS : MvnRepository.MAVEN_CENTRAL;
+  }
+
   @Override
   public int hashCode() {
     return Objects.hash(this.groupId, this.artifactId, this.version);

cli/src/main/java/com/devonfw/tools/ide/tool/repository/MvnRepository.java

@@ -127,14 +127,26 @@ public MvnArtifactMetadata getMetadata(MvnArtifact artifact, String tool, String
       }
       artifact = artifact.withClassifier(resolvedClassifier);
     }
-    UrlChecksums chekcsums = null;
+    UrlChecksums checksums = getChecksums(artifact);
+    return new MvnArtifactMetadata(artifact, tool, edition, checksums, os, arch);
+  }
+
+  /**
+   * Method is required to disable checksum checks in tests.
+   *
+   * @param artifact the {@link MvnArtifact} to use.
+   * @return the {@link UrlChecksums}.
+   */
+  protected UrlChecksums getChecksums(MvnArtifact artifact) {
+
+    UrlChecksums checksums = null;
     if (!artifact.isMavenMetadata()) {
-      chekcsums = new UrlLazyChecksums(artifact);
+      checksums = new UrlLazyChecksums(artifact);
     }
-    return new MvnArtifactMetadata(artifact, tool, edition, chekcsums, os, arch);
+    return checksums;
   }
 
-  private UrlGenericChecksum getChecksum(MvnArtifact artifact, String hashAlgorithm) {
+  protected UrlGenericChecksum getChecksum(MvnArtifact artifact, String hashAlgorithm) {
 
     MvnArtifact checksumArtifact = artifact.withType(artifact.getType() + "." + hashAlgorithm.toLowerCase(Locale.ROOT));
     Path checksumFile = getDownloadedArtifact(checksumArtifact, null);
@@ -147,7 +159,7 @@ private Path getDownloadedArtifact(MvnArtifact artifact, UrlChecksums checksums)
     Path file = this.localMavenRepository.resolve(artifact.getPath());
     if (isNotUpToDateInLocalRepo(file)) {
       this.context.getFileAccess().mkdirs(file.getParent());
-      download(artifact.getDownloadUrl(), file, artifact.getVersion(), checksums);
+      download(getMavenUrl(artifact), file, artifact.getVersion(), checksums);
     }
     return file;
   }
@@ -190,15 +202,16 @@ public VersionIdentifier resolveVersion(MvnArtifact artifact, GenericVersionRang
     versionString = resolvedVersion.toString();
     if (versionString.endsWith("-SNAPSHOT")) {
       artifact = artifact.withVersion(versionString);
-      return resolveSnapshotVersion(artifact.getDownloadUrl(), versionString);
+      return resolveSnapshotVersion(getMavenUrl(artifact), versionString);
     }
     return resolvedVersion;
   }
 
   @Override
   protected List<VersionIdentifier> fetchVersions(MvnArtifact artifact) {
 
-    String metadataUrl = artifact.withMavenMetadata().getDownloadUrl();
+    String metadataUrl = getMavenUrl(artifact.withMavenMetadata());
+
     Document metadata = fetchXmlMetadata(metadataUrl);
     return fetchVersions(metadata, metadataUrl);
   }
@@ -274,6 +287,16 @@ private Document fetchXmlMetadata(String url) {
     }
   }
 
+  /**
+   * Used for tests to overwrite Maven base url.
+   *
+   * @param artifact the {@link MvnArtifact} to use
+   * @return the Maven url
+   */
+  protected String getMavenUrl(MvnArtifact artifact) {
+    return artifact.getDownloadUrl();
+  }
+
   private class UrlLazyChecksums implements UrlChecksums {
 
     private final MvnArtifact artifact;
@@ -301,5 +324,4 @@ public Iterator<UrlGenericChecksum> iterator() {
       return this.checksums.iterator();
     }
   }
-
 }

cli/src/main/java/com/devonfw/tools/ide/tool/spring/Spring.java

@@ -0,0 +1,28 @@
+package com.devonfw.tools.ide.tool.spring;
+
+import java.util.Set;
+
+import com.devonfw.tools.ide.common.Tag;
+import com.devonfw.tools.ide.context.IdeContext;
+import com.devonfw.tools.ide.tool.ToolCommandlet;
+import com.devonfw.tools.ide.tool.mvn.MvnArtifact;
+import com.devonfw.tools.ide.tool.mvn.MvnBasedLocalToolCommandlet;
+
+/**
+ * {@link ToolCommandlet} for <a href="https://github.com/spring-projects/spring-boot">Spring-Boot-CLI</a>.
+ */
+public class Spring extends MvnBasedLocalToolCommandlet {
+
+  /** The {@link MvnArtifact} for Spring. */
+  public static final MvnArtifact ARTIFACT = new MvnArtifact("org/springframework/boot", "spring-boot-cli", "*", "tar.gz", "bin");
+
+  /**
+   * The constructor.
+   *
+   * @param context the {@link IdeContext}.
+   */
+  public Spring(IdeContext context) {
+
+    super(context, "spring", ARTIFACT, Set.of(Tag.JAVA, Tag.ARCHITECTURE, Tag.FRAMEWORK));
+  }
+}

cli/src/main/resources/nls/Help.properties

@@ -103,6 +103,8 @@ cmd.shell.detail=The interactive shell offers console users a new user experienc
 cmd.sonar=Tool commandlet for SonarQube.
 cmd.sonar.detail=SonarQube is a platform for continuous inspection of code quality. Detailed documentation can be found at https://docs.sonarqube.org/
 cmd.sonar.val.command=Action to perform (START|STOP|ANALYZE)
+cmd.spring=Tool commandlet for Spring-Boot-CLI.
+cmd.spring.detail=Spring Boot is an extension of the Spring framework that simplifies the initial configuration of Spring applications. Detailed documentation can be found at https://spring.io/projects/spring-boot
 cmd.status=Prints the status report about your IDEasy.
 cmd.status.detail=To check your IDE-status (e.g. duplicated or legacy variables) as well as potential information about updates to settings you should apply\nwith ide update, run the following command: 'ide status'.
 cmd.terraform=Tool commandlet for Terraform.

cli/src/main/resources/nls/Help_de.properties

@@ -103,6 +103,8 @@ cmd.shell.detail=Die integrierte Shell bietet Konsolenbenutzer*Innen eine neue B
 cmd.sonar=Werkzeug Kommando für SonarQube.
 cmd.sonar.detail=SonarQube ist eine Plattform für die kontinuierliche Code-Qualitätsprüfung. Detaillierte Dokumentation ist zu finden unter https://docs.sonarqube.org/
 cmd.sonar.val.command=Auszuführende Aktion (START|STOP|ANALYZE)
+cmd.spring=Werkzeug Kommando für Spring-Boot-CLI.
+cmd.spring.detail=Spring Boot ist eine Erweiterung des Spring frameworks das die initiale Konfiguration von Spring Anwendungen vereinfacht. Detaillierte Dokumentation ist zu finden unter https://spring.io/projects/spring-boot
 cmd.status=Gibt einen Statusbericht über IDEasy aus
 cmd.status.detail=Um den Status Ihrer IDE zu überprüfen (z.B. doppelte oder veraltete Variablen) sowie potenzielle Informationen über Updates zu den Einstellungen,\ndie Sie mit dem Befehl 'ide update' anwenden sollten, führen Sie den folgenden Befehl aus: 'ide status'.
 cmd.terraform=Werkzeug Kommando für Terraform.

cli/src/test/integration-tests/install-spring.sh

@@ -0,0 +1,4 @@
+echo "Running install spring (spring-boot-cli) integration test"
+ide -d install spring
+
+assertThat "${IDE_ROOT}/${TEST_PROJECT_NAME}/software/spring/bin/spring" exists

cli/src/test/java/com/devonfw/tools/ide/context/AbstractIdeTestContext.java

@@ -61,7 +61,7 @@ public class AbstractIdeTestContext extends AbstractIdeContext {
    *
    * @param logger the {@link IdeLogger}.
    * @param workingDirectory the optional {@link Path} to current working directory.
-   * @param wireMockRuntimeInfo wireMock server on a random port
+   * @param wireMockRuntimeInfo wireMock server on a random port.
    */
   public AbstractIdeTestContext(IdeStartContextImpl logger, Path workingDirectory, WireMockRuntimeInfo wireMockRuntimeInfo) {
 

cli/src/test/java/com/devonfw/tools/ide/context/IdeTestContext.java

@@ -9,6 +9,7 @@
 import com.devonfw.tools.ide.log.IdeLogLevel;
 import com.devonfw.tools.ide.log.IdeTestLogger;
 import com.devonfw.tools.ide.process.ProcessContext;
+import com.devonfw.tools.ide.tool.repository.MvnRepository;
 import com.devonfw.tools.ide.tool.repository.NpmRepository;
 import com.devonfw.tools.ide.tool.repository.ToolRepositoryMock;
 import com.github.tomakehurst.wiremock.junit5.WireMockRuntimeInfo;
@@ -119,4 +120,14 @@ protected NpmRepository createNpmRepository() {
     }
     return super.createNpmRepository();
   }
+
+  @Override
+  protected MvnRepository createMvnRepository() {
+    if (this.wireMockRuntimeInfo != null) {
+      return new MvnRepositoryMock(this, this.wireMockRuntimeInfo);
+    }
+    return super.createMvnRepository();
+  }
+
+
 }